Servers - Import Database

Başvuru

Hizmet:: SQL Database

API Sürümü:: 2021-11-01

Bir bacpac'i yeni bir veritabanına aktarır.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string	Kaynağı içeren kaynak grubunun adı. Bu değeri Azure Resource Manager API'sinden veya portaldan alabilirsiniz.
serverName	path	True	string	Sunucunun adı.
subscriptionId	path	True	string	Azure aboneliğini tanımlayan abonelik kimliği.
api-version	query	True	string	İstek için kullanılacak API sürümü.

İstek Gövdesi

Name	Gerekli	Tür	Description
administratorLogin	True	string	Yönetici oturum açma adı.
administratorLoginPassword	True	string	Yönetici oturum açma parolası.
storageKey	True	string	Depolama anahtarı.
storageKeyType	True	StorageKeyType	Depolama anahtarı türü.
storageUri	True	string	Depolama Uri'si.
authenticationType		string	Kimlik doğrulama türü.
databaseName		string	İçeri aktarma veritabanının adı.
edition		string	İçeri aktarma veritabanının sürümü.
maxSizeBytes		string	İçeri aktarma veritabanı için bayt cinsinden en büyük boyut.
networkIsolation		NetworkIsolationSettings	İstek için ağ yalıtımını etkinleştirmek için isteğe bağlı kaynak bilgileri.
serviceObjectiveName		string	İçeri aktarma veritabanının hizmet düzeyi hedef adı.

Yanıtlar

Name	Tür	Description
200 OK	ImportExportOperationResult	Veritabanı başarıyla içeri aktarıldı.
202 Accepted		Veritabanını içeri aktarma işlemi devam ediyor.
Other Status Codes		Hata Yanıtları: *** 400 MissingImportExportInputParameters - ImportExport giriş parametreleri eksik. 400 InvalidImportExportInputParameter - İçeri/dışarı aktarma isteği geçersiz bir giriş parametresi nedeniyle başarısız oldu. 400 PolybaseImportAuthenticationTypeNotSupported - Kimlik doğrulama türü parametresi PolybaseImport işlemini desteklemiyor. 400 DatabaseExtensionsInvalidOperationMode - Veritabanı uzantısı için geçersiz operationMode parametresi. 400 DatabaseExtensionsInvalidStorageKeyType - Depolama anahtarı türü 'StorageAccessKey' ile olmalıdır. 400 DatabaseExtensionsMissingStorageUri - Depolama URI'si boş olamaz. 400 InvalidSku - Kullanıcı geçersiz bir sku belirtti. 400 InvalidTierSkuCombination - Belirtilen katman belirtilen sku'yu desteklemiyor. 400 DatabaseInvalidSkuPropertyCombination - İstenen sku'nun özellikleri tutarsız. Lütfen geçerli bir bileşimin belirtildiğini denetleyin. Diğer ayrıntılar için bkz https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability . 400 InvalidMaxSizeTierCombination - Belirtilen katman belirtilen veritabanı maksimum boyutunu desteklemiyor. 400 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı. 400 InvalidImportExportParameter - İçeri/Dışarı Aktarma isteği geçersiz giriş parametresi nedeniyle başarısız oldu. 400 InvalidTier - Kullanıcı geçersiz bir katman belirtti. 400 InvalidOperationType - Geçerli bir işlem türü sağlayın. 400 ImportExportJobError - ImportExport işlemi başarısız oldu. 400 BlockedByOutboundFirewall - Giden güvenlik duvarı kuralları isteği engelledi. 404 ResourceNotFound - Mevcut olmayan bir kaynağı belirten geçersiz istek. 404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok. 404 ImportExportOperationIdNotFound - İçeri veya dışarı aktarma işlemi kimliği bulunamıyor. 404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok. 404 OperationIdNotFound - Kimlikli işlem yok. 409 ImportExportOperationInProgress - Veritabanında devam eden bir içeri veya dışarı aktarma işlemi var. 409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi. 409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesildiği için kaynak üzerindeki işlem tamamlanamadı. 429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler. 429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler. 500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin. 503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

