Kopiowanie danych z platformy Square przy użyciu usługi Azure Data Factory lub Synapse Analytics (wersja zapoznawcza)

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życia działania kopiowania w potoku usługi Azure Data Factory lub Synapse Analytics w celu skopiowania danych z kwadratu. Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Ważne

Ten łącznik jest obecnie w wersji zapoznawczej. Możesz wypróbować go i przekazać nam swoją opinię. Jeśli w swoim rozwiązaniu chcesz wprowadzić zależność od łączników w wersji zapoznawczej, skontaktuj się z pomocą techniczną platformy Azure.

Uwaga

Obecnie ten łącznik nie obsługuje kont piaskownicy.

Obsługiwane możliwości

Ten łącznik Square jest obsługiwany w następujących możliwościach:

Obsługiwane możliwości	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.

Wprowadzenie

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

• Narzędzie do kopiowania danych
• Witryna Azure Portal
• Zestaw SDK platformy .NET
• Zestaw SDK języka Python
• Azure PowerShell
• Interfejs API REST
• Szablon usługi Azure Resource Manager

Tworzenie połączonej usługi z platformą Square przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z aplikacją Square 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:

   Azure Data Factory

   

   Azure Synapse

   

2. Wyszukaj ciąg Square i wybierz łącznik Square.

   

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

   

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika Square.

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

Następujące właściwości są obsługiwane w przypadku połączonej usługi Square:

Właściwości	Opis	Wymagania
type	Właściwość type musi być ustawiona na: Square	Tak
connectionProperties	Grupa właściwości definiujących sposób nawiązywania połączenia z kwadratem.	Tak
W obszarze connectionProperties:
host	Adres URL wystąpienia Square. (tj. mystore.mysquare.com)	Tak
clientId	Identyfikator klienta skojarzony z aplikacją Square.	Tak
clientSecret	Wpis tajny klienta skojarzony z aplikacją Square. 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
accessToken	Token dostępu uzyskany z kwadratu. Udziela ograniczonego dostępu do konta Square, prosząc uwierzytelnionego użytkownika o jawne uprawnienia. Tokeny dostępu OAuth wygasają 30 dni po wystawieniu, ale tokeny odświeżania nie wygasają. Tokeny dostępu można odświeżać za pomocą tokenu odświeżania. 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
refreshToken	Token odświeżania uzyskany z kwadratu. Służy do uzyskiwania nowych tokenów dostępu po wygaśnięciu bieżącego tokenu. Oznacz to pole jako element SecureString, aby przechowywać je bezpiecznieFactory lub odwoływać się do wpisu tajnego przechowywanego w usłudze Azure Key Vault.	Nie.
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.

Kwadrat obsługuje dwa typy tokenu dostępu: osobiste i OAuth.

• Osobiste tokeny dostępu są używane do uzyskiwania nieograniczonego dostępu interfejsu API Connect do zasobów na własnym koncie Square.

• Tokeny dostępu OAuth są używane do uzyskiwania uwierzytelnionego i ograniczonego dostępu interfejsu API connect do dowolnego konta Square. Użyj ich, gdy aplikacja uzyskuje dostęp do zasobów na innych kontach Square w imieniu właścicieli kont. Tokeny dostępu OAuth mogą być również używane do uzyskiwania dostępu do zasobów na własnym koncie Square.

  Ważne

  Aby wykonać testowe połączenie w połączonej usłudze, MERCHANT_PROFILE_READ wymagane jest uzyskanie tokenu dostępu OAuth w zakresie. Aby uzyskać uprawnienia dostępu do innych tabel, zobacz Square OAuth Permissions Reference (Dokumentacja uprawnień uwierzytelniania OAuth kwadratu).

Uwierzytelnianie za pośrednictwem osobistego tokenu dostępu wymaga accessTokentylko wartości , a uwierzytelnianie za pośrednictwem protokołu OAuth wymaga accessToken i refreshToken. Dowiedz się, jak pobrać token dostępu z tego miejsca.

Przykład:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "typeProperties": {
            "connectionProperties": {
                "host": "<e.g. mystore.mysquare.com>", 
                "clientId": "<client ID>", 
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<clientSecret>"
                }, 
                "accessToken": {
                    "type": "SecureString",
                    "value": "<access token>"
                }, 
                "refreshToken": {
                    "type": "SecureString",
                    "value": "<refresh token>"
                }, 
                "useEncryptedEndpoints": true, 
                "useHostVerification": true, 
                "usePeerVerification": true 
            }
        }
    }
}

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. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych Square.

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

Właściwości	Opis	Wymagania
type	Właściwość type zestawu danych musi być ustawiona na: SquareObject	Tak
tableName	Nazwa tabeli.	Nie (jeśli określono "zapytanie" w źródle działania)

Przykład

{
    "name": "SquareDataset",
    "properties": {
        "type": "SquareObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Square 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 Square.

Kwadrat jako źródło

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

Właściwości	Opis	Wymagania
type	Właściwość type źródła działania kopiowania musi być ustawiona na: SquareSource	Tak
zapytanie	Użyj niestandardowego zapytania SQL, aby odczytać dane. Na przykład: "SELECT * FROM Business".	Nie (jeśli określono "tableName" w zestawie danych)

Przykład:

"activities":[
    {
        "name": "CopyFromSquare",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Square input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "SquareSource",
                "query": "SELECT * FROM Business"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Właściwości działania wyszukiwania

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

Powiązana zawartość

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