Tutorial: Configuración del reflejo de Microsoft Fabric en SQL Server

1. Para replicar datos desde SQL Server 2025, debe tener un rol de miembro o administrador en su espacio de trabajo al crear una base de datos replicada desde el portal Fabric. Durante la creación, a la identidad administrada de SQL Server se le concede automáticamente el permiso de tipo "lectura y escritura" en la base de datos reflejada. Los usuarios con el rol de colaborador no tienen el permiso Volver a compartir necesario para completar este paso.

   A partir de SQL Server 2025, los permisos necesarios para el inicio de sesión de Fabric son:

   • Los permisos siguientes en la base de datos de usuario:
     • SELECT
     • ALTERAR CUALQUIER ESPEJO EXTERNO
     • VER EL ESTADO DE RENDIMIENTO DE LA BASE DE DATOS
     • VER EL ESTADO DE SEGURIDAD DE LA BASE DE DATOS

2. Conéctese a la instancia de SQL Server mediante una herramienta de consulta de T-SQL como SQL Server Management Studio (SSMS) o la extensión MSSQL para Visual Studio Code.

3. Conéctese a la base de datos master. Cree un inicio de sesión de servidor y asigne los permisos adecuados.

   Importante

   Para las instancias de SQL Server en un grupo de disponibilidad Always On, la cuenta de inicio de sesión debe crearse en todas las instancias de SQL Server. La fabric_login principal debe tener el mismo SID en cada instancia de réplica.

   • Cree un inicio de sesión autenticado de SQL denominado fabric_login. Puede elegir cualquier nombre para este inicio de sesión. Proporcione su propia contraseña segura. Ejecute el siguiente script de T-SQL en la base de datos de master:

   --Run in the master database
   USE [master];
   CREATE LOGIN [fabric_login] WITH PASSWORD = '<strong password>';
   

   • O bien, inicie sesión como administrador de Microsoft Entra y cree un inicio de sesión autenticado Microsoft Entra ID desde una cuenta existente (recomendado). Ejecute el siguiente script de T-SQL en la base de datos de master:

   --Run in the master database
   USE [master];
   CREATE LOGIN [bob@contoso.com] FROM EXTERNAL PROVIDER;
   

4. Conéctese a la base de datos de usuario que planea reflejar en Microsoft Fabric. Cree un usuario de base de datos conectado al inicio de sesión y conceda los privilegios mínimos necesarios:

   • Para un inicio de sesión autenticado de SQL:

   --Run in the user database
   CREATE USER [fabric_user] FOR LOGIN [fabric_login];
   
   GRANT SELECT, ALTER ANY EXTERNAL MIRROR, VIEW DATABASE PERFORMANCE STATE, VIEW DATABASE SECURITY STATE
      TO [fabric_user];
   

   • O bien, para un inicio de sesión autenticado Microsoft Entra (recomendado):

   --Run in the user database
   CREATE USER [bob@contoso.com] FOR LOGIN [bob@contoso.com];
   
   GRANT SELECT, ALTER ANY EXTERNAL MIRROR, VIEW DATABASE PERFORMANCE STATE, VIEW DATABASE SECURITY STATE
      TO [bob@contoso.com];
   

Para SQL Server versiones 2016-2022, un administrador debe ser miembro del rol de servidor sysadmin para configurar CDC. El rol de servidor sysadmin también es necesario para cualquier mantenimiento futuro de CDC. La creación de reflejo usa CDC si ya está habilitado para que la base de datos y las tablas se reflejen. Los pasos siguientes crean el fabric_login inicio de sesión y lo agregan al rol de servidor sysadmin para configurar CDC. Si CDC ya existe, no es necesario agregar temporalmente el fabric_login principal al rol de sysadmin servidor. Una vez configurado CDC, habilitar el reflejo solo requiere CONECTAR a nivel de servidor y los permisos SELECT y CONNECT a nivel de base de datos para replicar los datos.

