Perguntas frequentes sobre Cosmos DB em Fabric

O Microsoft Fabric é uma plataforma de dados completa pronta para a empresa. O Fabric unifica movimentação de dados, bancos de dados, engenharia de dados, ciência de dados, inteligência em tempo real, BI com copiloto e desenvolvimento de aplicativos. Você não precisa mais reunir esses serviços individualmente de vários fornecedores.

O Cosmos DB in Fabric é uma base de dados NoSQL otimizada para IA, configurada automaticamente para satisfazer as necessidades da sua aplicação através de uma experiência simplificada. Os desenvolvedores podem usar o Cosmos DB no Fabric para criar aplicativos de IA com facilidade, sem gerenciar configurações complexas de banco de dados. O Cosmos DB no Microsoft Fabric é baseado no Azure Cosmos DB, que fornece dimensionamento dinâmico, alta disponibilidade e confiabilidade para o banco de dados.

O Cosmos DB é uma base de dados NoSQL distribuída. Pode armazenar dados semi-estruturados ou não estruturados no Cosmos DB no Fabric. O Cosmos DB no Fabric pode ser usado juntamente com os seus dados relacionais e os seus dados no OneLake no Fabric, permitindo uma plataforma de dados unificada para as suas aplicações.

Os dados do Cosmos DB são disponibilizados automaticamente para o Fabric OneLake. Essa integração fornece integração profunda do Cosmos DB com o resto da plataforma Fabric, permitindo análises perfeitas, inteligência em tempo real, funções de dados do usuário (UDFs), GraphQL, ciência de dados e BI com o Copilot e agentes de dados em um só lugar.

Para mais informações, veja Cosmos DB em Fabric.

O Cosmos DB em Fabric utiliza o mesmo motor e infraestrutura subjacentes do Azure Cosmos DB, proporcionando as mesmas garantias de desempenho, fiabilidade e disponibilidade. No entanto, existem diferenças fundamentais:

• Integração: O Cosmos DB em Fabric está fortemente integrado com o Microsoft Fabric e o OneLake, fornecendo espelhamento automático de dados para análise sem pipelines ETL.
• Gestão: O Cosmos DB no Fabric oferece uma experiência de gestão simplificada com padrões otimizados, reduzindo a complexidade da gestão da base de dados.
• Faturação: A utilização é medida em unidades de capacidade Fabric (CUs) em vez de unidades de pedido Azure (RUs), e é faturada através da sua capacidade Fabric.
• Autenticação: O Cosmos DB no Fabric utiliza exclusivamente autenticação Microsoft Entra, sem chaves primárias/secundárias.
• Licenciamento: Requer uma licença Power BI Premium, Fabric Capacity ou Trial Capacity.

Para mais informações, consulte a visão geral do Cosmos DB no Fabric e faturação e utilização.

Yes. O Cosmos DB no Fabric permite que aplicações armazenem documentos JSON arbitrários sem definições de esquema ou dicas. O modelo de dados flexível e sem esquema é ideal para dados semi-estruturados ou não estruturados e facilita a evolução do seu modelo de dados ao longo do tempo. Os dados estão imediatamente disponíveis para consulta usando a linguagem de consulta NoSQL.

Para mais informações, consulte a visão geral do Cosmos DB no Fabric.

Para começar com o Cosmos DB em Fabric:

1. Certifique-se de que possui uma licença Power BI Premium, Fabric Capacity ou Trial Capacity.
2. Navegue até ao portal Fabric e crie uma nova base de dados Cosmos DB no seu espaço de trabalho.
3. Crie contentores para armazenar os seus dados.
4. Ligue-se à sua base de dados usando os SDKs do Cosmos DB com autenticação Microsoft Entra.

Para um guia passo a passo, veja Quickstart: Criar uma base de dados Cosmos DB no Microsoft Fabric.

O Microsoft Fabric expõe um endpoint compatível com os kits de desenvolvimento de software (SDKs) do Cosmos DB. Esses SDKs, juntamente com a biblioteca de Identidade do Azure correspondente, devem ser usados para se conectar ao banco de dados diretamente usando a autenticação do Microsoft Entra. Para obter mais informações, consulte conectar-se ao Cosmos DB no Microsoft Fabric usando a ID do Microsoft Entra.

