Servers - Import Database

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

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

URI 매개 변수

Name In Required Type Description
resourceGroupName
path True
  • string

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

serverName
path True
  • string

서버의 이름입니다.

subscriptionId
path True
  • string

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

api-version
query True
  • string

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

요청 본문

Name Required Type Description
administratorLogin True
  • string

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

administratorLoginPassword True
  • string

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

storageKey True
  • string

Storage 키입니다.

storageKeyType True

Storage 키 형식입니다.

storageUri True
  • string

Storage Uri.

authenticationType
  • string

인증 유형입니다.

databaseName
  • string

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

edition
  • string

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

maxSizeBytes
  • string

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

networkIsolation

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

serviceObjectiveName
  • string

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

응답

Name Type Description
200 OK

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

202 Accepted

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

Other Status Codes

오류 응답: ***

  • 400 MissingImportExportInputParameters - ImportExport 입력 매개 변수가 없습니다.

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

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

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

  • 400 DatabaseExtensionsMissingStorageUri - Storage URI를 비울 수 없습니다.

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

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

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

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

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

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

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

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

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

예제

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

Sample Request

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

{
  "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"
  }
}

Sample Response

{
  "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.

Sample Request

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

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

Sample Response

{
  "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"
}

정의

ImportExportOperationResult

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

ImportNewDatabaseDefinition

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

NetworkIsolationSettings

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

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

Storage 키 형식입니다.

ImportExportOperationResult

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

Name Type Description
id
  • string

리소스 ID입니다.

name
  • string

리소스 이름입니다.

properties.blobUri
  • string

Blob Uri입니다.

properties.databaseName
  • string

데이터베이스 이름

properties.errorMessage
  • string

오류 메시지입니다.

properties.lastModifiedTime
  • string

마지막으로 수정한 시간입니다.

properties.privateEndpointConnections

이 요청과 연결된 프라이빗 엔드포인트의 상태를 가져옵니다.

properties.queuedTime
  • string

대기 시간.

properties.requestId
  • string

요청 ID입니다.

properties.requestType
  • string

요청 유형입니다.

properties.serverName
  • string

서버 이름입니다.

properties.status
  • string

작업 상태입니다.

type
  • string

리소스 종류.

ImportNewDatabaseDefinition

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

Name Type Description
administratorLogin
  • string

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

administratorLoginPassword
  • string

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

authenticationType
  • string

인증 유형입니다.

databaseName
  • string

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

edition
  • string

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

maxSizeBytes
  • string

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

networkIsolation

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

serviceObjectiveName
  • string

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

storageKey
  • string

Storage 키입니다.

storageKeyType

Storage 키 형식입니다.

storageUri
  • string

Storage Uri.

NetworkIsolationSettings

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

Name Type Description
sqlServerResourceId
  • string

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

storageAccountResourceId
  • string

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

PrivateEndpointConnectionRequestStatus

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

Name Type Description
privateEndpointConnectionName
  • string

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

privateLinkServiceId
  • string

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

status
  • string

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

StorageKeyType

Storage 키 형식입니다.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string