Databases - Update

서비스:
SQL Database
API 버전:
2014-04-01

기존 데이터베이스를 업데이트합니다.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}?api-version=2014-04-01

URI 매개 변수

Name In(다음 안에) 필수 형식 Description
databaseName
 path True

string

업데이트할 데이터베이스의 이름입니다.
resourceGroupName
 path True

string

리소스를 포함하는 리소스 그룹의 이름입니다. Azure Resource Manager API 또는 포털에서 이 값을 가져올 수 있습니다.
serverName
 path True

string

서버의 이름입니다.
subscriptionId
 path True

string

Azure 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

요청에 사용할 API 버전입니다.

요청 본문

Name 형식 Description
parameters

DatabaseUpdate

데이터베이스를 업데이트하는 데 필요한 매개 변수입니다.

응답

Name 형식 Description
200 OK

Database

그래
202 Accepted

수락됨

예제

Update a database max
Update a database min

Update a database max

샘플 요청

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb?api-version=2014-04-01

{
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "createMode": "Default",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "containmentState": 2,
    "readScale": "Disabled"
  }
}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "location": "Japan East",
  "kind": "v12.0,user",
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-02-24T22:39:46.547Z",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "sampleName": null,
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "elasticPoolName": null,
    "containmentState": 2,
    "readScale": "Disabled",
    "failoverGroupId": null
  }
}
상태 코드:
202

Update a database min

샘플 요청

PATCH https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb?api-version=2014-04-01

{}

샘플 응답

상태 코드:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/sqlcrudtest-4799/providers/Microsoft.Sql/servers/sqlcrudtest-5961/databases/testdb",
  "name": "testdb",
  "type": "Microsoft.Sql/servers/databases",
  "location": "Japan East",
  "kind": "v12.0,user",
  "properties": {
    "edition": "Standard",
    "status": "Online",
    "serviceLevelObjective": "S0",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "creationDate": "2017-02-24T22:39:46.547Z",
    "maxSizeBytes": "268435456000",
    "currentServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveId": "f1173c43-91bd-4aaa-973c-54e79e15235b",
    "requestedServiceObjectiveName": "S0",
    "sampleName": null,
    "defaultSecondaryLocation": "Japan West",
    "earliestRestoreDate": "2017-02-10T01:52:52.923Z",
    "elasticPoolName": null,
    "containmentState": 2,
    "readScale": "Disabled",
    "failoverGroupId": null
  }
}
상태 코드:
202

정의

Name Description
CreateMode

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

OnlineSecondary/NonReadableSecondary: 기존 데이터베이스의 (읽기 가능하거나 읽을 수 없는) 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, NonReadableSecondary, OnlineSecondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
Database

데이터베이스를 나타냅니다.
DatabaseEdition

데이터베이스의 버전입니다. DatabaseEditions 열거형에는 유효한 모든 버전이 포함됩니다. createMode가 NonReadableSecondary 또는 OnlineSecondary이면 이 값은 무시됩니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
DatabaseUpdate

데이터베이스를 업데이트하는 데 필요한 매개 변수입니다.
OperationImpact

권장 인덱스 작업을 수행할 때의 예상 영향입니다.
ReadScale

조건부. 데이터베이스가 지역 보조 데이터베이스인 경우 readScale은 읽기 전용 연결이 이 데이터베이스에 허용되는지 여부를 나타냅니다. DataWarehouse 버전에서는 지원되지 않습니다.
RecommendedIndex

이 데이터베이스에 권장되는 인덱스입니다.
RecommendedIndexAction

제안된 인덱스 작업입니다. 누락된 인덱스를 만들거나, 사용되지 않는 인덱스를 삭제하거나, 기존 인덱스를 다시 작성하여 성능을 향상시킬 수 있습니다.
RecommendedIndexState

현재 권장 사항 상태입니다.
RecommendedIndexType

인덱스 유형(CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름을 나타냅니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다. DataWarehouse 버전에서는 지원되지 않습니다.
ServiceObjectiveName

데이터베이스의 구성된 서비스 수준 목표의 이름입니다. 데이터베이스에 적용되는 프로세스의 서비스 수준 목표입니다. 성공적으로 업데이트되면 serviceLevelObjective 속성 값과 일치합니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
ServiceTierAdvisor

이 데이터베이스의 서비스 계층 관리자 목록입니다. 확장된 속성
SloUsageMetric

서비스 계층 관리자에 대한 serviceLevelObjectiveUsageMetrics를 가져오거나 설정합니다.
TransparentDataEncryption

이 데이터베이스에 대한 투명한 데이터 암호화 정보입니다.
TransparentDataEncryptionStatus

데이터베이스 투명한 데이터 암호화의 상태입니다.

CreateMode

열거형

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

OnlineSecondary/NonReadableSecondary: 기존 데이터베이스의 (읽기 가능하거나 읽을 수 없는) 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, NonReadableSecondary, OnlineSecondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.

값 Description
Copy
Default
NonReadableSecondary
OnlineSecondary
PointInTimeRestore
Recovery
Restore
RestoreLongTermRetentionBackup

Database

Object

데이터베이스를 나타냅니다.

Name 형식 Description
id

string

리소스 ID입니다.
kind

string

데이터베이스 종류입니다. Azure Portal 환경에 사용되는 메타데이터입니다.
location

string

리소스 위치입니다.
name

string

리소스 이름입니다.
properties.collation

string

데이터베이스의 데이터 정렬입니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다.
properties.containmentState

integer (int64)

데이터베이스의 포함 상태입니다.
properties.createMode

CreateMode

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

OnlineSecondary/NonReadableSecondary: 기존 데이터베이스의 (읽기 가능하거나 읽을 수 없는) 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, NonReadableSecondary, OnlineSecondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
properties.creationDate

string (date-time)

데이터베이스의 생성 날짜(ISO8601 형식)입니다.
properties.currentServiceObjectiveId

string (uuid)

데이터베이스의 현재 서비스 수준 목표 ID입니다. 현재 활성 상태인 서비스 수준 목표의 ID입니다.
properties.databaseId

string (uuid)

데이터베이스의 ID입니다.
properties.defaultSecondaryLocation

string

이 데이터베이스의 기본 보조 지역입니다.
properties.earliestRestoreDate

string (date-time)

이 데이터베이스에 복원을 사용할 수 있는 가장 빠른 시작 날짜 및 시간(ISO8601 형식)을 기록합니다.
properties.edition

DatabaseEdition

데이터베이스의 버전입니다. DatabaseEditions 열거형에는 유효한 모든 버전이 포함됩니다. createMode가 NonReadableSecondary 또는 OnlineSecondary이면 이 값은 무시됩니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.elasticPoolName

string

데이터베이스가 있는 탄력적 풀의 이름입니다. elasticPoolName과 requestedServiceObjectiveName이 모두 업데이트된 경우 requestedServiceObjectiveName의 값은 무시됩니다. DataWarehouse 버전에서는 지원되지 않습니다.
properties.failoverGroupId

string

이 데이터베이스를 포함하는 장애 조치(failover) 그룹의 리소스 식별자입니다.
properties.maxSizeBytes

string

바이트로 표현된 데이터베이스의 최대 크기입니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다. 가능한 값을 보려면 operationId: "Capabilities_ListByLocation"에서 참조하는 기능 API(/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities)를 쿼리합니다.
properties.readScale

ReadScale

조건부. 데이터베이스가 지역 보조 데이터베이스인 경우 readScale은 읽기 전용 연결이 이 데이터베이스에 허용되는지 여부를 나타냅니다. DataWarehouse 버전에서는 지원되지 않습니다.
properties.recommendedIndex

RecommendedIndex[]

이 데이터베이스에 권장되는 인덱스입니다.
properties.recoveryServicesRecoveryPointResourceId

string

조건부. createMode가 RestoreLongTermRetentionBackup인 경우 이 값이 필요합니다. 복원할 복구 지점의 리소스 ID를 지정합니다.
properties.requestedServiceObjectiveId

string (uuid)

데이터베이스의 구성된 서비스 수준 목표 ID입니다. 데이터베이스에 적용되는 프로세스의 서비스 수준 목표입니다. 성공적으로 업데이트되면 currentServiceObjectiveId 속성의 값과 일치합니다. requestedServiceObjectiveId와 requestedServiceObjectiveName이 모두 업데이트되면 requestedServiceObjectiveId 값이 requestedServiceObjectiveName 값을 재정의합니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 서비스 목표 ID를 확인하려면 Capabilities_ListByLocation REST API를 사용합니다.
properties.requestedServiceObjectiveName

ServiceObjectiveName

데이터베이스의 구성된 서비스 수준 목표의 이름입니다. 데이터베이스에 적용되는 프로세스의 서비스 수준 목표입니다. 성공적으로 업데이트되면 serviceLevelObjective 속성 값과 일치합니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.restorePointInTime

string (date-time)

조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. createMode가 Restore인 경우 이 값은 선택 사항입니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. 원본 데이터베이스의 earliestRestoreDate 값보다 크거나 같아야 합니다.
properties.sampleName

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름을 나타냅니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다. DataWarehouse 버전에서는 지원되지 않습니다.
properties.serviceLevelObjective

ServiceObjectiveName

데이터베이스의 현재 서비스 수준 목표입니다.
properties.serviceTierAdvisors

ServiceTierAdvisor[]

이 데이터베이스의 서비스 계층 관리자 목록입니다. 확장된 속성
properties.sourceDatabaseDeletionDate

string (date-time)

조건부. createMode가 Restore이고 sourceDatabaseId가 존재할 때 삭제된 데이터베이스의 원래 리소스 ID인 경우(현재 복원 가능한 삭제된 데이터베이스 ID와는 달리) 이 값이 필요합니다. 데이터베이스가 삭제된 시간을 지정합니다.
properties.sourceDatabaseId

string

조건부. createMode가 Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery 또는 Restore인 경우 이 값이 필요합니다. 원본 데이터베이스의 리소스 ID를 지정합니다. createMode가 NonReadableSecondary 또는 OnlineSecondary인 경우 원본 데이터베이스의 이름은 생성되는 새 데이터베이스와 동일해야 합니다.
properties.status

string

데이터베이스의 상태입니다.
properties.transparentDataEncryption

TransparentDataEncryption[]

이 데이터베이스에 대한 투명한 데이터 암호화 정보입니다.
properties.zoneRedundant

boolean

이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다.
tags

object

리소스 태그.
type

string

리소스 종류입니다.

DatabaseEdition

열거형

데이터베이스의 버전입니다. DatabaseEditions 열거형에는 유효한 모든 버전이 포함됩니다. createMode가 NonReadableSecondary 또는 OnlineSecondary이면 이 값은 무시됩니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
값 Description
Web
Business
Basic
Standard
Premium
PremiumRS
Free
Stretch
DataWarehouse
System
System2
GeneralPurpose
BusinessCritical
Hyperscale

DatabaseUpdate

Object

데이터베이스를 업데이트하는 데 필요한 매개 변수입니다.

Name 형식 Description
id

string

리소스 ID입니다.
name

string

리소스 이름입니다.
properties.collation

string

데이터베이스의 데이터 정렬입니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다.
properties.containmentState

integer (int64)

데이터베이스의 포함 상태입니다.
properties.createMode

CreateMode

데이터베이스 만들기 모드를 지정합니다.

기본값: 일반 데이터베이스 만들기.

복사: 기존 데이터베이스의 복사본으로 데이터베이스를 만듭니다. sourceDatabaseId는 원본 데이터베이스의 리소스 ID로 지정해야 합니다.

OnlineSecondary/NonReadableSecondary: 기존 데이터베이스의 (읽기 가능하거나 읽을 수 없는) 보조 복제본으로 데이터베이스를 만듭니다. sourceDatabaseId는 기존 주 데이터베이스의 리소스 ID로 지정해야 합니다.

PointInTimeRestore: 기존 데이터베이스의 특정 시점 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 기존 데이터베이스의 리소스 ID로 지정해야 하며 restorePointInTime을 지정해야 합니다.

복구: 지역에서 복제된 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId는 복원할 복구 가능한 데이터베이스 리소스 ID로 지정해야 합니다.

복원: 삭제된 데이터베이스의 백업을 복원하여 데이터베이스를 만듭니다. sourceDatabaseId를 지정해야 합니다. sourceDatabaseId가 데이터베이스의 원래 리소스 ID인 경우 sourceDatabaseDeletionDate를 지정해야 합니다. 그렇지 않으면 sourceDatabaseId는 복원 가능한 삭제된 데이터베이스 리소스 ID여야 하며 sourceDatabaseDeletionDate는 무시됩니다. restorePointInTime은 이전 시점부터 복원하도록 지정할 수도 있습니다.

RestoreLongTermRetentionBackup: 장기 보존 자격 증명 모음에서 복원하여 데이터베이스를 만듭니다. recoveryServicesRecoveryPointResourceId는 복구 지점 리소스 ID로 지정해야 합니다.

DataWarehouse 버전에서는 Copy, NonReadableSecondary, OnlineSecondary 및 RestoreLongTermRetentionBackup이 지원되지 않습니다.
properties.creationDate

string (date-time)

데이터베이스의 생성 날짜(ISO8601 형식)입니다.
properties.currentServiceObjectiveId

string (uuid)

데이터베이스의 현재 서비스 수준 목표 ID입니다. 현재 활성 상태인 서비스 수준 목표의 ID입니다.
properties.databaseId

string (uuid)

데이터베이스의 ID입니다.
properties.defaultSecondaryLocation

string

이 데이터베이스의 기본 보조 지역입니다.
properties.earliestRestoreDate

string (date-time)

이 데이터베이스에 복원을 사용할 수 있는 가장 빠른 시작 날짜 및 시간(ISO8601 형식)을 기록합니다.
properties.edition

DatabaseEdition

데이터베이스의 버전입니다. DatabaseEditions 열거형에는 유효한 모든 버전이 포함됩니다. createMode가 NonReadableSecondary 또는 OnlineSecondary이면 이 값은 무시됩니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.elasticPoolName

string

데이터베이스가 있는 탄력적 풀의 이름입니다. elasticPoolName과 requestedServiceObjectiveName이 모두 업데이트된 경우 requestedServiceObjectiveName의 값은 무시됩니다. DataWarehouse 버전에서는 지원되지 않습니다.
properties.failoverGroupId

string

이 데이터베이스를 포함하는 장애 조치(failover) 그룹의 리소스 식별자입니다.
properties.maxSizeBytes

string

바이트로 표현된 데이터베이스의 최대 크기입니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다. 가능한 값을 보려면 operationId: "Capabilities_ListByLocation"에서 참조하는 기능 API(/subscriptions/{subscriptionId}/providers/Microsoft.Sql/locations/{locationID}/capabilities)를 쿼리합니다.
properties.readScale

ReadScale

조건부. 데이터베이스가 지역 보조 데이터베이스인 경우 readScale은 읽기 전용 연결이 이 데이터베이스에 허용되는지 여부를 나타냅니다. DataWarehouse 버전에서는 지원되지 않습니다.
properties.recommendedIndex

RecommendedIndex[]

이 데이터베이스에 권장되는 인덱스입니다.
properties.recoveryServicesRecoveryPointResourceId

string

조건부. createMode가 RestoreLongTermRetentionBackup인 경우 이 값이 필요합니다. 복원할 복구 지점의 리소스 ID를 지정합니다.
properties.requestedServiceObjectiveId

string (uuid)

데이터베이스의 구성된 서비스 수준 목표 ID입니다. 데이터베이스에 적용되는 프로세스의 서비스 수준 목표입니다. 성공적으로 업데이트되면 currentServiceObjectiveId 속성의 값과 일치합니다. requestedServiceObjectiveId와 requestedServiceObjectiveName이 모두 업데이트되면 requestedServiceObjectiveId 값이 requestedServiceObjectiveName 값을 재정의합니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 서비스 목표 ID를 확인하려면 Capabilities_ListByLocation REST API를 사용합니다.
properties.requestedServiceObjectiveName

ServiceObjectiveName

데이터베이스의 구성된 서비스 수준 목표의 이름입니다. 데이터베이스에 적용되는 프로세스의 서비스 수준 목표입니다. 성공적으로 업데이트되면 serviceLevelObjective 속성 값과 일치합니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
properties.restorePointInTime

string (date-time)

조건부. createMode가 PointInTimeRestore인 경우 이 값이 필요합니다. createMode가 Restore인 경우 이 값은 선택 사항입니다. 새 데이터베이스를 만들기 위해 복원할 원본 데이터베이스의 지정 시간(ISO8601 형식)을 지정합니다. 원본 데이터베이스의 earliestRestoreDate 값보다 크거나 같아야 합니다.
properties.sampleName

SampleName

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름을 나타냅니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다. DataWarehouse 버전에서는 지원되지 않습니다.
properties.serviceLevelObjective

ServiceObjectiveName

데이터베이스의 현재 서비스 수준 목표입니다.
properties.serviceTierAdvisors

ServiceTierAdvisor[]

이 데이터베이스의 서비스 계층 관리자 목록입니다. 확장된 속성
properties.sourceDatabaseDeletionDate

string (date-time)

조건부. createMode가 Restore이고 sourceDatabaseId가 존재할 때 삭제된 데이터베이스의 원래 리소스 ID인 경우(현재 복원 가능한 삭제된 데이터베이스 ID와는 달리) 이 값이 필요합니다. 데이터베이스가 삭제된 시간을 지정합니다.
properties.sourceDatabaseId

string

조건부. createMode가 Copy, NonReadableSecondary, OnlineSecondary, PointInTimeRestore, Recovery 또는 Restore인 경우 이 값이 필요합니다. 원본 데이터베이스의 리소스 ID를 지정합니다. createMode가 NonReadableSecondary 또는 OnlineSecondary인 경우 원본 데이터베이스의 이름은 생성되는 새 데이터베이스와 동일해야 합니다.
properties.status

string

데이터베이스의 상태입니다.
properties.transparentDataEncryption

TransparentDataEncryption[]

이 데이터베이스에 대한 투명한 데이터 암호화 정보입니다.
properties.zoneRedundant

boolean

이 데이터베이스가 영역 중복인지 여부입니다. 즉, 이 데이터베이스의 복제본이 여러 가용성 영역에 분산됩니다.
tags

object

리소스 태그.
type

string

리소스 종류입니다.

OperationImpact

Object

권장 인덱스 작업을 수행할 때의 예상 영향입니다.

Name 형식 Description
changeValueAbsolute

number (double)

차원에 대한 절대 영향입니다.
changeValueRelative

number (double)

차원에 대한 상대적 영향(해당되지 않는 경우 null)
name

string

영향 차원의 이름입니다.
unit

string

차원에 대한 예상 영향을 측정하는 단위입니다.

ReadScale

열거형

조건부. 데이터베이스가 지역 보조 데이터베이스인 경우 readScale은 읽기 전용 연결이 이 데이터베이스에 허용되는지 여부를 나타냅니다. DataWarehouse 버전에서는 지원되지 않습니다.

값 Description
Enabled
Disabled

RecommendedIndex

Object

이 데이터베이스에 권장되는 인덱스입니다.

Name 형식 Description
id

string

리소스 ID입니다.
name

string

리소스 이름입니다.
properties.action

RecommendedIndexAction

제안된 인덱스 작업입니다. 누락된 인덱스를 만들거나, 사용되지 않는 인덱스를 삭제하거나, 기존 인덱스를 다시 작성하여 성능을 향상시킬 수 있습니다.
properties.columns

string[]

인덱스를 작성할 열
properties.created

string (date-time)

이 리소스가 만들어진 시간을 보여 주는 UTC 날짜/시간(ISO8601 형식)입니다.
properties.estimatedImpact

OperationImpact[]

권장 인덱스 작업을 수행할 때의 예상 영향입니다.
properties.includedColumns

string[]

인덱스로 포함할 열 이름 목록
properties.indexScript

string

전체 빌드 인덱스 스크립트
properties.indexType

RecommendedIndexType

인덱스 유형(CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)
properties.lastModified

string (date-time)

이 리소스가 마지막으로 변경된 시점의 UTC 날짜/시간(ISO8601 형식)입니다.
properties.reportedImpact

OperationImpact[]

인덱스 작업이 완료된 후 보고된 값입니다.
properties.schema

string

인덱스를 작성할 테이블이 상주하는 스키마
properties.state

RecommendedIndexState

현재 권장 사항 상태입니다.
properties.table

string

인덱스 작성을 위한 테이블입니다.
type

string

리소스 종류입니다.

RecommendedIndexAction

열거형

제안된 인덱스 작업입니다. 누락된 인덱스를 만들거나, 사용되지 않는 인덱스를 삭제하거나, 기존 인덱스를 다시 작성하여 성능을 향상시킬 수 있습니다.

값 Description
Create
Drop
Rebuild

RecommendedIndexState

열거형

현재 권장 사항 상태입니다.

값 Description
Active
Pending
Executing
Verifying
Pending Revert
Reverting
Reverted
Ignored
Expired
Blocked
Success

RecommendedIndexType

열거형

인덱스 유형(CLUSTERED, NONCLUSTERED, COLUMNSTORE, CLUSTERED COLUMNSTORE)

값 Description
CLUSTERED
NONCLUSTERED
COLUMNSTORE
CLUSTERED COLUMNSTORE

SampleName

열거형

이 데이터베이스를 만들 때 적용할 샘플 스키마의 이름을 나타냅니다. createMode가 기본값이 아닌 경우 이 값은 무시됩니다. DataWarehouse 버전에서는 지원되지 않습니다.

값 Description
AdventureWorksLT

ServiceObjectiveName

열거형

데이터베이스의 구성된 서비스 수준 목표의 이름입니다. 데이터베이스에 적용되는 프로세스의 서비스 수준 목표입니다. 성공적으로 업데이트되면 serviceLevelObjective 속성 값과 일치합니다.

SKU 목록은 지역 및 지원 제품에 따라 다를 수 있습니다. Azure 지역의 구독에 사용할 수 있는 SKU 이름, 계층/버전, 제품군 및 용량을 포함한 SKU를 확인하려면 Capabilities_ListByLocation REST API 또는 다음 명령 중 하나를 사용합니다.

az sql db list-editions -l <location> -o table

Get-AzSqlServerServiceObjective -Location <location>
값 Description
System
System0
System1
System2
System3
System4
System2L
System3L
System4L
Free
Basic
S0
S1
S2
S3
S4
S6
S7
S9
S12
P1
P2
P3
P4
P6
P11
P15
PRS1
PRS2
PRS4
PRS6
DW100
DW200
DW300
DW400
DW500
DW600
DW1000
DW1200
DW1000c
DW1500
DW1500c
DW2000
DW2000c
DW3000
DW2500c
DW3000c
DW6000
DW5000c
DW6000c
DW7500c
DW10000c
DW15000c
DW30000c
DS100
DS200
DS300
DS400
DS500
DS600
DS1000
DS1200
DS1500
DS2000
ElasticPool

ServiceTierAdvisor

Object

이 데이터베이스의 서비스 계층 관리자 목록입니다. 확장된 속성

Name 형식 Description
id

string

리소스 ID입니다.
name

string

리소스 이름입니다.
properties.activeTimeRatio

number (double)

서비스 계층 관리자용 activeTimeRatio입니다.
properties.avgDtu

number (double)

서비스 계층 관리자에 대한 avgDtu를 가져오거나 설정합니다.
properties.confidence

number (double)

서비스 계층 관리자에 대한 신뢰도를 가져오거나 설정합니다.
properties.currentServiceLevelObjective

string

서비스 계층 관리자에 대한 currentServiceLevelObjective를 가져오거나 설정합니다.
properties.currentServiceLevelObjectiveId

string (uuid)

서비스 계층 관리자에 대한 currentServiceLevelObjectiveId를 가져오거나 설정합니다.
properties.databaseSizeBasedRecommendationServiceLevelObjective

string

서비스 계층 관리자에 대한 databaseSizeBasedRecommendationServiceLevelObjective를 가져오거나 설정합니다.
properties.databaseSizeBasedRecommendationServiceLevelObjectiveId

string (uuid)

서비스 계층 관리자에 대한 databaseSizeBasedRecommendationServiceLevelObjectiveId를 가져오거나 설정합니다.
properties.disasterPlanBasedRecommendationServiceLevelObjective

string

서비스 계층 관리자에 대한 disasterPlanBasedRecommendationServiceLevelObjective를 가져오거나 설정합니다.
properties.disasterPlanBasedRecommendationServiceLevelObjectiveId

string (uuid)

서비스 계층 관리자에 대한 disasterPlanBasedRecommendationServiceLevelObjectiveId를 가져오거나 설정합니다.
properties.maxDtu

number (double)

서비스 계층 관리자에 대한 maxDtu를 가져오거나 설정합니다.
properties.maxSizeInGB

number (double)

서비스 계층 관리자에 대한 maxSizeInGB를 가져오거나 설정합니다.
properties.minDtu

number (double)

서비스 계층 관리자에 대한 minDtu를 가져오거나 설정합니다.
properties.observationPeriodEnd

string (date-time)

관찰 기간 시작(ISO8601 형식)입니다.
properties.observationPeriodStart

string (date-time)

관찰 기간 시작(ISO8601 형식)입니다.
properties.overallRecommendationServiceLevelObjective

string

서비스 계층 관리자에 대한 overallRecommendationServiceLevelObjective를 가져오거나 설정합니다.
properties.overallRecommendationServiceLevelObjectiveId

string (uuid)

서비스 계층 관리자에 대한 overallRecommendationServiceLevelObjectiveId를 가져오거나 설정합니다.
properties.serviceLevelObjectiveUsageMetrics

SloUsageMetric[]

서비스 계층 관리자에 대한 serviceLevelObjectiveUsageMetrics를 가져오거나 설정합니다.
properties.usageBasedRecommendationServiceLevelObjective

string

서비스 계층 관리자에 대한 usageBasedRecommendationServiceLevelObjective를 가져오거나 설정합니다.
properties.usageBasedRecommendationServiceLevelObjectiveId

string (uuid)

서비스 계층 관리자에 대한 usageBasedRecommendationServiceLevelObjectiveId를 가져오거나 설정합니다.
type

string

리소스 종류입니다.

SloUsageMetric

Object

서비스 계층 관리자에 대한 serviceLevelObjectiveUsageMetrics를 가져오거나 설정합니다.

Name 형식 Description
inRangeTimeRatio

number (double)

SLO 사용 메트릭에 대한 inRangeTimeRatio를 가져오거나 설정합니다.
serviceLevelObjective

ServiceObjectiveName

SLO 사용 메트릭에 대한 serviceLevelObjective입니다.
serviceLevelObjectiveId

string (uuid)

SLO 사용 메트릭에 대한 serviceLevelObjectiveId입니다.

TransparentDataEncryption

Object

이 데이터베이스에 대한 투명한 데이터 암호화 정보입니다.

Name 형식 Description
id

string

리소스 ID입니다.
location

string

리소스 위치입니다.
name

string

리소스 이름입니다.
properties.status

TransparentDataEncryptionStatus

데이터베이스 투명한 데이터 암호화의 상태입니다.
type

string

리소스 종류입니다.

TransparentDataEncryptionStatus

열거형

데이터베이스 투명한 데이터 암호화의 상태입니다.

값 Description
Enabled
Disabled