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 Admin GraphQL de Shopify, vous permettant d'interroger les données Shopify telles que les produits, les commandes et les clients avec une grande performance et flexibilité. Ce connecteur rationalise les flux de données et améliore l'évolutivité des intégrations Shopify.

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

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 mieux adaptées aux réplications à grande échelle car l'API GraphQL de Shopify a des limites basées sur le coût par requête ; en utilisant des opérations en masse, on évite le throttling.
• Ne lancez qu’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 sur Build et Custom Apps pour tous les détails.

1. Dans le coin supérieur droit de Shopify, cliquez sur 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. 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. À partir de 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 la connexion, entrez les propriétés de connexion.
6. (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é.
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 Enregistrer.

Paramètres

Propriétés de la 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 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 de Shopify pour plus de détails
Mode d'authentification	Méthode d'authentification : OAuth2 – Applications personnalisées créées dans le Tableau de bord des partenaires Shopify. PersonalAccessToken – Applications personnalisées créées dans l'administration Shopify.
URL de rappel	URL générée automatiquement fournie après l'authentification dans DataSync. Cela doit être mis sur liste blanche dans la section Configuration de l'application Shopify sous les URL de rappel.
Identité du client	Identifiant de l'application assigné lors de l'enregistrement. Trouvé dans la section Aperçu de l'application dans le Tableau de bord des partenaires. Exemple: 1234567890abcdef
Secret du client	Valeur confidentielle connue uniquement du propriétaire de l'application et de Shopify. Exemple: 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
Privilèges d'accès	Liste des portées d'accès à l'API Shopify demandées par le connecteur. Les défauts sont pré-sélectionnés ; certains points de terminaison peuvent nécessiter l'ajout de portées supplémentaires. Consultez Portées d'accès à l'API Shopify pour plus de 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é une seule fois ; à conserver en sécurité. Accorde un accès à l'API Admin aux données sensibles du magasin.
Utiliser les opérations en bloc	Paramètre qui active les opérations en masse de Shopify pour le schéma GraphQL. Convient pour la récupération de données à grande échelle. Les requêtes en masse sont créées automatiquement. Il est recommandé de maintenir les opérations en masse parallèles à un seul travail actif.
Possède un 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 Plus.
Verbosité	1 – Journaliser les requêtes, les comptes de lignes, le début/de la 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 requête/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	Temps en secondes à attendre pour l'ouverture de la connexion et l'exécution de la requête avant le délai d'attente.

Autres propriétés de la connexion

Propriétés de 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 Crypé. En sélectionnant Crypé, vous cachez la valeur de l'interface et la stockez chiffrée dans le back-end, 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 la façon dont 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 fin pour la performance et l'exactitude, et doivent être configurées selon votre environnement système et vos besoins opérationnels.

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 de l'application Shopify.
Décalage horaire	Décalage de rafraîchissement en secondes pour compenser les problèmes de synchronisation lors de la sélection des enregistrements. La valeur minimale est 0; la valeur maximale est 3600 secondes.
Taille du 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 selon votre vitesse réseau et la performance du disque ; dans la plupart des cas, la valeur par défaut (2000) fonctionne le mieux.