使用 Azure 数据工厂或 Synapse Analytics 在 Zendesk(预览版)中转换数据
适用于: Azure 数据工厂 Azure Synapse Analytics
提示
试用 Microsoft Fabric 中的数据工厂,这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用!
本文概述了如何使用数据流在 Zendesk(预览版)中转换数据。 有关详细信息,请阅读 Azure 数据工厂或 Azure Synapse Analytics 的简介文章。
重要
此连接器目前提供预览版。 欢迎试用并提供反馈。 若要在解决方案中使用预览版连接器的依赖项,请联系 Azure 客户支持。
支持的功能
此 Zendesk 连接器支持以下功能:
支持的功能 | IR |
---|---|
映射数据流(源/-) | ① |
① Azure 集成运行时 ② 自承载集成运行时
如需可以用作源/接收器的数据存储的列表,请参阅支持的数据存储表。
使用 UI 创建 Zendesk 链接服务
使用以下步骤在 Azure 门户 UI 中创建 Zendesk 链接服务。
浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡,并选择“链接服务”,然后单击“新建”:
搜索“Zendesk(预览版)”,并选择“Zendesk(预览版)”连接器。
配置服务详细信息、测试连接并创建新的链接服务。
连接器配置详细信息
下面各部分介绍了用于定义 Zendesk 特定数据工厂和 Synapse 管道实体的属性的信息。
链接服务属性
Zendesk 链接服务支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | type 属性必须设置为 Zendesk。 | 是 |
url | Zendesk 服务的基 URL。 | 是 |
authenticationType | 用于连接到 Zendesk 服务的身份验证类型。 允许的值为:基本和令牌。 有关其他属性和示例,请参阅下面的相应部分。 | 是 |
基本身份验证
将 authenticationType 属性设置为“基本”。 除了前面部分所述的通用属性,还指定以下属性:
属性 | 描述 | 必选 |
---|---|---|
userName | 用于登录到 Zendesk 的用户名。 | 是 |
password | 指定为用户名指定的用户帐户的密码。 将此字段标记为 SecureString 以安全存储它。 或者,可以引用 Azure Key Vault 中存储的机密。 | 是 |
示例:
{
"name": "ZendeskLinkedService",
"properties": {
"type": "Zendesk",
"typeProperties": {
"url": "<base url>",
"authenticationType": "basic",
"userName": "<user name>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
令牌身份验证
将 authenticationType 属性设置为“令牌”。 除了前面部分所述的通用属性,还指定以下属性:
属性 | 描述 | 必需 |
---|---|---|
apiToken | 指定用于 Zendesk 的 API 令牌。 将此字段标记为 SecureString 以安全存储它。 或者,可以引用 Azure Key Vault 中存储的机密。 | 是 |
示例:
{
"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
相关内容
有关复制活动支持作为源和接收器的数据存储的列表,请参阅受支持的数据存储。