Questa sezione descrive le stored procedure per le istanze Cloud SQL.
Una stored procedure contiene codice SQL che puoi riutilizzare.
Per eseguire una stored procedure, utilizza il comando EXEC
e sostituisci le seguenti variabili:
- procedure_name è il nome della stored procedure.
- database_name è il nome del database in cui vuoi eseguire la procedura.
- schema_name è il nome dello schema in cui vuoi eseguire la procedura.
EXEC database_name.schema_name.procedure_name @param1, @param2;Per ulteriori informazioni, consulta la pagina di riferimento EXECUTE (Transact-SQL).
Per creare la tua stored procedure, vedi Creare una stored procedure.
stored procedure di Cloud SQL per SQL Server
Stored procedure per l'utilizzo dell'inserimento collettivo
Per informazioni sull'inserimento collettivo, consulta Utilizzare l'inserimento collettivo per importare i dati.
msdb.dbo.gcloudsql_bulk_insert
Sintassi
EXEC msdb.dbo.gcloudsql_bulk_insert @database @schema @object @file ...
Description
Questa stored procedure ha parametri e comportamenti simili al comando BULK INSERT.
La stored procedure importa i dati in un'istanza Cloud SQL da un file archiviato in un bucket Cloud Storage. Utilizza l'API interoperabile Cloud Storage e le chiavi HMAC per autenticare l'accesso al bucket Cloud Storage.
Questa stored procedure ha i seguenti parametri:
Parametro | Tipo | Descrizione |
---|---|---|
@database |
SYSNAME |
Specifica il nome del database di destinazione in cui importare i dati. |
@schema |
SYSNAME |
Specifica il nome dello schema a cui appartiene la tabella. |
@object |
NVARCHAR |
Specifica il nome della tabella in cui inserire i dati. |
@file |
NVARCHAR |
Specifica il percorso del file di importazione nel bucket Cloud Storage.
Il percorso deve avere il seguente formato: s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH Sostituisci quanto segue:
|
@batchsize |
INT |
Specifica il numero di righe in un batch. |
@checkconstraints |
BIT |
Specifica che devono essere selezionati tutti i vincoli nella tabella di destinazione. |
@codepage |
NVARCHAR |
Specifica la tabella di codice dei dati contenuti nel file.
RAW è l'unica opzione predefinita. |
@datafiletype |
NVARCHAR |
Specifica il tipo di file di inserimento collettivo. |
@datasource |
NVARCHAR |
Specifica il nome dell'origine dati esterna da cui vuoi importare i dati. |
@errorfile |
NVARCHAR |
Specifica il percorso del file utilizzato per raccogliere le righe che contengono errori di formattazione.
Il percorso deve avere il seguente formato: s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH Sostituisci quanto segue:
Inoltre, Cloud SQL crea un file con estensione |
@errorfiledatasource |
NVARCHAR |
Specifica il nome dell'origine dati esterna in cui vuoi creare il file di errore. |
@firstrow |
INT |
Specifica l'identificatore numerico della prima riga da caricare. |
@firetriggers |
BIT |
Indica che tutti gli attivatori di inserimento definiti nella tabella di destinazione verranno eseguiti durante le operazioni di inserimento collettivo. |
@formatfiledatasource |
NVARCHAR |
Specifica il nome dell'origine dati esterna da cui caricare il file del formato. |
@keepidentity |
BIT |
Specifica l'utilizzo dei dati di identità dal file di importazione per la colonna Identità. I valori sono 0 , che significa false, e 1 , che significa true. |
@keepnulls |
BIT |
Consente di specificare se le colonne vuote devono mantenere un valore nullo durante l'operazione di importazione collettiva, anziché avere valori predefiniti per le colonne inserite. I valori sono 0 , che significa false, e 1 , che significa true. |
@kilobytesperbatch |
INT |
Specifica la quantità di dati per batch, in kB. |
@lastrow |
INT |
Specifica l'identificatore numerico dell'ultima riga da caricare. |
@maxerrors |
INT |
Specifica il numero di errori consentiti prima che Cloud SQL annulli l'operazione. |
@ordercolumnsjson |
NVARCHAR |
Specifica l'ordinamento e le colonne in formato JSON. Ad esempio:
[{"name": "COLUMN_NAME","order": "ORDER"},{"name": "COLUMN_NAME","order": "ORDER"}] Sostituisci quanto segue:
|
@rowsperbatch |
INT |
Specifica il numero di righe per batch.
Per ulteriori informazioni sulla selezione di una dimensione del batch, consulta Considerazioni sulle prestazioni. |
@tablock |
BIT |
Specifica che viene utilizzato un blocco della tabella per la durata dell'operazione di inserimento collettivo. |
@format |
NVARCHAR |
Specifica il formato del file. Utilizza CSV come valore di questo parametro. |
@fieldquote |
NVARCHAR |
Specifica il carattere da utilizzare come virgolette nel file CSV.
Se non specifichi alcun valore, Cloud SQL utilizza |
@formatfile |
NVARCHAR |
Specifica il percorso del file in Cloud Storage che descrive il formato dei dati da importare.
Il percorso deve avere il seguente formato: s3://storage.googleapis.com/BUCKET_NAME/FILE_PATH Sostituisci quanto segue:
|
@fieldterminator |
NVARCHAR |
Specifica il carattere di terminazione dei campi per i file di dati char e Widechar. |
@rowterminator |
NVARCHAR |
Specifica il carattere di terminazione delle righe per i file di dati char e Widechar. |
Stored procedure per la funzionalità SQL Server Audit
Per informazioni sull'utilizzo della funzionalità di controllo di SQL Server, consulta Controllo dei database SQL Server.
msdb.dbo.gcloudsql_fn_get_audit_file
Sintassi
msdb.dbo.gcloudsql_fn_get_audit_file
Description
Recupera i dati da un file di controllo creato dalla funzionalità SQL Server Audit.
Questa stored procedure accetta gli stessi parametri della funzione sys.fn_get_audit_file
. Consulta la documentazione per la funzione in questione per ulteriori informazioni relative a msdb.dbo.gcloudsql_fn_get_audit_file
.
Stored procedure per CDC (Change Data Capture)
Per saperne di più sulla CDC, consulta Abilitare il Change Data Capture (CDC).
msdb.dbo.gcloudsql_cdc_enable_db
Sintassi
exec msdb.dbo.gcloudsql_cdc_enable_db databaseName
Description
Attiva Change Data Capture (CDC) per un database.
databaseName
: il nome del database su cui eseguire questa stored procedure.
msdb.dbo.gcloudsql_cdc_disable_db
Sintassi
exec msdb.dbo.gcloudsql_cdc_disable_db databaseName
Description
Disattiva CDC per un database.
databaseName
: il nome del database su cui eseguire questa stored procedure.
Stored procedure per la replica esterna con Cloud SQL come publisher
Per ulteriori informazioni sulla pubblicazione per un sottoscrittore esterno o in un'altra istanza Cloud SQL, consulta Configurare le repliche esterne.
msdb.dbo.gcloudsql_transrepl_setup_distribution
Sintassi
exec msdb.dbo.gcloudsql_transrepl_setup_distribution @login,@password
Description
Una stored procedure wrapper che configura un database di distribuzione. Il wrapper richiama: sp_adddistributor, sp_adddistributiondb e sp_adddistpublisher.
- login: un accesso esistente utilizzato per connettersi e creare il database di distribuzione.
- password: la password utilizzata per la connessione al distributore.
msdb.dbo.gcloudsql_transrepl_replicationdboption
Sintassi
exec msdb.dbo.gcloudsql_transrepl_replicationdboption @db,@value
Description
Abilita o disabilita l'opzione di pubblicazione di un database per l'editore che utilizza sp_replicationdboption.
- db: il database per il quale è impostata l'opzione di replica.
- valore: consente di specificare
True
per attivare l'opzione di pubblicazione oFalse
per disattivare l'opzione di pubblicazione.
msdb.dbo.gcloudsql_transrepl_addlogreader_agent
Sintassi
exec msdb.dbo.gcloudsql_transrepl_addlogreader_agent @db,@login,@password
Description
Configura l'agente del lettore di log per un database che utilizza sp_addlogreader_agent.
- db - Database da pubblicare.
- login: l'accesso utilizzato per la connessione al publisher.
- password: la password utilizzata per la connessione.
msdb.dbo.gcloudsql_transrepl_addpublication
Sintassi
exec msdb.dbo.gcloudsql_transrepl_addpublication @db,@publication
Description
Crea la pubblicazione transazionale e agisce come stored procedure wrapper per sp_addpublication.
- db: database in fase di pubblicazione.
- publication: il nome della nuova pubblicazione creata.
msdb.dbo.gcloudsql_transrepl_droppublication
Sintassi
exec msdb.dbo.gcloudsql_transrepl_droppublication @db,@publication
Description
Elimina la pubblicazione transazionale e agisce come stored procedure wrapper per sp_droppublication.
- db: database per il quale viene eliminata la pubblicazione.
- publication: il nome della pubblicazione rimossa.
msdb.dbo.gcloudsql_transrepl_addpublication_snapshot
Sintassi
exec msdb.dbo.gcloudsql_transrepl_addpublication_snapshot @db,@publication,@login,@password
Description
Crea un agente snapshot per il database in fase di pubblicazione, agendo come una stored procedure del wrapping per sp_addpublication_snapshot.
- db: database per il quale viene eliminata la pubblicazione.
- publication: il nome della pubblicazione rimossa.
- login: l'accesso utilizzato per la connessione al publisher.
- password: la password utilizzata per la connessione.
msdb.dbo.gcloudsql_transrepl_addpushsubscription_agent
Sintassi
exec msdb.dbo.gcloudsql_transrepl_addpushsubscription_agent
@db,@publication,@subscriber_db,@subscriber_login,
@subscriber_password,@subscriber
Description
Crea un nuovo job agente pianificato per sincronizzare la sottoscrizione push, agendo come una stored procedure wrapper per sp_addpushsubscription_agent.
- db: database pubblicato.
- publication: nome della pubblicazione a cui aggiungere un agente di abbonamento push.
- subscriber_db: il database del sottoscrittore.
- subscriber_login: l'accesso utilizzato per la connessione all'abbonato.
- subscriber_password: la password utilizzata per la connessione all'iscritto.
- subscriber: il nome IP dell'istanza dell'abbonato. Questo valore può
specificare come:
<Hostname>,<PortNumber>
msdb.dbo.gcloudsql_transrepl_addmonitoraccess
Sintassi
exec msdb.dbo.gcloudsql_transrepl_addmonitoraccess @login
Description
Fornisce l'accesso al Monitoraggio replica e all'istruzione SELECT
sulle tabelle relative alla replica sul database di distribuzione.
- login: l'accesso utilizzato per accedere al monitoraggio della replica.
msdb.dbo.gcloudsql_transrepl_changedistributor_property
Sintassi
exec msdb.dbo.gcloudsql_transrepl_changedistributor_property @property,@value
Description
Questa stored procedure modifica heartbeat_interval
e esegue il wrapping di sp_changedistributor_property
. Per ulteriori informazioni, consulta la documentazione per sp_changedistributor_property
. Consulta anche la documentazione per ulteriori
informazioni sul valore heartbeat_interval
.
- property - La proprietà per un database di distribuzione.
- value - Il valore da fornire per la proprietà specificata.
msdb.dbo.gcloudsql_transrepl_dropsubscriber
Sintassi
exec msdb.dbo.gcloudsql_transrepl_dropsubscriber @subscriber
Description
Rimuove il sottoscrittore, agendo come stored procedure wrapper per sp_dropsubscriber.
- subscriber: il nome IP dell'abbonato da eliminare. Questo valore può
specificare come:
<Hostname>,<PortNumber>
msdb.dbo.gcloudsql_transrepl_remove_distribution
Sintassi
exec msdb.dbo.gcloudsql_transrepl_remove_distribution
Description
Rimuove la configurazione della distribuzione, agendo come stored procedure wrapper per quanto segue: sp_dropdistpublisher, sp_dropdistributiondb e sp_dropdistributor.
Passaggi successivi
- Scopri come abilitare la Change Data Capture (CDC).
- Scopri come configurare le repliche esterne.