Name

Tür

Description

200 OK

ImportExportOperationResult

Veritabanı başarıyla içeri aktarıldı.

202 Accepted

Veritabanını içeri aktarma işlemi devam ediyor.

Other Status Codes

Hata Yanıtları: ***

400 MissingImportExportInputParameters - ImportExport giriş parametreleri eksik.
400 InvalidImportExportInputParameter - İçeri/dışarı aktarma isteği geçersiz bir giriş parametresi nedeniyle başarısız oldu.
400 PolybaseImportAuthenticationTypeNotSupported - Kimlik doğrulama türü parametresi PolybaseImport işlemini desteklemiyor.
400 DatabaseExtensionsInvalidOperationMode - Veritabanı uzantısı için geçersiz operationMode parametresi.
400 DatabaseExtensionsInvalidStorageKeyType - Depolama anahtarı türü 'StorageAccessKey' ile olmalıdır.
400 DatabaseExtensionsMissingStorageUri - Depolama URI'si boş olamaz.
400 InvalidSku - Kullanıcı geçersiz bir sku belirtti.
400 InvalidTierSkuCombination - Belirtilen katman belirtilen sku'yu desteklemiyor.
400 DatabaseInvalidSkuPropertyCombination - İstenen sku'nun özellikleri tutarsız. Lütfen geçerli bir bileşimin belirtildiğini denetleyin. Diğer ayrıntılar için bkz https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability .
400 InvalidMaxSizeTierCombination - Belirtilen katman belirtilen veritabanı maksimum boyutunu desteklemiyor.
400 FeatureDisabledOnSelectedEdition - Kullanıcı geçerli veritabanı sürümünde devre dışı bırakılmış bir özelliği kullanmaya çalıştı.
400 InvalidImportExportParameter - İçeri/Dışarı Aktarma isteği geçersiz giriş parametresi nedeniyle başarısız oldu.
400 InvalidTier - Kullanıcı geçersiz bir katman belirtti.
400 InvalidOperationType - Geçerli bir işlem türü sağlayın.
400 ImportExportJobError - ImportExport işlemi başarısız oldu.
400 BlockedByOutboundFirewall - Giden güvenlik duvarı kuralları isteği engelledi.
404 ResourceNotFound - Mevcut olmayan bir kaynağı belirten geçersiz istek.
404 ServerNotInSubscriptionResourceGroup - Belirtilen sunucu belirtilen kaynak grubunda ve abonelikte yok.
404 ImportExportOperationIdNotFound - İçeri veya dışarı aktarma işlemi kimliği bulunamıyor.
404 ServerNotInSubscription - Belirtilen sunucu belirtilen abonelikte yok.
404 OperationIdNotFound - Kimlikli işlem yok.
409 ImportExportOperationInProgress - Veritabanında devam eden bir içeri veya dışarı aktarma işlemi var.
409 OperationCancelled - İşlem kullanıcı tarafından iptal edildi.
409 İşlem Kesildi - Aynı kaynakta başka bir işlem tarafından kesildiği için kaynak üzerindeki işlem tamamlanamadı.
429 SubscriptionTooManyCreateUpdateRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.
429 SubscriptionTooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.
500 OperationTimedOut - İşlem zaman aşımına uğradı ve otomatik olarak geri alındı. Lütfen işlemi yeniden deneyin.
503 TooManyRequests - Kullanılabilir kaynaklar tarafından işlenebilen maksimum isteklerin ötesindeki istekler.

Örnekler

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.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")),
            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

Örnek yanıt

Durum kodu:: 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"
}

Durum kodu:: 202

Imports to a new database.

Örnek isteği

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.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"),
            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

Örnek yanıt

Durum kodu:: 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"
}

Durum kodu:: 202

Tanımlar

Name	Description
ImportExportOperationResult	ImportExport işlemi sonuç kaynağı.
ImportNewDatabaseDefinition	Yeni veritabanı için içeri aktarma işlemini gerçekleştirmek için gereken bilgileri içerir.
NetworkIsolationSettings	Özel uç nokta bağlantısının oluşturulacağı ARM kaynaklarını içerir.
PrivateEndpointConnectionRequestStatus	Özel uç nokta bağlantı istekleri durumunu içerir.
StorageKeyType	Depolama anahtarı türü.

ImportExportOperationResult

ImportExport işlemi sonuç kaynağı.

Name	Tür	Description
id	string	Kaynak Kimliği.
name	string	Kaynak adı.
properties.blobUri	string	Blob Uri'si.
properties.databaseName	string	Veritabanı adı.
properties.errorMessage	string	Hata iletisi.
properties.lastModifiedTime	string	Son değiştirme zamanı.
properties.privateEndpointConnections	PrivateEndpointConnectionRequestStatus[]	Bu istekle ilişkili özel uç noktaların durumunu alır.
properties.queuedTime	string	Kuyruğa alınan süre.
properties.requestId	string	İstek Kimliği.
properties.requestType	string	İstek türü.
properties.serverName	string	Sunucunun adı.
properties.status	string	İşlem durumu.
type	string	Kaynak türü.

ImportNewDatabaseDefinition

Yeni veritabanı için içeri aktarma işlemini gerçekleştirmek için gereken bilgileri içerir.

Name	Tür	Description
administratorLogin	string	Yönetici oturum açma adı.
administratorLoginPassword	string	Yönetici oturum açma parolası.
authenticationType	string	Kimlik doğrulama türü.
databaseName	string	İçeri aktarma veritabanının adı.
edition	string	İçeri aktarma veritabanının sürümü.
maxSizeBytes	string	İçeri aktarma veritabanı için bayt cinsinden en büyük boyut.
networkIsolation	NetworkIsolationSettings	İstek için ağ yalıtımını etkinleştirmek için isteğe bağlı kaynak bilgileri.
serviceObjectiveName	string	İçeri aktarma veritabanının hizmet düzeyi hedef adı.
storageKey	string	Depolama anahtarı.
storageKeyType	StorageKeyType	Depolama anahtarı türü.
storageUri	string	Depolama Uri'si.

NetworkIsolationSettings

Özel uç nokta bağlantısının oluşturulacağı ARM kaynaklarını içerir.

Name	Tür	Description
sqlServerResourceId	string	Bu isteğin hedefi olan SQL sunucusunun kaynak kimliği. Ayarlanırsa, SQL sunucusu için özel uç nokta bağlantısı oluşturulur. İşlemin hedefi olan sunucuyla eşleşmelidir.
storageAccountResourceId	string	BACPAC dosyasını depolamak için kullanılan depolama hesabının kaynak kimliği. Ayarlanırsa, depolama hesabı için özel uç nokta bağlantısı oluşturulur. StorageUri parametresi için kullanılan depolama hesabıyla eşleşmelidir.

PrivateEndpointConnectionRequestStatus

Özel uç nokta bağlantı istekleri durumunu içerir.

Name	Tür	Description
privateEndpointConnectionName	string	Özel uç noktanın bağlantı adı.
privateLinkServiceId	string	Özel uç noktanın oluşturulduğu kaynak kimliği.
status	string	Bu özel uç nokta bağlantısının durumu.

StorageKeyType

Depolama anahtarı türü.

Name	Tür	Description
SharedAccessKey	string
StorageAccessKey	string

Aracılığıyla paylaş

Servers - Import Database

URI Parametreleri

İstek Gövdesi

Yanıtlar

Örnekler

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

Örnek isteği

Örnek yanıt

Imports to a new database.

Örnek isteği

Örnek yanıt

Tanımlar

ImportExportOperationResult

ImportNewDatabaseDefinition

NetworkIsolationSettings

PrivateEndpointConnectionRequestStatus

StorageKeyType

Ek kaynaklar