Connecteur source Shopify

Le connecteur source Shopify permet à DataSync de récupérer les données de Shopify pour les charger ou les synchroniser dans un entrepôt de données. La connexion s'effectue via la GraphQL Admin API de Shopify, qui donne accès aux données de la boutique, notamment les produits, les commandes et les clients.

Shopify publie une nouvelle version de son API chaque trimestre, et le connecteur est mis à jour en conséquence. DataSync propose deux modes d'authentification : Personal Access Token et OAuth 2.0.

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

Opérations en bloc

L'option Utiliser les opérations en bloc est recommandée pour les volumes de données importants. Sans elle, l'API Shopify limite la quantité de données récupérables par requête, ce qui peut ralentir ou interrompre la synchronisation. Une seule opération en bloc doit s'exécuter à la fois pour éviter tout problème de synchronisation.

Étape 1 : configurer une application personnalisée dans Shopify

La connexion entre DataSync et Shopify nécessite la création d'une application personnalisée Shopify. Pour plus de détails, consultez la documentation Shopify Build et Applications personnalisées documentation for full details.

1. Dans le coin supérieur droit de Shopify, sélectionnez votre nom.
2. Sélectionnez Aller à l'administration.
3. Cliquez sur Paramètres, puis Applications et canaux de vente.
4. Sélectionnez Développer des applications.
5. Cliquez sur Créer une application personnalisée.
6. Saisissez un nom pour l'application.
7. Sélectionnez un Développeur d'application (compte propriétaire ou collaborateur).
8. Cliquez sur Créer l'application.

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

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 Shopify.
5. Complétez toutes les propriétés de connexion requises.
6. (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.
7. Configurez les paramètres avancés selon votre environnement, notamment le Type de suivi.
8. Cliquez sur Enregistrer.

Propriétés de la connexion

Propriété	Description
Description	Nom unique attribué à la connexion. Exemple : Shopify.
URL Shopify	URL complète de la boutique Shopify. Exemple : https://mystore.myshopify.com.
Version API	Shopify API version à utiliser (documentation en anglais uniquement). Valeurs possibles : 2023‑04, 2023‑07, 2023‑10, 2024‑01, 2024‑04, 2024‑07, 2024‑10, 2025‑01, 2025‑04, 2025‑07.
Mode d'authentification	Mode correspondant au type d'application Shopify créée. OAuth2 pour les applications créées dans le Partner Dashboard de Shopify. PersonalAccessToken pour les applications créées dans l'interface d'administration Shopify.
URL de rappel	OAuth 2.0 uniquement URL générée automatiquement par DataSync après l'authentification. Doit être ajoutée à la liste URL de rappel dans la section Configuration de l'application Shopify.
Identité du client	OAuth 2.0 uniquement AIdentifiant de l'application attribué lors de son enregistrement. Visible dans la section Aperçu de l'application dans le Partner Dashboard. Exemple : 1234567890abcdef.
Secret du client	OAuth 2.0 uniquement Valeur confidentielle connue uniquement par le propriétaire de l'application et par Shopify. Exemple : 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.
Privilèges d'accès	OAuth 2.0 uniquement Liste des portées d'accès à l'API Shopify (documentation en anglais uniquement) demandées par le connecteur. Les portées par défaut sont présélectionnées. Certains points de terminaison peuvent nécessiter l'ajout de portées supplémentaires.
Jeton d'accès personnel	Personal Access Token uniquement Jeton généré lors de la création de l'application dans l'interface d'administration Shopify. Affiché une seule fois, à conserver en lieu sûr avant de fermer la page. Donne accès aux données de la boutique via l'Admin API. Exemple : shpat_abc123def456ghi789jkl012mno345pq.
Utiliser les opérations en bloc	Active les opérations en bloc Shopify pour la récupération des données via GraphQL. Recommandé pour les volumes de données importants. Les requêtes en bloc sont créées automatiquement. Une seule opération en bloc doit rester active à la fois.
Possède un compte Shopify Plus	Indique que l'application est installée sur un compte Shopify Plus. Ajoute des colonnes et des tables propres aux fonctionnalités Plus.
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.
Délai	Durée en secondes avant l'expiration d'une tentative de connexion ou d'une exécution de requête.

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 Shopify 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 Shopify.
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 avec Personal Access Token

Une connexion source Shopify avec Personal Access Token entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.

Exemple de configuration avec OAuth 2.0

Une connexion source Shopify avec OAuth 2.0 entièrement configurée dans DataSync, avec toutes les propriétés et tous les paramètres complétés.