Servers - Import Database

服務:: SQL Database

API 版本:: 2023-08-01

將 bacpac 匯入新的資料庫。

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

URI 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string	包含資源的資源群組名稱。您可以從 Azure Resource Manager API 或入口網站取得此值。
serverName	path	True	string	伺服器的名稱。
subscriptionId	path	True	string	識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	必要	類型	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	匯入資料庫的服務等級目標名稱。

回應

名稱	類型	Description
200 OK	ImportExportOperationResult	已成功匯入資料庫。
202 Accepted		匯入資料庫正在進行中。標題 Location: string
Other Status Codes	ErrorResponse	錯誤回應： *** 400 MissingImportExportInputParameters - 遺漏 ImportExport 輸入參數。 400 InvalidImportExportInputParameter - 匯入/導出要求因輸入參數無效而失敗。 400 PolybaseImportAuthenticationTypeNotSupported - PolybaseImport 作業不支持驗證類型參數。 400 DatabaseExtensionsInvalidOperationMode - 資料庫延伸模組的 operationMode 參數無效。 400 DatabaseExtensionsInvalidStorageKeyType - 記憶體密鑰類型必須由 'StorageAccessKey' 使用。 400 DatabaseExtensionsMissingStorageUri - 記憶體 URI 不可以是空的。 400 SQLPasswordSpecifiedWithManagedIdentity - 如果 authenticationType 為 ManagedIdentity，則不應該指定 administratorLoginPassword。 400 InvalidSqlAuthType - ImportExport 作業失敗，因為 sql 驗證類型無效 400 BlobAlreadyExist - ImportExport 作業失敗，因為記憶體 Blob 已經存在 400 InvalidImportExportOperationResourceLocks - 匯入/導出要求因 Private Link 資源的鎖定而無效。 400 DatabaseInvalidSkuPropertyCombination - 要求 SKU 的屬性不一致。請檢查是否已指定有效的組合。如需詳細資訊，請參閱 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability。 400 ImportExportJobError - ImportExport 作業失敗。 400 BlockedByOutboundFirewall - 輸出防火牆規則封鎖要求。 400 InvalidOperationType - 提供有效的作業類型。 400 InvalidMaxSizeTierCombination - 指定的層不支援指定的資料庫大小上限。 400 InvalidTier - 使用者指定了無效的階層。 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。 400 InvalidImportExportParameter - 匯入/匯出要求因輸入參數無效而失敗。 400 InvalidSku - 使用者指定了無效的 SKU。 400 InvalidTierSkuCombination - 指定的層不支援指定的 SKU。 400 InvalidImportExportStorageCredentials - 匯入/導出作業因記憶體認證無效而失敗 400 InvalidImportExportStorageAuthType - 匯入/導出作業失敗，因為記憶體驗證類型無效 400 InvalidImportExportStorageKeyFormat - 匯入/導出作業失敗，因為記憶體密鑰格式無效 400 LongImportExportStorageUri - 匯入/匯出作業因記憶體 URI 長而失敗 400 LargeExportDatabaseSize - 匯出作業失敗，因為資料庫大於支援的大小上限 400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本已停用的功能。 400 UnSupportedImportExportEdition - ImportExport 作業失敗，因為它的目標是無效的版本 400 InvalidImportExportStorageURI - ImportExport 作業失敗，因為記憶體 URI 無效 404 DatabaseDoesNotExist - 使用者已指定此伺服器實例上不存在的資料庫名稱。 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ResourceNotFound - 指定不存在資源的要求無效。 404 ImportExportOperationIdNotFound - 找不到匯入或導出的作業標識符。 404 OperationIdNotFound - 標識符為的作業不存在。 409 ImportExportOperationInProgress - 資料庫上有匯入或導出作業進行中。 409 CannotCancelOperation - 管理作業處於無法取消的狀態。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為相同資源上的另一個作業中斷。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。 500 OperationTimedOut - 作業逾時並自動回復。請重試作業。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

名稱

類型

