Udostępnij za pośrednictwem


Kopiowanie danych z usługi QuickBooks Online przy użyciu usługi Azure Data Factory lub Synapse Analytics (wersja zapoznawcza)

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób używania działania kopiowania w potoku usługi Azure Data Factory lub Synapse Analytics do kopiowania danych z usługi QuickBooks Online. Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Ważne

Ten łącznik jest obecnie w wersji zapoznawczej. Możesz wypróbować go i przekazać nam swoją opinię. Jeśli w swoim rozwiązaniu chcesz wprowadzić zależność od łączników w wersji zapoznawczej, skontaktuj się z pomocą techniczną platformy Azure.

Obsługiwane możliwości

Ten łącznik QuickBooks jest obsługiwany w przypadku następujących możliwości:

Obsługiwane możliwości IR
działanie Kopiuj (źródło/-) (1) (2)
Działanie Lookup (1) (2)

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła/ujścia, zobacz tabelę Obsługiwane magazyny danych.

Ten łącznik obsługuje uwierzytelnianie quickBooks OAuth 2.0.

Wprowadzenie

Aby wykonać działanie Kopiuj za pomocą potoku, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

Tworzenie połączonej usługi z aplikacją QuickBooks przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę z aplikacją QuickBooks w interfejsie użytkownika witryny Azure Portal.

  1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

  2. Wyszukaj pozycję QuickBooks i wybierz łącznik QuickBooks.

    Zrzut ekranu przedstawiający łącznik QuickBooks.

  3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

    Zrzut ekranu przedstawiający konfigurację połączonej usługi dla elementów QuickBooks.

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika QuickBooks.

Właściwości połączonej usługi

Następujące właściwości są obsługiwane w przypadku połączonej usługi QuickBooks:

Właściwości Opis Wymagania
type Właściwość type musi być ustawiona na: QuickBooks Tak
connectionProperties Grupa właściwości definiujących sposób nawiązywania połączenia z elementami QuickBooks. Tak
W obszarze connectionProperties:
endpoint Punkt końcowy serwera QuickBooks Online. (czyli quickbooks.api.intuit.com) Tak
companyId Identyfikator firmy QuickBooks do autoryzowania. Aby uzyskać informacje na temat znajdowania identyfikatora firmy, zobacz Jak mogę znajdź identyfikator firmy. Tak
consumerKey Identyfikator klienta aplikacji QuickBooks Online na potrzeby uwierzytelniania OAuth 2.0. Dowiedz się więcej tutaj. Tak
consumerSecret Wpis tajny klienta aplikacji QuickBooks Online na potrzeby uwierzytelniania OAuth 2.0. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault. Tak
refreshToken Token odświeżania OAuth 2.0 skojarzony z aplikacją QuickBooks. Dowiedz się więcej tutaj. Token odświeżania notatki wygaśnie po upływie 180 dni. Klient musi regularnie aktualizować token odświeżania.
Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault.
Tak
useEncryptedEndpoints Określa, czy punkty końcowe źródła danych są szyfrowane przy użyciu protokołu HTTPS. Wartość domyślna to true. Nie.

Przykład:

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

Obsługa tokenów odświeżania dla połączonej usługi

Jeśli używasz łącznika QuickBooks Online w połączonej usłudze, ważne jest prawidłowe zarządzanie tokenami odświeżania protokołu OAuth 2.0 z poziomu elementów QuickBooks. Połączona usługa używa tokenu odświeżania do uzyskiwania nowych tokenów dostępu. Jednak usługa QuickBooks Online okresowo aktualizuje token odświeżania, unieważniając poprzedni. Połączona usługa nie aktualizuje automatycznie tokenu odświeżania w usłudze Azure Key Vault, dlatego należy zarządzać aktualizowaniem tokenu odświeżania w celu zapewnienia nieprzerwanej łączności. W przeciwnym razie mogą wystąpić błędy uwierzytelniania po wygaśnięciu tokenu odświeżania.

Token odświeżania można zaktualizować ręcznie w usłudze Azure Key Vault na podstawie zasad wygasania tokenu odświeżania usługi QuickBooks Online. Innym podejściem jest jednak zautomatyzowanie aktualizacji za pomocą zaplanowanego zadania lub funkcji platformy Azure, która sprawdza nowy token odświeżania i aktualizuje je w usłudze Azure Key Vault.

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych QuickBooks.

Aby skopiować dane z usługi QuickBooks Online, ustaw właściwość type zestawu danych na QuickBooksObject. Obsługiwane są następujące właściwości:

Właściwości Opis Wymagania
type Właściwość type zestawu danych musi być ustawiona na: QuickBooksObject Tak
tableName Nazwa tabeli. Nie (jeśli określono "zapytanie" w źródle działania)

Przykład

{
    "name": "QuickBooksDataset",
    "properties": {
        "type": "QuickBooksObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<QuickBooks linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło QuickBooks.

QuickBooks jako źródło

Aby skopiować dane z usługi QuickBooks Online, ustaw typ źródła w działaniu kopiowania na wartość QuickBooksSource. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

Właściwości Opis Wymagania
type Właściwość type źródła działania kopiowania musi być ustawiona na: QuickBooksSource Tak
zapytanie Użyj niestandardowego zapytania SQL, aby odczytać dane. Na przykład: "SELECT * FROM "Bill" WHERE Id = '123'". Nie (jeśli określono "tableName" w zestawie danych)

Przykład:

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

Kopiowanie danych z programu Quickbooks Desktop

Działanie kopiowania w usłudze nie może kopiować danych bezpośrednio z programu Quickbooks Desktop. Aby skopiować dane z programu Quickbooks Desktop, wyeksportuj dane quickbook do pliku wartości rozdzielanych przecinkami (CSV), a następnie przekaż plik do usługi Azure Blob Storage. Z tego miejsca możesz użyć usługi, aby skopiować dane do wybranego ujścia.

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.