Adatok másolása a Square-ből az Azure Data Factory vagy a Synapse Analytics használatával

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

A Square-összekötő 1.0-s verziója eltávolítási szakaszban van. Javasoljuk, hogy frissítse a Square-összekötőt az 1.0-s verzióról a 2.0-ra.

Támogatott képességek

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

Támogatott képességek	integrációs modul
Copy tevékenység (forrás/-)	(1) (2)
Keresési tevékenység	(1) (2)

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

Az összekötő a jelen cikkben szereplő Windows-verziókat támogatja.

Előfeltételek

Ha az adattár helyszíni hálózaton, Azure-beli virtuális hálózaton vagy Amazon Virtual Private Cloudon belül található, konfigurálnia kell egy saját üzemeltetésű integrációs modult a csatlakozáshoz.

Ha az adattár felügyelt felhőalapú adatszolgáltatás, használhatja az Azure Integration Runtime-ot. Ha a hozzáférés a tűzfalszabályokban jóváhagyott IP-címekre korlátozódik, hozzáadhat azure integration runtime IP-eket az engedélyezési listához.

Az Azure Data Factory felügyelt virtuális hálózati integrációs moduljával is elérheti a helyszíni hálózatot anélkül, hogy saját üzemeltetésű integrációs modult telepítene és konfigurálna.

A Data Factory által támogatott hálózati biztonsági mechanizmusokkal és lehetőségekkel kapcsolatos további információkért lásd az adathozzáférési stratégiákat.

Feljegyzés

A 2.0-s verzió támogatott a helyi integrációs modul 5.56.0.0-s vagy újabb verziójával.

Első lépések

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

• Adatok másolása eszköz
• Azure Portál
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• 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.

   

Az összekötő 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-összekötő mostantól támogatja a 2.0-s verziót. Ebben a szakaszban frissítheti a Square-összekötő 1.0-s verziójának verzióját. A tulajdonság részleteiért tekintse meg a megfelelő szakaszokat.

• 2.0-s verzió
• 1.0-s verzió

2.0-s verzió

A Square társított szolgáltatás a következő tulajdonságokat támogatja a 2.0-s verzió alkalmazásakor:

Tulajdonság	Leírás	Kötelező
típus	A típustulajdonságot a következő értékre kell állítani: Négyzet	Igen
verzió	A megadott verzió. Az érték 2.0.	Igen
állomás	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. A hozzáférési jogkivonat-típusokról további információt az Access-jogkivonat-típusok című témakörben talál.	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
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs modul . Ha nincs megadva, az alapértelmezett Azure Integration Runtime-t használja. Használhatja a saját üzemeltetésű integrációs modult, amelynek verziója 5.56.0.0 vagy újabb.	Nem

Példa:

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

1.0-s verzió

A Square társított szolgáltatás az 1.0-s verzió alkalmazásakor a következő tulajdonságokat támogatja:

Tulajdonság	Leírás	Kötelező
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:
állomás	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. A hozzáférési jogkivonat-típusokról további információt az Access-jogkivonat-típusok című témakörben talál.	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
connectVia	Az adattárhoz való csatlakozáshoz használandó integrációs modul . Ha nincs megadva, az alapértelmezett Azure Integration Runtime-t használja.	Nem

Példa:

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

Hozzáférési jogkivonat-típusok

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 Connect 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örű Connect 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 a tesztelési kapcsolatMERCHANT_PROFILE_READható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.

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:

Tulajdonság	Leírás	Kötelező
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: SquareObject	Igen
tableName	A tábla neve.	Igen a 2.0-s verzióhoz. Nem az 1.0-s verzióhoz (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:

Tulajdonság	Leírás	Kötelező
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. Például: "SELECT * FROM Business"	Nem (ha "tableName" van megadva az adathalmazban)

Feljegyzés

query a 2.0-s verzió nem támogatja.

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

Adattípus-leképezés négyzethez

Amikor adatokat másol a Square-ből, a Square adattípusaiból a következő leképezések vonatkoznak a szolgáltatás által használt belső adattípusokra. Ha szeretné megtudni, hogyan képezi le a másolási tevékenység a forrássémát és az adattípust a célhelyre, tekintse meg a séma- és adattípus-leképezéseket.

Négyzet adattípus	Köztes szolgáltatás adattípusa (a 2.0-s verzióhoz)	Köztes szolgáltatás adattípusa (1.0-s verzióhoz)
Lánc	Lánc	Lánc
Egész szám	Int32	Int32
Long	Int64	Int64
logikai	logikai	logikai
Date	Lánc	Nem támogatott.
Időbélyeg	Lánc	Nem támogatott.
Időbélyeg eltolással	Lánc	Nem támogatott.
Időtartam (teljes)	Lánc	Lánc
Időtartam (csak idő)	Lánc	Lánc
Pénz	Int64	Int64

Keresési tevékenység tulajdonságai

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

Négyzet alakú összekötő életciklusa és frissítése

Az alábbi táblázat a Square-összekötő különböző verzióinak kiadási fázisát és változásnaplóit mutatja be:

verzió	Kiadási fázis	Változások naplója
1.0-s verzió	Removed	Nem alkalmazható.
2.0-s verzió	Általános elérhetőség	• A saját üzemeltetésű integrációs modul verziójának 5.56.0.0-s vagy újabb verziónak kell lennie. • A dátum, az időbélyeg és az eltolással rendelkező időbélyeg sztring adattípusként van beolvasva. • useEncryptedEndpoints, useHostVerification, usePeerVerification nem támogatott a társított szolgáltatásban. • query nem támogatott.

A Square-összekötő frissítése az 1.0-s verzióról a 2.0-s verzióra

1. A Csatolt szolgáltatás szerkesztése lapon válassza a 2.0-s verziót. További információkért tekintse meg a társított szolgáltatás 2.0-s verziójának tulajdonságait.

2. A Square társított szolgáltatás 2.0-s verziójának adattípus-leképezése eltér az 1.0-s verziótól. A legújabb adattípus-leképezés megismeréséhez tekintse meg a Square adattípus-leképezését.

3. Saját üzemeltetésű integrációs modul alkalmazása az 5.56.0.0-s vagy újabb verzióval.

4. query csak az 1.0-s verzió támogatja. A tableName helyett a verzió 2.0-ban query-t kell használnia.

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.