Kopírování dat z Concuru pomocí služby 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 Concuru. 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 Concur je podporovaný pro následující funkce:

Podporované funkce IR
aktivita Copy (zdroj/-) ① ②
Aktivita Lookup ① ②

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

Poznámka:

Partner účet se v současné době nepodporuje.

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:

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

Pomocí následujícího postupu vytvořte propojenou službu concur 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ý:

  2. Vyhledejte Concur a vyberte konektor Concur.

    Screenshot of the Concur connector.

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

    Screenshot of linked service configuration for Concur.

podrobnosti o konfiguraci Připojení oru

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

Vlastnosti propojené služby

Pro propojenou službu Concur se podporují následující vlastnosti:

Vlastnost Popis Povinní účastníci
type Vlastnost typu musí být nastavená na: Concur Ano
connectionProperties Skupina vlastností, která definuje, jak se připojit ke concuru. Ano
V části connectionProperties:
authenticationType Povolené hodnoty jsou OAuth_2.0_Bearer a OAuth_2.0 (starší verze). Možnost ověřování OAuth 2.0 funguje se starým rozhraním API Concur, které bylo od února 2017 zastaralé. Ano
host Koncový bod serveru Concur, například implementation.concursolutions.com. Ano
baseUrl Základní adresa URL autorizační adresy URL vaší společnosti Concur. Ano pro OAuth_2.0_Bearer ověřování
clientId ID klienta aplikace zadané službou Concur App Management Ano
clientSecret Tajný klíč klienta odpovídající ID klienta. 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 pro OAuth_2.0_Bearer ověřování
username Uživatelské jméno, které používáte pro přístup ke službě Concur. Ano
Heslo Heslo odpovídající uživatelskému jménu, které jste zadali do pole uživatelského jména. 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
useHostVerification Určuje, jestli se má při připojování přes protokol TLS vyžadovat název hostitele v certifikátu serveru. Výchozí hodnota je true. No
usePeerVerification Určuje, jestli se má při připojování přes protokol TLS ověřit identita serveru. Výchozí hodnota je true. No

Příklad:

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

Příklad (starší verze):

Všimněte si, že toto je starší verze propojeného modelu služby bez connectionProperties ověřování a použití OAuth_2.0 ověřování.

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

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

Chcete-li kopírovat data z Concur, nastavte vlastnost typu datové sady na ConcurObject. Tento typ datové sady neobsahuje žádnou další vlastnost specifickou pro typ. Podporují se následující vlastnosti:

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

Příklad

{
    "name": "ConcurDataset",
    "properties": {
        "type": "ConcurObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Concur 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 Concur.

ConcurSource jako zdroj

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

Příklad:

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

Vlastnosti aktivity vyhledávání

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

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