Database Extensions - Create Or Update
Eseguire un'operazione di estensione del database, ad esempio l'importazione di database, l'esportazione di database o l'importazione polybase
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/databases/{databaseName}/extensions/{extensionName}?api-version=2025-01-01
Parametri dell'URI
| Nome | In | Necessario | Tipo | Descrizione |
|---|---|---|---|---|
|
database
|
path | True |
string |
Nome del database. |
|
extension
|
path | True |
string |
|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole. |
|
server
|
path | True |
string |
Il nome del server. |
|
subscription
|
path | True |
string (uuid) |
ID della sottoscrizione di destinazione. Il valore deve essere un UUID. |
|
api-version
|
query | True |
string minLength: 1 |
Versione dell'API da usare per questa operazione. |
Corpo della richiesta
| Nome | Necessario | Tipo | Descrizione |
|---|---|---|---|
| properties.operationMode | True |
Modalità operativa dell'operazione: Importazione, Esportazione o PolybaseImport. |
|
| properties.storageKey | True |
string |
Chiave di archiviazione per l'account di archiviazione. Se StorageKeyType è ManagedIdentity, questo campo deve specificare l'ID risorsa dell'identità gestita. |
| properties.storageKeyType | True |
Tipo di chiave di archiviazione: StorageAccessKey, SharedAccessKey o ManagedIdentity. |
|
| properties.storageUri | True |
string |
URI di archiviazione per l'account di archiviazione. |
| properties.administratorLogin |
string |
Nome di accesso dell'amministratore. Se AuthenticationType è ManagedIdentity, questo campo deve specificare l'ID risorsa dell'identità gestita. |
|
| properties.administratorLoginPassword |
string (password) |
Password di accesso dell'amministratore. Se AuthenticationType è ManagedIdentity, questo campo non deve essere specificato. |
|
| properties.authenticationType |
string |
Tipo di autenticazione usato per accedere a SQL: Sql, ADPassword o ManagedIdentity. |
|
| properties.databaseEdition |
string |
Edizione di database per il database appena creato nel caso di un'operazione di importazione. |
|
| properties.maxSizeBytes |
string |
Dimensioni massime del database in byte per il database appena creato nel caso di un'operazione di importazione. |
|
| properties.networkIsolation |
Informazioni facoltative sulle risorse per abilitare l'isolamento di rete per la richiesta. |
||
| properties.serviceObjectiveName |
string |
Obiettivo del livello di servizio del database per il database appena creato nel caso di un'operazione di importazione. |
Risposte
| Nome | Tipo | Descrizione |
|---|---|---|
| 200 OK |
Risorsa 'ImportExportExtensionsOperationResult' con successo |
|
| 202 Accepted |
Operazione sulle risorse accettata. Intestazioni
|
|
| Other Status Codes |
Risposta di errore imprevista. |
Sicurezza
azure_auth
Azure Active Directory OAuth2 Flow.
Tipo:
oauth2
Flow:
implicit
URL di autorizzazione:
https://login.microsoftonline.com/common/oauth2/authorize
Ambiti
| Nome | Descrizione |
|---|---|
| user_impersonation | rappresentare l'account utente |
Esempio
| Create or Update database extensions. |
| Export database using database extension with Managed Identity. |
| Export database using database extension. |
| Import database using database extension. |
Create or Update database extensions.
Esempio di richiesta
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=2025-01-01
{
"properties": {
"operationMode": "PolybaseImport",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"storageKeyType": "StorageAccessKey",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
}
}
Risposta di esempio
{
"name": "polybaseimport",
"type": "Microsoft.Sql/servers/databases/extensions",
"id": "/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",
"properties": {
"databaseName": "878e303f-1ea0-4f17-aa3d-a22ac5e9da08",
"lastModifiedTime": "lastModifiedTime",
"requestId": "10000000-0000-0000-0000-000000000002",
"requestType": "PolybaseImport",
"serverName": "srv_1ffd1cf8-9951-47fb-807d-a9c384763849",
"status": "succeeded"
}
}
Export database using database extension with Managed Identity.
Esempio di richiesta
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=2025-01-01
{
"properties": {
"administratorLogin": "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
"authenticationType": "ManagedIdentity",
"operationMode": "Export",
"storageKey": "/subscriptions/00000000-1111-2222-3333-444444444444/resourcegroups/rgName/providers/Microsoft.ManagedIdentity/userAssignedIdentities/identityName",
"storageKeyType": "ManagedIdentity",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
}
}
Risposta di esempio
{
"name": "Export",
"type": "Microsoft.Sql/servers/databases/extensions",
"id": "/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",
"properties": {
"blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
"databaseName": "db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68",
"lastModifiedTime": "lastModifiedTime",
"privateEndpointConnections": [],
"queuedTime": "09/10/2021 18:35:10",
"requestId": "10000000-0000-0000-0000-000000000002",
"requestType": "Export",
"serverName": "srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c",
"status": "Completed"
}
}
Export database using database extension.
Esempio di richiesta
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=2025-01-01
{
"properties": {
"administratorLogin": "login",
"administratorLoginPassword": "password",
"authenticationType": "Sql",
"operationMode": "Export",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"storageKeyType": "StorageAccessKey",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
}
}
Risposta di esempio
{
"name": "Export",
"type": "Microsoft.Sql/servers/databases/extensions",
"id": "/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",
"properties": {
"blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
"databaseName": "db_7fe424c8-23cf-4ac3-bdc3-e21f424bdb68",
"lastModifiedTime": "lastModifiedTime",
"privateEndpointConnections": [],
"queuedTime": "09/10/2021 18:35:10",
"requestId": "10000000-0000-0000-0000-000000000002",
"requestType": "Export",
"serverName": "srv_9243d320-ac4e-4f97-8e06-b1167dae5f4c",
"status": "Completed"
}
}
Import database using database extension.
Esempio di richiesta
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=2025-01-01
{
"properties": {
"administratorLogin": "login",
"administratorLoginPassword": "password",
"authenticationType": "Sql",
"operationMode": "Import",
"storageKey": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"storageKeyType": "StorageAccessKey",
"storageUri": "https://teststorage.blob.core.windows.net/testcontainer/Manifest.xml"
}
}
Risposta di esempio
{
"name": "Import",
"type": "Microsoft.Sql/servers/databases/extensions",
"id": "/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",
"properties": {
"blobUri": "https://teststorage.blob.core.windows.net/testcontainer/samplebacpac.bacpac",
"databaseName": "db_2a47e946-e414-4c00-94ac-ed886bb78302",
"lastModifiedTime": "lastModifiedTime",
"privateEndpointConnections": [],
"queuedTime": "09/10/2021 18:35:10",
"requestId": "10000000-0000-0000-0000-000000000002",
"requestType": "Import",
"serverName": "srv_2d6be2d2-26c8-4930-8fb6-82a5e95e0e82",
"status": "Completed"
}
}
Definizioni
| Nome | Descrizione |
|---|---|
|
created |
Tipo di identità che ha creato la risorsa. |
|
Database |
Risorsa Import, Export o PolybaseImport. |
|
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
|
Error |
Dettagli dell'errore. |
|
Error |
Risposta di errore |
|
Import |
Risorsa risultato dell'operazione di estensione. |
|
Network |
Contiene le risorse arm per le quali creare una connessione all'endpoint privato. |
|
Operation |
Modalità operativa dell'operazione: Importazione, Esportazione o PolybaseImport. |
|
Private |
Contiene lo stato delle richieste di connessione dell'endpoint privato. |
|
Storage |
Tipo di chiave di archiviazione: StorageAccessKey, SharedAccessKey o ManagedIdentity. |
|
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
createdByType
Tipo di identità che ha creato la risorsa.
| Valore | Descrizione |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DatabaseExtensions
Risorsa Import, Export o PolybaseImport.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nome della risorsa |
| properties.administratorLogin |
string |
Nome di accesso dell'amministratore. Se AuthenticationType è ManagedIdentity, questo campo deve specificare l'ID risorsa dell'identità gestita. |
| properties.administratorLoginPassword |
string (password) |
Password di accesso dell'amministratore. Se AuthenticationType è ManagedIdentity, questo campo non deve essere specificato. |
| properties.authenticationType |
string |
Tipo di autenticazione usato per accedere a SQL: Sql, ADPassword o ManagedIdentity. |
| properties.databaseEdition |
string |
Edizione di database per il database appena creato nel caso di un'operazione di importazione. |
| properties.maxSizeBytes |
string |
Dimensioni massime del database in byte per il database appena creato nel caso di un'operazione di importazione. |
| properties.networkIsolation |
Informazioni facoltative sulle risorse per abilitare l'isolamento di rete per la richiesta. |
|
| properties.operationMode |
Modalità operativa dell'operazione: Importazione, Esportazione o PolybaseImport. |
|
| properties.serviceObjectiveName |
string |
Obiettivo del livello di servizio del database per il database appena creato nel caso di un'operazione di importazione. |
| properties.storageKey |
string |
Chiave di archiviazione per l'account di archiviazione. Se StorageKeyType è ManagedIdentity, questo campo deve specificare l'ID risorsa dell'identità gestita. |
| properties.storageKeyType |
Tipo di chiave di archiviazione: StorageAccessKey, SharedAccessKey o ManagedIdentity. |
|
| properties.storageUri |
string |
URI di archiviazione per l'account di archiviazione. |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
| Nome | Tipo | Descrizione |
|---|---|---|
| info |
object |
Informazioni aggiuntive. |
| type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
| Nome | Tipo | Descrizione |
|---|---|---|
| additionalInfo |
Informazioni aggiuntive sull'errore. |
|
| code |
string |
Codice di errore. |
| details |
Dettagli dell'errore. |
|
| message |
string |
Messaggio di errore. |
| target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
| Nome | Tipo | Descrizione |
|---|---|---|
| error |
Oggetto error. |
ImportExportExtensionsOperationResult
Risorsa risultato dell'operazione di estensione.
| Nome | Tipo | Descrizione |
|---|---|---|
| id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
Nome della risorsa |
| properties.blobUri |
string |
URI BLOB. |
| properties.databaseName |
string |
nome del database. |
| properties.errorMessage |
string |
Messaggio di errore. |
| properties.lastModifiedTime |
string |
Ora dell'ultima modifica. |
| properties.privateEndpointConnections |
Ottiene lo stato degli endpoint privati associati a questa richiesta. |
|
| properties.queuedTime |
string |
Tempo in coda. |
| properties.requestId |
string (uuid) |
ID richiesta. |
| properties.requestType |
string |
Tipo di richiesta. |
| properties.serverName |
string |
Nome server. |
| properties.status |
string |
Stato dell'operazione. |
| systemData |
Azure Resource Manager metadati contenenti informazioni createBy e modifiedBy. |
|
| type |
string |
Tipo di risorsa. Ad esempio: "Microsoft. Compute/virtualMachines" oppure "Microsoft. Storage/storageAccounts" |
NetworkIsolationSettings
Contiene le risorse arm per le quali creare una connessione all'endpoint privato.
| Nome | Tipo | Descrizione |
|---|---|---|
| sqlServerResourceId |
string (arm-id) |
ID risorsa per SQL Server che è la destinazione di questa richiesta. Se impostato, verrà creata la connessione all'endpoint privato per SQL Server. Deve corrispondere al server di destinazione dell'operazione. |
| storageAccountResourceId |
string (arm-id) |
ID risorsa per l'account di archiviazione usato per archiviare il file BACPAC. Se impostato, verrà creata la connessione all'endpoint privato per l'account di archiviazione. Deve corrispondere all'account di archiviazione usato per il parametro StorageUri. |
OperationMode
Modalità operativa dell'operazione: Importazione, Esportazione o PolybaseImport.
| Valore | Descrizione |
|---|---|
| PolybaseImport |
PolybaseImport |
| Import |
Import |
| Export |
Esportazione |
PrivateEndpointConnectionRequestStatus
Contiene lo stato delle richieste di connessione dell'endpoint privato.
| Nome | Tipo | Descrizione |
|---|---|---|
| privateEndpointConnectionName |
string |
Nome della connessione per l'endpoint privato. |
| privateLinkServiceId |
string |
ID risorsa per cui viene creato l'endpoint privato. |
| status |
string |
Stato di questa connessione endpoint privato. |
StorageKeyType
Tipo di chiave di archiviazione: StorageAccessKey, SharedAccessKey o ManagedIdentity.
| Valore | Descrizione |
|---|---|
| SharedAccessKey |
SharedAccessKey |
| StorageAccessKey |
StorageAccessKey |
| ManagedIdentity |
ManagedIdentity |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
| Nome | Tipo | Descrizione |
|---|---|---|
| createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
| createdBy |
string |
Identità che ha creato la risorsa. |
| createdByType |
Tipo di identità che ha creato la risorsa. |
|
| lastModifiedAt |
string (date-time) |
Il timestamp dell'ultima modifica della risorsa (UTC) |
| lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
| lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |