Kopírování dat z square 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 pomocí kopírovací aktivity v kanálu Azure Data Factory nebo Synapse Analytics kopírovat data ze Square. 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 Square verze 1.0 je ve fázi odebrání. Doporučujeme upgradovat konektor Square z verze 1.0 na 2.0.

Podporované funkce

Tento čtvercový konektor 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.

Požadavky

Pokud se vaše úložiště dat nachází uvnitř místní sítě, Azure virtuální sítě, nebo Amazon Virtual Private Cloud, musíte pro připojení nakonfigurovat self-hosted Integration Runtime.

Pokud je vaše úložiště dat spravovanou cloudovou datovou službou, můžete použít Azure Integration Runtime. Pokud je přístup omezený na IP adresy schválené v pravidlech brány firewall, můžete do seznamu povolených přidat ip adresy Azure Integration Runtime.

Funkci managed virtual network Integration Runtime můžete také použít v Azure Data Factory pro přístup k místní síti bez nutnosti instalace a konfigurace místního prostředí Integration Runtime.

Další informace o mechanismech zabezpečení sítě a možnostech podporovaných službou Data Factory najdete v tématu Strategie přístupu k datům.

Poznámka:

Verze 2.0 je podporovaná v místním prostředí Integration Runtime verze 5.56.0.0 nebo vyšší.

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 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í 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 Square a vyberte konektor Square.
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

Konektor Square teď podporuje verzi 2.0. V této části najdete informace o upgradu verze konektoru Square 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 Square podporuje následující vlastnosti při použití verze 2.0:

Vlastnost	Popis	Povinné
typ	Vlastnost typu musí být nastavena na: Square	Ano
verze	Zadaná verze. Hodnota je `2.0`.	Ano
hostitel	Adresa URL instance Square. (tj. mystore.mysquare.com)	Ano
clientId	ID klienta přidružené k vaší aplikaci Square.	Ano
clientSecret	Tajný klíč klienta přidružený k aplikaci Square. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault.	Ano
accessToken	Přístupový token získaný ze Square. Uděluje omezený přístup k účtu Square tím, že požádá ověřeného uživatele o explicitní oprávnění. Platnost přístupových tokenů OAuth vyprší 30 dnů po vydání, ale platnost obnovovacích tokenů nevyprší. Přístupové tokeny je možné aktualizovat pomocí obnovovacího tokenu. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault. Další informace o typech přístupových tokenů najdete v tématu Typy přístupových tokenů.	Ano
refreshToken	Obnovovací token získaný ze Square. Používá se k získání nových přístupových tokenů, když vyprší platnost aktuálního tokenu. Označte toto pole jako secureString, aby bylo možné ho bezpečně uložitFactory, nebo reference tajného kódu uloženého v Azure Key Vault.	Ne
connectVia	Integration Runtime pro připojení k úložišti dat. Pokud není zadaný, použije výchozí Azure Integration Runtime. Můžete použít místní prostředí Integration Runtime a jeho verze by měla být 5.56.0.0 nebo vyšší.	Ne

Příklad:

{
    "name": "SquareLinkedService",
    "properties": {
        "type": "Square",
        "version": "2.0",
        "typeProperties": {
            "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>"
            }
        },
        "connectVia": {
            "referenceName": "<name of Integration Runtime>",
            "type": "IntegrationRuntimeReference"
        }
    }
}

Verze 1.0

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

