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

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Wskazówka

Data Factory w usłudze Microsoft Fabric jest następną generacją Azure Data Factory z prostszą architekturą, wbudowaną sztuczną inteligencją i nowymi funkcjami. Jeśli dopiero zaczynasz integrować dane, zacznij od Fabric Data Factory. Istniejące obciążenia ADF można zaktualizować do Fabric, aby uzyskać dostęp do nowych możliwości w zakresie nauki o danych, analiz w czasie rzeczywistym oraz raportowania.

Ważne

Ten łącznik znajduje się na etapie zakończenia pomocy technicznej. Zaleca się przeprowadzenie migracji do łącznika ODBC przez zainstalowanie sterownika.

W tym artykule opisano sposób użycia działania kopiowania w potoku Azure Data Factory lub Synapse Analytics w celu skopiowania danych z usługi Concur. Opiera się na omówieniu działania kopiowania, które przedstawia ogólny przegląd działania kopiowania.

Obsługiwane możliwości

Ten łącznik Concur jest obsługiwany dla następujących funkcjonalności:

Obsługiwane możliwości środowisko IR
Kopiuj działanie (źródło/-) (1) (2)
Aktywność wyszukiwania (1) (2)

(1) Środowisko uruchomieniowe Azure (2) Środowisko uruchomieniowe lokalnie hostowane

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

Złącze obsługuje wersje Windows w tym artykule.

Uwaga

Konto partnera nie jest obecnie obsługiwane.

Wprowadzenie

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

Tworzenie połączonej usługi do aplikacji Concur przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć zintegrowaną usługę Concur w interfejsie portalu Azure.

  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 wybierz pozycję Nowe:

  2. Wyszukaj Concur i wybierz łącznik Concur.

    Zrzut ekranu przedstawiający łącznik Concur.

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

    Zrzut ekranu przedstawiający połączoną konfigurację usługi dla aplikacji Concur.

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

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

Następujące właściwości są obsługiwane w przypadku powiązanej usługi Concur:

Właściwości Opis Wymagane
typ Właściwość type musi być ustawiona na: Concur Tak
właściwościPołączenia Grupa właściwości definiujących sposób nawiązywania połączenia z usługą Concur. Tak
W obszarze connectionProperties:
typUwierzytelnienia Dozwolone wartości to OAuth_2.0_Bearer i OAuth_2.0 (starsza wersja). Opcja uwierzytelniania OAuth 2.0 współpracuje z wycofanym z użytku od lutego 2017 r. starym interfejsem API Concur. Tak
gospodarz Punkt końcowy serwera Concur, np. implementation.concursolutions.com. Tak
baseUrl Podstawowy adres URL autoryzacji Concur. Tak dla OAuth_2.0_Bearer uwierzytelniania
clientId Identyfikator klienta aplikacji dostarczony przez usługę Concur App Management. Tak
clientSecret Klucz tajny klienta odpowiadający identyfikatorowi klienta. Oznacz to pole jako SecureString, aby przechowywać je bezpiecznie lub odwołaj się do sekretu przechowywanego w Azure Key Vault. Tak dla OAuth_2.0_Bearer uwierzytelniania
nazwa użytkownika Nazwa użytkownika używana do uzyskiwania dostępu do usługi Concur. Tak
hasło Hasło odpowiadające nazwie użytkownika podanej w polu nazwa użytkownika. Oznacz to pole jako SecureString, aby przechowywać je bezpiecznie lub odwołaj się do sekretu przechowywanego w Azure Key Vault. Tak
używajZaszyfrowanychPunktówKońcowych Określa, czy punkty końcowe źródła danych są szyfrowane przy użyciu protokołu HTTPS. Wartość domyślna to true. Nie.
useHostVerification Określa, czy nazwa hosta w certyfikacie serwera ma być zgodna z nazwą hosta serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.
usePeerVerification Określa, czy należy zweryfikować tożsamość serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.

Przykład:

{ 
    "name": "ConcurLinkedService", 
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "connectionProperties": {
                "host":"<host e.g. implementation.concursolutions.com>",
                "baseUrl": "<base URL for authorization e.g. us-impl.api.concursolutions.com>",
                "authenticationType": "OAuth_2.0_Bearer",
                "clientId": "<client id>",
                "clientSecret": {
                    "type": "SecureString",
                    "value": "<client secret>"
                },
                "username": "fakeUserName",
                "password": {
                    "type": "SecureString",
                    "value": "<password>"
                },
                "useEncryptedEndpoints": true,
                "useHostVerification": true,
                "usePeerVerification": true
            }
        }
    }
} 

Przykład (starsza wersja):

Zwróć uwagę, że poniższy model usługi jest starszym modelem połączonej usługi bez uwierzytelniania przy użyciu connectionProperties i z uwierzytelnianiem przy użyciu OAuth_2.0.

{
    "name": "ConcurLinkedService",
    "properties": {
        "type": "Concur",
        "typeProperties": {
            "clientId" : "<clientId>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

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

Aby skopiować dane z aplikacji Concur, ustaw właściwość type zestawu danych na ConcurObject. W tym typie zestawu danych nie ma dodatkowej właściwości specyficznej dla typu. Obsługiwane są następujące właściwości:

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

Przykład

{
    "name": "ConcurDataset",
    "properties": {
        "type": "ConcurObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Concur linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Właściwości aktywności kopiowania

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

ConcurSource jako źródło

Aby skopiować dane z concur, ustaw typ źródła w działaniu kopiowania na ConcurSource. Następujące właściwości są obsługiwane w sekcji źródła działania kopiowania:

Właściwości Opis Wymagane
typ Właściwość type źródła działania kopiowania musi być ustawiona na: ConcurSource Tak
kwerenda Użyj niestandardowego zapytania SQL, aby odczytać dane. Na przykład: "SELECT * FROM Opportunities where Id = xxx ". Nie (jeśli określono "tableName" w zestawie danych)

Przykład:

"activities":[
    {
        "name": "CopyFromConcur",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Concur input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "ConcurSource",
                "query": "SELECT * FROM Opportunities where Id = xxx"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Właściwości czynności wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź akcję wyszukiwania.

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