Servers - Import Database

Mengimpor bacpac ke dalam database baru.

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

Parameter URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nama grup sumber daya yang berisi sumber daya. Anda dapat memperoleh nilai ini dari Azure Resource Manager API 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 digunakan untuk permintaan.

Isi Permintaan

Name Required Type Description
administratorLogin True
  • string

Nama masuk administrator.

administratorLoginPassword True
  • string

Kata sandi masuk administrator.

storageKey True
  • string

Kunci penyimpanan.

storageKeyType True

Jenis kunci penyimpanan.

storageUri True
  • string

Uri Penyimpanan.

authenticationType
  • string

Jenis autentikasi.

databaseName
  • string

Nama database impor.

edition
  • string

Edisi database impor.

maxSizeBytes
  • string

Ukuran maksimum dalam byte untuk database impor.

networkIsolation

Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.

serviceObjectiveName
  • string

Nama tujuan tingkat layanan dari database impor.

Respons

Name Type Description
200 OK

Berhasil mengimpor database.

202 Accepted

Mengimpor database sedang berlangsung.

Other Status Codes

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 mendukung operasi PolybaseImport.

  • 400 DatabaseExtensionsInvalidOperationMode - Parameter operationMode tidak valid untuk ekstensi database.

  • 400 DatabaseExtensionsInvalidStorageKeyType - Jenis kunci penyimpanan harus berdasarkan 'StorageAccessKey'.

  • 400 DatabaseExtensionsMissingStorageUri - URI Penyimpanan tidak boleh kosong.

  • 400 InvalidSku - Pengguna menentukan sku yang tidak valid.

  • 400 InvalidTierSkuCombination - Tingkat yang ditentukan tidak mendukung sku yang ditentukan.

  • 400 DatabaseInvalidSkuPropertyCombination - Properti sku yang diminta tidak konsisten. Silakan periksa apakah kombinasi yang valid ditentukan. Lihat https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability untuk detail selengkapnya.

  • 400 InvalidMaxSizeTierCombination - Tingkat yang ditentukan tidak mendukung ukuran maksimum database yang ditentukan.

  • 400 FeatureDisabledOnSelectedEdition - Pengguna mencoba menggunakan fitur yang dinonaktifkan pada edisi database saat ini.

  • 400 InvalidImportExportParameter - Permintaan Impor/Ekspor gagal karena parameter input yang tidak valid.

  • 400 InvalidTier - Pengguna menentukan tingkat yang tidak valid.

  • 400 InvalidOperationType - Menyediakan jenis operasi yang valid.

  • 400 ImportExportJobError - Operasi ImportExport gagal.

  • 400 BlockedByOutboundFirewall - Aturan firewall keluar memblokir permintaan.

  • 404 ResourceNotFound - Permintaan tidak valid yang menentukan sumber daya yang tidak ada.

  • 404 ServerNotInSubscriptionResourceGroup - Server yang ditentukan tidak ada di grup sumber daya dan langganan yang ditentukan.

  • 404 ImportExportOperationIdNotFound - Id operasi untuk impor atau ekspor tidak dapat ditemukan.

  • 404 ServerNotInSubscription - Server yang ditentukan tidak ada pada langganan yang ditentukan.

  • 409 ImportExportOperationInProgress - Ada operasi impor atau ekspor yang sedang berlangsung pada database.

Contoh

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

Sample Request

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

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

Sample Response

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

Imports to a new database.

Sample Request

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

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

Sample Response

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

Definisi

ImportExportOperationResult

Sumber daya hasil operasi ImportExport.

ImportNewDatabaseDefinition

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

NetworkIsolationSettings

Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.

PrivateEndpointConnectionRequestStatus

Berisi status permintaan koneksi titik akhir privat.

StorageKeyType

Jenis kunci penyimpanan.

ImportExportOperationResult

Sumber daya hasil operasi ImportExport.

Name Type Description
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

Mendapatkan status titik akhir privat yang terkait dengan permintaan ini.

properties.queuedTime
  • string

Waktu antrean.

properties.requestId
  • string

Id Permintaan.

properties.requestType
  • string

Jenis permintaan.

properties.serverName
  • string

Nama server.

properties.status
  • string

Status operasi.

type
  • string

Jenis sumber daya

ImportNewDatabaseDefinition

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

Name Type Description
administratorLogin
  • string

Nama masuk administrator.

administratorLoginPassword
  • string

Kata sandi masuk administrator.

authenticationType
  • string

Jenis autentikasi.

databaseName
  • string

Nama database impor.

edition
  • string

Edisi database impor.

maxSizeBytes
  • string

Ukuran maksimum dalam byte untuk database impor.

networkIsolation

Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.

serviceObjectiveName
  • string

Nama tujuan tingkat layanan dari database impor.

storageKey
  • string

Kunci penyimpanan.

storageKeyType

Jenis kunci penyimpanan.

storageUri
  • string

Uri Penyimpanan.

NetworkIsolationSettings

Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.

Name Type Description
sqlServerResourceId
  • string

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

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

Berisi status permintaan koneksi titik akhir privat.

Name Type Description
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

Jenis kunci penyimpanan.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string