Servers - Import Database

참조

서비스:: SQL Database

API 버전:: 2021-11-01

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 - 사용 가능한 리소스에서 처리할 수 있는 최대 요청을 초과하는 요청입니다.

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.

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

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


import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Servers ImportDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabaseWithNetworkIsolation
     * .json
     */
    /**
     * Sample code: Imports to a new database, using private link for the SQL server and storage account.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabaseUsingPrivateLinkForTheSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql")
                .withNetworkIsolation(new NetworkIsolationSettings().withStorageAccountResourceId(
                    "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink")
                    .withSqlServerResourceId(
                        "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr")),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

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

상태 코드:: 202

Imports to a new database.

샘플 요청

HTTP
Java

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


import com.azure.resourcemanager.sql.models.ImportNewDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Servers ImportDatabase.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportNewDatabase.json
     */
    /**
     * Sample code: Imports to a new database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToANewDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServers().importDatabase("Default-SQL-SouthEastAsia", "testsvr",
            new ImportNewDatabaseDefinition().withDatabaseName("testdb")
                .withStorageKeyType(StorageKeyType.STORAGE_ACCESS_KEY).withStorageKey("fakeTokenPlaceholder")
                .withStorageUri("https://test.blob.core.windows.net/test.bacpac").withAdministratorLogin("login")
                .withAdministratorLoginPassword("fakeTokenPlaceholder").withAuthenticationType("Sql"),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

샘플 응답

상태 코드:: 200

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

상태 코드:: 202

정의

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

다음을 통해 공유

Servers - Import Database

URI 매개 변수

요청 본문

응답

예제

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

샘플 요청

샘플 응답

Imports to a new database.

샘플 요청

샘플 응답

정의

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

추가 리소스