Zarządzanie kontem usługi Azure CosmosManage an Azure Cosmos account

DOTYCZY: interfejs API SQL

W poniższym artykule opisano sposób zarządzania różnymi zadaniami w ramach konta usługi Azure Cosmos przy użyciu witryny Azure Portal, programu Azure PowerShell, interfejsu wiersza polecenia platformy Azure i szablonów usługi Azure Resource Manager.This article describes how to manage various tasks on an Azure Cosmos account using the Azure portal, Azure PowerShell, Azure CLI, and Azure Resource Manager templates.

Tworzenie kontaCreate an account

Azure PortalAzure portal

  1. W menu witryny Azure Portal lub na stronie głównej wybierz pozycję Utwórz zasób.From the Azure portal menu or the Home page, select Create a resource.

  2. Na stronie Nowa wyszukaj i wybierz usługę Azure Cosmos DB.On the New page, search for and select Azure Cosmos DB.

  3. Na stronie Azure Cosmos DB wybierz pozycję Utwórz.On the Azure Cosmos DB page, select Create.

  4. Na stronie Tworzenie konta usługi Azure Cosmos DB wprowadź podstawowe ustawienia nowego konta usługi Azure Cosmos.On the Create Azure Cosmos DB Account page, enter the basic settings for the new Azure Cosmos account.

    UstawienieSetting WartośćValue OpisDescription
    SubskrypcjaSubscription Nazwa subskrypcjiSubscription name Wybierz subskrypcję platformy Azure, której chcesz użyć dla tego konta usługi Azure Cosmos.Select the Azure subscription that you want to use for this Azure Cosmos account.
    Grupa zasobówResource Group Nazwa grupy zasobówResource group name Wybierz grupę zasobów lub wybierz pozycję Utwórz nową, a następnie wprowadź unikatową nazwę nowej grupy zasobów.Select a resource group, or select Create new, then enter a unique name for the new resource group.
    Nazwa kontaAccount Name Unikatowa nazwaA unique name Wprowadź nazwę, która będzie identyfikować konto usługi Azure Cosmos.Enter a name to identify your Azure Cosmos account. Ponieważ adres documents.azure.com jest dołączany do podanej nazwy w celu utworzenia identyfikatora URI, użyj unikatowej nazwy.Because documents.azure.com is appended to the name that you provide to create your URI, use a unique name.

    Nazwa może zawierać tylko małe litery, cyfry i znaki łącznika (-).The name can only contain lowercase letters, numbers, and the hyphen (-) character. Musi mieć długość od 3 do 44 znaków.It must be between 3-44 characters in length.
    Interfejs APIAPI Typ konta do utworzeniaThe type of account to create Wybierz pozycję Core (SQL) , aby utworzyć bazę danych dokumentów i wykonać zapytanie przy użyciu składni języka SQL.Select Core (SQL) to create a document database and query by using SQL syntax.

    Interfejs API określa typ konta do utworzenia.The API determines the type of account to create. Usługa Azure Cosmos DB oferuje pięć interfejsów API: Core (SQL) i MongoDB dla danych dokumentów, Gremlin dla danych grafów, Azure Table i Cassandra.Azure Cosmos DB provides five APIs: Core (SQL) and MongoDB for document data, Gremlin for graph data, Azure Table, and Cassandra. Obecnie dla każdego interfejsu API należy utworzyć oddzielne konto.Currently, you must create a separate account for each API.
    Tryb wydajnościCapacity mode Nieobsługiwana przepływność lub bezserwerowyProvisioned throughput or Serverless Wybierz opcję zainicjowana przepływność , aby utworzyć konto w trybie przepływności aprowizacji .Select Provisioned throughput to create an account in provisioned throughput mode. Wybierz opcję Bezserwerowa , aby utworzyć konto w trybie bezserwerowym .Select Serverless to create an account in serverless mode.
    Zastosuj rabat na podstawie warstwy BezpłatnaApply Free Tier Discount Zastosuj lub nie stosujApply or Do not apply W ramach warstwy Bezpłatna usługi Azure Cosmos DB uzyskasz bezpłatnie pierwsze 400 jednostek RU/s i 5 GB magazynu na koncie.With Azure Cosmos DB free tier, you will get the first 400 RU/s and 5 GB of storage for free in an account. Dowiedz się więcej o warstwie Bezpłatna.Learn more about free tier.
    LokalizacjaLocation Region najbliżej Twoich użytkownikówThe region closest to your users Wybierz lokalizację geograficzną, w której będzie hostowane konto usługi Azure Cosmos DB.Select a geographic location to host your Azure Cosmos DB account. Użyj lokalizacji znajdującej się najbliżej Twoich użytkowników, aby zapewnić im najszybszy dostęp do danych.Use the location that is closest to your users to give them the fastest access to the data.
    Typ kontaAccount Type Produkcyjne lub nieprodukcyjneProduction or Non-Production Wybierz pozycję Produkcyjne, jeśli konto będzie używane w obciążeniu produkcyjnym.Select Production if the account will be used for a production workload. Wybierz pozycję Nieprodukcyjne, jeśli konto będzie używane na potrzeby nieprodukcyjne, na przykład programowania, testowania, kontroli jakości lub wdrażania przejściowego.Select Non-Production if the account will be used for non-production, e.g. development, testing, QA, or staging. Jest to ustawienie tagu zasobu platformy Azure, które dostosowuje środowisko portalu, ale nie wpływa na bazowe konto usługi Azure Cosmos DB.This is an Azure resource tag setting that tunes the Portal experience but does not affect the underlying Azure Cosmos DB account. Tę wartość można zmienić w dowolnym momencie.You can change this value anytime.

    Uwaga

    W ramach jednej subskrypcji platformy Azure można korzystać z maksymalnie jednego konta usługi Azure Cosmos DB w warstwie Bezpłatna. Tę opcję należy wybrać podczas tworzenia konta.You can have up to one free tier Azure Cosmos DB account per Azure subscription and must opt-in when creating the account. Jeśli opcja zastosowania rabatu na podstawie warstwy Bezpłatna nie jest widoczna, inne konto w subskrypcji już korzysta z warstwy Bezpłatna.If you do not see the option to apply the free tier discount, this means another account in the subscription has already been enabled with free tier.

    Uwaga

    Następujące opcje są niedostępne, jeśli wybierzesz opcję bezserwerowe jako tryb pojemności:The following options are not available if you select Serverless as the Capacity mode:

    • Zastosuj rabat na podstawie warstwy BezpłatnaApply Free Tier Discount
    • Nadmiarowość geograficznaGeo-redundancy
    • Moduły zapisujące obsługujące wiele regionówMulti-region Writes

    Strona nowego konta usługi Azure Cosmos DB

  5. Wybierz pozycję Przegląd + utwórz.Select Review + create. Sekcje Sieć i Tagi możesz pominąć.You can skip the Network and Tags sections.

  6. Przejrzyj ustawienia konta, a następnie wybierz pozycję Utwórz.Review the account settings, and then select Create. Utworzenie konta trwa kilka minut.It takes a few minutes to create the account. Poczekaj na wyświetlenie komunikatu Wdrożenie zostało ukończone na stronie portalu.Wait for the portal page to display Your deployment is complete.

    Okienko Powiadomienia w witrynie Azure Portal

  7. Wybierz pozycję Przejdź do zasobu, aby przejść do strony konta usługi Azure Cosmos DB.Select Go to resource to go to the Azure Cosmos DB account page.

    Strona konta usługi Azure Cosmos DB

