Servers - Import Database

Importe un bacpac dans une nouvelle base de données.

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

Paramètres URI

Name In Required Type Description
resourceGroupName
path True
  • string

Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.

serverName
path True
  • string

Le nom du serveur

subscriptionId
path True
  • string

L’ID d’abonnement d’un abonnement Azure.

api-version
query True
  • string

Version de l’API à utiliser pour la requête.

Corps de la demande

Name Required Type Description
administratorLogin True
  • string

Nom de connexion administrateur.

administratorLoginPassword True
  • string

Mot de passe de connexion administrateur.

storageKey True
  • string

clé Stockage.

storageKeyType True

Stockage type de clé.

storageUri True
  • string

uri Stockage.

authenticationType
  • string

Type d’authentification.

databaseName
  • string

Nom de la base de données d’importation.

edition
  • string

Édition de la base de données d’importation.

maxSizeBytes
  • string

Taille maximale en octets pour la base de données d’importation.

networkIsolation

Informations de ressource facultatives pour activer l’isolation réseau pour la requête.

serviceObjectiveName
  • string

Nom de l’objectif de niveau de service de la base de données d’importation.

Réponses

Name Type Description
200 OK

Importation réussie de la base de données.

202 Accepted

L’importation de la base de données est en cours.

Other Status Codes

Réponses d’erreur : ***

  • 400 MissingImportExportInputParameters - Paramètres d’entrée ImportExport manquants.

  • 400 PolybaseImportAuthenticationTypeNotSupported - Le paramètre de type d’authentification n’est pas pris en charge pour l’opération PolybaseImport.

  • 400 DatabaseExtensionsInvalidOperationMode - Paramètre operationMode non valide pour l’extension de base de données.

  • 400 DatabaseExtensionsInvalidStorageKeyType : le type de clé de stockage doit être « StorageAccessKey ».

  • 400 DatabaseExtensionsMissingStorageUri - Stockage URI ne peut pas être vide.

  • 400 FeatureDisabledOnSelectedEdition : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée sur l’édition actuelle de la base de données.

  • 400 InvalidOperationType - Fournissez un type d’opération valide.

  • 400 ImportExportJobError - L’opération ImportExport a échoué.

  • 400 BlockedByOutboundFirewall - Les règles de pare-feu sortant ont bloqué la requête.

  • 404 ResourceNotFound - Requête non valide spécifiant une ressource inexistante.

  • 404 ServerNotInSubscriptionResourceGroup - Le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 ImportExportOperationIdNotFound - L’ID d’opération pour l’importation ou l’exportation est introuvable.

  • 404 ServerNotInSubscription : le serveur spécifié n’existe pas sur l’abonnement spécifié.

  • 409 ImportExportOperationInProgress : il existe une opération d’importation ou d’exportation en cours sur la base de données.

Exemples

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=2020-11-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=2020-11-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"
}

Définitions

ImportExportOperationResult

Ressource de résultat de l’opération ImportExport.

ImportNewDatabaseDefinition

Contient les informations nécessaires pour effectuer l’opération d’importation pour la nouvelle base de données.

NetworkIsolationSettings

Contient les ressources ARM pour lesquelles créer une connexion de point de terminaison privé.

PrivateEndpointConnectionRequestStatus

Contient l’état des demandes de connexion de point de terminaison privé.

StorageKeyType

Stockage type de clé.

ImportExportOperationResult

Ressource de résultat de l’opération ImportExport.

Name Type Description
id
  • string

ID de la ressource

name
  • string

Nom de la ressource.

properties.blobUri
  • string

Uri d’objet blob.

properties.databaseName
  • string

Nom de la base de données.

properties.errorMessage
  • string

Message d’erreur.

properties.lastModifiedTime
  • string

Heure de dernière modification.

properties.privateEndpointConnections

Obtient l’état des points de terminaison privés associés à cette requête.

properties.queuedTime
  • string

Heure en file d’attente.

properties.requestId
  • string

ID de requête.

properties.requestType
  • string

Type de la demande.

properties.serverName
  • string

Nom du serveur.

properties.status
  • string

État de l’opération.

type
  • string

Type de ressource.

ImportNewDatabaseDefinition

Contient les informations nécessaires pour effectuer l’opération d’importation pour la nouvelle base de données.

Name Type Description
administratorLogin
  • string

Nom de connexion administrateur.

administratorLoginPassword
  • string

Mot de passe de connexion administrateur.

authenticationType
  • string

Type d’authentification.

databaseName
  • string

Nom de la base de données d’importation.

edition
  • string

Édition de la base de données d’importation.

maxSizeBytes
  • string

Taille maximale en octets pour la base de données d’importation.

networkIsolation

Informations de ressource facultatives pour activer l’isolation réseau pour la requête.

serviceObjectiveName
  • string

Nom de l’objectif de niveau de service de la base de données d’importation.

storageKey
  • string

clé Stockage.

storageKeyType

Stockage type de clé.

storageUri
  • string

uri Stockage.

NetworkIsolationSettings

Contient les ressources ARM pour lesquelles créer une connexion de point de terminaison privé.

Name Type Description
sqlServerResourceId
  • string

ID de ressource du serveur SQL qui est la cible de cette requête. Si elle est définie, la connexion de point de terminaison privé est créée pour le serveur SQL. Doit correspondre au serveur qui est la cible de l’opération.

storageAccountResourceId
  • string

ID de ressource du compte de stockage utilisé pour stocker le fichier BACPAC. Si elle est définie, la connexion de point de terminaison privé est créée pour le compte de stockage. Doit correspondre au compte de stockage utilisé pour le paramètre StorageUri.

PrivateEndpointConnectionRequestStatus

Contient l’état des demandes de connexion de point de terminaison privé.

Name Type Description
privateEndpointConnectionName
  • string

Nom de connexion du point de terminaison privé.

privateLinkServiceId
  • string

ID de ressource pour lequel le point de terminaison privé est créé.

status
  • string

État de cette connexion de point de terminaison privé.

StorageKeyType

Stockage type de clé.

Name Type Description
SharedAccessKey
  • string
StorageAccessKey
  • string