Delen via

Gegevens kopiëren van Shopify met behulp van Azure Data Factory of Synapse Analytics

VAN TOEPASSING OP: Azure Data Factory Azure Synapse Analytics

Tip

Probeer Data Factory uit in Microsoft Fabric, een alles-in-één analyseoplossing voor ondernemingen. Microsoft Fabric omvat alles, van gegevensverplaatsing tot gegevenswetenschap, realtime analyses, business intelligence en rapportage. Meer informatie over het gratis starten van een nieuwe proefversie .

In dit artikel wordt beschreven hoe u de kopieeractiviteit gebruikt in een Azure Data Factory- of Synapse Analytics-pijplijn om gegevens te kopiëren uit Shopify. Het is gebaseerd op het artikel over het overzicht van kopieeractiviteiten met een algemeen overzicht van de kopieeractiviteit.

Belangrijk

De Shopify-connector versie 1.0 bevindt zich in de verwijderingsfase. U wordt aangeraden om de Shopify-connector te upgraden van versie 1.0 naar 2.0.

Ondersteunde mogelijkheden

Deze Shopify-connector wordt ondersteund voor de volgende mogelijkheden:

Ondersteunde mogelijkheden IR
Copy-activiteit (bron/-) (1) (2)
Activiteit Lookup (1) (2)

(1) Azure Integration Runtime (2) Zelf-hostende Integration Runtime

Zie de tabel Ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen/sinks.

De service biedt een ingebouwd stuurprogramma om connectiviteit in te schakelen, daarom hoeft u geen stuurprogramma handmatig te installeren met behulp van deze connector.

De connector ondersteunt de Windows-versies in dit artikel.

De billing_on kolomeigenschap is verwijderd uit de tabellen Recurring_Application_Charges en UsageCharge vanwege de officiële afschaffing van billing_on veld van Shopify.

Opmerking

Voor versie 2.0 behouden kolomnamen de Shopify GraphQL-structuur, zoals data.customers.edges.node.createdAt. Voor versie 1.0 gebruiken kolomnamen bijvoorbeeld Created_Atvereenvoudigde namen.

Aan de slag

Als u de kopieeractiviteit wilt uitvoeren met een pijplijn, kunt u een van de volgende hulpprogramma's of SDK's gebruiken:

Een gekoppelde service maken met Shopify met behulp van de gebruikersinterface

Gebruik de volgende stappen om een gekoppelde service te maken voor Shopify in de gebruikersinterface van Azure Portal.

  1. Blader naar het tabblad Beheren in uw Azure Data Factory- of Synapse-werkruimte en selecteer Gekoppelde services en klik vervolgens op Nieuw:

  2. Zoek Shopify en selecteer de Shopify-connector.

    Schermopname van de Shopify-connector.

  3. Configureer de servicedetails, test de verbinding en maak de nieuwe gekoppelde service.

    Schermopname van de configuratie van de gekoppelde service voor Shopify.

Configuratiedetails van connector

De volgende secties bevatten details over eigenschappen die worden gebruikt om Data Factory-entiteiten te definiëren die specifiek zijn voor Shopify-connector.

Eigenschappen van gekoppelde service

De Shopify-connector ondersteunt nu versie 2.0. Raadpleeg deze sectie om uw Shopify-connectorversie te upgraden vanaf versie 1.0. Raadpleeg de desbetreffende secties voor de details van de eigendom.

Versie 2.0

De gekoppelde Shopify-service ondersteunt de volgende eigenschappen wanneer versie 2.0 wordt toegepast:

Eigenschappen Beschrijving Vereist
type De eigenschap van het type moet worden ingesteld op: Shopify Ja
version De versie die je opgeeft. De waarde is 2.0. Ja
host Het eindpunt van de Shopify-server. (dat wil mystore.myshopify.com) Ja
accessToken Het API-toegangstoken dat kan worden gebruikt om toegang te krijgen tot de gegevens van Shopify. Het token verloopt niet als het offline is. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault. Ja

Voorbeeld:

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

Versie 1.0

De gekoppelde Shopify-service ondersteunt de volgende eigenschappen wanneer versie 1.0 wordt toegepast:

Eigenschappen Beschrijving Vereist
type De eigenschap van het type moet worden ingesteld op: Shopify Ja
host Het eindpunt van de Shopify-server. (dat wil mystore.myshopify.com) Ja
accessToken Het API-toegangstoken dat kan worden gebruikt om toegang te krijgen tot de gegevens van Shopify. Het token verloopt niet als het offline is. Markeer dit veld als SecureString om het veilig op te slaan of verwijs naar een geheim dat is opgeslagen in Azure Key Vault. Ja
useEncryptedEndpoints Hiermee geeft u op of de eindpunten van de gegevensbron zijn versleuteld met HTTPS. De standaardwaarde is waar. Nee
useHostVerification Hiermee geeft u op of de hostnaam in het certificaat van de server moet overeenkomen met de hostnaam van de server wanneer u verbinding maakt via TLS. De standaardwaarde is waar. Nee
usePeerVerification Hiermee geeft u op of de identiteit van de server moet worden gecontroleerd bij het maken van verbinding via TLS. De standaardwaarde is waar. Nee

