Perguntas frequentes sobre o Azure Cosmos DB

O Azure Cosmos DB é adequado para casos de uso da Web, dispositivos móveis, jogos e IoT. Nesses casos de uso; escala automática, desempenho previsível, tempos de resposta rápidos em milissegundos e a capacidade de consultar dados sem esquema são importantes. O Azure Cosmos DB funciona bem em contextos de desenvolvimento rápido e dá suporte à iteração contínua de modelos de dados de aplicativos. Os aplicativos que gerenciam conteúdo e dados gerados pelo usuário geralmente são mapeados para casos de uso comuns do Azure Cosmos DB.

Uma RU (Unidade de Solicitação) é a medida de taxa de transferência no Azure Cosmos DB. O rendimento de uma única unidade de solicitação corresponde a taxa de transferência da ação GET HTTP para um documento de 1 quilobite. Todas as operações no Azure Cosmos DB; incluindo leituras, gravações, consultas e execuções de procedimentos armazenados; tem um valor unitário de solicitação determinístico com base na taxa de transferência necessária para concluir a operação. Em vez de ser forçado a considerar CPU, E/S e memória em relação a taxa de transferência do seu aplicativo, você pode pensar em termos de unidades de solicitação.

Você pode configurar cada contêiner do Azure Cosmos DB com taxa de transferência provisionada em termos de unidades de solicitação por segundo (RU/s). Você pode comparar solicitações individuais para medir em unidades de solicitação e criar um contêiner para lidar com a soma das unidades de solicitação em todas as solicitações desse contêiner em um segundo. Também é possível aumentar ou reduzir verticalmente a produtividade de seu contêiner, conforme as necessidades do aplicativo mudam. Para obter mais informações sobre como medir unidades de solicitação, veja a calculadora de taxa de transferência.

Os modelos de dados chave/valor (tabela), colunar, documento e grafo têm suporte nativo devido ao design ARS (átomos, registros e sequências) no qual o Azure Cosmos DB é criado. Os átomos, os registros e as sequências podem ser facilmente mapeados e projetados para vários modelos de dados. As APIs para um subconjunto de modelos estão disponíveis usando o design ARS (MongoDB, NoSQL, Table, Apache Cassandra e Apache Gremlin). O Azure Cosmos DB também dá suporte a outras APIs.

Um contêiner é um grupo de itens. Os contêineres podem abranger uma ou mais partições e podem ser dimensionados para lidar com volumes praticamente ilimitados de armazenamento ou taxa de transferência.

Um contêiner é uma entidade faturável, onde a taxa de transferência e o armazenamento usado determinam o custo. Cada contêiner é cobrado por hora com base na produtividade provisionada e no espaço de armazenamento usado. Para obter mais informações, veja Preços do Azure Cosmos DB.

O Azure Cosmos DB é o serviço de banco de dados multimodelo distribuído globalmente da Microsoft. Vários modelos refere-se ao suporte do Azure Cosmos DB para múltiplas APIs e modelos de dados. Neste paradigma, diferentes APIs usam diferentes formatos de dados para armazenamento e protocolo de ligação. Por exemplo; NoSQL usa JSON, MongoDB usa JSON codificado em binário (BSON), Table usa Entity Data Model (EDM), Cassandra usa Cassandra Query Language (CQL), Gremlin usa o formato JSON. Dessa forma, é recomendável usar a mesma API para todos os acessos aos dados em uma determinada conta.

Sim. As APIs do Azure Cosmos DB permitem a integração direta. Por exemplo, as APIs REST do Azure Cosmos DB podem ser integradas ao Gerenciamento de API do Azure para operações CRUD, eliminando a necessidade de serviços intermediários como o Azure Functions.

Sim, o Azure Cosmos DB está em conformidade com a HIPAA. A HIPAA estabelece os requisitos para o uso, a divulgação e a proteção de informações de integridade individualmente identificáveis. Para saber mais, confira o Centro de Confiabilidade da Microsoft.

Não há limite para a quantidade total de dados que um contêiner pode armazenar no Azure Cosmos DB.

Não há limite para a quantidade total de produtividade para a qual um contêiner dá suporte no Azure Cosmos DB. A ideia principal é distribuir sua carga de trabalho de maneira aproximadamente uniforme entre um número suficientemente grande de chaves de partição.

