Databases - Import

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

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

URI Parametreleri

Name In Required Type Description
databaseName
path True
  • string

Veritabanının adı.

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 Required Type 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

Depolama anahtar türü.

storageUri True
  • string

Depolama Uri.

authenticationType
  • string

Kimlik doğrulama türü.

networkIsolation

İstek için ağ yalıtımını etkinleştirmek için isteğe bağlı kaynak bilgileri.

Yanıtlar

Name Type Description
200 OK

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 boş olamaz.

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

  • 409 ImportExportOperationInProgress - Veritabanında devam eden bir içeri veya dışarı aktarma işlemi var.

Örnekler

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

Sample Request

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=2021-08-01-preview

{
  "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 an existing empty database.

Sample Request

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=2021-08-01-preview

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

Tanımlar

ImportExistingDatabaseDefinition

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

ImportExportOperationResult

ImportExport işlemi sonuç kaynağı.

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

ImportExistingDatabaseDefinition

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

Name Type Description
administratorLogin
  • string

Yönetici oturum açma adı.

administratorLoginPassword
  • string

Yönetici oturum açma parolası.

authenticationType
  • string

Kimlik doğrulama türü.

networkIsolation

İstek için ağ yalıtımını etkinleştirmek için isteğe bağlı kaynak bilgileri.

storageKey
  • string

Depolama anahtarı.

storageKeyType

Depolama anahtar türü.

storageUri
  • string

Depolama Uri.

ImportExportOperationResult

ImportExport işlemi sonuç kaynağı.

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

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

NetworkIsolationSettings

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

Name Type 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 Type 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 Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string