Perguntas frequentes sobre o Cosmos DB no Fabric

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

O Cosmos DB no Fabric é um banco de dados NoSQL otimizado para IA, configurado automaticamente para atender às necessidades do aplicativo por meio 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 é um banco de dados NoSQL distribuído. Você pode armazenar dados semiestruturados ou não estruturados no Cosmos DB no Fabric. O Cosmos DB no Fabric pode ser usado junto com seus dados relacionais e seus dados no OneLake in Fabric, habilitando uma plataforma de dados unificada para seus aplicativos.

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 restante da plataforma Fabric, permitindo análise contínua, inteligência em tempo real, UDFs (Funções de Dados do Usuário), GraphQL, Ciência de Dados e BI com Copilot e agentes de dados em um só lugar.

Para obter mais informações, consulte Cosmos DB no Fabric.

O Cosmos DB no Fabric usa o mesmo mecanismo e infraestrutura subjacentes que o Azure Cosmos DB, fornecendo as mesmas garantias de desempenho, confiabilidade e disponibilidade. No entanto, há diferenças importantes:

• Integração: o Cosmos DB no Fabric é totalmente integrado ao Microsoft Fabric e ao OneLake, fornecendo espelhamento automático de dados para análise sem pipelines DE ETL.
• Gerenciamento: o Cosmos DB no Fabric oferece uma experiência de gerenciamento simplificada com padrões otimizados, reduzindo a complexidade de gerenciamento de banco de dados.
• Cobrança: o uso é medido em CUs (unidades de capacidade) do Fabric em vez de RUs (unidades de solicitação) do Azure e é cobrado por meio da capacidade do Fabric.
• Autenticação: o Cosmos DB no Fabric usa a autenticação do Microsoft Entra exclusivamente, sem chaves primárias/secundárias.
• Licenciamento: requer uma licença do Power BI Premium, capacidade do Fabric ou capacidade de avaliação.

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

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

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

Para começar a usar o Cosmos DB no Fabric:

1. Verifique se você tem uma licença do Power BI Premium, Capacidade do Fabric ou Capacidade de Avaliação.
2. Navegue até o portal do Fabric e crie um novo banco de dados do Cosmos DB em seu workspace.
3. Crie contêineres para armazenar seus dados.
4. Conecte-se ao banco de dados usando os SDKs do Cosmos DB com a autenticação do Microsoft Entra.

Para obter um guia passo a passo, consulte Início Rápido: Criar um banco de dados do Cosmos DB no Microsoft Fabric.

O Microsoft Fabric expõe um ponto de extremidade compatível com os SDKs (kits de desenvolvimento de software) 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 no Fabric dá suporte aos SDKs do Cosmos DB, incluindo:

• SDK do .NET
• SDK do Python
• Java SDK
• SDK do JavaScript/Node.js
• GO SDK
• Rust SDK
• Apache Spark SDK

Use esses SDKs junto com a biblioteca de Identidade do Azure para autenticação do Microsoft Entra. Para obter mais informações, consulte conectar-se ao Cosmos DB no Fabric.

Não há suporte para chaves primárias e secundárias. Você deve usar identidades do Microsoft Entra (identidades de usuário, entidades de serviço ou identidades gerenciadas) para autenticar.

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

O Cosmos DB no Fabric dá suporte principalmente à linguagem de consulta NoSQL para consultar dados.

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

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

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

Sim. O Cosmos DB no Fabric dá suporte à agregação por meio de funções de agregação na linguagem de consulta NoSQL, incluindo COUNT, MAX, MIN, AVG e SUM. Essas funções podem ser usadas em consultas para executar análises em seus dados.

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

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

As transações podem ser executadas usando operações em lotes transacionais nos SDKs.

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

O Cosmos DB no Fabric dá suporte ao OCC (controle de simultaneidade otimista) por meio de marcas de entidade HTTP (ETags). Cada recurso tem uma ETag que é definida no servidor sempre que um documento é atualizado. As ETags podem ser usadas com o cabeçalho If-Match para permitir que o servidor decida se um recurso deve ser atualizado. Se a ETag não for mais atual, o servidor rejeitará a operação com um código de resposta "Falha de pré-condição HTTP 412" e o cliente deverá repetir o recurso para adquirir o valor ETag atual.

A maioria dos SDKs do Cosmos DB inclui classes para gerenciar o controle de simultaneidade otimista. Para obter mais informações, consulte o controle de simultaneidade otimista no Cosmos DB.

Sim. O Cosmos DB no Fabric dá suporte a consultas entre bancos de dados, permitindo que você consulte dados em vários bancos de dados do Cosmos DB e até mesmo bancos de dados SQL no mesmo workspace do Fabric. Essa experiência de consulta unificada permite análises avançadas em todo o seu patrimônio de dados.

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

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

Para obter mais informações, consulte o espelho OneLake no Cosmos DB no Fabric.

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

Para obter mais informações, consulte o espelho OneLake no Cosmos DB no Fabric.

Não. A replicação de dados para o OneLake é um recurso principal do Cosmos DB no Fabric e não pode ser desabilitada. Todos os dados em seus contêineres do Cosmos DB são automaticamente espelhados para o OneLake no formato Delta Parquet.

