Freigeben über


Database Extensions - Create Or Update

Ausführen eines Datenbankerweiterungsvorgangs wie Datenbankimport, Datenbankexport oder Polybasisimport

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/extensions/{extensionName}?api-version=2023-08-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
databaseName
path True

string

Der Name der Datenbank.

extensionName
path True

string

resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.

serverName
path True

string

Der Name des Servers.

subscriptionId
path True

string

Die Abonnement-ID, die ein Azure-Abonnement identifiziert.

api-version
query True

string

Die API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name Erforderlich Typ Beschreibung
properties.operationMode True

OperationMode

Vorgangsmodus des Vorgangs: Import, Export oder PolybaseImport.

properties.storageKey True

string

Speicherschlüssel für das Speicherkonto.

properties.storageKeyType True

StorageKeyType

Speicherschlüsseltyp: StorageAccessKey oder SharedAccessKey.

properties.storageUri True

string

Speicher-URI für das Speicherkonto.

properties.administratorLogin

string

Administratoranmeldungsname.

properties.administratorLoginPassword

string

Administratoranmeldungskennwort.

properties.authenticationType

string

Authentifizierungstyp: SQL-Authentifizierung oder AD-Kennwort.

properties.databaseEdition

string

Datenbankedition für die neu erstellte Datenbank im Falle eines Importvorgangs.

properties.maxSizeBytes

string

Maximale Datenbankgröße in Byte für die neu erstellte Datenbank im Falle eines Importvorgangs.

properties.networkIsolation

NetworkIsolationSettings

Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.

properties.serviceObjectiveName

string

Ziel der Datenbankdienstebene für die neu erstellte Datenbank im Falle eines Importvorgangs.

Antworten

Name Typ Beschreibung
200 OK

ImportExportExtensionsOperationResult

Import-/Exportvorgang erfolgreich abgeschlossen.

202 Accepted

Import/Export-Vorgang wird ausgeführt.

Header

Location: string

Other Status Codes

ErrorResponse

Fehlerantworten: ***

  • 400 MissingImportExportInputParameters – Fehlende ImportExport-Eingabeparameter.

  • 400 InvalidImportExportInputParameter – Fehler bei der Import-/Exportanforderung aufgrund eines ungültigen Eingabeparameters.

  • 400 PolybaseImportAuthenticationTypeNotSupported – Der Authentifizierungstypparameter wird für den PolybaseImport-Vorgang nicht unterstützt.

  • 400 DatabaseExtensionsInvalidOperationMode – Ungültiger operationMode-Parameter für die Datenbankerweiterung.

  • 400 DatabaseExtensionsInvalidStorageKeyType – Der Speicherschlüsseltyp muss von 'StorageAccessKey' sein.

  • 400 DatabaseExtensionsMissingStorageUri – Speicher-URI darf nicht leer sein.

  • 400 SQLPasswordSpecifiedWithManagedIdentity – administratorLoginPassword sollte nicht angegeben werden, wenn authenticationType managedIdentity ist.

  • 400 InvalidSqlAuthType – ImportExport-Vorgang fehlgeschlagen, da der SQL-Authentifizierungstyp ungültig ist.

  • 400 BlobAlreadyExist – ImportExport-Vorgang fehlgeschlagen, da das Speicher-Blob bereits vorhanden ist

  • 400 InvalidImportExportOperationResourceLocks – Die Import/Export-Anforderung ist aufgrund von Sperren der Ressourcen für private Verknüpfungen ungültig.

  • 400 DatabaseInvalidSkuPropertyCombination – Die Eigenschaften der angeforderten Sku sind inkonsistent. Überprüfen Sie, ob eine gültige Kombination angegeben ist. Weitere Informationen finden Sie unter https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 ImportExportJobError – Fehler beim ImportExport-Vorgang.

  • 400 BlockedByOutboundFirewall – Die ausgehenden Firewallregeln blockierten die Anforderung.

  • 400 InvalidOperationType – Geben Sie einen gültigen Vorgangstyp an.

  • 400 InvalidMaxSizeTierCombination – Die angegebene Ebene unterstützt die angegebene Datenbank max. Größe nicht.

  • 400 InvalidTier – Der Benutzer hat eine ungültige Ebene angegeben.

  • 400 CannotUseReservedDatabaseName – In diesem Vorgang kann kein reservierter Datenbankname verwendet werden.

  • 400 InvalidImportExportParameter – Fehler bei der Import-/Exportanforderung aufgrund eines ungültigen Eingabeparameters.

  • 400 InvalidSku – Der Benutzer hat eine ungültige Sku angegeben.

  • 400 InvalidTierSkuCombination – Die angegebene Ebene unterstützt die angegebene SKU nicht.

  • 400 InvalidImportExportStorageCredentials – Import/Export-Vorgang aufgrund ungültiger Speicheranmeldeinformationen fehlgeschlagen

  • 400 InvalidImportExportStorageAuthType – Import/Export-Vorgang aufgrund eines ungültigen Speicherauthentifizierungstyps fehlgeschlagen

  • 400 InvalidImportExportStorageKeyFormat – Import/Export-Vorgang aufgrund eines ungültigen Speicherschlüsselformats fehlgeschlagen

  • 400 LongImportExportStorageUri – Import/Export-Vorgang aufgrund eines langen Speicher-URI fehlgeschlagen

  • 400 LargeExportDatabaseSize – Exportvorgang fehlgeschlagen, da die Datenbank größer als die maximal unterstützte Größe ist.

  • 400 FeatureDisabledOnSelectedEdition – Der Benutzer hat versucht, ein Feature zu verwenden, das in der aktuellen Datenbankedition deaktiviert ist.

  • 400 UnSupportedImportExportEdition – ImportExport-Vorgang fehlgeschlagen, weil er auf eine ungültige Edition ausgerichtet ist

  • 400 InvalidImportExportStorageURI – ImportExport-Vorgang fehlgeschlagen, da der Speicher-URI ungültig ist.

  • 404 DatabaseDoesNotExist – Der Benutzer hat einen Datenbanknamen angegeben, der in dieser Serverinstanz nicht vorhanden ist.

  • 404 ServerNotInSubscription – Der angegebene Server ist für das angegebene Abonnement nicht vorhanden.

  • 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 404 ResourceNotFound – Ungültige Anforderung, die eine nicht vorhandene Ressource angibt.

  • 404 ImportExportOperationIdNotFound – Die Vorgangs-ID für den Import oder Export wurde nicht gefunden.

  • 404 OperationIdNotFound – Der Vorgang mit der ID ist nicht vorhanden.

  • 409 ImportExportOperationInProgress – Es wird ein Import- oder Exportvorgang in der Datenbank ausgeführt.

  • 409 CannotCancelOperation – Der Verwaltungsvorgang befindet sich in einem Zustand, der nicht abgebrochen werden kann.

  • 409 OperationCancelled – Der Vorgang wurde vom Benutzer abgebrochen.

  • 409 OperationInterrupted – Der Vorgang für die Ressource konnte nicht abgeschlossen werden, weil er durch einen anderen Vorgang in derselben Ressource unterbrochen wurde.

  • 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

  • 500 OperationTimedOut – Timeout des Vorgangs und automatisches Zurücksetzen. Versuchen Sie den Vorgang erneut.

  • 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können.

