Importer un fichier CSV

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

gcloud

1. Créez un bucket Cloud Storage.
2. Importez le fichier CSV dans le 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 AlloyDB du bucket.

    service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

   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 --gcs-uri=gs://BUCKET_NAME/FILE_NAME --database=DATABASE_NAME --user=USER --csv --table=TABLE_NAME

   Effectuez les remplacements suivants :

   • CLUSTER_NAME : nom du cluster.
   • REGION: région dans laquelle le cluster AlloyDB est déployé.
   • BUCKET_NAME: nom du bucket Cloud Storage.
   • FILE_NAME: nom du fichier CSV.
   • DATABASE_NAME: nom d'une base de données dans le cluster.
   • USER: utilisateur de l'opération d'importation.
   • TABLE_NAME: table de la base de données.

   Pour en savoir plus sur l'utilisation de la commande import, consultez la page de référence de la commande alloydb 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 CSV dans le bucket. Pour obtenir de l'aide concernant l'importation de fichiers dans des buckets, consultez la page Importer des objets.

3. Accordez au compte de service des autorisations pour le bucket Cloud Storage pour l'opération d'importation. Utilisez le format de compte de service pour identifier le compte de service du projet dans lequel vous importez. Le format du compte de service est le suivant:

   service-PROJECT_NUMBER@gcp-sa-alloydb.iam.gserviceaccount.com

4. 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. Pour obtenir de l'aide sur la définition des autorisations IAM, consultez la page Utiliser des autorisations IAM.

5. Importez le fichier.

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

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

   Avant d'utiliser les données de requête ci-dessous, 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_CSV_FILE: chemin d'accès au fichier CSV.
   • USER: utilisateur de l'opération d'importation.
   • DATABASE_NAME: nom d'une base de données dans le cluster AlloyDB.
   • TABLE_NAME: table de la base de données.
   • COLUMNS (facultatif): colonnes à importer.
   • ESCAPE_CHARACTER (facultatif): caractère devant précéder un caractère de données devant être échappé. La valeur de cet argument doit être un caractère en code ASCII hexadécimal. Par exemple, 22 représente un guillemet double.
   • QUOTE_CHARACTER (facultatif): caractère qui contient des valeurs de colonnes contenant un type de données de chaîne. La valeur de cet argument doit être un caractère en code ASCII hexadécimal. Par exemple, 22 représente un guillemet double.
   • FIELD_DELIMITER (facultatif): caractère séparant les valeurs de colonne. La valeur de cet argument doit être un caractère en code ASCII hexadécimal. Par exemple, 2C représente une virgule.

   Corps JSON de la requête :

   {
     "gcsUri": "gs://BUCKET_NAME/PATH_TO_CSV_FILE",
     "database": "DATABASE_NAME",
     "user": "USER",
     "csvImportOptions": {
       "table": "TABLE_NAME",
       "columns": ["COLUMN1", "COLUMN2"],
       "fieldDelimiter": "FIELD_DELIMITER",
       "quoteCharacter": "QUOTE_CHARACTER",
       "escapeCharacter": "ESCAPE_CHARACTER"
     }
   }
   

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

   curl (Linux, macOS ou Cloud Shell)

   Enregistrez le corps de la requête dans un fichier nommé request.json et 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)

   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 semblable à celle-ci:

   Réponse

   {
    "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID",
    "metadata": {
     "@type": "type.googleapis.com/google.cloud.alloydb.v1.OperationMetadata",
     "createTime": "2024-09-17T06:05:31.244428646Z",
     "target": "projects/project-id/locations/location-id/clusters/target-cluster",
     "verb": "import",
     "requestedCancellation": false,
     "apiVersion": "v1"
    },
    "done": false
   }
   

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

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

gcloud

gcloud alloydb clusters import CLUSTER_NAME --region=REGION --database=DATABASE_NAME --gcs-uri='gs://BUCKET_NAME/PATH_TO_CSV_FILE' --user=USERNAME --table=TABLE_NAME --columns=COLUMNS --field-delimiter='2C' --quote-character='22' --escape-character='5C' --csv

REST v1

Le corps de requête API REST équivalent ressemble à ceci:

{
 "gcsUri": "gs://BUCKET_NAME/PATH_TO_CSV_FILE",
 "database": "DATABASE_NAME",
 "user": "USER",
 "csvImportOptions": {
     "table": "TABLE_NAME",
     "columns": ["COLUMN1", "COLUMN2"],
     "escapeCharacter": "5C",
     "quoteCharacter": "22",
     "fieldDelimiter": "2C",
 }
}

Pour découvrir comment est formée la requête d'API REST sous-jacente pour cette tâche, consultez la page clusters:import dans APIs Explorer.

gcloud

Exécutez ce qui suit à l'aide de la commande gcloud alloydb operations describe:

gcloud alloydb operations describe OPERATION_ID --region=REGION

L'état de ces opérations est indiqué dans le champ STATUS.

Vous pouvez également répertorier 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 ci-dessous, 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 la section Avant de commencer.

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

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

$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

Vous recevez une réponse JSON semblable à celle-ci:

Si la requête aboutit, le corps de la réponse contient une instance d'Opération.