Databases - Import

リファレンス

サービス:: SQL Database

API バージョン:: 2021-11-01

bacpac を新しいデータベースにインポートします。

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

URI パラメーター

名前	/	必須	型	説明
databaseName	path	True	string	データベースの名前。
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	認証の種類。
networkIsolation		NetworkIsolationSettings	要求のネットワーク分離を有効にするオプションのリソース情報。

応答

名前	型	説明
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 an existing empty database, using private link to communicate with SQL server and storage account.

Imports to an existing empty database.

Imports to an existing empty database, using private link to communicate with 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/databases/testdb/import?api-version=2021-11-01

{
  "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.ImportExistingDatabaseDefinition;
import com.azure.resourcemanager.sql.models.NetworkIsolationSettings;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Databases ImportMethod.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportDatabaseWithNetworkIsolation.
     * json
     */
    /**
     * Sample code: Imports to an existing empty database, using private link to communicate with SQL server and storage
     * account.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToAnExistingEmptyDatabaseUsingPrivateLinkToCommunicateWithSQLServerAndStorageAccount(
        com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases()
            .importMethod("Default-SQL-SouthEastAsia", "testsvr", "testdb", new ImportExistingDatabaseDefinition()
                .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 an existing empty database.

要求のサンプル

HTTP
Java

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

{
  "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.ImportExistingDatabaseDefinition;
import com.azure.resourcemanager.sql.models.StorageKeyType;

/**
 * Samples for Databases ImportMethod.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ImportDatabase.json
     */
    /**
     * Sample code: Imports to an existing empty database.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void importsToAnExistingEmptyDatabase(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getDatabases().importMethod("Default-SQL-SouthEastAsia", "testsvr",
            "testdb",
            new ImportExistingDatabaseDefinition().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

定義

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

ImportExistingDatabaseDefinition

既存のデータベースのインポート操作を実行するために必要な情報を格納します。

名前	型	説明
administratorLogin	string	管理者ログイン名。
administratorLoginPassword	string	管理者ログインパスワード。
authenticationType	string	認証の種類。
networkIsolation	NetworkIsolationSettings	要求のネットワーク分離を有効にするオプションのリソース情報。
storageKey	string	ストレージキー。
storageKeyType	StorageKeyType	ストレージキーの種類。
storageUri	string	ストレージ URI。

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	リソースの種類。

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

次の方法で共有

Databases - Import

URI パラメーター

要求本文

応答

例

Imports to an existing empty database, using private link to communicate with SQL server and storage account.

要求のサンプル

応答のサンプル

Imports to an existing empty database.

要求のサンプル

応答のサンプル

定義

ImportExistingDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

その他のリソース