다음을 통해 공유


Servers - Import Database

bacpac을 새 데이터베이스로 가져옵니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/import?api-version=2021-11-01

URI 매개 변수

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

string

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

serverName
path True

string

서버의 이름입니다.

subscriptionId
path True

string

Azure 구독을 식별하는 구독 ID입니다.

api-version
query True

string

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

요청 본문

Name 필수 형식 Description
administratorLogin True

string

관리자 로그인 이름입니다.

administratorLoginPassword True

string

관리자 로그인 암호입니다.

storageKey True

string

스토리지 키.

storageKeyType True

StorageKeyType

스토리지 키 유형입니다.

storageUri True

string

스토리지 Uri.

authenticationType

string

인증 유형입니다.

databaseName

string

가져오기 데이터베이스의 이름입니다.

edition

string

가져오기 데이터베이스의 버전입니다.

maxSizeBytes

string

가져오기 데이터베이스의 최대 크기(바이트)입니다.

networkIsolation

NetworkIsolationSettings

요청에 대한 네트워크 격리를 사용하도록 설정하는 선택적 리소스 정보입니다.

serviceObjectiveName

string

가져오기 데이터베이스의 서비스 수준 목표 이름입니다.

응답

Name 형식 Description
200 OK

ImportExportOperationResult

데이터베이스를 가져왔습니다.

202 Accepted

데이터베이스 가져오기가 진행 중입니다.

Other Status Codes

오류 응답: ***

  • 400 MissingImportExportInputParameters - ImportExport 입력 매개 변수가 누락되었습니다.

  • 400 InvalidImportExportInputParameter - 잘못된 입력 매개 변수로 인해 가져오기/내보내기 요청이 실패했습니다.

  • 400 PolybaseImportAuthenticationTypeNotSupported - 인증 유형 매개 변수는 PolybaseImport 작업을 지원하지 않습니다.

  • 400 DatabaseExtensionsInvalidOperationMode - 데이터베이스 확장에 대한 operationMode 매개 변수가 잘못되었습니다.

  • 400 DatabaseExtensionsInvalidStorageKeyType - 스토리지 키 유형은 'StorageAccessKey'여야 합니다.

  • 400 DatabaseExtensionsMissingStorageUri - 스토리지 URI를 비울 수 없습니다.

  • 400 InvalidSku - 사용자가 잘못된 sku를 지정했습니다.

  • 400 InvalidTierSkuCombination - 지정된 계층이 지정된 sku를 지원하지 않습니다.

  • 400 DatabaseInvalidSkuPropertyCombination - 요청된 sku의 속성이 일치하지 않습니다. 유효한 조합이 지정되어 있는지 검사. 자세한 내용은 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability를 참조하세요.

  • 400 InvalidMaxSizeTierCombination - 지정된 계층은 지정된 데이터베이스 최대 크기를 지원하지 않습니다.

  • 400 FeatureDisabledOnSelectedEdition - 사용자가 현재 데이터베이스 버전에서 사용하지 않도록 설정된 기능을 사용하려고 했습니다.

  • 400 InvalidImportExportParameter - 잘못된 입력 매개 변수로 인해 가져오기/내보내기 요청이 실패했습니다.

  • 400 InvalidTier - 사용자가 잘못된 계층을 지정했습니다.

  • 400 InvalidOperationType - 유효한 작업 유형을 제공합니다.

  • 400 ImportExportJobError - ImportExport 작업이 실패했습니다.

  • 400 BlockedByOutboundFirewall - 아웃바운드 방화벽 규칙이 요청을 차단했습니다.

  • 404 ResourceNotFound - 존재하지 않는 리소스를 지정하는 잘못된 요청입니다.

  • 404 ServerNotInSubscriptionResourceGroup - 지정된 서버가 지정된 리소스 그룹 및 구독에 없습니다.

  • 404 ImportExportOperationIdNotFound - 가져오기 또는 내보내기 작업 ID를 찾을 수 없습니다.

  • 404 ServerNotInSubscription - 지정된 서버가 지정된 구독에 없습니다.

  • 404 OperationIdNotFound - ID가 있는 작업이 없습니다.

  • 409 ImportExportOperationInProgress - 데이터베이스에서 가져오기 또는 내보내기 작업이 진행 중입니다.

  • 409 OperationCancelled - 사용자가 작업을 취소했습니다.

  • 409 OperationInterrupted - 동일한 리소스의 다른 작업에 의해 중단되었으므로 리소스에 대한 작업을 완료할 수 없습니다.

  • 429 SubscriptionTooManyCreateUpdateRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 429 SubscriptionTooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

  • 500 OperationTimedOut - 작업 시간이 초과되고 자동으로 롤백됩니다. 작업을 다시 시도하세요.

  • 503 TooManyRequests - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