Interfejs wiersza polecenia platformy AzureAzure CLI

Zobacz Tworzenie konta Azure Cosmos dB przy użyciu interfejsu wiersza polecenia platformy AzurePlease see Create an Azure Cosmos DB account with Azure CLI

Azure PowerShellAzure PowerShell

Zobacz Tworzenie konta Azure Cosmos dB przy użyciu programu PowerShellPlease see Create an Azure Cosmos DB account with PowerShell

Szablon usługi Azure Resource ManagerAzure Resource Manager template

Zobacz Tworzenie konta Azure Cosmos DB z szablonami Azure Resource ManagerPlease see Create Azure Cosmos DB account with Azure Resource Manager templates

Dodawanie/usuwanie regionów z poziomu konta bazy danychAdd/remove regions from your database account

Azure PortalAzure portal

  1. Zaloguj się do Azure Portal.Sign in to Azure portal.

  2. Przejdź do konta usługi Azure Cosmos i otwórz menu Replikacja danych globalnie .Go to your Azure Cosmos account, and open the Replicate data globally menu.

  3. Aby dodać regiony, zaznacz sześciokąty na mapie z + etykietą odpowiadającą żądanym regionom.To add regions, select the hexagons on the map with the + label that corresponds to your desired region(s). Alternatywnie, aby dodać region, wybierz opcję + Dodaj region i wybierz region z menu rozwijanego.Alternatively, to add a region, select the + Add region option and choose a region from the drop-down menu.

  4. Aby usunąć regiony, usuń co najmniej jeden region z mapy, wybierając niebieskie sześciokąty ze znacznikami wyboru.To remove regions, clear one or more regions from the map by selecting the blue hexagons with check marks. Możesz też wybrać ikonę „kosza na śmieci” (🗑) z prawej strony regionu.Or select the "wastebasket" (🗑) icon next to the region on the right side.

  5. Aby zapisać zmiany, wybierz pozycję OK.To save your changes, select OK.

    Menu dodawania lub usuwania regionów