1. Conéctese a la instancia de SQL Server mediante una herramienta de consulta de T-SQL como SQL Server Management Studio (SSMS) o la extensión MSSQL para Visual Studio Code.

2. Conéctese a la base de datos master. En este paso, creará un login de servidor y asignará los permisos adecuados.

   Si el CDC ya está habilitado para que la base de datos y las tablas se reflejen como un espejo, fabric_login no necesita ser miembro del rol de servidor sysadmin. Si CDC aún no está habilitado, fabric_login debe ser miembro del rol de servidor sysadmin para configurar CDC.

   Importante

   Para las instancias de SQL Server en un grupo de disponibilidad Always On, la cuenta de acceso debe crearse en todas las instancias de SQL Server. Repita los pasos siguientes en cada instancia de réplica. La fabric_login principal debe tener el mismo SID en cada instancia de réplica.

   Puede elegir cualquier nombre para este inicio de sesión. Es necesario pertenecer al rol de servidor sysadmin de la instancia de SQL Server 2016-2022 para enable o deshabilitar la captura de datos modificados.

   • Ejecute el siguiente script de T-SQL en la master base de datos para crear un inicio de sesión autenticado de SQL denominado fabric_login. Proporcione su propia contraseña segura.

   --Run in the master database
   USE [master];
   CREATE LOGIN [fabric_login] WITH PASSWORD = '<strong password>';
   GRANT CONNECT SQL TO [fabric_login];
   ALTER SERVER ROLE [sysadmin] ADD MEMBER [fabric_login];
   

   • O bien, inicie sesión como administrador de Microsoft Entra y cree un inicio de sesión autenticado Microsoft Entra ID desde una cuenta existente. Ejecute el siguiente script de T-SQL en la base de datos de master:

   --Run in the master database
   USE [master];
   CREATE LOGIN [bob@contoso.com] FROM EXTERNAL PROVIDER;
   GRANT CONNECT SQL TO [fabric_login];
   ALTER SERVER ROLE [sysadmin] ADD MEMBER [bob@contoso.com];
   

3. La pertenencia al rol de base de datos db_owner de la base de datos de origen para el reflejo es necesaria para administrar CDC.

   Conéctese a la base de datos de usuario que planea reflejar en Microsoft Fabric. Cree un usuario de base de datos conectado al inicio de sesión y conceda los privilegios mínimos necesarios.

   • Para un inicio de sesión autenticado de SQL:

   --Run in the user database
   CREATE USER [fabric_user] FOR LOGIN [fabric_login];
   GRANT CONNECT, SELECT TO [fabric_user];
   

   • O bien, para un inicio de sesión autenticado Microsoft Entra (recomendado):

   --Run in the user database
   CREATE USER [bob@contoso.com] FOR LOGIN [bob@contoso.com];
   GRANT CONNECT, SELECT TO [bob@contoso.com];
   

4. Una vez habilitado CDC, puede quitar fabric_login del rol de servidor sysadmin.

   • Para un inicio de sesión autenticado de SQL:

   --Run in the master database
   USE [master];
   ALTER SERVER ROLE [sysadmin] DROP MEMBER [fabric_login];
   

   • O bien, para un inicio de sesión autenticado Microsoft Entra (recomendado):

   --Run in the master database
   USE [master];
   ALTER SERVER ROLE [sysadmin] DROP MEMBER [bob@contoso.com];
   

Conexión del servidor a Azure Arc y habilitación de la identidad administrada

Para configurar Fabric Mirroring, debe configurar Azure Arc para la instancia de SQL Server 2025.

1. Si aún no lo está, conecte el servidor a Azure Arc e instale la extensión de Azure para SQL Server.

   • Siga los pasos descritos en Quickstart: conexión de una máquina híbrida con servidores habilitados para Azure Arc.
   • La extensión Azure para SQL Server se instala automáticamente al conectar la instancia de SQL Server a Azure Arc.
   • Para instancias de SQL Server que se ejecutan en un grupo de disponibilidad Always On, todos los nodos deben estar conectados a Azure Arc.

