Importer un fichier SQL

Pour reconstruire une base de données à partir d'un script en texte brut de commandes SQL, vous pouvez importer un fichier SQL stocké dans un bucket Cloud Storage dans un cluster AlloyDB pour PostgreSQL.

Remarque : Si vous migrez l'intégralité d'une base de données depuis un serveur de base de données compatible (sur site, dans AWS ou dans AlloyDB) vers un nouveau cluster AlloyDB, vous pouvez utiliser Database Migration Service au lieu d'exporter, puis d'importer des fichiers. Si vous souhaitez créer un cluster à partir du fichier importé, envisagez de restaurer une sauvegarde sur un autre cluster.

Vous pouvez annuler l'importation de données dans des clusters AlloyDB. Pour en savoir plus, consultez Annuler une opération d'importation.

Lorsque vous importez des fichiers de dump SQL, assurez-vous que la version de PostgreSQL à partir de laquelle le dump a été créé est compatible avec la version de PostgreSQL de votre instance AlloyDB. L'importation d'un fichier de dump d'une version supérieure vers une version inférieure peut échouer en raison d'une syntaxe SQL incompatible.

Avant de commencer

Avant de commencer une opération d'importation :

• Assurez-vous que votre base de données dispose d'un quota de stockage suffisant.
• Les opérations d'importation utilisent des ressources de base de données, mais elles n'interfèrent pas avec les opérations de base de données normales, sauf si le cluster est sous-provisionné.

Rôles et autorisations requis pour l'importation dans AlloyDB

Pour importer des données de Cloud Storage dans AlloyDB, l'utilisateur qui lance l'importation doit disposer de l'un des rôles suivants :

• Le rôle Administrateur AlloyDB
• Un rôle personnalisé comprenant les autorisations suivantes :
  • alloydb.clusters.get
  • alloydb.clusters.import

De plus, le compte de service du cluster AlloyDB doit disposer de l'un des rôles suivants :

• Le rôle IAM storage.objectViewer
• Un rôle personnalisé comprenant les autorisations suivantes :
  • storage.objects.get

Pour obtenir de l'aide sur les rôles IAM, consultez Identity and Access Management.

Remarque : La prise en compte des modifications que vous apportez aux autorisations et aux rôles IAM peut prendre quelques minutes. Pour en savoir plus, consultez Propagation des modifications d'accès.

Importer un fichier SQL dans des clusters AlloyDB

Pour importer des données dans un cluster AlloyDB à l'aide d'un fichier SQL, procédez comme suit :

Console

1. Dans la console Google Cloud , accédez à la page Clusters.

   accéder aux clusters

2. Cliquez sur le nom d'un cluster pour ouvrir la page Vue d'ensemble de ce cluster.

3. Cliquez sur Importer.

4. Dans Format de fichier, sélectionnez SQL.

5. Dans Sélectionner un fichier source, choisissez d'importer des fichiers depuis votre ordinateur ou sélectionnez un fichier dans un emplacement Cloud Storage.

   1. Pour importer un fichier depuis votre ordinateur, procédez comme suit :

      1. Sélectionnez Importer des fichiers depuis votre ordinateur.
      2. Cliquez sur Parcourir à côté de Sélectionner un fichier local pour sélectionner un fichier SQL sur votre ordinateur local.
      3. Cliquez sur Parcourir à côté de Sélectionner un emplacement Cloud Storage pour sélectionner un emplacement Cloud Storage où stocker le fichier local importé.
      4. Cliquez sur Importer pour importer le fichier.

   2. Pour sélectionner un fichier SQL existant dans un bucket Cloud Storage, procédez comme suit :

      1. Sélectionnez Sélectionner un fichier dans Google Cloud Storage.
      2. Cliquez sur Parcourir à côté de bucket-name/file-name pour sélectionner un fichier SQL dans un bucket Cloud Storage.

