Solución de problemas de bases de datos reflejadas de Fabric

En este artículo se describen los escenarios comunes, las resoluciones y las soluciones alternativas para las bases de datos reflejadas de Microsoft Fabric. Para cada origen de datos, revise también la solución de problemas específica, las preguntas más frecuentes (P+F) y las limitaciones.

Area	Referencia
Solución de problemas	Creación de reflejo para Azure Cosmos DB, Azure Database for PostgreSQL, Azure SQL Database, Azure SQL Managed Instance, Snowflake, SQL Server, Fabric SQL Database
Limitaciones	Creación de reflejo para Azure Cosmos DB, Azure Database for PostgreSQL, Azure Databricks, Azure SQL Database, Azure SQL Managed Instance, Snowflake, Google BigQuery, Oracle, SAP, SQL Server, Fabric SQL Database
Preguntas más frecuentes	Creación de reflejo para Azure Cosmos DB, Azure Database for PostgreSQL, Azure Databricks, Azure SQL Database, Azure SQL Managed Instance, Google BigQuery, SQL Server, Fabric SQL Database

Cambios en la capacidad de Fabric

Scenario	Description
Capacidad de tejido en pausa	La creación de reflejo se detiene y no se puede enumerar ni acceder al elemento de base de datos reflejado. Reanude o vuelva a asignar la capacidad al área de trabajo.
Capacidad de tejido reanudada	Cuando la capacidad se reanuda desde un estado en pausa, el estado de la base de datos reflejada aparece como Pausado. Como resultado, los cambios realizados en el origen no se replican en OneLake. Para reanudar la creación de reflejo, vaya a la base de datos reflejada en el portal de Fabric, seleccione Reanudar replicación. La creación de reflejo continúa desde donde se ha pausado. Tenga en cuenta que si la capacidad permanece en pausa durante mucho tiempo, es posible que la creación de reflejo no se reanude desde su punto de detención y se vuelvan a activar los datos desde el principio. Esto se debe a que pausar la replicación durante mucho tiempo puede hacer que el uso del registro de transacciones de la base de datos de origen aumente e impida el truncamiento del registro. Para minimizar el impacto en la base de datos, si el espacio de registro usado está cerca de estar lleno, cuando se reanude la creación de reflejo, se iniciará una nueva puesta en marcha de la base de datos para liberar el espacio de registro retenido.
Escalado de capacidad de Fabric	La creación de reflejo continúa. Si reduce verticalmente la capacidad, tenga en cuenta que el almacenamiento de OneLake para los datos reflejados está libre hasta un límite en función del tamaño de la capacidad, por lo que reducir verticalmente la capacidad puede incurrir en un cargo de almacenamiento adicional. Obtenga más información en Costo de creación de reflejo.
Capacidad de tejido limitada	Espere hasta que el estado de sobrecarga supere o actualice la capacidad. La creación de reflejo continuará una vez restaurada la capacidad. Obtenga más información en Acciones que puede realizar para recuperarse de situaciones de sobrecarga.
Capacidad de prueba de Fabric expirada	La creación de reflejo se detiene. Para conservar la base de datos reflejada, compre capacidad de Fabric. Obtenga más información en Expiración de la capacidad de prueba de Fabric.

Los datos no parecen replicarse

Si observa un retraso en la apariencia de los datos reflejados, compruebe lo siguiente:

• Estado de creación de reflejo: En la página de supervisión del portal de Fabric de la base de datos reflejada, compruebe el estado de la base de datos reflejada y tablas específicas, y la columna "Última finalización" que indica la última vez que Fabric actualiza la tabla reflejada desde el origen. Vacío significa que la tabla aún no está reflejada.

  Si habilita la supervisión del área de trabajo, puede comprobar la latencia de ejecución de la creación de reflejo, consultando el ReplicatorBatchLatency valor de los registros de operaciones de la base de datos reflejadas.

  Para los tipos de origen como Azure SQL Database, Azure SQL Managed Instance y Azure Database for PostgreSQL, siga las instrucciones específicas para comprobar también la configuración y el estado de la base de datos de origen.

• Datos en OneLake: La creación de reflejo replica continuamente los datos en OneLake en formato de tabla de Delta Lake. Para validar si los datos llegan correctamente a OneLake, puede crear un acceso directo desde las tablas reflejadas en una instancia de Lakehouse y, a continuación, crear cuadernos con consultas de Spark para consultar los datos. Obtenga más información sobre Explorar con cuadernos.

• Datos en el punto de conexión de SQL Analytics: Puede consultar los datos reflejados a través del punto de conexión de SQL Analytics de la base de datos reflejada o una instancia de Lakehouse con un acceso directo a los datos reflejados. Cuando vea un retraso, valide el estado de creación de reflejo y los datos en OneLake como se mencionó anteriormente en primer lugar. Si los datos se muestran en OneLake pero no en el punto de conexión de SQL Analytics, puede deberse a un retraso en la sincronización de metadatos en el punto de conexión de SQL Analytics.

  Puede forzar manualmente una actualización del examen automático de metadatos. En la página del punto de conexión de SQL Analytics, seleccione el botón Actualizar como se muestra en la imagen siguiente. Espere algún tiempo y vuelva a consultar los datos para comprobarlos.

  

Detención replicación

Al seleccionar Detener replicación, los archivos OneLake permanecen tal como está, pero la replicación incremental se detiene. Puede reiniciar la replicación en cualquier momento seleccionando Iniciar replicación. Es posible que quiera detener o iniciar la replicación al restablecer el estado de replicación, después de que la base de datos de origen cambie o como herramienta de solución de problemas.

Replicación de la jerarquía de esquemas de origen

