O espelhamento no Microsoft Fabric fornece uma experiência sem ETL perfeita para integrar seus dados existentes do Azure Cosmos DB com o restante dos dados no Fabric. Use as dicas neste artigo para ajudar a solucionar problemas que você pode enfrentar ao criar um banco de dados espelhado para o Azure Cosmos DB no Fabric.
Importante
O espelhamento para o Azure Cosmos DB está atualmente em versão prévia. Não há suporte para cargas de trabalho de produção durante a visualização. Atualmente, há suporte apenas para contas do Azure Cosmos DB para NoSQL.
Aqui está uma lista de problemas comuns e etapas relevantes de solução de problemas a seguir se o espelhamento de um banco de dados do Azure Cosmos DB para o Microsoft Fabric não estiver funcionando conforme o esperado.
O espelhamento está falhando ao carregar os bancos de dados com um erro "SQLAPIendpoint". Como resolver esse erro?
Esse erro normalmente indica que sua chave de conta do Azure Cosmos DB não é mais válida para a conexão selecionada. Depois que as credenciais de conexão forem atualizadas com uma chave de conta válida, configure o espelhamento novamente.
O Fabric não pode configurar o espelhamento com um erro que indica que minha conta do Azure Cosmos DB não tem backup contínuo. Como fazer para corrigir esse erro?
Habilite o backup contínuo para sua conta do Azure Cosmos DB. Para obter mais informações, consulte criar uma conta do Azure Cosmos DB com backup contínuo ou migrar uma conta existente do Azure Cosmos DB para backup contínuo.
Depois que o recurso de backup contínuo estiver habilitado, retorne à configuração de espelhamento do Fabric e continue com as etapas restantes.
Como saber se minha conta do Azure Cosmos DB tem backup contínuo habilitado?
Usando o portal do Azure, você pode verificar se o recurso de backup contínuo está habilitado localizando a opção Restauração pontual no menu de recursos da conta do Azure Cosmos DB. Se essa opção não estiver disponível, a conta não terá backup contínuo habilitado ou a conta estará migrando para backup contínuo.
Habilitar o backup contínuo na minha conta do Azure Cosmos DB está causando vários erros. Ainda posso configurar o espelhamento do Fabric?
Não, o backup contínuo deve ser habilitado para contas do Azure Cosmos DB destinadas a ser uma fonte de espelhamento.
Se houver uma mensagem de erro ao habilitar o backup contínuo para uma conta do Azure Cosmos DB, a conta poderá ter limitações bloqueando o recurso. Por exemplo, se você excluiu anteriormente o repositório analítico da conta, a conta não poderá dar suporte ao backup contínuo. Nesse cenário, a única opção restante é usar uma nova conta do Azure Cosmos DB para espelhamento.
Por que a replicação não está funcionando e estou recebendo "erro interno do servidor" ao selecionar "monitorar replicação"?
Se estiver usando a ID do Entra para autenticação, verifique se as permissões de controle de acesso baseadas em função necessárias foram adicionadas. Para obter mais informações, consulte as limitações de segurança de espelhamento do Azure Cosmos DB.
Caso contrário, a replicação poderá estar funcionando e você observará um erro transitório se o Azure Cosmos DB estiver limitando as solicitações do Fabric. Além disso, pode haver uma limitação do espelhamento com o Azure Cosmos DB causando esse problema. Para obter mais informações, consulte as limitações de espelhamento do Azure Cosmos DB.
Atualize o portal do Fabric e determine se o problema é resolvido automaticamente. Além disso, você pode desmarcar e reelecionar contêineres afetados para interromper e reiniciar a replicação. Se nenhuma dessas opções funcionar, abra um tíquete de suporte.
Como posso ter certeza de que o Fabric está replicando dados do Azure Cosmos DB?
Primeiro, siga as etapas gerais de solução de problemas para bancos de dados espelhados do Fabric. Para obter mais informações, consulte solução de problemas.
Na maioria dos casos, a opção de replicação monitor pode fornecer mais detalhes indicando se os dados estão sendo replicados para o Fabric com êxito. Uma etapa comum de solução de problemas é verificar se a hora da última atualização é recente. Se a hora não for recente, pare e reinicie a replicação como a próxima etapa. Observe que a "hora da última atualização" só será atualizada se o banco de dados de origem tiver alterações desde o tempo indicado para replicação. Se o banco de dados de origem não tiver atualizações, exclusões ou inserções, a "hora da última atualização" não será atualizada.
O painel "monitorar replicação" inclui tabelas sem linhas replicadas após um período significativo de tempo. A replicação está paralisada?
A replicação provavelmente está paralisada. Desmarque o contêiner afetado e selecione novamente para reiniciar a replicação como uma primeira etapa. Se essa etapa não funcionar, abra um tíquete de suporte.
Por que não consigo encontrar tabelas no ponto de extremidade de análise do SQL?
Primeiro, atualize os esquemas e o nó dbo para determinar se as tabelas estão prontas. As tabelas são carregadas automaticamente depois de prontas. Se nenhuma tabela estiver pronta após um período significativo de tempo, use o painel de replicação Monitor para determinar se ocorreram erros de replicação.
Por que minhas tabelas de warehouse de destino incluem apenas a coluna '_rid' após a replicação?
Primeiro, atualize os esquemas e o nó dbo para determinar se as tabelas estão prontas. As tabelas são carregadas automaticamente depois de prontas. Se mais colunas não estiverem prontas após um período significativo de tempo, use o painel de replicação Monitor para determinar se ocorreram erros de replicação.
Eu adicionei novos itens a um contêiner no meu banco de dados do Azure Cosmos DB. Esses itens não estão incluídos nos resultados das minhas consultas de ponto de extremidade de análise do SQL. Como saber se a replicação está funcionando?
A opção de replicação monitor pode fornecer mais detalhes indicando se os dados estão sendo replicados para o Fabric com êxito. Uma etapa comum de solução de problemas é verificar se a hora da última atualização é recente. Se a hora não for recente, pare e reinicie a replicação como a próxima etapa. Se a hora for recente, tente a consulta novamente. Às vezes, pode haver um atraso entre os dados que estão sendo inseridos no Azure Cosmos DB e que estão sendo replicados e disponíveis no Fabric.
Se os dados ainda não estiverem disponíveis, use o Lakehouse para criar um atalho e executar uma consulta Spark em um notebook. O Spark sempre mostra os dados mais recentes. Se os dados estiverem disponíveis no Spark, mas não na análise de SQL, abra um tíquete de suporte.
Se os dados também não estiverem disponíveis no Spark, poderá haver um problema não intencional com a latência de replicação. Aguarde algum tempo e tente novamente a replicação. Se os problemas persistirem, abra um tíquete de suporte.
Por que estou recebendo um texto JSON não está formatado corretamente. Mensagem de erro """ de caractere inesperado é encontrada na posição" ao executar consultas T-SQL no meu ponto de extremidade de análise do SQL?
O data warehouse não pode lidar com colunas de cadeia de caracteres JSON maiores que 8 KB. Dados aninhados representados como uma cadeia de caracteres JSON em tabelas de ponto de extremidade ou de warehouse de análise de SQL geralmente podem fazer com que a coluna aumente para mais de 8 KB de tamanho. Monitorando os níveis de aninhamento e a quantidade de dados se você receber essa mensagem de erro. Para obter mais informações, consulte as limitações do data warehouse.
O espelhamento do Cosmos DB dá suporte a nomes de coluna com caracteres especiais?
Sim, há suporte para nomes de coluna com espaços em branco ou caracteres curinga.=, ;, {}, (), \n, \t