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

APLICA-SE A: NoSQL MongoDB Cassandra Gremlin Tabela

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 Azure PowerShell, Azure CLI, modelos do Azure Resource Manager, Bíceps e Terraform.

Gorjeta

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

Pré-requisitos

Nenhuma

Criar uma conta

Siga os passos:

  1. A partir do menu do portal do Azure ou a partir da Home page, selecione Criar um recurso.

  2. Procure o 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 para NoSQL.

    O Azure Cosmos DB fornece várias APIs:

    • NoSQL, para dados de documentos
    • PostgreSQL
    • MongoDB, para dados de documentos
    • Apache Cassandra
    • Tabela
    • Apache Gremlin, para dados gráficos

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

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

    Definição valor Description
    Subscrição Nome da subscrição Selecione a subscrição do Azure que pretende utilizar para esta conta do Azure Cosmos DB.
    Grupo de Recursos Nome do grupo de recursos Selecione um grupo de recursos ou selecione Criar novo e, em seguida, introduza um nome exclusivo para o novo grupo de recursos.
    Nome da Conta Um nome exclusivo Insira um nome para identificar sua conta do Azure Cosmos DB. Uma vez que documents.azure.com é anexado ao nome que indicar para criar o URI, utilize um nome exclusivo. O nome pode conter apenas letras minúsculas, números e o caractere hífen (-). Deve ter de 3 a 44 caracteres.
    Location A região mais próxima dos seus utilizadores Selecione a localização geográfica para alojar a sua conta do Azure Cosmos DB. Utilize a localização mais próxima dos utilizadores para lhes dar o 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 de taxa de transferência provisionada. Selecione Serverless para criar uma conta no modo serverless .
    Aplicar desconto de nível gratuito do Azure Cosmos DB Candidatar-se ou Não aplicar Com o nível gratuito do Azure Cosmos DB, você obtém os primeiros 1000 RU/s e 25 GB de armazenamento gratuitamente 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 de taxa de transferência que pode ser provisionada nessa conta. Esse limite evita cobranças inesperadas relacionadas à 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 optar por participar ao criar a conta. Se você não vir a opção de aplicar o desconto de nível gratuito, outra conta na assinatura já foi habilitada com o nível gratuito.

    A captura de tela mostra a página Criar Conta do Azure Cosmos DB.

    Nota

    As seguintes opções não estarão disponíveis se você selecionar Serverless como o modo de Capacidade:

    • Aplicar Desconto de Escalão Gratuito
    • Limitar a taxa de transferência total da conta
  5. Na guia Distribuição Global, configure os seguintes detalhes. Você pode deixar os valores padrão para este início rápido:

    Definição valor Description
    Georredundância Desativar Habilite ou desative a distribuição global em sua conta emparelhando sua região com uma região par. Pode adicionar mais regiões à sua conta mais tarde.
    Escritas de várias regiões Desativar O recurso de gravação em 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 Disponibilidade Desativar As zonas de disponibilidade ajudam a melhorar ainda mais a disponibilidade e a resiliência do seu aplicativo.

    Nota

    As opções a seguir não estarão disponíveis se você selecionar Serverless como o modo de capacidade na página Noções básicas anterior:

    • Georredundância
    • Escritas 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 a política de backup periódico ou contínuo .
    • Encriptação. Use uma chave gerenciada pelo serviço ou uma chave gerenciada pelo cliente.
    • Etiquetas. As etiquetas são pares nome/valor que permitem categorizar recursos e ver faturação consolidada aplicando a mesma etiqueta a múltiplos recursos e grupos de recursos.
  7. Selecione Rever + criar.

  8. Reveja as definições da conta e, em seguida, selecione Criar. A criação da conta demora alguns minutos. Aguarde até que a página do portal apresente A implementação está concluída.

    A captura de tela mostra que sua implantação foi concluída.

  9. Selecione Ir para recurso para aceder à página da conta do Azure Cosmos DB.

    A captura de tela mostra a página da conta do Azure Cosmos DB.

