Sdílet prostřednictvím


Servers - Import Database

Importuje soubor bacpac do nové databáze.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.

serverName
path True

string

Název serveru.

subscriptionId
path True

string

ID předplatného, které identifikuje předplatné Azure.

api-version
query True

string

Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name Vyžadováno Typ Description
administratorLogin True

string

Přihlašovací jméno správce.

administratorLoginPassword True

string

Přihlašovací heslo správce.

storageKey True

string

Klíč úložiště.

storageKeyType True

StorageKeyType

Typ klíče úložiště.

storageUri True

string

Identifikátor URI úložiště

authenticationType

string

Typ ověřování.

databaseName

string

Název importové databáze.

edition

string

Edice importované databáze.

maxSizeBytes

string

Maximální velikost v bajtech pro databázi importu

networkIsolation

NetworkIsolationSettings

Volitelné informace o prostředcích pro povolení izolace sítě pro požadavek.

serviceObjectiveName

string

Název cíle na úrovni služby databáze importu.

Odpovědi

Name Typ Description
200 OK

ImportExportOperationResult

Databáze byla úspěšně importována.

202 Accepted

Probíhá import databáze.

Hlavičky

Location: string

Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 MissingImportExportInputParameters – Chybí vstupní parametry ImportExport.

  • 400 InvalidImportExportInputParameter – Požadavek na import/export selhal kvůli neplatnému vstupnímu parametru.

  • 400 PolybaseImportAuthenticationTypeNotSupported – Parametr typu ověřování nepodporuje operaci PolybaseImport.

  • 400 DatabaseExtensionsInvalidOperationMode – neplatný parametr operationMode pro rozšíření databáze.

  • 400 DatabaseExtensionsInvalidStorageKeyType – Typ klíče úložiště musí obsahovat StorageAccessKey.

  • 400 DatabaseExtensionsMissingStorageUri – Identifikátor URI úložiště nemůže být prázdný.

  • 400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword by neměl být zadán, pokud authenticationType je ManagedIdentity.

  • 400 InvalidSqlAuthType – Operace ImportExport selhala, protože typ ověřování SQL je neplatný

  • 400 BlobAlreadyExist – Operace ImportExport selhala, protože objekt blob úložiště již existuje.

  • 400 InvalidImportExportOperationResourceLocks – Požadavek na import/export je neplatný kvůli zámkům u prostředků služby Private Link.

  • 400 DatabaseInvalidSkuPropertyCombination – vlastnosti požadované skladové položky jsou nekonzistentní. Zkontrolujte, jestli je zadaná platná kombinace. Další podrobnosti najdete v https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 ImportExportJobError – Operace ImportExport selhala.

  • 400 BlockedByOutboundFirewall – pravidla odchozí brány firewall zablokovala požadavek.

  • 400 InvalidOperationType – Zadejte platný typ operace.

  • 400 InvalidMaxSizeTierCombination – zadaná úroveň nepodporuje zadanou maximální velikost databáze.

  • 400 InvalidTier – Uživatel zadal neplatnou úroveň.

  • 400 CannotUseReservedDatabaseName – V této operaci nelze použít název rezervované databáze.

  • 400 InvalidImportExportParameter – Požadavek importu/exportu selhal kvůli neplatnému vstupnímu parametru.

  • 400 InvalidSku – uživatel zadal neplatnou skladovou položku.

  • 400 InvalidTierSkuCombination – zadaná úroveň nepodporuje zadanou skladovou položku.

  • 400 InvalidImportExportStorageCredentials – Operace importu nebo exportu selhala kvůli neplatným přihlašovacím údajům úložiště

  • 400 InvalidImportExportStorageAuthType – Operace importu nebo exportu selhala kvůli neplatnému typu ověřování úložiště

  • 400 InvalidImportExportStorageKeyFormat – Operace importu nebo exportu selhala kvůli neplatnému formátu klíče úložiště

  • 400 LongImportExportStorageUri – Operace importu nebo exportu selhala kvůli dlouhému identifikátoru URI úložiště

  • 400 LargeExportDatabaseSize – Operace exportu selhala, protože databáze je větší než maximální podporovaná velikost

  • 400 FeatureDisabledOnSelectedEdition – Uživatel se pokusil použít funkci, která je v aktuální edici databáze zakázaná.

  • 400 UnSupportedImportExportEdition – operace ImportExport selhala, protože cílí na neplatnou edici.

  • 400 InvalidImportExportStorageURI – Operace ImportExport selhala, protože identifikátor URI úložiště je neplatný

  • 404 DatabaseDoesNotExist – Uživatel zadal název databáze, který v této instanci serveru neexistuje.

  • 404 ServerNotInSubscription – Zadaný server v zadaném předplatném neexistuje.

  • 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném.

  • 404 ResourceNotFound – Neplatný požadavek určující neexistující prostředek.

  • 404 ImportExportOperationIdNotFound – ID operace pro import nebo export nelze najít.

  • 404 OperationIdNotFound – operace s ID neexistuje.

  • 409 ImportExportOperationInProgress – Probíhá operace importu nebo exportu v databázi.

  • 409 CannotCancelOperation – Operace správy je ve stavu, který nelze zrušit.

  • 409 OperationCancelled - Operace byla zrušena uživatelem.

  • 409 OperationInterrupted – operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací na stejném prostředku.

  • 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

  • 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat.

  • 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky.

