az cosmosdb sql container

Azure Cosmos DB SQL 컨테이너를 관리합니다.

명령

az cosmosdb sql container create

Azure Cosmos DB SQL 데이터베이스 아래에 SQL 컨테이너를 만듭니다.

az cosmosdb sql container delete

Azure Cosmos DB SQL 데이터베이스에서 SQL 컨테이너를 삭제합니다.

az cosmosdb sql container exists

Azure Cosmos DB SQL 컨테이너가 있는지 확인합니다.

az cosmosdb sql container list

Azure Cosmos DB SQL 데이터베이스 아래에 SQL 컨테이너를 나열합니다.

az cosmosdb sql container merge

sql 컨테이너의 파티션을 병합합니다.

az cosmosdb sql container redistribute-partition-throughput

sql 컨테이너의 파티션 처리량을 재배포합니다.

az cosmosdb sql container retrieve-partition-throughput

sql 컨테이너의 파티션 처리량을 검색합니다.

az cosmosdb sql container show

Azure Cosmos DB SQL 데이터베이스 아래에 SQL 컨테이너의 세부 정보를 표시합니다.

az cosmosdb sql container throughput

Azure Cosmos DB 계정으로 SQL 컨테이너의 처리량을 관리합니다.

az cosmosdb sql container throughput migrate

자동 크기 조정과 수동으로 프로비전된 간에 SQL 컨테이너의 처리량을 마이그레이션합니다.

az cosmosdb sql container throughput show

Azure Cosmos DB SQL 데이터베이스에서 SQL 컨테이너의 처리량을 가져옵니다.

az cosmosdb sql container throughput update

Azure Cosmos DB SQL 데이터베이스에서 SQL 컨테이너의 처리량을 업데이트합니다.

az cosmosdb sql container update

Azure Cosmos DB SQL 데이터베이스에서 SQL 컨테이너를 업데이트합니다.

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"

필수 매개 변수

--account-name -a

Cosmosdb 계정 이름입니다.

--database-name -d

데이터베이스 이름

--name -n

컨테이너 이름

--partition-key-path -p

파티션 키 경로(예: '/address/zipcode').

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--analytical-storage-ttl -t

분석 스토리지를 사용하도록 설정한 경우의 분석 TTL입니다.

--cep

클라이언트 암호화 정책, 문자열 또는 파일로 입력할 수 있습니다. 예: --cep 또는 --cep @policy-file.json "{"includedPaths": [{"path": "/path1","clientEncryptionKeyId": "key1","encryptionAlgorithm": "AEAD_AES_256_CBC_HMAC_SHA256","encryptionType": "Deterministic"}],"policyFormatVersion": 2}".

--conflict-resolution-policy -c

충돌 해결 정책에서는 문자열 또는 파일(예: --conflict-resolution-policy 또는 --conflict-resolution-policy @policy-file.json "{"mode": "lastWriterWins", "conflictResolutionPath": "/path"}")으로 입력할 수 있습니다.

--idx

인덱싱 정책, 문자열 또는 파일로 입력할 수 있습니다. 예: --idx 또는 --idx @policy-file.json "{"indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}, { "path": "/"_etag"/}".

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

최대 처리량 리소스는 (RU/s)로 확장할 수 있습니다. 리소스가 자동 크기 조정을 사용하도록 설정된 경우 제공됩니다. 최소값은 4000(RU/s)일 수 있습니다.

--partition-key-version

파티션 키의 버전입니다.

--throughput

SQL 컨테이너(RU/s)의 처리량입니다. 기본값은 400입니다. 컨테이너에 전용 처리량이 있어야 하는 경우가 아니면 데이터베이스에 공유 처리량이 있는 경우 이 매개 변수를 생략합니다.

--ttl

기본 TTL입니다. 값이 없거나 "-1"로 설정된 경우 항목이 만료되지 않습니다. 값이 "n"으로 설정된 경우 항목은 마지막으로 수정한 시간 후 "n" 초 후에 만료됩니다.

--unique-key-policy -u

고유 키 정책, 문자열 또는 파일(예: --unique-key-policy 또는 --unique-key-policy @policy-file.json "{"uniqueKeys": [{"paths": ["/path/to/key1"]}, {"paths": ["/path/to/key2"]}}}")으로 입력할 수 있습니다.

az cosmosdb sql container delete

Azure Cosmos DB SQL 데이터베이스에서 SQL 컨테이너를 삭제합니다.

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

필수 매개 변수

--account-name -a

Cosmosdb 계정 이름입니다.

--database-name -d

데이터베이스 이름

--name -n

컨테이너 이름

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az cosmosdb sql container exists

Azure Cosmos DB SQL 컨테이너가 있는지 확인합니다.

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

필수 매개 변수

--account-name -a

Cosmosdb 계정 이름입니다.

--database-name -d

데이터베이스 이름

--name -n

컨테이너 이름

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az cosmosdb sql container list

Azure Cosmos DB SQL 데이터베이스 아래에 SQL 컨테이너를 나열합니다.

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

필수 매개 변수

--account-name -a

Cosmosdb 계정 이름입니다.

--database-name -d

데이터베이스 이름

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az cosmosdb sql container merge

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

필수 매개 변수

--account-name -a

CosmosDB 데이터베이스 계정의 이름입니다.

--database-name -d

CosmosDB 데이터베이스 이름의 이름입니다.

--name -n

CosmosDB 컬렉션의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az cosmosdb sql container redistribute-partition-throughput

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]'

필수 매개 변수

--account-name -a

CosmosDB 데이터베이스 계정의 이름입니다.

--database-name -d

CosmosDB 데이터베이스 이름의 이름입니다.

--name -n

CosmosDB 컬렉션의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--evenly-distribute

모든 실제 파티션 간에 처리량을 동일하게 분산하도록 전환합니다.

허용되는 값: false, true
--source-partition-info

공백으로 구분된 원본 실제 파티션 ID(예: 1 2).

--target-partition-info

원하는 대상 실제 파티션 처리량에 대한 정보(예: 0=1200 1=1200).

az cosmosdb sql container retrieve-partition-throughput

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

필수 매개 변수

--account-name -a

CosmosDB 데이터베이스 계정의 이름입니다.

--database-name -d

CosmosDB 데이터베이스 이름의 이름입니다.

--name -n

CosmosDB 컨테이너의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--all-partitions

모든 실제 파티션에 대한 처리량을 검색하도록 전환합니다.

허용되는 값: false, true
--physical-partition-ids -p

실제 파티션 ID의 공백으로 구분된 목록입니다.

az cosmosdb sql container show

Azure Cosmos DB SQL 데이터베이스 아래에 SQL 컨테이너의 세부 정보를 표시합니다.

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

필수 매개 변수

--account-name -a

Cosmosdb 계정 이름입니다.

--database-name -d

데이터베이스 이름

--name -n

컨테이너 이름

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

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]

필수 매개 변수

--account-name -a

Cosmosdb 계정 이름입니다.

--database-name -d

데이터베이스 이름

--name -n

컨테이너 이름

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--analytical-storage-ttl -t

분석 스토리지를 사용하는 경우 분석 TTL입니다.

--idx

인덱싱 정책, 문자열 또는 파일로 입력할 수 있습니다. 예: --idx 또는 --idx @policy-file.json "{"indexingMode": "consistent", "automatic": true, "includedPaths": [{"path": "/*"}], "excludedPaths": [{ "path": "/headquarters/employees/?"}} , { "path": "/"_etag"/}}}".

--ttl

기본 TTL입니다. 값이 없거나 "-1"로 설정된 경우 항목이 만료되지 않습니다. 값이 "n"으로 설정된 경우 항목은 마지막으로 수정한 시간 이후 "n" 초 후에 만료됩니다.