Opret ressourcer

Når du administrerer Azure Cosmos DB for NoSQL-konti ved hjælp af Kommandolinjegrænsefladen i Azure, opdeles de fleste kommandoer i to kernekommandogrupper for kommandolinjegrænsefladen:

• az cosmosdb: Denne gruppe indeholder de kommandoer, der kræves for at oprette og administrere en ny Azure Cosmos DB-konto.
• az cosmosdb sql: Denne undergruppe af az cosmosdb gruppe indeholder kommandoerne til at administrere NoSQL API-specifikke ressourcer, f.eks. databaser og objektbeholdere.

Kommandoer til Azure Cosmos DB-kontogruppe

Hvis du vil oprette en ny konto, skal du bruge kommandoen az cosmosdb create. Denne kommando kræver som minimum kun navnet på den nye konto, der skal oprettes, og målressourcegruppen for kontoressourcen. Når du opretter den nye konto, skal du sikre dig, at det navn, du bruger, er globalt entydigt for at undgå, at kommandoen mislykkes pga. en navnekonflikt med en anden tjenesteforekomst.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>'

Når du opretter en ny konto, kan du også vælge at angive ekstra parametre for at styre egenskaberne for den nyoprettede konto. Denne kommando aktiverer f.eks. det gratis niveau og angiver standardkonsistensniveauet til Eventual.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --default-consistency-level 'Eventual' \
    --enable-free-tier 'true'

I de fleste tilfælde skal du angive det område, hvor du vil udrulle din Azure Cosmos DB-konto. Du kan bruge argumentet - placeringer til at angive en eller flere målplaceringer for din konto.

az cosmosdb create \
    --name '<account-name>' \
    --resource-group '<resource-group>' \
    --locations regionName='eastus'

Senere lærer du, hvordan du angiver flere målplaceringer, samtidig med at du angiver de relevante failoverprioriteter for hver placering.

Azure Cosmos DB til NoSQL-undergruppekommandoer

Kommandogruppen az cosmosdb sql indeholder flere kommandoer og undergrupper til administration af individuelle ressourcer i NoSQL-API'en. Du kan f.eks. bruge kommandoen az cosmosdb sql database create til at oprette en ny database i en eksisterende konto. I dette eksempel henviser argumentet --name til navnet på den nye database, og argumentet --account-name henviser til navnet på den konto, der blev oprettet tidligere.

az cosmosdb sql database create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --name '<database-name>' 

Den az cosmosdb sql-objektbeholder opretter kommando opretter en ny objektbeholder i en eksisterende database. Argumentet --name i denne kontekst henviser til navnet på den nye objektbeholder, mens argumentet --database-name refererer til navnet på den database, der tidligere er oprettet.

Denne oprettelseskommando kræver også som minimum en værdi for argumentet --partition-key-path, da dette argument er påkrævet for alle objektbeholdere i Azure Cosmos DB for NoSQL.

az cosmosdb sql container create \
    --account-name '<account-name>' \
    --resource-group '<resource-group>' \
    --database-name '<database-name>' \
    --name '<container-name>' \
    --throughput '400' \
    --partition-key-path '<partition-key-path-string>'