Perguntas frequentes sobre diferentes APIs no Azure Cosmos DB

O Azure Cosmos DB é uma ótima escolha para novos aplicativos Web, móveis, de jogos e IoT, em que a escala automática, o desempenho previsível, os tempos de resposta rápidos na ordem de milissegundos e a capacidade de consultar dados sem esquemas 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 são 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. Uma taxa de transferência de 1 RU corresponde à taxa de transferência do GET de um documento de 1 KB. Toda operação no Azure Cosmos DB, incluindo leituras, gravações, consultas SQL e execuções de procedimentos armazenados, tem um valor determinístico de RU baseado na produtividade necessária para concluir a operação. Em vez de pensar em CPU, E/S, memória e como cada uma dessas medidas afeta a produtividade do seu aplicativo, você pode pensar em uma medida de RU única.

Você pode configurar cada contêiner do Azure Cosmos DB com produtividade provisionada em termos de RUs da produtividade por segundo. Em aplicativos de qualquer escala, você pode usar um parâmetro de comparação em solicitações individuais para medir seus valores de RU e provisionar um contêiner para manipular o total de unidades de solicitação em todas as solicitações. 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 unidades de solicitação e para obter ajuda para determinar suas necessidades de contêiner, experimente 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 já estão disponíveis (NoSQL, MongoDB, Table e Gremlin) e outras específicas para modelos de dados adicionais estarão disponíveis no futuro.

O Azure Cosmos DB tem um mecanismo de indexação livre de esquemas, capaz de indexar automaticamente todos os dados que ingere sem a necessidade de qualquer esquema ou de índices secundários do desenvolvedor. O mecanismo apoia-se em um conjunto de layouts de índice lógico (invertido, colunar, árvore) que separam o layout de armazenamento do índice e dos subsistemas de processamento de consulta. O Azure Cosmos DB também tem a capacidade de dar suporte a um conjunto de protocolos de transmissão e APIs de forma extensível e convertê-las com eficiência no modelo de dados principal (1) e nos layouts de índice lógico (2) tornando-o capaz de dar suporte a vários modelos de dados.

O Azure Cosmos DB é o serviço de banco de dados multimodelo distribuído globalmente da Microsoft. Quando vários modelos significarem que o Azure Cosmos DB tem suporte para várias APIs e vários modelos de dados, APIs diferentes usarão formatos de dados diferentes para o protocolo de armazenamento e de conexão. Por exemplo: o SQL usa JSON; o MongoDB usa BSON; o Table usa o EDM; o Cassandra usa CQL; o Gremlin usa o formato JSON. Dessa forma, é recomendável usar a mesma API para todos os acessos aos dados em uma determinada conta.

Cada API opera de forma independente, exceto as APIs para Gremlin e NoSQL, que são interoperáveis.

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 aproximadamente de forma uniforme entre um número suficientemente grande de chaves de partição.

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

Para obter detalhes, consulte a página Detalhes de preço do Azure Cosmos DB. Os encargos pelo uso do Azure Cosmos DB são determinados pelo número de contêineres provisionados, pelo número de horas em que os contêineres estavam online e pela produtividade provisionada de cada contêiner.

Sim, você pode se inscrever para uma conta de tempo limitado sem custo adicional, sem nenhum compromisso. Para se inscrever, visite Experimente gratuitamente o Azure Cosmos DB ou leia mais em Tente as Perguntas frequentes do Azure Cosmos DB.

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.

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

• Página de perguntas & respostas da Microsoft
• Stack Overflow. O Stack Overflow é o melhor para perguntas sobre programação. Verifique se sua pergunta está no tópico e forneça o máximo de detalhes possíveis, tornando a pergunta clara e possível de responder.

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

Agora você pode aproveitar uma experiência do Azure Cosmos DB gratuitamente, por tempo limitado, sem assinatura e sem compromisso. Para se inscrever para uma assinatura do tipo Experimente o Azure Cosmos DB gratuitamente, vá para Experimente o Azure Cosmos DB gratuitamente e use qualquer MSA (Conta pessoal da Microsoft). Esta assinatura é separada da Avaliação gratuita do Azure e pode ser usada juntamente com uma Avaliação gratuita do Azure ou uma assinatura paga do Azure.

Experimente as assinaturas do Azure Cosmos DB é exibido no portal do Azure ao lado de outras assinaturas associadas à sua ID de usuário.

As seguintes condições se aplicam às assinaturas de Experimente o Azure Cosmos DB:

• O acesso à conta pode ser concedido a MSAs (Contas pessoais da Microsoft). Evite usar contas do Microsoft Entra ou contas que pertencem a locatários corporativos do Microsoft Entra, pois elas podem ter limitações em vigor que poderiam bloquear a concessão de acesso.
• Um contêiner de taxa de transferência provisionada por assinatura para contas de API para NoSQL, Gremlin e Table.
• Até três coleções de taxa de transferência provisionada por assinatura para contas do MongoDB.
• Um banco de dados de taxa de transferência provisionada por assinatura. Os bancos de dados de taxa de transferência provisionada podem conter qualquer número de contêineres internamente.
• Capacidade de armazenamento de 10 GB.
• A replicação global está disponível atualmente nas seguintes regiões do Azure: EUA Central, Norte da Europa e Sudeste Asiático
• Taxa de transferência máxima de 5.000 RU/s quando provisionadas no nível de contêiner.
• Taxa de transferência máxima de 20.000 RU/s quando provisionadas no nível de banco de dados.
• As assinaturas expiram após 30 dias e podem ser estendidas para um máximo de 31 dias no total. Depois de expirarem, as informações contidas são excluídas.
• Não é possível criar tíquetes de suporte do Azure para contas Experimente o Azure Cosmos DB; no entanto, é oferecido suporte para assinantes com planos de suporte existentes.

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

Uma chave primária é um token de segurança para acessar todos os recursos de uma conta. As pessoas que têm a chave têm acesso de leitura e gravação a todos os recursos na conta do banco de dados. Seja cauteloso ao distribuir chaves primárias. A primeira chave primária e a secunda chave primária estão disponíveis na folha Chaves do [portal do Azure] [azure-portal]. Para saber mais sobre as chaves, consulte Exibir, copiar e regenerar chaves de acesso.

O valor de PreferredLocations pode ser definido para qualquer uma das regiões do Azure em que o Azure Cosmos DB está disponível. Para obter uma lista de regiões disponíveis, consulte Regiões do Azure.

O Azure Cosmos DB está presente em todas as regiões do Azure, conforme especificado na página Regiões do Azure. Como ele é o serviço principal, cada novo data center 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. Ou seja, se você criar uma conta em uma região soberana, não poderá replicar fora da 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 produtividade no nível do contêiner e no nível do banco de dados são ofertas separadas e mudar entre elas requer a migração de dados de origem para destino. Isso significa que você precisa criar um novo banco de dados ou um novo contêiner e, em seguida, migrar os dados usando a biblioteca do executor em massa ou o Azure Data Factory.

Sim, o Azure Cosmos DB dá suporte à análise de série temporal; veja um exemplo do padrão de série temporal. O exemplo mostra como usar o feed de alterações para criar exibições agregadas nos dados de série temporal. Você pode estender essa abordagem usando o streaming do spark ou outro processador de dados de streaming.

Consulte os artigos sobre cotas de serviço e limites de taxa de transferência por contêiner e banco de dados do Azure Cosmos DB para obter mais informações.

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. Para obter instruções sobre como adicionar uma conta do Azure Cosmos DB, consulte Criar uma conta de banco de dados do Azure Cosmos DB.

SDKs estão disponíveis para .NET, Python, Node.js, JavaScript e Java. Os desenvolvedores também podem usar as APIs HTTP RESTful para interagir com os recursos do Azure Cosmos DB em uma série de plataformas e linguagens.

Exemplos para os SDKs do .NET, Java, Node.js e Python da API para NoSQL estão disponíveis no GitHub.

Sim, a API para NoSQL permite que os aplicativos armazenem documentos JSON arbitrários sem dicas nem definições de esquema. Os dados ficam disponíveis imediatamente para consulta por meio da interface de consulta SQL do Azure Cosmos DB.

Sim, a API para NoSQL dá suporte a transações entre documentos que são expressas 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 exceções forem emitidas por parte da execução do código de aplicativo JavaScript pelo servidor, toda a transação será revertida.

