Kopírování dat z Shopify pomocí Azure Data Factory nebo Synapse Analytics

VZTAHUJE SE NA: Azure Data Factory Azure Synapse Analytics

Tip

Data Factory v Microsoft Fabric je nová generace Azure Data Factory s jednodušší architekturou, integrovanou AI a novými funkcemi. Pokud s integrací dat začínáte, začněte Fabric Data Factory. Stávající úlohy ADF lze upgradovat na Fabric pro přístup k novým funkcím v oblastech datové vědy, analýz v reálném čase a vytváření sestav.

Tento článek popisuje, jak použít aktivitu kopírování v kanálu Azure Data Factory nebo Synapse Analytics ke kopírování dat ze služby Shopify. Vychází z článku přehled aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Důležité

Konektor Shopify verze 1.0 je ve fázi odebrání. Doporučujeme upgradovat konektor Shopify z verze 1.0 na verzi 2.0.

Podporované funkce

Tento konektor Shopify je podporovaný pro následující funkce:

Podporované funkce	IR
aktivita Copy (zdroj/-)	(1) (2)
Vyhledávací aktivita	(1) (2)

(1) Azure Integration Runtime (2) Lokálně hostované Integration Runtime

Seznam úložišť dat podporovaných jako zdroje nebo jímky najdete v tabulce Podporované úložiště dat.

Služba poskytuje integrovaný ovladač, který umožňuje připojení, takže pomocí tohoto konektoru nemusíte ručně instalovat žádný ovladač.

Konektor podporuje verze Windows uvedené v tomto článku.

Vlastnost sloupce billing_on byla odebrána z tabulek Recurring_Application_Charges a UsageCharge z důvodu oficiálního ukončení používání atributu billing_on společností Shopify.

Poznámka:

Názvy sloupců verze 2.0 uchovávají strukturu Shopify GraphQL, například data.customers.edges.node.createdAt. Pro verzi 1.0 používají názvy sloupců zjednodušené názvy, Created_Atnapříklad .

Začínáme

K provedení aktivity kopírování pomocí datového kanálu můžete použít jeden z následujících nástrojů nebo sad SDK:

Vytvoření propojené služby pro Shopify pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu Shopify v uživatelském rozhraní portálu Azure.

Přejděte na kartu Spravovat v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a potom klikněte na Nový:
- Azure Data Factory
- Azure Synapse
Vyhledejte Shopify a vyberte konektor Shopify.
Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor Shopify.

Vlastnosti propojené služby

Konektor Shopify teď podporuje verzi 2.0. V této části najdete informace o upgradu verze konektoru Shopify z verze 1.0. Podrobnosti o nemovitosti najdete v odpovídajících oddílech.

Verze 2.0
verze 1.0

Verze 2.0

Propojená služba Shopify podporuje následující vlastnosti při použití verze 2.0:

Vlastnost	Popis	Povinné
typ	Vlastnost typu musí být nastavena na: Shopify.	Ano
verze	Zadaná verze. Hodnota je `2.0`.	Ano
hostitel	Koncový bod serveru Shopify. (to znamená mystore.myshopify.com)	Ano
accessToken	Přístupový token rozhraní API, který se dá použít pro přístup k datům Shopify. Platnost tokenu nevyprší, pokud je offline. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault.	Ano

Příklad:

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

Verze 1.0

Propojená služba Shopify podporuje následující vlastnosti při použití verze 1.0:

Vlastnost	Popis	Povinné
typ	Vlastnost typu musí být nastavena na: Shopify.	Ano
hostitel	Koncový bod serveru Shopify. (to znamená mystore.myshopify.com)	Ano
accessToken	Přístupový token rozhraní API, který se dá použít pro přístup k datům Shopify. Platnost tokenu nevyprší, pokud je offline. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault.	Ano
useEncryptedEndpoints	Určuje, jestli jsou koncové body zdroje dat šifrované pomocí protokolu HTTPS. Výchozí hodnota je true.	Ne
useHostVerification	Určuje, jestli se má při připojování přes protokol TLS vyžadovat, aby název hostitele v certifikátu serveru odpovídal názvu hostitele serveru. Výchozí hodnota je true.	Ne
usePeerVerification	Určuje, jestli se má při připojování přes protokol TLS ověřit identita serveru. Výchozí hodnota je true.	Ne

Příklad:

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

Vlastnosti datové sady

Úplný seznam oddílů a vlastností dostupných pro definování datových sad najdete v článku o datových sadách . Tato část obsahuje seznam vlastností podporovaných datovou sadou Shopify.

Pokud chcete kopírovat data z Shopify, nastavte vlastnost typu datové sady na ShopifyObject. Podporují se následující vlastnosti:

Vlastnost	Popis	Povinné
typ	Vlastnost typu datové sady musí být nastavená na: ShopifyObject.	Ano
tableName	Název tabulky. Pro verzi 2.0 názvy tabulek zachovávají strukturu Shopify GraphQL, například `customers`. Pro verzi 1.0 používají názvy tabulek zjednodušené názvy s předponami, `"Shopify"."Customers"`například .	Ne (pokud je zadán dotaz ve zdroji aktivity)

Poznámka:

Sloupec značek nelze přečíst, když zadáte tableName v datové sadě. Chcete-li přečíst tento sloupec, použijte query.

Příklad

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

Vlastnosti kopírovací aktivity

Úplný seznam oddílů a vlastností dostupných pro definování aktivit najdete v článku Pipelines . Tato část obsahuje seznam vlastností podporovaných zdrojem Shopify.

Shopify jako zdroj

Pokud chcete kopírovat data z Shopify, nastavte typ zdroje v aktivitě kopírování na ShopifySource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Vlastnost	Popis	Povinné
typ	Vlastnost typu zdroje aktivity kopírování musí být nastavena na: ShopifySource.	Ano
dotaz	Pro verzi 2.0 použijte dotaz GraphQL ke čtení dat. Další informace o tomto dotazu najdete v tomto článku. Všimněte si, že stránkování je podporováno pouze pro vnější tabulky a každý záznam ve vnější tabulce může obsahovat až 250 záznamů vnitřní tabulky. Kromě toho se stránkování nepodporuje u vnořených tabulek. Pro verzi 1.0 použijte vlastní dotaz SQL ke čtení dat. Například: `"SELECT * FROM "Products" WHERE Product_Id = '123'"`.	Ne (pokud je v datové sadě zadán název tabulky)

Příklad:

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

Mapování datových typů pro Shopify

Při kopírování dat z Shopify platí následující mapování z datových typů Shopify na interní datové typy používané službou. Informace o tom, jak aktivita kopírování mapuje zdrojové schéma a datový typ na jímku, najdete v tématu Mapování schématu a datového typu.

Shopify – datový typ	Dočasný datový typ služby (pro verzi 2.0)	Dočasný datový typ služby (pro verzi 1.0)
logický	logický	logický
Int	Int	Int
UnsignedInt64	UInt64	UInt64
Decimal	Decimal	Decimal
Plout	Double	Double
String	String	String
Date	Date	Date
DateTime	DateTime	DateTime
ID	String	String
URL	String	String
Kód země	String	String
Další vlastní datové typy	String	String

Vlastnosti aktivity vyhledávání

Zjistit podrobnosti o vlastnostech můžete v aktivitě Vyhledávání.

Shopify – životní cyklus a upgrade konektoru

Následující tabulka ukazuje fázi vydání a protokoly změn pro různé verze konektoru Shopify:

Version	Fáze vydání	Záznam změn
Verze 1.0	Removed	Nelze použít.
Verze 2.0	Obecná dostupnost	• Názvy tabulek a sloupců uchovávají strukturu Shopify GraphQL. • Podporuje pouze dotaz GraphQL. • `useEncryptedEndpoints`, `useHostVerification`, `usePeerVerification` nejsou podporovány v propojené službě.

Aktualizujte konektor Shopify z verze 1.0 na verzi 2.0

Na stránce Upravit propojenou službu vyberte verzi 2.0. Další informace najdete ve vlastnostech propojené služby verze 2.0.
Ve verzi 2.0 si všimněte, že názvy tabulek a sloupců zachovávají strukturu Shopify GraphQL.
Pokud používáte dotaz SQL ve zdroji aktivity kopírování nebo vyhledávací aktivitu odkazující na propojenou službu verze 1.0, musíte je převést na dotaz GraphQL. Další informace o tomto dotazu najdete v tomto článku.

Úložiště dat, která kopírovací aktivita podporuje jako zdroje a cíle, najdete v seznamu podporovaných úložišť dat.

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-04-07

Kopírování dat z Shopify pomocí Azure Data Factory nebo Synapse Analytics

Podporované funkce

Začínáme

Vytvoření propojené služby pro Shopify pomocí uživatelského rozhraní

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Verze 2.0

Verze 1.0

Vlastnosti datové sady

Vlastnosti kopírovací aktivity

Shopify jako zdroj

Mapování datových typů pro Shopify

Vlastnosti aktivity vyhledávání

Shopify – životní cyklus a upgrade konektoru

Aktualizujte konektor Shopify z verze 1.0 na verzi 2.0

Související obsah

Váš názor

Další materiály