az cosmosdb sql container
Note
このコマンド グループには、Azure CLI と少なくとも 1 つの拡張機能の両方で定義されているコマンドがあります。 各拡張機能をインストールして、拡張機能を活用します。 拡張機能の詳細をご覧ください。
Azure Cosmos DB の SQL コンテナーを管理します。
コマンド
名前 | 説明 | 型 | 状態 |
---|---|---|---|
az cosmosdb sql container create |
Azure Cosmos DB SQL データベースの下に SQL コンテナーを作成します。 |
コア | GA |
az cosmosdb sql container create (cosmosdb-preview 拡張機能) |
Azure Cosmos DB SQL データベースの下に SQL コンテナーを作成します。 |
拡張機能 | GA |
az cosmosdb sql container delete |
Azure Cosmos DB SQL データベースの下にある SQL コンテナーを削除します。 |
コア | GA |
az cosmosdb sql container exists |
Azure Cosmos DB SQL コンテナーが存在するかどうかを確認します。 |
コア | GA |
az cosmosdb sql container list |
Azure Cosmos DB SQL データベースの下の SQL コンテナーを一覧表示します。 |
コア | GA |
az cosmosdb sql container merge |
SQL コンテナーのパーティションをマージします。 |
拡張機能 | プレビュー |
az cosmosdb sql container redistribute-partition-throughput |
SQL コンテナーのパーティション スループットを再配布します。 |
拡張機能 | プレビュー |
az cosmosdb sql container restore |
削除された SQL コンテナーを同じアカウント内に復元します。 |
コア | GA |
az cosmosdb sql container restore (cosmosdb-preview 拡張機能) |
削除された SQL コンテナーを同じアカウント内に復元します。 |
拡張機能 | プレビュー |
az cosmosdb sql container retrieve-partition-throughput |
SQL コンテナーのパーティション スループットを取得します。 |
拡張機能 | プレビュー |
az cosmosdb sql container show |
Azure Cosmos DB SQL データベースの下に SQL コンテナーの詳細を表示します。 |
コア | GA |
az cosmosdb sql container throughput |
Azure Cosmos DB アカウントで SQL コンテナーのスループットを管理します。 |
コア | GA |
az cosmosdb sql container throughput migrate |
自動スケーリングと手動プロビジョニングの間で SQL コンテナーのスループットを移行します。 |
コア | GA |
az cosmosdb sql container throughput show |
Azure Cosmos DB SQL データベースの SQL コンテナーのスループットを取得します。 |
コア | GA |
az cosmosdb sql container throughput update |
Azure Cosmos DB SQL データベースの SQL コンテナーのスループットを更新します。 |
コア | GA |
az cosmosdb sql container update |
Azure Cosmos DB SQL データベースの下にある SQL コンテナーを更新します。 |
コア | GA |
az cosmosdb sql container update (cosmosdb-preview 拡張機能) |
Azure Cosmos DB SQL データベースの下にある SQL コンテナーを更新します。 |
拡張機能 | GA |
az cosmosdb sql container create
Azure Cosmos DB SQL データベースの下に SQL コンテナーを作成します。
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]
例
Azure Cosmos DB SQL コンテナーを作成します。
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"
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
パーティション キーのパス (例: '/address/zipcode')。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
分析ストレージが有効になっている場合の分析 TTL。
クライアント暗号化ポリシーは、文字列またはファイルとして入力できます。たとえば、--cep または --cep @policy-file.json "{"includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"}],"policyFormatVersion": 2}"
競合解決ポリシーでは、文字列またはファイルとして入力できます(例: --conflict-resolution-policy @policy-file.json 、--conflict-resolution-policy "{"mode": "lastWriterWins"、"conflictResolutionPath": "/path"})。
インデックス作成ポリシー、 文字列またはファイルとして入力できます。例: --idx または --idx @policy-file.json "{"indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/}}}"。
最大スループット リソースは 、(RU/秒) にスケーリングできます。 リソースが自動スケーリングが有効な場合に提供されます。 最小値は 4000 (RU/秒) にすることができます。
パーティション キーのバージョン。
SQL コンテナーのスループット (RU/秒)。 既定値は 400 です。 コンテナーに専用スループットが必要でない限り、データベースに共有スループットがある場合は、このパラメーターを省略します。
既定の TTL。 値が見つからないか、"-1" に設定されている場合、項目は期限切れになりません。 値が "n" に設定されている場合、アイテムは最終変更時刻の後に "n" 秒後に期限切れになります。
一意キー ポリシーでは、文字列またはファイルとして入力できます。たとえば、--unique-key-policy や --unique-key-policy @policy-file.json "{"uniqueKeys": [{"paths": ["/path/to/key1"]}、{"paths": ["/path/to/key2"]}}"。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container create (cosmosdb-preview 拡張機能)
Azure Cosmos DB SQL データベースの下に SQL コンテナーを作成します。
az cosmosdb sql container create --account-name
--database-name
--name
--partition-key-path
--resource-group
[--analytical-storage-ttl]
[--cep]
[--conflict-resolution-policy]
[--idx]
[--materialized-view-definition]
[--max-throughput]
[--partition-key-version]
[--throughput]
[--ttl]
[--unique-key-policy]
例
Azure Cosmos DB SQL コンテナーを作成します。
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"
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
パーティション キーのパス (例: '/address/zipcode')。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
分析ストレージが有効になっている場合の分析 TTL。
クライアント暗号化ポリシーは、文字列またはファイルとして入力できます。たとえば、--cep または --cep @policy-file.json "{ "includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"}],"policyFormatVersion": 2}" です。
競合解決ポリシーでは、文字列またはファイルとして入力できます。たとえば、--conflict-resolution-policy @policy-file.json や --conflict-resolution-policy "{ "mode": "lastWriterWins"、"conflictResolutionPath": "/path" }" などです。
インデックス作成ポリシー、 文字列またはファイルとして入力できます(例: --idx @policy-file.json または --idx "{ "indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"} }".
具体化されたビュー定義。文字列またはファイルとして入力できます。たとえば、--materialized-view-definition @materializedview-definition-file.json または --materialized-view-definition -m '{ "sourceCollectionId": "MySourceCollectionName", "definition": "Standard Edition LECT * FROM root r"}'。
最大スループット リソースは 、(RU/秒) にスケーリングできます。 リソースが自動スケーリングが有効な場合に提供されます。 最小値は 4000 (RU/秒) にすることができます。
パーティション キーのバージョン。
SQL コンテナーのスループット (RU/秒)。 既定値は 400 です。 コンテナーに専用スループットが必要でない限り、データベースに共有スループットがある場合は、このパラメーターを省略します。
既定の TTL。 値が見つからないか、"-1" に設定されている場合、項目は期限切れになりません。 値が "n" に設定されている場合、アイテムは最終変更時刻の後に "n" 秒後に期限切れになります。
一意のキー ポリシー。文字列またはファイルとして入力できます。たとえば、--unique-key-policy や --unique-key-policy @policy-file.json "{ "uniqueKeys": [{"paths": ["/path/to/key1"]}、{"paths": ["/path/to/key2"]}} "
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container delete
Azure Cosmos DB SQL データベースの下にある SQL コンテナーを削除します。
az cosmosdb sql container delete --account-name
--database-name
--name
--resource-group
[--yes]
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
確認のダイアログを表示しません。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container exists
Azure Cosmos DB SQL コンテナーが存在するかどうかを確認します。
az cosmosdb sql container exists --account-name
--database-name
--name
--resource-group
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container list
Azure Cosmos DB SQL データベースの下の SQL コンテナーを一覧表示します。
az cosmosdb sql container list --account-name
--database-name
--resource-group
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container merge
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
SQL コンテナーのパーティションをマージします。
az cosmosdb sql container merge --account-name
--database-name
--name
--resource-group
例
コンテナー my-container のパーティションをマージする
az cosmosdb sql container merge -g my-resource-group -a my-account -d my-db --name my-container
必須のパラメーター
CosmosDB データベース アカウントの名前。
CosmosDB データベース名の名前。
CosmosDB コレクションの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container redistribute-partition-throughput
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
SQL コンテナーのパーティション スループットを再配布します。
az cosmosdb sql container redistribute-partition-throughput --account-name
--database-name
--name
--resource-group
[--evenly-distribute {false, true}]
[--source-partition-info]
[--target-partition-info]
例
SQL コンテナーのパーティション スループットをすべての物理パーティションに均等に分散する
az cosmosdb sql container redistribute-partition-throughput --account-name account_name --database-name db_name --name container_name --resource-group rg_name --evenly-distribute
ソース パーティションからターゲット パーティションに SQL コンテナーのパーティション スループットを再配布します
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]'
必須のパラメーター
CosmosDB データベース アカウントの名前。
CosmosDB データベース名の名前。
CosmosDB コレクションの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
すべての物理パーティション間でスループットを均等に分散するように切り替えます。
スペース区切りソース物理パーティション ID (例: 1 2)。
目的のターゲット物理パーティションのスループットに関する情報 (例: 0=1200 1=1200)。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container restore
削除された SQL コンテナーを同じアカウント内に復元します。
az cosmosdb sql container restore --account-name
--database-name
--name
--resource-group
[--restore-timestamp]
例
削除された SQL コンテナーを同じアカウント内に復元します。
az cosmosdb sql container restore --resource-group resource_group --account-name database_account_name --database-name parent_database_name --name name_of_container_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
コンテナーの復元先のタイムスタンプ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container restore (cosmosdb-preview 拡張機能)
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
削除された SQL コンテナーを同じアカウント内に復元します。
az cosmosdb sql container restore --account-name
--database-name
--name
--resource-group
[--disable-ttl {false, true}]
[--restore-timestamp]
例
削除された SQL コンテナーを同じアカウント内に復元します。
az cosmosdb sql container restore --resource-group resource_group --account-name database_account_name --database-name parent_database_name --name name_of_container_needs_to_be_restored --restore-timestamp 2020-07-13T16:03:41+0000
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
ttl を無効にして復元を有効または無効にします。
コンテナーの復元先のタイムスタンプ。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container retrieve-partition-throughput
このコマンドはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus
SQL コンテナーのパーティション スループットを取得します。
az cosmosdb sql container retrieve-partition-throughput --account-name
--database-name
--name
--resource-group
[--all-partitions {false, true}]
[--physical-partition-ids]
例
特定の物理パーティションのコンテナー container_nameのスループットを取得する
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
すべての物理パーティションのコンテナー container_nameのスループットを取得する
az cosmosdb sql container retrieve-partition-throughput --account-name account_name --database-name db_name --name container_name --resource-group rg_name --all-partitions
必須のパラメーター
CosmosDB データベース アカウントの名前。
CosmosDB データベース名の名前。
CosmosDB コンテナーの名前。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
すべての物理パーティションのスループットを取得するように切り替えます。
物理パーティション ID のスペース区切りリスト。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container show
Azure Cosmos DB SQL データベースの下に SQL コンテナーの詳細を表示します。
az cosmosdb sql container show --account-name
--database-name
--name
--resource-group
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container update
Azure Cosmos DB SQL データベースの下にある SQL コンテナーを更新します。
az cosmosdb sql container update --account-name
--database-name
--name
--resource-group
[--analytical-storage-ttl]
[--idx]
[--ttl]
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
分析ストレージが有効になっている場合の分析 TTL。
インデックス作成ポリシー、 文字列またはファイルとして入力できます。例: --idx または --idx @policy-file.json "{"indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/}}}"。
既定の TTL。 値が見つからないか、"-1" に設定されている場合、項目は期限切れになりません。 値が "n" に設定されている場合、アイテムは最終変更時刻の後に "n" 秒後に期限切れになります。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
az cosmosdb sql container update (cosmosdb-preview 拡張機能)
Azure Cosmos DB SQL データベースの下にある SQL コンテナーを更新します。
az cosmosdb sql container update --account-name
--database-name
--name
--resource-group
[--analytical-storage-ttl]
[--idx]
[--materialized-view-definition]
[--ttl]
必須のパラメーター
Cosmosdb アカウント名。
データベース名。
コンテナー名。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
省略可能のパラメーター
分析ストレージが有効になっている場合の分析 TTL。
インデックス作成ポリシー、 文字列またはファイルとして入力できます(例: --idx @policy-file.json または --idx "{ "indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/\"_etag\"/?"} }".
具体化されたビュー定義。文字列またはファイルとして入力できます。たとえば、--materialized-view-definition @materializedview-definition-file.json または --materialized-view-definition -m '{ "sourceCollectionId": "MySourceCollectionName", "definition": "Standard Edition LECT * FROM root r"}'。
既定の TTL。 値が見つからないか、"-1" に設定されている場合、項目は期限切れになりません。 値が "n" に設定されている場合、アイテムは最終変更時刻の後に "n" 秒後に期限切れになります。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI