Limitações nos bancos de dados espelhados no Microsoft Fabric do Azure Cosmos DB (Versão prévia)

Este artigo detalha as limitações atuais para contas do Azure Cosmos DB espelhadas no Microsoft Fabric. Os detalhes de limitação e cota nesta página estão sujeitos a alterações no futuro.

Disponibilidade

Há suporte para o espelhamento em um conjunto específico de regiões do Fabric e APIs do Azure Cosmos DB.

APIs com suporte

O espelhamento só está disponível para os tipos de conta do Azure Cosmos DB listados aqui.

Regiões com suporte

Aqui está uma lista de regiões que oferecem suporte ao espelhamento para o Azure Cosmos DB:

Limitações de conta e banco de dados

• Você poderá habilitar o espelhamento somente se a conta do Azure Cosmos DB estiver configurada com backup contínuo de 7 ou 30 dias.
• Todas as limitações atuais do recurso de backup contínuo no Azure Cosmos DB também se aplicam ao espelhamento do Fabric.
  • Essas limitações incluem, mas não estão limitadas a: incapacidade de desabilitar o backup contínuo uma vez habilitado e falta de suporte para contas de gravação de várias regiões. Para obter mais informações, consulte Limitações de backup contínuo do Azure Cosmos DB.
  • Você pode habilitar os recursos de armazenamento analítico e backup contínuo na mesma conta do Azure Cosmos DB.
• Não é possível desabilitar o recurso de repositório analítico em contas do Azure Cosmos DB com backup contínuo habilitado.
• Você não pode habilitar o backup contínuo em uma conta do Azure Cosmos DB que desabilitou anteriormente o recurso de repositório analítico para um contêiner.

Limitações de segurança

• As chaves de conta de leitura/gravação do Azure Cosmos DB são o único mecanismo com suporte para se conectar à conta de origem. Não há suporte para chaves de conta somente leitura, identidades gerenciadas e autenticação sem senha com controle de acesso baseado em função.
• Você deve atualizar as credenciais de conexão para espelhamento do Fabric se as chaves de conta forem giradas. Se você não atualizar as chaves, o espelhamento falhará. Para resolver essa falha, pare a replicação, atualize as credenciais com as chaves recém-giradas e reinicie a replicação.
• Os usuários do Fabric com acesso ao espaço de trabalho herdam automaticamente o acesso ao banco de dados espelho. No entanto, você pode controlar granularmente o workspace e o acesso em nível de locatário para gerenciar o acesso dos usuários em sua organização.
• Você pode compartilhar diretamente o banco de dados espelhado no Fabric.

Permissões

• Se você tiver apenas permissões de visualizador no Fabric, não poderá visualizar ou consultar dados no ponto de extremidade de análise do SQL.
• Se você pretende usar o data explorer, o explorador de dados do Azure Cosmos DB não usa as mesmas permissões que o Fabric. As solicitações para exibir e consultar dados usando o data explorer são roteadas para o Azure em vez do Fabric.

Segurança de rede

• A conta de origem do Azure Cosmos DB deve habilitar o acesso à rede pública para todas as redes.
• Os pontos de extremidade privados não têm suporte para contas do Azure Cosmos DB.
• O isolamento de rede usando técnicas e recursos como endereços IP ou pontos de extremidade de serviço não tem suporte para contas do Azure Cosmos DB.
• Os dados no OneLake não oferecem suporte a pontos de extremidade privados, chaves gerenciadas pelo cliente ou criptografia dupla.

Limitações do Data Explorer

• As consultas do Fabric Data Explorer são somente leitura. Você pode exibir contêineres, itens de exibição e itens de consulta existentes.
• Não é possível criar ou excluir contêineres usando o data explorer no Fabric.
• Não é possível inserir, modificar ou excluir itens usando o data explorer no Fabric.
• Você pode evitar o compartilhamento do banco de dados de origem compartilhando apenas o ponto de extremidade de análise do SQL com outros usuários para análise.
• Não é possível desativar o data explorer em um banco de dados espelhado.

