Servers - Import Database

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.

Örnekler

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

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=2021-11-01

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

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