Databases - Import

Layanan:: SQL Database

Versi API:: 2023-08-01

Mengimpor bacpac ke database baru.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
databaseName	path	True	string	Nama database.
resourceGroupName	path	True	string	Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari API Azure Resource Manager atau portal.
serverName	path	True	string	Nama server.
subscriptionId	path	True	string	ID langganan yang mengidentifikasi langganan Azure.
api-version	query	True	string	Versi API yang akan digunakan untuk permintaan tersebut.

Isi Permintaan

Nama	Diperlukan	Jenis	Deskripsi
administratorLogin	True	string	Nama masuk administrator.
administratorLoginPassword	True	string	Kata sandi masuk administrator.
storageKey	True	string	Kunci penyimpanan.
storageKeyType	True	StorageKeyType	Jenis kunci penyimpanan.
storageUri	True	string	Uri Penyimpanan.
authenticationType		string	Jenis autentikasi.
networkIsolation		NetworkIsolationSettings	Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.

Respons

Nama	Jenis	Deskripsi
200 OK	ImportExportOperationResult	Berhasil mengimpor database.
202 Accepted		Mengimpor database sedang berlangsung. Header Location: string
Other Status Codes	ErrorResponse	Respons Kesalahan: *** 400 MissingImportExportInputParameters - Parameter input ImportExport hilang. 400 InvalidImportExportInputParameter - Permintaan impor/ekspor gagal karena parameter input yang tidak valid. 400 PolybaseImportAuthenticationTypeNotSupported - Parameter jenis autentikasi tidak didukung untuk operasi PolybaseImport. 400 DatabaseExtensionsInvalidOperationMode - Parameter operationMode tidak valid untuk ekstensi database. 400 DatabaseExtensionsInvalidStorageKeyType - Jenis kunci penyimpanan harus oleh 'StorageAccessKey'. 400 DatabaseExtensionsMissingStorageUri - URI Penyimpanan tidak boleh kosong. 400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword tidak boleh ditentukan jika authenticationType adalah ManagedIdentity. 400 InvalidSqlAuthType - Operasi ImportExport gagal karena jenis autentikasi sql tidak valid 400 BlobAlreadyExist - Operasi ImportExport gagal karena blob penyimpanan sudah ada 400 InvalidImportExportOperationResourceLocks - Permintaan Impor/Ekspor tidak valid karena kunci pada sumber daya Private Link. 400 DatabaseInvalidSkuPropertyCombination - Properti sku yang diminta tidak konsisten. Harap periksa apakah kombinasi yang valid ditentukan. Lihat https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability untuk detail selengkapnya. 400 ImportExportJobError - Operasi ImportExport telah gagal. 400 BlockedByOutboundFirewall - Aturan firewall keluar memblokir permintaan. 400 InvalidOperationType - Menyediakan jenis operasi yang valid. 400 InvalidMaxSizeTierCombination - Tingkat yang ditentukan tidak mendukung ukuran maksimum database yang ditentukan. 400 InvalidTier - Pengguna menentukan tingkat yang tidak valid. 400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini. 400 InvalidImportExportParameter - Permintaan Impor/Ekspor gagal karena parameter input yang tidak valid. 400 InvalidSku - Pengguna menentukan sku yang tidak valid. 400 InvalidTierSkuCombination - Tingkat yang ditentukan tidak mendukung sku yang ditentukan. 400 InvalidImportExportStorageCredentials - Operasi Impor/Ekspor gagal karena kredensial penyimpanan yang tidak valid 400 InvalidImportExportStorageAuthType - Operasi Impor/Ekspor gagal karena jenis autentikasi penyimpanan yang tidak valid 400 InvalidImportExportStorageKeyFormat - Operasi Impor/Ekspor gagal karena format kunci penyimpanan tidak valid 400 LongImportExportStorageUri - Operasi Impor/Ekspor gagal karena URI penyimpanan yang panjang 400 LargeExportDatabaseSize - Operasi ekspor gagal karena database lebih besar dari ukuran maksimum yang didukung 400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini. 400 UnSupportedImportExportEdition - Operasi ImportExport gagal karena menargetkan edisi yang tidak valid 400 InvalidImportExportStorageURI - Operasi ImportExport gagal karena URI penyimpanan tidak valid 404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini. 404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan. 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan. 404 ResourceNotFound - Permintaan yang tidak valid menentukan sumber daya yang tidak ada. 404 ImportExportOperationIdNotFound - Id operasi untuk impor atau ekspor tidak dapat ditemukan. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 ImportExportOperationInProgress - Ada operasi impor atau ekspor yang sedang berlangsung pada database. 409 CannotCancelOperation - Operasi manajemen dalam keadaan yang tidak dapat dibatalkan. 409 OperationCancelled - Operasi telah dibatalkan oleh pengguna. 409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama. 429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia. 500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini. 503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Nama

