你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure 数据工厂或 Synapse Analytics 从 ServiceNow 复制数据

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

提示

试用 Microsoft Fabric 中的数据工厂，这是一种适用于企业的一站式分析解决方案。 Microsoft Fabric 涵盖从数据移动到数据科学、实时分析、商业智能和报告的所有内容。 了解如何免费开始新的试用！

本文概述如何在 Azure 数据工厂和 Synapse Analytics 管道中使用复制活动从 ServiceNow 复制数据。 它是基于概述复制活动总体的复制活动概述一文。

重要

新的 ServiceNow 连接器提供改进的本机 ServiceNow 支持。 如果在解决方案中使用旧版 ServiceNow 连接器，建议尽早升级 ServiceNow 连接器。 有关旧版和最新版本之间的差异的详细信息，请参阅此部分。

支持的功能

此 ServiceNow 连接器支持以下功能：

支持的功能	IR
复制活动（源/-）	① ②
Lookup 活动	① ②

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

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

服务提供了内置驱动程序，用来启用连接。 因此，使用此连接器无需手动安装任何驱动程序。

请使用实际值，而不是 ServiceNow 中的显示值。

先决条件

若要使用此连接器，你需要有一个至少对 ServiceNow 中的 sys_db_object 和 sys_dictionary 表具有读取访问权限的角色。

使用入门

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

• 复制数据工具
• Azure 门户
• .NET SDK
• Python SDK
• Azure PowerShell
• REST API
• Azure 资源管理器模板

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

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

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

   Azure 数据工厂

   

   Azure Synapse

   

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

   

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

   

连接器配置详细信息

对于特定于 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	表达式类型。 值可以是 Constant（默认值）、Unary、Binary、Field 和 Nary。	否
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>"
            }
        }
    }
]

使用表达式参数

可以通过选择“添加动态内容”在“查询生成器”中配置表达式参数。 参数类型应为 Object，值应遵循以下示例 JSON 中显示的格式：

 {
	"type": "Nary",
	"operators": [
		"="
	],
	"operands": [
		{
			"type": "Field",
			"value": "col"
		},
		{
			"type": "Constant",
			"value": "val"
		}
	]
}

下面是使用表达式参数的源 JSON 的示例：

"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": "Expression",
                    "value": "@pipeline().parameters.expressionParameter"
                }
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

查找活动属性

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

升级 ServiceNow 连接器

下面是帮助你升级 ServiceNow 连接器的步骤：

1. 引用链接服务属性以新建链接服务。
2. 源中的查询升级到查询生成器，该生成器与 ServiceNow 中的条件生成器具有相同的用法。 请参阅ServiceNow 作为源，以了解如何配置它。

ServiceNow 与 ServiceNow（旧版）之间的差异

ServiceNow 连接器提供新功能，并与 ServiceNow（旧版）连接器的大多数功能兼容。 下表显示了 ServiceNow 与 ServiceNow（旧版）之间的功能差异。

ServiceNow	ServiceNow（旧版）
链接服务不支持 useEncryptedEndpoints、useHostVerification 和 usePeerVerification。	支持链接服务中的 useEncryptedEndpoints、useHostVerification 和 usePeerVerification。
在源中支持查询生成器。	源不支持查询生成器。
不支持基于 SQL 的查询。	支持基于 SQL 的查询。
查询生成器不支持 sortBy 查询。	支持查询中的 sortBy 查询。
可以在数据集中查看架构。	无法在数据集中查看架构。

相关内容

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