6. Dans le menu déroulant Base de données, sélectionnez la base de données dans laquelle vous souhaitez importer les données.

   Si votre fichier de dump SQL inclut une métacommande \connect (ou \c), elle remplace la base de données cible que vous sélectionnez dans la console Google Cloud .

7. Facultatif : Pour spécifier un utilisateur pour l'opération d'importation, cliquez sur Afficher les options utilisateur, puis saisissez le nom d'utilisateur dans le champ Utilisateur.

8. Pour lancer l'opération d'importation, cliquez sur Importer.

Remarque : Vous pouvez importer un fichier .gz compressé ou un fichier .sql non compressé.

gcloud

1. Créez un bucket Cloud Storage.

2. Importez le fichier SQL dans votre bucket. Pour obtenir de l'aide concernant l'importation de fichiers dans des buckets, consultez la page Importer des objets.

3. Utilisez gcloud storage buckets add-iam-policy-binding pour accorder le rôle IAM storage.objectViewer au compte de service du cluster AlloyDB pour le bucket :

   [e-mail]

   Pour obtenir de l'aide sur la définition des autorisations IAM, consultez la page Utiliser des autorisations IAM.

4. Importez le fichier :

   gcloud alloydb clusters import CLUSTER_NAME \
     --region=REGION \
     --database=DATABASE_NAME \
     --gcs-uri='gs://BUCKET_NAME/PATH_TO_SQL_FILE' \
     --user=USERNAME \
     --sql

   Remarque : Vous pouvez importer un fichier compressé (.gz) ou non compressé (.sql).

   Remplacez les éléments suivants :

   • CLUSTER_NAME : nom du cluster.
   • REGION : région dans laquelle le cluster AlloyDB est déployé.
   • DATABASE_NAME : nom d'une base de données dans le cluster.
   • BUCKET_NAME : nom du bucket Cloud Storage.
   • PATH_TO_SQL_FILE : chemin d'accès au fichier SQL.
   • USERNAME : utilisateur pour l'opération d'importation.

   Si la commande affiche une erreur de type PERMISSION_DENIED, vérifiez les autorisations.

   Pour plus d'informations sur l'utilisation de la commande import, consultez la page de référence de la commande gcloud alloydb clusters import.

5. Si vous n'avez pas besoin de conserver les autorisations IAM que vous avez définies précédemment, supprimez-les à l'aide de gcloud storage buckets remove-iam-policy-binding.

REST v1

1. Créez un bucket Cloud Storage.
2. Importez le fichier SQL dans votre bucket. Pour obtenir de l'aide concernant l'importation de fichiers dans des buckets, consultez la page Importer des objets.

3. Utilisez gcloud storage buckets add-iam-policy-binding pour accorder le rôle IAM storage.objectViewer au compte de service du cluster AlloyDB pour le bucket. Le format du compte de service est le suivant :

   [e-mail]

   Pour obtenir de l'aide sur la définition des autorisations IAM, consultez la page Utiliser des autorisations IAM.

4. Importez votre fichier SQL.

   Remarque : Vous pouvez importer un fichier compressé (.gz) ou non compressé (.sql).

   Utilisez la méthode HTTP et l'URL suivantes :

   POST https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import

   Avant d'utiliser les données de requête, effectuez les remplacements suivants :

   • PROJECT_ID : ID du projet.
   • LOCATION_ID : région dans laquelle le cluster AlloyDB est déployé.
   • CLUSTER_ID : ID du cluster.
   • BUCKET_NAME : nom du bucket Cloud Storage.
   • PATH_TO_SQL_FILE : chemin d'accès au fichier SQL.
   • USER : utilisateur à utiliser pour l'importation.
   • DATABASE_NAME : nom d'une base de données dans le cluster AlloyDB.

   Corps JSON de la requête :

   {
      "gcsUri": "gs://BUCKET_NAME/PATH_TO_SQL_FILE",
      "database": "DATABASE_NAME",
      "user": "USER",
      "sqlImportOptions": {}
   }
   

   Pour envoyer votre requête, développez l'une des options suivantes :

   curl (Linux, macOS ou Cloud Shell)

   La commande suivante suppose que vous vous êtes connecté à la Google Cloud CLI avec votre compte utilisateur en exécutant gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la gcloud CLI. Vous pouvez exécuter gcloud auth list pour vérifier le compte actuellement actif.

   Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

      curl -X POST \
            -H "Authorization: Bearer $(gcloud auth print-access-token)" \
            -H "Content-Type: application/json; charset=utf-8" \
            -d @request.json \
            "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"
   

   PowerShell (Windows)

   La commande suivante suppose que vous vous êtes connecté à la Google Cloud CLI avec votre compte utilisateur en exécutant gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la gcloud CLI. Vous pouvez exécuter gcloud auth list pour vérifier le compte actuellement actif.

   Enregistrez le corps de la requête dans un fichier nommé request.json, puis exécutez la commande suivante :

   $cred = gcloud auth print-access-token
   $headers = @{ "Authorization" = "Bearer $cred" }
   
   Invoke-WebRequest `
     -Method POST `
     -Headers $headers `
     -ContentType: "application/json; charset=utf-8" `
     -InFile request.json `
     -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID:import"| Select-Object -Expand Content
   

   Vous recevez une réponse JSON de ce type :

   Réponse

   {
    "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
    "metadata": {
     "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
     "createTime": "2025-01-04T13:12:32.363393723Z",
     "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
     "verb": "import",
     "requestedCancellation": false,
     "apiVersion": "v1"
    },
    "done": false
   }
   

   Pour utiliser un autre utilisateur pour l'importation, spécifiez la propriété de l'utilisateur.

5. Si vous n'avez pas besoin de conserver les autorisations IAM que vous avez définies précédemment, supprimez-les.

   Pour obtenir la liste complète des paramètres de la requête, consultez clusters.import.

Vérifier l'état d'une opération d'importation

Pour vérifier l'état d'une opération d'importation, procédez comme suit :

gcloud

Exécutez la commande suivante à l'aide de gcloud alloydb operations describe :

gcloud alloydb operations describe OPERATION_ID --region=REGION

Vous pouvez également lister les détails d'une opération spécifique ou annuler une opération spécifique. Pour en savoir plus sur cette commande, consultez la page de référence de la commande gcloud alloydb operations.

REST v1

Utilisez la méthode GET et l'URL suivante :

GET https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID

Pour en savoir plus, consultez la page get.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

• REGION : région dans laquelle le cluster AlloyDB est déployé.
• PROJECT_ID : ID du projet.
• OPERATION_ID : ID de l'opération d'importation. Pour en savoir plus, consultez Avant de commencer.

Pour envoyer votre requête, développez l'une des options suivantes :

curl (Linux, macOS ou Cloud Shell)

La commande suivante suppose que vous vous êtes connecté à la gcloud CLI avec votre compte utilisateur en exécutant gcloud init ou gcloud auth login, ou en utilisant Cloud Shell, qui vous connecte automatiquement à la gcloud CLI. Vous pouvez exécuter gcloud auth list pour vérifier le compte actuellement actif.

Exécutez la commande suivante :

  curl -X GET \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID
 

PowerShell (Windows)

La commande suivante suppose que vous vous êtes connecté à la gcloud CLI avec votre compte utilisateur en exécutant gcloud init ou gcloud auth login. Vous pouvez exécuter gcloud auth list pour vérifier le compte actuellement actif.

Exécutez la commande suivante :

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
  -Method GET `
  -Headers $headers `
  -Uri "https://alloydb.googleapis.com/v1/projects/PROJECT_ID/locations/REGION/operations/OPERATION_ID" | Select-Object -Expand Content

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Étapes suivantes

• Découvrez comment importer un fichier CSV.
• Découvrez comment annuler une opération d'importation.