教程：安装 Snowflake ServiceNow® 数据引入连接器¶

简介¶

学习本教程，使用 Snowsight 向导来配置和了解 Snowflake Connector for ServiceNow®，选择一些表，引入数据，并运行示例查询。

本教程并非详尽无遗。请查看 关于 Snowflake Connector for ServiceNow®V2 了解全部功能和限制。

设置 ServiceNow® 开发者实例¶

如果您不想在您的 ServiceNow® 账户上测试此连接器，可以使用开发者实例。本节介绍如何设置开发者实例。

1. 前往 ServiceNow® 开发者网站 (https://developer.servicenow.com)，并创建开发者用户。

2. 使用新创建的用户登录开发者网站并选择 Create an Instance。

3. 选择实例类型。您将收到一封包含实例 URL 的电子邮件，以及您的用户和密码。

部署通常非常快，大约五分钟。但是，在等待的同时，我们可以进入下一步并配置 Snowflake！

创建并设置 Snowflake 账户¶

满足所有先决条件¶

从 Data Products -> Apps -> Snowflake Connector for ServiceNow 启动 Snowflake Connector for ServiceNow®。您将看到连接器开始数据引入前需要完成的任务列表。请仔细阅读以下说明并逐一完成。

如果要启用 OAuth2 身份验证，最后的步骤之一会要求您创建应用程序注册表。接下来的几个步骤将聚焦这一点。

对于下一节，我们建议您打开两个浏览器选项卡，以便将某些数据从 Snowflake 复制到 ServiceNow®:

• 从 Snowflake 中，使用连接器生成重定向 URL，其将被粘贴到应用程序注册表中。

• 从 ServiceNow® 中，您需要应用程序注册表来提供客户端 ID 和密钥，然后粘贴到 Snowflake 中。

配置连接器¶

1. 选择 Start configuration。系统会显示此配置屏幕。默认情况下，这些字段设置为配置连接器时创建的对象的名称。您还可以使用现有对象。连接器将使用所选的虚拟仓库进行后台数据引入。

2. 有关更多信息，请查看 配置 Snowflake Connector for ServiceNow®V2。

3. 选择 Configure。

请注意，配置过程可能需要几分钟才能完成。

将 Snowflake 设置为 ServiceNow® OAuth2 握手¶

1. 选择 OAuth2 作为身份验证方法。

2. 填写 ServiceNow® 实例详细信息。这是 ServiceNow® 账户的 ServiceNow® URL 的第一部分，无 https://* 协议和后续 service-now.com。

3. 从 ServiceNow® 将 Client id 和 Client secret 粘贴到 Snowflake 向导。

4. 选择 Connect。ServiceNow® 账户弹出并请求连接到 Snowflake。

5. 选择 Allow。两个系统之间建立连接。

要验证连接，请选择三个点 [...] 和 View Details。您将在弹出窗口顶部看到 ServiceNow 的身份验证日期。

配置删除同步¶

如果您不仅希望插入和更新，而且还希望将删除同步到 Snowflake，则必须提供日志表的名称。默认情况下 ServiceNow® 使用 sys_audit_delete 表来存储有关已删除记录的信息，因此请随意提供此名称。如果您不关心删除，可以将此字段留空。

选择 Validate 来检查连接器是否能连接到源系统并可以访问所有所需的表。该过程可能需要几分钟才能完成。完成后，选择 Define data to sync 来选择要引入的表。

选择 ServiceNow® 表¶

1. 在 Snowflake Connector for ServiceNow 窗口顶部栏上，选择 Data Sync。

2. 为了能够稍后运行测试查询，我们需要引入几个表。在搜索窗口中输入 incident 并选中旁边的框，然后选择 30 分钟的同步时间。

3. 要选择其他表，请清除搜索，输入表名称并选中复选框。至少对 task 表执行此操作。

备注

提示：清除搜索字段，然后选择标题 Status 对选择的所有表格进行排序并显示。

4. 选择 Start Sync。选择窗口关闭，您将从主连接器窗口收到消息 Syncing Data。除了您选择的表之外，还将加载三个系统表。这些表对于构建原始数据视图是必要的：sys_dictionary、sys_db_object 和 sys_glide_object。

您会收到一条表示成功的消息。至少完全引入一个表后，就会显示该消息。

连接器监控¶

打开工作表以检查连接器状态。以下是一些您可以执行的 SQL 示例，以获取监控信息：

// Return general information about all ingestions
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats;
// Search for information about particular table ingestions
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats WHERE table_name = '<table_name>';
// Examine connector configuration
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_configuration;
// Calculate ingested data volume
SELECT
    table_name,
    sum(ingested_rows) AS row_count
FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_stats
GROUP BY table_name
ORDER BY table_name;
// General connector statistics
SELECT * FROM SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.public.connector_overview;

配置对引入数据的访问¶

连接器显示 DATA_READER 应用程序角色。该角色对目标架构中的所有引入数据具有读取权限。它会自动授予安装过程的 配置 步骤中提供的角色。在本指南前文中的屏幕截图中，它被命名为 SERVICE_NOW_RESOURCES_PROVIDER。如果需要，您可以进一步授予应用程序角色或账户角色。

查询数据¶

检查连接器在目标数据库的目标架构下创建的表。对于 ServiceNow® 中配置为同步的每个表，连接器都会创建以下表和视图：

• 包含原始形式数据的同名表，其中每条记录都包含在单个 VARIANT 列中。

• 一个名为 table_name__view 的视图，包含扁平形式的数据，其中该视图包含原始表中每一列的一列以及原始表中存在的每条记录的一行。

• 名为 table_name__view_with_deleted 的视图，包含与 table_name__view 相同的数据以及 ServiceNow 中已删除的记录的行。

• 表 table_name__event_log 包含连接器从 ServiceNow® 中提取的变更历史记录。

要从原始数据进行查询，请查看 访问原始数据。要查询视图（推荐），请查看 访问扁平化数据。

USE ROLE SERVICE_NOW_RESOURCES_PROVIDER;
USE DATABASE SERVICENOW_DEST_DB;
USE SCHEMA DEST_SCHEMA;
WITH T1 AS (
    SELECT
    DISTINCT
        T.NUMBER AS TICKET_NUMBER,
        T.SHORT_DESCRIPTION,
        T.DESCRIPTION,
        T.PRIORITY,
        T.SYS_CREATED_ON AS CREATED_ON,
        T.SYS_UPDATED_ON AS UPDATED_ON,
        T.CLOSED_AT
    FROM TASK__VIEW T
    LEFT JOIN INCIDENT__VIEW I
        ON I.SYS_ID = T.SYS_ID -- ADDITIONAL INCIDENT DETAIL
   WHERE I.SYS_ID IS NOT NULL -- THIS CONDITION HELPS KEEP JUST THE INCIDENT TICKETS
)
SELECT
 YEAR(CREATED_ON) AS YEAR_CREATED,
 MONTH(CREATED_ON) AS MONTH_CREATED,
 PRIORITY,
 COUNT(DISTINCT TICKET_NUMBER) AS NUM_INCIDENTS
FROM T1
GROUP BY
    YEAR_CREATED,
    MONTH_CREATED,
    PRIORITY
ORDER BY
    YEAR_CREATED,
    MONTH_CREATED,
    PRIORITY
;

授予连接器访问权限¶

除了用于访问目标数据库中数据的应用程序角色之外，连接器还显示了两个应用程序角色：

• VIEWER 角色对连接器配置和状态具有只读访问权限

• ADMIN 角色可以修改连接器配置并启用/禁用引入

要监控错误、运行统计数据、检查连接器统计数据以及检查启用的表，可以设置允许访问连接器数据库中的视图和只读过程的 ServiceNow® 监控角色。

例如，在工作表中运行以下命令（然后使用角色）：

USE ROLE accountadmin;
CREATE ROLE IF NOT EXISTS servicenow_monitor_role;
GRANT APPLICATION ROLE SNOWFLAKE_CONNECTOR_FOR_SERVICENOW.viewer TO ROLE servicenow_monitor_role;
GRANT USAGE ON WAREHOUSE SERVICENOW_WAREHOUSE TO ROLE servicenow_monitor_role;

停止引入¶

在本教程中，我们仅引入数据，因此在初始加载后停止引入是有意义的。但是，在生产环境中，不会停止连接器。

1. 在 Snowsight 中，选择 Snowflake Connector for ServiceNow 磁贴。

2. 在 Snowflake Connector for ServiceNow 窗口中，选择 Pause Connector。

卸载连接器（但不卸载数据）¶

如果您已完成本教程或由于任何原因不再需要连接器，可以通过 Snowflake Marketplace 轻松卸载。

1. 选择 数据产品，然后选择 应用程序。

2. 在列表上代表连接器应用程序的项目中选择三个点图标。

3. 选择 卸载。

4. 决定是否要删除应用程序拥有的对象（目标架构中包含引入数据的表和视图）或将其所有权转移给另一个角色。

5. 选择 卸载。

结论和资源¶

恭喜！您已成功安装并配置 Snowflake Connector for ServiceNow®，引入数据并运行查询以收集有关事件和优先级的见解。

您学到的内容

• 如何设置 Snowflake Connector for ServiceNow®。

• 如何将 ServiceNow® 数据引入 Snowflake。

• 如何停止连接器以避免在开发环境中产生不必要的成本。