W trybie zapisu w jednym regionie nie można usunąć regionu zapisu.In a single-region write mode, you cannot remove the write region. Aby można było usunąć bieżący region zapisu, należy przejść do trybu failover w innym regionie.You must fail over to a different region before you can delete the current write region.

W trybie zapisu w wielu regionach można dodawać lub usuwać dowolne regiony, o ile pozostaje co najmniej jeden region.In a multi-region write mode, you can add or remove any region, if you have at least one region.

Interfejs wiersza polecenia platformy AzureAzure CLI

Zobacz Dodawanie lub usuwanie regionów przy użyciu interfejsu wiersza polecenia platformy AzurePlease see Add or remove regions with Azure CLI

Azure PowerShellAzure PowerShell

Zobacz Dodawanie lub usuwanie regionów przy użyciu programu PowerShellPlease see Add or remove regions with PowerShell

Konfigurowanie wielu regionów zapisuConfigure multiple write-regions

Azure PortalAzure portal

Otwórz kartę Replikuj dane globalnie i wybierz pozycję Włącz , aby włączyć zapisywanie w ramach wieloregionu.Open the Replicate Data Globally tab and select Enable to enable multi-region writes. Po włączeniu zapisów obejmujących wiele regionów wszystkie regiony odczytu znajdujące się obecnie na koncie staną się regionami odczytu i zapisu.After you enable multi-region writes, all the read regions that you currently have on the account will become read and write regions.

Konto usługi Azure Cosmos służy do konfigurowania wieloregionowego zrzutu ekranu

Interfejs wiersza polecenia platformy AzureAzure CLI

Zobacz Włączanie regionów wielu zapisów za pomocą interfejsu wiersza polecenia platformy AzurePlease see Enable multiple-write regions with Azure CLI

Azure PowerShellAzure PowerShell

Zobacz Włączanie regionów wielu zapisów przy użyciu programu PowerShellPlease see Enable multiple-write regions with PowerShell

Szablon usługi Resource ManagerResource Manager template

Konto można migrować z jednego regionu zapisu do wielu regionów zapisu, wdrażając szablon Menedżer zasobów używany do tworzenia konta i ustawienia enableMultipleWriteLocations: true .An account can be migrated from single write region to multiple write regions by deploying the Resource Manager template used to create the account and setting enableMultipleWriteLocations: true. Następujący szablon Azure Resource Manager jest nieminimalnym szablonem, który spowoduje wdrożenie konta Azure Cosmos dla interfejsu API SQL z dwoma regionami i włączenie wielu lokalizacji zapisu.The following Azure Resource Manager template is a bare minimum template that will deploy an Azure Cosmos account for SQL API with two regions and multiple write locations enabled.

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "name": {
            "type": "String"
        },
        "location": {
            "type": "String",
            "defaultValue": "[resourceGroup().location]"
        },
        "primaryRegion":{
            "type":"string",
            "metadata": {
                "description": "The primary replica region for the Cosmos DB account."
            }
        },
        "secondaryRegion":{
            "type":"string",
            "metadata": {
              "description": "The secondary replica region for the Cosmos DB account."
          }
        }
    },
    "resources": [
        {
            "type": "Microsoft.DocumentDb/databaseAccounts",
            "kind": "GlobalDocumentDB",
            "name": "[parameters('name')]",
            "apiVersion": "2019-08-01",
            "location": "[parameters('location')]",
            "tags": {},
            "properties": {
                "databaseAccountOfferType": "Standard",
                "consistencyPolicy": { "defaultConsistencyLevel": "Session" },
                "locations":
                [
                    {
                        "locationName": "[parameters('primaryRegion')]",
                        "failoverPriority": 0,
                        "isZoneRedundant": false
                    },
                    {
                        "locationName": "[parameters('secondaryRegion')]",
                        "failoverPriority": 1,
                        "isZoneRedundant": false
                    }
                ],
                "enableMultipleWriteLocations": true
            }
        }
    ]
}

Włączanie automatycznego przejścia do trybu failover dla konta usługi Azure CosmosEnable automatic failover for your Azure Cosmos account

Opcja automatycznej pracy awaryjnej umożliwia Azure Cosmos DB przełączenia w tryb failover do regionu z najwyższym priorytetem trybu failover bez akcji użytkownika, jeśli region staje się niedostępny.The Automatic failover option allows Azure Cosmos DB to failover to the region with the highest failover priority with no user action should a region become unavailable. Gdy włączona jest automatyczna tryb failover, priorytet regionu można modyfikować.When automatic failover is enabled, region priority can be modified. Aby można było włączyć automatyczne przełączanie do trybu failover, konto musi mieć co najmniej dwa regiony.Account must have two or more regions to enable automatic failover.

Azure PortalAzure portal

  1. Na koncie usługi Azure Cosmos Otwórz okienko Replikuj dane globalnie .From your Azure Cosmos account, open the Replicate data globally pane.

  2. U góry okienka wybierz pozycję Automatyczne przełączanie w tryb failover.At the top of the pane, select Automatic Failover.

    Menu globalnego replikowania danych

  3. W okienku Automatyczne przełączanie w tryb failover upewnij się, że przełącznik Włącz automatyczne przejście w tryb failover jest ustawiony w pozycji .On the Automatic Failover pane, make sure that Enable Automatic Failover is set to ON.

  4. Wybierz pozycję Zapisz.Select Save.

    Menu Automatyczne przełączanie w tryb failover w portalu

Interfejs wiersza polecenia platformy AzureAzure CLI

Zobacz Włączanie automatycznego przełączania do trybu failover przy użyciu interfejsu wiersza polecenia platformy AzurePlease see Enable automatic failover with Azure CLI

Azure PowerShellAzure PowerShell

Zobacz Włączanie automatycznego przełączania do trybu failover przy użyciu programu PowerShellPlease see Enable automatic failover with PowerShell

Ustawianie priorytetów trybu failover dla konta usługi Azure CosmosSet failover priorities for your Azure Cosmos account

Po skonfigurowaniu konta usługi Cosmos do automatycznego przełączania w tryb failover priorytet trybu failover dla regionów można zmienić.After a Cosmos account is configured for automatic failover, the failover priority for regions can be changed.

Ważne

Nie można zmodyfikować regionu zapisu (priorytet trybu failover równy zero), jeśli konto jest skonfigurowane do automatycznego przełączania do trybu failover.You cannot modify the write region (failover priority of zero) when the account is configured for automatic failover. Aby zmienić region zapisu, należy wyłączyć automatyczne przełączanie do trybu failover i przeprowadzić ręczną pracę awaryjną.To change the write region, you must disable automatic failover and do a manual failover.

