Adatok másolása a QuickBooks Online-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 másolhat adatokat a QuickBooks Online-ból az Azure Data Factory vagy a Synapse Analytics-folyamat másolási tevékenységével. 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.

Támogatott képességek

Ez a QuickBooks-ö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.

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

Csatolt szolgáltatás létrehozása a QuickBookshoz felhasználói felülettel

Az alábbi lépésekkel hozhat létre csatolt szolgáltatást a QuickBookshoz 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. Keresse meg a Gyorskönyveket, és válassza a QuickBooks-ö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 QuickBooks-összekötőre jellemző Data Factory-entitások definiálásához használt tulajdonságok részleteit ismertetik.

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

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

Property	Leírás	Required
típus	A típustulajdonságnak a következőre kell állítania: QuickBooks	Igen
connectionProperties	A QuickBookshoz való csatlakozás módját meghatározó tulajdonságok csoportja.	Igen
A következő alatt connectionProperties:
endpoint	A QuickBooks Online-kiszolgáló végpontja. (azaz quickbooks.api.intuit.com)	Igen
companyId	Az engedélyezéshez a QuickBooks-vállalat cégazonosítója. A cégazonosító megkereséséről további információt Hogyan a Cégazonosító megkeresése című témakörben talál.	Igen
consumerKey	Az OAuth 2.0 hitelesítéshez készült QuickBooks Online-alkalmazás ügyfélazonosítója. További információ innen.	Igen
consumerSecret	Az OAuth 2.0-s hitelesítéshez készült QuickBooks Online-alkalmazás titkos ügyfélkódja. 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 QuickBooks alkalmazáshoz társított OAuth 2.0 frissítési jogkivonat. További információ innen. Megjegyzés: A frissí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 SecureStringként, hogy biztonságosan tárolja, vagy hivatkozzon az Azure Key Vaultban tárolt titkos kódra.	Igen
useEncryptedEndpoints	Megadja, hogy az adatforrásvégpontok HTTPS használatával vannak-e titkosítva. Az alapértelmezett érték igaz.	Nem

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

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 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:

Property	Leírás	Required
típus	Az adathalmaz típustulajdonságának a következőnek kell lennie: QuickBooksObject	Igen
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.

Gyorskönyvek forrásként

Ha adatokat szeretne másolni a QuickBooks Online-ból, állítsa a másolási tevékenység forrástípusát a QuickBooksSource-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: QuickBooksSource	Igen
Lekérdezés	Az adatok olvasásához használja az egyéni SQL-lekérdezést. For example: "SELECT * FROM "Bill" WHERE Id = '123'".	Nem (ha "tableName" van megadva az adathalmazban)

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 Desktopbó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-adatokat egy vesszővel tagolt (CSV) fájlba, majd töltse fel a fájlt az Azure Blob Storage-ba. Innen a szolgáltatással átmásolhatja az adatokat a 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.

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.