访问 Snowflake 中的 ServiceNow® 数据¶

授予访问 Snowflake 中 ServiceNow® 数据的权限¶

Snowflake Connector for ServiceNow®V2 与 Snowflake 同步数据后，任何具有以下权限的角色都可以访问 ServiceNow® 数据：

• Snowflake 中包含 ServiceNow® 数据的数据库和架构的 USAGE 权限， 以及

• 对此架构中的表或视图的 SELECT 权限

Snowflake 建议创建一个具有这些权限的专用角色，并将其授予需要访问所引入的 ServiceNow® 数据的用户。

例如，如果您将连接器配置为将 ServiceNow® 数据存储在 dest_db 数据库和 dest_schema 架构中，则可以创建名为 servicenow_data_reader_role 的角色并向该角色授予访问数据的权限。

以下示例显示如何授予这些权限：

CREATE ROLE servicenow_data_reader_role;
GRANT USAGE ON DATABASE dest_db TO ROLE servicenow_data_reader_role;
GRANT USAGE ON SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON FUTURE TABLES IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON FUTURE VIEWS IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON ALL TABLES IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;
GRANT SELECT ON ALL VIEWS IN SCHEMA dest_db.dest_schema TO ROLE servicenow_data_reader_role;

Copy

访问原始数据¶

对于您同步的每个 ServiceNow® 表，Snowflake Connector for ServiceNow®V2 会在数据库和架构中创建一个具有相同名称的新表，以用于在 Snowflake 中存储 ServiceNow® 数据。

例如，如果您将连接器配置为将 ServiceNow® 数据存储在 dest_db 数据库和 dest_schema 架构中，并且将连接器配置为同步 ServiceNow® 中的 incident 表，则连接器将创建名为 dest_db.dest_schema.incident 的表。

此表包含从 ServiceNow® 引入的原始数据。此表包含以下列：

以下是检索 dest_db.dest_schema.incident 表数据的 SELECT 语句的输出示例：

SELECT * FROM DEST_DB.DEST_SCHEMA.INCIDENT LIMIT 5;

+----------------------------------+-------------------------+-------------+--------------------------+
| SYS_ID                           | RAW:ACTIVE              |  IS_DELETED | LAST_UPDATE_DATE         |
+----------------------------------+-------------------------+-------------+--------------------------+
| caa04d36db8ba0106e9643c81396197b | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| cea045be1b03e010eac562c4bd4bcbb2 | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| caa0c9bedb8be010f9f19c41ba961934 | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| caa0c9bedb8be010f9f19c41ba961969 | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
| b9a0c53adb436410d6fa2b691396190a | {"active": "true", ...} |  FALSE      |  2021-08-24 12:59:23.932 |
+----------------------------------+-------------------------+-------------+--------------------------+

Copy

访问扁平化数据¶

对于每个包含数据的表，连接器都会根据原始数据创建两个扁平化视图。视图的名称是带有后缀 __view 和 __view_with_deleted 的表的名称。例如，对于名为 incident 的 ServiceNow® 表，连接器创建以下视图：

• dest_db.dest_schema.incident__view

• dest_db.dest_schema.incident__view_with_deleted

带有 __view 后缀的视图包含 ServiceNow® 中的记录。带有 __view_with_deleted 后缀的视图包含这些相同的记录以及从 ServiceNow® 表中删除的记录。

请注意以下事项：

• 这些视图中的列名称为大写。您不能使用小写名称来访问这些列。

• 带有时间和时间戳的列始终使用 UTC 时区保存，与 ServiceNow 实例中设置的时区无关。因此，根据 ServiceNow 实例配置的不同，其显示的值可能与 ServiceNow 实例中显示的值不同。两者的区别仅在于显示值不同，ServiceNow 和 Snowflake 中的时间戳均指向同一时间点。

• 没有空表的视图。数据出现在 ServiceNow® 表中后，视图便已创建。

• 尽管连接器处理架构更改，但连接器不会重新加载数据。

  因此，在架构发生更改的情况下，来自旧架构中的记录不会更新。

