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=2022-02-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

Chiave di archiviazione.

storageKeyType True

Tipo di chiave di archiviazione.

storageUri True
  • string

Uri di archiviazione.

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 sulle risorse facoltative per abilitare l'isolamento di rete per la richiesta.

serviceObjectiveName
  • string

Nome obiettivo a livello di servizio del database di importazione.

Risposte

Name Type Description
200 OK

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

  • 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=2022-02-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=2022-02-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 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.

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

Ultima ora modificata.

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 sulle risorse facoltative per abilitare l'isolamento di rete per la richiesta.

serviceObjectiveName
  • string

Nome obiettivo a livello di servizio del database di importazione.

storageKey
  • string

Chiave di archiviazione.

storageKeyType

Tipo di chiave di archiviazione.

storageUri
  • string

Uri di archiviazione.

NetworkIsolationSettings

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

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

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

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string