Beispiele

Create or Update database extensions.
Export database using database extension.
Import database using database extension.

Create or Update database extensions.

Beispielanforderung

PUT https://management.azure.com/subscriptions/a1c0814d-3c18-4e1e-a247-c128c12b1677/resourceGroups/rg_20cbe0f0-c2d9-4522-9177-5469aad53029/providers/Microsoft.Sql/servers/srv_1ffd1cf8-9951-47fb-807d-a9c384763849/databases/878e303f-1ea0-4f17-aa3d-a22ac5e9da08/extensions/polybaseimport?api-version=2023-08-01

{
  "properties": {
    "operationMode": "PolybaseImport",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
  }
}

Beispiel für eine Antwort

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "PolybaseImport",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_1ffd1cf8-9951-47fb-807d-a9c384763849",
    "databaseName": "878e303f-1ea0-4f17-aa3d-a22ac5e9da08",
    "status": "succeeded"
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

Export database using database extension.

Beispielanforderung

PUT https://management.azure.com/subscriptions/0ca8cd24-0b47-4ad5-bc7e-d70e35c44adf/resourceGroups/rg_d1ef9eae-044d-4710-ba59-b82e84ad3157/providers/Microsoft.Sql/servers/srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c/databases/db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68/extensions/Export?api-version=2023-08-01