Limitações de 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. Se os nomes de propriedade forem atualizados para remover esses caracteres inválidos, você deverá configurar um novo espelho para o mesmo banco de dados e contêiner e não poderá usar o espelho antigo.
• O Fabric OneLake espelha da região geograficamente mais próxima do Azure para a região de capacidade do Fabric em cenários em que uma conta do Azure Cosmos DB tem várias regiões de leitura. Em cenários de recuperação de desastres, o espelhamento verifica e seleciona automaticamente novas regiões de leitura, pois suas regiões de leitura podem potencialmente fazer failover e alterações.
• As operações de exclusão no contêiner de origem são refletidas imediatamente no Fabric OneLake usando espelhamento. Não há suporte para operações de exclusão reversível usando valores de TTL (tempo devida útil).
• O espelhamento não oferece suporte ao particionamento personalizado.
• O Fabric tem limitações existentes com o T-SQL. Para obter mais informações, consulte Limitações do T-SQL.

Alterações de esquema e dados

• Excluir e adicionar um contêiner semelhante substitui os dados nas tabelas de warehouse apenas pelos dados do novo contêiner.
• A alteração do tipo de dados em uma propriedade em vários itens faz com que o replicador faça upgrade dos dados, quando aplicável. Esse comportamento está em paridade com a experiência delta nativa. Qualquer dado que não se encaixe nos critérios compatíveis passa a ser um tipo nulo. Por exemplo, alterar uma propriedade de matriz para um upcast de cadeia de caracteres para um tipo nulo.
• Adicionar novas propriedades aos itens faz com que o espelhamento detecte perfeitamente as novas propriedades e adicione colunas correspondentes à tabela do warehouse. Se as propriedades do item forem removidas ou ausentes, elas terão um valor nulo para o registro correspondente.
• A replicação de dados usando espelhamento não tem um esquema de fidelidade total ou bem definido. O espelhamento rastreia automática e continuamente as alterações de propriedade e o tipo de dados (quando permitido).

Dados aninhados

• Os objetos JSON aninhados nos itens do Azure Cosmos DB são representados como cadeias de caracteres JSON em tabelas de warehouse.
• Comandos como OPENJSON, CROSS APPLY e OUTER APPLY estão disponíveis para expandir seletivamente os dados da cadeia de caracteres JSON.
• O PowerQuery inclui ToJson para expandir seletivamente os dados da cadeia de caracteres JSON.
• O espelhamento não tem restrições de esquema no nível de aninhamento. Para obter mais informações, confira Restrições de esquema de repositório analítico do Azure Cosmos DB.

Limitações do data warehouse

• O warehouse não pode processar colunas de cadeia de caracteres JSON com tamanho maior que 8 KB. A mensagem de erro para esse cenário é "O texto JSON não está formatado corretamente. Caractere inesperado '"' encontra-se na posição".
• Os dados aninhados representados como uma cadeia de caracteres JSON no ponto de extremidade de análise do SQL e 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.

Limitações de itens espelhados

• Habilitar o espelhamento para uma conta do Azure Cosmos DB em um workspace requer a função de administrador ou membro em seu workspace.
• A interrupção da replicação desabilita completamente o espelhamento.
• Iniciar a replicação propaga novamente todas as tabelas de warehouse de destino. Esta operação inicia efetivamente o espelhamento a partir do zero.

Fornecer comentários

Se você gostaria de fazer comentários sobre limitações, recursos ou problemas atuais, compartilhe conosco em fabriccosmosdbmirror@microsoft.com.

Conteúdo relacionado

• Espelhamento do Azure Cosmos DB (Versão prévia)
• Perguntas frequentes: bancos de dados espelhados no Microsoft Fabric do Azure Cosmos DB
• Solução de problemas: bancos de dados espelhados no Microsoft Fabric do Azure Cosmos DB