Partager via

Copier des données à partir de Shopify à l’aide d’Azure Data Factory ou synapse Analytics

S’APPLIQUE À : Azure Data Factory Azure Synapse Analytics

Conseil

Essayez Data Factory dans Microsoft Fabric, une solution d’analyse tout-en-un pour les entreprises. Microsoft Fabric couvre tous les aspects, du déplacement des données à la science des données, en passant par l’analyse en temps réel, la business intelligence et le reporting. Découvrez comment démarrer un nouvel essai gratuitement !

Cet article explique comment utiliser l’activité de copie dans Azure Data Factory ou Synapse Analytics pour copier des données de Shopify. Il s’appuie sur l’article Vue d’ensemble de l’activité de copie.

Important

Le connecteur Shopify version 1.0 est à l’étape de suppression. Vous êtes recommandé de mettre à niveau le connecteur Shopify de la version 1.0 vers la version 2.0.

Fonctionnalités prises en charge

Ce connecteur Shopify est pris en charge pour les activités suivantes :

Fonctionnalités prises en charge IR
Activité de copie (source/-) (1) (2)
Activité de recherche (1) (2)

① Runtime d’intégration Azure ② Runtime d’intégration auto-hébergé

Pour obtenir la liste des magasins de données pris en charge en tant que sources et récepteurs, consultez la table Magasins de données pris en charge.

La service fournit un pilote intégré qui permet la connexion. Vous n'avez donc pas besoin d'installer manuellement un pilote à l'aide de ce connecteur.

Le connecteur prend en charge les versions Windows de cet article.

La propriété de colonne billing_on a été supprimée des tables Recurring_Application_Charges et UsageCharge en raison de la dépréciation officielle du champ billing_on de Shopify.

Note

Pour la version 2.0, les noms de colonnes conservent la structure Shopify GraphQL, telle que data.customers.edges.node.createdAt. Pour la version 1.0, les noms de colonnes utilisent des noms simplifiés, par exemple Created_At.

Prise en main

Pour effectuer l’activité de copie avec un pipeline, vous pouvez utiliser l’un des outils ou kits sdk suivants :

Créer un service lié à Shopify à l’aide de l’interface utilisateur

Utilisez les étapes suivantes pour créer un service lié à Shopify dans l’interface utilisateur du portail Azure.

  1. Accédez à l’onglet Gérer dans votre espace de travail Azure Data Factory ou Synapse, sélectionnez Services liés, puis cliquez sur Nouveau :

  2. Recherchez Shopify et sélectionnez le connecteur Shopify.

    Capture d’écran du connecteur Shopify.

  3. Configurez les informations du service, testez la connexion et créez le nouveau service lié.

    Capture d’écran de la configuration du service lié pour Shopify.

Détails de configuration du connecteur

Les sections suivantes fournissent des informations sur les propriétés utilisées pour définir les entités Data Factory propres au connecteur Shopify.

Propriétés du service lié

Le connecteur Shopify prend désormais en charge la version 2.0. Reportez-vous à cette section pour mettre à niveau votre version de connecteur Shopify à partir de la version 1.0. Pour plus d’informations sur la propriété, consultez les sections correspondantes.

Version 2.0

Le service lié Shopify prend en charge les propriétés suivantes lors de l’application de la version 2.0 :

Propriété Description Obligatoire
type La propriété de type doit être définie sur Shopify Oui
version Version que vous spécifiez. La valeur est 2.0. Oui
host Point de terminaison du serveur Shopify (autrement dit, mystore.myshopify.com). Oui
accessToken Jeton d’accès d’API qui peut être utilisé pour accéder aux données de Shopify. Le jeton n’expire pas s’il est en mode hors connexion. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault. Oui

Exemple :

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "version": "2.0",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

Version 1.0

Le service lié Shopify prend en charge les propriétés suivantes lors de l’application de la version 1.0 :

Propriété Description Obligatoire
type La propriété de type doit être définie sur Shopify Oui
host Point de terminaison du serveur Shopify (autrement dit, mystore.myshopify.com). Oui
accessToken Jeton d’accès d’API qui peut être utilisé pour accéder aux données de Shopify. Le jeton n’expire pas s’il est en mode hors connexion. Marquez ce champ en tant que SecureString afin de le stocker de façon sécurisée, ou référencez un secret stocké dans Azure Key Vault. Oui
useEncryptedEndpoints Indique si les points de terminaison de la source de données sont chiffrés suivant le protocole HTTPS. La valeur par défaut est true. Non
useHostVerification Indique si le nom d’hôte du certificat du serveur doit correspondre à celui du serveur en cas de connexion TLS. La valeur par défaut est true. Non
usePeerVerification Indique s’il faut vérifier l’identité du serveur en cas de connexion TLS. La valeur par défaut est true. Non

Exemple :

