Skip to main content
Formulaire de configuration de la source GCS

Présentation

La source GCS (Google Cloud Storage) récupère des fichiers de données depuis un bucket GCS. Utilisez-la lorsque vos données sont stockées sous forme de fichiers dans Google Cloud et que vous souhaitez les importer dans Reelevant pour la personnalisation.

Configuration

Champs obligatoires

Champs optionnels

Le rôle minimum requis est Storage Object Viewer (roles/storage.objectViewer) sur le bucket cible.

Formats de fichiers pris en charge

GCS détecte automatiquement le format du fichier. Les formats suivants sont pris en charge :
Les fichiers compressés (.gz, .zip) sont automatiquement décompressés avant le parsing.

Déchiffrement PGP

La source GCS prend en charge les fichiers chiffrés PGP. Lorsque pgpPrivateKey est configuré, les fichiers sont déchiffrés de manière transparente avant la décompression et le parsing. Les fichiers chiffrés armored (.asc) et binary (.pgp, .gpg) sont pris en charge.
Consultez le guide de déchiffrement PGP pour plus de détails sur la génération de clés, les formats pris en charge et la gestion des erreurs.

Chemins wildcards

Vous pouvez utiliser un wildcard (*) dans le chemin du fichier pour correspondre à plusieurs fichiers. Cela est utile lorsque :
  • Un nouveau fichier est exporté périodiquement avec un nom différent (par ex. exports/products_20240101.csv, exports/products_20240102.csv)
  • Les données sont réparties sur plusieurs fichiers dans le même répertoire
Exemples de patterns :
  • exports/products_*.csv — correspond à tous les fichiers CSV commençant par products_ dans le dossier exports/
  • data/*.json — correspond à tous les fichiers JSON dans le dossier data/

Modes de traitement des fichiers

Lors de l’utilisation de chemins wildcards, vous pouvez configurer la manière dont les fichiers sont sélectionnés via le champ processType :

Fonctionnement

  1. Reelevant s’authentifie avec les identifiants de compte de service fournis.
  2. Le bucket et le chemin spécifiés sont accédés. Si un wildcard est utilisé, les fichiers correspondants sont listés.
  3. Les fichiers sont téléchargés, décompressés si nécessaire, et parsés selon le format détecté.
  4. Les champs sont extraits et rendus disponibles pour le mapping.
  5. Lors des synchronisations suivantes, les fichiers sont rerécupérés selon le mode de traitement configuré.
Assurez-vous que le compte de service dispose d’un accès en lecture au bucket et aux objets spécifiés. Le rôle minimum requis est Storage Object Viewer.