O Cosmos DB em Fabric suporta os SDKs do Cosmos DB, incluindo:

• SDK para .NET
• Python SDK
• SDK de Java
• JavaScript/Node.js SDK
• GO SDK (Kit de Desenvolvimento de Software)
• Rust SDK
• Apache Spark SDK

Use estes SDKs juntamente com a biblioteca Azure Identity para autenticação Microsoft Entra. Para mais informações, consulte ligar ao Cosmos DB no Fabric.

Não, as chaves primárias e secundárias não são suportadas. Deve usar identidades do Microsoft Entra (identidades de utilizador, principais de serviço ou identidades geridas) para autenticar.

Para mais informações, consulte autenticação para Cosmos DB no Fabric.

O Cosmos DB em Fabric suporta principalmente a linguagem de consulta NoSQL para consultar dados.

A linguagem de consulta NoSQL fornece uma poderosa sintaxe semelhante à Structured Query Language (SQL) do American National Standards Institute (ANSI) para trabalhar com dados JSON. Essa linguagem foi projetada para ser familiar aos usuários com experiência em SQL, ao mesmo tempo em que suporta a flexibilidade e a natureza hierárquica dos documentos JSON.

O recurso de espelhamento interno do Cosmos DB no Fabric também oferece suporte ao uso de T-SQL para consultar dados. O espelhamento e o ponto de extremidade de análise SQL permitem que você use a sintaxe T-SQL familiar para trabalhar com seus dados do Cosmos DB, facilitando a integração com fluxos de trabalho e ferramentas existentes baseados em SQL.

Para obter mais informações, consulte Usar a linguagem de consulta NoSQL.

Yes. O Cosmos DB em Fabric suporta agregação através de funções agregadas na linguagem de consulta NoSQL, incluindo COUNT, MAX, MIN, AVG e SUM. Estas funções podem ser usadas em consultas para realizar análises dos seus dados.

Para mais informações, consulte a documentação da linguagem de consulta NoSQL.

Yes. O Cosmos DB em Fabric suporta transações entre documentos dentro de uma única partição. As transações são englobadas numa única partição lógica e executadas com semântica ACID (atomicidade, consistência, isolamento, durabilidade) como "tudo ou nada", isoladas de outras operações em execução simultânea. Se ocorrerem exceções, toda a transação será revertida.

As transações podem ser executadas usando operações em lote transacional nos SDKs.

Para mais informações, consulte as transações do Cosmos DB.

O Cosmos DB no Fabric suporta controlo de concorrência otimista (OCC) através de etiquetas de entidade HTTP (ETags). Cada recurso tem um ETag que é definido no servidor sempre que um documento é atualizado. Os ETags podem ser usados com o cabeçalho If-Match para permitir que o servidor decida se um recurso deve ser atualizado. Se o ETag já não estiver atual, o servidor rejeita a operação com um código de resposta "HTTP 412 Precondition failure", e o cliente tem de recuperar o recurso para adquirir o valor atual do ETag.

A maioria dos SDKs do Cosmos DB inclui classes para gerir o controlo otimista da concorrência. Para mais informações, consulte controlo otimista de concorrência no Cosmos DB.

Yes. O Cosmos DB em Fabric suporta consultas entre bases de dados, permitindo consultar dados em múltiplas bases de dados Cosmos DB e até em bases de dados SQL dentro do mesmo espaço de trabalho Fabric. Esta experiência unificada de consulta permite análises poderosas em todo o seu património de dados.

Para mais informações, consulte consultas entre bases de dados no Cosmos DB no Fabric.

Cada Cosmos DB na base de dados Fabric espelha automaticamente os dados para o OneLake no formato Delta Parquet. Este espelhamento acontece quase em tempo real, sem qualquer configuração ou configuração adicional. Os dados espelhados estão imediatamente disponíveis para análise, ciência de dados, relatórios Power BI e outras cargas de trabalho Fabric.

Para mais informações, veja o espelho do OneLake no Cosmos DB em Fabric.

A replicação de dados do Cosmos DB em Fabric para OneLake ocorre quase em tempo real. Inserções, atualizações e eliminações são replicadas com latência mínima, normalmente em segundos, dependendo do volume de alterações.

