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 |
|---|---|---|---|---|
|
database
|
path | True |
string |
Der Name der Datenbank. |
|
extension
|
path | True |
string |
|
|
resource
|
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. |
|
server
|
path | True |
string |
Der Name des Servers. |
|
subscription
|
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 |
Vorgangsmodus des Vorgangs: Import, Export oder PolybaseImport. |
|
| properties.storageKey | True |
string |
Speicherschlüssel für das Speicherkonto. |
| properties.storageKeyType | True |
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 |
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 |
Import-/Exportvorgang erfolgreich abgeschlossen. |
|
| 202 Accepted |
Import/Export-Vorgang wird ausgeführt. Header Location: string |
|
| Other Status Codes |
Fehlerantworten: ***
|
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 |
|---|---|
|
Database |
Eine Import-, Export- oder PolybaseImport-Ressource. |
|
Error |
Der Ressourcenverwaltungsfehler zusätzliche Informationen. |
|
Error |
Das Fehlerdetails. |
|
Error |
Fehlerantwort |
|
Import |
Ergebnisressource des Erweiterungsvorgangs. |
|
Network |
Enthält die ARM-Ressourcen, für die eine private Endpunktverbindung erstellt werden soll. |
|
Operation |
Vorgangsmodus des Vorgangs: Import, Export oder PolybaseImport. |
|
Private |
Enthält den Status der privaten Endpunktverbindungsanforderungen. |
|
Storage |
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 |
Optionale Ressourceninformationen zum Aktivieren der Netzwerkisolation für die Anforderung. |
|
| properties.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 |
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 |
Die zusätzlichen Informationen des Fehlers. |
|
| code |
string |
Der Fehlercode. |
| details |
Die Fehlerdetails. |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Fehlerziel. |
ErrorResponse
Fehlerantwort
| Name | Typ | Beschreibung |
|---|---|---|
| error |
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 |
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 |