Sim, ambos os modos estão sempre totalmente criptografados.

O número de contêineres aprovisionados, o número de horas em que os contêineres estiveram online e a taxa de transferência aprovisionada para cada contentor determinam os custos de utilização do Azure Cosmos DB. Para obter mais detalhes sobre preços, consulte Preços do Azure Cosmos DB.

Para fazer uma pergunta técnica, poste em um desses dois fóruns de perguntas e respostas:

• Perguntas e respostas da Microsoft (perguntas e respostas)
• Stack Overflow. O Stack Overflow é o melhor para perguntas sobre programação. Forneça o máximo de detalhes possível, tornando a pergunta clara e respondível.

Para corrigir um problema com sua conta, apresente uma solicitação de suporte no portal do Azure.

Primeiro você deve se inscrever para uma assinatura do Azure. Depois de se inscrever em uma assinatura do Azure, você poderá adicionar o contêiner da API para NoSQL à sua assinatura do Azure.

SDKs (Software Development Kits) estão disponíveis para .NET, Python, Node.js, JavaScript, Go e Java. Os desenvolvedores também podem usar as APIs REST para interagir com os recursos do Azure Cosmos DB de mais plataformas e linguagens.

Confira estes exemplos de código de Início Rápido e modelos para a API para NoSQL:

• .NET
• Python
• Node.js / JavaScript
• Java/Spring
• Vá

Sim, a API para NoSQL permite que os aplicativos armazenem documentos JSON arbitrários como itens sem dicas nem definições de esquema. Os dados ficam imediatamente disponíveis para consulta com a linguagem de consulta do Azure Cosmos DB for NoSQL.

Sim, a API para NoSQL dá suporte a transações entre documentos que são expressas usando lotes nos SDKs ou como procedimentos armazenados e gatilhos do JavaScript. As transações têm como escopo uma única partição em cada contêiner e são executadas com a semântica ACID como “tudo ou nada”, isoladas de outras solicitações de códigos e de usuários executadas simultaneamente. Se ocorrerem exceções, toda a transação será revertida.

Você pode criar bancos de dados usando uma destas ferramentas:

• Portal do Azure
• SDKs do cliente da API para NoSQL (plano de dados)
  • .NET
  • Python
  • JavaScript
  • Java
  • Vá
• SDKs de gerenciamento API para NoSQL (plano de controle)
  • .NET
  • Python
  • JavaScript
  • Java
  • Vá
• Azure Resource Manager
  • Modelo JSON
  • Bíceps
  • Terraform
• REST API

Yes! O Azure Cosmos DB dá suporte à autenticação do Microsoft Entra para gerenciar o serviço e os recursos dele (plano de controle) e executar dados, operações e consultas (plano de dados). A autenticação do plano de controle é executada usando o recurso de controle de acesso baseado em função do Azure. Você pode usar uma função interna pré-configurada](../../role-based-access-control/built-in-roles.md) ou você pode criar uma função personalizada. Com o controle de acesso baseado em função do Azure, você pode gerenciar contas, bancos de dados, contêineres e metadados. O plano de controle inclui operações incluindo, mas não se limitando a esses exemplos.

• Criar, substituir ou excluir bancos de dados – Criar, substituir ou excluir contêineres – Ler ou substituir a taxa de transferência do banco de dados – Ler ou substituir a taxa de transferência do contêiner Autenticação de plano de dados usa uma API personalizada para implementação de controle de acesso baseado em função nativa do NoSQL. Com essa implementação nativa, você também pode usar funções pré-configuradas ou personalizadas. Com o controle de acesso baseado em função nativo, você pode executar consultas, gerenciar itens ou executar outras operações comuns. O plano de dados inclui operações incluindo, mas não se limitando a esses exemplos.
• Criar, substituir, atualizar ou excluir itens – Aplicar patches em itens – Executar consultas

