Configurar as funcionalidades da sua conta do Azure Cosmos DB for MongoDB

  • Artigo

APLICA-SE AO: MongoDB

As funcionalidades podem ser adicionadas ou removidas da sua conta de API para MongoDB. Muitos desses recursos afetam o comportamento da conta, portanto, é importante estar totalmente ciente do efeito que um recurso tem antes de habilitá-lo ou desabilitá-lo. Vários recursos são definidos nas contas da API para MongoDB por padrão e não podem ser alterados nem removidos. Um exemplo é a recurso EnableMongo. Este artigo demonstra como habilitar e desabilitar um recurso.

Pré-requisitos

Funcionalidades disponíveis

Funcionalidade Descrição Removível
DisableRateLimitingResponses Permite que a API do Mongo repita as solicitações de limitação de taxa no lado do servidor até o valor definido para max-request-timeout. Yes
EnableMongoRoleBasedAccessControl Habilita o suporte para criação de usuários e funções para controle de acesso nativo baseado em função do MongoDB No
EnableMongoRetryableWrites Habilita o suporte para gravações repetíveis na conta. Yes
EnableMongo16MBDocumentSupport Habilita o suporte para inserção de documentos com até 16 MB de tamanho. 1 Não
EnableUniqueCompoundNestedDocs Habilita o suporte para índices exclusivos e compostos em campos aninhados, desde que o campo aninhado não seja uma matriz. No
EnableTtlOnCustomPath Fornece o recurso de definir um TTL (vida útil) personalizado em qualquer campo em uma coleção. Não há suporte para a configuração de TTL na propriedade de índice exclusiva parcial. 2 Não
EnablePartialUniqueIndex Habilita o suporte para índice parcial exclusivo, o que permite que você tenha mais flexibilidade para especificar exatamente quais campos nos documentos você gostaria de indexar. Não

Observação

1 Essa funcionalidade não pode ser habilitada nas contas do Azure Cosmos DB for MongoDB com chaves gerenciadas pelo cliente (CMK).

Observação

2 Essa funcionalidade não pode ser habilitada nas contas do Azure Cosmos DB for MongoDB com backup contínuo.

Importante

A alteração de recursos usando o Azure Resource Manager não está disponível para contas do Azure Cosmos DB for MongoDB.

Habilitar uma capacidade

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

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

    Você deve ver uma seção de recurso semelhante a esta saída:

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

    Examine a funcionalidade padrão. Neste exemplo, o único recurso definido é EnableMongo.

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

    Somente recursos explicitamente nomeados são definidos em sua conta. Por exemplo, se você quiser adicionar o recurso DisableRateLimitingResponses ao exemplo anterior, use o comando az cosmosdb update com o parâmetro --capabilities 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, de forma inclusiva. Isso inclui recursos que já estão habilitados para a conta que você deseja manter. Neste exemplo, o recurso EnableMongo já estava habilitado, portanto, você deve especificar os recursos EnableMongo e DisableRateLimitingResponses.

    Dica

    Se estiver usando o PowerShell e aparecer uma mensagem de erro ao 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")

Desabilitar uma capacidade

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

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

    Você deve ver uma seção de recurso semelhante a esta saída:

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

    Verifique se há todos os recursos 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.

    Somente recursos explicitamente nomeados são definidos em sua conta. Por exemplo, se você quiser remover o recurso DisableRateLimitingResponses, use o comando az cosmosdb update e liste o recurso que deseja manter:

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

    Dica

    Se estiver usando o PowerShell e aparecer uma mensagem de erro ao 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")

Próximas etapas