Servers - Import Database

Referensi

Service:: SQL Database

API Version:: 2021-11-01

Mengimpor bacpac ke dalam database baru.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
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

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.
databaseName		string	Nama database impor.
edition		string	Edisi database impor.
maxSizeBytes		string	Ukuran maksimum dalam byte untuk database impor.
networkIsolation		NetworkIsolationSettings	Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.
serviceObjectiveName		string	Nama tujuan tingkat layanan dari database impor.

Respons

Nama	Jenis	Deskripsi
200 OK	ImportExportOperationResult	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 didukung untuk 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. 404 OperationIdNotFound - Operasi dengan Id tidak ada. 409 ImportExportOperationInProgress - Ada operasi impor atau ekspor yang sedang berlangsung pada database. 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.

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 didukung untuk 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.
404 OperationIdNotFound - Operasi dengan Id tidak ada.
409 ImportExportOperationInProgress - Ada operasi impor atau ekspor yang sedang berlangsung pada database.
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 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

Definisi

Nama	Deskripsi
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.

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	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.

Nama	Jenis	Deskripsi
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	NetworkIsolationSettings	Informasi sumber daya opsional untuk mengaktifkan isolasi jaringan untuk permintaan.
serviceObjectiveName	string	Nama tujuan tingkat layanan dari database impor.
storageKey	string	Kunci penyimpanan.
storageKeyType	StorageKeyType	Jenis kunci penyimpanan.
storageUri	string	Uri Penyimpanan.

NetworkIsolationSettings

Berisi sumber daya ARM untuk membuat koneksi titik akhir privat.

Nama	Jenis	Deskripsi
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.

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

Jenis kunci penyimpanan.

Nama	Jenis	Deskripsi
SharedAccessKey	string
StorageAccessKey	string

Servers - Import Database

Parameter URI

Isi Permintaan

Respons

Contoh

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

Definisi

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Sumber Daya Tambahan: