Gerenciar uma conta do Azure Cosmos DB usando o portal do Azure

APLICA-SE AO: NoSQL MongoDB Cassandra Gremlin Table

Este artigo descreve como gerenciar várias tarefas em uma conta do Azure Cosmos DB usando o portal do Azure. O Azure Cosmos DB também pode ser gerenciado com outros clientes de gerenciamento do Azure, incluindo o Azure PowerShell, a CLI do Azure, modelos Azure Resource Manager, o Bicep e o Terraform.

Dica

A API de gerenciamento do Azure Cosmos DB ou do painel de controle não foi projetada para grandes volumes de solicitação, como o restante do serviço. Para saber mais, confira Limites de serviço do painel de controle

Pré-requisitos

Nenhum

Criar uma conta

Siga as etapas:

  1. No menu do portal do Azure ou na Home page, selecione Criar um recurso.

  2. Pesquise por Azure Cosmos DB. Selecione Criar>Azure Cosmos DB.

  3. Na página Criar uma conta do Azure Cosmos DB, selecione a opção Criar na seção Azure Cosmos DB for NoSQL.

    O Azure Cosmos DB fornece várias APIs:

    • NoSQL, para dados do documento
    • PostgreSQL
    • MongoDB, para dados do documento
    • Apache Cassandra
    • Tabela
    • Apache Gremlin, para dados do grafo

    Para saber mais sobre a API para NoSQL, confira Bem-vindo(a) ao Azure Cosmos DB.

  4. Na página Criar uma Conta do Azure Cosmos DB, insira as configurações básicas da nova conta do Azure Cosmos DB.

    Configuração Valor Descrição
    Subscription Nome da assinatura Selecione a assinatura do Azure que você deseja usar para essa conta do Azure Cosmos DB.
    Grupo de recursos Nome do grupo de recursos Selecione um grupo de recursos ou selecione Criar novo, então insira um nome exclusivo para o novo grupo de recursos.
    Nome da Conta Um nome exclusivo Insira um nome para identificar a conta do Azure Cosmos DB. Já que documents.Azure.com é acrescentado ao nome que você fornece para criar o URI, use um nome exclusivo. O nome pode conter apenas letras minúsculas, números e o caractere de hífen (-). Deve ter de 3 a 44 caracteres.
    Location A região mais próxima dos usuários Selecione uma localização geográfica para hospedar a sua conta do Azure Cosmos DB. Use a localização mais próxima dos usuários para fornecer a eles acesso mais rápido aos dados.
    Modo de capacidade Taxa de transferência provisionada ou sem servidor Selecione Taxa de transferência provisionada para criar uma conta no modo taxa de transferência provisionada. Selecione Sem servidor para criar uma conta no modo sem servidor.
    Aplicar o desconto por nível gratuito do Azure Cosmos DB Aplicar ou Não aplicar Com a camada gratuita do Azure Cosmos DB, você recebe os primeiros 1000 RU/s e 25 GB de armazenamento sem custos em uma conta. Saiba mais sobre o nível gratuito.
    Limitar a taxa de transferência total da conta Selecionado ou não Limite a quantidade total da taxa de transferência que pode ser provisionada nessa conta. Esse limite impede encargos inesperados relacionados à taxa de transferência provisionada. Você pode atualizar ou remover esse limite depois que sua conta for criada.

    Você pode ter até uma conta gratuita do Azure Cosmos DB por assinatura do Azure e deve aceitar ao criar a conta. Se você não vê a opção de aplicar o desconto por nível gratuito, outra conta da assinatura já foi habilitada com o nível gratuito.

    Captura de tela mostrando a página Criar Conta do Azure Cosmos DB.

    Observação

    As seguintes opções não estarão disponíveis se você selecionar Sem servidor como Modo de capacidade:

    • Aplicar desconto por nível gratuito
    • Limitar a taxa de transferência total da conta
  5. Na guia Distribuição global, configure os detalhes a seguir. Para este início rápido, é possível usar os valores padrão:

    Configuração Valor Descrição
    Redundância geográfica Desabilitar Habilite ou desabilite a distribuição global em sua conta emparelhando sua região com uma região de par. Você poderá adicionar mais regiões à sua conta posteriormente.
    Gravações de várias regiões Desabilitar A capacidade de gravação de várias regiões permite que você aproveite a taxa de transferência provisionada para seus bancos de dados e contêineres em todo o mundo.
    Zonas de Disponibilidades Desabilitar As Zonas de Disponibilidade ajudam a aprimorar a disponibilidade e a resiliência do seu aplicativo.

    Observação

    As seguintes opções não estarão disponíveis se você selecionar Sem servidor como Modo de capacidade na página anterior Noções básicas:

    • Redundância geográfica
    • Gravações de várias regiões
  6. Opcionalmente, você pode configurar mais detalhes nas seguintes guias:

    • Redes. Configure o acesso a partir de uma rede virtual.
    • Política de Backup. Configure uma política de backup periódica ou contínua.
    • Criptografia. Use uma chave gerenciada pelo serviço ou uma chave gerenciada pelo cliente.
    • Marcas. Marcas são pares nome/valor que permitem categorizar recursos e exibir a cobrança consolidada por meio da aplicação da mesma marca a vários recursos e grupos de recursos.
  7. Selecione Examinar + criar.

  8. Examine as configurações da conta e selecione Criar. São necessários alguns minutos para criar a conta. Aguarde até que a página do portal exiba Sua implantação está concluída.

    Captura de tela mostrando que sua implantação está concluída.

  9. Selecione Ir para recurso para ir para a página da conta do Azure Cosmos DB.

    Captura de tela mostrando a página da conta do Azure Cosmos DB.

Adicionar ou remover regiões de sua conta de banco de dados

Dica

Quando uma nova região é adicionada, todos os dados devem ser totalmente replicados e confirmados na nova região antes que a região seja marcada como disponível. O tempo para esta operação depende da quantidade de dados armazenados na conta. Se uma operação de dimensionamento de taxa de transferência assíncrona estiver em andamento, a operação de expansão da taxa de transferência será pausada e será retomada automaticamente quando a operação de adicionar/remover região for concluída.

  1. Entre no Portal do Azure.

  2. Vá até sua conta do Azure Cosmos DB e selecione Replicar dados globalmente no menu de recursos.

  3. Para adicionar regiões, selecione os hexágonos no mapa com o rótulo + que corresponde às regiões desejadas. Como alternativa, para adicionar uma região, escolha a opção +Adicionar região e escolha uma região no menu suspenso.

  4. Para remover regiões, desmarque uma ou mais regiões do mapa marcando os hexágonos azuis com marcas de seleção. Você pode selecionar o ícone de "cesto de lixo" (🗑) ao lado da região no canto direito.

  5. Para salvar suas alterações, escolha OK.

    Captura de tela do menu Replicar dados globalmente, realçando uma região.

    No modo de gravação de região única, não é possível remover a região de gravação. Você deverá realizar o failover para uma região diferente antes de excluir a região de gravação atual.

    Em um modo de gravação de várias regiões, você poderá adicionar ou remover qualquer região, se você tiver pelo menos uma região.

    Configurar várias regiões de gravação

    Abra a guia Replicar Dados Globalmente e selecione Habilitar para habilitar gravações de várias regiões. Depois que você habilitar gravações de várias regiões, todas as regiões de leitura que você tiver na conta no momento se tornarão regiões de leitura e gravação.

    Captura de tela do menu Replicar dados globalmente, realçando Configurar regiões e Salvar.

Habilitar o failover gerenciado pelo serviço para a conta do Azure Cosmos DB

A opção failover Gerenciado pelo Serviço permite que o Azure Cosmos DB faça failover para a região com a prioridade mais alta de failover sem nenhuma ação do usuário caso uma região fique indisponível. Quando o failover gerenciado pelo serviço estiver habilitado, a prioridade de região poderá ser modificada. Sua conta precisa ter duas ou mais regiões para habilitar o failover gerenciado pelo serviço.

  1. Na sua conta do Azure Cosmos DB, abra o painel Replicar dados globalmente.

  2. Escolha Failover Gerenciado pelo Serviço na parte superior do painel.

    Captura de tela que mostra o menu replicar dados globalmente.

  3. No painel Failover gerenciado pelo serviço, verifique se a opção Habilitar Failover gerenciado pelo serviço está definida como ATIVADO.

  4. Clique em Salvar.

    Captura de tela do menu do portal de failover gerenciado pelo serviço.

Definir prioridades de failover para a conta do Azure Cosmos DB

Após uma conta do Azure Cosmos DB ser configurada para failover gerenciado pelo serviço, a prioridade de failover para regiões pode ser alterada.

Importante

Não é possível modificar a região de gravação (prioridade de failover igual a zero) quando a conta está configurada para failover gerenciado pelo serviço. Para alterar a região de gravação, é necessário desabilitar o failover gerenciado pelo serviço e fazer um failover manual.

  1. Na sua conta do Azure Cosmos DB, abra o painel Replicar dados globalmente.

  2. Escolha Failover Gerenciado pelo Serviço na parte superior do painel.

    Captura de tela mostrando o menu replicar dados globalmente.

  3. No painel Failover gerenciado pelo serviço, verifique se a opção Habilitar Failover gerenciado pelo serviço está definida como ATIVADO.

  4. Para modificar a prioridade de failover, arraste as regiões de leitura nos três pontos à esquerda da linha que aparecem quando o mouse é passado sobre ela.

  5. Selecione Salvar.

    Captura de tela do menu do portal de failover gerenciado pelo serviço.

Fazer um failover manual em uma conta do Azure Cosmos DB

Importante

A conta do Azure Cosmos DB precisa ser configurada para failover manual para essa operação ser bem-sucedida.

Observação

Se você executar uma operação manual de failover enquanto uma operação de dimensionamento de taxa de transferência assíncrona estiver em andamento, a operação de expansão de taxa de transferência será pausada. Ela é retomada automaticamente quando a operação de failover é concluída. Saiba mais informações, confira Melhores práticas para dimensionar a taxa de transferência provisionada (RU/s)

  1. Vá até sua conta do Azure Cosmos DB e abra o menu Replicar dados globalmente.

  2. Na parte superior do menu, escolha Failover Manual.

    Captura de tela do menu Replicar dados globalmente.

  3. No menu Failover Manual, escolha a nova região de gravação. Marque a caixa de seleção para indicar que você entende que essa opção alterará sua região de gravação.

  4. Para disparar o failover, escolha OK.

    Captura de tela do menu manual do portal de failover.