Connecteur source Google Sheets

Le connecteur source Google Sheets permet à DataSync de récupérer les données de Google Sheets et de les charger dans un entrepôt de données. Avant de commencer, un compte Google et un client OAuth configuré dans Google Cloud Console sont nécessaires pour permettre l'authentification de DataSync. La configuration se fait en deux parties qui se référencent mutuellement : la création d'un client OAuth dans Google Cloud Console pour autoriser l'accès de DataSync, puis la création d'une connexion source dans DataSync à partir des identifiants de ce client. Il est conseillé de garder Google Cloud Console et DataSync ouverts côte à côte pendant ces étapes.

Une fois la connexion source créée, configurez la connexion de destination pour finaliser l'installation.

important

L'authentification doit se faire avec le même compte Google que celui utilisé pour créer le projet Google Cloud et le client OAuth.

Étape 1 : configurer Google Cloud

Créer ou sélectionner un projet Google Cloud

1. Accédez à la Google Cloud Console.
2. Connectez-vous avec le compte Google.
3. Sélectionnez Sélectionner un projet, puis effectuez l'une des actions suivantes :
   • Sélectionnez un projet existant.
   • Sélectionnez Nouveau projet, saisissez un nom et un emplacement, puis cliquez sur Créer.

Activer les API requises

1. Dans Google Cloud Console, sélectionnez API et services, puis API et services activés.
2. Si plusieurs projets existent, vérifiez que le bon projet est sélectionné.
3. Sélectionnez Activer les API et services.
4. Recherchez Google Sheets API et cliquez sur Activer.
5. Recherchez Google Drive API et cliquez sur Activer.

Créer les identifiants OAuth

1. Dans Google Cloud Console, accédez à API et services, puis Identifiants.
2. Sélectionnez Créer des identifiants, puis ID client OAuth.
3. Sous Type d'application, sélectionnez Application web.
4. Sous Origines JavaScript autorisées, ajoutez l'URL du serveur DataSync et le domaine de l'entreprise.
5. Laissez URI de redirection autorisés vide pour le moment.
6. Cliquez sur Créer, puis copiez l'ID client et le Secret client pour usage ultérieur.

remarque

Les valeurs dans Origines JavaScript autorisées doivent être des URL valides se terminant par une extension de domaine comme .com ou .net.

Étape 2 : créer la connexion source dans DataSync

Configurer la connexion

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions de la source, cliquez sur Nouveau.
4. Sélectionnez Google Sheets.
5. Complétez toutes les propriétés de connexion requises.
6. Copiez l'URL de rappel depuis le panneau Propriétés de la connexion.

Ajouter l'URL de rappel dans Google Cloud Console

1. Dans Google Cloud Console, accédez à API et services, puis Identifiants.
2. Sélectionnez le client OAuth.
3. Sous URI de redirection autorisés, ajoutez l'URL de rappel.
4. Cliquez sur Sauvegarder.

Authentifier et autoriser

1. (Facultatif) Dans le panneau Autres propriétés de la connexion, cliquez sur Ajouter une propriété et définissez les paramètres supplémentaires nécessaires.
2. Configurez les paramètres avancés selon votre environnement, notamment le Type de suivi.
3. Cliquez sur Enregistrer et terminez les étapes de connexion et de consentement Google.

Propriétés de la connexion

Propriété	Description
Description	Nom unique attribué à la connexion. Exemple : Google Sheets.
URL de rappel	URL de redirection générée automatiquement par DataSync. Doit être ajoutée aux URI de redirection autorisés du client OAuth Google Cloud.
ID client	ID client OAuth disponible sous API et services > Identifiants dans Google Cloud Console. Exemple : 1234567890-abc.apps.googleusercontent.com.
Secret client	Secret client OAuth disponible sous API et services > Identifiants dans Google Cloud Console. Exemple : xK8mNpL7vRtYw2cDjHs9bEuFgAiZo3qB.
Verbosité	Contrôle le niveau de détail écrit dans le journal. Chaque niveau inclut tout ce qui précède plus des informations supplémentaires. 1 enregistre les requêtes, les nombres de lignes, les heures de début et de fin d'exécution ainsi que les erreurs. 2 ajoute les requêtes de cache et les en-têtes HTTP. 3 ajoute les corps de requête et de réponse. 4 ajoute la communication au niveau du transport. 5 ajoute toutes les commandes d'interface.
Activer le pooling	Active le pooling de connexions, qui conserve un ensemble de connexions ouvertes et les réutilise entre les extractions au lieu d'ouvrir une nouvelle connexion à chaque fois. Réduit la charge et améliore les performances lorsque plusieurs extractions s'exécutent en même temps.
Délai d'inactivité du pool	Temps d'inactivité maximal en secondes avant qu'une connexion soit retournée au pool.
Taille maximale du pool	Nombre maximum de connexions autorisées dans le pool en même temps.
Temps d'attente du pool	Temps d'attente maximal en secondes pour obtenir une connexion avant qu'une erreur ne soit générée.

Autres propriétés de la connexion

Ce panneau permet d'ajouter des propriétés de chaîne de connexion qui ne figurent pas dans le panneau Propriétés de la connexion. Pour les valeurs sensibles comme les mots de passe, choisissez le type Crypté. La valeur reste alors masquée dans l'interface et stockée de façon chiffrée côté serveur.

Propriété	Description
Propriété	Propriété de la chaîne de connexion définissant l'action ou le comportement. Exemple : ReadOnly.
Valeur	Valeur associée à la propriété. Exemple : True.
Type	Visibilité de la valeur : Visible ou Crypté.

Paramètres avancés

Ces paramètres déterminent la façon dont le connecteur suit les modifications de données, gère l'heure et la région, et traite les enregistrements pendant l'extraction. Ajustez-les selon votre environnement Google Sheets afin que les résultats restent exacts et cohérents.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications de données : Aucun ou Date.
Region	Paramètre régional du connecteur, si la configuration l'exige.
Fuseau horaire	Fuseau horaire correspondant à l'environnement Google Sheets.
Décalage de temps	Décalage d'actualisation en secondes pour compenser les écarts de synchronisation lors de la sélection des enregistrements. Minimum 0, maximum 3600.
Taille du lot	Nombre d'enregistrements traités par lot lors de l'extraction. Des lots plus grands peuvent améliorer les performances mais consomment davantage de mémoire. La valeur par défaut est 2000, le maximum est 10000. À ajuster selon la vitesse du réseau et les performances du disque. La valeur par défaut convient dans la plupart des cas.

Exemple de configuration

Connexion source Google Sheets entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.