Configura una base de datos de Cloud SQL para SQL Server para la CDC

En esta página, se describe cómo configurar la captura de datos modificados (CDC) para transmitir datos desde una base de datos de Cloud SQL para SQL Server a un destino compatible, como BigQuery o Cloud Storage.

1. Conéctese a su instancia de Cloud SQL. Puedes hacerlo con el comando gcloud sql connect en el símbolo del sistema de Cloud Shell.

2. Ejecuta el siguiente comando para habilitar la CDC en la base de datos:

   EXEC msdb.dbo.gcloudsql_cdc_enable_db 'DATABASE_NAME'
   

   Reemplaza DATABASE_NAME por el nombre de tu base de datos de origen.

3. Habilita la CDC en las tablas para las que necesitas capturar cambios:

   USE [DATABASE_NAME]
   EXEC sys.sp_cdc_enable_table
   @source_schema = N'SCHEMA_NAME',
   @source_name = N'TABLE_NAME',
   @role_name = NULL
   GO
   

4. Habilita el aislamiento de instantánea.

   Cuando completas los datos faltantes de tu base de datos de SQL Server, es importante garantizar instantáneas coherentes. Si no aplicas la configuración que se describe en esta sección, los cambios que se realicen en la base de datos durante el proceso de carga inicial podrían generar duplicados o resultados incorrectos. Es necesario aplicar la configuración de aislamiento de instantáneas si tu transmisión incluye tablas sin claves primarias.

   Habilitar el aislamiento de instantáneas crea una vista temporal de tu base de datos al comienzo del proceso de relleno. Esto garantiza que los datos que se copian sigan siendo coherentes, incluso si otros usuarios realizan cambios en las tablas activas al mismo tiempo. Habilitar el aislamiento de instantáneas puede tener un ligero impacto en el rendimiento, pero es fundamental para una extracción de datos confiable.

   Para habilitar el aislamiento de instantánea, haz lo siguiente:

   1. Conéctate a tu base de datos con un cliente de SQL Server.
   2. Ejecuta el comando siguiente:

   ALTER DATABASE DATABASE_NAME SET ALLOW_SNAPSHOT_ISOLATION ON;
   

   Reemplaza DATABASE_NAME por el nombre de tu base de datos.

5. Crea un usuario de Datastream:

   1. En la consola de Google Cloud , ve a la página Instancias de Cloud SQL.

      Ir a Instancias de Cloud SQL

   2. Crea un usuario y asígnale los roles db_owner y db_denydatawriter:

   CREATE USER USER_NAME FOR LOGIN YOUR_LOGIN;
   

   EXEC sp_addrolemember 'db_owner', 'USER_NAME';
   EXEC sp_addrolemember 'db_denydatawriter', 'USER_NAME';
   

Pasos adicionales requeridos para el método CDC de registros de transacción

Los pasos que se describen en esta sección solo son necesarios cuando configuras tu base de datos de origen de SQL Server para usarla con el método CDC de los registros de transacción.

1. Establece el intervalo de sondeo para el que deseas que los cambios estén disponibles en tu fuente.

   USE [DATABASE_NAME]
   EXEC sys.sp_cdc_change_job @job_type = 'capture' , @pollinginterval = 86399
   EXEC sp_cdc_stop_job 'capture'
   EXEC sp_cdc_start_job 'capture'
   

   El parámetro @pollinginterval se mide en segundos, y se recomienda establecer el valor en 86399. Esto significa que el registro de transacciones retiene los cambios durante 86,399 segundos (un día). La ejecución del procedimiento sp_cdc_start_job 'capture inicia la configuración.

2. Configura una protección contra el truncamiento de registros.

   Para asegurarte de que el lector de CDC tenga tiempo suficiente para leer los registros y, al mismo tiempo, permitir el truncamiento de registros para evitar el uso del espacio de almacenamiento, puedes configurar una protección de truncamiento de registros:

   1. Conéctate a la base de datos con un cliente de SQL Server.