Partager via


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=2023-08-01

Paramètres URI

Nom Dans Obligatoire 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

Nom du serveur.

subscriptionId
path True

string

ID d’abonnement qui identifie un abonnement Azure.

api-version
query True

string

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

Corps de la demande

Nom Obligatoire Type Description
administratorLogin True

string

Nom de connexion administrateur.

administratorLoginPassword True

string

Mot de passe de connexion administrateur.

storageKey True

string

Clé de stockage.

storageKeyType True

StorageKeyType

Type de clé de stockage.

storageUri True

string

URI de 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

NetworkIsolationSettings

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

Nom Type Description
200 OK

ImportExportOperationResult

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

202 Accepted

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

En-têtes

Location: string

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

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

  • 400 InvalidImportExportInputParameter : la demande d’importation/exportation a échoué en raison d’un paramètre d’entrée non valide.

  • 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 - L’URI de stockage ne peut pas être vide.

  • 400 SQLPasswordSpecifiedWithManagedIdentity - administratorLoginPassword ne doit pas être spécifié si authenticationType est ManagedIdentity.

  • 400 InvalidSqlAuthType - Échec de l’opération ImportExport, car le type d’authentification sql n’est pas valide

  • 400 BlobAlreadyExist - Échec de l’opération ImportExport, car l’objet blob de stockage existe déjà

  • 400 InvalidImportExportOperationResourceLocks : la requête Import/Export n’est pas valide en raison de verrous sur les ressources Private Link.

  • 400 DatabaseInvalidSkuPropertyCombination : les propriétés de la référence SKU demandée sont incohérentes. Vérifiez qu’une combinaison valide est spécifiée. Pour plus d’informations, consultez https://docs.microsoft.com/en-us/rest/api/sql/capabilities/listbylocation#serviceobjectivecapability.

  • 400 ImportExportJobError : l’opération ImportExport a échoué.

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

  • 400 InvalidOperationType : indiquez un type d’opération valide.

  • 400 InvalidMaxSizeTierCombination : le niveau spécifié ne prend pas en charge la taille maximale de la base de données spécifiée.

  • 400 InvalidTier : l’utilisateur a spécifié un niveau non valide.

  • 400 CannotUseReservedDatabaseName - Impossible d’utiliser le nom de la base de données réservée dans cette opération.

  • 400 InvalidImportExportParameter : la requête Import/Export a échoué en raison d’un paramètre d’entrée non valide.

  • 400 InvalidSku : l’utilisateur a spécifié une référence SKU non valide.

  • 400 InvalidTierSkuCombination : le niveau spécifié ne prend pas en charge la référence sku spécifiée.

  • 400 InvalidImportExportStorageCredentials - Échec de l’opération Import/Export en raison d’informations d’identification de stockage non valides

  • 400 InvalidImportExportStorageAuthType - Échec de l’opération Import/Export en raison d’un type d’authentification de stockage non valide

  • 400 InvalidImportExportStorageKeyFormat - Échec de l’opération Import/Export en raison d’un format de clé de stockage non valide

  • 400 LongImportExportStorageUri - Échec de l’opération Import/Export en raison d’un URI de stockage long

  • 400 LargeExportDatabaseSize - Échec de l’opération d’exportation, car la base de données est supérieure à la taille maximale prise en charge

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

  • 400 UnSupportedImportExportEdition - Échec de l’opération ImportExport, car elle cible une édition non valide

  • 400 InvalidImportExportStorageURI - Échec de l’opération ImportExport, car l’URI de stockage n’est pas valide

  • 404 DatabaseDoesNotExist : l’utilisateur a spécifié un nom de base de données qui n’existe pas sur cette instance de serveur.

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

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

  • 404 ResourceNotFound : requête non valide spécifiant une ressource inexistante.

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

  • 404 OperationIdNotFound : l’opération avec ID n’existe pas.

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

  • 409 CannotCancelOperation : l’opération de gestion est dans un état qui ne peut pas être annulé.

  • 409 OperationCancelled : l’opération a été annulée par l’utilisateur.

  • 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

  • 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération.

  • 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

Exemples

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

Exemple de requête

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

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

Exemple de réponse

{
  "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"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Imports to a new database.

Exemple de requête

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

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

Exemple de réponse

{
  "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"
}
Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.Sql/locations/japaneast/importExportOperationResults/00000000-0000-0000-0000-000000000000?api-version=2022-08-01

Définitions

Nom Description
ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

ErrorDetail

Détail de l’erreur.

ErrorResponse

Réponse d’erreur

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

Type de clé de stockage.

ErrorAdditionalInfo

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom Type Description
info

object

Informations supplémentaires.

type

string

Type d’informations supplémentaire.

ErrorDetail

Détail de l’erreur.

Nom Type Description
additionalInfo

ErrorAdditionalInfo[]

Informations supplémentaires sur l’erreur.

code

string

Code d’erreur.

details

ErrorDetail[]

Détails de l’erreur.

message

string

Message d’erreur.

target

string

Cible d’erreur.

ErrorResponse

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet d’erreur.

ImportExportOperationResult

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

Nom Type Description
id

string

ID de 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

PrivateEndpointConnectionRequestStatus[]

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

properties.queuedTime

string

Heure mise en file d’attente.

properties.requestId

string (uuid)

ID de demande.

properties.requestType

string

Type de requête.

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.

Nom 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

NetworkIsolationSettings

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é de stockage.

storageKeyType

StorageKeyType

Type de clé de stockage.

storageUri

string

URI de stockage.

NetworkIsolationSettings

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

Nom Type Description
sqlServerResourceId

string (arm-id)

ID de ressource pour le 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 (arm-id)

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

Nom 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

Type de clé de stockage.

Valeur Description
SharedAccessKey
StorageAccessKey