La mise en miroir dans Microsoft Fabric offre une expérience sans ETL transparente pour intégrer vos données Azure Cosmos DB existantes avec le reste de vos données dans Microsoft Fabric. Utilisez les astuces de cet article pour résoudre les problèmes que vous pouvez rencontrer lorsque vous créez une base de données miroir pour Azure Cosmos DB dans Microsoft Fabric.
Important
La mise en miroir d'Azure Cosmos DB est actuellement en préversion. Les charges de travail de production ne sont pas prises en charge dans la préversion. Seuls les comptes Azure Cosmos DB for NoSQL sont pris en charge.
Voici une liste des problèmes courants et des étapes pertinentes de résolution des problèmes à suivre si la mise en miroir d'une base de données Azure Cosmos DB vers Microsoft Fabric ne fonctionne pas comme prévu.
La mise en miroir échoue lors du chargement des bases de données avec une erreur « SQLAPIendpoint ». Comment faire pour résoudre cette erreur ?
Cette erreur indique généralement que votre clé de compte Azure Cosmos DB n'est plus valide pour la connexion que vous avez sélectionnée. Une fois les identifiants de connexion mis à jour avec une clé de compte valide, configurez à nouveau la mise en miroir.
Microsoft Fabric ne peut pas configurer la mise en miroir avec une erreur indiquant que mon compte Azure Cosmos DB n'a pas de sauvegarde continue. Comment résoudre cette erreur ?
Activez la sauvegarde continue pour votre compte Azure Cosmos DB. Pour plus d'informations, consultez créer un compte Azure Cosmos DB avec sauvegarde continue ou migrer un compte Azure Cosmos DB existant vers une sauvegarde continue.
Une fois la caractéristique de sauvegarde continue activée, revenez à la configuration de la mise en miroir Microsoft Fabric et poursuivez les étapes restantes.
Comment faire pour savoir si mon compte Azure Cosmos DB a une sauvegarde continue activée ?
Grâce au Portail Azure, vous pouvez avoir la case activée si la caractéristique de sauvegarde continue est activée en localisant l'option Limite de restauration dans le temps dans le menu de ressources du compte Azure Cosmos DB. Si cette option n'est pas disponible, le compte n'a pas de sauvegarde continue activée ou le compte migre vers une sauvegarde continue.
L'activation de la sauvegarde continue dans mon compte Azure Cosmos DB provoque diverses erreurs. Puis-je toujours configurer la mise en miroir Microsoft Fabric ?
Non. La sauvegarde continue doit être activée pour les comptes Azure Cosmos DB destinés à être une source de mise en miroir.
S'il existe un message d'erreur lors de l'activation de la sauvegarde continue pour un compte Azure Cosmos DB, le compte peut présenter des limitations bloquant la caractéristique. Par exemple, si vous avez précédemment supprimé le stockage analytique pour le compte, le compte ne peut pas prendre en charge la sauvegarde continue. Dans ce scénario, la seule option restante consiste à utiliser un nouveau compte Azure Cosmos DB pour la mise en miroir.
Pourquoi la réplication ne fonctionne-t-elle pas et je reçois « erreur de serveur interne » lorsque je sélectionne « surveiller la réplication » ?
La réplication peut fonctionner et vous observez une erreur temporaire si Azure Cosmos DB limite les demandes de Microsoft Fabric. En outre, une limitation de mise en miroir avec Azure Cosmos DB peut être à l'origine de ce problème. Pour plus d'informations, consultez Limitations de mise en miroir Azure Cosmos DB.
Actualisez le portail Fabric et déterminez si le problème est résolu automatiquement. En outre, vous pouvez arrêter et démarrer la réplication. Si aucune de ces options ne fonctionne, ouvrez un ticket de support.
Comment puis-je vérifier que Microsoft Fabric réplique des données à partir d'Azure Cosmos DB ?
Tout d'abord, suivez les étapes de résolution des problèmes générales pour les bases de données Microsoft Fabric en miroir. Pour plus d'informations, consultez Résolution des problèmes.
Dans la plupart des cas, l'option Surveiller la réplication peut fournir des détails supplémentaires indiquant si les données sont répliquées sur Microsoft Fabric avec succès. Une étape de résolution des problèmes courante consiste à avoir la case activée si la dernière heure actualisée est récente. Si l'heure n'est pas récente, arrêtez et redémarrez la réplication à l'étape suivante. Notez que l’« heure de la dernière actualisation » est mise à jour uniquement si la base de données source a changé depuis l’heure notée pour la réplication. Si la base de données source n’a pas de mises à jour, de suppressions ou d’insertions, l’« heure de la dernière actualisation » n’est pas mise à jour.
Le volet « surveiller la réplication » inclut des tables sans lignes répliquées après une durée importante. La réplication est-elle bloquée ?
La réplication est probablement bloquée. Arrêtez et redémarrez la réplication en première étape. Si cette option ne fonctionne pas, ouvrez un ticket de support.
Pourquoi ne puis-je trouver aucune table dans le point de terminaison d'analytique SQL ?
Tout d'abord, actualisez les schémas et le nœud dbo pour déterminer si les tables sont prêtes. Les tables sont automatiquement chargées une fois qu'elles sont prêtes. Si aucune table n'est prête après une durée importante, utilisez le volet Surveiller la réplication pour déterminer si des erreurs de réplication se sont produites.
Pourquoi mes tables d'entrepôt cible incluent-elles uniquement la colonne « _rid » après la réplication ?
Tout d'abord, actualisez les schémas et le nœud dbo pour déterminer si les tables sont prêtes. Les tables sont automatiquement chargées une fois qu'elles sont prêtes. Si d'autres colonnes ne sont pas prêtes après une durée importante, utilisez le volet Surveiller la réplication pour déterminer si des erreurs de réplication se sont produites.
J'ai ajouté de nouveaux articles à un conteneur dans ma base de données Azure Cosmos DB. Ces articles ne sont pas inclus dans les résultats de mes requêtes de point de terminaison d'analytique SQL. Comment faire pour savoir si la réplication fonctionne ?
L'option Surveiller la réplication peut fournir des détails supplémentaires indiquant si les données sont réplicables sur Microsoft Fabric avec succès. Une étape de résolution des problèmes courante consiste à avoir la case activée si la dernière heure actualisée est récente. Si l'heure n'est pas récente, arrêtez et redémarrez la réplication à l'étape suivante. Si l'heure est récente, réessayez votre requête. Parfois, il peut y avoir un retard entre les données insérées dans Azure Cosmos DB et elles sont répliquées et disponibles dans Microsoft Fabric.
Si les données sont toujours non disponibles, utilisez Lakehouse pour créer un raccourci et exécuter une requête Spark à partir d'un notebook. Spark affiche toujours les données les plus récentes. Si les données sont disponibles dans Spark, mais pas dans l'analytique SQL, ouvrez un ticket de support.
Si les données sont non disponibles dans Spark, la latence de réplication peut présenter un problème inattendu. Patientez un moment et réessayez la réplication. Si le problème persiste, ouvrez un ticket de support.
Pourquoi est-ce que je reçois un message d'erreur « le texte JSON n'est pas correctement mis en forme. Le caractère inattendu '"' est trouvé à la position » lors de l'exécution de requêtes T-SQL sur mon point de terminaison d'analytique SQL ?
L'entrepôt de données ne peut pas gérer les colonnes de chaîne JSON supérieures à 8 Kb de taille. Les données imbriquées représentées sous la forme d'une chaîne JSON dans les tables du point de terminaison d'analytique SQL ou de l’entrepôt peuvent généralement augmenter de plus de 8 Kb de taille. Surveillance des niveaux d'imbrication et de la quantité de données si vous recevez ce message d'erreur. Pour plus d'informations, consultez Limitations de Data Warehouse.
Pourquoi est-ce que je reçois une erreur « Nom de colonne non valide » dans le volet « surveiller la réplication » ?
La mise en miroir ne prend pas en charge les conteneurs qui contiennent des articles avec des noms de propriétés contenant des espaces blancs ou des caractères de carte génériques. Cette limitation entraîne l'échec de la mise en miroir pour le conteneur spécifique. D'autres conteneurs au sein des mêmes bases de données peuvent toujours être mis en miroir avec succès. Pour plus d'informations, consultez Limitations de réplication.