O SQL é uma linguagem normalmente usada para consultar dados relacionais. A API para NoSQL tem uma linguagem de consulta NoSQL personalizada derivada do SQL. A linguagem de consulta NoSQL inclui um subconjunto da linguagem de consulta SQL normalmente associada ao SQL Server, juntamente com vários aprimoramentos específicos do NoSQL. A linguagem de consulta NoSQL fornece extensibilidade e operadores hierárquicos e relacionais por meio de JavaScript com base em UDFs (funções definidas por usuário). A gramática JSON permite modelar documentos JSON como árvores com nós rotulados, que são usados pelas técnicas de indexação automática do Azure Cosmos DB e pelo dialeto de consulta SQL do Azure Cosmos DB. Para obter informações sobre como usar essa linguagem de consulta, consulte Consulta NoSQL.

A API para NoSQL dá suporte à agregação por meio de funções de agregação como: COUNT, MAX, AVG e SUM por meio da linguagem de consulta NoSQL.

A API para NoSQL dá suporte ao OCC (controle de simultaneidade otimista) por meio das marcas da entidade HTTP ou Etags. Cada recurso da API para NoSQL tem uma Etag, a qual é definida no servidor sempre que um documento é atualizado. O cabeçalho da Etag e o valor atual são incluídos em todas as mensagens de resposta. As Etags podem ser usadas com o cabeçalho If-Match a fim de permitir que o servidor decida se um recurso deve ser atualizado. O valor de If-Match é o valor de Etag a ser comparado. Se o valor de Etag corresponder ao valor de Etag do servidor, o recurso será atualizado. Se a Etag não for mais atual, o servidor rejeitará a operação com um código de resposta "HTTP 412 Falha de pré-condição". O cliente refaz a busca do recurso a fim de obter o valor de Etag atual para o recurso. Além disso, pode-se utilizar ETags com o cabeçalho If-None-Match para determinar se uma nova busca de um recurso é necessária.

A maioria dos SDKs da API para NoSQL inclui classes para gerenciar o controle de simultaneidade otimista.

Use o recurso de importação em massa no SDK do .NET ou no SDK do Java para a API do NoSQL para importar grandes conjuntos de dados. Esse recurso otimiza a taxa de transferência provisionada para importar grandes conjuntos de dados.

Como alternativa, use Apache Spark para importar dados em escala usando Python ou Scala.

Sim. Como o Azure Cosmos DB for NoSQL é um serviço RESTful, os links de recursos são imutáveis e podem ser armazenados em cache. Os clientes da API para NoSQL podem especificar um cabeçalho “If-None-Match” para leituras em qualquer documento semelhante a recurso ou contêiner e atualizar suas cópias locais após a versão do servidor ser alterada.

Sim. O Emulador do Azure Cosmos DB fornece uma emulação de alta fidelidade do serviço Azure Cosmos DB. Ele dá suporte a funcionalidades idênticas ao Azure Cosmos DB em várias APIs. Essa funcionalidade inclui suporte para criar itens, consultar itens, provisionar contêineres e dimensionar contêineres. Você pode desenvolver e testar aplicativos usando os pontos de extremidade do emulador. Em seguida, você pode implantar os aplicativos no Azure em escala global alterando a cadeia de conexão do emulador para o serviço dinâmico.

Essa limitação do Data Explorer é uma limitação do JavaScript. O JavaScript usa números de formato de ponto flutuante de precisão dupla, conforme especificado no Institute of Electric and Electronics Engineers (IEEE) 754. Esse tipo de dados pode conter com segurança apenas números entre -(2⁵³ - 1) e 2⁵³-1 (ou seja, 9007199254740991).

O controle de acesso baseado em função (RBAC) é um método de regular o acesso a recursos de computador ou rede com base nas funções de usuários individuais dentro de uma empresa. No Azure Cosmos DB, o RBAC é usado para conceder acesso ao plano de dados pata usuários e aplicativos. Para obter mais informações sobre diversos termos no controle de acesso baseado em função, consulte o glossário de segurança.

Use o recurso RBAC (controle de acesso baseado em função) nativo do Azure Cosmos DB para conceder acesso ao plano de dados a usuários e aplicativos. Para obter mais informações, consulte Conceder acesso baseado em função de plano de dados.

Até o momento, há suporte apenas para a API NoSQL.

O suporte do portal do Azure para o gerenciamento de funções ainda não está disponível.

No momento, há suporte para os SDKs do .NET V3, do Java V4, do JavaScript V3 e do Python V4.3+.

Sim.

