O espelhamento no Microsoft Fabric fornece uma experiência perfeita sem ETL para integrar seus dados existentes do Azure Cosmos DB com o restante de 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 do 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 versão prévia. No momento, há suporte apenas para contas do Azure Cosmos DB for NoSQL.
Aqui está uma lista de problemas comuns e etapas de solução de problemas relevantes a serem seguidas caso o espelhamento de um banco de dados do Azure Cosmos DB para o Microsoft Fabric não esteja funcionando conforme o esperado.
Não consigo ver a opção de espelhamento na página "Criar" ou "Data Warehouse" do portal do Fabric. Como faço para habilitar o espelhamento?
O administrador da organização deve habilitar o recurso de espelhamento para ver a opção de espelhamento no workspace ou locatário do Fabric. Para obter mais informações, veja Habilitar espelhamento.
O espelhamento está falhando ao carregar os bancos de dados com um erro "SQLAPIendpoint". Como resolver esse erro?
Esse erro geralmente 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 indicando 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 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 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 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á oferecer 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 estou recebendo erros de "capacidade de avaliação" quando seleciono "Criar um banco de dados espelhado do Azure Cosmos DB"?
Você deve habilitar o espelhamento para seu workspace ou locatário. Para obter mais informações, veja habilitar espelhamento. Se você observar erros persistentes, abra um tíquete de suporte.
Por que estou recebendo "erro interno do servidor" quando seleciono "Criar um banco de dados espelhado do Azure Cosmos DB"?
Você deve habilitar o espelhamento para seu workspace ou locatário. Para obter mais informações, veja habilitar espelhamento. Se você observar erros persistentes, abra um tíquete de suporte.
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 as 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, confira 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 do Fabric. Para saber mais, consulte solução de problemas.
Na maioria dos casos, a opção Monitorar replicação pode fornecer mais detalhes indicando se os dados estão sendo replicados para o Fabric com êxito. Uma etapa comum da 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.
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á travada. Pare e reinicie a replicação como primeiro passo. Se essa etapa não funcionar, abra um tíquete de suporte.
Por que não consigo encontrar nenhuma tabela 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 Monitorar replicação para determinar se ocorreram erros de replicação.
Por que minhas tabelas de warehouse 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 prontas. Se mais colunas não estiverem prontas após um período significativo de tempo, use o painel Monitorar replicação 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 de análise do SQL. Como saber se a replicação está funcionando?
A opção Monitorar replicação pode fornecer mais detalhes indicando se os dados estão sendo replicados para o Fabric com êxito. Uma etapa comum da 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 consultar novamente. Às vezes, pode haver um atraso entre a inserção dos dados no Azure Cosmos DB e a replicação e disponibilização 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 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, pode haver um problema não intencional com a latência de replicação. Aguarde algum tempo e tente replicar novamente. Se o problema persistir, abra um tíquete de suporte.
Por que estou recebendo um "texto JSON não está formatado corretamente. Mensagem de erro de caractere inesperado '"' encontra-se na posição" ao executar consultas T-SQL em meu ponto de extremidade de análise do SQL?
O data warehouse não pode processar colunas de cadeia de caracteres JSON com tamanho maior que 8 KB. Os dados aninhados representados como uma cadeia de caracteres JSON no ponto de extremidade de análise do SQL ou como tabelas de warehouse geralmente podem fazer com que o tamanho da coluna aumente para mais de 8 KB. Monitoramento dos níveis de aninhamento e da 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 de coluna inválido" no painel "Monitorar replicação"?
O espelhamento não oferece suporte a contêineres que contêm itens com nomes de propriedade contendo espaços em branco ou caracteres curinga. Essa limitação faz com que o espelhamento do contêiner específico falhe. Outros contêineres dentro dos mesmos bancos de dados ainda podem espelhar com êxito. Para obter mais informações, confira limitações de replicação.