2. Si aún no está configurado, debe configurar Managed identity for SQL Server enabled by Azure Arc, que habilita la autenticación saliente necesaria para Fabric Mirroring.

3. Conéctese a la instancia local de SQL Server 2025. Al conectarse, seleccione Confiar en el certificado de servidor.

4. Vea las identidades administradas:

   --Run in the master database
   USE [master];
   SELECT *
   FROM sys.dm_server_managed_identities;
   

   Esto debe devolver 1 fila con los valores correctos client_id y tenant_id. Identity_type debe ser "Asignado automáticamente por el sistema".

Adición de permisos de identidades administradas en Microsoft Fabric

La identidad administrada del SQL Server se crea y se conceden permisos por Microsoft Fabric, automáticamente.

Sin embargo, para las instancias de SQL Server que se ejecutan en un grupo de disponibilidad Always On, a la identidad administrada asignada por el sistema (SAMI) de cada nodo secundario se le deben conceder permisos de Contributor al área de trabajo de Fabric. La extensión de Azure crea una identidad administrada para SQL Server cuando la instancia de SQL está conectada a Azure Arc y cada una de ellas debe tener permisos de Fabric manualmente.

1. En el portal de Fabric, conceda permisos de Fabric a la identidad administrada de cada nodo secundario.

   1. En el espacio de trabajo de Fabric, seleccione Administrar acceso.

      

   2. Seleccione Agregar personas o grupos.

   3. En el cuadro de diálogo Agregar personas , busque los nombres de servidor de cada nodo del grupo de disponibilidad.

   4. Conceda cada pertenencia al rol Colaborador .

      

Configuración de la puerta de enlace de datos de red virtual o local

Compruebe los requisitos de red para que Fabric acceda a la SQL Server. Debe instalar una puerta de enlace de datos local o crear una puerta de enlace de datos de red virtual para reflejar los datos. Asegúrese de que la red de la máquina de puerta de enlace local puede conectarse a la instancia de SQL Server. Para obtener más información, consulte Cómo: Proteger datos en bases de datos reflejadas de Microsoft Fabric desde SQL Server.

Para usar la puerta de enlace de datos local:

1. Descargue la puerta de enlace de datos local desde el Centro de descarga oficial de Microsoft.
2. Inicie la instalación. Siga las instrucciones de Instalación de una puerta de enlace de datos local.
   • Proporcione la dirección de correo electrónico de la cuenta Microsoft.
   • Nombre: MyOPDG o cualquier nombre que desee.
   • Clave de recuperación: proporcione una clave de recuperación segura.

Creación de un SQL Server reflejado

1. Abra el portal de Fabric.
2. Use un área de trabajo existente o cree una.
3. Vaya al panel Crear . Seleccione el icono Crear .
4. Desplácese para seleccionar Mirrored SQL Server base de datos.
5. Escriba el nombre de la base de datos de SQL Server que se va a reflejar y seleccione Crear.

Conexión de Fabric a la instancia de SQL Server

Para habilitar la creación de reflejo, debe conectarse a la instancia de SQL Server desde Fabric para iniciar la conexión desde Fabric. Los pasos siguientes le guían a través del proceso de creación de la conexión a la SQL Server:

1. En Nuevos orígenes, seleccione SQL Server base de datos. O bien, seleccione una conexión de SQL Server existente en el centro de OneLake.

2. Si seleccionó Nueva conexión, escriba los detalles de conexión a la instancia de SQL Server.

   • Server: el nombre de servidor completamente calificado que Fabric usa para llegar a su instancia de SQL Server, el mismo que usaría para SSMS.

   Sugerencia

   Instancias de SQL Server que están en un grupo de disponibilidad Always On, use el Always On listener para Server.

   • Database: escriba el nombre del SQL Server.
     • Conexión: cree una nueva conexión.
     • Nombre de conexión: se proporciona un nombre automático. Puede cambiarlo.
     • Puerta de enlace de datos: Seleccione la puerta de enlace de datos que configuró según su escenario.
     • Tipo de autenticación: elija el método de autenticación y proporcione el principal que configuró en Usar un inicio de sesión y un usuario de base de datos asignado.
     • Active la casilla Usar conexión cifrada .