Sim. Para obter mais informações, consulte Desabilitar a autenticação baseada em chave.

A orientação geral para migrar uma conta do Cosmos DB para um grupo de recursos ou assinatura diferente está descrita no artigo movendo recursos do Azure para um novo grupo de recursos ou assinatura.

Depois de mover com êxito a conta do Azure Cosmos DB de acordo com a diretriz geral, todas as identidades (System-Assigned ou User-Assigned) associadas à conta deverão ser reatribuídas. Essa reatribuição é necessária para garantir que essas identidades continuem a ter as permissões necessárias para acessar a chave do Key Vault.

Se a sua conta do Cosmos DB tiver as chaves gerenciadas pelo cliente ativadas, você só poderá migrar a conta se ela for uma conta de chave gerenciada pelo cliente entre locatários. Para obter mais informações, consulte o guia sobre como configurar chaves gerenciadas pelo cliente entre locatários para sua conta do Azure Cosmos DB com o Azure Key Vault.

Ao migrar do modo periódico para o modo contínuo, você não pode executar nenhuma operação de plano de controle que execute atualizações ou exclusões no nível da conta. Por exemplo, operações como adicionar ou remover regiões, failover de conta, atualização da política de backup etc. não podem ser executadas enquanto a migração está em andamento. O tempo de migração depende do tamanho dos dados e do número de regiões em sua conta. A ação de restauração nas contas migradas só é bem-sucedida a partir do momento em que a migração é concluída com êxito.

Você pode restaurar sua conta após a conclusão da migração. Se a migração for concluída às 13h PST, você poderá fazer a restauração a partir de um ponto específico no tempo a partir das 13h PST.

Sim.

API para NoSQL, API para Tabela, API do Gremlin e API para contas do MongoDB que usam taxa de transferência provisionada compartilhada, provisionada ou dimensionada automaticamente dão suporte à migração para backup contínuo.

Contas com o Link do Azure Synapse habilitado ou que tinham o Link do Azure Synapse desabilitado para uma ou mais coleções não podem migrar para backup contínuo.

A migração leva uma quantidade variável de tempo que depende, em grande parte, do tamanho dos dados e do número de regiões em sua conta. Você pode obter o status de migração usando comandos da CLI do Azure ou do PowerShell. Para contas grandes com dezenas de terabytes de dados, a migração pode levar até alguns dias para ser concluída.

Sim, essa migração é um pouco demorada porque que depende, em grande parte, da necessidade de aguardar que todas as gravações provisórias antigas sejam drenadas durante a migração para o backup contínuo. Você pode obter o status de migração usando comandos da CLI do Azure ou do PowerShell. Para contas grandes com dezenas de terabytes de dados, a migração pode levar até alguns dias para ser concluída.

Não, a operação de migração ocorre em segundo plano. Portanto, as solicitações do cliente não são afetadas. No entanto, precisamos executar algumas operações de back-end durante a migração e pode levar tempo extra se a conta estiver sob carga pesada.

Depois que o processo de migração é iniciado, a conta é habilitada no modo contínuo. Se a migração falhar, você deverá iniciar a migração novamente até que ela seja bem-sucedida.

Suponha que você iniciou a migração em t1 e terminou em t5, você não pode usar um carimbo de data/hora de restauração entre t1 e t5. Suponha também que sua conta agora esteja no modo contínuo. Para restaurar para um tempo depois t5, execute a restauração usando o portal do Azure, a CLI ou o PowerShell, como normalmente com uma conta contínua. Essa solicitação de restauração de autoatendimento só pode ser feita após a conclusão da migração. Para fazer a restauração em um período antes de t1, abra um tíquete de suporte como de costume com uma conta de backup periódico. Após a migração, você tem até 30 dias para executar a restauração periódica. Durante esses 30 dias, você pode restaurar com base na retenção/intervalo de backup de sua conta antes da migração. Por exemplo, se o backup foi configurado para reter 24 cópias em intervalos de 1 hora, você pode restaurar a qualquer momento entre (t1 – 24 hours) e t1.

Operações como adicionar/remover região, failover, alterar política de backup e alterações de taxa de transferência resultantes da movimentação de dados são bloqueadas durante a migração.

