Abilita Change Data Capture (CDC)

Questa pagina descrive come abilitare Change Data Capture (CDC) in Cloud SQL per SQL Server. Questa funzionalità è disponibile per i database delle tue istanze.

CDC consente di acquisire molti tipi di modifiche. Per informazioni su come attivare e disattivare CDC, consulta la documentazione di Microsoft.

Dopo aver eseguito la connessione a un'istanza, l'utente sqlserver può eseguire molte operazioni CDC.

Vedi anche Utilizzare i dati delle modifiche.

Prima di iniziare

Prima di implementare CDC su un'istanza, esamina tutte le informazioni riportate in questa pagina.

Confermare la disponibilità della funzionalità

CDC è disponibile per le seguenti versioni del database Cloud SQL per SQL Server:

  • SQL Server 2022 Standard
  • SQL Server 2022 Enterprise
  • SQL Server 2019 Standard
  • SQL Server 2019 Enterprise
  • SQL Server 2017 Standard
  • SQL Server 2017 Enterprise

Abilitazione di CDC e avvio dei job di acquisizione CDC

Il tuo database contiene le seguenti stored procedure, da utilizzare per l'utente sqlserver:

  • msdb.dbo.gcloudsql_cdc_enable_db
  • msdb.dbo.gcloudsql_cdc_disable_db

Attiva CDC

Per attivare questa funzionalità per un database, esegui la stored procedure necessaria e trasmetti il nome del database. Ad esempio:

EXEC msdb.dbo.gcloudsql_cdc_enable_db 'DATABASE_NAME'

Disattivare CDC

Per disattivare questa funzionalità per un database, esegui un comando come il seguente:

EXEC msdb.dbo.gcloudsql_cdc_disable_db 'DATABASE_NAME'

Avviare i job di acquisizione CDC

Una volta abilitata la CDC, vengono creati job per l'acquisizione e la pulizia. I job non sono visibili all'utente sqlserver in SQL Server Management Studio (SSMS). Tuttavia, puoi modificare i job utilizzando le stored procedure integrate. Inoltre, i job sono visualizzabili tramite la seguente stored procedure:

Per avviare un job di pulizia, puoi utilizzare il seguente comando:

EXEC sys.sp_cdc_start_job @job_type = N'cleanup'

Per modificare i parametri del job, puoi utilizzare un comando simile al seguente, ad esempio:

EXEC sys.sp_cdc_change_job  @job_type = N'capture',
        @maxtrans = 20,
        @pollinginterval = NULL,
        @maxscans = NULL,
        @continuous = NULL

Per ulteriori informazioni su come avviare e modificare i job, consulta quanto segue:

Vedi anche sys.sp_cdc_add_job.

Abilitazione di CDC per una tabella

Dopo aver attivato CDC per un database, qualsiasi utente con accesso dbo (proprietario del database) può configurare il monitoraggio delle tabelle nel database.

Per informazioni sui comandi e sulle opzioni CDC standard, consulta Abilitare e disabilitare Change Data Capture.

Tenere traccia delle modifiche in una tabella

Per monitorare una tabella, utilizza la stored procedure sys.sp_cdc_enable_table.

Ad esempio, puoi specificare un comando simile al seguente:

EXEC sys.sp_cdc_enable_table
  @source_schema = N'dbo',
  @source_name = N'customer',
  @role_name = N'CDC'

Controllare se CDC è abilitata in una tabella

Per verificare se CDC è abilitato in una tabella, utilizza la stored procedure sys.sp_cdc_help_change_data_capture.

Ad esempio, puoi specificare un comando simile al seguente:

EXECUTE sys.sp_cdc_help_change_data_capture
  @source_schema = N'dbo',
  @source_name = N'customer'

Modifiche alle query tramite una tabella delle modifiche CDC

Per visualizzare le modifiche CDC apportate a una tabella, utilizza una query SELECT sulla tabella che viene creata automaticamente quando CDC è abilitato nella tabella.

La tabella è denominata come segue:

<schema>_<table_name>_CT

Ad esempio, puoi specificare un comando simile al seguente:

SELECT * FROM cdc.dbo_customer_CT

Abilita CDC in una tabella con un'istanza di acquisizione specificata

Per monitorare una tabella con un'istanza di acquisizione, utilizza la stored procedure sys.sp_cdc_enable_table.

Ad esempio, puoi specificare un comando simile al seguente:

EXEC sys.sp_cdc_enable_table
    @source_schema = N'dbo',
    @source_name = N'customer',
    @role_name = N'CDC',
    @capture_instance = N'customer_cdc',
    @supports_net_changes = 1

Esegui query su tutte le modifiche all'interno di un'istanza di acquisizione

Per visualizzare le modifiche CDC apportate a una tabella all'interno di un'"istanza di acquisizione", utilizza la stored procedure cdc.fn_cdc_get_all_changes_<capture_instance>.

Ad esempio, puoi specificare un'istruzione SQL simile alla seguente:

DECLARE @from_lsn binary(10), @to_lsn binary(10)
SET @from_lsn = sys.fn_cdc_get_min_lsn(N'customer_cdc')
SET @to_lsn = sys.fn_cdc_get_max_lsn()
SELECT * FROM cdc.fn_cdc_get_all_changes_customer_cdc(@from_lsn, @to_lsn, N'all');

Disattivare CDC per una tabella

Per disattivare il monitoraggio CDC per una tabella, utilizza la procedura memorizzata sys.sp_cdc_disable_table. Specifica un'istanza di acquisizione da disattivare. In alternativa, specifica un'istanza di acquisizione come 'all'.

Ad esempio, puoi specificare un comando simile al seguente per disattivare CDC per la tabella:

EXEC sys.sp_cdc_disable_table
  @source_schema = N'dbo',
  @source_name = N'customer',
  @capture_instance = N'all'

Eliminazione di un database abilitato a CDC

Se la tecnologia CDC è abilitata per un database e provi a eliminarlo, potresti riscontrare errori. In questo caso, disabilita CDC per il database, quindi elimina il database.

Ad esempio, puoi specificare un comando simile al seguente per disattivare ed eliminare un database:

EXEC msdb.dbo.gcloudsql_cdc_disable_db 'DATABASE_NAME'
DROP DATABASE 'DATABASE_NAME'

Se non riesci a eliminare il database perché ha connessioni aperte, utilizza la seguente query per visualizzare queste connessioni:

select db_name(dbid),* from sys.sysprocesses where db_name(dbid)= 'DATABASE_NAME'

Chiudi tutte le connessioni aperte. Disabilita CDC per il database, quindi elimina il database.

Importazione di un database abilitato per CDC

Quando importi un database abilitato a CDC, Cloud SQL per SQL Server mantiene il flag KEEP_CDC abilitato e crea automaticamente job di acquisizione e pulizia con parametri predefiniti.