Description

200 OK

ImportExportOperationResult

已成功匯入資料庫。

202 Accepted

匯入資料庫正在進行中。

標題

Location: string

Other Status Codes

ErrorResponse

錯誤回應： ***

400 MissingImportExportInputParameters - 遺漏 ImportExport 輸入參數。
400 InvalidImportExportInputParameter - 匯入/導出要求因輸入參數無效而失敗。
400 PolybaseImportAuthenticationTypeNotSupported - PolybaseImport 作業不支持驗證類型參數。
400 DatabaseExtensionsInvalidOperationMode - 資料庫延伸模組的 operationMode 參數無效。
400 DatabaseExtensionsInvalidStorageKeyType - 記憶體密鑰類型必須由 'StorageAccessKey' 使用。
400 DatabaseExtensionsMissingStorageUri - 記憶體 URI 不可以是空的。
400 SQLPasswordSpecifiedWithManagedIdentity - 如果 authenticationType 為 ManagedIdentity，則不應該指定 administratorLoginPassword。
400 InvalidSqlAuthType - ImportExport 作業失敗，因為 sql 驗證類型無效
400 BlobAlreadyExist - ImportExport 作業失敗，因為記憶體 Blob 已經存在
400 InvalidImportExportOperationResourceLocks - 匯入/導出要求因 Private Link 資源的鎖定而無效。
400 DatabaseInvalidSkuPropertyCombination - 要求 SKU 的屬性不一致。請檢查是否已指定有效的組合。如需詳細資訊，請參閱 https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability。
400 ImportExportJobError - ImportExport 作業失敗。
400 BlockedByOutboundFirewall - 輸出防火牆規則封鎖要求。
400 InvalidOperationType - 提供有效的作業類型。
400 InvalidMaxSizeTierCombination - 指定的層不支援指定的資料庫大小上限。
400 InvalidTier - 使用者指定了無效的階層。
400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。
400 InvalidImportExportParameter - 匯入/匯出要求因輸入參數無效而失敗。
400 InvalidSku - 使用者指定了無效的 SKU。
400 InvalidTierSkuCombination - 指定的層不支援指定的 SKU。
400 InvalidImportExportStorageCredentials - 匯入/導出作業因記憶體認證無效而失敗
400 InvalidImportExportStorageAuthType - 匯入/導出作業失敗，因為記憶體驗證類型無效
400 InvalidImportExportStorageKeyFormat - 匯入/導出作業失敗，因為記憶體密鑰格式無效
400 LongImportExportStorageUri - 匯入/匯出作業因記憶體 URI 長而失敗
400 LargeExportDatabaseSize - 匯出作業失敗，因為資料庫大於支援的大小上限
400 FeatureDisabledOnSelectedEdition - 用戶嘗試使用目前資料庫版本已停用的功能。
400 UnSupportedImportExportEdition - ImportExport 作業失敗，因為它的目標是無效的版本
400 InvalidImportExportStorageURI - ImportExport 作業失敗，因為記憶體 URI 無效
404 DatabaseDoesNotExist - 使用者已指定此伺服器實例上不存在的資料庫名稱。
404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。
404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。
404 ResourceNotFound - 指定不存在資源的要求無效。
404 ImportExportOperationIdNotFound - 找不到匯入或導出的作業標識符。
404 OperationIdNotFound - 標識符為的作業不存在。
409 ImportExportOperationInProgress - 資料庫上有匯入或導出作業進行中。
409 CannotCancelOperation - 管理作業處於無法取消的狀態。
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=2023-08-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"
  }
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ImportNewDatabaseWithNetworkIsolation.json
// this example is just showing the usage of "Servers_ImportDatabase" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// invoke the operation
DatabaseImportDefinition databaseImportDefinition = new DatabaseImportDefinition(StorageKeyType.StorageAccessKey, "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==", new Uri("https://test.blob.core.windows.net/test.bacpac"), "login", "password")
{
    DatabaseName = "testdb",
    AuthenticationType = "Sql",
    NetworkIsolation = new NetworkIsolationSettings
    {
        StorageAccountResourceId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Storage/storageAccounts/test-privatelink"),
        SqlServerResourceId = new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr"),
    },
};
ArmOperation<ImportExportOperationResult> lro = await sqlServer.ImportDatabaseAsync(WaitUntil.Completed, databaseImportDefinition);
ImportExportOperationResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

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

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

