Database Extensions - Create Or Update

서비스:: SQL Database

API 버전:: 2023-08-01

데이터베이스 가져오기, 데이터베이스 내보내기 또는 polybase 가져오기와 같은 데이터베이스 확장 작업 수행

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/extensions/{extensionName}?api-version=2023-08-01

URI 매개 변수

Name	In(다음 안에)	필수	형식	Description
databaseName	path	True	string	데이터베이스의 이름입니다.
extensionName	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
properties.operationMode	True	OperationMode	작업의 작업 모드: 가져오기, 내보내기 또는 PolybaseImport입니다.
properties.storageKey	True	string	스토리지 계정의 스토리지 키입니다.
properties.storageKeyType	True	StorageKeyType	스토리지 키 유형: StorageAccessKey 또는 SharedAccessKey.
properties.storageUri	True	string	스토리지 계정에 대한 스토리지 URI입니다.
properties.administratorLogin		string	관리자 로그인 이름입니다.
properties.administratorLoginPassword		string	관리자 로그인 암호입니다.
properties.authenticationType		string	인증 유형: SQL 인증 또는 AD 암호입니다.
properties.databaseEdition		string	가져오기 작업의 경우 새로 만든 데이터베이스에 대한 데이터베이스 버전입니다.
properties.maxSizeBytes		string	가져오기 작업의 경우 새로 만든 데이터베이스의 데이터베이스 최대 크기(바이트)입니다.
properties.networkIsolation		NetworkIsolationSettings	요청에 대한 네트워크 격리를 사용하도록 설정하는 선택적 리소스 정보입니다.
properties.serviceObjectiveName		string	가져오기 작업의 경우 새로 만든 데이터베이스에 대한 데이터베이스 서비스 수준 목표입니다.

응답

Name	형식	Description
200 OK	ImportExportExtensionsOperationResult	가져오기/내보내기 작업을 완료했습니다.
202 Accepted		가져오기/내보내기 작업이 진행 중입니다. 헤더 Location: string
Other Status Codes	ErrorResponse	오류 응답: *** 400 MissingImportExportInputParameters - ImportExport 입력 매개 변수가 없습니다. 400 InvalidImportExportInputParameter - 잘못된 입력 매개 변수로 인해 가져오기/내보내기 요청이 실패했습니다. 400 PolybaseImportAuthenticationTypeNotSupported - 인증 유형 매개 변수는 PolybaseImport 작업을 지원하지 않습니다. 400 DatabaseExtensionsInvalidOperationMode - 데이터베이스 확장에 대한 operationMode 매개 변수가 잘못되었습니다. 400 DatabaseExtensionsInvalidStorageKeyType - 스토리지 키 유형은 'StorageAccessKey'여야 합니다. 400 DatabaseExtensionsMissingStorageUri - 스토리지 URI는 비워 둘 수 없습니다. 400 SQLPasswordSpecifiedWithManagedIdentity - authenticationType이 ManagedIdentity인 경우 administratorLoginPassword를 지정하면 안 됩니다. 400 InvalidSqlAuthType - SQL 인증 유형이 잘못되어 ImportExport 작업이 실패했습니다. 400 BlobAlreadyExist - 스토리지 Blob이 이미 있으므로 ImportExport 작업이 실패했습니다. 400 InvalidImportExportOperationResourceLocks - Private Link 리소스에 대한 잠금으로 인해 가져오기/내보내기 요청이 잘못되었습니다. 400 DatabaseInvalidSkuPropertyCombination - 요청된 sku의 속성이 일치하지 않습니다. 유효한 조합이 지정되어 있는지 확인하세요. 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability 참조하세요. 400 ImportExportJobError - ImportExport 작업이 실패했습니다. 400 BlockedByOutboundFirewall - 아웃바운드 방화벽 규칙이 요청을 차단했습니다. 400 InvalidOperationType - 유효한 작업 유형을 제공합니다. 400 InvalidMaxSizeTierCombination - 지정된 계층은 지정된 데이터베이스 최대 크기를 지원하지 않습니다. 400 InvalidTier - 사용자가 잘못된 계층을 지정했습니다. 400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다. 400 InvalidImportExportParameter - 잘못된 입력 매개 변수로 인해 가져오기/내보내기 요청이 실패했습니다. 400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다. 400 InvalidTierSkuCombination - 지정된 계층이 지정된 sku를 지원하지 않습니다. 400 InvalidImportExportStorageCredentials - 잘못된 스토리지 자격 증명으로 인해 가져오기/내보내기 작업이 실패했습니다. 400 InvalidImportExportStorageAuthType - 잘못된 스토리지 인증 유형으로 인해 가져오기/내보내기 작업이 실패했습니다. 400 InvalidImportExportStorageKeyFormat - 잘못된 스토리지 키 형식으로 인해 가져오기/내보내기 작업이 실패했습니다. 400 LongImportExportStorageUri - 긴 스토리지 URI로 인해 가져오기/내보내기 작업이 실패했습니다. 400 LargeExportDatabaseSize - 데이터베이스가 지원되는 최대 크기보다 크므로 내보내기 작업이 실패했습니다. 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다. 400 UnSupportedImportExportEdition - 잘못된 버전을 대상으로 하므로 ImportExport 작업이 실패했습니다. 400 InvalidImportExportStorageURI - 스토리지 URI가 잘못되어 ImportExport 작업이 실패했습니다. 404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다. 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다. 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다. 404 ResourceNotFound - 존재하지 않는 리소스를 지정하는 잘못된 요청입니다. 404 ImportExportOperationIdNotFound - 가져오기 또는 내보내기 작업 ID를 찾을 수 없습니다. 404 OperationIdNotFound - ID가 있는 작업이 없습니다. 409 ImportExportOperationInProgress - 데이터베이스에서 가져오기 또는 내보내기 작업이 진행 중입니다. 409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다. 409 OperationCancelled - 사용자가 작업을 취소했습니다. 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다. 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다. 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요. 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

