使用 Azure 数据工厂或 Synapse Analytics(预览版)从 Concur 复制数据

适用于:Azure 数据工厂 Azure Synapse Analytics

重要

此连接器位于 支持阶段的末尾。 建议通过安装驱动程序迁移到 ODBC 连接器 。

本文概述了如何在 Azure 数据工厂或 Synapse Analytics 管道中使用“复制活动”来从 Concur 复制数据。 它建立在提供复制活动总体概述的复制活动概述文章之上。

支持的功能

此 Concur 连接器支持以下功能:

支持的功能 IR
复制活动(源/-) (1) (2)
查找活动 (1) (2)

① Azure 集成运行时 ② 自承载集成运行时

如需可以用作源/接收器的数据存储的列表,请参阅支持的数据存储表。

连接器支持此文章中的 Windows 版本。

注意

当前不支持合作伙伴帐户。

入门

若要使用管道执行复制活动,可以使用以下工具或 SDK 之一:

使用 UI 创建到 Concur 的链接服务

使用以下步骤在 Azure 门户 UI 中创建一个到 Concur 的链接服务。

  1. 浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡,并选择“链接服务”,然后单击“新建”:

  2. 搜索“Concur”并选择“Concur 连接器”。

    Concur 连接器的屏幕截图。

  3. 配置服务详细信息、测试连接并创建新的链接服务。

    Concur 的链接服务配置的屏幕截图。

连接器配置详细信息

对于特定于 Concur 连接器的数据工厂实体,以下部分提供有关用于定义这些实体的属性的详细信息。

链接的服务属性

Concur 链接服务支持以下属性:

属性 描述 必填
类型 type 属性必须设置为:Concur 是
连接属性 定义如何连接到 Concur 的一组属性。 是
在 connectionProperties 下:
身份验证类型 允许的值为 OAuth_2.0_Bearer 和 OAuth_2.0(旧版)。 OAuth 2.0 验证选项适用于 2017 年 2 月已弃用的旧 Concur API。 是
主持人 Concur 服务器的端点,比如 implementation.concursolutions.com。 是
baseUrl Concur 授权 URL 的基础 URL。 是,用于OAuth_2.0_Bearer身份验证
clientId 由 Concur 应用管理提供的应用程序客户端 ID。 是
客户端密钥 与客户端 ID 相对应的客户端密码。 将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure 密钥保管库 中的机密。 是,用于OAuth_2.0_Bearer身份验证
用户名 用于访问 Concur 服务的用户名。 是
密码 在“用户名”字段中提供的用户名所对应的密码。 将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure 密钥保管库 中的机密。 是
使用加密端点 指定是否使用 HTTPS 加密数据源终结点。 默认值为 true。 否
useHostVerification 指定通过 TLS 进行连接时是否要求服务器证书中的主机名与服务器的主机名匹配。 默认值为 true。 否
usePeerVerification 指定通过 TLS 进行连接时是否要验证服务器的标识。 默认值为 true。 否

示例:

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

示例(旧版):

请注意,以下是没有 connectionProperties 且使用 OAuth_2.0 身份验证的旧版链接服务模型。

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

数据集属性

有关可用于定义数据集的各部分和属性的完整列表,请参阅数据集一文。 本部分提供 Concur 数据集支持的属性列表。

要从 Concur 复制数据,请将数据集的 type 属性设置为“ConcurObject”。 此类型的数据集中没有其他特定于类型的属性。 支持以下属性:

属性 描述 必填
类型 数据集的 type 属性必须设置为:ConcurObject 是
表名称 表的名称。 否(如果指定了活动源中的“query”)

示例

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

复制活动属性

有关可用于定义活动的各部分和属性的完整列表,请参阅管道一文。 本部分提供 Concur 数据源支持的属性列表。

以 ConcurSource 作为源

要从 Concur 复制数据,请将复制活动中的源类型设置为“ConcurSource”。 复制活动source部分支持以下属性:

属性 描述 必填
类型 复制活动 source 的 type 属性必须设置为:ConcurSource 是
查询 使用自定义 SQL 查询读取数据。 例如:"SELECT * FROM Opportunities where Id = xxx "。 否(如果指定了数据集中的“tableName”这个字段)

示例:

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

查找活动属性

若要了解有关属性的详细信息,请查看 Lookup 活动。

有关复制活动支持的源和接收器数据存储列表,请参阅支持的数据存储。