範例要求

HTTP
dotnet

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

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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ImportNewDatabase.json
// this example is just showing the usage of "Servers_ImportDatabase" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerResource created on azure
// for more information of creating SqlServerResource, please refer to the document of SqlServerResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default-SQL-SouthEastAsia";
string serverName = "testsvr";
ResourceIdentifier sqlServerResourceId = SqlServerResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName);
SqlServerResource sqlServer = client.GetSqlServerResource(sqlServerResourceId);

// invoke the operation
DatabaseImportDefinition databaseImportDefinition = new DatabaseImportDefinition(StorageKeyType.StorageAccessKey, "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx==", new Uri("https://test.blob.core.windows.net/test.bacpac"), "login", "password")
{
    DatabaseName = "testdb",
    AuthenticationType = "Sql",
};
ArmOperation<ImportExportOperationResult> lro = await sqlServer.ImportDatabaseAsync(WaitUntil.Completed, databaseImportDefinition);
ImportExportOperationResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

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

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

定義

名稱	Description
ErrorAdditionalInfo	資源管理錯誤其他資訊。
ErrorDetail	錯誤詳細數據。
ErrorResponse	錯誤回應
ImportExportOperationResult	ImportExport 作業結果資源。
ImportNewDatabaseDefinition	包含執行新資料庫匯入作業所需的資訊。
NetworkIsolationSettings	包含用來建立私人端點連線的 ARM 資源。
PrivateEndpointConnectionRequestStatus	包含私人端點連線要求狀態。
StorageKeyType	儲存器金鑰類型。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱	類型	Description
info	object	其他資訊。
type	string	其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱	類型	Description
additionalInfo	ErrorAdditionalInfo[]	錯誤其他資訊。
code	string	錯誤碼。
details	ErrorDetail[]	錯誤詳細數據。
message	string	錯誤訊息。
target	string	錯誤目標。

ErrorResponse

Object

錯誤回應

名稱	類型	Description
error	ErrorDetail	error 物件。

ImportExportOperationResult

Object

ImportExport 作業結果資源。

名稱	類型	Description
id	string	資源標識碼。
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 (uuid)	要求標識碼。
properties.requestType	string	要求類型。
properties.serverName	string	伺服器名稱。
properties.status	string	作業狀態。
type	string	資源類型。

ImportNewDatabaseDefinition

Object

包含執行新資料庫匯入作業所需的資訊。

名稱	類型	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

Object

包含用來建立私人端點連線的 ARM 資源。

名稱	類型	Description
sqlServerResourceId	string (arm-id)	SQL Server 的資源標識碼，這是此要求的目標。如果設定，將會為 SQL Server 建立私人端點連線。必須符合作業目標的伺服器。
storageAccountResourceId	string (arm-id)	用來儲存 BACPAC 檔案之記憶體帳戶的資源識別碼。如果設定，將會為記憶體帳戶建立私人端點連線。必須符合 StorageUri 參數所使用的記憶體帳戶。

PrivateEndpointConnectionRequestStatus

Object

包含私人端點連線要求狀態。

名稱	類型	Description
privateEndpointConnectionName	string	私人端點的連接名稱。
privateLinkServiceId	string	建立私人端點的資源標識碼。
status	string	此私人端點連線的狀態。

StorageKeyType

列舉型別

儲存器金鑰類型。

值	Description
SharedAccessKey
StorageAccessKey

共用方式為

Servers - Import Database

URI 參數

要求本文

回應

範例

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

範例要求

範例回覆

Imports to a new database.

範例要求

範例回覆

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType