O espelhamento no Microsoft Fabric fornece uma experiência perfeita sem ETL para integrar seus dados existentes do Azure Cosmos DB com o restante dos seus 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 na malha.
Importante
O espelhamento para o Azure Cosmos DB está atualmente em visualização. Não há suporte para cargas de trabalho de produção durante a visualização. Atualmente, apenas contas do Azure Cosmos DB para NoSQL são suportadas.
Aqui está uma lista de problemas comuns e etapas de solução de problemas relevantes a serem seguidas 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 resolvo este 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 consegue configurar o espelhamento com um erro que indica que minha conta do Azure Cosmos DB não tem backup contínuo. Como faço 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.
Quando o recurso de backup contínuo estiver habilitado, retorne à configuração de espelhamento de malha e continue com as etapas restantes.
Como sei se minha conta do Azure Cosmos DB tem o 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 Point in Time no menu de recursos da conta do Azure Cosmos DB. Se essa opção não estiver disponível, a conta não tem o backup contínuo habilitado ou a conta está migrando para o 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 de malha?
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 pode ter limitações bloqueando o recurso. Por exemplo, se você excluiu anteriormente o repositório analítico da conta, a conta não poderá suportar 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" quando seleciono "monitorar replicação"?
A replicação pode estar funcionando e você está observando um erro transitório se o Azure Cosmos DB estiver limitando solicitações do Fabric. Além disso, pode haver uma limitação de espelhamento com o Azure Cosmos DB causando esse problema. Para obter mais informações, consulte Limitações de espelhamento do Azure Cosmos DB.
Atualize o portal do Fabric e determine se o problema foi resolvido automaticamente. Além disso, você pode parar e iniciar 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 de malha. Para obter mais informações, consulte solução de problemas.
Na maioria dos casos, a opção de replicação do Monitor pode fornecer mais detalhes indicando se os dados estão sendo replicados para a malha com êxito. Uma etapa comum de solução de problemas é verificar se a última hora atualizada é recente. Se o tempo não for recente, pare e reinicie a replicação como a próxima etapa. Observe que a "última hora de atualização" só será atualizada se o banco de dados de origem tiver alterações desde o tempo observado para replicação. Se o banco de dados de origem não tiver atualizações, exclusões ou inserções, a "última hora atualizada" não será atualizada.
O painel "replicação do monitor" inclui tabelas sem linhas replicadas após um período de tempo significativo. A replicação está travada?
É provável que a replicação esteja presa. Pare e reinicie a replicação como primeiro passo. Se esta etapa não funcionar, abra um tíquete de suporte.
Por que não consigo encontrar nenhuma tabela no ponto de extremidade da análise 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 estarem prontas. Se nenhuma tabela estiver pronta após um período de tempo significativo, use o painel de replicação Monitor para determinar se ocorreram erros de replicação.
Por que minhas tabelas de depósito de destino só incluem 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 estarem prontas. Se mais colunas não estiverem prontas após um período de tempo significativo, use o painel de replicação Monitor para determinar se ocorreram erros de replicação.
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 do SQL Analytics. Como posso saber se a replicação está a funcionar?
A opção de replicação do 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 última hora atualizada é recente. Se o tempo 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 serem inseridos no Azure Cosmos DB e serem replicados e disponibilizados no Fabric.
Se os dados ainda não estiverem disponíveis, use o Lakehouse para criar um atalho e executar uma consulta do Spark a partir de um bloco de anotações. O Spark sempre mostra os dados mais recentes. Se os dados estiverem disponíveis no Spark, mas não na análise SQL, abra um tíquete de suporte.
Se os dados também não estiverem disponíveis no Spark, pode haver um problema não intencional com a latência de replicação. Aguarde algum tempo e tente replicar novamente. Se os problemas persistirem, abra um tíquete de suporte.
Por que estou recebendo um "O texto JSON não está formatado corretamente. Caractere inesperado '"' é encontrado na posição" mensagem de erro ao executar consultas T-SQL no meu ponto de extremidade de análise SQL?
O armazém de dados não pode processar colunas de cadeia de caracteres JSON com mais de 8 KB de tamanho. Os dados aninhados representados como uma cadeia de caracteres JSON em tabelas de ponto de extremidade ou de depósito da análise 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 Limitações do data warehouse.
Por que estou recebendo um erro "Nome da coluna inválido" no painel "replicação do monitor"?
O espelhamento não oferece suporte a contêineres que contenham itens com nomes de propriedade que contenham espaços em branco ou caracteres curinga. Essa limitação faz com que o espelhamento para o contêiner específico falhe. Outros contêineres dentro dos mesmos bancos de dados ainda podem espelhar com êxito. Para obter mais informações, consulte Limitações de replicação.