Erstellen eines Azure Cosmos DB for NoSQL-Kontos

GILT FÜR: NoSQL

Ein Azure Cosmos DB for NoSQL-Konto enthält alle Ihre Azure Cosmos DB-Ressourcen: Datenbanken, Container und Elemente. Das Konto stellt einen eindeutigen Endpunkt für verschiedene Tools und SDKs bereit, um eine Verbindung mit Azure Cosmos DB herzustellen und alltägliche Vorgänge auszuführen. Weitere Informationen zu den Ressourcen in Azure Cosmos DB finden Sie unter Azure Cosmos DB-Ressourcenmodell.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.

Erstellen eines Kontos

Erstellen Sie ein einzelnes Azure Cosmos DB-Konto mithilfe der API für NoSQL.

Azure-Befehlszeilenschnittstelle

1. Erstellen Sie Shellvariablen für accountName, resourceGroupName und location.

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. Wenn Sie das noch nicht getan haben, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an.

3. Erstellen Sie mit dem Befehl az group create eine neue Ressourcengruppe in Ihrem Abonnement.

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. Verwenden Sie den Befehl az cosmosdb create, um ein neues Azure Cosmos DB for NoSQL-Konto mit Standardeinstellungen zu erstellen.

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --locations regionName=$location
   

PowerShell

1. Erstellen Sie Shellvariablen für ACCOUNT_NAME, RESOURCE_GROUP_NAME und LOCATION.

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. Wenn Sie das noch nicht getan haben, melden Sie sich mit dem Cmdlet Connect-AzAccount bei Azure PowerShell an.

3. Erstellen Sie mit dem Cmdlet New-AzResourceGroup eine neue Ressourcengruppe in Ihrem Abonnement.

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. Verwenden Sie das Cmdlet New-AzCosmosDBAccount, um ein neues Azure Cosmos DB for NoSQL-Konto mit Standardeinstellungen zu erstellen.

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

Portal

Tipp

Für diese Anleitung empfehlen wir die Verwendung des Ressourcengruppennamens msdocs-cosmos.

1. Melden Sie sich beim Azure-Portal an.

2. Wählen Sie im Menü des Azure-Portals oder auf der Startseite die Option Ressource erstellen aus.

3. Suchen Sie auf der Seite Neu nach Azure Cosmos DB, und wählen Sie die Option aus.

4. Wählen Sie auf der Seite API-Option auswählen die Option Erstellen im Abschnitt NoSQL – Empfehlen aus. Bei Azure Cosmos DB gibt es fünf APIs: „SQL“, „MongoDB“, „Gremlin“, „Tabelle“ und „Cassandra“. Weitere Informationen zur API für NoSQL.

   

5. Geben Sie auf der Seite Azure Cosmos DB-Konto erstellen die folgenden Informationen ein:

   Einstellung	Wert	BESCHREIBUNG
   Subscription	Abonnementname	Wählen Sie das Azure-Abonnement aus, das Sie für dieses Azure Cosmos DB-Konto verwenden möchten.
   Ressourcengruppe	Ressourcengruppenname	Wählen Sie eine Ressourcengruppe aus, oder wählen Sie Neu erstellen aus, und geben Sie einen eindeutigen Namen für die Ressourcengruppe ein.
   Kontoname	Ein eindeutiger Name	Geben Sie einen Namen zur Identifizierung Ihres Azure Cosmos DB-Kontos ein. Weil der Name als Teil eines vollqualifizierten Domänennamens (FQDN) mit dem Suffix documents.azure.com verwendet wird, muss er global eindeutig sein. Der Name darf nur Kleinbuchstaben, Zahlen und den Bindestrich (-) enthalten. Außerdem muss der Name zwischen 3 und 44 Zeichen lang sein.
   Standort	Die Region, die Ihren Benutzern am nächsten liegt	Wählen Sie einen geografischen Standort aus, an dem Ihr Azure Cosmos DB-Konto gehostet werden soll. Verwenden Sie den Standort, der Ihren Benutzern am nächsten ist, damit sie möglichst schnell auf die Daten zugreifen können.
   Kapazitätsmodus	Bereitgestellter Durchsatz oder serverlos	Wählen Sie Bereitgestellter Durchsatz aus, um ein Konto im Modus Bereitgestellter Durchsatz zu erstellen. Wählen Sie Serverlos aus, um ein Konto im Modus Serverlos zu erstellen.
   Anwenden des Rabatts für den Free-Tarif von Azure Cosmos DB	Anwenden oder Nicht anwenden	Mit dem Azure Cosmos DB-Tarif „Free“ erhalten Sie die ersten 1000 RUs/Sek. sowie 25 GB Speicher kostenlos in einem Konto. Weitere Informationen zum Tarif „Free“

   Hinweis

   Sie können pro Azure-Abonnement maximal ein Azure Cosmos DB-Konto im Free-Tarif einrichten und müssen sich beim Erstellen des Kontos anmelden. Wird die Option zum Anwenden des tarifspezifischen Rabatts für den Free-Tarif nicht angezeigt, bedeutet dies, dass bereits ein anderes Konto im Abonnement mit dem Free-Tarif aktiviert wurde.

   

6. Klicken Sie auf Überprüfen + erstellen.

7. Überprüfen Sie die von Ihnen angegebenen Einstellungen, und wählen Sie dann Erstellen aus. Die Erstellung des Kontos dauert einige Minuten. Warten Sie, bis auf der Portalseite Ihre Bereitstellung ist abgeschlossen angezeigt wird, bevor sie den Vorgang fortsetzen.

8. Wählen Sie Zu Ressource wechseln aus, um zur Seite des Azure Cosmos DB-Kontos zu wechseln.

   

Nächste Schritte

In dieser Anleitung haben Sie gelernt, wie Sie ein Azure Cosmos DB for NoSQL-Konto erstellen. Sie können jetzt eine Anwendung mit Ihrem Azure Cosmos DB-Konto erstellen.

Erstellen einer .NET-Konsolenanwendung mit Azure Cosmos DB for NoSQL