Příklady

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

Ukázkový požadavek

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/servers/testsvr/import?api-version=2023-08-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"
  }
}

Ukázková odpověď

{
  "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"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

Ukázkový požadavek

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

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

Ukázková odpověď

{
  "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"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Definice

Name Description
ErrorAdditionalInfo

Další informace o chybě správy prostředků

ErrorDetail

Podrobnosti o chybě.

ErrorResponse

Chybová odpověď

ImportExportOperationResult

Prostředek výsledku operace ImportExport.

ImportNewDatabaseDefinition

Obsahuje informace potřebné k provedení operace importu pro novou databázi.

NetworkIsolationSettings

Obsahuje prostředky ARM, pro které se má vytvořit připojení privátního koncového bodu.

PrivateEndpointConnectionRequestStatus

Obsahuje stav žádostí o připojení privátního koncového bodu.

StorageKeyType

Typ klíče úložiště.

ErrorAdditionalInfo

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.

type

string

Další typ informací.

ErrorDetail

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.

code

string

Kód chyby.

details

ErrorDetail[]

Podrobnosti o chybě.

message

string

Chybová zpráva.

target

string

Cíl chyby.

ErrorResponse

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ImportExportOperationResult

Prostředek výsledku operace ImportExport.

Name Typ Description
id

string

ID prostředku.

name

string

Název prostředku

properties.blobUri

string

Identifikátor URI objektu blob.

properties.databaseName

string

Název databáze.

properties.errorMessage

string

Zpráva o chybě.

properties.lastModifiedTime

string

Čas poslední změny

properties.privateEndpointConnections

PrivateEndpointConnectionRequestStatus[]

Získá stav privátních koncových bodů přidružených k tomuto požadavku.

properties.queuedTime

string

Čas zařazený do fronty

properties.requestId

string (uuid)

ID požadavku.

properties.requestType

string

Typ požadavku.

properties.serverName

string

Název serveru.

properties.status

string

Stav operace.

type

string

Typ prostředku.

ImportNewDatabaseDefinition

Obsahuje informace potřebné k provedení operace importu pro novou databázi.

Name Typ Description
administratorLogin

string

Přihlašovací jméno správce.

administratorLoginPassword

string

Přihlašovací heslo správce.

authenticationType

string

Typ ověřování.

databaseName

string

Název importové databáze.

edition

string

Edice importované databáze.

maxSizeBytes

string

Maximální velikost v bajtech pro databázi importu

networkIsolation

NetworkIsolationSettings

Volitelné informace o prostředcích pro povolení izolace sítě pro požadavek.

serviceObjectiveName

string

Název cíle na úrovni služby databáze importu.

storageKey

string

Klíč úložiště.

storageKeyType

StorageKeyType

Typ klíče úložiště.

storageUri

string

Identifikátor URI úložiště

NetworkIsolationSettings

Obsahuje prostředky ARM, pro které se má vytvořit připojení privátního koncového bodu.

Name Typ Description
sqlServerResourceId

string (arm-id)

ID prostředku pro SQL Server, který je cílem tohoto požadavku. Pokud je tato možnost nastavená, vytvoří se pro SQL Server připojení privátního koncového bodu. Musí odpovídat serveru, který je cílem operace.

storageAccountResourceId

string (arm-id)

ID prostředku účtu úložiště použitého k uložení souboru BACPAC. Pokud je tato možnost nastavená, vytvoří se pro účet úložiště připojení privátního koncového bodu. Musí odpovídat účtu úložiště použitému pro parametr StorageUri.

PrivateEndpointConnectionRequestStatus

Obsahuje stav žádostí o připojení privátního koncového bodu.

Name Typ Description
privateEndpointConnectionName

string

Název připojení privátního koncového bodu.

privateLinkServiceId

string

ID prostředku, pro který se vytvoří privátní koncový bod.

status

string

Stav tohoto připojení privátního koncového bodu

StorageKeyType

Typ klíče úložiště.

Hodnota Description
SharedAccessKey
StorageAccessKey