Condividi tramite


Databases - Import

Importa un bacpac in un nuovo database.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
databaseName
path True

string

Nome del database.

resourceGroupName
path True

string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

serverName
path True

string

Nome del server.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome Necessario Tipo Descrizione
administratorLogin True

string

Nome di accesso amministratore.

administratorLoginPassword True

string

Password di accesso amministratore.

storageKey True

string

Chiave di archiviazione.

storageKeyType True

StorageKeyType

Tipo di chiave di archiviazione.

storageUri True

string

Uri di archiviazione.

authenticationType

string

Tipo di autenticazione.

networkIsolation

NetworkIsolationSettings

Informazioni sulle risorse facoltative per abilitare l'isolamento di rete per la richiesta.

Risposte

Nome Tipo Descrizione
200 OK

ImportExportOperationResult

È stato importato correttamente il database.

202 Accepted

L'importazione del database è in corso.

Other Status Codes

Risposte agli errori: **

  • 400 MissingImportExportInputParameters - Parametri di input ImportExport mancanti.

  • 400 InvalidImportExportInputParameter - La richiesta di importazione/esportazione non è riuscita a causa di un parametro di input non valido.

  • 400 PolybaseImportAuthenticationTypeNotSupported - Il parametro del tipo di autenticazione non è supportato per l'operazione PolybaseImport.

  • 400 DatabaseExtensionsInvalidOperationMode - Parametro operationMode non valido per l'estensione del database.

  • 400 DatabaseExtensionsInvalidStorageKeyType- Il tipo di chiave di archiviazione deve essere "StorageAccessKey".

  • 400 DatabaseExtensionsMissingStorageUri - L'URI di archiviazione non può essere vuoto.

  • 400 InvalidSku: l'utente ha specificato uno sku non valido.

  • 400 InvalidTierSkuCombination: il livello specificato non supporta lo sku specificato.

  • 400 DatabaseInvalidSkuPropertyCombination: le proprietà dello sku richiesto sono incoerenti. Verificare che sia specificata una combinazione valida. Per informazioni dettagliate, vedere https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 InvalidMaxSizeTierCombination: il livello specificato non supporta le dimensioni massime del database specificate.

  • 400 FeatureDisabledOnSelectedEdition - Utente ha tentato di usare una funzionalità disabilitata nell'edizione del database corrente.

  • 400 InvalidImportExportParameter : la richiesta Import/Export non è riuscita a causa di un parametro di input non valido.

  • 400 InvalidTier: l'utente ha specificato un livello non valido.

  • 400 InvalidOperationType - Specificare un tipo di operazione valido.

  • 400 ImportExportJobError: l'operazione ImportExport non è riuscita.

  • 400 BlockedByOutboundFirewall - Le regole del firewall in uscita bloccavano la richiesta.

  • 404 ResourceNotFound - Richiesta non valida che specifica una risorsa non esistente.

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 ImportExportOperationIdNotFound - Impossibile trovare l'ID operazione per l'importazione o l'esportazione.

  • 404 ServerNotInSubscription: il server specificato non esiste nella sottoscrizione specificata.

  • 404 OperationIdNotFound: l'operazione con ID non esiste.

  • 409 ImportExportOperationInProgress: è in corso un'operazione di importazione o esportazione nel database.

  • 409 OperationCancelled: l'operazione è stata annullata dall'utente.

  • 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione.

  • 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Imports to an existing empty database, using private link to communicate with SQL server and storage account.
Imports to an existing empty database.

Esempio di richiesta

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

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

Risposta di esempio

{
  "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 an existing empty database.

Esempio di richiesta

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

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

Risposta di esempio

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

Definizioni

Nome Descrizione
ImportExistingDatabaseDefinition

Contiene le informazioni necessarie per eseguire l'operazione di importazione per il database esistente.

ImportExportOperationResult

Risorsa risultato dell'operazione ImportExport.

NetworkIsolationSettings

Contiene le risorse di Resource Manager per cui creare una connessione endpoint privato.

PrivateEndpointConnectionRequestStatus

Contiene lo stato delle richieste di connessione dell'endpoint privato.

StorageKeyType

Tipo di chiave di archiviazione.

ImportExistingDatabaseDefinition

Contiene le informazioni necessarie per eseguire l'operazione di importazione per il database esistente.

Nome Tipo Descrizione
administratorLogin

string

Nome di accesso amministratore.

administratorLoginPassword

string

Password di accesso amministratore.

authenticationType

string

Tipo di autenticazione.

networkIsolation

NetworkIsolationSettings

Informazioni sulle risorse facoltative per abilitare l'isolamento di rete per la richiesta.

storageKey

string

Chiave di archiviazione.

storageKeyType

StorageKeyType

Tipo di chiave di archiviazione.

storageUri

string

Uri di archiviazione.

ImportExportOperationResult

Risorsa risultato dell'operazione ImportExport.

Nome Tipo Descrizione
id

string

ID risorsa.

name

string

Nome risorsa.

properties.blobUri

string

Uri BLOB.

properties.databaseName

string

nome del database.

properties.errorMessage

string

Messaggio di errore.

properties.lastModifiedTime

string

Ultima ora modificata.

properties.privateEndpointConnections

PrivateEndpointConnectionRequestStatus[]

Ottiene lo stato degli endpoint privati associati a questa richiesta.

properties.queuedTime

string

Ora in coda.

properties.requestId

string

ID richiesta.

properties.requestType

string

Tipo di richiesta.

properties.serverName

string

Nome del server.

properties.status

string

Stato dell'operazione.

type

string

Tipo di risorsa.

NetworkIsolationSettings

Contiene le risorse di Resource Manager per cui creare una connessione endpoint privato.

Nome Tipo Descrizione
sqlServerResourceId

string

ID risorsa per SQL Server che è la destinazione di questa richiesta. Se impostata, verrà creata la connessione dell'endpoint privato per sql server. Deve corrispondere al server di destinazione dell'operazione.

storageAccountResourceId

string

ID risorsa per l'account di archiviazione usato per archiviare il file BACPAC. Se impostata, la connessione dell'endpoint privato verrà creata per l'account di archiviazione. Deve corrispondere all'account di archiviazione usato per il parametro StorageUri.

PrivateEndpointConnectionRequestStatus

Contiene lo stato delle richieste di connessione dell'endpoint privato.

Nome Tipo Descrizione
privateEndpointConnectionName

string

Nome di connessione per l'endpoint privato.

privateLinkServiceId

string

ID risorsa per cui viene creato l'endpoint privato.

status

string

Stato di questa connessione endpoint privata.

StorageKeyType

Tipo di chiave di archiviazione.

Nome Tipo Descrizione
SharedAccessKey

string

StorageAccessKey

string