Servers - Import Database

Importa un bacpac in un nuovo database.

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

Parametri dell'URI

Name In Required Type Description
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

Name Required Type Description
administratorLogin True
  • string

Nome di accesso amministratore.

administratorLoginPassword True
  • string

Password di accesso amministratore.

storageKey True
  • string

Archiviazione chiave.

storageKeyType True

Archiviazione tipo di chiave.

storageUri True
  • string

Archiviazione URI.

authenticationType
  • string

Tipo di autenticazione.

databaseName
  • string

Nome del database di importazione.

edition
  • string

Edizione del database di importazione.

maxSizeBytes
  • string

Dimensioni massime in byte per il database di importazione.

networkIsolation

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

serviceObjectiveName
  • string

Nome dell'obiettivo del livello di servizio del database di importazione.

Risposte

Name Type Description
200 OK

Il database è stato importato correttamente.

202 Accepted

L'importazione del database è in corso.

Other Status Codes

Risposte di errore:

  • 400 MissingImportExportInputParameters - Parametri di input ImportExport mancanti.

  • 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: Archiviazione URI non può essere vuoto.

  • 400 FeatureDisabledOnSelectedEdition : l'utente ha tentato di usare una funzionalità disabilitata nell'edizione di database corrente.

  • 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 inesistente.

  • 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.

  • 409 ImportExportOperationInProgress - È in corso un'operazione di importazione o esportazione nel database.

Esempio

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

Sample Request

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

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

Sample Response

{
  "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 a new database.

Sample Request

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

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

Sample Response

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

ImportExportOperationResult

Risorsa risultato dell'operazione ImportExport.

ImportNewDatabaseDefinition

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

NetworkIsolationSettings

Contiene le risorse arm per cui creare una connessione all'endpoint privato.

PrivateEndpointConnectionRequestStatus

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

StorageKeyType

Archiviazione tipo di chiave.

ImportExportOperationResult

Risorsa risultato dell'operazione ImportExport.

Name Type Description
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

Ora dell'ultima modifica.

properties.privateEndpointConnections

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.

ImportNewDatabaseDefinition

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

Name Type Description
administratorLogin
  • string

Nome di accesso amministratore.

administratorLoginPassword
  • string

Password di accesso amministratore.

authenticationType
  • string

Tipo di autenticazione.

databaseName
  • string

Nome del database di importazione.

edition
  • string

Edizione del database di importazione.

maxSizeBytes
  • string

Dimensioni massime in byte per il database di importazione.

networkIsolation

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

serviceObjectiveName
  • string

Nome dell'obiettivo del livello di servizio del database di importazione.

storageKey
  • string

Archiviazione chiave.

storageKeyType

Archiviazione tipo di chiave.

storageUri
  • string

Archiviazione URI.

NetworkIsolationSettings

Contiene le risorse arm per cui creare una connessione all'endpoint privato.

Name Type Description
sqlServerResourceId
  • string

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

storageAccountResourceId
  • string

ID risorsa per l'account di archiviazione usato per archiviare il file BACPAC. Se impostato, verrà creata la connessione dell'endpoint privato 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.

Name Type Description
privateEndpointConnectionName
  • string

Nome della connessione per l'endpoint privato.

privateLinkServiceId
  • string

ID risorsa per cui viene creato l'endpoint privato.

status
  • string

Stato della connessione all'endpoint privato.

StorageKeyType

Archiviazione tipo di chiave.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string