Google utilise la technologie IA pour traduire le contenu dans votre langue préférée. Les traductions générées par IA peuvent contenir des erreurs.

Importer un fichier CSV

Pour charger des données tabulaires dans une table de base de données existante, vous pouvez importer un fichier CSV stocké dans un bucket Cloud Storage dans un cluster AlloyDB pour PostgreSQL.

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

Avant de commencer

Avant de commencer une opération d'importation :

Assurez-vous que votre base de données dispose d'un espace 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 des clusters 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 :

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 la page Identity and Access Management.

Importer des données à partir d'un fichier CSV dans des clusters AlloyDB

La base de données et la table dans lesquelles vous procédez à l'importation doivent exister sur votre cluster AlloyDB. Pour obtenir de l'aide sur la création d'une base de données, consultez Créer une base de données.
Les fichiers CSV doivent comporter une ligne par rangée de données ainsi que des champs séparés par une virgule.
Les fichiers CSV ne doivent pas contenir de ligne d'en-tête. Si votre fichier CSV comporte une ligne d'en-tête, supprimez-la avant l'importation.

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

Console

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

accéder aux clusters
Cliquez sur le nom d'un cluster pour ouvrir la page Vue d'ensemble de ce cluster.
Cliquez sur Importer.
Dans Format de fichier, sélectionnez CSV.
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 CSV 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 CSV 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 CSV dans un bucket Cloud Storage.
Dans le menu déroulant Base de données, sélectionnez la base de données dans laquelle vous souhaitez importer les données.
Sélectionnez la table dans la base de données dans le menu déroulant Table.
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.
Pour lancer l'opération d'importation, cliquez sur Importer.

gcloud

Créez un bucket Cloud Storage.
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.
Utilisez gcloud storage buckets add-iam-policy-binding pour accorder le rôle IAM storage.objectViewer au compte de service AlloyDB pour le 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.
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
```
Remarque : Vous pouvez importer un fichier compressé (.gz) ou non compressé (.csv).

Remplacez les éléments 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 pour l'opération d'importation.
- TABLE_NAME : table de la base de données.
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.
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

Créez un bucket Cloud Storage.
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.
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 :
```
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.
Importez le fichier.

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

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_CSV_FILE : chemin d'accès au fichier CSV.
- USER : utilisateur pour 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 au format hexadécimal ASCII. 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 au format hexadécimal ASCII. Par exemple, 22 représente un guillemet double.
- FIELD_DELIMITER (facultatif) : caractère qui divise les valeurs de la colonne. La valeur de cet argument doit être un caractère au format hexadécimal ASCII. 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)

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": "2024-09-17T06:05:31.244428646Z",
  "target": "projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID",
  "verb": "import",
  "requestedCancellation": false,
  "apiVersion": "v1"
 },
 "done": false
}
```
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.

Personnaliser le format CSV et importer le fichier

Vous pouvez personnaliser le format CSV et importer le fichier lorsque le fichier CSV contient un délimiteur de champ, un guillemet ou un caractère d'échappement non défini par défaut. Pour importer un fichier CSV dont le format n'est pas celui par défaut, vous devez fournir les mêmes options de mise en forme dans la requête.

Utilisez les exemples de gcloud CLI et d'API REST suivants pour personnaliser le format de votre fichier CSV.

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 dédiée à la méthode clusters.import dans APIs Explorer.

Si vous obtenez une erreur telle que INVALID_ARGUMENT, vérifiez que la table existe bien. Si tel est le cas, confirmez que vous disposez des autorisations appropriées sur le bucket. Pour vous aider à configurer le contrôle des accès dans Cloud Storage, consultez la page Créer et gérer des listes de contrôle d'accès.

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 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 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)

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)

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 SQL.
Découvrez comment annuler une opération d'importation.

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

Avant de commencer

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

Importer des données à partir d'un fichier CSV dans des clusters AlloyDB

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Réponse

Personnaliser le format CSV et importer le fichier

gcloud

REST v1

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

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Étapes suivantes

Importer un fichier CSV