Um contêiner é um grupo de documentos e de suas respectivas lógicas de aplicativo JavaScript associadas. Um contêiner é uma entidade faturável, em que o custo é determinado pela produtividade e pelo armazenamento usado. Os contêineres podem abranger um ou mais servidores ou partições e podem ser dimensionados para lidar com volumes de armazenamento ou de produtividade praticamente ilimitados.

• Para a API para NoSQL, o recurso é chamado de contêiner.
• Para a API para MongoD, um contêiner é mapeado para uma coleção.
• Para as APIs para Cassandra e Table, o contêiner é mapeado para uma tabela.
• Para a API para Gremlin, o contêiner é mapeado para um grafo.

Os contêineres também são as entidades de cobrança do Azure Cosmos DB. Cada contêiner é cobrado por hora com base na produtividade provisionada e no espaço de armazenamento usado. Para obter mais informações, consulte o Preço do Azure Cosmos DB.

Você pode criar bancos de dados usando o Portal do Azure, conforme descrito em Adicionar um contêiner, um dos SDKs do Azure Cosmos DB ou as APIs REST.

Você pode criar usuários e permissões usando um dos SDKs da API do Azure Cosmos DB ou as APIs REST.

A linguagem de consulta SQL com suporte nas contas da API para NoSQL é um subconjunto avançado da funcionalidade de consulta com suporte no SQL Server. A linguagem de consulta SQL do Azure Cosmos DB fornece operadores hierárquicos e relacionais avançados e extensibilidade por meio de UDFs (funções definidas pelo usuário) baseadas em JavaScript. 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 a gramática SQL, consulte o artigo [Consulta SQL][consulta].

A API para NoSQL dá suporte à agregação de baixa latência em qualquer escala por meio das funções de agregação COUNT, MIN, MAX, AVG e SUM pela gramática SQL.

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, as Etags podem ser usadas com o cabeçalho If-None-Match para determinar se é necessário realizar uma nova busca de um recurso.

Para usar a simultaneidade otimista em .NET, use a classe AccessCondition . Para obter um exemplo de .NET, confira Program.cs no exemplo DocumentManagement no GitHub.

A API para NoSQL dá suporte a transações integradas à linguagem por meio de procedimentos armazenados e gatilhos do JavaScript. Todas as operações de banco de dados dentro de scripts são executadas em isolamento de instantâneo. Caso seja um contêiner de partição única, a execução terá o escopo definido para o contêiner. Se o contêiner estiver particionado, a execução terá o escopo definido para documentos com o mesmo valor de chave de partição dentro do contêiner. E obtido um instantâneo das versões do documento (ETags) no início da transação e confirmado somente se o script for bem-sucedido. Se o JavaScript emitir um erro, a transação será revertida. Para obter mais informações, consulte a Programação JavaScript do lado do servidor para o Azure Cosmos DB.

Você pode fazer a inserção em massa documentos no Azure Cosmos DB de uma das seguintes maneiras:

• A ferramenta de executor em massa, conforme descrito em Uso da biblioteca do .NET do executor em massa e Uso da biblioteca Java do executor em massa
• Procedimentos armazenados, conforme descrito em Programação de JavaScript do lado do servidor para o Azure Cosmos DB.

Sim. Como o Azure Cosmos DB é 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 uma funcionalidade idêntica ao Azure Cosmos DB, incluindo suporte para criar e consultar documentos JSON, provisionar e dimensionar coleções, bem como executar procedimentos armazenados e gatilhos. Você pode desenvolver e testar aplicativos usando o Emulador do Azure Cosmos DB e implanta-los no Azure em escala global fazendo uma única alteração de configuração no ponto de extremidade de conexão do Azure Cosmos DB.

Esta é a limitação do JavaScript. O JavaScript usa números de formato de ponto flutuante de precisão dupla conforme especificado em IEEE 754 e pode manter, com segurança, apenas números entre -(2⁵³ - 1) e 2⁵³-1 (isto é, 9007199254740991).

A criação de permissões usando o ResourceTokens é permitida no nível do contêiner e de seus descendentes (como documentos, anexos). Isso implica que, no momento, tentar criar uma permissão no nível do banco de dados ou da conta não é permitido.

Próximas etapas

Para obter mais informações sobre perguntas frequentes de outras APIs, consulte:

• 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