Crearea de resurse

  • 4 minute

Atunci când gestionați conturile Azure Cosmos DB pentru NoSQL utilizând Azure CLI, majoritatea comenzilor vor fi împărțite în două grupuri de comenzi CLI nucleu:

  • az cosmosdb: Acest grup conține comenzile necesare pentru a crea și a gestiona un nou cont Azure Cosmos DB.
  • az cosmosdb sql: Acest subgrup al az cosmosdb grup conține comenzile pentru gestionarea resurselor specifice NoSQL API, cum ar fi bazele de date și containerele.

Comenzile grupului de conturi Azure Cosmos DB

Pentru a crea un cont nou, va trebui să utilizați az cosmosdb create comandă. Această comandă necesită cel puțin numele noului cont pentru a crea și grupul de resurse țintă pentru resursa de cont. Atunci când creați noul cont, trebuie să vă asigurați că numele pe care îl utilizați este unic global pentru a evita ca comanda să nu reușească din cauza unui conflict de nume cu altă instanță de serviciu.

Sfat

În mod implicit, această comandă va crea un cont NoSQL nou.

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

Atunci când creați un cont nou, puteți specifica opțional parametri suplimentari pentru a controla caracteristicile contului nou creat. De exemplu, această comandă activează nivelul liber și setează nivelul de consistență implicit pentru a Eventual.

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

În majoritatea cazurilor, se recomandă să specificați regiunea în care doriți să implementați contul Azure Cosmos DB. Puteți utiliza argumentul locații pentru a specifica una sau mai multe locații țintă pentru contul dvs.

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

Mai târziu, veți afla cum să specificați mai multe locații țintă în timp ce setați prioritățile corespunzătoare pentru reluare în caz de nereușită pentru fiecare locație.

Notă

Atunci când aveți îndoieli, puteți căuta oricând documentația de ajutor pentru comenzi utilizând argumentul --help în aceste exemple: az cosmosdb --help & az cosmosdb create --help.

Comenzi subgrup Azure Cosmos DB pentru NoSQL

az cosmosdb sql grup de comenzi conține mai multe comenzi și subgrupuri pentru a gestiona resurse individuale în cadrul NoSQL API. De exemplu, puteți utiliza baza de date sql cosmosdb create command pentru a crea o bază de date nouă într-un cont existent. În acest exemplu, argumentul --name se referă la numele noii baze de date, iar argumentul --account-name se referă la numele contului creat anterior.

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

Comanda az cosmosdb sql container create command creează un nou container într-o bază de date existentă. Argumentul nume în acest context se referă la numele noului container, în timp ce argumentul --database-name se referă la numele bazei de date create anterior.

Această comandă de creare necesită, de asemenea, cel puțin o valoare pentru --partition-key-path argument, deoarece acest argument este necesar pentru toate containerele din Azure Cosmos DB pentru 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>'

Notă

Atunci când aveți îndoieli, puteți căuta oricând documentația de ajutor pentru comenzi utilizând argumentul --help în aceste exemple: az cosmosdb sql --help, az cosmosdb sql database --help, & az cosmosdb sql container --help.