Configurar seus recursos de conta do Azure Cosmos DB para MongoDB

  • Artigo

APLICA-SE A: MongoDB

Os recursos são recursos que podem ser adicionados ou removidos à sua API para a conta do MongoDB. Muitos desses recursos afetam o comportamento da conta, por isso é importante estar totalmente ciente do efeito que um recurso tem antes de ativá-lo ou desativá-lo. Vários recursos são definidos na API para contas MongoDB por padrão e não podem ser alterados ou removidos. Um exemplo é a EnableMongo capacidade. Este artigo demonstra como habilitar e desabilitar um recurso.

Pré-requisitos

Capacidades disponíveis

Capacidade Description Removível
DisableRateLimitingResponses Permite que a API do Mongo tente novamente solicitações de limitação de taxa no lado do servidor até o valor definido para max-request-timeout. Sim
EnableMongoRoleBasedAccessControl Habilite o suporte para a criação de usuários e funções para o controle de acesso baseado em função nativo do MongoDB. Não
EnableMongoRetryableWrites Habilita o suporte para gravações repetidas na conta. Sim
EnableMongo16MBDocumentSupport Permite o suporte para a inserção de documentos de até 16 MB de tamanho. Não
EnableUniqueCompoundNestedDocs Habilita o suporte para índices compostos e exclusivos em campos aninhados se o campo aninhado não for uma matriz. Não
EnableTtlOnCustomPath Fornece a capacidade de definir um Time to Live (TTL) personalizado em qualquer campo de uma coleção. Não há suporte para a configuração de TTL na propriedade de índice exclusivo parcial. 1 Não
EnablePartialUniqueIndex Permite o suporte para um índice parcial exclusivo, para que você tenha mais flexibilidade para especificar exatamente quais campos em documentos deseja indexar. Não
EnableUniqueIndexReIndex Permite o suporte para reindexação de índice exclusiva para o Cosmos DB para MongoDB RU. 1º Não

Nota

1 Esse recurso não pode ser habilitado em contas do Azure Cosmos DB para MongoDB com backup contínuo.

Habilitar um recurso

  1. Recupere seus recursos de conta existentes usando az cosmosdb show:

    az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>

    Você verá uma seção de recursos semelhante a esta saída de exemplo:

    "capabilities": [
  {
    "name": "EnableMongo"
  }
]

    Analise o recurso padrão. Neste exemplo, o único recurso definido é EnableMongo.

  2. Defina o novo recurso em sua conta de banco de dados. A lista de recursos deve incluir a lista de recursos habilitados anteriormente que você deseja manter.

    Apenas os recursos explicitamente nomeados são definidos na sua conta. Por exemplo, se você quiser adicionar a DisableRateLimitingResponses capacidade ao exemplo anterior, use o comando az cosmosdb update com o --capabilities parâmetro e liste todos os recursos que deseja ter em sua conta:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo DisableRateLimitingResponses

    Importante

    A lista de recursos deve sempre especificar todos os recursos que você deseja habilitar, inclusive. Isso inclui recursos que já estão habilitados para a conta que você deseja manter. Neste exemplo, o EnableMongo recurso já estava habilitado, portanto, você deve especificar o recurso e o DisableRateLimitingResponsesEnableMongo recurso.

    Gorjeta

    Se você estiver usando o PowerShell e uma mensagem de erro aparecer quando você usar o comando anterior, tente usar uma matriz do PowerShell para listar os recursos:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo","DisableRateLimitingResponses")

Desativar uma funcionalidade

  1. Recupere os recursos da sua conta existente usando az cosmosdb show:

    az cosmosdb show \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name>

    Você verá uma seção de recursos semelhante a esta saída de exemplo:

    "capabilities": [
  {
    "name": "EnableMongo"
  },
  {
    "name": "DisableRateLimitingResponses"
  }
]

    Verifique todos os recursos que estão definidos no momento. Neste exemplo, dois recursos são definidos: EnableMongo e DisableRateLimitingResponses.

  2. Remova um dos recursos da sua conta de banco de dados. A lista de recursos deve incluir a lista de recursos habilitados anteriormente que você deseja manter.

    Apenas os recursos explicitamente nomeados são definidos na sua conta. Por exemplo, se quiser remover a DisableRateLimitingResponses capacidade, use o az cosmosdb update comando e liste a capacidade que deseja manter:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities EnableMongo

    Gorjeta

    Se você estiver usando o PowerShell e uma mensagem de erro aparecer quando você usar esse comando, tente usar uma matriz do PowerShell para listar os recursos:

    az cosmosdb update \
    --resource-group <azure_resource_group> \
    --name <azure_cosmos_db_account_name> \
    --capabilities @("EnableMongo")

Próximos passos

  • Saiba como usar o Studio 3T com o Azure Cosmos DB para MongoDB.
  • Saiba como usar o Robo 3T com o Azure Cosmos DB para MongoDB.
  • Explore exemplos do MongoDB com o Azure Cosmos DB para MongoDB.
  • Tentando fazer o planejamento de capacidade para uma migração para o Azure Cosmos DB? Você pode usar informações sobre seu cluster de banco de dados existente para planejamento de capacidade.