La creación de reflejo en Microsoft Fabric ofrece una experiencia fluida sin ETL para integrar los datos existentes de Azure Cosmos DB con el resto de los datos en Fabric. Utilice las sugerencias de este artículo para solucionar los problemas que pueda experimentar al crear una base de datos reflejada para Azure Cosmos DB en Fabric.
Importante
La creación de reflejo para Azure Cosmos DB está actualmente en versión preliminar. No se admiten cargas de trabajo de producción durante la versión preliminar. Actualmente, solo se admiten cuentas de Azure Cosmos DB for NoSQL.
A continuación, se muestra una lista de problemas habituales y los pasos de solución de problemas que se deben seguir si la creación de reflejo de una base de datos de Azure Cosmos DB en Microsoft Fabric no funciona según lo previsto.
Se produce un error en la creación de reflejo al cargar las bases de datos con un error "SQLAPIendpoint". ¿Cómo se resuelve este problema?
Este error suele indicar que la clave de cuenta de Azure Cosmos DB ya no es válida para la conexión seleccionada. Una vez actualizadas las credenciales de conexión con una clave de cuenta válida, vuelva a configurar la creación de reflejo.
Fabric no puede configurar la creación de reflejo con un error que indica que mi cuenta de Azure Cosmos DB no tiene copia de seguridad continua. ¿Cómo se corrige este error?
Habilite la copia de seguridad continua para la cuenta de Azure Cosmos DB. Para obtener más información, consulte Creación de una cuenta de Azure Cosmos DB con copia de seguridad continua o Migración de una cuenta de Azure Cosmos DB existente a una copia de seguridad continua.
Una vez habilitada la característica de copia de seguridad continua, vuelva a la configuración de creación de reflejo en Fabric y continúe con los pasos restantes.
¿Cómo puedo saber si mi cuenta de Azure Cosmos DB tiene habilitada la copia de seguridad continua?
Con Azure Portal, puede comprobar si la característica de copia de seguridad continua está habilitada mediante la búsqueda de la opción Restauración a un momento dado en el menú de recursos de la cuenta de Azure Cosmos DB. Si esta opción no está disponible, la cuenta no tiene habilitada la copia de seguridad continua o se está migrando a la copia de seguridad continua.
Cuando habilito la copia de seguridad continua en mi cuenta de Azure Cosmos DB, se producen varios errores. ¿Puedo configurar la creación de reflejo en Fabric?
No, la copia de seguridad continua debe estar habilitada para las cuentas de Azure Cosmos DB destinadas a ser un origen de creación de reflejo.
Si aparece un mensaje de error al habilitar la copia de seguridad continua para una cuenta de Azure Cosmos DB, es posible que esta tenga limitaciones y bloquee la característica. Por ejemplo, si eliminó previamente el almacén analítico de la cuenta, esta no podrá admitir la copia de seguridad continua. En este escenario, la única opción restante es usar una nueva cuenta de Azure Cosmos DB para la creación de reflejo.
¿Por qué la replicación no funciona y se muestra "error interno del servidor" al seleccionar "Supervisión de la replicación"?
Si la replicación funciona, se producirá un error transitorio si Azure Cosmos DB limita las solicitudes de Fabric. Además, puede haber una limitación de la creación de reflejo en Azure Cosmos DB que provoque este problema. Para obtener más información, consulte Límites a la creación de reflejo de Azure Cosmos DB.
Actualiza el portal de Fabric y comprueba si el problema se resuelve automáticamente. También puede detener e iniciar la replicación. Si ninguna de estas opciones funciona, abra una incidencia de soporte técnico.
¿Cómo puedo asegurarme de que Fabric replique datos de Azure Cosmos DB?
Antes de nada, siga los pasos generales de solución de problemas para las bases de datos reflejadas de Fabric. Para obtener más información, consulte Solución de problemas.
En la mayoría de los casos, la opción Supervisión de la replicación proporciona más información para saber si los datos se replican en Fabric correctamente. Un paso de solución de problemas habitual es comprobar si la última hora actualizada es reciente. Si la hora no es reciente, el paso siguiente será detener y reiniciar la replicación. Tenga en cuenta que la "hora de la última actualización" solo se actualiza si la base de datos de origen ha sufrido cambios desde la hora anotada para la replicación. Si la base de datos de origen no tiene actualizaciones, eliminaciones o inserciones, no se actualizará la "hora de la última actualización".
El panel "Supervisión de la replicación" incluye tablas sin filas replicadas después de una cantidad de tiempo significativa. ¿La replicación está bloqueada?
Es probable que la replicación esté bloqueada. Detenga y reinicie la replicación como primer paso. Si esto no funciona, abra una incidencia de soporte técnico.
¿Por qué no veo ninguna tabla en el punto de conexión de análisis SQL?
Antes de nada, actualice el nodo Esquemas y dbo para comprobar si las tablas están listas. Las tablas se cargan automáticamente cuando están listas. Si no hay tablas listas después de una cantidad de tiempo significativa, use el panel Supervisión de la replicación para comprobar si ha ocurrido algún error de replicación.
¿Por qué las tablas de almacenamiento de destino solo incluyen la columna "_rid" después de la replicación?
Antes de nada, actualice el nodo Esquemas y dbo para comprobar si las tablas están listas. Las tablas se cargan automáticamente cuando están listas. Si no hay más columnas listas después de una cantidad de tiempo significativa, use el panel Supervisión de la replicación para comprobar si ha ocurrido algún error de replicación.
He agregado nuevos elementos a un contenedor en mi base de datos de Azure Cosmos DB. Estos no se incluyen en los resultados de mis consultas de punto de conexión de análisis SQL. ¿Cómo puedo saber si la replicación funciona?
La opción Supervisión de la replicación proporciona más información para saber si los datos se replican en Fabric correctamente. Un paso de solución de problemas habitual es comprobar si la última hora actualizada es reciente. Si la hora no es reciente, el paso siguiente será detener y reiniciar la replicación. Si la hora es reciente, vuelva a intentar la consulta. A veces, puede haber un retraso entre los datos que se introducen en Azure Cosmos DB y los que se replican y están disponibles en Fabric.
Si los datos aún no están disponibles, utilice Lakehouse para crear una combinación de teclas y ejecutar una consulta de Spark desde un cuaderno. Spark siempre muestra los datos más recientes. Si los datos están disponibles en Spark, pero no en el análisis SQL, abra una incidencia de soporte técnico.
Si los datos tampoco están disponibles en Spark, puede haber un problema no deseado con la latencia de replicación. Espere un tiempo y vuelva a intentar la replicación. Si el problema persiste, abra una incidencia de soporte técnico.
¿Por qué recibo el mensaje de error "El texto JSON no tiene el formato correcto. Carácter inesperado """ en la posición" al ejecutar consultas de T-SQL en el punto de conexión de análisis SQL?
El almacenamiento de datos no puede manipular columnas de cadena JSON con un tamaño superior a 8 KB. Los datos anidados representados como una cadena JSON en las tablas de almacenamiento o puntos de conexión de análisis de SQL normalmente pueden hacer que la columna aumente a más de 8 KB de tamaño. Niveles de supervisión del anidamiento y cantidad de datos si recibe este mensaje de error. Para obtener más información consulte Limitaciones de almacenamiento de datos.
¿Por qué recibo el error "Nombre de columna no válido" en el panel "Supervisión de la replicación"?
La creación de reflejo no admite contenedores que contengan elementos con nombres de propiedad que contengan espacios en blanco o caracteres comodín. Esta limitación hace que se produzca un error en la creación de reflejo del contenedor específico. Otros contenedores en las mismas bases de datos todavía pueden reflejarse correctamente. Para obtener más información, consulte Limitaciones de la replicación.