Voorbeeld:

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

Eigenschappen van gegevensset

Zie het artikel gegevenssets voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van gegevenssets . Deze sectie bevat een lijst met eigenschappen die worden ondersteund door shopify-gegevensset.

Als u gegevens van Shopify wilt kopiëren, stelt u de typeeigenschap van de gegevensset in op ShopifyObject. De volgende eigenschappen worden ondersteund:

Eigenschappen Beschrijving Vereist
type De typeeigenschap van de gegevensset moet worden ingesteld op: ShopifyObject Ja
tableName Naam van de tabel.

Voor versie 2.0 behouden tabelnamen bijvoorbeeld customersde Shopify GraphQL-structuur.

Voor versie 1.0 gebruiken tabelnamen vereenvoudigde namen met voorvoegsels, bijvoorbeeld "Shopify"."Customers".		 Nee (als 'query' in de bron van de activiteit staat vermeld)

Opmerking

de kolom tags kan niet worden gelezen wanneer u opgeeft tableName in de gegevensset. Als u deze kolom wilt lezen, gebruikt u query.

Voorbeeld

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

Eigenschappen van de kopieeractiviteit

Zie het artikel Pijplijnen voor een volledige lijst met secties en eigenschappen die beschikbaar zijn voor het definiëren van activiteiten. Deze sectie bevat een lijst met eigenschappen die worden ondersteund door shopify-bron.

Shopify als bron

Als u gegevens van Shopify wilt kopiëren, stelt u het brontype in de kopieeractiviteit in op ShopifySource. De volgende eigenschappen worden ondersteund in de sectie bron van kopieeractiviteit:

Eigenschappen Beschrijving Vereist
type De typeeigenschap van de bron van de kopieeractiviteit moet worden ingesteld op: ShopifySource Ja
query Gebruik voor versie 2.0 de GraphQL-query om gegevens te lezen. Zie dit artikel voor meer informatie over deze query. De pagineringsquery wordt alleen ondersteund voor buitenste tabellen en elke record in de buitenste tabel kan maximaal 250 interne tabelrecords bevatten.

Gebruik voor versie 1.0 de aangepaste SQL-query om gegevens te lezen. Voorbeeld: "SELECT * FROM "Products" WHERE Product_Id = '123'".		 Nee (als 'tableName' in de gegevensset is opgegeven)

Voorbeeld:

"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>"
            }
        }
    }
]

Toewijzing van gegevenstypen voor Shopify

Wanneer u gegevens kopieert uit Shopify, zijn de volgende toewijzingen van Shopify-gegevenstypen van toepassing op de interne gegevenstypen die door de service worden gebruikt. Zie Schema- en gegevenstypetoewijzingen voor meer informatie over hoe de kopieeractiviteit het bronschema en het gegevenstype toewijst aan de sink.

Shopify-gegevenstype Tussentijds servicedatatype (voor versie 2.0) Interim service-gegevenssoort (voor versie 1.0)
Booleaan Booleaan Booleaan
Int Int Int
UnsignedInt64 UInt64 UInt64
Decimal Decimal Decimal
Drijven Double Double
String String String
Datum Datum Datum
DateTime DateTime DateTime
ID-kaart String String
URL String String
CountryCode String String
Andere aangepaste gegevenstypen String String

Eigenschappen van opzoekactiviteit

Als u meer wilt weten over de eigenschappen, controleert u de lookup-activiteit.

Levenscyclus en upgrade van Shopify-connector

De volgende tabel toont de releasefase en wijzigingslogboeken voor verschillende versies van de Shopify-connector:

Versie Releasefase Wijzigingslogboek
Versie 1.0 Removed Niet van toepassing.
Versie 2.0 Algemene beschikbaarheid • Tabel- en kolomnamen behouden de Shopify GraphQL-structuur.

• Alleen Ondersteuning voor GraphQL-query's.

• useEncryptedEndpoints, useHostVerificationworden usePeerVerification niet ondersteund in de gekoppelde service.

Upgrade de Shopify-connector van versie 1.0 naar versie 2.0

  1. Selecteer op de pagina Gekoppelde service bewerken 2.0 voor versie. Zie de eigenschappen van gekoppelde serviceversie 2.0 voor meer informatie.
  2. Houd er voor versie 2.0 rekening mee dat tabel- en kolomnamen de Shopify GraphQL-structuur behouden.
  3. Als u SQL-query gebruikt in de bron van de kopieeractiviteit of de opzoekactiviteit die verwijst naar de gekoppelde versie 1.0-service, moet u deze converteren naar de GraphQL-query. Zie dit artikel voor meer informatie over deze query

Gerelateerde inhoud

Zie ondersteunde gegevensarchieven voor een lijst met gegevensarchieven die worden ondersteund als bronnen en sinks door de kopieeractiviteit.

  • Last updated on