Para obter mais informações, consulte o espelho OneLake no Cosmos DB no Fabric.

Sim. No OneLake, as tabelas do Cosmos DB são armazenadas como tabelas Delta ordenadas por v, que dão suporte ao modo Direct Lake no Power BI. Isso permite relatórios de alto desempenho e baixa latência diretamente sobre seus dados do Cosmos DB sem duplicação de dados.

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

Você pode verificar o status da replicação navegando até a seção de replicação do banco de dados no portal do Fabric. Esta seção exibe metadados sobre replicação, incluindo o status da última sincronização e quaisquer erros que possam ter ocorrido.

Para obter mais informações, consulte o espelho OneLake no Cosmos DB no Fabric.

As RUs (unidades de solicitação) são uma moeda de desempenho que abstrai os recursos do sistema (CPU, IOPS e memória) necessários para executar operações de banco de dados. Todas as operações de banco de dados, incluindo leituras, gravações, 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 solicitação.

No Cosmos DB no Fabric, as unidades de solicitação são convertidas em CUs (unidades de capacidade) do Fabric para fins de relatório de cobrança e uso.

Para obter mais informações, consulte unidades de solicitação no Cosmos DB no Fabric e cobrança e utilização.

Todos os contêineres no Cosmos DB no Fabric usam a taxa de transferência provisionada de dimensionamento automático. Com o dimensionamento automático, os contêineres dimensionam automaticamente a taxa de transferência com base nas demandas de carga de trabalho, dimensionando entre 10% e 100% da taxa de transferência máxima configurada (RU/s). Quando sua carga de trabalho está ociosa, ela reduz para 10% do máximo para minimizar os custos. Quando a demanda aumenta, ela aumenta instantaneamente sem nenhum período de aquecimento.

Os contêineres criados no portal do Fabric têm uma taxa de transferência de dimensionamento automático padrão de 5.000 RU/s. Isso pode ser ajustado entre 1.000 e 50.000 RU/s usando o SDK do Cosmos DB.

Para obter mais informações, consulte a taxa de transferência de dimensionamento automático no Cosmos DB no Fabric.

Não. Todos os contêineres no Cosmos DB no Fabric devem usar a taxa de transferência provisionada de dimensionamento automático. Não há suporte para taxa de transferência provisionada sem servidor e manual (padrão). Os contêineres criados por meio do SDK devem ter a taxa de transferência definida como dimensionamento automático durante a criação do contêiner ou um erro será gerado informando "O Tipo de Oferta está restrito ao Dimensionamento Automático para sua conta".

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

• Os contêineres dão suporte a uma taxa de transferência máxima de dimensionamento automático de 50.000 unidades de solicitação por segundo (RU/s) por padrão.
• Os contêineres criados no portal do Fabric são alocados automaticamente em 5.000 RU/s de taxa de transferência máxima de dimensionamento automático.
• Os contêineres criados usando um SDK podem ser definidos com um mínimo de 1.000 RU/s até a taxa de transferência máxima de dimensionamento automático permitida.

A taxa de transferência máxima além de 50.000 RU/s pode ser aumentada enviando um tíquete de suporte.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

Você pode ler e atualizar a taxa de transferência de dimensionamento automático em um contêiner usando o SDK do Cosmos DB. Use os métodos de gerenciamento de taxa de transferência do SDK para obter a taxa de transferência atual e substituí-la por um novo valor.

Para obter exemplos de código, consulte a taxa de transferência de dimensionamento automático no Cosmos DB no Fabric.

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

O Cosmos DB no Fabric dá suporte a vários tipos de índice:

• Índice de intervalo: suporte para consultas de intervalo em tipos numéricos, de cadeia de caracteres e de data.
• Índice espacial: suporte para consultas geoespaciais usando tipos de dados de ponto, linha e polígono.
• Índice composto: suporte para otimizar consultas que filtram ou classificam várias propriedades simultaneamente.
• Índice de vetor: suporte para indexação e pesquisa de inserções de vetor para aplicativos de IA usando DiskANN ou índices de vetor simples quantificados.
• Índice de texto completo: suporte para indexação de texto completo e pesquisa em seus documentos com suporte específico ao idioma.

Para obter mais informações, consulte indexação no Cosmos DB no Fabric e indexação de vetores.

Você pode personalizar as políticas de indexação ao criar um contêiner ou atualizá-las posteriormente usando o SDK do Cosmos DB. As políticas de indexação permitem especificar quais caminhos incluir ou excluir da indexação, configurar tipos de índice (intervalo, espacial, composição) e otimizar o desempenho da consulta.

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

Sim. O Cosmos DB no Fabric dá suporte à indexação e pesquisa de vetores, habilitando aplicativos alimentados por IA com recursos de pesquisa de similaridade. Você pode armazenar e indexar inserções de vetor junto com seus documentos JSON e executar pesquisas de vetor eficientes usando DiskANN ou índices de vetor simples quantificados.

Para obter mais informações, consulte a indexação de vetores no Cosmos DB no Fabric e napesquisa híbrida.

O Cosmos DB no Fabric fornece vários recursos de segurança para ajudar a proteger seus dados por padrão. Esses recursos incluem, mas não se limitam a:

• Autenticação do Microsoft Entra para acesso seguro
• Criptografia de dados em repouso e em trânsito
• Controle de acesso baseado em workspace por meio de permissões do Fabric

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

O Cosmos DB no Fabric herda permissões de workspace do user Fabric. Por exemplo, se um usuário tiver permissões de visualizador de workspace, ele terá acesso somente leitura ao artefato do Cosmos DB. Atualmente, você pode definir permissões no nível do item. No entanto, eles serão aplicados a todos os artefatos do Cosmos DB dentro do espaço de trabalho.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

Não. A criptografia cmk (chave gerenciada pelo cliente) não está disponível no momento para o Cosmos DB no Fabric.

No momento, não há suporte para Link Privado no nível do artefato do Cosmos DB. No entanto, os Links Privados estão disponíveis no nível do locatário do Fabric para proteger a conectividade com o serviço fabric.

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

Não. Todos os dados no Cosmos DB no Fabric permanecem dentro de seu locatário e região do Fabric. A replicação de dados para o OneLake ocorre dentro do ambiente do cliente e não deixa os limites do locatário.

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

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

Você pode monitorar o consumo do Cosmos DB usando o aplicativo Métricas de Capacidade do Microsoft Fabric. Este aplicativo fornece uma exibição centralizada do consumo de capacidade em todas as cargas de trabalho do Fabric, incluindo o Cosmos DB. Você pode filtrar o aplicativo para mostrar apenas as atividades relacionadas ao Cosmos DB e acompanhar as tendências de uso.

Para obter mais informações, consulte a cobrança e a utilização do Cosmos DB no Fabric e monitore o Cosmos DB no Fabric.

Uma capacidade do Power BI Premium, fabric ou capacidade de avaliação é necessária para usar o Cosmos DB no Fabric. Seu uso é medido em relação às CUs (unidades de capacidade) disponíveis na capacidade do Fabric.

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

O Cosmos DB no Fabric está disponível em regiões em que o Microsoft Fabric tem suporte. Seu banco de dados do Cosmos DB está localizado na região do workspace do Fabric, que se baseia na região de capacidade.

Para obter a lista atual de regiões com suporte, consulte a disponibilidade regional do Fabric.

Seu banco de dados do Cosmos DB está localizado na região do workspace do Fabric. A região do workspace é determinada pela capacidade atribuída a ela, que é exibida nas configurações do Workspace na página de informações de licença .

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

Os bancos de dados do Cosmos DB no Fabric são implantados em uma única região (a região do workspace do Fabric). No momento, não há suporte para implantações de várias regiões. No entanto, a infraestrutura subjacente fornece alta disponibilidade dentro da região.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

Sim. O Cosmos DB implanta todos os recursos em zonas de disponibilidade, fornecendo resiliência aprimorada e alta disponibilidade em regiões com suporte.

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

Os bancos de dados dão suporte a um máximo de 25 contêineres por padrão. Esse limite pode ser aumentado enviando um tíquete de suporte.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

Não. Atualmente, não há suporte para procedimentos armazenados, gatilhos e UDFs (funções definidas pelo usuário) do Cosmos DB no Fabric.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

Não. Atualmente, não há suporte para renomeação de artefato para o Cosmos DB no Fabric.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

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

Cadeias de caracteres JSON em um documento com mais de 8 KB são truncadas quando consultadas do ponto de extremidade de análise de SQL espelhado. A solução alternativa é criar um atalho do banco de dados espelhado no Fabric Lakehouse ou usar o Spark para consultar seus dados.

Para obter mais informações, consulte as limitações do Cosmos DB no Fabric.

Sim. Você pode usar notebooks do Fabric para interagir com dados diretamente 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 de notebooks Apache Spark. Você pode usar o Spark para executar análises, fluxos de trabalho de ciência de dados e operações de machine learning em seus dados do Cosmos DB.

Para obter mais informações, consulte o espelho OneLake no Cosmos DB no Fabric ou use o Spark com o Cosmos DB no Fabric ou use blocos de anotações do Fabric com o Cosmos DB no Fabric.

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

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

Sim. Você pode implementar fluxos de trabalho de CI/CD para o Cosmos DB no Fabric usando os pipelines de implantação do Fabric e a integração do Git. Isso permite que você controle a versão de esquemas, configurações e automação de implantação do banco de dados.

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

Sim. Você pode migrar dados do Azure Cosmos DB para o Cosmos DB no Fabric usando vários métodos, incluindo:

• Pipelines do Azure Data Factory ou fabric Data Factory
• Recursos de importação em massa do Azure Cosmos DB nos SDKs
• Apache Spark para migração de dados em larga escala
• Scripts de migração personalizados usando os SDKs
• Ferramenta de Migração de Dados da Área de Trabalho do Azure Cosmos DB

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

Conteúdo relacionado

• Saiba mais sobre o Cosmos DB no Fabric
• Examinar as limitações do Cosmos DB no Fabric