Microsoft.Sql 서버/데이터베이스 2022-05-01-preview
- 최신
- 2024-05-01-preview
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2019-06-01-preview
- 2017-10-01-preview
- 2017-03-01-preview
- 2014-04-01
Bicep 리소스 정의
서버/데이터베이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Sql/servers/databases 리소스를 만들려면 템플릿에 다음 Bicep을 추가합니다.
resource symbolicname 'Microsoft.Sql/servers/databases@2022-05-01-preview' = {
parent: resourceSymbolicName
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
autoPauseDelay: int
catalogCollation: 'string'
collation: 'string'
createMode: 'string'
elasticPoolId: 'string'
federatedClientId: 'string'
highAvailabilityReplicaCount: int
isLedgerOn: bool
licenseType: 'string'
longTermRetentionBackupResourceId: 'string'
maintenanceConfigurationId: 'string'
maxSizeBytes: int
minCapacity: int
preferredEnclaveType: 'string'
readScale: 'string'
recoverableDatabaseId: 'string'
recoveryServicesRecoveryPointId: 'string'
requestedBackupStorageRedundancy: 'string'
restorableDroppedDatabaseId: 'string'
restorePointInTime: 'string'
sampleName: 'string'
secondaryType: 'string'
sourceDatabaseDeletionDate: 'string'
sourceDatabaseId: 'string'
sourceResourceId: 'string'
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
속성 값
DatabaseIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | ID 형식 | 'None' 'UserAssigned' |
userAssignedIdentities | 사용할 사용자 할당 ID의 리소스 ID | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
이름 | 묘사 | 값 |
---|
DatabaseProperties
이름 | 묘사 | 값 |
---|---|---|
autoPauseDelay | 데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다. | int |
catalogCollation | 메타데이터 카탈로그의 데이터 정렬입니다. | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
조교 | 데이터베이스의 데이터 정렬입니다. | 문자열 |
createMode | 데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 데이터베이스 만들기. 복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다. 보조: 기존 데이터베이스의 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. 복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다. RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다. DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다. |
'Copy' '기본값' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' '복원' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' '보조' |
elasticPoolId | 이 데이터베이스를 포함하는 탄력적 풀의 리소스 식별자입니다. | 문자열 |
federatedClientId | 데이터베이스 CMK 시나리오당 교차 테넌트에 사용되는 클라이언트 ID | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
highAvailabilityReplicaCount | 고가용성을 제공하는 데 사용되는 데이터베이스와 연결된 보조 복제본의 수입니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. | int |
isLedgerOn | 이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다. | bool |
licenseType | 이 데이터베이스에 적용할 라이선스 유형입니다. 라이선스가 필요한 경우 LicenseIncluded , 라이선스가 있고 Azure 하이브리드 혜택을 받을 자격이 있는 경우 BasePrice . |
'BasePrice' 'LicenseIncluded' |
longTermRetentionBackupResourceId | 이 데이터베이스의 만들기 작업과 관련된 장기 보존 백업의 리소스 식별자입니다. | 문자열 |
maintenanceConfigurationId | 데이터베이스에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다. | 문자열 |
maxSizeBytes | 바이트로 표현된 데이터베이스의 최대 크기입니다. | int |
minCapacity | 데이터베이스가 항상 할당하는 최소 용량(일시 중지되지 않은 경우) | int |
preferredEnclaveType | 데이터베이스에 요청된 enclave 유형(예: 기본 또는 VBS enclave)입니다. | '기본값' 'VBS' |
readScale | 읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 연결 문자열에서 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본으로 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. | '사용 안 함' 'Enabled' |
recoverableDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다. | 문자열 |
recoveryServicesRecoveryPointId | 이 데이터베이스의 만들기 작업과 연결된 복구 지점의 리소스 식별자입니다. | 문자열 |
requestedBackupStorageRedundancy | 이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorableDroppedDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 복원 가능한 삭제된 데이터베이스의 리소스 식별자입니다. | 문자열 |
restorePointInTime | 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. | 문자열 |
sampleName | 이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다. | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
secondaryType | 보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo, Named 및 Standby입니다. | 'Geo' 'Named' '대기' |
sourceDatabaseDeletionDate | 데이터베이스가 삭제된 시간을 지정합니다. | 문자열 |
sourceDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다. | 문자열 |
sourceResourceId | 이 데이터베이스의 만들기 작업과 연결된 원본의 리소스 식별자입니다. 이 속성은 DataWarehouse 버전에 대해서만 지원되며 구독 간에 복원할 수 있습니다. sourceResourceId를 지정하면 sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId 및 sourceDatabaseDeletionDate를 지정하지 않아야 하며 CreateMode는 PointInTimeRestore, 복원 또는 복구여야 합니다. createMode가 PointInTimeRestore인 경우 sourceResourceId는 기존 데이터베이스 또는 기존 sql 풀의 리소스 ID여야 하며 restorePointInTime을 지정해야 합니다. createMode가 Restore인 경우 sourceResourceId는 복원 가능한 삭제된 데이터베이스 또는 복원 가능한 삭제된 sql 풀의 리소스 ID여야 합니다. createMode가 복구인 경우 sourceResourceId는 복구 가능한 데이터베이스 또는 복구 가능한 sql 풀의 리소스 ID여야 합니다. 원본 구독이 대상 구독과 다른 테넌트에 속하는 경우 "x-ms-authorization-auxiliary" 헤더에는 원본 테넌트에 대한 인증 토큰이 포함되어야 합니다. "x-ms-authorization-auxiliary" 헤더에 대한 자세한 내용은 /azure/azure-resource-manager/management/authenticate-multi-tenant를 참조하세요. |
문자열 |
zoneRedundant | 이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다. | bool |
DatabaseUserIdentity
이름 | 묘사 | 값 |
---|
Microsoft.Sql/servers/databases
이름 | 묘사 | 값 |
---|---|---|
신원 | 데이터베이스의 Azure Active Directory ID입니다. | DatabaseIdentity |
위치 | 리소스 위치입니다. | string(필수) |
이름 | 리소스 이름 | string(필수) |
부모 | Bicep에서 자식 리소스에 대한 부모 리소스를 지정할 수 있습니다. 자식 리소스가 부모 리소스 외부에서 선언된 경우에만 이 속성을 추가해야 합니다. 자세한 내용은 부모 리소스외부의 자식 리소스 |
형식 리소스의 기호 이름: 서버 |
속성 | 리소스 속성입니다. | DatabaseProperties |
sku | 데이터베이스 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br /> powershellGet-AzSqlServerServiceObjective -Location <위치> ```` |
Sku |
태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
Sku
이름 | 묘사 | 값 |
---|---|---|
용량 | 특정 SKU의 용량입니다. | int |
가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
이름 | SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. | string(필수) |
크기 | 특정 SKU의 크기 | 문자열 |
계층 | 특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. | 문자열 |
TrackedResourceTags
이름 | 묘사 | 값 |
---|
빠른 시작 샘플
다음 빠른 시작 샘플은 이 리소스 유형을 배포합니다.
Bicep 파일 | 묘사 |
---|---|
Log Analytics 기록된 감사로 Azure SQL Server |
이 템플릿을 사용하면 감사가 활성화된 Azure SQL 서버를 배포하여 Log Analytics(OMS 작업 영역)에 감사 로그를 쓸 수 있습니다. |
SQL Server 및 데이터베이스 만들기 | 이 템플릿을 사용하면 SQL Database 및 서버를 만들 수 있습니다. |
투명한 암호화 사용하여 전용 SQL 풀 |
투명한 데이터 암호화를 사용하여 SQL Server 및 전용 SQL 풀(이전의 SQL DW)을 만듭니다. |
Azure 아키텍처 스포츠 분석 배포 |
ADLS Gen 2를 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 연결된 서비스가 있는 Azure Data Factory 인스턴스(배포된 경우 Azure SQL Database) 및 Azure Databricks 인스턴스를 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF 인스턴스의 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault 인스턴스, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault가 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다. |
프라이빗 엔드포인트 예제 | 이 템플릿은 Azure SQL Server를 가리키는 프라이빗 엔드포인트를 만드는 방법을 보여줍니다. |
SQL Database 사용하여 웹앱 프로비전 | 이 템플릿은 웹앱, SQL Database, 자동 크기 조정 설정, 경고 규칙 및 App Insights를 프로비전합니다. 데이터베이스에 대한 웹앱에서 연결 문자열을 구성합니다. |
Azure SQL 사용하여 Linux의 Sonarqube Docker Web App |
이 템플릿은 공식 Sonarqube 이미지를 사용하고 Azure SQL Server에서 지원되는 Azure App Service 웹앱 Linux 컨테이너에 Sonarqube를 배포합니다. |
관리 ID, SQL Server 및 Α 사용하여 웹앱 |
앱 + 데이터 + 관리 ID + 모니터링을 위한 Azure 인프라를 배포하는 간단한 예제 |
ARM 템플릿 리소스 정의
서버/데이터베이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹 - 리소스 그룹 배포 명령 참조
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Sql/servers/databases 리소스를 만들려면 템플릿에 다음 JSON을 추가합니다.
{
"type": "Microsoft.Sql/servers/databases",
"apiVersion": "2022-05-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"autoPauseDelay": "int",
"catalogCollation": "string",
"collation": "string",
"createMode": "string",
"elasticPoolId": "string",
"federatedClientId": "string",
"highAvailabilityReplicaCount": "int",
"isLedgerOn": "bool",
"licenseType": "string",
"longTermRetentionBackupResourceId": "string",
"maintenanceConfigurationId": "string",
"maxSizeBytes": "int",
"minCapacity": "int",
"preferredEnclaveType": "string",
"readScale": "string",
"recoverableDatabaseId": "string",
"recoveryServicesRecoveryPointId": "string",
"requestedBackupStorageRedundancy": "string",
"restorableDroppedDatabaseId": "string",
"restorePointInTime": "string",
"sampleName": "string",
"secondaryType": "string",
"sourceDatabaseDeletionDate": "string",
"sourceDatabaseId": "string",
"sourceResourceId": "string",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
속성 값
DatabaseIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | ID 형식 | 'None' 'UserAssigned' |
userAssignedIdentities | 사용할 사용자 할당 ID의 리소스 ID | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
이름 | 묘사 | 값 |
---|
DatabaseProperties
이름 | 묘사 | 값 |
---|---|---|
autoPauseDelay | 데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다. | int |
catalogCollation | 메타데이터 카탈로그의 데이터 정렬입니다. | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
조교 | 데이터베이스의 데이터 정렬입니다. | 문자열 |
createMode | 데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 데이터베이스 만들기. 복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다. 보조: 기존 데이터베이스의 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. 복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다. RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다. DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다. |
'Copy' '기본값' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' '복원' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' '보조' |
elasticPoolId | 이 데이터베이스를 포함하는 탄력적 풀의 리소스 식별자입니다. | 문자열 |
federatedClientId | 데이터베이스 CMK 시나리오당 교차 테넌트에 사용되는 클라이언트 ID | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
highAvailabilityReplicaCount | 고가용성을 제공하는 데 사용되는 데이터베이스와 연결된 보조 복제본의 수입니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. | int |
isLedgerOn | 이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다. | bool |
licenseType | 이 데이터베이스에 적용할 라이선스 유형입니다. 라이선스가 필요한 경우 LicenseIncluded , 라이선스가 있고 Azure 하이브리드 혜택을 받을 자격이 있는 경우 BasePrice . |
'BasePrice' 'LicenseIncluded' |
longTermRetentionBackupResourceId | 이 데이터베이스의 만들기 작업과 관련된 장기 보존 백업의 리소스 식별자입니다. | 문자열 |
maintenanceConfigurationId | 데이터베이스에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다. | 문자열 |
maxSizeBytes | 바이트로 표현된 데이터베이스의 최대 크기입니다. | int |
minCapacity | 데이터베이스가 항상 할당하는 최소 용량(일시 중지되지 않은 경우) | int |
preferredEnclaveType | 데이터베이스에 요청된 enclave 유형(예: 기본 또는 VBS enclave)입니다. | '기본값' 'VBS' |
readScale | 읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 연결 문자열에서 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본으로 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. | '사용 안 함' 'Enabled' |
recoverableDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다. | 문자열 |
recoveryServicesRecoveryPointId | 이 데이터베이스의 만들기 작업과 연결된 복구 지점의 리소스 식별자입니다. | 문자열 |
requestedBackupStorageRedundancy | 이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorableDroppedDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 복원 가능한 삭제된 데이터베이스의 리소스 식별자입니다. | 문자열 |
restorePointInTime | 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. | 문자열 |
sampleName | 이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다. | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
secondaryType | 보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo, Named 및 Standby입니다. | 'Geo' 'Named' '대기' |
sourceDatabaseDeletionDate | 데이터베이스가 삭제된 시간을 지정합니다. | 문자열 |
sourceDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다. | 문자열 |
sourceResourceId | 이 데이터베이스의 만들기 작업과 연결된 원본의 리소스 식별자입니다. 이 속성은 DataWarehouse 버전에 대해서만 지원되며 구독 간에 복원할 수 있습니다. sourceResourceId를 지정하면 sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId 및 sourceDatabaseDeletionDate를 지정하지 않아야 하며 CreateMode는 PointInTimeRestore, 복원 또는 복구여야 합니다. createMode가 PointInTimeRestore인 경우 sourceResourceId는 기존 데이터베이스 또는 기존 sql 풀의 리소스 ID여야 하며 restorePointInTime을 지정해야 합니다. createMode가 Restore인 경우 sourceResourceId는 복원 가능한 삭제된 데이터베이스 또는 복원 가능한 삭제된 sql 풀의 리소스 ID여야 합니다. createMode가 복구인 경우 sourceResourceId는 복구 가능한 데이터베이스 또는 복구 가능한 sql 풀의 리소스 ID여야 합니다. 원본 구독이 대상 구독과 다른 테넌트에 속하는 경우 "x-ms-authorization-auxiliary" 헤더에는 원본 테넌트에 대한 인증 토큰이 포함되어야 합니다. "x-ms-authorization-auxiliary" 헤더에 대한 자세한 내용은 /azure/azure-resource-manager/management/authenticate-multi-tenant를 참조하세요. |
문자열 |
zoneRedundant | 이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다. | bool |
DatabaseUserIdentity
이름 | 묘사 | 값 |
---|
Microsoft.Sql/servers/databases
이름 | 묘사 | 값 |
---|---|---|
apiVersion | api 버전 | '2022-05-01-preview' |
신원 | 데이터베이스의 Azure Active Directory ID입니다. | DatabaseIdentity |
위치 | 리소스 위치입니다. | string(필수) |
이름 | 리소스 이름 | string(필수) |
속성 | 리소스 속성입니다. | DatabaseProperties |
sku | 데이터베이스 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br /> powershellGet-AzSqlServerServiceObjective -Location <위치> ```` |
Sku |
태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. 템플릿 |
형 | 리소스 종류 | 'Microsoft.Sql/servers/databases' |
Sku
이름 | 묘사 | 값 |
---|---|---|
용량 | 특정 SKU의 용량입니다. | int |
가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
이름 | SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. | string(필수) |
크기 | 특정 SKU의 크기 | 문자열 |
계층 | 특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. | 문자열 |
TrackedResourceTags
이름 | 묘사 | 값 |
---|
빠른 시작 템플릿
다음 빠른 시작 템플릿은 이 리소스 유형을 배포합니다.
템플렛 | 묘사 |
---|---|
Log Analytics 기록된 감사로 Azure SQL Server Azure |
이 템플릿을 사용하면 감사가 활성화된 Azure SQL 서버를 배포하여 Log Analytics(OMS 작업 영역)에 감사 로그를 쓸 수 있습니다. |
SQL Server 및 데이터베이스 만들기 Azure 배포 |
이 템플릿을 사용하면 SQL Database 및 서버를 만들 수 있습니다. |
투명한 암호화 사용하여 전용 SQL 풀 Azure |
투명한 데이터 암호화를 사용하여 SQL Server 및 전용 SQL 풀(이전의 SQL DW)을 만듭니다. |
새 SQL 탄력적 풀 배포 Azure 배포 |
이 템플릿을 사용하면 새 연결된 SQL Server 및 새 SQL Database를 사용하여 새 SQL 탄력적 풀을 배포하여 할당할 수 있습니다. |
Azure 아키텍처 스포츠 분석 배포 Azure |
ADLS Gen 2를 사용하도록 설정된 Azure Storage 계정, 스토리지 계정에 연결된 서비스가 있는 Azure Data Factory 인스턴스(배포된 경우 Azure SQL Database) 및 Azure Databricks 인스턴스를 만듭니다. 템플릿을 배포하는 사용자의 AAD ID와 ADF 인스턴스의 관리 ID에는 스토리지 계정에 대한 Storage Blob 데이터 기여자 역할이 부여됩니다. Azure Key Vault 인스턴스, Azure SQL Database 및 Azure Event Hub(스트리밍 사용 사례용)를 배포하는 옵션도 있습니다. Azure Key Vault가 배포되면 템플릿을 배포하는 사용자의 데이터 팩터리 관리 ID 및 AAD ID에 Key Vault 비밀 사용자 역할이 부여됩니다. |
VNET 사용자 지정 Ambari + Hive Metastore DB를 사용하여 HDInsight Azure |
이 템플릿을 사용하면 사용자 지정 Ambari DB 및 Hive Metastore 역할을 하는 새 SQL DB를 사용하여 기존 가상 네트워크에 HDInsight 클러스터를 만들 수 있습니다. 기존 SQL Sever, 스토리지 계정 및 VNET이 있어야 합니다. |
프라이빗 엔드포인트 예제 Azure 배포 |
이 템플릿은 Azure SQL Server를 가리키는 프라이빗 엔드포인트를 만드는 방법을 보여줍니다. |
SQL Database 사용하여 웹앱 프로비전 Azure 배포 |
이 템플릿은 웹앱, SQL Database, 자동 크기 조정 설정, 경고 규칙 및 App Insights를 프로비전합니다. 데이터베이스에 대한 웹앱에서 연결 문자열을 구성합니다. |
고가용성 사용하여 원격 데스크톱 서비스 Azure |
이 ARM 템플릿 샘플 코드는 고가용성이 있는 원격 데스크톱 서비스 2019 세션 컬렉션 랩을 배포합니다. 목표는 Windows Server 2019를 사용하여 원격 데스크톱 서비스에 대해 완전 중복되고 고가용성 솔루션을 배포하는 것입니다. |
Azure SQL 사용하여 Linux의 Sonarqube Docker Web App Azure |
이 템플릿은 공식 Sonarqube 이미지를 사용하고 Azure SQL Server에서 지원되는 Azure App Service 웹앱 Linux 컨테이너에 Sonarqube를 배포합니다. |
관리 ID, SQL Server 및 Α 사용하여 웹앱 Azure |
앱 + 데이터 + 관리 ID + 모니터링을 위한 Azure 인프라를 배포하는 간단한 예제 |
Azure SQL 프라이빗 엔드포인트 사용하는 WebApp Azure |
이 템플릿은 Azure SQL Server를 가리키는 프라이빗 엔드포인트를 사용하는 웹앱을 만드는 방법을 보여 줍니다. |
Terraform(AzAPI 공급자) 리소스 정의
서버/데이터베이스 리소스 종류는 다음을 대상으로 하는 작업으로 배포할 수 있습니다.
- 리소스 그룹
각 API 버전에서 변경된 속성 목록은 변경 로그참조하세요.
리소스 형식
Microsoft.Sql/servers/databases 리소스를 만들려면 템플릿에 다음 Terraform을 추가합니다.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/servers/databases@2022-05-01-preview"
name = "string"
identity = {
type = "string"
userAssignedIdentities = {
{customized property} = {
}
}
}
location = "string"
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
tags = {
{customized property} = "string"
}
body = jsonencode({
properties = {
autoPauseDelay = int
catalogCollation = "string"
collation = "string"
createMode = "string"
elasticPoolId = "string"
federatedClientId = "string"
highAvailabilityReplicaCount = int
isLedgerOn = bool
licenseType = "string"
longTermRetentionBackupResourceId = "string"
maintenanceConfigurationId = "string"
maxSizeBytes = int
minCapacity = int
preferredEnclaveType = "string"
readScale = "string"
recoverableDatabaseId = "string"
recoveryServicesRecoveryPointId = "string"
requestedBackupStorageRedundancy = "string"
restorableDroppedDatabaseId = "string"
restorePointInTime = "string"
sampleName = "string"
secondaryType = "string"
sourceDatabaseDeletionDate = "string"
sourceDatabaseId = "string"
sourceResourceId = "string"
zoneRedundant = bool
}
})
}
속성 값
DatabaseIdentity
이름 | 묘사 | 값 |
---|---|---|
형 | ID 형식 | 'None' 'UserAssigned' |
userAssignedIdentities | 사용할 사용자 할당 ID의 리소스 ID | DatabaseIdentityUserAssignedIdentities |
DatabaseIdentityUserAssignedIdentities
이름 | 묘사 | 값 |
---|
DatabaseProperties
이름 | 묘사 | 값 |
---|---|---|
autoPauseDelay | 데이터베이스가 자동으로 일시 중지된 시간(분)입니다. -1 값은 자동 일시 중지를 사용하지 않도록 설정됨을 의미합니다. | int |
catalogCollation | 메타데이터 카탈로그의 데이터 정렬입니다. | 'DATABASE_DEFAULT' 'SQL_Latin1_General_CP1_CI_AS' |
조교 | 데이터베이스의 데이터 정렬입니다. | 문자열 |
createMode | 데이터베이스 만들기 모드를 지정합니다. 기본값: 일반 데이터베이스 만들기. 복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다. 보조: 기존 데이터베이스의 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다. PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다. 복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다. 복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다. RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다. DataWarehouse 버전에서는 Copy, Secondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다. |
'Copy' '기본값' 'OnlineSecondary' 'PointInTimeRestore' 'Recovery' '복원' 'RestoreExternalBackup' 'RestoreExternalBackupSecondary' 'RestoreLongTermRetentionBackup' '보조' |
elasticPoolId | 이 데이터베이스를 포함하는 탄력적 풀의 리소스 식별자입니다. | 문자열 |
federatedClientId | 데이터베이스 CMK 시나리오당 교차 테넌트에 사용되는 클라이언트 ID | 문자열 제약 조건: 최소 길이 = 36 최대 길이 = 36 패턴 = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
highAvailabilityReplicaCount | 고가용성을 제공하는 데 사용되는 데이터베이스와 연결된 보조 복제본의 수입니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. | int |
isLedgerOn | 이 데이터베이스가 원장 데이터베이스인지 여부는 데이터베이스의 모든 테이블이 원장 테이블임을 의미합니다. 참고: 데이터베이스를 만든 후에는 이 속성의 값을 변경할 수 없습니다. | bool |
licenseType | 이 데이터베이스에 적용할 라이선스 유형입니다. 라이선스가 필요한 경우 LicenseIncluded , 라이선스가 있고 Azure 하이브리드 혜택을 받을 자격이 있는 경우 BasePrice . |
'BasePrice' 'LicenseIncluded' |
longTermRetentionBackupResourceId | 이 데이터베이스의 만들기 작업과 관련된 장기 보존 백업의 리소스 식별자입니다. | 문자열 |
maintenanceConfigurationId | 데이터베이스에 할당된 유지 관리 구성 ID입니다. 이 구성은 유지 관리 업데이트가 발생하는 기간을 정의합니다. | 문자열 |
maxSizeBytes | 바이트로 표현된 데이터베이스의 최대 크기입니다. | int |
minCapacity | 데이터베이스가 항상 할당하는 최소 용량(일시 중지되지 않은 경우) | int |
preferredEnclaveType | 데이터베이스에 요청된 enclave 유형(예: 기본 또는 VBS enclave)입니다. | '기본값' 'VBS' |
readScale | 읽기 전용 라우팅의 상태입니다. 사용하도록 설정된 경우 애플리케이션 의도가 연결 문자열에서 읽기 전용으로 설정된 연결은 동일한 지역의 읽기 전용 보조 복제본으로 라우팅될 수 있습니다. 탄력적 풀 내의 하이퍼스케일 데이터베이스에는 적용되지 않습니다. | '사용 안 함' 'Enabled' |
recoverableDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 복구 가능한 데이터베이스의 리소스 식별자입니다. | 문자열 |
recoveryServicesRecoveryPointId | 이 데이터베이스의 만들기 작업과 연결된 복구 지점의 리소스 식별자입니다. | 문자열 |
requestedBackupStorageRedundancy | 이 데이터베이스에 대한 백업을 저장하는 데 사용할 스토리지 계정 유형입니다. | 'Geo' 'GeoZone' 'Local' 'Zone' |
restorableDroppedDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 복원 가능한 삭제된 데이터베이스의 리소스 식별자입니다. | 문자열 |
restorePointInTime | 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. | 문자열 |
sampleName | 이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름입니다. | 'AdventureWorksLT' 'WideWorldImportersFull' 'WideWorldImportersStd' |
secondaryType | 보조 데이터베이스인 경우 데이터베이스의 보조 형식입니다. 유효한 값은 Geo, Named 및 Standby입니다. | 'Geo' 'Named' '대기' |
sourceDatabaseDeletionDate | 데이터베이스가 삭제된 시간을 지정합니다. | 문자열 |
sourceDatabaseId | 이 데이터베이스의 만들기 작업과 연결된 원본 데이터베이스의 리소스 식별자입니다. | 문자열 |
sourceResourceId | 이 데이터베이스의 만들기 작업과 연결된 원본의 리소스 식별자입니다. 이 속성은 DataWarehouse 버전에 대해서만 지원되며 구독 간에 복원할 수 있습니다. sourceResourceId를 지정하면 sourceDatabaseId, recoverableDatabaseId, restoreableDroppedDatabaseId 및 sourceDatabaseDeletionDate를 지정하지 않아야 하며 CreateMode는 PointInTimeRestore, 복원 또는 복구여야 합니다. createMode가 PointInTimeRestore인 경우 sourceResourceId는 기존 데이터베이스 또는 기존 sql 풀의 리소스 ID여야 하며 restorePointInTime을 지정해야 합니다. createMode가 Restore인 경우 sourceResourceId는 복원 가능한 삭제된 데이터베이스 또는 복원 가능한 삭제된 sql 풀의 리소스 ID여야 합니다. createMode가 복구인 경우 sourceResourceId는 복구 가능한 데이터베이스 또는 복구 가능한 sql 풀의 리소스 ID여야 합니다. 원본 구독이 대상 구독과 다른 테넌트에 속하는 경우 "x-ms-authorization-auxiliary" 헤더에는 원본 테넌트에 대한 인증 토큰이 포함되어야 합니다. "x-ms-authorization-auxiliary" 헤더에 대한 자세한 내용은 /azure/azure-resource-manager/management/authenticate-multi-tenant를 참조하세요. |
문자열 |
zoneRedundant | 이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다. | bool |
DatabaseUserIdentity
이름 | 묘사 | 값 |
---|
Microsoft.Sql/servers/databases
이름 | 묘사 | 값 |
---|---|---|
신원 | 데이터베이스의 Azure Active Directory ID입니다. | DatabaseIdentity |
위치 | 리소스 위치입니다. | string(필수) |
이름 | 리소스 이름 | string(필수) |
parent_id | 이 리소스의 부모인 리소스의 ID입니다. | 유형의 리소스에 대한 ID: 서버 |
속성 | 리소스 속성입니다. | DatabaseProperties |
sku | 데이터베이스 SKU입니다. SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.azurecli<br />az sql db list-editions -l <location> -o table<br />````<br /><br /> powershellGet-AzSqlServerServiceObjective -Location <위치> ```` |
Sku |
태그 | 리소스 태그 | 태그 이름 및 값의 사전입니다. |
형 | 리소스 종류 | "Microsoft.Sql/servers/databases@2022-05-01-preview" |
Sku
이름 | 묘사 | 값 |
---|---|---|
용량 | 특정 SKU의 용량입니다. | int |
가족 | 서비스에 여러 세대의 하드웨어가 있는 경우 동일한 SKU에 대해 여기에서 캡처할 수 있습니다. | 문자열 |
이름 | SKU의 이름(일반적으로 문자 + 숫자 코드(예: P3)입니다. | string(필수) |
크기 | 특정 SKU의 크기 | 문자열 |
계층 | 특정 SKU의 계층 또는 버전(예: Basic, Premium)입니다. | 문자열 |
TrackedResourceTags
이름 | 묘사 | 값 |
---|