Microsoft.DocumentDB databaseAccounts/sqlDatabases/containers 2023-04-15
- 최신
- 2024-05-15
- 2024-05-15-preview
- 2024-02-15-preview
- 2023-11-15
- 2023-11-15-preview
- 2023-09-15
- 2023-09-15-preview
- 2023-04-15
- 2023-03-15
- 2023-03-15-preview
- 2023-03-01-preview
- 2022-11-15
- 2022-11-15-preview
- 2022-08-15
- 2022-08-15-preview
- 2022-05-15
- 2022-05-15-preview
- 2022-02-15-preview
- 2021-11-15-preview
- 2021-10-15
- 2021-10-15-preview
- 2021-07-01-preview
- 2021-06-15
- 2021-05-15
- 2021-04-15
- 2021-04-01-preview
- 2021-03-15
- 2021-03-01-preview
- 2021-01-15
- 2020-09-01
- 2020-06-01-미리 보기
- 2020-04-01
- 2020-03-01
- 2019-12-12
- 2019-08-01
Bicep 리소스 정의
databaseAccounts/sqlDatabases/containers 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-04-15' = {
name: 'string'
location: 'string'
tags: {
tagName1: 'tagValue1'
tagName2: 'tagValue2'
}
parent: resourceSymbolicName
properties: {
options: {
autoscaleSettings: {
maxThroughput: int
}
throughput: int
}
resource: {
analyticalStorageTtl: int
clientEncryptionPolicy: {
includedPaths: [
{
clientEncryptionKeyId: 'string'
encryptionAlgorithm: 'string'
encryptionType: 'string'
path: 'string'
}
]
policyFormatVersion: int
}
conflictResolutionPolicy: {
conflictResolutionPath: 'string'
conflictResolutionProcedure: 'string'
mode: 'string'
}
defaultTtl: int
id: 'string'
indexingPolicy: {
automatic: bool
compositeIndexes: [
{
order: 'string'
path: 'string'
}
]
excludedPaths: [
{
path: 'string'
}
]
includedPaths: [
{
indexes: [
{
dataType: 'string'
kind: 'string'
precision: int
}
]
path: 'string'
}
]
indexingMode: 'string'
spatialIndexes: [
{
path: 'string'
types: [
'string'
]
}
]
}
partitionKey: {
kind: 'string'
paths: [
'string'
]
version: int
}
uniqueKeyPolicy: {
uniqueKeys: [
{
paths: [
'string'
]
}
]
}
}
}
}
속성 값
databaseAccounts/sqlDatabases/containers
Name | Description | 값 |
---|---|---|
name | 리소스 이름 Bicep에서 자식 리소스의 이름과 형식을 설정하는 방법을 참조하세요. |
string(필수) |
위치 | 리소스가 속한 리소스 그룹의 위치입니다. | string |
tags | 태그는 리소스를 설명하는 키-값 쌍의 목록입니다. 여러 리소스 그룹에서 이 리소스를 보고 그룹화할 때 이러한 태그를 사용할 수 있습니다. 리소스에 대해 최대 15개의 태그를 제공할 수 있습니다. 각 태그에는 128자 이하의 키와 256자 이하의 값이 포함되어야 합니다. 예를 들어 템플릿 형식의 기본 환경은 "defaultExperience": "Cassandra"로 설정됩니다. 현재 "defaultExperience" 값에는 "Table", "Graph", "DocumentDB" 및 "MongoDB"도 포함됩니다. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
부모(parent) | Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가하면 됩니다. 자세한 내용은 부모 리소스 외부의 자식 리소스를 참조하세요. |
형식의 리소스에 대한 기호 이름: sqlDatabases |
properties | Azure Cosmos DB 컨테이너를 만들고 업데이트하는 속성입니다. | SqlContainerCreateUpdatePropertiesOrSqlContainerGetP... (필수) |
SqlContainerCreateUpdatePropertiesOrSqlContainerGetP...
Name | Description | 값 |
---|---|---|
옵션 | 요청에 적용할 키-값 옵션 쌍입니다. 이는 요청과 함께 전송된 헤더에 해당합니다. | CreateUpdateOptionsOrSqlContainerGetPropertiesOption... |
resource | 컨테이너의 표준 JSON 형식 | SqlContainerResourceOrSqlContainerGetPropertiesResou... (필수) |
CreateUpdateOptionsOrSqlContainerGetPropertiesOption...
Name | Description | 값 |
---|---|---|
autoscaleSettings | 자동 크기 조정 설정을 지정합니다. | AutoscaleSettings |
throughput | 초당 요청 단위입니다. 예를 들어 "처리량": 10000입니다. | int |
AutoscaleSettings
Name | Description | 값 |
---|---|---|
maxThroughput | 최대 처리량을 나타내며 리소스를 확장할 수 있습니다. | int |
SqlContainerResourceOrSqlContainerGetPropertiesResou...
Name | Description | 값 |
---|---|---|
analyticalStorageTtl | 분석 TTL. | int |
clientEncryptionPolicy | 컨테이너에 대한 클라이언트 암호화 정책입니다. | ClientEncryptionPolicy |
conflictResolutionPolicy | 컨테이너에 대한 충돌 해결 정책입니다. | ConflictResolutionPolicy |
defaultTtl | 기본 사용 시간 | int |
id | Cosmos DB SQL 컨테이너의 이름 | string(필수) |
indexingPolicy | 인덱싱 정책의 구성입니다. 기본적으로 인덱싱은 컨테이너 내의 모든 문서 경로에 대해 자동으로 수행됩니다. | IndexingPolicy |
partitionKey | 데이터를 여러 파티션으로 분할하는 데 사용할 파티션 키 구성 | ContainerPartitionKey |
uniqueKeyPolicy | Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 지정하기 위한 고유 키 정책 구성입니다. | UniqueKeyPolicy |
ClientEncryptionPolicy
Name | Description | 값 |
---|---|---|
includedPaths | 경로별 설정과 함께 암호화가 필요한 항목의 경로입니다. | ClientEncryptionIncludedPath[](필수) |
policyFormatVersion | 클라이언트 암호화 정책 정의의 버전입니다. 지원되는 버전은 1과 2입니다. 버전 2는 ID 및 파티션 키 경로 암호화를 지원합니다. | int(필수) 제약 조건: 최소값 = 1 최대값 = 2 |
ClientEncryptionIncludedPath
Name | Description | 값 |
---|---|---|
clientEncryptionKeyId | 경로를 암호화하는 데 사용할 클라이언트 암호화 키의 식별자입니다. | string(필수) |
encryptionAlgorithm | 사용할 암호화 알고리즘입니다. 예 : AEAD_AES_256_CBC_HMAC_SHA256. | string(필수) |
encryptionType | 수행할 암호화 유형입니다. 예 : 결정적, 임의. | string(필수) |
path | 암호화해야 하는 경로입니다. | string(필수) |
ConflictResolutionPolicy
Name | Description | 값 |
---|---|---|
conflictResolutionPath | LastWriterWins 모드의 경우 충돌 해결 경로입니다. | 문자열 |
conflictResolutionProcedure | 사용자 지정 모드의 경우 충돌을 해결하는 절차입니다. | 문자열 |
mode | 충돌 해결 모드를 나타냅니다. | '사용자 지정' 'LastWriterWins' |
IndexingPolicy
Name | Description | 값 |
---|---|---|
automatic | 인덱싱 정책이 자동인지를 나타냅니다. | bool |
compositeIndexes | 복합 경로 목록 | CompositePath[] |
excludedPaths | 인덱싱에서 제외할 경로 목록 | ExcludedPath[] |
includedPaths | 인덱싱에 포함할 경로 목록 | IncludedPath[] |
indexingMode | 인덱싱 모드를 나타냅니다. | '일관성' 'lazy' 'none' |
spatialIndexes | 공간 세부 정보 목록 | SpatialSpec[] |
CompositePath
Name | Description | 값 |
---|---|---|
순서 | 복합 경로에 대한 정렬 순서입니다. | '오름차순' '내림차순' |
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
ExcludedPath
Name | Description | 값 |
---|---|---|
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
IncludedPath
Name | Description | 값 |
---|---|---|
인덱스 | 이 경로에 대한 인덱스 목록 | 인덱스[] |
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
인덱스
Name | Description | 값 |
---|---|---|
dataType | 인덱싱 동작이 적용되는 데이터 형식입니다. | 'LineString' 'MultiPolygon' 'Number' 'Point' '다각형' 'String' |
kind | 인덱스의 유형을 나타냅니다. | '해시' 'Range' '공간' |
정밀도 | 인덱스의 전체 자릿수입니다. -1은 최대 정밀도입니다. | int |
SpatialSpec
Name | Description | 값 |
---|---|---|
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
types | 경로의 공간 형식 목록 | 다음 중 어느 것을 포함하는 문자열 배열: 'LineString' 'MultiPolygon' 'Point' '다각형' |
ContainerPartitionKey
Name | Description | 값 |
---|---|---|
kind | 분할에 사용되는 알고리즘의 종류를 나타냅니다. MultiHash의 경우 컨테이너 만들기에 대해 여러 파티션 키(최대 3개)가 지원됩니다. | '해시' 'MultiHash' 'Range' |
경로 | 컨테이너 내에서 분할할 수 있는 데이터를 사용하는 경로 목록 | string[] |
버전 | 파티션 키 정의의 버전을 나타냅니다. | int 제약 조건: 최소값 = 1 최대값 = 2 |
UniqueKeyPolicy
Name | Description | 값 |
---|---|---|
uniqueKeys | Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 적용하는 의 고유 키 목록입니다. | UniqueKey[] |
UniqueKey
Name | Description | 값 |
---|---|---|
경로 | 경로 목록은 Azure Cosmos DB 서비스의 각 문서에 대해 고유해야 합니다. | string[] |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
템플릿 | Description |
---|---|
무료 계층 Azure Cosmos DB 계정 만들기 |
이 템플릿은 공유 처리량 및 컨테이너가 있는 데이터베이스를 사용하여 SQL API에 대한 무료 계층 Azure Cosmos DB 계정을 만듭니다. |
Core(SQL) API에 대한 Azure Cosmos DB 계정 만들기 |
이 템플릿은 다른 여러 옵션이 있는 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
분석 저장소가 있는 Azure Cosmos DB 계정 SQL API |
이 템플릿은 분석 저장소로 구성된 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
자동 크기 조정을 사용하여 Azure Cosmos DB 계정 SQL API 만들기 |
이 템플릿은 다른 여러 옵션을 사용하여 자동 크기 조정 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
Azure Cosmos DB Core(SQL) API 저장 프로시저 만들기 |
이 템플릿은 Core(SQL) API용 Azure Cosmos DB 계정과 저장 프로시저, 트리거 및 사용자 정의 함수가 있는 컨테이너를 만듭니다. |
Cosmos DB 연결을 사용하여 Azure Data Explorer DB 배포 |
Cosmos DB 연결을 사용하여 Azure Data Explorer DB를 배포합니다. |
ARM 템플릿 리소스 정의
databaseAccounts/sqlDatabases/containers 리소스 종류는 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령을 참조하세요.
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers",
"apiVersion": "2023-04-15",
"name": "string",
"location": "string",
"tags": {
"tagName1": "tagValue1",
"tagName2": "tagValue2"
},
"properties": {
"options": {
"autoscaleSettings": {
"maxThroughput": "int"
},
"throughput": "int"
},
"resource": {
"analyticalStorageTtl": "int",
"clientEncryptionPolicy": {
"includedPaths": [
{
"clientEncryptionKeyId": "string",
"encryptionAlgorithm": "string",
"encryptionType": "string",
"path": "string"
}
],
"policyFormatVersion": "int"
},
"conflictResolutionPolicy": {
"conflictResolutionPath": "string",
"conflictResolutionProcedure": "string",
"mode": "string"
},
"defaultTtl": "int",
"id": "string",
"indexingPolicy": {
"automatic": "bool",
"compositeIndexes": [
{
"order": "string",
"path": "string"
}
],
"excludedPaths": [
{
"path": "string"
}
],
"includedPaths": [
{
"indexes": [
{
"dataType": "string",
"kind": "string",
"precision": "int"
}
],
"path": "string"
}
],
"indexingMode": "string",
"spatialIndexes": [
{
"path": "string",
"types": [ "string" ]
}
]
},
"partitionKey": {
"kind": "string",
"paths": [ "string" ],
"version": "int"
},
"uniqueKeyPolicy": {
"uniqueKeys": [
{
"paths": [ "string" ]
}
]
}
}
}
}
속성 값
databaseAccounts/sqlDatabases/containers
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | 'Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers' |
apiVersion | 리소스 api 버전 | '2023-04-15' |
name | 리소스 이름 JSON ARM 템플릿에서 자식 리소스의 이름 및 형식을 설정하는 방법을 참조하세요. |
string(필수) |
위치 | 리소스가 속한 리소스 그룹의 위치입니다. | string |
tags | 태그는 리소스를 설명하는 키-값 쌍의 목록입니다. 여러 리소스 그룹에서 이 리소스를 보고 그룹화할 때 이러한 태그를 사용할 수 있습니다. 리소스에 대해 최대 15개의 태그를 제공할 수 있습니다. 각 태그에는 128자 이하의 키와 256자 이하의 값이 포함되어야 합니다. 예를 들어 템플릿 형식의 기본 환경은 "defaultExperience": "Cassandra"로 설정됩니다. 현재 "defaultExperience" 값에는 "Table", "Graph", "DocumentDB" 및 "MongoDB"도 포함됩니다. | 태그 이름 및 값의 사전입니다. 템플릿의 태그를 참조하세요. |
properties | Azure Cosmos DB 컨테이너를 만들고 업데이트하는 속성입니다. | SqlContainerCreateUpdatePropertiesOrSqlContainerGetP... (필수) |
SqlContainerCreateUpdatePropertiesOrSqlContainerGetP...
Name | Description | 값 |
---|---|---|
옵션 | 요청에 적용할 키-값 옵션 쌍입니다. 요청과 함께 전송된 헤더에 해당합니다. | CreateUpdateOptionsOrSqlContainerGetPropertiesOption... |
resource | 컨테이너의 표준 JSON 형식 | SqlContainerResourceOrSqlContainerGetPropertiesResou... (필수) |
CreateUpdateOptionsOrSqlContainerGetPropertiesOption...
Name | Description | 값 |
---|---|---|
autoscaleSettings | 자동 크기 조정 설정을 지정합니다. | AutoscaleSettings |
throughput | 초당 요청 단위입니다. 예를 들어 "처리량": 10000입니다. | int |
AutoscaleSettings
Name | Description | 값 |
---|---|---|
maxThroughput | 최대 처리량을 나타내며 리소스를 확장할 수 있습니다. | int |
SqlContainerResourceOrSqlContainerGetPropertiesResou...
Name | Description | 값 |
---|---|---|
analyticalStorageTtl | 분석 TTL. | int |
clientEncryptionPolicy | 컨테이너에 대한 클라이언트 암호화 정책입니다. | ClientEncryptionPolicy |
conflictResolutionPolicy | 컨테이너에 대한 충돌 해결 정책입니다. | ConflictResolutionPolicy |
defaultTtl | 기본 TL(Time to Live) | int |
id | Cosmos DB SQL 컨테이너의 이름 | string(필수) |
indexingPolicy | 인덱싱 정책의 구성입니다. 기본적으로 인덱싱은 컨테이너 내의 모든 문서 경로에 대해 자동으로 수행됩니다. | IndexingPolicy |
partitionKey | 데이터를 여러 파티션으로 분할하는 데 사용할 파티션 키 구성 | ContainerPartitionKey |
uniqueKeyPolicy | Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 지정하기 위한 고유 키 정책 구성입니다. | UniqueKeyPolicy |
ClientEncryptionPolicy
Name | Description | 값 |
---|---|---|
includedPaths | 경로별 설정과 함께 암호화가 필요한 항목의 경로입니다. | ClientEncryptionIncludedPath[] (필수) |
policyFormatVersion | 클라이언트 암호화 정책 정의의 버전입니다. 지원되는 버전은 1과 2입니다. 버전 2는 ID 및 파티션 키 경로 암호화를 지원합니다. | int(필수) 제약 조건: 최소값 = 1 최대값 = 2 |
ClientEncryptionIncludedPath
Name | Description | 값 |
---|---|---|
clientEncryptionKeyId | 경로를 암호화하는 데 사용할 클라이언트 암호화 키의 식별자입니다. | string(필수) |
encryptionAlgorithm | 사용할 암호화 알고리즘입니다. 예를 들어 - AEAD_AES_256_CBC_HMAC_SHA256. | string(필수) |
encryptionType | 수행할 암호화 유형입니다. 예를 들어 - 결정적, 임의. | string(필수) |
path | 암호화해야 하는 경로입니다. | string(필수) |
ConflictResolutionPolicy
Name | Description | 값 |
---|---|---|
conflictResolutionPath | LastWriterWins 모드의 경우 충돌 해결 경로입니다. | 문자열 |
conflictResolutionProcedure | 사용자 지정 모드의 경우 충돌을 해결하는 절차입니다. | 문자열 |
mode | 충돌 해결 모드를 나타냅니다. | 'Custom' 'LastWriterWins' |
IndexingPolicy
Name | Description | 값 |
---|---|---|
automatic | 인덱싱 정책이 자동인지를 나타냅니다. | bool |
compositeIndexes | 복합 경로 목록 목록 | CompositePath[] |
excludedPaths | 인덱싱에서 제외할 경로 목록 | ExcludedPath[] |
includedPaths | 인덱싱에 포함할 경로 목록 | IncludedPath[] |
indexingMode | 인덱싱 모드를 나타냅니다. | '일관성' 'lazy' 'none' |
spatialIndexes | 공간 세부 정보 목록 | SpatialSpec[] |
CompositePath
Name | Description | 값 |
---|---|---|
순서 | 복합 경로의 정렬 순서입니다. | '오름차순' '내림차순' |
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | 문자열 |
ExcludedPath
Name | Description | 값 |
---|---|---|
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
IncludedPath
Name | Description | 값 |
---|---|---|
인덱스 | 이 경로에 대한 인덱스 목록 | 인덱스[] |
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
인덱스
Name | Description | 값 |
---|---|---|
dataType | 인덱싱 동작이 적용되는 데이터 형식입니다. | 'LineString' 'MultiPolygon' 'Number' 'Point' '다각형' 'String' |
kind | 인덱스의 유형을 나타냅니다. | '해시' 'Range' 'Spatial' |
정밀도 | 인덱스의 전체 자릿수입니다. -1은 최대 정밀도입니다. | int |
SpatialSpec
Name | Description | 값 |
---|---|---|
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
types | 경로의 공간 형식 목록 | 다음 중 어느 것을 포함하는 문자열 배열: 'LineString' 'MultiPolygon' 'Point' '다각형' |
ContainerPartitionKey
Name | Description | 값 |
---|---|---|
kind | 분할에 사용되는 알고리즘의 종류를 나타냅니다. MultiHash의 경우 컨테이너 만들기에 대해 여러 파티션 키(최대 3개)가 지원됩니다. | '해시' 'MultiHash' 'Range' |
경로 | 컨테이너 내에서 분할할 수 있는 데이터를 사용하는 경로 목록 | string[] |
버전 | 파티션 키 정의의 버전을 나타냅니다. | int 제약 조건: 최소값 = 1 최대값 = 2 |
UniqueKeyPolicy
Name | Description | 값 |
---|---|---|
uniqueKeys | Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 적용하는 의 고유 키 목록입니다. | UniqueKey[] |
UniqueKey
Name | Description | 값 |
---|---|---|
경로 | 경로 목록은 Azure Cosmos DB 서비스의 각 문서에 대해 고유해야 합니다. | string[] |
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 종류를 배포합니다.
템플릿 | Description |
---|---|
무료 계층 Azure Cosmos DB 계정 만들기 |
이 템플릿은 공유 처리량 및 컨테이너가 있는 데이터베이스를 사용하여 SQL API에 대한 무료 계층 Azure Cosmos DB 계정을 만듭니다. |
Core(SQL) API에 대한 Azure Cosmos DB 계정 만들기 |
이 템플릿은 다른 여러 옵션이 있는 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
분석 저장소가 있는 Azure Cosmos DB 계정 SQL API |
이 템플릿은 분석 저장소로 구성된 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
자동 크기 조정을 사용하여 Azure Cosmos DB 계정 SQL API 만들기 |
이 템플릿은 다른 여러 옵션을 사용하여 자동 크기 조정 처리량이 있는 데이터베이스 및 컨테이너를 사용하여 Core(SQL) API에 대한 Azure Cosmos 계정을 만듭니다. |
Azure Cosmos DB Core(SQL) API 저장 프로시저 만들기 |
이 템플릿은 Core(SQL) API용 Azure Cosmos DB 계정과 저장 프로시저, 트리거 및 사용자 정의 함수가 있는 컨테이너를 만듭니다. |
Cosmos DB 연결을 사용하여 Azure Data Explorer DB 배포 |
Cosmos DB 연결을 사용하여 Azure Data Explorer DB를 배포합니다. |
Terraform(AzAPI 공급자) 리소스 정의
databaseAccounts/sqlDatabases/containers 리소스 종류는 다음을 대상으로 하는 작업과 함께 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그를 참조하세요.
리소스 형식
Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-04-15"
name = "string"
location = "string"
parent_id = "string"
tags = {
tagName1 = "tagValue1"
tagName2 = "tagValue2"
}
body = jsonencode({
properties = {
options = {
autoscaleSettings = {
maxThroughput = int
}
throughput = int
}
resource = {
analyticalStorageTtl = int
clientEncryptionPolicy = {
includedPaths = [
{
clientEncryptionKeyId = "string"
encryptionAlgorithm = "string"
encryptionType = "string"
path = "string"
}
]
policyFormatVersion = int
}
conflictResolutionPolicy = {
conflictResolutionPath = "string"
conflictResolutionProcedure = "string"
mode = "string"
}
defaultTtl = int
id = "string"
indexingPolicy = {
automatic = bool
compositeIndexes = [
{
order = "string"
path = "string"
}
]
excludedPaths = [
{
path = "string"
}
]
includedPaths = [
{
indexes = [
{
dataType = "string"
kind = "string"
precision = int
}
]
path = "string"
}
]
indexingMode = "string"
spatialIndexes = [
{
path = "string"
types = [
"string"
]
}
]
}
partitionKey = {
kind = "string"
paths = [
"string"
]
version = int
}
uniqueKeyPolicy = {
uniqueKeys = [
{
paths = [
"string"
]
}
]
}
}
}
})
}
속성 값
databaseAccounts/sqlDatabases/containers
Name | Description | 값 |
---|---|---|
형식 | 리소스 종류 | "Microsoft.DocumentDB/databaseAccounts/sqlDatabases/containers@2023-04-15" |
name | 리소스 이름 | string(필수) |
위치 | 리소스가 속한 리소스 그룹의 위치입니다. | string |
parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 형식의 리소스에 대한 ID: sqlDatabases |
tags | 태그는 리소스를 설명하는 키-값 쌍의 목록입니다. 여러 리소스 그룹에서 이 리소스를 보고 그룹화할 때 이러한 태그를 사용할 수 있습니다. 리소스에 대해 최대 15개의 태그를 제공할 수 있습니다. 각 태그에는 128자 이하의 키와 256자 이하의 값이 포함되어야 합니다. 예를 들어 템플릿 형식의 기본 환경은 "defaultExperience": "Cassandra"로 설정됩니다. 현재 "defaultExperience" 값에는 "Table", "Graph", "DocumentDB" 및 "MongoDB"도 포함됩니다. | 태그 이름 및 값의 사전입니다. |
properties | Azure Cosmos DB 컨테이너를 만들고 업데이트하는 속성입니다. | SqlContainerCreateUpdatePropertiesOrSqlContainerGetP... (필수) |
SqlContainerCreateUpdatePropertiesOrSqlContainerGetP...
Name | Description | 값 |
---|---|---|
옵션 | 요청에 적용할 키-값 옵션 쌍입니다. 요청과 함께 전송된 헤더에 해당합니다. | CreateUpdateOptionsOrSqlContainerGetPropertiesOption... |
resource | 컨테이너의 표준 JSON 형식 | SqlContainerResourceOrSqlContainerGetPropertiesResou... (필수) |
CreateUpdateOptionsOrSqlContainerGetPropertiesOption...
Name | Description | 값 |
---|---|---|
autoscaleSettings | 자동 크기 조정 설정을 지정합니다. | AutoscaleSettings |
throughput | 초당 요청 단위입니다. 예를 들어 "처리량": 10000입니다. | int |
AutoscaleSettings
Name | Description | 값 |
---|---|---|
maxThroughput | 최대 처리량을 나타내며 리소스를 확장할 수 있습니다. | int |
SqlContainerResourceOrSqlContainerGetPropertiesResou...
Name | Description | 값 |
---|---|---|
analyticalStorageTtl | 분석 TTL. | int |
clientEncryptionPolicy | 컨테이너에 대한 클라이언트 암호화 정책입니다. | ClientEncryptionPolicy |
conflictResolutionPolicy | 컨테이너에 대한 충돌 해결 정책입니다. | ConflictResolutionPolicy |
defaultTtl | 기본 TL(Time to Live) | int |
id | Cosmos DB SQL 컨테이너의 이름 | string(필수) |
indexingPolicy | 인덱싱 정책의 구성입니다. 기본적으로 인덱싱은 컨테이너 내의 모든 문서 경로에 대해 자동으로 수행됩니다. | IndexingPolicy |
partitionKey | 데이터를 여러 파티션으로 분할하는 데 사용할 파티션 키 구성 | ContainerPartitionKey |
uniqueKeyPolicy | Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 지정하기 위한 고유 키 정책 구성입니다. | UniqueKeyPolicy |
ClientEncryptionPolicy
Name | Description | 값 |
---|---|---|
includedPaths | 경로별 설정과 함께 암호화가 필요한 항목의 경로입니다. | ClientEncryptionIncludedPath[](필수) |
policyFormatVersion | 클라이언트 암호화 정책 정의의 버전입니다. 지원되는 버전은 1과 2입니다. 버전 2는 ID 및 파티션 키 경로 암호화를 지원합니다. | int(필수) 제약 조건: 최소값 = 1 최대값 = 2 |
ClientEncryptionIncludedPath
Name | Description | 값 |
---|---|---|
clientEncryptionKeyId | 경로를 암호화하는 데 사용할 클라이언트 암호화 키의 식별자입니다. | string(필수) |
encryptionAlgorithm | 사용할 암호화 알고리즘입니다. 예 : AEAD_AES_256_CBC_HMAC_SHA256. | string(필수) |
encryptionType | 수행할 암호화 유형입니다. 예 : 결정적, 임의. | string(필수) |
path | 암호화해야 하는 경로입니다. | string(필수) |
ConflictResolutionPolicy
Name | Description | 값 |
---|---|---|
conflictResolutionPath | LastWriterWins 모드의 경우 충돌 해결 경로입니다. | string |
conflictResolutionProcedure | 사용자 지정 모드의 경우 충돌을 해결하는 절차입니다. | string |
mode | 충돌 해결 모드를 나타냅니다. | "Custom" "LastWriterWins" |
IndexingPolicy
Name | Description | 값 |
---|---|---|
automatic | 인덱싱 정책이 자동인지를 나타냅니다. | bool |
compositeIndexes | 복합 경로 목록 | CompositePath[] |
excludedPaths | 인덱싱에서 제외할 경로 목록 | ExcludedPath[] |
includedPaths | 인덱싱에 포함할 경로 목록 | IncludedPath[] |
indexingMode | 인덱싱 모드를 나타냅니다. | "일관성" "게으른" "none" |
spatialIndexes | 공간 세부 정보 목록 | SpatialSpec[] |
CompositePath
Name | Description | 값 |
---|---|---|
순서 | 복합 경로에 대한 정렬 순서입니다. | "오름차순" "내림차순" |
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
ExcludedPath
Name | Description | 값 |
---|---|---|
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
IncludedPath
Name | Description | 값 |
---|---|---|
인덱스 | 이 경로에 대한 인덱스 목록 | 인덱스[] |
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
인덱스
Name | Description | 값 |
---|---|---|
dataType | 인덱싱 동작이 적용되는 데이터 형식입니다. | "LineString" "MultiPolygon" "Number" "Point" "다각형" "String" |
kind | 인덱스의 유형을 나타냅니다. | "해시" "Range" "공간" |
정밀도 | 인덱스의 전체 자릿수입니다. -1은 최대 정밀도입니다. | int |
SpatialSpec
Name | Description | 값 |
---|---|---|
path | 인덱싱 동작이 적용되는 경로입니다. 인덱스 경로는 일반적으로 루트로 시작하고 와일드카드(/path/*)로 끝납니다. | string |
types | 경로의 공간 형식 목록 | 다음 중 어느 것을 포함하는 문자열 배열: "LineString" "MultiPolygon" "Point" "다각형" |
ContainerPartitionKey
Name | Description | 값 |
---|---|---|
kind | 분할에 사용되는 알고리즘의 종류를 나타냅니다. MultiHash의 경우 컨테이너 만들기에 대해 여러 파티션 키(최대 3개)가 지원됩니다. | "해시" "MultiHash" "Range" |
경로 | 컨테이너 내에서 분할할 수 있는 데이터를 사용하는 경로 목록 | string[] |
버전 | 파티션 키 정의의 버전을 나타냅니다. | int 제약 조건: 최소값 = 1 최대값 = 2 |
UniqueKeyPolicy
Name | Description | 값 |
---|---|---|
uniqueKeys | Azure Cosmos DB 서비스의 컬렉션에 있는 문서에 고유성 제약 조건을 적용하는 의 고유 키 목록입니다. | UniqueKey[] |
UniqueKey
Name | Description | 값 |
---|---|---|
경로 | 경로 목록은 Azure Cosmos DB 서비스의 각 문서에 대해 고유해야 합니다. | string[] |