Kopírování dat z QuickBooks Online pomocí Azure Data Factory nebo Synapse Analytics (Preview)

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 QuickBooks Online. 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.

Podporované funkce

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

Podporované funkce	IR
aktivita Copy (zdroj/-)	(1) (2)
Aktivita Lookup	(1) (2)

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

Tento konektor podporuje ověřování QuickBooks OAuth 2.0.

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:

• Nástroj pro kopírování dat
• Azure Portal
• Sada .NET SDK
• Sada Python SDK
• Azure PowerShell
• Rozhraní REST API
• Šablona Azure Resource Manageru

Vytvoření propojené služby pro QuickBooks pomocí uživatelského rozhraní

Pomocí následujícího postupu vytvořte propojenou službu pro QuickBooks v uživatelském rozhraní webu Azure Portal.

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

   

2. Vyhledejte QuickBooks a vyberte konektor QuickBooks.

   

3. Nakonfigurujte podrobnosti o službě, otestujte připojení a vytvořte novou propojenou službu.

   

Podrobnosti konfigurace konektoru

Následující části obsahují podrobnosti o vlastnostech, které slouží k definování entit služby Data Factory specifických pro konektor QuickBooks.

Vlastnosti propojené služby

Propojené služby QuickBooks podporují následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu musí být nastavená na: QuickBooks.	Ano
connectionProperties	Skupina vlastností, která definuje, jak se připojit k QuickBooks.	Ano
V části connectionProperties:
endpoint	Koncový bod serveru QuickBooks Online. (to znamená quickbooks.api.intuit.com)	Ano
companyId	ID společnosti QuickBooks, která se má autorizovat. Informace o tom, jak najít ID společnosti, najdete v tématu Návody vyhledání ID společnosti.	Ano
consumerKey	ID klienta vaší aplikace QuickBooks Online pro ověřování OAuth 2.0. Další informace najdete tady.	Ano
consumerSecret	Tajný klíč klienta vaší aplikace QuickBooks Online pro ověřování OAuth 2.0. 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 OAuth 2.0 přidružený k aplikaci QuickBooks. Další informace najdete tady. Poznámka: Platnost obnovovacího tokenu vyprší po 180 dnech. Zákazník musí pravidelně aktualizovat obnovovací token. 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
useEncryptedEndpoints	Určuje, jestli jsou koncové body zdroje dat šifrované pomocí protokolu HTTPS. Výchozí hodnota je true.	No

Příklad:

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

Zpracování obnovovacích tokenů pro propojenou službu

Pokud používáte konektor QuickBooks Online v propojené službě, je důležité správně spravovat obnovovací tokeny OAuth 2.0 z QuickBooks. Propojená služba k získání nových přístupových tokenů používá obnovovací token. QuickBooks Online ale pravidelně aktualizuje obnovovací token a zneplatní předchozí token. Propojená služba neaktualizuje automaticky obnovovací token ve službě Azure Key Vault, takže potřebujete spravovat aktualizaci obnovovacího tokenu, abyste zajistili nepřerušované připojení. Jinak může dojít k selhání ověřování po vypršení platnosti obnovovacího tokenu.

Obnovovací token ve službě Azure Key Vault můžete ručně aktualizovat na základě zásad vypršení platnosti obnovovacího tokenu QuickBooks Online. Dalším přístupem je ale automatizovat aktualizace pomocí naplánované úlohy nebo funkce Azure Functions , která kontroluje nový obnovovací token a aktualizuje je ve službě Azure Key Vault.

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

Pokud chcete kopírovat data z QuickBooks Online, nastavte vlastnost typu datové sady na QuickBooksObject. Podporují se následující vlastnosti:

Vlastnost	Popis	Povinní účastníci
type	Vlastnost typu datové sady musí být nastavená na: QuickBooksObject.	Ano
tableName	Název tabulky.	Ne (pokud je zadán dotaz ve zdroji aktivity)

Příklad

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks 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 QuickBooks.

QuickBooks jako zdroj

Pokud chcete kopírovat data z QuickBooks Online, nastavte typ zdroje v aktivitě kopírování na QuickBooksSource. 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 nastavená na: QuickBooksSource.	Ano
query	Ke čtení dat použijte vlastní dotaz SQL. Například: "SELECT * FROM "Bill" WHERE Id = '123'".	Ne (pokud je v datové sadě zadán název tabulky)

Příklad:

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

Kopírování dat z Quickbooks Desktopu

Aktivita kopírování ve službě nemůže kopírovat data přímo z Quickbooks Desktopu. Pokud chcete kopírovat data z Quickbooks Desktopu, exportujte data Quickbooks do souboru s hodnotami oddělenými čárkami (CSV) a pak soubor nahrajte do služby Azure Blob Storage. Odtud můžete pomocí služby zkopírovat data do jímky podle svého výběru.

Vlastnosti aktivity vyhledávání

Podrobnosti o vlastnostech najdete v aktivitě Vyhledávání.

Související obsah

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