Compartir a través de

Añadir origen de CDC de Azure SQL Database a una secuencia de eventos

En este artículo se muestra cómo agregar un origen de captura de datos modificados (CDC) de Azure SQL Database a una secuencia de eventos.

El conector de origen de CDC de Azure SQL Database para secuencias de eventos de Microsoft Fabric permite capturar una instantánea de los datos actuales en una base de datos de Azure SQL. A continuación, el conector supervisa y registra los cambios futuros a nivel de fila en estos datos. Una vez capturados los cambios en el flujo de eventos, puede procesar estos datos de CDC en tiempo real y enviarlos a diferentes destinos dentro de Fabric para su posterior procesamiento o análisis.

Nota:

Este origen no se admite en las siguientes regiones de la capacidad del área de trabajo: Oeste de EE. UU. 3, Oeste de Suiza.

Requisitos previos

  • Acceso a un área de trabajo en el modo de licencia de capacidad de Fabric (o) el modo de licencia de prueba con los permisos Colaborador o superior.
  • Un servidor de Azure SQL en ejecución con una base de datos de Azure SQL.
  • La base de datos de Azure SQL debe ser de acceso público y no estar detrás de un firewall o protegida en una red virtual.
  • Habilite CDC en su base de datos de Azure SQL ejecutando el procedimiento almacenado sys.sp_cdc_enable_db. Para obtener más información, consulte Habilitación y deshabilitación de la captura de datos modificados.
  • Si no tienes una secuencia de eventos, crea una.

Tenga en cuenta que no debe habilitar la creación de reflejos en la base de datos de Azure SQL.

Habilitación de la CDC en su Azure SQL Database

  1. Vaya al Azure Portal, abra la Azure SQL Database y seleccione Editor de consultas. Elija un método de autenticación para iniciar sesión.

    Captura de pantalla de la apertura de Azure SQL Database.

  2. Ejecuta los siguientes comandos SQL para habilitar CDC en la base de datos:

    -- Enable Database for CDC
EXEC sys.sp_cdc_enable_db;

-- Enable CDC for a table using a gating role option
EXEC sys.sp_cdc_enable_table
    @source_schema = N'dbo',
    @source_name   = N'MyTable',
    @role_name     = NULL
GO

Iniciar el Asistente para seleccionar un origen de datos

Si aún no ha agregado ningún origen a la secuencia de eventos, seleccione el mosaico Usar origen externo.

Recorte de pantalla en el que se muestra la selección del icono Usar origen externo.

Si va a agregar el origen a un elemento Eventstream ya publicado, cambie al modo Editar, seleccione Agregar origen en la cinta de opciones y, a continuación, seleccione Orígenes externos.

Captura de pantalla que muestra la selección del menú Agregar origen a orígenes externos.  

En la página Seleccionar un origen de datos, busca y selecciona Conectar en el icono Azure SQL DB (CDC).

Captura de pantalla en el que se muestra la selección de Azure SQL DB (CDC) como tipo de origen en el asistente para obtener eventos.

Configuración y conexión a la CDC de la base de datos de Azure SQL

  1. En la página Conectar, seleccione Nueva conexión.

    Captura de pantalla que muestra la página Conectar del asistente para obtener eventos con el vínculo **Nueva conexión** resaltado.

  2. En la sección Configuración de la conexión, introduzca los siguientes valores para la base de datos de Azure SQL:

    • Servidor: Introduzca el nombre del servidor de Azure SQL desde el portal de Azure. Tiene este formato: mysqlservername.database.windows.net.

    • Base de datos: escriba el nombre de la base de datos de Azure SQL en Azure Portal.

      Captura de pantalla en la que se muestra la sección Configuración de la conexión de la página Nueva conexión.

  3. Desplácese hacia abajo y, en la sección Credenciales de conexión, siga estos pasos.

    • Para Nombre de conexión, introduzca un nombre para la conexión.

    • Para Tipo de autenticación, seleccione Básica.

      Nota:

      Actualmente, las secuencias de eventos de Fabric solo admiten la autenticación Básica.

    • Escriba el Nombre de usuario y la Contraseña de la base de datos.

  4. Seleccione Conectar.

    Captura de pantalla que muestra la sección de credenciales de conexión de la página Nueva conexión.

  5. Ahora, en la página Conectar , seleccione Todas las tablas o Escriba nombres de tabla. Si selecciona este último, especifique tablas con una lista separada por comas de identificadores de tabla completos (schemaName.tableName) o expresiones regulares válidas. Por ejemplo:

    • Use dbo.test.* para seleccionar todas las tablas cuyos nombres empiecen por dbo.test.
    • Use dbo\.(test1|test2) para seleccionar dbo.test1 y dbo.test2.

    Puede mezclar ambos formatos mediante comas. Se pueden escribir hasta 100 tablas, con cada nombre de tabla (incluido el nombre de esquema) limitado a 128 caracteres si se usan identificadores de tabla completos directamente.

  6. Puede expandir Opciones avanzadas para configurar el modo de control decimal, que especifica cómo controla DECIMAL el conector y NUMERIC los valores de columna:

    • Precise: representa valores que usan tipos decimales exactos (por ejemplo, Java BigDecimal) para garantizar una precisión y precisión completas en la representación de datos.
    • Double: convierte valores en números de punto flotante de precisión doble. Esto mejora la facilidad de uso y el rendimiento, pero puede provocar una pérdida de precisión.
    • String: codifica los valores como cadenas con formato. Esto facilita que se consuman en sistemas posteriores, pero se pierde información semántica sobre el tipo numérico original.

  7. Seleccione Siguiente.

    Captura de pantalla que muestra la página Conectar del asistente para Obtener eventos rellenada.

  8. En la pantalla Revisar y crear, revise el resumen y, a continuación, seleccione Agregar.

    Captura de pantalla que muestra la página Revisar y crear del asistente para Obtener eventos rellenada.

Visualización del flujo de eventos actualizado

  1. Puede ver la fuente de Azure SQL Database (CDC) agregada a la secuencia de eventos en Modo de edición.

    Captura de pantalla del streaming del origen CDC de Azure SQL Database en la vista de Editar.

  2. Para implementar este origen de CDC de Azure SQL Database recién agregado, seleccione Publicar. Después de completar estos pasos, el origen de CDC de Azure SQL Database está disponible para su visualización en la Vista en vivo.

    Captura de pantalla del streaming del origen CDC de Azure SQL Database en la Vista en vivo.

Contenido relacionado

Otros conectores: