az cosmosdb sql container

Verwalten von SQL-Containern für Azure Cosmos DB

Befehle

az cosmosdb sql container create

Erstellen Sie einen SQL-Container unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container delete

Löschen Sie den SQL-Container unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container exists

Überprüft, ob ein Azure Cosmos DB SQL-Container vorhanden ist.

az cosmosdb sql container list

Listet die SQL-Container unter einer Azure Cosmos DB SQL-Datenbank auf.

az cosmosdb sql container merge

Fügt die Partitionen eines SQL-Containers zusammen.

az cosmosdb sql container redistribute-partition-throughput

Verteilt den Partitionsdurchsatz eines SQL-Containers.

az cosmosdb sql container retrieve-partition-throughput

Rufen Sie den Partitionsdurchsatz eines SQL-Containers ab.

az cosmosdb sql container show

Zeigen Sie die Details eines SQL-Containers unter einer Azure Cosmos DB SQL-Datenbank an.

az cosmosdb sql container throughput

Verwalten des Durchsatzes des SQL-Containers unter einem Azure Cosmos DB-Konto.

az cosmosdb sql container throughput migrate

Migrieren Sie den Durchsatz des SQL-Containers zwischen der automatischen Skalierung und manuell bereitgestellt.

az cosmosdb sql container throughput show

Rufen Sie den Durchsatz des SQL-Containers unter einer Azure Cosmos DB SQL-Datenbank ab.

az cosmosdb sql container throughput update

Aktualisieren Sie den Durchsatz des SQL-Containers unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container update

Aktualisieren eines SQL-Containers unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container create

Erstellen Sie einen SQL-Container unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container create --account-name
                                 --database-name
                                 --name
                                 --partition-key-path
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--cep]
                                 [--conflict-resolution-policy]
                                 [--idx]
                                 [--max-throughput]
                                 [--partition-key-version]
                                 [--throughput]
                                 [--ttl]
                                 [--unique-key-policy]

Beispiele

Erstellen Sie einen AZURE Cosmos DB SQL-Container.

az cosmosdb sql container create -g MyResourceGroup -a MyAccount -d MyDatabase -n MyContainer --partition-key-path "/my/path" --idx @policy-file.json --ttl 1000 --throughput "700"

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--database-name -d

Datenbankname.

--name -n

Der Containername.

--partition-key-path -p

Partition Key Path, z. B. "/address/zipcode".

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--analytical-storage-ttl -t

Analytische TTL, wenn der analytische Speicher aktiviert ist.

--cep

Clientverschlüsselungsrichtlinie können Sie als Zeichenfolge oder als Datei eingeben, z. B. "-cep" oder --cep @policy-file.json "{"includedPaths": ["path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType","encryptionType": "Deterministic"}],"policyFormatVersion": 2}".

--conflict-resolution-policy -c

Konfliktauflösungsrichtlinie können Sie als Zeichenfolge oder als Datei eingeben, z. B. --conflict-resolution-policy @policy-file.json oder --conflict-resolution-policy "{"mode": "lastWriterWins", "conflictResolutionPath": "/path"}".

--idx

