使用 Azure 数据工厂或 Synapse Analytics 从 ServiceNow 复制数据
适用于:Azure 数据工厂 Azure Synapse Analytics
本文概述如何在 Azure 数据工厂和 Synapse Analytics 管道中使用复制活动从 ServiceNow 复制数据。 它是基于概述复制活动总体的复制活动概述一文。
重要
新的 ServiceNow 连接器提供改进的本机 ServiceNow 支持。 如果在解决方案中使用旧版 ServiceNow 连接器,建议尽早升级 ServiceNow 连接器。 有关旧版和最新版本之间的差异的详细信息,请参阅此部分。
支持的功能
此 ServiceNow 连接器支持以下功能:
支持的功能 | IR |
---|---|
复制活动(源/-) | ① ② |
Lookup 活动 | ① ② |
① Azure 集成运行时 ② 自承载集成运行时
如需可以用作源/接收器的数据存储的列表,请参阅支持的数据存储表。
服务提供了内置驱动程序,用来启用连接。 因此,使用此连接器无需手动安装任何驱动程序。
请使用实际值,而不是 ServiceNow 中的显示值。
先决条件
若要使用此连接器,你需要有一个至少对 ServiceNow 中的 sys_db_object 和 sys_dictionary 表具有读取访问权限的角色。
使用入门
若要使用管道执行复制活动,可以使用以下工具或 SDK 之一:
使用 UI 创建到 ServiceNow 的链接服务
使用以下步骤在 Azure 门户 UI 中创建一个到 ServiceNow 的链接服务。
浏览到 Azure 数据工厂或 Synapse 工作区中的“管理”选项卡并选择“链接服务”,然后单击“新建”:
搜索“ServiceNow”并选择 ServiceNow 连接器。
配置服务详细信息、测试连接并创建新的链接服务。
连接器配置详细信息
对于特定于 ServiceNow 连接器的数据工厂实体,以下部分提供有关用于定义这些实体的属性的详细信息。
链接服务属性
ServiceNow 链接服务支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | type 属性必须设置为:ServiceNowV2 | 是 |
endpoint | ServiceNow 服务器的终结点 (http://<instance>.service-now.com )。 |
是 |
authenticationType | 可使用的身份验证类型。 允许值包括:BasicOAuth2 |
是 |
username | 用户名用于连接到 ServiceNow 服务器,进行基本和 OAuth2 身份验证。 | 是 |
password | 基本和 OAuth2 身份验证的用户名所对应的密码。 将此字段标记为 SecureString 以安全地存储它,或引用存储在 Azure Key Vault 中的机密。 | 是 |
clientId | OAuth2 身份验证的客户端 ID。 | 是,适用于 OAuth 身份验证 |
clientSecret | OAuth2 身份验证的客户端密码。 将此字段标记为 SecureString 以安全地存储它,或引用 Azure Key Vault 中存储的机密。 | 是,适用于 OAuth 身份验证 |
grantType | 指定客户端应用用于访问令牌的 OAuth2.0 流的类型。 默认值为密码。 | 是,适用于 OAuth 身份验证 |
示例:
{
"name": "ServiceNowLinkedService",
"properties": {
"type": "ServiceNowV2",
"typeProperties": {
"endpoint" : "http://<instance>.service-now.com",
"authenticationType" : "Basic",
"username" : "<username>",
"password": {
"type": "SecureString",
"value": "<password>"
}
}
}
}
数据集属性
有关可用于定义数据集的各部分和属性的完整列表,请参阅数据集一文。 本部分提供 ServiceNow 数据集支持的属性列表。
要从 ServiceNow 复制数据,请将数据集的 type 属性设置为ServiceNowV2Object。 支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | 数据集的 type 属性必须设置为:ServiceNowV2Object | 是 |
tableName | 表的名称。 | 是 |
示例
{
"name": "ServiceNowDataset",
"properties": {
"type": "ServiceNowV2Object",
"typeProperties": {
"tableName": "<table name>"
},
"schema": [],
"linkedServiceName": {
"referenceName": "<ServiceNow linked service name>",
"type": "LinkedServiceReference"
}
}
}
复制活动属性
有关可用于定义活动的各部分和属性的完整列表,请参阅管道一文。 本部分提供 ServiceNow 源支持的属性列表。
以 ServiceNow 作为源
要从 ServiceNow 复制数据,请将复制活动中的源类型设置为ServiceNowV2Source。 复制活动source部分支持以下属性:
属性 | 描述 | 必需 |
---|---|---|
type | 复制活动源的 type 属性必须设置为:ServiceNowV2Source | 是 |
表达式 | 使用表达式读取数据。 可以在查询生成器中配置表达式。 它与 ServiceNow 中的条件生成器具有相同的用法。 有关如何使用它的说明,请参阅本文。 | 否 |
在 下 | ||
type | 表达式类型。 值可以是常量(默认值)、一元、二进制和字段。 | 否 |
value | 常量值。 | 是(当表达式类型为常量或字段时) |
运算符 | 运算符值。 有关运算符的详细信息,请参阅本文中的运算符可用于包含字符串的选择字段部分。 | 是(当表达式类型为一元或二进制时) |
操作数 | 对其应用运算符的表达式列表。 | 是(当表达式类型为一元或二进制时) |
示例:
"activities": [
{
"name": "CopyFromServiceNow",
"type": "Copy",
"inputs": [
{
"referenceName": "<ServiceNow input dataset name>",
"type": "DatasetReference"
}
],
"outputs": [
{
"referenceName": "<output dataset name>",
"type": "DatasetReference"
}
],
"typeProperties": {
"source": {
"type": "ServiceNowV2Source",
"expression": {
"type": "Nary",
"operators": [
"<"
],
"operands": [
{
"type": "Field",
"value": "u_founded"
},
{
"type": "Constant",
"value": "2000"
}
]
}
},
"sink": {
"type": "<sink type>"
}
}
}
]
查找活动属性
若要了解有关属性的详细信息,请查看 Lookup 活动。
升级 ServiceNow 连接器
下面是帮助你升级 ServiceNow 连接器的步骤:
- 引用链接服务属性以新建链接服务。
- 源中的查询升级到查询生成器,该生成器与 ServiceNow 中的条件生成器具有相同的用法。 请参阅ServiceNow 作为源,以了解如何配置它。
ServiceNow 与 ServiceNow(旧版)之间的差异
ServiceNow 连接器提供新功能,并与 ServiceNow(旧版)连接器的大多数功能兼容。 下表显示了 ServiceNow 与 ServiceNow(旧版)之间的功能差异。
ServiceNow | ServiceNow(旧版) |
---|---|
链接服务不支持 useEncryptedEndpoints、useHostVerification 和 usePeerVerification。 | 支持链接服务中的 useEncryptedEndpoints、useHostVerification 和 usePeerVerification。 |
在源中支持查询生成器。 | 源不支持查询生成器。 |
不支持基于 SQL 的查询。 | 支持基于 SQL 的查询。 |
查询生成器不支持 sortBy 查询。 | 支持查询中的 sortBy 查询。 |
可以在数据集中查看架构。 | 无法在数据集中查看架构。 |
相关内容
有关复制活动支持作为源和接收器的数据存储的列表,请参阅支持的数据存储。