Al reflejar datos de varios tipos de bases de datos de origen, la jerarquía de esquemas de origen se conserva en la base de datos reflejada. Garantiza que los datos permanecen organizados de forma coherente en distintos servicios, lo que le permite consumirlos con la misma lógica en el punto de conexión de SQL Analytics, cuadernos de Spark, modelos semánticos y otras referencias a los datos.

En el caso de las bases de datos reflejadas creadas antes de habilitar esta característica, verá que el esquema de origen se aplana en la base de datos reflejada y el nombre del esquema se codifica en el nombre de la tabla. Si desea reorganizar tablas con esquemas, vuelva a crear la base de datos reflejada.

Si usa la API para crear o actualizar la base de datos reflejada, establezca el valor de la propiedad defaultSchema, que indica si se va a replicar la jerarquía de esquemas de la base de datos de origen. Consulte los ejemplos de definición de la API REST pública de creación de reflejo de Microsoft Fabric.

Compatibilidad con la asignación de columnas delta

La creación de reflejo admite la replicación de columnas que contienen espacios o caracteres especiales en nombres (como ,;{}()\n\t=) de las bases de datos de origen a las bases de datos reflejadas. En segundo plano, la creación de reflejo escribe datos en OneLake con la asignación de columnas delta habilitada.

Para las tablas que ya están en replicación antes de habilitar esta característica, para incluir columnas con caracteres especiales en los nombres, debe actualizar la configuración de la base de datos reflejada quitando y leyendo esas tablas, o bien detener y reiniciar la base de datos reflejada.

Tomar posesión de una base de datos reflejada

Actualmente, la base de datos reflejada no admite el cambio de propiedad. Si una base de datos reflejada deja de funcionar porque el propietario del elemento ha dejado la organización o ya no es válida, debe volver a crear la base de datos reflejada.

Regiones soportadas

El reflejo de la base de datos y el reflejo abierto están disponibles en todas las regiones de Microsoft Fabric. Para obtener más información, consulte Disponibilidad de la región de Fabric.

Troubleshoot

Esta sección contiene los pasos generales de solución de problemas de creación de reflejo.

No puedo conectarme a una base de datos de origen

1. Compruebe que los detalles de conexión son correctos, el nombre del servidor, el nombre de la base de datos, el nombre de usuario y la contraseña.
2. Compruebe que el servidor no está detrás de un firewall o una red virtual privada. Abra los puertos de firewall adecuados.
   • Algunos orígenes reflejados admiten puertas de enlace de datos de red virtual o puertas de enlace de datos locales, consulte la documentación del origen para obtener soporte técnico de esta característica.

No se replican vistas

Actualmente, no se admiten vistas. Solo se admite la replicación de tablas normales.

No se replica ninguna tabla

1. Compruebe el estado de supervisión para comprobar el estado de las tablas. Para más información, consulte Supervisión de la replicación de la base de datos reflejada de Fabric.
2. Seleccione el botón Configurar replicación . Compruebe si las tablas están presentes en la lista de tablas o si hay alertas en cada detalle de tabla.

Faltan columnas en la tabla de destino

1. Seleccione el botón Configurar replicación .
2. Seleccione el icono Alerta junto a los detalles de la tabla si no se replican columnas.

Algunos de los datos de mi columna parecen truncarse

El punto de conexión de SQL Analytics admite varchar(max) hasta 16 MB.

• El límite de 16 MB se aplica a las tablas creadas después del 18 de noviembre de 2025 en bases de datos reflejadas, pero cada tipo de elemento reflejado puede tener un límite diferente e inferior. Por ejemplo, SQL Server en espejo soporta hasta 1 MB y Cosmos DB soporta hasta 2 MB. Consulte la tabla siguiente.
• Las tablas existentes creadas antes del 18 de noviembre de 2025 solo admiten varchar(8000) y deben volver a crearse para adoptar un nuevo tipo de datos y admitir datos mayores que 8 KB.

Elemento de plataforma reflejado	límite varchar(max)
SQL Server reflejado, Base de datos SQL de Azure, Instancia administrada de SQL de Azure	1 MB
Base de datos SQL en Fabric	1 MB
Azure Cosmos DB replicado	2 MB
Cosmos DB en Fabric	2 MB

La tabla o el esquema reflejados no se eliminan cuando se quitan en la base de datos de origen

Nivel de tabla:

• Al elegir reflejar una lista de tablas selectivas y se quita la tabla de origen, la tabla reflejada permanece y aparece el error "La tabla de origen no existe" en la supervisión. Si ya no desea replicar esta tabla, actualice la configuración de la base de datos reflejada y quítela, se eliminará la tabla reflejada.
• Al elegir reflejar todos los datos y se quita la tabla de origen, también se elimina la tabla reflejada.

Nivel de esquema: cuando el esquema se elimina en la base de datos de origen, se sigue viendo el esquema en el endpoint de SQL Analytics como un esquema vacío.

No puedo cambiar la base de datos de origen

No se admite el cambio de la base de datos de origen. Cree una nueva base de datos reflejada.

Limita los mensajes de error

Estos mensajes de error comunes tienen explicaciones y mitigaciones:

Mensaje de error	Razón	Mitigación
"El recuento de tablas puede superar el límite, podría haber algunas tablas que faltan".	Hay un máximo de 500 tablas.	En la base de datos de origen, quite o filtre las tablas. Si la nueva tabla es la 500ª tabla, no se requiere mitigación.
"La replicación se está limitando y se espera que continúe en AAAA-MM-DDTHH:MM:ss".	Hay un máximo de 1 TB de datos modificados capturados por base de datos reflejada al día.	Espere a que finalice la limitación.

Contenido relacionado

• ¿Qué es la creación de reflejos en Fabric?
• Supervisión de la replicación de base de datos reflejada en Fabric