Name

형식

Description

200 OK

ImportExportExtensionsOperationResult

가져오기/내보내기 작업을 완료했습니다.

202 Accepted

가져오기/내보내기 작업이 진행 중입니다.

헤더

Location: string

Other Status Codes

ErrorResponse

오류 응답: ***

400 MissingImportExportInputParameters - ImportExport 입력 매개 변수가 없습니다.
400 InvalidImportExportInputParameter - 잘못된 입력 매개 변수로 인해 가져오기/내보내기 요청이 실패했습니다.
400 PolybaseImportAuthenticationTypeNotSupported - 인증 유형 매개 변수는 PolybaseImport 작업을 지원하지 않습니다.
400 DatabaseExtensionsInvalidOperationMode - 데이터베이스 확장에 대한 operationMode 매개 변수가 잘못되었습니다.
400 DatabaseExtensionsInvalidStorageKeyType - 스토리지 키 유형은 'StorageAccessKey'여야 합니다.
400 DatabaseExtensionsMissingStorageUri - 스토리지 URI는 비워 둘 수 없습니다.
400 SQLPasswordSpecifiedWithManagedIdentity - authenticationType이 ManagedIdentity인 경우 administratorLoginPassword를 지정하면 안 됩니다.
400 InvalidSqlAuthType - SQL 인증 유형이 잘못되어 ImportExport 작업이 실패했습니다.
400 BlobAlreadyExist - 스토리지 Blob이 이미 있으므로 ImportExport 작업이 실패했습니다.
400 InvalidImportExportOperationResourceLocks - Private Link 리소스에 대한 잠금으로 인해 가져오기/내보내기 요청이 잘못되었습니다.
400 DatabaseInvalidSkuPropertyCombination - 요청된 sku의 속성이 일치하지 않습니다. 유효한 조합이 지정되어 있는지 확인하세요. 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability 참조하세요.
400 ImportExportJobError - ImportExport 작업이 실패했습니다.
400 BlockedByOutboundFirewall - 아웃바운드 방화벽 규칙이 요청을 차단했습니다.
400 InvalidOperationType - 유효한 작업 유형을 제공합니다.
400 InvalidMaxSizeTierCombination - 지정된 계층은 지정된 데이터베이스 최대 크기를 지원하지 않습니다.
400 InvalidTier - 사용자가 잘못된 계층을 지정했습니다.
400 CannotUseReservedDatabaseName - 이 작업에서 예약된 데이터베이스 이름을 사용할 수 없습니다.
400 InvalidImportExportParameter - 잘못된 입력 매개 변수로 인해 가져오기/내보내기 요청이 실패했습니다.
400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다.
400 InvalidTierSkuCombination - 지정된 계층이 지정된 sku를 지원하지 않습니다.
400 InvalidImportExportStorageCredentials - 잘못된 스토리지 자격 증명으로 인해 가져오기/내보내기 작업이 실패했습니다.
400 InvalidImportExportStorageAuthType - 잘못된 스토리지 인증 유형으로 인해 가져오기/내보내기 작업이 실패했습니다.
400 InvalidImportExportStorageKeyFormat - 잘못된 스토리지 키 형식으로 인해 가져오기/내보내기 작업이 실패했습니다.
400 LongImportExportStorageUri - 긴 스토리지 URI로 인해 가져오기/내보내기 작업이 실패했습니다.
400 LargeExportDatabaseSize - 데이터베이스가 지원되는 최대 크기보다 크므로 내보내기 작업이 실패했습니다.
400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.
400 UnSupportedImportExportEdition - 잘못된 버전을 대상으로 하므로 ImportExport 작업이 실패했습니다.
400 InvalidImportExportStorageURI - 스토리지 URI가 잘못되어 ImportExport 작업이 실패했습니다.
404 DatabaseDoesNotExist - 사용자가 이 서버 인스턴스에 없는 데이터베이스 이름을 지정했습니다.
404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다.
404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.
404 ResourceNotFound - 존재하지 않는 리소스를 지정하는 잘못된 요청입니다.
404 ImportExportOperationIdNotFound - 가져오기 또는 내보내기 작업 ID를 찾을 수 없습니다.
404 OperationIdNotFound - ID가 있는 작업이 없습니다.
409 ImportExportOperationInProgress - 데이터베이스에서 가져오기 또는 내보내기 작업이 진행 중입니다.
409 CannotCancelOperation - 관리 작업이 취소할 수 없는 상태입니다.
409 OperationCancelled - 사용자가 작업을 취소했습니다.
409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.
429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.
500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.
503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Create or Update database extensions.

