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

A KÖVETKEZŐKRE VONATKOZIK: Azure Data Factory Azure Synapse Analytics

Ez a cikk azt ismerteti, hogyan használhatja a másolási tevékenységet egy Azure Data Factory vagy Synapse Analytics-folyamatban adatok másolásához a QuickBooks Online-ból. A másolási tevékenység áttekintési cikkére épül, amely általános áttekintést nyújt a másolási tevékenységről.

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.

Támogatott képességek

Ez a QuickBooks-összekötő a következő tevékenységekhez támogatott:

A QuickBooks Online-ból bármilyen támogatott fogadóadattárba másolhat adatokat. A másolási tevékenység által forrásként/fogadóként támogatott adattárak listáját a Támogatott adattárak táblában találja.

Ez az összekötő támogatja a QuickBooks OAuth 2.0-hitelesítést.

Első lépések

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

Társított szolgáltatás létrehozása QuickBookshoz felhasználói felületen

Az alábbi lépésekkel hozhat létre társított szolgáltatást a QuickBookshoz a Azure Portal felhasználói felületén.

  1. Tallózással lépjen a Azure Data Factory vagy Synapse-munkaterület Kezelés lapjára, válassza a Társított szolgáltatások lehetőséget, majd kattintson az Új gombra:

  2. Keressen a QuickBooksra, és válassza ki a QuickBooks-összekötőt.

    Screenshot of the QuickBooks connector.

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

    Screenshot of linked service configuration for QuickBooks.

Összekötő konfigurációjának részletei

Az alábbi szakaszok a QuickBooks-összekötőre jellemző Data Factory-entitások meghatározásához használt tulajdonságokat ismertetik.

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

A QuickBooks társított szolgáltatásban a következő tulajdonságok támogatottak:

Tulajdonság Leírás Kötelező
típus A típustulajdonságnak a következőre kell állítania: QuickBooks Yes
connectionProperties A QuickBookshoz való csatlakozás módját meghatározó tulajdonságok csoportja. Yes
A következő alatt connectionProperties:
endpoint A QuickBooks Online-kiszolgáló végpontja. (azaz quickbooks.api.intuit.com) Yes
companyId Az engedélyezni kívánt QuickBooks-vállalat cégazonosítója. A cégazonosító megkereséséről további információt a Hogyan cégazonosító megkeresése című témakörben talál. Yes
consumerKey A QuickBooks Online-alkalmazás OAuth 2.0-hitelesítéshez használt ügyfél-azonosítója. További információ itt található. Yes
consumerSecret A QuickBooks Online-alkalmazás OAuth 2.0-hitelesítéshez használt titkos ügyfélkulcsa. Jelölje meg ezt a mezőt SecureString-ként, hogy biztonságosan tárolja, vagy hivatkozzon egy Azure-Key Vault tárolt titkos kódra. Yes
refreshToken A QuickBooks alkalmazáshoz társított OAuth 2.0 frissítési jogkivonat. További információ itt található. A megjegyzésfrissítési jogkivonat 180 nap után lejár. Az ügyfélnek rendszeresen frissítenie kell a frissítési jogkivonatot.
Jelölje meg ezt a mezőt SecureString-ként, hogy biztonságosan tárolja, vagy hivatkozzon egy Azure-Key Vault tárolt titkos kódra.
Yes
useEncryptedEndpoints Meghatározza, hogy az adatforrásvégpontok HTTPS-kapcsolattal legyenek-e titkosítva. Az alapértelmezett érték az igaz. No

Példa

{
    "name": "QuickBooksLinkedService",
    "properties": {
        "type": "QuickBooks",
        "typeProperties": {
            "connectionProperties": {
                "endpoint": "quickbooks.api.intuit.com",
                "companyId": "<company id>",
                "consumerKey": "<consumer key>", 
                "consumerSecret": {
                     "type": "SecureString",
                     "value": "<clientSecret>"
            	},
                "refreshToken": {
                     "type": "SecureString",
                     "value": "<refresh token>"
            	},
                "useEncryptedEndpoints": true
            }
        }
    }
}

Adatkészlet 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 QuickBooks-adatkészlet által támogatott tulajdonságok listáját tartalmazza.

Ha adatokat szeretne másolni a QuickBooks Online-ból, állítsa az adathalmaz típustulajdonságát QuickBooksObject é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: QuickBooksObject Yes
tableName A tábla neve. Nem (ha "lekérdezés" van megadva a tevékenységforrásban)

Példa

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks 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 QuickBooks-forrás által támogatott tulajdonságok listáját tartalmazza.

QuickBooks mint forrás

Ha adatokat szeretne másolni a QuickBooks Online-ból, állítsa a másolási tevékenység forrástípusát QuickBooksSource-ra. A másolási tevékenység forrásszakasza a következő tulajdonságokat támogatja:

Tulajdonság Leírás Kötelező
típus A másolási tevékenység forrásának típustulajdonságát a következőre kell állítani: QuickBooksSource Yes
lekérdezés Az adatok olvasásához használja az egyéni SQL lekérdezést. Példa: "SELECT * FROM "Bill" WHERE Id = '123'". Nem (ha a "tableName" érték meg van adva az adatkészletben)

Példa

"activities":[
    {
        "name": "CopyFromQuickBooks",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<QuickBooks input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "QuickBooksSource",
                "query": "SELECT * FROM \"Bill\" WHERE Id = '123' "
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Adatok másolása a Quickbooks asztali verziójából

A szolgáltatás másolási tevékenysége nem tud adatokat másolni közvetlenül a Quickbooks desktopból. Ha adatokat szeretne másolni a Quickbooks Desktopból, exportálja a Quickbooks adatait egy vesszővel tagolt (CSV) fájlba, majd töltse fel a fájlt Azure Blob Storage. Innen a szolgáltatással átmásolhatja az adatokat az Ön által választott fogadóba.

Keresési tevékenység tulajdonságai

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

Következő lépések

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.