Kopírování dat z square pomocí služby Azure Data Factory nebo Synapse Analytics (Preview)

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tento článek popisuje, jak pomocí aktivity kopírování v kanálu Azure Data Factory nebo Synapse Analytics kopírovat data z square. Vychází z článku s přehledem aktivity kopírování, který představuje obecný přehled aktivity kopírování.

Podporované funkce

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

(1) Prostředí Azure Integration Runtime (2) Místní prostředí 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 v tomto článku.

Začínáme

K provedení aktivita Copy s kanálem můžete použít jeden z následujících nástrojů nebo sad SDK:

• Nástroj pro kopírování dat
• Azure Portal
• Sada .NET SDK
• Sada Python SDK
• Azure PowerShell
• Rozhraní REST API
• Šablona Azure Resource Manageru

Vytvoření propojené služby na Square pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu na Square v uživatelském rozhraní webu Azure Portal.

1. Přejděte na kartu Správa v pracovním prostoru Azure Data Factory nebo Synapse a vyberte Propojené služby a pak klikněte na Nový:

   • Azure Data Factory
   • Azure Synapse

   

2. Vyhledejte čtverec a vyberte spojnici čtverce.

   

3. 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 Square.

Vlastnosti propojené služby

Pro propojenou službu Square jsou podporovány následující vlastnosti:

Square podporuje dva typy přístupového tokenu: osobní a OAuth.

• Osobní přístupové tokeny slouží k získání neomezeného přístupu rozhraní API pro připojení k prostředkům ve vašem vlastním účtu Square.

• Přístupové tokeny OAuth se používají k získání ověřeného a vymezeného přístupu rozhraní CONNECT API k libovolnému účtu Square. Použijte je, když vaše aplikace přistupuje k prostředkům v jiných účtech Square jménem vlastníků účtů. Přístupové tokeny OAuth se dají použít také pro přístup k prostředkům ve vašem vlastním účtu Square.

  Důležité

  K provedení testovacího připojení v propojené službě MERCHANT_PROFILE_READ je nutné získat přístupový token OAuth s vymezeným oborem. Oprávnění pro přístup k jiným tabulkám najdete v tématu Referenční informace o oprávněních square OAuth.

Ověřování prostřednictvím osobního přístupového tokenu vyžaduje accessTokenpouze , zatímco ověřování přes OAuth vyžaduje accessToken a refreshToken. Tady se dozvíte, jak načíst přístupový token.

Příklad:

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

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 Square.

Chcete-li kopírovat data z square, nastavte vlastnost typu datové sady na SquareObject. Podporují se následující vlastnosti:

Příklad

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

Vlastnosti aktivity kopírování

Ú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 Square.

Čtverec jako zdroj

Chcete-li kopírovat data z square, nastavte typ zdroje v aktivitě kopírování na SquareSource. Ve zdrojové části aktivity kopírování jsou podporovány následující vlastnosti:

Příklad:

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

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Související obsah

Seznam úložišť dat podporovaných jako zdroje a jímky aktivitou kopírování najdete v podporovaných úložištích dat.