Export database using database extension.

Import database using database extension.

Create or Update database extensions.

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/a1c0814d-3c18-4e1e-a247-c128c12b1677/resourceGroups/rg_20cbe0f0-c2d9-4522-9177-5469aad53029/providers/Microsoft.Sql/servers/srv_1ffd1cf8-9951-47fb-807d-a9c384763849/databases/878e303f-1ea0-4f17-aa3d-a22ac5e9da08/extensions/polybaseimport?api-version=2023-08-01

{
  "properties": {
    "operationMode": "PolybaseImport",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
  }
}

샘플 응답

상태 코드:: 202

상태 코드:: 200

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "PolybaseImport",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_1ffd1cf8-9951-47fb-807d-a9c384763849",
    "databaseName": "878e303f-1ea0-4f17-aa3d-a22ac5e9da08",
    "status": "succeeded"
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

Export database using database extension.

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/0ca8cd24-0b47-4ad5-bc7e-d70e35c44adf/resourceGroups/rg_d1ef9eae-044d-4710-ba59-b82e84ad3157/providers/Microsoft.Sql/servers/srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c/databases/db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68/extensions/Export?api-version=2023-08-01

{
  "properties": {
    "operationMode": "Export",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}

샘플 응답

상태 코드:: 200

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Export",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c",
    "databaseName": "db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

상태 코드:: 202

Import database using database extension.

샘플 요청

HTTP

PUT https://management.azure.com/subscriptions/17ca4d13-bf7d-4c33-a60e-b87a2820a325/resourceGroups/rg_062866bf-c4f4-41f9-abf0-b59132ca7924/providers/Microsoft.Sql/servers/srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82/databases/db_2a47e946-e414-4c00-94ac-ed886bb78302/extensions/Import?api-version=2023-08-01

{
  "properties": {
    "operationMode": "Import",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}

샘플 응답

상태 코드:: 200

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Import",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82",
    "databaseName": "db_2a47e946-e414-4c00-94ac-ed886bb78302",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

상태 코드:: 202

정의

Name	Description
DatabaseExtensions	Import, Export 또는 PolybaseImport 리소스입니다.
ErrorAdditionalInfo	리소스 관리 오류 추가 정보입니다.
ErrorDetail	오류 세부 정보입니다.
ErrorResponse	오류 응답
ImportExportExtensionsOperationResult	확장 작업 결과 리소스입니다.
NetworkIsolationSettings	프라이빗 엔드포인트 연결을 만들 ARM 리소스를 포함합니다.
OperationMode	작업의 작업 모드: 가져오기, 내보내기 또는 PolybaseImport입니다.
PrivateEndpointConnectionRequestStatus	프라이빗 엔드포인트 연결 요청 상태를 포함합니다.
StorageKeyType	스토리지 키 유형: StorageAccessKey 또는 SharedAccessKey.

DatabaseExtensions

Object

Import, Export 또는 PolybaseImport 리소스입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.administratorLogin	string	관리자 로그인 이름입니다.
properties.administratorLoginPassword	string	관리자 로그인 암호입니다.
properties.authenticationType	string	인증 유형: SQL 인증 또는 AD 암호입니다.
properties.databaseEdition	string	가져오기 작업의 경우 새로 만든 데이터베이스에 대한 데이터베이스 버전입니다.
properties.maxSizeBytes	string	가져오기 작업의 경우 새로 만든 데이터베이스의 데이터베이스 최대 크기(바이트)입니다.
properties.networkIsolation	NetworkIsolationSettings	요청에 대한 네트워크 격리를 사용하도록 설정하는 선택적 리소스 정보입니다.
properties.operationMode	OperationMode	작업의 작업 모드: 가져오기, 내보내기 또는 PolybaseImport입니다.
properties.serviceObjectiveName	string	가져오기 작업의 경우 새로 만든 데이터베이스에 대한 데이터베이스 서비스 수준 목표입니다.
properties.storageKey	string	스토리지 계정의 스토리지 키입니다.
properties.storageKeyType	StorageKeyType	스토리지 키 유형: StorageAccessKey 또는 SharedAccessKey.
properties.storageUri	string	스토리지 계정에 대한 스토리지 URI입니다.
type	string	리소스 종류입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name	형식	Description
info	object	추가 정보입니다.
type	string	추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name	형식	Description
additionalInfo	ErrorAdditionalInfo[]	오류 추가 정보입니다.
code	string	오류 코드입니다.
details	ErrorDetail[]	오류 세부 정보입니다.
message	string	오류 메시지입니다.
target	string	오류 대상입니다.

ErrorResponse

Object

오류 응답

Name	형식	Description
error	ErrorDetail	오류 개체입니다.

ImportExportExtensionsOperationResult

Object

확장 작업 결과 리소스입니다.

Name	형식	Description
id	string	리소스 ID입니다.
name	string	리소스 이름입니다.
properties.blobUri	string	Blob URI입니다.
properties.databaseName	string	데이터베이스 이름입니다.
properties.errorMessage	string	오류 메시지입니다.
properties.lastModifiedTime	string	마지막으로 수정한 시간입니다.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	이 요청과 연결된 프라이빗 엔드포인트의 상태를 가져옵니다.
properties.queuedTime	string	대기 시간.
properties.requestId	string (uuid)	요청 ID입니다.
properties.requestType	string	요청 유형입니다.
properties.serverName	string	서버 이름입니다.
properties.status	string	작업 상태입니다.
type	string	리소스 종류입니다.

NetworkIsolationSettings

Object

프라이빗 엔드포인트 연결을 만들 ARM 리소스를 포함합니다.

Name	형식	Description
sqlServerResourceId	string (arm-id)	이 요청의 대상인 SQL Server의 리소스 ID입니다. 설정되면 SQL Server에 대한 프라이빗 엔드포인트 연결이 만들어집니다. 작업의 대상인 서버와 일치해야 합니다.
storageAccountResourceId	string (arm-id)	BACPAC 파일을 저장하는 데 사용되는 스토리지 계정의 리소스 ID입니다. 설정되면 스토리지 계정에 대한 프라이빗 엔드포인트 연결이 만들어집니다. StorageUri 매개 변수에 사용되는 스토리지 계정과 일치해야 합니다.

OperationMode

열거형

작업의 작업 모드: 가져오기, 내보내기 또는 PolybaseImport입니다.

값	Description
PolybaseImport
Import
Export

PrivateEndpointConnectionRequestStatus

Object

프라이빗 엔드포인트 연결 요청 상태를 포함합니다.

Name	형식	Description
privateEndpointConnectionName	string	프라이빗 엔드포인트의 연결 이름입니다.
privateLinkServiceId	string	프라이빗 엔드포인트가 만들어지는 리소스 ID입니다.
status	string	이 프라이빗 엔드포인트 연결의 상태입니다.

StorageKeyType

열거형

스토리지 키 유형: StorageAccessKey 또는 SharedAccessKey.

값	Description
SharedAccessKey
StorageAccessKey

다음을 통해 공유

Database Extensions - Create Or Update

URI 매개 변수

요청 본문

응답

예제

Create or Update database extensions.

샘플 요청

샘플 응답

Export database using database extension.

샘플 요청

샘플 응답

Import database using database extension.

샘플 요청

샘플 응답

정의

DatabaseExtensions

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportExportExtensionsOperationResult

NetworkIsolationSettings

OperationMode

PrivateEndpointConnectionRequestStatus

StorageKeyType