Jenis

Deskripsi

200 OK

ImportExportOperationResult

Berhasil mengimpor database.

202 Accepted

Mengimpor database sedang berlangsung.

Header

Location: string

Other Status Codes

ErrorResponse

Respons Kesalahan: ***

400 MissingImportExportInputParameters - Parameter input ImportExport hilang.
400 InvalidImportExportInputParameter - Permintaan impor/ekspor gagal karena parameter input yang tidak valid.
400 PolybaseImportAuthenticationTypeNotSupported - Parameter jenis autentikasi tidak didukung untuk operasi PolybaseImport.
400 DatabaseExtensionsInvalidOperationMode - Parameter operationMode tidak valid untuk ekstensi database.
400 DatabaseExtensionsInvalidStorageKeyType - Jenis kunci penyimpanan harus oleh 'StorageAccessKey'.
400 DatabaseExtensionsMissingStorageUri - URI Penyimpanan tidak boleh kosong.
400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword tidak boleh ditentukan jika authenticationType adalah ManagedIdentity.
400 InvalidSqlAuthType - Operasi ImportExport gagal karena jenis autentikasi sql tidak valid
400 BlobAlreadyExist - Operasi ImportExport gagal karena blob penyimpanan sudah ada
400 InvalidImportExportOperationResourceLocks - Permintaan Impor/Ekspor tidak valid karena kunci pada sumber daya Private Link.
400 DatabaseInvalidSkuPropertyCombination - Properti sku yang diminta tidak konsisten. Harap periksa apakah kombinasi yang valid ditentukan. Lihat https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability untuk detail selengkapnya.
400 ImportExportJobError - Operasi ImportExport telah gagal.
400 BlockedByOutboundFirewall - Aturan firewall keluar memblokir permintaan.
400 InvalidOperationType - Menyediakan jenis operasi yang valid.
400 InvalidMaxSizeTierCombination - Tingkat yang ditentukan tidak mendukung ukuran maksimum database yang ditentukan.
400 InvalidTier - Pengguna menentukan tingkat yang tidak valid.
400 CannotUseReservedDatabaseName - Tidak dapat menggunakan nama database yang dipesan dalam operasi ini.
400 InvalidImportExportParameter - Permintaan Impor/Ekspor gagal karena parameter input yang tidak valid.
400 InvalidSku - Pengguna menentukan sku yang tidak valid.
400 InvalidTierSkuCombination - Tingkat yang ditentukan tidak mendukung sku yang ditentukan.
400 InvalidImportExportStorageCredentials - Operasi Impor/Ekspor gagal karena kredensial penyimpanan yang tidak valid
400 InvalidImportExportStorageAuthType - Operasi Impor/Ekspor gagal karena jenis autentikasi penyimpanan yang tidak valid
400 InvalidImportExportStorageKeyFormat - Operasi Impor/Ekspor gagal karena format kunci penyimpanan tidak valid
400 LongImportExportStorageUri - Operasi Impor/Ekspor gagal karena URI penyimpanan yang panjang
400 LargeExportDatabaseSize - Operasi ekspor gagal karena database lebih besar dari ukuran maksimum yang didukung
400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini.
400 UnSupportedImportExportEdition - Operasi ImportExport gagal karena menargetkan edisi yang tidak valid
400 InvalidImportExportStorageURI - Operasi ImportExport gagal karena URI penyimpanan tidak valid
404 DatabaseDoesNotExist - Pengguna telah menentukan nama database yang tidak ada pada instans server ini.
404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan.
404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.
404 ResourceNotFound - Permintaan yang tidak valid menentukan sumber daya yang tidak ada.
404 ImportExportOperationIdNotFound - Id operasi untuk impor atau ekspor tidak dapat ditemukan.
404 OperationIdNotFound - Operasi dengan Id tidak ada.
409 ImportExportOperationInProgress - Ada operasi impor atau ekspor yang sedang berlangsung pada database.
409 CannotCancelOperation - Operasi manajemen dalam keadaan yang tidak dapat dibatalkan.
409 OperationCancelled - Operasi telah dibatalkan oleh pengguna.
409 OperationInterrupted - Operasi pada sumber daya tidak dapat diselesaikan karena terganggu oleh operasi lain pada sumber daya yang sama.
429 SubscriptionTooManyCreateUpdateRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.
429 SubscriptionTooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.
500 OperationTimedOut - Waktu operasi habis dan secara otomatis digulung balik. Silakan coba lagi operasi ini.
503 TooManyRequests - Permintaan di luar permintaan maks yang dapat diproses oleh sumber daya yang tersedia.