Indizierungsrichtlinie können Sie es als Zeichenfolge oder als Datei eingeben, z. B. "-idx" oder --idx @policy-file.json "{"indexingMode": "konsistent", "automatic": true, "includedPaths": [{"path": "/*"}], "ausgeschlossenPaths": [{ "pfad": "/headquarters/employees/?"}", { "path": "/"_etag"?}}".

Standardwert: { "indexingMode": "consistent", "automatic": true, "includedPaths": [ { "path": "/*" } ], "excludedPaths": [ { "path": "/\"_etag\"/?" } ] }
--max-throughput

Die maximale Durchsatzressource kann auf (RU/s) skaliert werden. Wird bereitgestellt, wenn die Ressource automatisch skaliert ist. Der Mindestwert kann 4000 (RU/s) sein.

--partition-key-version

Die Version des Partitionsschlüssels.

--throughput

Der Durchsatz des SQL-Containers (RU/s). Standardwert ist 400. Lassen Sie diesen Parameter aus, wenn die Datenbank über den freigegebenen Durchsatz verfügt, es sei denn, der Container sollte über einen dedizierten Durchsatz verfügen.

--ttl

Standard-TTL. Wenn der Wert auf "-1" fehlt oder festgelegt ist, laufen Elemente nicht ab. Wenn der Wert auf "n" festgelegt ist, läuft elemente nach der letzten Änderungszeit "n" ab.

--unique-key-policy -u

Eindeutige Schlüsselrichtlinie können Sie es als Zeichenfolge oder als Datei eingeben, z. B. --unique-key-policy oder --unique-key-policy @policy-file.json "{"uniqueKeys": [{"path/to/key1"]}, {"path/to/key1"}, {"path": ["/path/to/key2"}}".

az cosmosdb sql container delete

Löschen Sie den SQL-Container unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container delete --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--yes]

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--database-name -d

Datenbankname.

--name -n

Der Containername.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--yes -y

Nicht zur Bestätigung auffordern

az cosmosdb sql container exists

Überprüft, ob ein Azure Cosmos DB SQL-Container vorhanden ist.

az cosmosdb sql container exists --account-name
                                 --database-name
                                 --name
                                 --resource-group

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--database-name -d

Datenbankname.

--name -n

Der Containername.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cosmosdb sql container list

Listet die SQL-Container unter einer Azure Cosmos DB SQL-Datenbank auf.

az cosmosdb sql container list --account-name
                               --database-name
                               --resource-group

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--database-name -d

Datenbankname.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cosmosdb sql container merge

Fügt die Partitionen eines SQL-Containers zusammen.

az cosmosdb sql container merge --account-name
                                --database-name
                                --name
                                --resource-group

Beispiele

Zusammenführen von Partitionen des Containers "my-container"

az cosmosdb sql container merge -g my-resource-group -a my-account -d my-db --name my-container

Erforderliche Parameter

--account-name -a

Name des CosmosDB-Datenbankkontos.

--database-name -d

Name des CosmosDB-Datenbanknamens.

--name -n

Name der CosmosDB-Auflistung.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cosmosdb sql container redistribute-partition-throughput

Verteilt den Partitionsdurchsatz eines SQL-Containers.

az cosmosdb sql container redistribute-partition-throughput --account-name
                                                            --database-name
                                                            --name
                                                            --resource-group
                                                            [--evenly-distribute {false, true}]
                                                            [--source-partition-info]
                                                            [--target-partition-info]

Beispiele

Gleichmäßig verteilt den Partitionsdurchsatz für einen SQL-Container unter allen physischen Partitionen.

az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --evenly-distribute

Verteiler den Partitionsdurchsatz für einen SQL-Container aus Quellpartitionen zu Zielpartitionen

az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --target-partition-info 8=1200 6=1200]' --source-partition-info 9]'

Erforderliche Parameter

--account-name -a

Name des CosmosDB-Datenbankkontos.

--database-name -d

Name des CosmosDB-Datenbanknamens.

--name -n

Name der CosmosDB-Auflistung.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--evenly-distribute

Wechseln Sie zum Verteilen des Durchsatzes gleichermaßen unter allen physischen Partitionen.

Zulässige Werte: false, true
--source-partition-info

Leerzeichen getrennte physische Partitions-IDs z. B. 1 2.

--target-partition-info

Informationen zum gewünschten physischen Partitionsdurchsatz z. B. 0=1200 1=1200.

az cosmosdb sql container retrieve-partition-throughput

Rufen Sie den Partitionsdurchsatz eines SQL-Containers ab.

az cosmosdb sql container retrieve-partition-throughput --account-name
                                                        --database-name
                                                        --name
                                                        --resource-group
                                                        [--all-partitions {false, true}]
                                                        [--physical-partition-ids]

Beispiele

Abrufen des Containerdurchsatzs container_name für bestimmte physische Partitionen

az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --physical-partition-ids 8 9

Abrufen des Container-container_name-Durchsatzs für alle physischen Partitionen

az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name  --resource-group rg_name --all-partitions

Erforderliche Parameter

--account-name -a

Name des CosmosDB-Datenbankkontos.

--database-name -d

Name des CosmosDB-Datenbanknamens.

--name -n

Name des CosmosDB-Containers.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--all-partitions

Wechseln Sie zum Abrufen des Durchsatzes für alle physischen Partitionen.

Zulässige Werte: false, true
--physical-partition-ids -p

Leerzeichentrennte Liste der physischen Partitions-IDs.

az cosmosdb sql container show

Zeigen Sie die Details eines SQL-Containers unter einer Azure Cosmos DB SQL-Datenbank an.

az cosmosdb sql container show --account-name
                               --database-name
                               --name
                               --resource-group

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--database-name -d

Datenbankname.

--name -n

Der Containername.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

az cosmosdb sql container update

Aktualisieren eines SQL-Containers unter einer Azure Cosmos DB SQL-Datenbank.

az cosmosdb sql container update --account-name
                                 --database-name
                                 --name
                                 --resource-group
                                 [--analytical-storage-ttl]
                                 [--idx]
                                 [--ttl]

Erforderliche Parameter

--account-name -a

Cosmosdb-Kontoname.

--database-name -d

Datenbankname.

--name -n

Der Containername.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--analytical-storage-ttl -t

Analytische TTL, wenn der analytische Speicher aktiviert ist.

--idx

Indizierungsrichtlinie können Sie es als Zeichenfolge oder als Datei eingeben, z. B. "-idx" oder --idx @policy-file.json "{"indexingMode": "konsistent", "automatic": true, "includedPaths": [{"path": "/*"}], "ausgeschlossenPaths": [{ "pfad": "/headquarters/employees/?"}", { "path": "/"_etag"?}}".

--ttl

Standard-TTL. Wenn der Wert auf "-1" fehlt oder festgelegt ist, laufen Elemente nicht ab. Wenn der Wert auf "n" festgelegt ist, läuft elemente nach der letzten Änderungszeit "n" ab.