Connecteur source Google Sheets

Le connecteur source Google Sheets dans DataSync vous permet de récupérer des données depuis Google Sheets pour les charger ou les synchroniser dans votre entrepôt de données. Avant de commencer, vous devez disposer d’un compte Google et créer un client OAuth dans Google Cloud Console afin que DataSync puisse s’authentifier.

Après avoir créé toutes les connexions sources requises, configurez votre connexion de destination pour finaliser la configuration.

important

Authentifiez-vous avec le même compte Google que celui utilisé pour créer le projet Google Cloud et le client OAuth.

Activer les API requises

1. Dans Google Cloud Console, sélectionnez API et services, puis API et services activés.
2. Si vous avez plusieurs projets, vérifiez que le bon projet est sélectionné.
3. Cliquez sur + Activer les APIs et services.
4. Dans la barre de recherche, entrez Google Sheets, puis appuyez sur Entrée.
5. Sélectionnez API Google Analytics et cliquez sur Activer.
6. Dans la barre de recherche, entrez Google Drive, puis appuyez sur Entrée.
7. Sélectionnez API Google Drive et cliquez sur Activer.

Créer des identifiants OAuth

1. Dans Google Cloud Console, sélectionnez APIs et services, puis Identifiants.
2. Cliquez sur + Créer des identifiants, puis ID client OAuth.
3. Dans Type d'application, sélectionnez Application web.
4. Dans Origines JavaScript autorisées, ajoutez l’URL de votre serveur DataSync et le domaine de votre entreprise.
5. Laissez URI de redirection autorisés vide pour le moment.
6. Sélectionnez Créer, puis notez le Client ID et le Client secret pour les renseigner plus tard dans DataSync.

remarque

Les valeurs dans Origines JavaScript autorisées doivent être des URL valides (par exemple, se terminant par .com ou .net).

Créer une connexion source dans DataSync

1. Connectez-vous à DataSync.
2. À partir de l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions sources, cliquez sur Nouveau.
4. Sélectionnez Google Sheets.
5. Dans le panneau Propriétés de la connexion, saisissez les valeurs requises.
6. Copiez l'URL de rappel affichée dans Propriétés de connexion.
7. Dans Google Cloud Console, allez à APIs et services, puis Identifiants.
8. Sélectionnez votre client OAuth, puis ajoutez l’URL de rappel de DataSync dans URI de redirection autorisés. Cliquez sur Sauvegarder.
9. (Optionnel) Dans le panneau Autres propriétés de la connexion, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
10. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
11. Cliquez sur Enregistrer, puis terminez la connexion Google et l’écran de consentement.

Paramètres

Propriétés de la connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : Google Sheets
URL de rappel	URL générée par DataSync à ajouter dans URI de redirection autorisés dans la Google Cloud Console.
Identité du client	ID client OAuth disponible dans la Google Cloud Console > API et services > Identifiants. Exemple : 1234567890-abc.apps.googleusercontent.com
Secret du client	Secret client OAuth disponible dans la Google Cloud Console > API et services > Identifiants. Exemple : XyZ123_ABCD
Verbosité	1 – Journaliser les requêtes, les comptes de ligne, le début/fin d'exécution, les erreurs. 2 – Inclut le niveau 1 plus les requêtes de cache, les en-têtes HTTP. 3 – Inclut le niveau 2 plus les corps des requêtes/réponses. 4 – Inclut le niveau 3 plus la communication au niveau transport. 5 – Inclut le niveau 4 plus toutes les commandes de l'interface.
Délai d'inactivité du Pool	Temps d'inactivité maximum pour les connexions avant de les renvoyer au pool, en secondes.
Taille maximale du Pool	Nombre maximum de connexions autorisées dans le pool.
Temps d'attente du Pool	Temps d'attente maximal pour l'allocation de connexion avant qu'une erreur ne soit déclenchée, en secondes.

Autres propriétés de la connexion

Propriétés supplémentaires de chaîne de connexion non spécifiées dans le panneau Propriétés de connexion. Pour chaque propriété ajoutée, vous pouvez choisir Visible ou Crypé. En sélectionnant Crypé, la valeur est masquée de l'interface et stockée chiffrée dans l'arrière-plan, comme lors de la définition de mots de passe.

Paramètre	Description
Propriété	Propriété de chaîne de connexion qui définit l'action ou le comportement. Exemple : ReadOnly
Valeur	Valeur pour la propriété. Exemple : True
Type	Visibilité de la propriété : Visible ou Crypé.

Paramètres avancés

Les paramètres avancés contrôlent comment le connecteur Google Sheets suit les modifications, gère la configuration régionale et temporelle, et traite les lots de données pendant l'extraction. Ces options permettent un ajustement précis pour la performance et l'exactitude, et doivent être configurées en fonction de votre environnement système et de vos exigences opérationnelles.

Paramètre	Description
Type de suivi	Méthode de suivi des modifications : Aucun ou Date.
Région	Paramètre de région pour le connecteur, si nécessaire pour votre configuration.
Fuseau horaire	Fuseau horaire correspondant au serveur d'application Google Sheets.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de timing dans la sélection des enregistrements. La valeur minimale est 0 ; le maximum est de 3600 secondes.
Taille de lot	Quantité d'enregistrements traités dans chaque lot pendant l'extraction. Des tailles de lot plus grandes augmentent l'utilisation de la mémoire mais peuvent améliorer les performances jusqu'à un certain point. La valeur par défaut est de 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez en fonction de la vitesse de votre réseau et de la performance de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.