Udostępnij za pośrednictwem

Konfigurowanie możliwości konta usługi Azure Cosmos DB for MongoDB

  • Artykuł

DOTYCZY: MongoDB

Możliwości to funkcje, które można dodać lub usunąć do interfejsu API dla konta bazy danych MongoDB. Wiele z tych funkcji ma wpływ na zachowanie konta, dlatego ważne jest, aby być w pełni świadomym efektu, jaki ma funkcja przed jej włączeniem lub wyłączeniem. Kilka możliwości jest domyślnie ustawionych na interfejsie API dla kont bazy danych MongoDB i nie można ich zmienić ani usunąć. Przykładem jest EnableMongo możliwość. W tym artykule przedstawiono sposób włączania i wyłączania możliwości.

Wymagania wstępne

Dostępne możliwości

Możliwość opis Wymienne
DisableRateLimitingResponses Zezwala interfejsowi API Mongo na ponawianie żądań ograniczania szybkości po stronie serwera do momentu ustawienia wartości dla max-request-timeoutelementu . Tak
EnableMongoRoleBasedAccessControl Włącz obsługę tworzenia użytkowników i ról dla natywnej kontroli dostępu opartej na rolach bazy danych MongoDB. Nie.
EnableMongoRetryableWrites Umożliwia obsługę operacji zapisu z możliwością ponawiania prób na koncie. Tak
EnableMongo16MBDocumentSupport Umożliwia wstawianie dokumentów o rozmiarze do 16 MB. 1 Nie.
EnableUniqueCompoundNestedDocs Umożliwia obsługę złożonych i unikatowych indeksów w polach zagnieżdżonych, jeśli zagnieżdżone pole nie jest tablicą. Nie.
EnableTtlOnCustomPath Umożliwia ustawienie niestandardowego czasu wygaśnięcia (TTL) w dowolnym polu w kolekcji. Ustawienie czasu wygaśnięcia dla częściowej właściwości indeksu unikatowego nie jest obsługiwane. 2 Nie.
EnablePartialUniqueIndex Umożliwia obsługę unikatowego indeksu częściowego, dzięki czemu masz większą elastyczność, aby określić dokładnie pola w dokumentach, które chcesz indeksować. Nie.

Uwaga

1 Nie można włączyć tej funkcji na kontach usługi Azure Cosmos DB dla bazy danych MongoDB z kluczami zarządzanymi przez klienta (CMK).

Uwaga

2 Nie można włączyć tej funkcji na kontach usługi Azure Cosmos DB dla bazy danych MongoDB z ciągłą kopią zapasową.

Ważne

Zmiana możliwości przy użyciu usługi Azure Resource Manager nie jest dostępna dla kont usługi Azure Cosmos DB dla bazy danych MongoDB.

Włączanie możliwości

  1. Pobierz istniejące możliwości konta przy użyciu polecenia az cosmosdb show:

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

    Powinna zostać wyświetlona sekcja możliwości podobna do tych przykładowych danych wyjściowych:

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

    Przejrzyj możliwość domyślną. W tym przykładzie jedyną funkcją ustawioną jest EnableMongo.

  2. Ustaw nową możliwość na koncie bazy danych. Lista możliwości powinna zawierać listę wcześniej włączonych funkcji, które chcesz zachować.

    Tylko jawnie nazwane możliwości są ustawiane na Twoim koncie. Jeśli na przykład chcesz dodać DisableRateLimitingResponses możliwość do poprzedniego przykładu, użyj polecenia az cosmosdb update z parametrem --capabilities i wyświetl listę wszystkich możliwości, które chcesz mieć na swoim koncie:

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

    Ważne

    Lista możliwości musi zawsze określać wszystkie możliwości, które chcesz włączyć, włącznie. Obejmuje to możliwości, które są już włączone dla konta, które chcesz zachować. W tym przykładzie EnableMongo funkcja została już włączona, więc musisz określić zarówno EnableMongo możliwości, jak i DisableRateLimitingResponses możliwości.

    Napiwek

    Jeśli używasz programu PowerShell i pojawia się komunikat o błędzie podczas korzystania z poprzedniego polecenia, zamiast tego spróbuj użyć tablicy programu PowerShell, aby wyświetlić listę możliwości:

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

Wyłączanie możliwości

  1. Pobierz istniejące możliwości konta przy użyciu polecenia az cosmosdb show:

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

    Powinna zostać wyświetlona sekcja możliwości podobna do tych przykładowych danych wyjściowych:

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

    Sprawdź wszystkie możliwości, które są obecnie ustawione. W tym przykładzie ustawiono dwie możliwości: EnableMongo i DisableRateLimitingResponses.

  2. Usuń jedną z funkcji z konta bazy danych. Lista możliwości powinna zawierać listę wcześniej włączonych funkcji, które chcesz zachować.

    Tylko jawnie nazwane możliwości są ustawiane na Twoim koncie. Jeśli na przykład chcesz usunąć DisableRateLimitingResponses możliwość, użyj az cosmosdb update polecenia i wyświetl listę możliwości, które chcesz zachować:

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

    Napiwek

    Jeśli używasz programu PowerShell i pojawia się komunikat o błędzie podczas korzystania z tego polecenia, zamiast tego spróbuj użyć tablicy programu PowerShell, aby wyświetlić listę możliwości:

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

Następne kroki

  • Dowiedz się, jak używać programu Studio 3T z usługą Azure Cosmos DB dla bazy danych MongoDB.
  • Dowiedz się, jak używać narzędzia Robo 3T z usługą Azure Cosmos DB dla bazy danych MongoDB.
  • Zapoznaj się z przykładami bazy danych MongoDB za pomocą usługi Azure Cosmos DB dla bazy danych MongoDB.
  • Próbujesz zaplanować pojemność migracji do usługi Azure Cosmos DB? Informacje o istniejącym klastrze bazy danych można użyć do planowania pojemności.