Contoh

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.

Permintaan sampel

HTTP

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=2023-08-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"
  }
}

Respon sampel

Kode status:: 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"
}

Kode status:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000

Imports to an existing empty database.

Permintaan sampel

HTTP

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=2023-08-01

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

Respon sampel

Kode status:: 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"
}

Kode status:: 202

Location: /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000

Definisi

Nama	Deskripsi
ErrorAdditionalInfo	Info tambahan kesalahan manajemen sumber daya.
ErrorDetail	Detail kesalahan.
ErrorResponse	Respons kesalahan
ImportExistingDatabaseDefinition	Berisi informasi yang diperlukan untuk melakukan operasi impor untuk database yang ada.
ImportExportOperationResult	Sumber daya hasil operasi ImportExport.
NetworkIsolationSettings	Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.
PrivateEndpointConnectionRequestStatus	Berisi status permintaan koneksi titik akhir privat.
StorageKeyType	Jenis kunci penyimpanan.

ErrorAdditionalInfo

Objek

Info tambahan kesalahan manajemen sumber daya.

Nama	Jenis	Deskripsi
info	object	Info tambahan.
type	string	Jenis info tambahan.

ErrorDetail

Objek

Detail kesalahan.

Nama	Jenis	Deskripsi
additionalInfo	ErrorAdditionalInfo[]	Info tambahan kesalahan.
code	string	Kode kesalahan.
details	ErrorDetail[]	Detail kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan.

ErrorResponse

Objek

Respons kesalahan

Nama	Jenis	Deskripsi
error	ErrorDetail	Objek kesalahan.

ImportExistingDatabaseDefinition

Objek

Berisi informasi yang diperlukan untuk melakukan operasi impor untuk database yang ada.

Nama	Jenis	Deskripsi
administratorLogin	string	Nama masuk administrator.
administratorLoginPassword	string	Kata sandi masuk administrator.
authenticationType	string	Jenis autentikasi.
networkIsolation	NetworkIsolationSettings	Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.
storageKey	string	Kunci penyimpanan.
storageKeyType	StorageKeyType	Jenis kunci penyimpanan.
storageUri	string	Uri Penyimpanan.

ImportExportOperationResult

Objek

Sumber daya hasil operasi ImportExport.

Nama	Jenis	Deskripsi
id	string	ID Sumber Daya.
name	string	Nama sumber daya.
properties.blobUri	string	Uri Blob.
properties.databaseName	string	Nama database.
properties.errorMessage	string	Pesan kesalahan.
properties.lastModifiedTime	string	Waktu terakhir diubah.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Mendapatkan status titik akhir privat yang terkait dengan permintaan ini.
properties.queuedTime	string	Waktu antrean.
properties.requestId	string (uuid)	Id Permintaan.
properties.requestType	string	Jenis permintaan.
properties.serverName	string	Nama server.
properties.status	string	Status operasi.
type	string	Jenis sumber daya.

NetworkIsolationSettings

Objek

Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.

Nama	Jenis	Deskripsi
sqlServerResourceId	string (arm-id)	Id sumber daya untuk server SQL yang merupakan target permintaan ini. Jika diatur, koneksi titik akhir privat akan dibuat untuk server SQL. Harus cocok dengan server yang merupakan target operasi.
storageAccountResourceId	string (arm-id)	Id sumber daya untuk akun penyimpanan yang digunakan untuk menyimpan file BACPAC. Jika diatur, koneksi titik akhir privat akan dibuat untuk akun penyimpanan. Harus cocok dengan akun penyimpanan yang digunakan untuk parameter StorageUri.

PrivateEndpointConnectionRequestStatus

Objek

Berisi status permintaan koneksi titik akhir privat.

Nama	Jenis	Deskripsi
privateEndpointConnectionName	string	Nama koneksi untuk titik akhir privat.
privateLinkServiceId	string	Id sumber daya tempat titik akhir privat dibuat.
status	string	Status koneksi titik akhir privat ini.

StorageKeyType

Enumerasi

Jenis kunci penyimpanan.

Nilai	Deskripsi
SharedAccessKey
StorageAccessKey

Bagikan melalui

Databases - Import

Parameter URI

Isi Permintaan

Respons

Contoh

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

Permintaan sampel

Respon sampel

Imports to an existing empty database.

Permintaan sampel

Respon sampel

Definisi

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ImportExistingDatabaseDefinition

ImportExportOperationResult

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType