Servers - Import Database

リファレンス

Service:: SQL Database

API Version:: 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 パラメーター

名前	/	必須	型	説明
resourceGroupName	path	True	string	リソースが含まれているリソースグループの名前。この値は、Azure リソースマネージャー API またはポータルから取得できます。
serverName	path	True	string	サーバーの名前。
subscriptionId	path	True	string	Azure サブスクリプションを識別するサブスクリプション ID。
api-version	query	True	string	要求で使用する API のバージョン。

要求本文

名前	必須	型	説明
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	インポートデータベースのサービスレベル目標名。

応答

名前	型	説明
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 - 使用可能なリソースで処理できる最大要求を超える要求。

名前

型

説明

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.core.util.Context;
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")),
            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

Sample Response

Status code:: 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"
}

Status code:: 202

Imports to a new database.

Sample Request

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.core.util.Context;
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"),
            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

Sample Response

Status code:: 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"
}

Status code:: 202

定義

名前	説明
ImportExportOperationResult	ImportExport 操作の結果リソース。
ImportNewDatabaseDefinition	新しいデータベースのインポート操作を実行するために必要な情報が含まれます。
NetworkIsolationSettings	プライベートエンドポイント接続を作成する ARM リソースが含まれます。
PrivateEndpointConnectionRequestStatus	プライベートエンドポイント接続要求の状態が含まれます。
StorageKeyType	ストレージキーの種類。

ImportExportOperationResult

ImportExport 操作の結果リソース。

名前	型	説明
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

新しいデータベースのインポート操作を実行するために必要な情報が含まれます。

名前	型	説明
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 リソースが含まれます。

名前	型	説明
sqlServerResourceId	string	この要求のターゲットである SQL サーバーのリソース ID。設定すると、SQL サーバーのプライベートエンドポイント接続が作成されます。操作のターゲットであるサーバーと一致する必要があります。
storageAccountResourceId	string	BACPAC ファイルの格納に使用されるストレージアカウントのリソース ID。設定すると、ストレージアカウントのプライベートエンドポイント接続が作成されます。 StorageUri パラメーターに使用されるストレージアカウントと一致する必要があります。

PrivateEndpointConnectionRequestStatus

プライベートエンドポイント接続要求の状態が含まれます。

名前	型	説明
privateEndpointConnectionName	string	プライベートエンドポイントの接続名。
privateLinkServiceId	string	プライベートエンドポイントが作成されるリソース ID。
status	string	このプライベートエンドポイント接続の状態。

StorageKeyType

ストレージキーの種類。

名前	型	説明
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

URI パラメーター

要求本文

応答

例

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

Sample Request

Sample Response

Imports to a new database.

Sample Request

Sample Response

定義

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

その他のリソース