{
  "properties": {
    "operationMode": "Export",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}

Beispiel für eine Antwort

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Export",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c",
    "databaseName": "db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

Import database using database extension.

Beispielanforderung

PUT https://management.azure.com/subscriptions/17ca4d13-bf7d-4c33-a60e-b87a2820a325/resourceGroups/rg_062866bf-c4f4-41f9-abf0-b59132ca7924/providers/Microsoft.Sql/servers/srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82/databases/db_2a47e946-e414-4c00-94ac-ed886bb78302/extensions/Import?api-version=2023-08-01

{
  "properties": {
    "operationMode": "Import",
    "storageKeyType": "StorageAccessKey",
    "storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml",
    "administratorLogin": "login",
    "administratorLoginPassword": "password",
    "authenticationType": "Sql"
  }
}

Beispiel für eine Antwort

{
  "properties": {
    "requestId": "10000000-0000-0000-0000-000000000002",
    "requestType": "Import",
    "lastModifiedTime": "lastModifiedTime",
    "serverName": "srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82",
    "databaseName": "db_2a47e946-e414-4c00-94ac-ed886bb78302",
    "status": "Completed",
    "queuedTime": "09/10/2021 18:35:10",
    "blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
    "privateEndpointConnections": []
  },
  "id": "10000000-0000-0000-0000-000000000002",
  "name": "10000000-0000-0000-0000-000000000002",
  "type": "Microsoft.Sql/servers/databases/extensions"
}

Definitionen

Name Beschreibung
DatabaseExtensions

Eine Import-, Export- oder PolybaseImport-Ressource.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

ErrorDetail

Das Fehlerdetails.

ErrorResponse

Fehlerantwort

ImportExportExtensionsOperationResult

Ergebnisressource des Erweiterungsvorgangs.

NetworkIsolationSettings

Enthält die ARM-Ressourcen, für die eine private Endpunktverbindung erstellt werden soll.

OperationMode

Vorgangsmodus des Vorgangs: Import, Export oder PolybaseImport.

PrivateEndpointConnectionRequestStatus

Enthält den Status der privaten Endpunktverbindungsanforderungen.

StorageKeyType

Speicherschlüsseltyp: StorageAccessKey oder SharedAccessKey.

DatabaseExtensions

Eine Import-, Export- oder PolybaseImport-Ressource.

Name Typ Beschreibung
id

string

Ressourcen-ID.

name

string

Ressourcenname.

properties.administratorLogin

string

Administratoranmeldungsname.

properties.administratorLoginPassword

string

Administratoranmeldungskennwort.

properties.authenticationType

string

Authentifizierungstyp: SQL-Authentifizierung oder AD-Kennwort.

properties.databaseEdition

string

Datenbankedition für die neu erstellte Datenbank im Falle eines Importvorgangs.

properties.maxSizeBytes

string

Maximale Datenbankgröße in Byte für die neu erstellte Datenbank im Falle eines Importvorgangs.

properties.networkIsolation

NetworkIsolationSettings

Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung.

properties.operationMode

OperationMode

Vorgangsmodus des Vorgangs: Import, Export oder PolybaseImport.

properties.serviceObjectiveName

string

Ziel der Datenbankdienstebene für die neu erstellte Datenbank im Falle eines Importvorgangs.

properties.storageKey

string

Speicherschlüssel für das Speicherkonto.

properties.storageKeyType

StorageKeyType

Speicherschlüsseltyp: StorageAccessKey oder SharedAccessKey.

properties.storageUri

string

Speicher-URI für das Speicherkonto.

type

string

Ressourcentyp.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name Typ Beschreibung
info

object

Die zusätzlichen Informationen.

type

string

Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name Typ Beschreibung
additionalInfo

ErrorAdditionalInfo[]

Die zusätzlichen Informationen des Fehlers.

code

string

Der Fehlercode.

details

ErrorDetail[]

Die Fehlerdetails.

message

string

Die Fehlermeldung.

target

string

Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name Typ Beschreibung
error

ErrorDetail

Das Fehlerobjekt.

ImportExportExtensionsOperationResult

Ergebnisressource des Erweiterungsvorgangs.

Name Typ Beschreibung
id

string

Ressourcen-ID.

name

string

Ressourcenname.

properties.blobUri

string

Blob-URI.

properties.databaseName

string

Datenbankname.

properties.errorMessage

string

Fehlermeldung.

properties.lastModifiedTime

string

Zeitpunkt der letzten Änderung.

properties.privateEndpointConnections

PrivateEndpointConnectionRequestStatus[]

Ruft den Status privater Endpunkte ab, die dieser Anforderung zugeordnet sind.

properties.queuedTime

string

In die Warteschlange eingereihte Zeit.

properties.requestId

string (uuid)

Anforderungs-ID.

properties.requestType

string

Anforderungstyp.

properties.serverName

string

Servername.

properties.status

string

Vorgangsstatus.

type

string

Ressourcentyp.

NetworkIsolationSettings

Enthält die ARM-Ressourcen, für die eine private Endpunktverbindung erstellt werden soll.

Name Typ Beschreibung
sqlServerResourceId

string (arm-id)

Die Ressourcen-ID für den SQL-Server, der das Ziel dieser Anforderung ist. Wenn festgelegt, wird eine private Endpunktverbindung für den SQL-Server erstellt. Muss mit dem Server übereinstimmen, der das Ziel des Vorgangs ist.

storageAccountResourceId

string (arm-id)

Die Ressourcen-ID für das Speicherkonto, das zum Speichern der BACPAC-Datei verwendet wird. Bei Festlegung wird für das Speicherkonto eine private Endpunktverbindung erstellt. Muss mit dem Speicherkonto übereinstimmen, das für den Parameter "StorageUri" verwendet wird.

OperationMode

Vorgangsmodus des Vorgangs: Import, Export oder PolybaseImport.

Wert Beschreibung
PolybaseImport
Import
Export

PrivateEndpointConnectionRequestStatus

Enthält den Status der privaten Endpunktverbindungsanforderungen.

Name Typ Beschreibung
privateEndpointConnectionName

string

Der Verbindungsname für den privaten Endpunkt.

privateLinkServiceId

string

Ressourcen-ID, für die der private Endpunkt erstellt wird.

status

string

Status dieser privaten Endpunktverbindung.

StorageKeyType

Speicherschlüsseltyp: StorageAccessKey oder SharedAccessKey.

Wert Beschreibung
SharedAccessKey
StorageAccessKey