Para mais informações, veja o espelho do OneLake no Cosmos DB em Fabric.

Não. A replicação de dados para o OneLake é uma funcionalidade central do Cosmos DB no Fabric e não pode ser desativada. Todos os dados nos seus contentores Cosmos DB são automaticamente espelhados para o OneLake no formato Delta Parquet.

Para mais informações, veja o espelho do OneLake no Cosmos DB em Fabric.

Yes. No OneLake, as tabelas Cosmos DB são armazenadas como tabelas Delta ordenadas em v, que suportam o modo Direct Lake no Power BI. Isto permite relatórios de alto desempenho e baixa latência diretamente sobre os dados da sua base de dados Cosmos, sem duplicação de dados.

Para mais informações, consulte criar relatórios com o Cosmos DB no Fabric.

Pode verificar o estado da replicação navegando até à secção de replicação da sua base de dados no portal Fabric. Esta secção mostra metadados sobre replicação, incluindo o estado da última sincronização e quaisquer erros que possam ter ocorrido.

Para mais informações, veja o espelho do OneLake no Cosmos DB em Fabric.

As unidades de pedido (RUs) são uma moeda de desempenho que abstrai os recursos do sistema (CPU, IOPS e memória) necessários para realizar operações na base de dados. Todas as operações da base de dados, incluindo leituras, escritas, consultas e atualizações, são medidas em RUs. Por exemplo, uma leitura de ponto para um item de 1 KB consome uma unidade de pedido.

No Cosmos DB em Fabric, as unidades de pedido são convertidas em unidades de capacidade Fabric (CUs) para fins de faturação e reporte de utilização.

Para mais informações, consulte unidades de pedido no Cosmos DB no Fabric e faturação e utilização.

Todos os contentores no Cosmos DB no Fabric utilizam débito provisionado autoscale. Com a autoescalabilidade, os contentores escalam automaticamente o débito com base nas exigências da carga de trabalho, escalando entre 10% e 100% do débito máximo configurado (RU/s). Quando a sua carga de trabalho está inativa, reduz-se para 10% do máximo para minimizar custos. Quando a procura aumenta, esta escala instantaneamente sem qualquer período de aquecimento.

Os contentores criados no portal do Fabric têm um débito automático predefinido de 5.000 RU/s. Isto pode ser ajustado entre 1.000 e 50.000 RU/s usando o Cosmos DB SDK.

Para mais informações, consulte o débito autoscale no Cosmos DB no Fabric.

Não. Todos os contentores no Cosmos DB no Fabric devem usar débito autoscaled provisionado. O throughput provisionado manualmente (padrão) e serverless não é suportado. Os contentores criados através do SDK devem ter o throughput configurado para autoescalar durante a criação do contenteur, caso contrário será apresentado um erro a indicar "O Tipo de Oferta está restrito a Autoscale para a sua conta.".

Para mais informações, veja limitações para o Cosmos DB no Fabric.

• Os contentores suportam um débito máximo de autoescalabilidade de 50.000 unidades de pedido por segundo (RU/s) por defeito.
• Os contentores criados no portal Fabric recebem automaticamente um débito máximo de autoescala de 5.000 RU/s.
• Contentores criados usando um SDK podem ser definidos com um mínimo de 1.000 RU/s até ao débito máximo permitido de autoescalabilidade.

O débito máximo para além de 50.000 RU/s pode ser aumentado através do envio de um pedido de suporte.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Pode ler e atualizar o débito autoescalável num contentor usando o Cosmos DB SDK. Use os métodos de gestão de throughput do SDK para obter o throughput atual e substituí-lo por um novo valor.

Para exemplos de código, veja o débito autoescalável no Cosmos DB no Fabric.

O Cosmos DB no Fabric suporta indexação automática por defeito. Todas as propriedades nos seus documentos JSON são indexadas automaticamente por defeito. Os utilizadores podem também definir políticas de indexação personalizadas para incluir ou excluir caminhos específicos, configurar tipos de índice e otimizar para os seus padrões de consulta.

O Cosmos DB em Fabric suporta vários tipos de índice:

• Índice de intervalo: Suporte para consultas por intervalo em tipos numéricos, de strings e de data.
• Índice espacial: Suporte para consultas geoespaciais usando tipos de dados pontuais, de linha e de polígonos.
• Índice composto: Suporte para otimizar consultas que filtram ou ordenam em múltiplas propriedades simultaneamente.
• Índice vetorial: Suporte para indexação e pesquisa de embeddings vetoriais para aplicações de IA usando DiskANN ou índices vetoriais planos quantizados.
• Índice de texto completo: Suporte para indexação de texto completo e pesquisa nos seus documentos com suporte específico por língua.

Para mais informações, veja indexação no Cosmos DB no Fabric e indexação vetorial.

Pode personalizar políticas de indexação ao criar um contentor ou atualizá-las mais tarde usando o SDK da base de dados Cosmos. As políticas de indexação permitem-lhe especificar quais os caminhos a incluir ou excluir da indexação, configurar os tipos de índice (intervalo, espacial, composto) e otimizar o desempenho das consultas.

Para mais informações, consulte personalizar políticas de indexação no Cosmos DB no Fabric.

Yes. O Cosmos DB em Fabric suporta indexação vetorial e pesquisa, permitindo aplicações baseadas em IA com capacidades de pesquisa por similaridade. Pode armazenar e indexar embeddings vetoriais ao lado dos seus documentos JSON e realizar pesquisas vetoriais eficientes usando DiskANN ou índices vetoriais planos quantizados.

Para mais informações, consulte indexação vetorial no Cosmos DB no Fabric e pesquisa híbrida.

O Cosmos DB em Fabric oferece várias funcionalidades de segurança para ajudar a proteger os seus dados por defeito. Esses recursos incluem, mas não estão limitados a:

• Autenticação do Microsoft Entra para acesso seguro
• Encriptação de dados em repouso e em trânsito
• Controlo de acesso baseado em espaço de trabalho através de permissões do Fabric

Para mais informações, veja segurança do Cosmos DB no Fabric.

O Cosmos DB no Fabric herda as permissões do espaço de trabalho do utilizador Fabric. Por exemplo, se um utilizador tiver permissões de visualização de espaço de trabalho, terá acesso apenas de leitura ao artefacto da base de dados Cosmos. Atualmente, pode definir permissões ao nível do item. No entanto, serão aplicadas a todos os artefactos da Cosmos DB dentro do espaço de trabalho.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Não. A encriptação da chave gerida pelo cliente (CMK) não está atualmente disponível para o Cosmos DB no Fabric.

O Private Link não é atualmente suportado ao nível do artefacto da base de dados Cosmos. No entanto, estão disponíveis Links Privados ao nível do tenant Fabric para garantir a conectividade ao serviço Fabric.

Para mais informações, consulte os links privados no Fabric.

Não. Todos os dados no Cosmos DB no Fabric permanecem dentro do seu tenant e região do Fabric. A replicação de dados para o OneLake ocorre dentro do ambiente do cliente e não sai dos limites do inquilino.

O uso de computação e armazenamento do Cosmos no Fabric é faturado através da sua capacidade do Fabric usando unidades de capacidade (CUs). As unidades de pedido (RUs) consumidas pelas operações do Cosmos DB são automaticamente convertidas em unidades de capacidade para fins de faturação. A fórmula de conversão é: 100 RU/s = 0,067 CUs/h.

Para mais informações, consulte faturação e utilização do Cosmos DB no Fabric.

Pode monitorizar o seu consumo na base de dados Cosmos usando a aplicação Microsoft Fabric Capacity Metrics. Esta aplicação fornece uma visão centralizada do consumo de capacidade em todas as cargas de trabalho do Fabric, incluindo o Cosmos DB. Pode filtrar a aplicação para mostrar apenas a atividade relacionada com o Cosmos DB e acompanhar as tendências de uso.

Para mais informações, consulte faturação e utilização do Cosmos DB no Fabric e monitorize o Cosmos DB no Fabric.

É necessário um Power BI Premium, Capacidade de Fabric ou Capacidade de Teste para usar o Cosmos DB no Fabric. O seu consumo é medido em função das unidades de capacidade (CUs) disponíveis na sua capacidade Fabric.

Para obter mais informações sobre licenciamento, consulte Licenças do Microsoft Fabric.

O Cosmos DB em Fabric está disponível em regiões onde o Microsoft Fabric é suportado. A sua base de dados Cosmos DB está localizada na região do seu espaço de trabalho Fabric, que é baseada na região de capacidade.

Para a lista atual de regiões suportadas, consulte a disponibilidade regional do Fabric.

A sua base de dados Cosmos DB está localizada na região do seu espaço de trabalho Fabric. A região do espaço de trabalho é determinada pela capacidade atribuída, que é exibida nas definições do Espaço de Trabalho , na página de informações da Licença .

Para mais informações, consulte a disponibilidade regional da Fabric.

O Cosmos DB nas bases de dados Fabric é implementado numa única região (a região do seu espaço de trabalho Fabric). Implementações multi-região não são atualmente suportadas. No entanto, a infraestrutura subjacente proporciona elevada disponibilidade dentro da região.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Yes. O Cosmos DB mobiliza todos os recursos entre zonas de disponibilidade, proporcionando maior resiliência e elevada disponibilidade nas regiões suportadas.

Para obter mais informações, consulte Suporte à zona de disponibilidade de malha.

As bases de dados suportam um máximo de 25 contentores por defeito. Este limite pode ser aumentado através da submissão de um pedido de suporte.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Não. Os procedimentos armazenados, triggers e funções definidas pelo utilizador (UDFs) do Cosmos DB não são atualmente suportados no Cosmos DB no Fabric.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Não. Atualmente, a renomeação de artefactos não é suportada para o Cosmos DB no Fabric.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Os documentos dentro do Cosmos DB têm um limite de 2 MB.

As strings JSON dentro de um documento com mais de 8 KB são truncadas quando consultadas a partir do endpoint de análise SQL espelhado. A solução alternativa é criar um atalho da base de dados espelhada no Fabric Lakehouse ou usar o Spark para consultar os seus dados.

Para mais informações, veja limitações para o Cosmos DB no Fabric.

Yes. Podes usar cadernos Fabric para interagir diretamente com dados no Cosmos DB no Fabric. Além disso, os dados no Cosmos DB no Fabric são automaticamente espelhados para o OneLake no formato Delta Parquet, tornando-os acessíveis a partir dos cadernos Apache Spark. Pode usar o Spark para realizar análises, fluxos de trabalho de ciência de dados e operações de aprendizagem automática nos seus dados do Cosmos DB.

Para mais informações, veja espelhar o OneLake no Cosmos DB no Fabric ou usar o Spark com o Cosmos DB no Fabric ou usar cadernos do Fabric com o Cosmos DB no Fabric.

Pode criar relatórios Power BI diretamente sobre o Cosmos DB em dados Fabric usando o modo Direct Lake. Os dados espelhados no OneLake são armazenados como tabelas Delta ordenadas em v, permitindo relatórios de alto desempenho sem duplicação de dados.

Para mais informações, consulte criar relatórios com o Cosmos DB no Fabric.

Yes. Pode implementar fluxos de trabalho CI/CD para o Cosmos DB no Fabric usando os pipelines de implementação do Fabric e a integração com Git. Isto permite-lhe controlar versões os esquemas da base de dados, configurações e automação de implementação.

Para mais informações, consulte integração contínua e implementação do Cosmos DB no Fabric.

Yes. Pode migrar dados do Azure Cosmos DB para o Cosmos DB no Fabric usando vários métodos, incluindo:

• Azure Data Factory ou Fabric Data Factory pipelines
• Funcionalidades de importação em massa do Azure Cosmos DB nos SDKs
• Apache Spark para migração de dados em grande escala
• Scripts de migração personalizados usando os SDKs
• Azure Cosmos DB Desktop Data Migration Tool

O processo de migração envolve exportar dados do Azure Cosmos DB e importá-los para o Cosmos DB no Fabric usando SDKs e strings de ligação compatíveis com autenticação Microsoft Entra.

Conteúdo relacionado

• Saiba mais sobre o Cosmos DB no Fabric
• Revisão das limitações do Cosmos DB no Fabric