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

Článek
01/05/2024

PLATÍ PRO: Azure Data Factory Azure Synapse Analytics

Tip

Vyzkoušejte si službu Data Factory v Microsoft Fabric, řešení pro analýzy typu all-in-one pro podniky. Microsoft Fabric zahrnuje všechno od přesunu dat až po datové vědy, analýzy v reálném čase, business intelligence a vytváření sestav. Přečtěte si, jak začít používat novou zkušební verzi zdarma.

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

Důležité

Tento konektor je aktuálně ve verzi Preview. Můžete to vyzkoušet a poslat nám svůj názor. Pokud do svého řešení chcete zavést závislost na konektorech ve verzi Preview, kontaktujte podporu Azure.

Poznámka:

V současné době tento konektor nepodporuje účty sandboxu.

Podporované funkce

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

Podporované funkce	IR
aktivita Copy (zdroj/-)	① ②
Aktivita Lookup	① ②

(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č.

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:

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.

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
Vyhledejte čtverec a vyberte spojnici čtverce.
Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

podrobnosti o konfiguraci Připojení oru

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:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu musí být nastavena na: Square	Ano
connectionProperties	Skupina vlastností, která definuje, jak se připojit k čtverci.	Ano
V části `connectionProperties`:
host	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, abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault.	Ano
accessToken	Přístupový token získaný z náměstí. 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, abyste ho mohli bezpečně uložit, nebo odkazovat na tajný klíč uložený ve službě Azure Key Vault.	Ano
refreshToken	Obnovovací token získaný z náměstí. 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, abyste ho mohli bezpečně uložitFactory, nebo odkazovat na tajný kód uložený ve službě Azure Key Vault.	No
useEncryptedEndpoints	Určuje, jestli jsou koncové body zdroje dat šifrované pomocí protokolu HTTPS. Výchozí hodnota je true.	No
useHostVerification	Určuje, jestli se má při připojování přes protokol TLS vyžadovat název hostitele v certifikátu serveru. Výchozí hodnota je true.	No
usePeerVerification	Určuje, jestli se má při připojování přes protokol TLS ověřit identita serveru. Výchozí hodnota je true.	No

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

Osobní přístupové tokeny slouží k získání neomezeného Připojení přístupu rozhraní API k prostředkům ve vašem vlastním účtu Square.
Přístupové tokeny OAuth slouží k získání ověřeného a omezeného přístupu k rozhraní API Připojení 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:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu datové sady musí být nastavená na: SquareObject.	Ano
tableName	Název tabulky.	Ne (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 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:

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

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

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