예제

Imports to a new database, using private link for the SQL server and storage account.
Imports to a new database.

샘플 요청

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2021-11-01

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql",
  "networkIsolation": {
    "sqlServerResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr",
    "storageAccountResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"
  }
}

샘플 응답

{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}

Imports to a new database.

샘플 요청

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2021-11-01

{
  "databaseName": "testdb",
  "storageKeyType": "StorageAccessKey",
  "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==",
  "storageUri": "https://test.blob.core.windows.net/test.bacpac",
  "administratorLogin": "login",
  "administratorLoginPassword": "password",
  "authenticationType": "Sql"
}

샘플 응답

{
  "properties": {
    "requestId": "9d9a794a-5cec-4f23-af70-d29511b522a4",
    "requestType": "Import",
    "queuedTime": "2/2/2020 8:33:27 PM",
    "lastModifiedTime": "2/2/2020 8:34:47 PM",
    "blobUri": "https://test.blob.core.windows.net/test.bacpac",
    "serverName": "testsvr.database.windows.net",
    "databaseName": "testdb",
    "status": "Completed"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/databases/testdb/importExportOperationResults/9d9a794a-5cec-4f23-af70-d29511b522a4",
  "name": "9d9a794a-5cec-4f23-af70-d29511b522a4",
  "type": "Microsoft.Sql/servers/databases/importExportOperationResults"
}

정의

Name Description
ImportExportOperationResult

ImportExport 작업 결과 리소스입니다.

ImportNewDatabaseDefinition

새 데이터베이스에 대한 가져오기 작업을 수행하는 데 필요한 정보를 포함합니다.

NetworkIsolationSettings

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

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

스토리지 키 유형입니다.

ImportExportOperationResult

ImportExport 작업 결과 리소스입니다.

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

요청 ID입니다.

properties.requestType

string

요청 유형입니다.

properties.serverName

string

서버 이름입니다.

properties.status

string

작업 상태입니다.

type

string

리소스 종류.

ImportNewDatabaseDefinition

새 데이터베이스에 대한 가져오기 작업을 수행하는 데 필요한 정보를 포함합니다.

Name 형식 Description
administratorLogin

string

관리자 로그인 이름입니다.

administratorLoginPassword

string

관리자 로그인 암호입니다.

authenticationType

string

인증 유형입니다.

databaseName

string

가져오기 데이터베이스의 이름입니다.

edition

string

가져오기 데이터베이스의 버전입니다.

maxSizeBytes

string

가져오기 데이터베이스의 최대 크기(바이트)입니다.

networkIsolation

NetworkIsolationSettings

요청에 대한 네트워크 격리를 사용하도록 설정하는 선택적 리소스 정보입니다.

serviceObjectiveName

string

가져오기 데이터베이스의 서비스 수준 목표 이름입니다.

storageKey

string

스토리지 키.

storageKeyType

StorageKeyType

스토리지 키 유형입니다.

storageUri

string

스토리지 Uri.

NetworkIsolationSettings

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

Name 형식 Description
sqlServerResourceId

string

이 요청의 대상인 SQL Server의 리소스 ID입니다. 설정되면 SQL Server에 대한 프라이빗 엔드포인트 연결이 만들어집니다. 작업의 대상인 서버와 일치해야 합니다.

storageAccountResourceId

string

BACPAC 파일을 저장하는 데 사용되는 스토리지 계정의 리소스 ID입니다. 설정된 경우 스토리지 계정에 대한 프라이빗 엔드포인트 연결이 만들어집니다. StorageUri 매개 변수에 사용되는 스토리지 계정과 일치해야 합니다.

PrivateEndpointConnectionRequestStatus

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

Name 형식 Description
privateEndpointConnectionName

string

프라이빗 엔드포인트의 연결 이름입니다.

privateLinkServiceId

string

프라이빗 엔드포인트가 만들어지는 리소스 ID입니다.

status

string

이 프라이빗 엔드포인트 연결의 상태입니다.

StorageKeyType

스토리지 키 유형입니다.

Name 형식 Description
SharedAccessKey

string

StorageAccessKey

string