3. Seleccione Conectar.

Preparación de la instancia de SQL Server

1. El servicio SQL Server Agent debe estar en ejecución. Se recomienda encarecidamente configurar el inicio automático.
2. La Captura de Datos Modificados (CDC) se habilitará y configurará automáticamente por Fabric Mirroring para cada tabla deseada en tu base de datos. Revise los problemas conocidos y los errores con CDC. CDC requiere que cada tabla tenga una clave principal.

Configuración de la puerta de enlace de datos de red virtual o local

Compruebe los requisitos de red para que Fabric acceda a la SQL Server. Debe instalar una puerta de enlace de datos local o crear una puerta de enlace de datos de red virtual para reflejar los datos. Asegúrese de que la red de la puerta de enlace de datos puede conectarse a la instancia de SQL Server. Para obtener más información, consulte Cómo: Proteger datos en bases de datos reflejadas de Microsoft Fabric desde SQL Server.

Para usar la puerta de enlace de datos local:

1. Descargar la puerta de enlace de datos local, ver Descargar la puerta de enlace de datos local desde el Centro de Descarga Oficial de Microsoft.
2. Inicie la instalación. Siga las instrucciones de Instalación de una puerta de enlace de datos local.
   • Proporcione la dirección de correo electrónico de la cuenta Microsoft.
   • Nombre: MyOPDG o cualquier nombre que desee.
   • Clave de recuperación: proporcione una clave de recuperación segura.

Crear un SQL Server en espejo

1. Abra el portal de Fabric.
2. Use un área de trabajo existente o cree una.
3. Vaya al panel Crear . Seleccione el icono Crear .
4. Desplácese para seleccionar Mirrored SQL Server base de datos.
5. Escriba el nombre de la base de datos de SQL Server que se va a reflejar y seleccione Crear.

Conexión de Fabric a la instancia de SQL Server

Para habilitar el Mirroring, debe conectarse a la instancia de SQL Server desde Fabric para iniciar la conexión desde Fabric. Los pasos siguientes le guían a través del proceso de creación de la conexión a la SQL Server:

1. En Nuevos orígenes, seleccione SQL Server base de datos. O bien, seleccione una conexión de SQL Server existente en el centro de OneLake.

2. Si seleccionó Nueva conexión, escriba los detalles de conexión a la instancia de SQL Server.

   • Server: la ruta de acceso de nombre de servidor completa que Fabric usa para llegar a la instancia de SQL Server, igual que usaría para SSMS.

   Sugerencia

   Para instancias de SQL Server en un grupo de disponibilidad Always On, use el Always On listener para Server.

   • Database: escriba el nombre del SQL Server.
     • Conexión: cree una nueva conexión.
     • Nombre de conexión: se proporciona un nombre automático. Puede cambiarlo.
     • Puerta de enlace de datos: Seleccione el nombre de la puerta de enlace de datos local que configuró según su escenario.
     • Tipo de autenticación: elija el método de autenticación y proporcione el principal que configuró en Usar un inicio de sesión y un usuario de base de datos asignado.

3. Seleccione Conectar.

Configurar réplicas secundarias de grupos de disponibilidad Always On

Esta sección solo es necesaria si la base de datos de origen para el reflejo del servidor SQL en Fabric es miembro de un grupo de disponibilidad Always On.

Si la base de datos de origen está en un grupo de disponibilidad AlwaysOn, se requieren pasos adicionales para configurar las réplicas secundarias. Repita estos pasos para cada réplica secundaria a fin de preparar el grupo de disponibilidad completo. Cada réplica requiere que los trabajos del Agente SQL se configuren para que CDC se comporte correctamente cuando esa réplica sea principal.

