Connecteur Source Shopify

Le connecteur source Shopify dans DataSync vous permet de récupérer des données depuis Shopify pour les charger ou les synchroniser dans votre entrepôt de données. Il facilite l'intégration transparente avec l'API GraphQL Admin de Shopify, vous permettant de requêter des données Shopify telles que des produits, des commandes et des clients avec une grande performance et flexibilité. Ce connecteur rationalise les flux de données et améliore la scalabilité des intégrations Shopify.

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

Limitations

• Shopify publie une nouvelle version de l'API chaque trimestre, et le connecteur est mis à jour en conséquence.
• L'option Utiliser des opérations en masse applique un schéma spécifique aux opérations en masse ; sans cela, le schéma diffère.
• Les opérations en masse sont souvent meilleures pour la réplication à grande échelle car l'API GraphQL de Shopify a des limites de coûts par requête ; utiliser des opérations en masse évite le throttling.
• Exécutez uniquement une opération en masse à la fois pour éviter les problèmes de synchronisation.

Configurer une application personnalisée dans Shopify

Pour connecter DataSync à Shopify, vous devez créer une application Shopify personnalisée. Consultez la documentation de Shopify sur Créer et Applications personnalisées pour plus de détails.

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

Créer des connexions source dans DataSync

1. Connectez-vous à DataSync.
2. Depuis l'écran d'accueil, sélectionnez Connexions.
3. À côté de Connexions Sources, cliquez sur Nouveau.
4. Sélectionnez Shopify.
5. Dans le panneau Propriétés de connexion, saisissez les propriétés de connexion.
6. (Facultatif) 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é.
7. Dans le panneau Paramètres Avancés, configurez les paramètres, y compris le Type de suivi et d'autres valeurs selon vos besoins.
8. Cliquez sur Sauvegarder.

Paramètres

Propriétés de connexion

Paramètre	Description
Description	Nom unique pour la connexion. Exemple : Shopify
URL Shopify	URL complète de la boutique Shopify. Exemple : https://mystore.myshopify.com
Version de l'API	Version de l'API Shopify à utiliser. Valeurs autorisées : 2023‑04, 2023‑07, 2023‑10, 2024‑01, 2024‑04, 2024‑07, 2024‑10. Consultez Versioning Shopify pour plus de détails.
Mode d'authentification	Méthode d'authentification : OAuth2 – Applications personnalisées créées dans le tableau de bord Shopify Partner. PersonalAccessToken – Applications personnalisées créées dans l'administration Shopify.
URL de rappel	URL auto-générée fournie après authentification dans DataSync. Celle-ci doit être ajoutée à la liste blanche dans la section Configuration de l'application Shopify sous URL de rappel.
ID du client	Identifiant de l'application attribué lors de l'enregistrement. Trouvé dans la section Aperçu de l'application dans le tableau de bord partenaire. Exemple : 1234567890abcdef
Secret du client	Valeur confidentielle connue uniquement du propriétaire de l'application et de Shopify. Exemple : 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
Scope	Liste des portées d'accès à l'API Shopify demandées par le connecteur. Les valeurs par défaut sont pré-sélectionnées ; certains points de terminaison peuvent nécessiter l'ajout de portées supplémentaires. Voir Portées d'accès à l'API Shopify pour les détails.
Jeton d'accès personnel	(PersonalAccessToken uniquement) Jeton généré lors de la création d'une application dans l'administration Shopify. Affiché uniquement une fois ; à sauvegarder en toute sécurité. Accorde l'accès à l'API Admin pour des données sensibles de la boutique.
Utiliser des opérations en masse	Paramètre qui permet les opérations en masse de Shopify pour le schéma GraphQL. Adapté à la récupération de données à grande échelle. Les requêtes en masse sont créées automatiquement. Il est recommandé de limiter les opérations en masse parallèles à un seul job actif.
Compte Shopify Plus	Paramètre qui spécifie si l'application est installée sur un compte Shopify Plus. Ajoute des colonnes et des tables supplémentaires spécifiques aux fonctionnalités de Plus.
Verbosité	1 – Joue les requêtes, le nombre de lignes, 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 de demande/réponse. 4 – Inclut le niveau 3 plus la communication au niveau du transport. 5 – Inclut le niveau 4 plus toutes les commandes d'interface.
Délai d'attente	Temps en secondes à attendre pour l'ouverture de la connexion et l'exécution de la requête avant le délai d'attente.

Propriétés de connexion supplémentaires

Propriétés de la chaîne de connexion supplémentaires 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é, vous cachez la valeur de l'interface et la stockez de manière chiffrée dans l'arrière-plan, par exemple lors de la définition de mots de passe.

Paramètre	Description
Propriété	Propriété de la 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 Shopify suit les changements, gère la configuration régionale et horaire, et traite les lots de données lors de 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 changements : 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 Shopify.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de timing lors de 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 lors de 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 2000 et le maximum ne doit pas dépasser 10000 enregistrements. Ajustez en fonction de la vitesse de votre réseau et des performances de votre disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.

Exemple