A migração com falha não bloqueia nenhuma operação do plano de controle. Se a migração falhar, tente novamente até que tenha êxito antes de executar outras operações do plano de controle.

Não é possível cancelar a migração porque as migrações não são uma operação reversível. Por meio de uma chamada de suporte, a equipe pode cancelar temporariamente e permitir que as operações offline continuem. Mas não é possível voltar para o estado de backup periódico.

Não há uma ferramenta para estimar o tempo. Nossos testes e execuções de escala indicam que uma conta com 1 TB de dados leva cerca de 90 minutos. Para contas de várias regiões, calcule o tamanho total dos dados como Number_of_regions * Data_in_single_region.

Teste o recurso de modo de backup contínuo para verificar se ele funciona conforme o esperado antes de migrar contas de produção. A migração é uma operação unidirecional e não pode ser revertida.

Sim, você pode se inscrever para uma conta de banco de dados gratuita com 1.000 RU/s e 25 GB gratuitamente.

Se você estiver começando com o Azure, é possível inscrever-se para uma Conta gratuita do Azure, que oferece 30 dias e um crédito para testar todos os serviços do Azure. Se você tem uma assinatura do Visual Studio, também está qualificado para receber créditos Azure gratuitos para usar em qualquer serviço do Azure.

Também use o Emulador do Azure Cosmos DB para desenvolver e testar seu aplicativo no local, gratuitamente, sem criar uma assinatura do Azure. Quando estiver satisfeito com o funcionamento de seu aplicativo no Emulador do Azure Cosmos DB, você poderá passar a usar uma conta do Azure Cosmos DB na nuvem.

O Azure Cosmos DB está disponível no Portal do Azure. Primeiro, inscreva-se para uma assinatura do Azure. Depois de se inscrever, adicione uma conta do Azure Cosmos DB à sua assinatura do Azure.

Use a ID do Microsoft Entra para autenticar no Azure Cosmos DB para todas as APIs que dão suporte a esse método de autenticação. Para APIs que não dão suporte à autenticação do Microsoft Entra ID, use as chaves com cuidado. Verifique se as chaves das contas de produção são armazenadas com segurança, como no Azure Key Vault.

Para obter informações sobre a disponibilidade regional do Azure Cosmos DB, veja Produtos Azure disponíveis por região. Você pode contabilizar seu banco de dados em uma ou mais dessas regiões.

Os kits de desenvolvimento de software (SDKs) para Azure Cosmos DB permitem a configuração das regiões que utilizam para ligações. Na maioria dos SDKs, o valor `PreferredLocations`` é definido para qualquer uma das regiões do Azure em que o Azure Cosmos DB está disponível.

O Azure Cosmos DB está presente em todas as regiões do Azure, conforme especificado na página Regiões do Azure. Por ser um serviço central do Azure, cada novo datacenter tem uma presença do Azure Cosmos DB.

Quando você definir uma região, lembre-se de que o Azure Cosmos DB respeita nuvens soberanas e governamentais. Por exemplo, você não pode replicar dados de uma região soberana. Da mesma forma, você não pode habilitar a replicação em outros locais soberanos de uma conta externa.

O provisionamento de taxa de transferência no nível do contêiner e do banco de dados são ofertas separadas e alternar entre qualquer uma dessas ofertas exige a migração de dados da origem para o destino. Você precisa criar um novo banco de dados ou contêiner e depois migrar os dados usando biblioteca de executores em massa ou Azure Data Factory.

Sim, o Azure Cosmos DB dá suporte à análise de série temporal. Você pode usar o feed de alterações para criar visualizações agregadas de dados de série temporal. Você pode estender essa abordagem usando o streaming do Apache Spark ou outro processador de dados de stream.

Para obter informações sobre cotas de serviço e limites de taxa de transferência, veja cotas de serviço e ao longo da taxa de transferência.

Conteúdo relacionado

• Perguntas frequentes sobre Azure Cosmos DB for NoSQL
• Perguntas frequentes sobre o Azure Cosmos DB for MongoDB
• Perguntas frequentes sobre o Azure Cosmos DB for Apache Gremlin
• Perguntas frequentes sobre o Azure Cosmos DB for Apache Cassandra
• Perguntas frequentes sobre o Azure Cosmos DB for Table