以下是从 dest_db.dest_schema.incident_view 视图检索数据的 SELECT 语句的输出示例。在此示例中，ServiceNow® 中的 incident 表具有名为 ACTIVE、APPROVAL、CATEGORY 和 ESCALATION 的列。

SELECT ACTIVE, APPROVAL, CATEGORY, ESCALATION
FROM DEST_DB.DEST_SCHEMA.INCIDENT__VIEW LIMIT 5;

+--------+----------------+------------------+------------+
| ACTIVE | APPROVAL       | CATEGORY         | ESCALATION |
+--------+----------------+------------------+------------+
| TRUE   | not requested  | software         | 0          |
| TRUE   | not requested  | Cloud Management | 0          |
| TRUE   | not requested  | software         | 0          |
| TRUE   | not requested  | network          | 0          |
| TRUE   | not requested  | database         | 0          |
+--------+----------------+------------------+------------+

Copy

查看表的事件日志¶

Snowflake Connector for ServiceNow®V2 可以跟踪对 ServiceNow® 中的记录所做的更改。此跟踪信息存储在称为事件日志的表中。

对于启用同步的每个 ServiceNow® 表，连接器会在 Snowflake 中创建一个名为 <destination_db>.<destination_schema>.<table_name>__event_log 的事件日志表。

每个事件日志表都有以下列：

事件日志反映了相应 ServiceNow® 表中数据更改的历史记录。例如，如果一条新记录插入到 ServiceNow® 中的 u_ip_port 表中，则 event_type 设置为 INSERT 事件类型的记录将添加到 Snowflake 中的 dest_db.dest_schema.u_ip_port__event_log 表中。

同样，如果在 ServiceNow® 中的表中更新或删除记录，则 event_type 设置为 UPDATE 或 DELETE 的记录将添加到 dest_db.dest_schema.u_ip_port__event_log 表中。

Snowflake 中包含原始数据(dest_db.dest_schema.table_name) 的表源自相应的事件日志表 (dest_db.dest_schema.table_name__event_log)。例如：

• 如果将 INSERT 事件的记录添加到 table_name__event_log，则连接器会将相应的记录添加到 table_name 表中。

• 如果给定 sys_id 的 UPDATE 事件添加到事件日志表中，连接器将使用新数据更新 table_name 表中 sys_id 的相应记录。

• 如果发生 DELETE 事件，则 table_name 中相应记录的 is_deleted 标志设置为 true。

获取引用字段的显示值¶

在 ServiceNow® 表中，某些字段是 引用字段 (https://docs.servicenow.com/bundle/washingtondc-platform-administration/page/administer/field-administration/concept/c_ReferenceField.html)，其中包含对其他表中记录的引用。

在下面的示例中， incident 表中的字段 opened_by 是一个引用字段，其中包含对另一个表 (sys_user) 中 sys_id <sys_id> 的记录的引用：

{
  "link": "https://testingatt1.service-now.com/api/now/table/sys_user/<sys_id>",
  "value": "<sys_id>"
}

Copy

要显示表中的引用字段，请使用以下实参调用 SHOW_REFERENCES_OF_TABLE 存储过程：

CALL SHOW_REFERENCES_OF_TABLE('<table_name>');

Copy

其中：

table_name

指定要显示其引用字段的表的名称。

此存储过程检查表的架构并返回包含以下属性的对象的 JSON 列表：

CALL CREATE_VIEW_WITH_DISPLAY_VALUES('<table_name>');

SELECT OPENED_BY, OPENED_BY__METADATA
  FROM DEST_DB.DEST_SCHEMA.INCIDENT__VIEW_WITH_REFERENCES;

+-----------+------------------------------------+
| OPENED_BY | OPENED_BY__METADATA                |
+-----------+------------------------------------+
| "JOHN"    | {                                  |
|           |   "reference_field": {             |
|           |     "display_value": "JOHN",       |
|           |     "key": "b177...",              |
|           |     "link": "https://...",         |
|           |     "reference_table": "sys_user", |
|           |     "resolved": true               |
|           |   }                                |
|           | }                                  |
+-----------+------------------------------------+