Référence du connecteur Shopify
Bêta
Cette fonctionnalité est en version bêta. Pour l’utiliser, un administrateur du workspace doit activer Lakeflow Connect for Shopify depuis la page Previews . Consultez Gérer les aperçus Databricks.
Cette page contient des informations de référence pour le connecteur Shopify géré, y compris les tables sources prises en charge et les schémas de tables de destination.
Tables sources prises en charge
Le connecteur Shopify prend en charge les tables sources suivantes, toutes situées sous le schéma source default :
Table source | Clé primaire | Description | Mode de synchronisation | Champ de curseur |
|---|---|---|---|---|
|
| Produits de votre boutique, incluant le titre, le statut, le fournisseur et l’inventaire total. | Incrémentiel |
|
|
| Commandes passées dans votre boutique, y compris le statut financier, le statut d’exécution et la devise. | Incrémentiel |
|
|
| Profils clients, comprenant le nom, les coordonnées et le nombre de commandes. | Incrémentiel |
|
|
| Commandes brouillons créées dans votre boutique, y compris le statut et l’heure de réalisation. | Incrémentiel |
|
|
| Collections de produits de votre boutique, y compris le titre, le handle, et l'ordre de tri. | Incrémentiel |
|
|
| Collections de produits sélectionnées manuellement. | Incrémentiel |
|
|
| Collections de produits automatisées, comprenant l'ensemble de règles qui détermine l'appartenance. | Incrémentiel |
|
|
| Articles de blog de votre boutique en ligne, incluant le statut de publication. | Incrémentiel |
|
|
| Pages de la boutique en ligne, y compris le statut de publication. | Incrémentiel |
|
|
| Variantes de produit, y compris le SKU, le prix, le code-barres et la quantité en stock. | Incrémentiel |
|
|
| Blogs de votre boutique en ligne. | Incrémentiel |
|
|
| Articles d’inventaire, incluant le SKU et l’indication du suivi de l’article. | Incrémentiel |
|
|
| Remises basées sur le code, y compris la configuration de la remise. | Incrémentiel |
|
|
| Remises automatiques, y compris la configuration des remises. | Incrémentiel |
|
|
| Emplacements des boutiques, y compris si chacune expédie des stocks et traite les commandes en ligne. | Refresh uniquement | |
|
| Profil de la boutique, y compris le domaine, la devise et le fuseau horaire. | Refresh uniquement | |
|
| Transactions de vente, incluant le moyen de paiement et le montant. | Incrémentiel |
|
|
| Associations entre les produits et les collections personnalisées. | Refresh uniquement | |
|
| Litiges de paiement et refusions de débit, y compris le statut et les délais pour les éléments de preuve. | Refresh uniquement | |
|
| Paiements abandonnés, y compris les totaux et l’URL de récupération. | Incrémentiel |
|
|
| Commandes traitées, y compris le statut et l'emplacement attribué. | Incrémentiel |
|
|
| Fichiers d’image de la médiathèque de votre boutique. | Incrémentiel |
|
|
| Tous les fichiers multimédias de la bibliothèque multimédia de votre boutique, y compris les images, les vidéos et les modèles 3D. | Incrémentiel |
|
|
| Pays configurés pour l’expédition et les taxes, y compris les provinces. | Refresh uniquement | |
|
| Transactions du solde Shopify Payments, incluant le montant, les frais et le net. | Incrémentiel |
|
|
| Transactions de paiement des commandes, y compris le type, la passerelle, le statut et le montant. | Incrémentiel |
|
|
| Remboursements émis sur les commandes, y compris les détails du réapprovisionnement et des postes. | Incrémentiel |
|
|
| Exécutions de commandes, y compris le suivi et le statut des expéditions. | Incrémentiel |
|
|
| Lignes d’articles incluses dans les remboursements de commandes, y compris la quantité et le type de réapprovisionnement. | Incrémentiel |
|
|
| Ajustements appliqués aux remboursements de commandes, y compris le montant et le motif. | Incrémentiel |
|
|
| Médias joints aux variantes de produits, incluant des images, des vidéos, et des modèles 3D. | Incrémentiel |
|
|
| Lignes d'expédition sur les commandes, incluant le transporteur et les tarifs. | Incrémentiel |
|
|
| Accords de ventes sur les commandes, y compris le type et le motif. | Incrémentiel |
|
|
| Évaluations des risques de fraude pour les commandes, y compris la recommandation. | Incrémentiel |
|
|
| Adresses des clients, y compris la ville, la province, le pays et le code postal. | Incrémentiel |
|
|
| Postes de commande sur les ordres de traitement, incluant la quantité totale et restante. | Incrémentiel |
|
|
| Utiliser des codes promotionnels pour des remises basées sur le code, y compris le nombre d’utilisations. | Incrémentiel |
|
|
| Associations entre les collections et les produits qu’elles contiennent. | Refresh uniquement | |
|
| Niveaux d’inventaire par article et par emplacement, incluant les quantités disponibles, en stock et réservées. | Refresh uniquement |
Options du connecteur
Consultez la section Exemples pour connaître l’utilisation.
Option | Type | Périmètre | Obligatoire | S'applique à | Description |
|---|---|---|---|---|---|
| Chaîne ( | Pipeline | Non | Toutes les tables incrémentielles | Date et heure les plus anciennes à partir desquelles ingérer des données. Default to 365 days before the first sync. S’applique uniquement à la première synchronisation de chaque table ; les synchronisations ultérieures reprennent à partir du curseur stocké. |
Schémas de table de destination
products
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
orders
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
customers
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
draft_orders
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
collections
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
custom_collections
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
smart_collections
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
articles
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
pages
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
product_variants
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
blogs
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
inventory_items
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
discount_codes
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
discount_automatic
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
locations
Primary key: id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
shop
Primary key: id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
tender_transactions
Clé principale : id
Champ de curseur : processedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
collects
Primary key: id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
disputes
Primary key: id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
abandoned_checkouts
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
fulfillment_orders
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
media_image
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
media
Clé principale : id
Champ de curseur : updatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
countries
Primary key: id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
balance_transactions
Clé principale : id
Champ de curseur : transactionDate
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
transactions
Clé principale : id
Champ de curseur : created_at
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
order_refunds
Clé principale : id
Champ de curseur : created_at
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
fulfillments
Clé principale : id
Champ de curseur : updated_at
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
order_line_refund
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
order_adjustment
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
product_variant_media
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
order_shipping_line
Clé principale : id
Champ de curseur : parentUpdatedAt
Les lignes d’expédition supprimées sont capturées par le biais de la colonne isRemoved.
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
order_agreements
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
order_risks
Clé principale : order_id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
customer_address
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
fulfillment_order_line_item
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
discount_redeem_code
Clé principale : id
Champ de curseur : parentUpdatedAt
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
Cette table ne prend pas en charge le SCD de type 2, car elle contient des colonnes VARIANT.
collection_product
Primary key: collection_id, product_id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
inventory_level
Primary key: id
Sync mode: Full refresh only
Champ | Type de données |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Périmètres d’accès requis
L’application Shopify doit être autorisée pour les périmètres d’accès à l’API Admin suivants. Les périmètres requis par le connecteur dépendent des tables que vous ingérez. Pour en savoir plus, consultez la référence des périmètres d’accès Shopify.
Périmètre d'accès | Requis pour |
|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
- Pour ingérer les commandes et les tables dérivées de commandes (telles que
orders,transactions,order_refundsetfulfillments) de plus de 60 jours, l’application nécessite également l’étendueread_all_orders, combinée avecread_orders. Shopify accorderead_all_orderssur approbation. Sans cela,read_ordersne renvoie que les commandes des 60 derniers jours. - Les tables
balance_transactionsetdisputesnécessitent Shopify Payments sur la boutique. - Certains champs
customers,customer_addresset de commande sont des données client protégées. Shopify renvoie ces champs provenant de boutiques autres que de développement uniquement après que l’application a rempli les conditions requises relatives aux données client protégées. Consultez la référence des périmètres d’accès Shopify.