Vlastnost	Popis	Povinné
typ	Vlastnost typu musí být nastavena na: Square	Ano
vlastnosti připojení	Skupina vlastností, která definuje, jak se připojit ke službě Square.	Ano
V části `connectionProperties`:
hostitel	Adresa URL instance Square. (tj. mystore.mysquare.com)	Ano
clientId	ID klienta přidružené k vaší aplikaci Square.	Ano
clientSecret	Tajný klíč klienta přidružený k aplikaci Square. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault.	Ano
accessToken	Přístupový token získaný ze Square. Uděluje omezený přístup k účtu Square tím, že požádá ověřeného uživatele o explicitní oprávnění. Platnost přístupových tokenů OAuth vyprší 30 dnů po vydání, ale platnost obnovovacích tokenů nevyprší. Přístupové tokeny je možné aktualizovat pomocí obnovovacího tokenu. Označte toto pole jako SecureString pro jeho bezpečné uložení, nebo odkazujte na tajemství uložené v Azure Key Vault. Další informace o typech přístupových tokenů najdete v tématu Typy přístupových tokenů.	Ano
refreshToken	Obnovovací token získaný ze Square. Používá se k získání nových přístupových tokenů, když vyprší platnost aktuálního tokenu. Označte toto pole jako secureString, aby bylo možné ho bezpečně uložitFactory, nebo reference tajného kódu uloženého v Azure Key Vault.	Ne
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
connectVia	Integration Runtime pro připojení k úložišti dat. Pokud není zadaný, použije výchozí Azure Integration Runtime.	Ne

Příklad:

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

Typy přístupových tokenů

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

Osobní přístupové tokeny se používají k získání neomezeného přístupu k Connect API pro přístup k prostředkům ve vašem úč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. Zjistěte, jak získat přístupový token zde.

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:

Vlastnost	Popis	Povinné
typ	Vlastnost typu datové sady musí být nastavená na: SquareObject.	Ano
tableName	Název tabulky.	Ano pro verzi 2.0. Ne pro verzi 1.0 (pokud je zadán dotaz ve zdroji aktivity)

Příklad

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

Vlastnost	Popis	Povinné
typ	Vlastnost typu zdroje aktivity kopírování musí být nastavena na: SquareSource	Ano
dotaz	Ke čtení dat použijte vlastní dotaz SQL. Například: `"SELECT * FROM Business"`.	Ne (pokud je v datové sadě zadán název tabulky)

Poznámka:

query verze 2.0 není podporována.

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

Mapování datových typů pro čtverec

Při kopírování dat ze Square se aplikuje následující mapování datových typů společnosti Square 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.

Datový typ Čtvercový	Dočasný datový typ služby (pro verzi 2.0)	Dočasný datový typ služby (pro verzi 1.0)
String	String	String
Integer	Int32	Int32
Long	Int64	Int64
logický	logický	logický
Date	String	Není podporováno.
Časová značka	String	Není podporováno.
Časové razítko s posunem	String	Není podporováno.
Doba trvání (úplná)	String	String
Doba trvání (pouze čas)	String	String
Peníze	Int64	Int64

Vlastnosti aktivity vyhledávání

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

Životní cyklus a upgrade čtvercových konektorů

Následující tabulka uvádí protokoly fáze vydání a změn pro různé verze konektoru Square:

Version	Fáze vydání	Záznam změn
Verze 1.0	Removed	Nelze použít.
Verze 2.0	Obecná dostupnost	• Verze místního prostředí Integration Runtime by měla být 5.56.0.0 nebo vyšší. • Datum, časové razítko a časové razítko s posunem se čtou jako datový typ String. • `useEncryptedEndpoints`, `useHostVerification`, `usePeerVerification` nejsou podporovány v propojené službě. • `query` není podporován.

Upgrade konektoru Square 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.
Mapování datového typu pro propojenou službu Square verze 2.0 se liší od mapování datového typu pro verzi 1.0. Nejnovější mapování datových typů najdete v tématu Mapování datových typů pro čtverec.
Použijte místní prostředí Integration Runtime s verzí 5.56.0.0 nebo vyšší.
query je podporován pouze ve verzi 1.0. Měli byste použít tableName místo query ve verzi 2.0.

Ú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 square pomocí Azure Data Factory nebo Synapse Analytics

Podporované funkce

Požadavky

Začínáme

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

Podrobnosti konfigurace konektoru

Vlastnosti propojené služby

Verze 2.0

Verze 1.0

Typy přístupových tokenů

Vlastnosti datové sady

Vlastnosti kopírovací aktivity

Čtverec jako zdroj

Mapování datových typů pro čtverec

Vlastnosti aktivity vyhledávání

Životní cyklus a upgrade čtvercových konektorů

Upgrade konektoru Square z verze 1.0 na verzi 2.0

Související obsah

Váš názor

Další materiály