Azure PortalAzure portal

  1. Na koncie usługi Azure Cosmos Otwórz okienko Replikuj dane globalnie .From your Azure Cosmos account, open the Replicate data globally pane.

  2. U góry okienka wybierz pozycję Automatyczne przełączanie w tryb failover.At the top of the pane, select Automatic Failover.

    Menu globalnego replikowania danych

  3. W okienku Automatyczne przełączanie w tryb failover upewnij się, że przełącznik Włącz automatyczne przejście w tryb failover jest ustawiony w pozycji .On the Automatic Failover pane, make sure that Enable Automatic Failover is set to ON.

  4. Aby zmodyfikować priorytety trybu failover, przeciągnij regiony odczytu za pośrednictwem trzech kropek znajdujących się po lewej stronie wiersza, który jest wyświetlany po umieszczeniu na nich wskaźnika myszy.To modify the failover priority, drag the read regions via the three dots on the left side of the row that appear when you hover over them.

  5. Wybierz pozycję Zapisz.Select Save.

    Menu Automatyczne przełączanie w tryb failover w portalu

Interfejs wiersza polecenia platformy AzureAzure CLI

Zobacz Ustawianie priorytetu trybu failover przy użyciu interfejsu wiersza polecenia platformy AzurePlease see Set failover priority with Azure CLI

Azure PowerShellAzure PowerShell

Zobacz Ustawianie priorytetu trybu failover przy użyciu programu PowerShellPlease see Set failover priority with PowerShell

Wykonaj ręczną pracę awaryjną na koncie usługi Azure CosmosPerform manual failover on an Azure Cosmos account

Ważne

Aby ta operacja zakończyła się pomyślnie, należy skonfigurować konto usługi Azure Cosmos do ręcznego przełączania do trybu failover.The Azure Cosmos account must be configured for manual failover for this operation to succeed.

Proces przeprowadzania ręcznej pracy awaryjnej polega na zmianie regionu zapisu konta (priorytetu trybu failover = 0) w innym regionie skonfigurowanym dla tego konta.The process for performing a manual failover involves changing the account's write region (failover priority = 0) to another region configured for the account.

Uwaga

Kont z wieloma regionami zapisu nie można przełączyć ręcznie do trybu failover.Accounts with multiple write regions cannot be manually failed over. W przypadku aplikacji korzystających z zestawu SDK usługi Azure Cosmos zestaw SDK wykrywa, kiedy region stanie się niedostępny, a następnie przekierowuje automatycznie do następnego najbliższego regionu, jeśli używany jest interfejs API multihostingu w zestawie SDK.For applications using the Azure Cosmos SDK, the SDK will detect when a region becomes unavailable, then redirect automatically to the next closest region if using multi-homing API in the SDK.

Azure PortalAzure portal

  1. Przejdź do konta usługi Azure Cosmos i otwórz menu Replikacja danych globalnie .Go to your Azure Cosmos account, and open the Replicate data globally menu.

  2. W górnej części menu wybierz pozycję Ręczne przejście do trybu failover.At the top of the menu, select Manual Failover.

    Menu globalnego replikowania danych

  3. W menu Ręczne przejście do trybu failover wybierz nowy region zapisu.On the Manual Failover menu, select your new write region. Zaznacz pole wyboru, aby wskazać, że rozumiesz, iż ta opcja zmienia region zapisu.Select the check box to indicate that you understand this option changes your write region.

  4. Aby wyzwolić tryb failover, wybierz pozycję OK.To trigger the failover, select OK.

    Menu Ręczne przejście do trybu failover w portalu

Interfejs wiersza polecenia platformy AzureAzure CLI

Zobacz wyzwalanie ręcznego przełączania do trybu failover przy użyciu interfejsu wiersza polecenia platformy AzurePlease see Trigger manual failover with Azure CLI

Azure PowerShellAzure PowerShell

Zobacz wyzwalanie ręcznego przełączania w tryb failover przy użyciu programu PowerShellPlease see Trigger manual failover with PowerShell

Następne krokiNext steps

Aby uzyskać więcej informacji i zapoznać się z przykładami dotyczącymi zarządzania kontem usługi Azure Cosmos oraz bazą danych i kontenerami, przeczytaj następujące artykuły:For more information and examples on how to manage the Azure Cosmos account as well as database and containers, read the following articles: