Konfigurace možností účtu Azure Cosmos DB pro MongoDB

  • Článek

PLATÍ PRO: MongoDB

Funkce jsou funkce, které je možné přidat nebo odebrat do účtu rozhraní API pro MongoDB. Mnoho z těchto funkcí má vliv na chování účtu, takže je důležité mít před povolením nebo zakázáním plně přehled o efektu, který má funkce. Pro účty API pro MongoDB je ve výchozím nastavení nastaveno několik možností a nejde je změnit ani odebrat. Jedním z příkladů je EnableMongo schopnost. Tento článek ukazuje, jak povolit a zakázat funkci.

Požadavky

Dostupné možnosti

Schopnost Popis Vyměnitelné
DisableRateLimitingResponses Umožňuje rozhraní Mongo API opakovat žádosti o omezení rychlosti na straně serveru, dokud není nastavená max-request-timeouthodnota . Ano
EnableMongoRoleBasedAccessControl Povolte podporu vytváření uživatelů a rolí pro nativní řízení přístupu na základě role MongoDB. No
EnableMongoRetryableWrites Umožňuje podporu opakovaných zápisů v účtu. Ano
EnableMongo16MBDocumentSupport Umožňuje podporu vkládání dokumentů o velikosti až 16 MB. No
EnableUniqueCompoundNestedDocs Povolí podporu složených a jedinečných indexů u vnořených polí, pokud vnořené pole není pole. No
EnableTtlOnCustomPath Umožňuje nastavit vlastní hodnotu TTL (Time to Live) u libovolného pole v kolekci. Nastavení hodnoty TTL pro částečnou jedinečnou vlastnost indexu není podporováno. 1 No
EnablePartialUniqueIndex Umožňuje podporu jedinečného částečného indexu, takže máte větší flexibilitu určit přesně ta pole v dokumentech, která chcete indexovat. No
EnableUniqueIndexReIndex Umožňuje podporu opětovného indexování jedinečných indexů pro službu Cosmos DB pro MongoDB RU. 1 No

Poznámka:

1 Tuto funkci nelze povolit u účtů Azure Cosmos DB pro MongoDB s průběžným zálohováním.

Povolení funkce

  1. Načtení stávajících možností účtu pomocí příkazu az cosmosdb show:

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

    Měla by se zobrazit část schopností podobná tomuto ukázkovém výstupu:

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

    Zkontrolujte výchozí možnost. V tomto příkladu je jedinou nastavenou EnableMongoschopností .

  2. Nastavte novou funkci v databázovém účtu. Seznam funkcí by měl obsahovat seznam dříve povolených funkcí, které chcete zachovat.

    Ve vašem účtu se nastaví jenom explicitně pojmenované funkce. Pokud například chcete přidat DisableRateLimitingResponses funkci do předchozího příkladu, použijte příkaz az cosmosdb update s parametrem --capabilities a zobrazte seznam všech funkcí, které chcete mít ve svém účtu:

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

    Důležité

    Seznam funkcí musí vždy určovat všechny možnosti, které chcete povolit ( včetně). To zahrnuje funkce, které už jsou povolené pro účet, který chcete zachovat. V tomto příkladu EnableMongo už byla funkce povolená, takže musíte zadat EnableMongo jak schopnost DisableRateLimitingResponses , tak i schopnost.

    Tip

    Pokud používáte PowerShell a při použití předchozího příkazu se zobrazí chybová zpráva, zkuste místo toho pomocí pole PowerShellu zobrazit seznam možností:

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

Zakázání funkce

  1. Načtení stávajících možností účtu pomocí az cosmosdb show:

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

    Měla by se zobrazit část schopností podobná tomuto ukázkovém výstupu:

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

    Zkontrolujte všechny možnosti, které jsou aktuálně nastavené. V tomto příkladu jsou nastaveny dvě možnosti: EnableMongo a DisableRateLimitingResponses.

  2. Odeberte jednu z možností z databázového účtu. Seznam funkcí by měl obsahovat seznam dříve povolených funkcí, které chcete zachovat.

    Ve vašem účtu se nastaví jenom explicitně pojmenované funkce. Pokud například chcete odebrat DisableRateLimitingResponses funkci, použijte az cosmosdb update příkaz a vypíšete možnosti, které chcete zachovat:

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

    Tip

    Pokud používáte PowerShell a při použití tohoto příkazu se zobrazí chybová zpráva, zkuste místo toho pomocí pole PowerShellu zobrazit seznam možností:

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

Další kroky