Adatok másolása a Square-ből az Azure Data Factory vagy a Synapse Analytics használatával (előzetes verzió)

A következőkre vonatkozik: Azure Data Factory Azure Synapse Analytics

Tipp.

Próbálja ki a Data Factoryt a Microsoft Fabricben, amely egy teljes körű elemzési megoldás a nagyvállalatok számára. A Microsoft Fabric az adattovábbítástól az adatelemzésig, a valós idejű elemzésig, az üzleti intelligenciáig és a jelentéskészítésig mindent lefed. Ismerje meg, hogyan indíthat új próbaverziót ingyenesen!

Ez a cikk azt ismerteti, hogyan használhatja a Másolási tevékenységet egy Azure Data Factory vagy Synapse Analytics-folyamatban az adatok Square-ből való másolásához. A másolási tevékenység áttekintési cikkére épül, amely a másolási tevékenység általános áttekintését mutatja be.

Fontos

Ez az összekötő jelenleg előzetes verzióban érhető el. Kipróbálhatja, és visszajelzést küldhet nekünk. Ha függőséget szeretne felvenni a megoldásában található előzetes verziójú összekötőkre, lépjen kapcsolatba az Azure-támogatással.

Megjegyzés:

Ez az összekötő jelenleg nem támogatja a tesztkörnyezeti fiókokat.

Támogatott képességek

Ez a Négyzet összekötő a következő képességeket támogatja:

Támogatott képességek	IR
Copy tevékenység (forrás/-)	① ②
Keresési tevékenység	① ②

(1) Azure-integrációs modul (2) Saját üzemeltetésű integrációs modul

A forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

A szolgáltatás egy beépített illesztőprogramot biztosít a kapcsolat engedélyezéséhez, ezért nem kell manuálisan telepítenie egyetlen illesztőprogramot sem ezzel az összekötővel.

Első lépések

A Copy tevékenység folyamattal való végrehajtásához használja az alábbi eszközök vagy SDK-k egyikét:

• Az Adatok másolása eszköz
• The Azure portal
• A .NET SDK
• A Python SDK
• Azure PowerShell
• A REST API
• Az Azure Resource Manager-sablon

Társított szolgáltatás létrehozása a Square-hez felhasználói felülettel

Az alábbi lépésekkel létrehozhat egy társított szolgáltatást a Square-hez az Azure Portal felhasználói felületén.

1. Keresse meg az Azure Data Factory vagy a Synapse-munkaterület Kezelés lapját, és válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

   Azure Data Factory

   

   Azure Synapse

   

2. Keressen rá a Square kifejezésre, és válassza a Négyzet összekötőt.

   

3. Konfigurálja a szolgáltatás részleteit, tesztelje a kapcsolatot, és hozza létre az új társított szolgáltatást.

   

Csatlakozás or konfigurációjának részletei

A következő szakaszok a Square-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságok részleteit ismertetik.

Társított szolgáltatás tulajdonságai

A Square társított szolgáltatás esetében a következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	A típustulajdonságot a következő értékre kell állítani: Négyzet	Igen
connectionProperties	A Square-hez való csatlakozás módját meghatározó tulajdonságok csoportja.	Igen
A következő alatt connectionProperties:
házigazda	A Square-példány URL-címe. (azaz mystore.mysquare.com)	Igen
clientId	A Square-alkalmazáshoz társított ügyfélazonosító.	Igen
clientSecret	A Square-alkalmazáshoz társított ügyfélkód. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
accessToken	A Square-ből beszerzett hozzáférési jogkivonat. Korlátozott hozzáférést biztosít a Square-fiókokhoz, ha explicit engedélyeket kér egy hitelesített felhasználótól. Az OAuth hozzáférési jogkivonatok a kibocsátás után 30 nappal lejárnak, de a frissítési jogkivonatok nem járnak le. A hozzáférési jogkivonatok frissítési jogkivonattal frissíthetők. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
refreshToken	A Square-ből beszerzett frissítési jogkivonat. Új hozzáférési jogkivonatok beszerzésére szolgál az aktuális lejáratkor. Jelölje meg ezt a mezőt SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Nem
useEncryptedEndpoints	Megadja, hogy az adatforrásvégpontok HTTPS használatával vannak-e titkosítva. Az alapértelmezett érték igaz.	Nem
useHostVerification	Megadja, hogy a kiszolgáló tanúsítványában szereplő gazdagépnévnek meg kell-e egyeznie a kiszolgáló gazdagépnevével, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem
usePeerVerification	Megadja, hogy ellenőrizze-e a kiszolgáló identitását, amikor TLS-en keresztül csatlakozik. Az alapértelmezett érték igaz.	Nem

A négyzet kétféle hozzáférési jogkivonatot támogat: személyes és OAuth.

• A személyes hozzáférési jogkivonatokkal korlátlan Csatlakozás API-hozzáférést kaphat a saját Square-fiókjában lévő erőforrásokhoz.

• Az OAuth hozzáférési jogkivonatokkal hitelesített és hatókörrel rendelkező Csatlakozás API-hozzáférést kap bármely Square-fiókhoz. Használja őket, ha az alkalmazás más Square-fiókok erőforrásaihoz fér hozzá a fióktulajdonosok nevében. Az OAuth hozzáférési jogkivonatok a saját Square-fiók erőforrásainak eléréséhez is használhatók.

  Fontos

  A társított szolgáltatásban MERCHANT_PROFILE_READ a tesztelési kapcsolat elvégzéséhez hatókörrel rendelkező OAuth hozzáférési jogkivonat szükséges. A többi táblához való hozzáféréshez szükséges engedélyeket a Square OAuth Permissions Reference (Négyzetes OAuth-engedélyek referenciája) című témakörben találhatja meg.

A személyes hozzáférési jogkivonaton keresztüli hitelesítésre csak akkor van szükség accessToken, ha az OAuthon keresztüli hitelesítéshez accessToken és refreshToken. Ebből a cikkből megtudhatja, hogyan szerezheti be a hozzáférési jogkivonatot.

Példa

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

Adathalmaz tulajdonságai

Az adathalmazok meghatározásához elérhető szakaszok és tulajdonságok teljes listáját az adathalmazokról szóló cikkben találja. Ez a szakasz a Square-adathalmaz által támogatott tulajdonságok listáját tartalmazza.

Ha négyzetből szeretne adatokat másolni, állítsa az adathalmaz típustulajdonságát SquareObject értékre. A következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: SquareObject	Igen
tableName	A tábla neve.	Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

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

Másolási tevékenység tulajdonságai

A tevékenységek meghatározásához elérhető szakaszok és tulajdonságok teljes listáját a Folyamatok című cikkben találja. Ez a szakasz a Square-forrás által támogatott tulajdonságok listáját tartalmazza.

Négyzet forrásként

Ha négyzetből szeretne adatokat másolni, állítsa a másolási tevékenység forrástípusát a SquareSource-ra. A másolási tevékenység forrás szakaszában a következő tulajdonságok támogatottak:

Property	Leírás	Required
típus	A másolási tevékenység forrásának típustulajdonságának a következőnek kell lennie: SquareSource	Igen
Lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. For example: "SELECT * FROM Business".	Nem (ha "tableName" van megadva az adathalmazban)

Példa

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

Keresési tevékenység tulajdonságai

A tulajdonságok részleteinek megismeréséhez tekintse meg a keresési tevékenységet.

Kapcsolódó tartalom

A másolási tevékenység által forrásként és fogadóként támogatott adattárak listáját a támogatott adattárakban találja.