Udostępnij przez


Kopiuj dane z Shopify przy użyciu usługi Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób używania działania kopiowania w potoku usługi Azure Data Factory lub Synapse Analytics do kopiowania danych z Firmy. Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Ważne

Łącznik w wersji 1.0 jest znajduje się w fazie usuwania. Zaleca się zaktualizowanie łącznika Shopify z wersji 1.0 do wersji 2.0.

Obsługiwane możliwości

Ten łącznik Rozwiązania Jest obsługiwany w następujących funkcjach:

Obsługiwane możliwości środowisko IR
działanie Kopiuj (źródło/-) (1) (2)
Działanie Lookup (1) (2)

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła/ujścia, zobacz tabelę Obsługiwane magazyny danych.

Usługa udostępnia wbudowany sterownik umożliwiający łączność, dlatego nie trzeba ręcznie instalować żadnego sterownika przy użyciu tego łącznika.

Łącznik obsługuje wersje systemu Windows w tym artykule.

Właściwość kolumny billing_on została usunięta z tabel Recurring_Application_Charges i UsageCharge z powodu oficjalnego wycofania pola billing_on Firmy.

Uwaga / Notatka

W przypadku wersji 2.0 nazwy kolumn zachowują strukturę GraphQL, taką jak data.customers.edges.node.createdAt. W przypadku wersji 1.0 nazwy kolumn używają uproszczonych nazw, na przykład Created_At.

Wprowadzenie

Aby wykonać działanie kopiowania za pomocą pipeline'u, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

Tworzenie połączonej usługi z Aplikacją Helsink przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z Aplikacją w interfejsie użytkownika witryny Azure Portal.

  1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

  2. Wyszukaj pozycję Aby uzyskać połączenie, wybierz łącznik w Usłudze Aby uzyskać informacje.

    Zrzut ekranu przedstawiający łącznik z Usługą.

  3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

    Zrzut ekranu przedstawiający połączoną konfigurację usługi dla Pakietu.

Szczegóły konfiguracji łącznika

W poniższych sekcjach przedstawiono szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika Usługi Intune.

Właściwości połączonej usługi

Konektor Shopify obsługuje teraz wersję 2.0. Zapoznaj się z tą sekcją aby uaktualnić wersję łącznika Shopify z wersji 1.0. Aby uzyskać informacje szczegółowe dotyczące nieruchomości, zobacz odpowiednie sekcje.

Wersja 2.0

Powiązana usługa Shopify wspiera następujące właściwości przy zastosowaniu wersji 2.0:

Właściwości Opis Wymagania
typ Właściwość type musi być ustawiona na: The Tak
wersja Wersja, którą określisz. Wartość to 2.0. Tak
gospodarz Punkt końcowy serwera Woń. (czyli mystore.myshopify.com) Tak
accessToken Token dostępu interfejsu API, który może służyć do uzyskiwania dostępu do danych Firmy. Token nie wygasa, jeśli jest w trybie offline. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault. Tak

Przykład:

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

Wersja 1.0

Połączona usługa Shopify obsługuje następujące właściwości, gdy stosowana jest wersja 1.0:

Właściwości Opis Wymagania
typ Właściwość type musi być ustawiona na: The Tak
gospodarz Punkt końcowy serwera Woń. (czyli mystore.myshopify.com) Tak
accessToken Token dostępu interfejsu API, który może służyć do uzyskiwania dostępu do danych Firmy. Token nie wygasa, jeśli jest w trybie offline. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault. Tak
useEncryptedEndpoints Określa, czy punkty końcowe źródła danych są szyfrowane przy użyciu protokołu HTTPS. Wartość domyślna to true. Nie.
useHostVerification Określa, czy nazwa hosta w certyfikacie serwera ma być zgodna z nazwą hosta serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.
usePeerVerification Określa, czy należy zweryfikować tożsamość serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.

Przykład:

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

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. W tej sekcji znajduje się lista właściwości obsługiwanych przez zestaw danych z Pakietu.

Aby skopiować dane z Firmy, ustaw właściwość type zestawu danych na WartośćObject. Obsługiwane są następujące właściwości:

Właściwości Opis Wymagania
typ Właściwość type zestawu danych musi być ustawiona na: FirmaObject Tak
tableName Nazwa tabeli.

W przypadku wersji 2.0 nazwy tabel zachowują strukturę GraphQL, na przykład customers.

W przypadku wersji 1.0 nazwy tabel używają uproszczonych nazw z prefiksami, na przykład "Shopify"."Customers".
Nie (jeśli w źródle aktywności określono "zapytanie")

Uwaga / Notatka

Kolumna tagów nie może być odczytywana podczas określania tableName w zestawie danych. Aby odczytać tę kolumnę, użyj polecenia query.

Przykład

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

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło w Sieci.

Źródło w źródle

Aby skopiować dane z Firmy, ustaw typ źródła w działaniu kopiowania na Źródło. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

Właściwości Opis Wymagania
typ Właściwość type źródła działania kopiowania musi być ustawiona na: FirmaSource Tak
kwerenda W wersji 2.0 użyj zapytania GraphQL, aby odczytać dane. Aby dowiedzieć się więcej na temat tego zapytania, zobacz ten artykuł. Należy pamiętać, że zapytanie stronicowania jest obsługiwane tylko w przypadku tabel zewnętrznych, a każdy rekord w tabeli zewnętrznej może zawierać maksymalnie 250 rekordów tabeli wewnętrznej.

W przypadku wersji 1.0 użyj niestandardowego zapytania SQL do odczytywania danych. Na przykład: "SELECT * FROM "Products" WHERE Product_Id = '123'".
Nie (jeśli określono "tableName" w zestawie danych)

Przykład:

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

Mapowanie typów danych dla Shopify

Podczas kopiowania danych z Shopify, następujące mapowania mają zastosowanie z typów danych Shopify do wewnętrznych typów danych używanych przez usługę. Aby dowiedzieć się, jak działanie kopiowania mapuje schemat źródłowy i typ danych na docelowy, zobacz Mapowanie schematu i typu danych.

Typ danych Shopify Typ danych usługi tymczasowej (wersja 2.0) Typ danych usługi tymczasowej (wersja 1.0)
logiczny logiczny logiczny
Int Int Int
Bez znaku Int64 UInt64 UInt64
Decimal Decimal Decimal
Spławik Double Double
Sznurek Sznurek Sznurek
Date Date Date
DateTime DateTime DateTime
identyfikator Sznurek Sznurek
adres URL Sznurek Sznurek
Kod kraju Sznurek Sznurek
Inne niestandardowe typy danych Sznurek Sznurek

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Cykl życia i uaktualnianie łącznika Shopify

W poniższej tabeli przedstawiono etap wydania i dzienniki zmian dla różnych wersji łącznika Shopify.

wersja Etap wydania Dziennik zmian
Wersja 1.0 Removed Nie dotyczy.
Wersja 2.0 Ogólna dostępność • Nazwy tabel i kolumn zachowują strukturę GraphQL w Usłudze Intune.

• Obsługa tylko zapytań GraphQL.

useEncryptedEndpoints, useHostVerification, usePeerVerification nie są obsługiwane w połączonej usłudze.

Uaktualnij integrator Shopify z wersji 1.0 do wersji 2.0

  1. Na stronie Edytowanie połączonej usługi wybierz wersję 2.0. Aby uzyskać więcej informacji, zobacz właściwości połączonej usługi w wersji 2.0.
  2. W wersji 2.0 należy pamiętać, że nazwy tabel i kolumn zachowują strukturę Shopify GraphQL.
  3. Jeśli używasz zapytania SQL w źródle działania kopiowania lub działania wyszukiwania odwołującego się do połączonej usługi w wersji 1.0, musisz przekonwertować je na zapytanie GraphQL. Aby dowiedzieć się więcej o tym zapytaniu, zobacz ten artykuł

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.