{
    "name": "ShopifyLinkedService",
    "properties": {
        "type": "Shopify",
        "typeProperties": {
            "host" : "mystore.myshopify.com",
            "accessToken": {
                 "type": "SecureString",
                 "value": "<accessToken>"
            }
        }
    }
}

Propriétés du jeu de données

Pour obtenir la liste complète des sections et propriétés disponibles pour la définition de jeux de données, consultez l’article sur les jeux de données. Cette section fournit la liste des propriétés prises en charge par le jeu de données Shopify.

Pour copier des données de Shopify, affectez la valeur ShopifyObject à la propriété de type du jeu de données. Les propriétés prises en charge sont les suivantes :

Propriété Description Obligatoire
type La propriété type du jeu de données doit être définie sur : ShopifyObject Oui
tableName Nom de la table.

Pour la version 2.0, les noms de tables conservent la structure Shopify GraphQL, par exemple customers.

Pour la version 1.0, les noms de tables utilisent des noms simplifiés avec des préfixes, par exemple "Shopify"."Customers".		 Non (si « query » est spécifié dans la source de l'activité)

Note

la colonne de balises ne peut pas être lue lorsque vous spécifiez tableName dans le jeu de données. Pour lire cette colonne, utilisez query.

Exemple

{
    "name": "ShopifyDataset",
    "properties": {
        "type": "ShopifyObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Shopify linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Propriétés de l’activité de copie

Pour obtenir la liste complète des sections et des propriétés disponibles pour la définition des activités, consultez l’article Pipelines. Cette section fournit la liste des propriétés prises en charge par la source Shopify.

Shopify en tant que source

Pour copier des données à partir de Shopify, définissez ShopifySource comme type source dans l’activité de copie. Les propriétés prises en charge dans la section source de l’activité de copie sont les suivantes :

Propriété Description Obligatoire
type La propriété de type de la source d’activité de copie doit être définie sur ShopifySource Oui
query Pour la version 2.0, utilisez la requête GraphQL pour lire les données. Pour en savoir plus sur cette requête, consultez cet article. Notez que la requête de pagination n’est prise en charge que pour les tables externes, et chaque enregistrement de la table externe peut inclure jusqu’à 250 enregistrements de table interne.

Pour la version 1.0, utilisez la requête SQL personnalisée pour lire les données. Par exemple : "SELECT * FROM "Products" WHERE Product_Id = '123'".		 Non (si « tableName » est spécifié dans dataset)

Exemple :

"activities":[
    {
        "name": "CopyFromShopify",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Shopify input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ShopifySource"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mappage de type de données pour Shopify

Lorsque vous copiez des données à partir de Shopify, les mappages suivants s’appliquent des types de données de Shopify aux types de données internes utilisés par le service. Pour découvrir comment l’activité de copie mappe le schéma et le type de données la source au récepteur, consultez Mappage de schéma dans l’activité de copie.

Type de données Shopify Type de données de service intermédiaire (pour la version 2.0) Type de données de service intermédiaire (pour la version 1.0)
Booléen Booléen Booléen
Int Int Int
UnsignedInt64 UInt64 UInt64
Decimal Decimal Decimal
Flottant Double Double
Chaîne Chaîne Chaîne
Date Date Date
Date et heure Date et heure Date et heure
ID Chaîne Chaîne
URL Chaîne Chaîne
Code du pays Chaîne Chaîne
Autres types de données personnalisés Chaîne Chaîne

Propriétés de l’activité Lookup

Pour en savoir plus sur les propriétés, consultez Activité Lookup.

Cycle de vie et mise à niveau du connecteur Shopify

Le tableau suivant présente l’étape de mise en production et les journaux des modifications pour différentes versions du connecteur Shopify :

Version Phase de mise en production Journal des modifications
Version 1.0 Removed Non applicable.
Version 2.0 Disponibilité générale • Les noms de tables et de colonnes conservent la structure Shopify GraphQL.

• Prise en charge de la requête GraphQL uniquement.

• useEncryptedEndpoints, useHostVerificationusePeerVerification ne sont pas pris en charge dans le service lié.

Mettre à niveau le connecteur Shopify de la version 1.0 vers la version 2.0

  1. Dans la page Modifier le service lié , sélectionnez 2.0 pour la version. Pour plus d’informations, consultez les propriétés du service lié version 2.0.
  2. Pour la version 2.0, notez que les noms de tables et de colonnes conservent la structure Shopify GraphQL.
  3. Si vous utilisez la requête SQL dans la source d’activité de copie ou l’activité de recherche qui fait référence au service lié version 1.0, vous devez les convertir en requête GraphQL. Pour en savoir plus sur cette requête, consultez cet article

Contenu connexe

Consultez les banques de données prises en charge pour obtenir la liste des banques de données prises en charge en tant que sources et récepteurs par l’activité de copie.

  • Last updated on