Kopiera data från Square med Hjälp av Azure Data Factory eller Synapse Analytics (förhandsversion)

GÄLLER FÖR: Azure Data Factory Azure Synapse Analytics

Den här artikeln beskriver hur du använder kopieringsaktiviteten i en Azure Data Factory- eller Synapse Analytics-pipeline för att kopiera data från Square. Den bygger på översiktsartikeln för kopieringsaktivitet som visar en allmän översikt över kopieringsaktiviteten.

Funktioner som stöds

Den här Square-anslutningsappen stöds för följande funktioner:

(1) Azure Integration Runtime (2) Lokalt installerad integrationskörning

En lista över datalager som stöds som källor/mottagare finns i tabellen Datalager som stöds.

Tjänsten tillhandahåller en inbyggd drivrutin för att aktivera anslutningen. Därför behöver du inte installera någon drivrutin manuellt med den här anslutningsappen.

Anslutningsappen stöder Windows-versionerna i den här artikeln.

Komma igång

Om du vill utföra aktiviteten Kopiera med en pipeline kan du använda något av följande verktyg eller SDK:er:

• Verktyget Kopiera data
• Azure-portalen
• The .NET SDK
• The Python SDK
• Azure PowerShell
• REST-API:et
• Azure Resource Manager-mallen

Skapa en länkad tjänst till Square med hjälp av användargränssnittet

Använd följande steg för att skapa en länkad tjänst till Square i användargränssnittet för Azure Portal.

1. Bläddra till fliken Hantera i Din Azure Data Factory- eller Synapse-arbetsyta och välj Länkade tjänster och klicka sedan på Ny:

   • Azure Data Factory
   • Azure Synapse

   

2. Sök efter Fyrkant och välj square-anslutningsappen.

   

3. Konfigurera tjänstinformationen, testa anslutningen och skapa den nya länkade tjänsten.

   

Konfigurationsinformation för anslutningsprogram

Följande avsnitt innehåller information om egenskaper som används för att definiera Data Factory-entiteter som är specifika för Square Connector.

Länkade tjänstegenskaper

Följande egenskaper stöds för kvadratlänkad tjänst:

Square stöder två typer av åtkomsttoken: personlig och OAuth.

• Personliga åtkomsttoken används för att få obegränsad Åtkomst till resurser i ditt eget Square-konto.

• OAuth-åtkomsttoken används för att få autentiserad och begränsad Åtkomst-API till alla Square-konton. Använd dem när din app kommer åt resurser i andra Square-konton för kontoägares räkning. OAuth-åtkomsttoken kan också användas för att komma åt resurser i ditt eget Square-konto.

  Viktigt!

  För att utföra testanslutningen i den länkade tjänsten MERCHANT_PROFILE_READ krävs för att hämta en begränsad OAuth-åtkomsttoken. Behörigheter för åtkomst till andra tabeller finns i Referens för Square OAuth-behörigheter.

Autentisering via personlig åtkomsttoken behöver accessTokenbara , medan autentisering via OAuth kräver accessToken och refreshToken. Lär dig hur du hämtar åtkomsttoken härifrån.

Exempel:

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

Egenskaper för datauppsättning

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera datauppsättningar finns i artikeln datauppsättningar . Det här avsnittet innehåller en lista över egenskaper som stöds av Kvadratdatauppsättning.

Om du vill kopiera data från Square anger du datamängdens typegenskap till SquareObject. Följande egenskaper stöds:

Exempel

{
    "name": "SquareDataset",
    "properties": {
        "type": "SquareObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Square linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Kopiera egenskaper för aktivitet

En fullständig lista över avsnitt och egenskaper som är tillgängliga för att definiera aktiviteter finns i artikeln Pipelines . Det här avsnittet innehåller en lista över egenskaper som stöds av Kvadratkälla.

Kvadrat som källa

Om du vill kopiera data från Square anger du källtypen i kopieringsaktiviteten till SquareSource. Följande egenskaper stöds i avsnittet kopieringsaktivitetskälla:

Exempel:

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

Egenskaper för uppslagsaktivitet

Mer information om egenskaperna finns i Sökningsaktivitet.

Relaterat innehåll

En lista över datalager som stöds som källor och mottagare av kopieringsaktiviteten finns i datalager som stöds.