1. Ejecutar una conmutación del grupo de disponibilidad a una réplica secundaria.

2. Usa el script proporcionado para crear, si aún no existen, los trabajos de limpieza y captura en la base de datos del sistema de la instancia de réplica secundaria msdb. Estos trabajos son importantes para mantener los datos históricos retenidos por CDC.

   En el siguiente script, reemplace por <YOUR DATABASE NAME> el nombre de la base de datos de usuario que se reflejará. Ejecute el siguiente ejemplo de T-SQL en la base de datos de usuario:

   DECLARE @db nvarchar(128) = '<YOUR DATABASE NAME>';
   
   DECLARE @capture nvarchar(128) = N'cdc.' + @db + N'_capture';
   DECLARE @cleanup nvarchar(128) = N'cdc.' + @db + N'_cleanup';
   -- Names may differ. Run `SELECT * FROM msdb.dbo.sysjobs WHERE category_id = 13 or category_id = 16` to see if these names exist.
   
    IF NOT EXISTS (SELECT name, job_id FROM msdb.dbo.sysjobs WHERE name = @capture)
    BEGIN
        -- Create the capture job
        EXEC sys.sp_cdc_add_job @job_type = N'capture';
        PRINT 'CDC capture job has been created.';
    END
    ELSE
    BEGIN
        PRINT 'CDC capture job already exists.';
        -- Start capture job is running
        IF NOT EXISTS (SELECT j.name, j.enabled, ja.start_execution_date, ja.stop_execution_date
            FROM msdb.dbo.sysjobs AS j
            LEFT JOIN msdb.dbo.sysjobactivity AS ja ON j.job_id = ja.job_id
            WHERE j.name = @capture and ((ja.start_execution_date IS NOT NULL and ja.stop_execution_date IS NULL)) or j.enabled <> 0)
        BEGIN
            EXEC msdb.dbo.sp_start_job @job_name = @capture;
            PRINT 'CDC capture job started running.';
        END
        ELSE
        BEGIN
            PRINT 'CDC capture job already running.';
        END
    END
   
    IF NOT EXISTS (SELECT name,job_id FROM msdb.dbo.sysjobs WHERE name = @cleanup)
    BEGIN
        -- Create the cleanup job
        EXEC sys.sp_cdc_add_job @job_type = N'cleanup';
        PRINT 'CDC cleanup job has been created.';
    END
    ELSE
    BEGIN
        -- Ensure that the cleanup job is properly scheduled (default schedule)
        IF NOT EXISTS (SELECT j.name, j.enabled, ja.start_execution_date, ja.stop_execution_date
            FROM msdb.dbo.sysjobs AS j
            LEFT JOIN msdb.dbo.sysjobactivity AS ja ON j.job_id = ja.job_id
            WHERE j.name = @cleanup and j.enabled <> 0)
        BEGIN
            EXEC msdb.dbo.sp_update_job @job_name = @cleanup, @enabled = 1;
            PRINT 'CDC cleanup job updated to enabled.';
        END
        ELSE
        BEGIN
            PRINT 'CDC cleanup job already enabled.';
        END
        PRINT 'CDC cleanup job already exists.';
    END
   

   Los trabajos CDC de captura y limpieza se inician inmediatamente y se crean con la configuración predeterminada. Para obtener más información sobre los trabajos, consulte sys.sp_cdc_add_job (Transact-SQL).

3. Cada trabajo se ejecuta en cada réplica de grupo de disponibilidad de forma predeterminada, incluso si es una réplica secundaria. Esto provocará mensajes de error en los registros, ya que las bases de datos de usuario de las réplicas secundarias no se pueden escribir. Habilite los dos empleos o tareas CDC en las réplicas principales y deshabilítelos en las réplicas secundarias. Siga las instrucciones de Captura de datos de cambio en grupos de disponibilidad Always On.