Compartilhar via

使用 Azure 数据工厂 或 Synapse Analytics 转换 Zendesk (预览版)中的数据

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

本文概述了如何使用数据流转换 Zendesk(预览版)中的数据。 若要了解详细信息,请阅读 Azure 数据工厂Azure Synapse Analytics的介绍性文章。

重要

此连接器目前提供预览版。 欢迎试用并提供反馈。 如果要依赖解决方案中的预览连接器,请联系 Azure 支持

支持的功能

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

支持的功能 IR
映射数据流(源/-)

(1) Azure集成运行时 (2) 自承载集成运行时

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

使用 UI 创建 Zendesk 链接服务

使用以下步骤在Azure门户 UI 中创建 Zendesk 链接服务。

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

    创建新的链接的服务的 Azure 数据工厂用户界面截图

  2. 搜索“Zendesk(预览版)”,并选择“Zendesk(预览版)”连接器。

    显示选择 Zendesk 连接器的屏幕截图。

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

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

连接器配置详细信息

下面各部分介绍了用于定义 Zendesk 特定数据工厂和 Synapse 管道实体的属性的信息。

连接的服务属性

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

属性 描述 必需
类型 type 属性必须设置为 Zendesk。
url Zendesk 服务的基础 URL。
认证类型 用于连接到 Zendesk 服务的身份验证类型。 允许的值为:基本和令牌。 有关其他属性和示例,请参阅下面的相应部分。

基本身份验证

将 authenticationType 属性设置为“基本”。 除了前面部分所述的通用属性,还指定以下属性:

属性 描述 必需
userName 用于登录到 Zendesk 的用户名。
密码 指定为用户名指定的用户帐户的密码。 将此字段标记为 SecureString 以安全存储它。 或者,可以引用存储在 Azure 密钥保管库 中的机密。

示例:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "basic",
            "userName": "<user name>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

令牌身份验证

将 authenticationType 属性设置为“令牌”。 除了前面部分所述的通用属性,还指定以下属性:

属性 描述 必需
API令牌 指定用于 Zendesk 的 API 令牌。 将此字段标记为 SecureString 以安全存储它。 或者,可以引用存储在 Azure 密钥保管库 中的机密。

示例:

{
    "name": "ZendeskLinkedService",
    "properties": {
        "type": "Zendesk",
        "typeProperties": {
            "url": "<base url>",
            "authenticationType": "token",
            "apiToken": {
                "type": "SecureString",
                "value": "<API token>"
            }
        }
    }
}

映射数据流属性

转换映射数据流中的数据时,可以从 Zendesk 中读取表。 有关详细信息,请参阅映射数据流中的源转换。 只能使用内联数据集作为源类型。

源转换

下表列出了 Zendesk 源支持的属性。 你可以在“源选项”选项卡中编辑这些属性。

名称 描述 必需 允许的值 数据流脚本属性
实体 Zendesk 中实体的逻辑名称。 是的,当使用内联模式时 activities
group_memberships
groups
organizations
requests
satisfaction_ratings
sessions
tags
targets
ticket_audits
ticket_fields
ticket_metrics
tickets
triggers
users
views
实体

Zendesk 源脚本示例

source(allowSchemaDrift: true,
	validateSchema: false,
	store: 'zendesk',
	format: 'rest',
	entity: 'tickets') ~> ZendeskSource

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