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 avoir un compte Google et créer le projet API requis, activer les services et configurer le consentement OAuth dans la Google Cloud Console.

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

important

Vous devez vous authentifier avec le même compte Google utilisé pour créer le projet API afin de charger des données.

Configurer les paramètres de l'API Google Cloud

Créer un projet

1. Connectez-vous à la Google Cloud Console.
2. Connectez-vous avec votre compte Google.
3. Sous APIs et services activés, cliquez sur Créer un projet.
4. Entrez un nom de projet et sélectionnez l'emplacement.
5. Cliquez sur Créer.

Activer les APIs

1. Sélectionnez votre projet.
2. Cliquez sur + Activer les APIs et services.
3. Dans la barre de recherche, entrez Google Sheets et appuyez sur Entrée.
4. Sélectionnez Google Sheets API et cliquez sur Activer.
5. Dans la barre de recherche, entrez Google Drive et appuyez sur Entrée.
6. Sélectionnez Google Drive API et cliquez sur Activer.

Configurer l'écran de consentement OAuth

1. Sélectionnez l'icône du hamburger dans le coin supérieur gauche pour ouvrir le menu de navigation.
2. Sous Produits, sélectionnez APIs et services, puis Écran de consentement OAuth.
3. Cliquez sur Commencer.
4. Entrez le nom de l'application et l'e-mail de support utilisateur, puis cliquez sur Suivant.
5. Sélectionnez Externe et cliquez sur Suivant.
6. Entrez votre adresse e-mail et cliquez sur Suivant.
7. Acceptez la politique des services API Google et cliquez sur Créer.
8. Dans le panneau de navigation, sélectionnez Marquage.
9. Entrez un nom d'application pour aider à l'identifier.
10. Sous Domaines autorisés, cliquez sur + Ajouter un domaine et entrez le domaine de votre serveur DataSync et le domaine de votre entreprise.
11. Cliquez sur Enregistrer.
12. Dans le panneau de navigation, sélectionnez Accès aux données.
13. Cliquez sur Ajouter ou supprimer des étendues pour définir les autorisations pour cette application.

Créer un ID client OAuth

1. Sélectionnez l'icône du hamburger dans le coin supérieur gauche pour ouvrir le menu de navigation.
2. Sous Produits, sélectionnez APIs et services, puis Identifiants.
3. Cliquez sur + Créer des identifiants, puis sélectionnez ID client OAuth.
4. Dans Type d'application, sélectionnez Application web.
5. Entrez un nom pour l'application.
6. Cliquez sur Créer.
7. Copiez le secret client et l'ID client dans la boîte de dialogue de confirmation.
8. Cliquez sur Ok pour fermer.

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 connexion, entrez les propriétés de connexion.
6. Copiez l'URL de rappel depuis le panneau Propriétés de connexion.
7. Connectez-vous à nouveau à la Google Cloud Console.
8. Dans le menu de navigation, allez à APIs et services et Identifiants.
9. Sous votre entrée de client OAuth, dans URI de redirection autorisés, cliquez sur Ajouter URI.
10. Collez l'URL de rappel et cliquez sur Enregistrer.
11. (Optionnel) Dans le panneau Propriétés de connexion supplémentaires, sélectionnez Ajouter une propriété et entrez les paramètres pour chaque propriété.
12. Dans le panneau Paramètres avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos exigences.
13. Cliquez sur Enregistrer.
14. Vous serez redirigé vers un écran de connexion Google pour vous authentifier. Connectez-vous avec le compte utilisé pour créer le projet API, puis cliquez sur Autoriser pour terminer.

Paramètres

Propriétés de connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : Google Sheets
URL de rappel	URL unique générée dans DataSync qui doit être autorisée dans la liste des URI de redirection autorisés de votre projet Google Cloud.
ID client	Identifiant pour votre client OAuth, disponible dans la Google Cloud Console sous Identifiants. Exemple : 1234567890-abc.apps.googleusercontent.com
Secret client	Clé secrète pour votre client OAuth, disponible dans la Google Cloud Console sous 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'expiration de pool inactif	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.

Propriétés de connexion supplémentaires

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 Chiffré. En sélectionnant Chiffré, 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 Chiffré.

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.

Exemple