Adicionar/remover regiões da sua conta de banco de dados

Gorjeta

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

  1. Inicie sessão no portal do Azure.

  2. Vá para 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ão(ões) desejada(s). Como alternativa, para adicionar uma região, selecione a opção + Adicionar região e escolha uma região no menu suspenso.

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

  5. Para salvar as alterações, selecione OK.

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

    No modo de escrita de região única, não pode remover a região de escrita. Deve efetuar ativação pós-falha para uma região diferente para poder eliminar a região de escrita atual.

    No modo de escrita de várias regiões, pode adicionar ou remover qualquer região desde que tenha, pelo menos, uma região.

    Configurar várias regiões de escrita

    Abra a guia Replicar dados globalmente e selecione Habilitar para habilitar gravações em várias regiões. Depois de habilitar as gravações em várias regiões, todas as regiões de leitura que você tem atualmente na conta se tornarão regiões de leitura e gravação.

    Captura de ecrã do menu Replicar dados globalmente, realçando Configurar regiões e Guardar.

Habilitar failover gerenciado por serviço para sua conta do Azure Cosmos DB

A opção de failover gerenciado por serviço permite que o Azure Cosmos DB faça failover para a região com a prioridade de failover mais alta sem nenhuma ação do usuário caso uma região fique indisponível. Quando o failover gerenciado pelo serviço está habilitado, a prioridade da região pode ser modificada. Sua conta deve 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. Na parte superior do painel, selecione Failover gerenciado por serviço.

    Captura de tela que mostra o menu replicar dados globalmente.

  3. No painel Failover Gerenciado por Serviço, verifique se Habilitar Failover Gerenciado por Serviço está definido como ATIVADO.

  4. Selecione Guardar.

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

Definir prioridades de failover para sua conta do Azure Cosmos DB

Depois que uma conta do Azure Cosmos DB é configurada para failover gerenciado por 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 zero) quando a conta está configurada para failover gerenciado por serviço. Para alterar a região de gravação, você deve 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. Na parte superior do painel, selecione Failover gerenciado por serviço.

    Captura de tela mostrando o menu Replicar dados globalmente.

  3. No painel Failover Gerenciado por Serviço, verifique se Habilitar Failover Gerenciado por Serviço está definido como ATIVADO.

  4. Para modificar a prioridade de failover, arraste as regiões de leitura através dos três pontos no lado esquerdo da linha que aparecem quando você passa o mouse sobre elas.

  5. Selecione Guardar.

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

Executar failover manual em uma conta do Azure Cosmos DB

Importante

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

Nota

Se você executar uma operação de failover manual enquanto uma operação de dimensionamento assíncrono de taxa de transferência estiver em andamento, a operação de expansão de taxa de transferência será pausada. Ele é retomado automaticamente quando a operação de failover é concluída. Para obter mais informações, consulte Práticas recomendadas para dimensionamento da taxa de transferência provisionada (RU/s)

Aviso

No caso de uma interrupção de região de gravação, em que a conta do Azure Cosmos DB promove uma região secundária para ser a nova região de gravação primária por meio de failover gerenciado por serviço, a região de gravação original não será promovida de volta como a região de gravação automaticamente depois de recuperada. É sua responsabilidade voltar para a região recuperada como a região de gravação usando o PowerShell, a CLI do Azure ou o portal do Azure (uma vez seguro fazê-lo, conforme descrito acima).

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

  2. Na parte superior do menu, selecione Failover manual.

    Captura de ecrã do menu Replicar dados globalmente.

  3. No menu Failover manual, selecione sua nova região de gravação. Marque a caixa de seleção para indicar que você entende que essa opção altera sua região de gravação.

  4. Para acionar o failover, selecione OK.

    Captura de tela do menu manual do portal de failover.