连接器故障排除¶

身份验证步骤错误¶

在安装向导中 连接到 ServiceNow 或手动运行 SET_CONNECTION_CONFIGURATION 过程时，可能会出现问题。如果在此步骤中遇到错误，请确保用于安装连接器的用户有权访问 sys_db_object 表。

与 ACL 问题相关的错误状态码，可能出现在 SET_CONNECTION_CONFIGURATION 过程返回的 JSON 对象中，具体如下：

• REQUEST_FAILED

您可以执行以下类似于连接器的查询来验证访问权限。在请求未返回预期结果之前，将无法安装连接器。例如，如果您使用 curl 发送 HTTP 请求：

# checking access to the sys_db_object table
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_db_object?sysparm_limit=1"

其中：

servicenow_instance

指定 ServiceNow® 实例的名称。

username 和 password

为 ServiceNow® 实例指定凭据。

响应示例：

• 至少返回了一些字段 - 用户具有访问表所需的权限。

• 响应为空 - 用户有权访问表，但不能访问已处理的记录。它可能会在以后导致问题。

• 响应包含错误 - 用户没有访问表所需的权限。

验证源步骤错误¶

在安装向导中 验证源 或手动运行 FINALIZE_CONNECTOR_CONFIGURATION 过程时，可能会出现问题。如果在此步骤中遇到错误，请确保用于安装连接器的用户具有访问元数据表所需的权限。

与 ACL 问题相关的错误状态码，可能出现在 FINALIZE_CONNECTOR_CONFIGURATION 过程返回的 JSON 对象中，具体如下：

• METADATA_TABLE_ACCESS_VALIDATION_ERROR

• JOURNAL_TABLE_ACCESS_VALIDATION_ERROR

您可以执行以下类似于连接器的查询来验证访问权限。在请求未返回预期结果之前，将无法安装连接器。例如，如果您使用 curl 发送 HTTP 请求：

# checking access to the sys_db_object table
# expected fields in the result object: sys_id, super_class, name
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_db_object?sysparm_fields=sys_id,super_class,name&sysparm_limit=1&sysparm_query=name=sys_db_object"

# checking access to the sys_dictionary table
# expected fields in the result object: sys_id, name, element, internal_type
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_dictionary?sysparm_fields=sys_id,name,element,internal_type&sysparm_limit=1&sysparm_query=name=sys_dictionary"

# checking access to the sys_glide_object table
# expected fields in the result object: sys_id, name, scalar_type
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_glide_object?sysparm_fields=sys_id,name,scalar_type&sysparm_limit=1&sysparm_query=name=datetime"

# checking access to the sys_table_rotation table
# expected fields in the result object: sys_id, name
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/sys_table_rotation?sysparm_fields=sys_id,name&sysparm_limit=1&sysparm_query=name=syslog"

# (optional) - check only if deletions auditing is going to be used
# checking access to the journal table
# if known, "&sysparm_query=tablename=<table_name>" or "&sysparm_query=documentkey=<sys_id>" can be appended to the request
# expected fields in the result object: sys_id, sys_created_on, documentkey, tablename
curl -u '<username>:<password>' "https://<servicenow_instance>.service-now.com/api/now/table/<journal_table>?sysparm_fields=sys_id,sys_created_on,documentkey,tablename&sysparm_limit=1"

其中：

servicenow_instance

指定 ServiceNow® 实例的名称。

username 和 password

为 ServiceNow® 实例指定凭据。

journal_table

指定 ServiceNow® 用于删除审计的表的名称。通常其值为 sys_audit_delete。

响应示例：

• 响应中存在所有预期字段 - 用户具有必要的权限。

• 缺少某些预期字段 - 用户没有对所有列的必要权限。

• 响应为空 - 用户没有对所有行的必要权限。

• 响应包含错误 - 用户没有对表的必要权限。

获取故障排除数据¶

要获取故障排除数据，请调用 GET_TROUBLESHOOTING_DATA 存储过程：

CALL GET_TROUBLESHOOTING_DATA(<from_timestamp>, <to_timestamp>);

其中：

from_timestamp

指定应提取数据的日期范围起始点（UTC 时区）。

to_timestamp

指定应提取数据的日期范围结束点（UTC 时区）。

此存储过程会以表格格式返回以下数据：

• 配置信息

• 连接器遇到的错误

• 引入历史记录

以下示例展示了如何调用此存储过程：

CALL GET_TROUBLESHOOTING_DATA('2024-02-05 10:00:00', '2024-02-10 22:30:00');

您可以将返回的数据以 CSV 格式保存，并发送给 Snowflake 支持部门。

恢复连接器仓库¶

如果连接器失去对其仓库的访问权限，请通过调用 UPDATE_WAREHOUSE 存储过程来配置新仓库。

恢复 ServiceNow® 数据的数据库和架构¶

如果 ServiceNow® 数据的数据库或架构 被删除，则唯一的恢复方法是运行 UNDROP 命令。如果此命令不可用，则您必须重新安装连接器并再次引入 ServiceNow® 数据。

如果 包含 ServiceNow® 数据的视图 被删除，它应该会在下次负责创建它们的后台任务运行时自动重新创建。

如果包含 ServiceNow® 数据的其中一个表（事件日志 或 原始数据 表）被删除，您无法使用 UNDROP TABLE 命令来恢复它，请执行以下操作来开始再次引入 ServiceNow 表：

• 确保为此 ServiceNow® 表删除事件日志和原始数据表。

• 禁用 ServiceNow® 表。

• 使用 DELETE_TABLE 过程。

• 启用 ServiceNow® 表。

恢复连接器的通知集成¶

如果连接器失去通知集成对象的访问权限，请再次执行 配置警报 过程，并根据需要重新创建通知集成对象。

如果电子邮件通知是通过 Snowsight 配置的，那么您只需禁用并重新启用它们，即可恢复必要的外部对象。

检查 Snowflake 中是否存在列元数据¶

要检查列元数据是否存在于 Snowflake 的 sys_dictionary 表上，请执行以下查询：

SELECT * FROM <dest_db>.<dest_schema>.sys_dictionary__view WHERE name = '<table_name>' AND element = '<column_name>';

如果您正在调查的表有父表（继承自 ServiceNow®），并且您正在查找的列已添加到父表中，则应改用父表名称。

要列出您感兴趣的表从中继承的所有表，请执行以下查询：

SELECT
    sys_id,
    name,
    PARSE_JSON(super_class):value::string AS super_class_sys_id
FROM <dest_db>.<dest_schema>.sys_db_object__view
START WITH name = '<table_name>'
CONNECT BY sys_id = PRIOR super_class_sys_id;

如果返回行，则表示该列的元数据已正确引入到 Snowflake 中，但视图尚未刷新。检查状态以及是否：

• 视图最近刷新，但列仍不存在，请联系支持人员。

• 视图尚未刷新，请等待下一个引入计划。

如果返回空结果，则表示连接器尚未引入此列的元数据。您需要在 ServiceNow® 端验证记录是否对连接器可见，以及时间戳是否正确。

查看刷新状态¶

要验证给定表的视图上次刷新时间以及操作是否成功，请执行以下查询：

SELECT flattened_views_status, flattened_views_last_updated FROM tables_state WHERE table_name = '<table_name>';

如果上次刷新失败，您可能需要查询事件表并查找连接器报告的错误。

查看 ServiceNow® 列元数据可用性¶

扁平化视图中缺少列的原因可能是连接器无法引入列元数据。这可能是因为 ACLs 阻止 sys_dictionary 表中的行被表 API 返回。另一个可能的原因是 sys_updated_on 列中的时间戳值过期。也可能是列/表定义是从不同的 ServiceNow® 实例导入的。要确定连接器是否可以访问列元数据，请执行 GET 请求到以下端点：

https://<servicenow_instance>.service-now.com/api/now/table/sys_dictionary?sysparm_query=name=<table_name>^element=<column_name>

如果返回空结果，则连接器无法访问该列。该列可能受 ACL 保护或不存在。

如果返回了列定义，请检查 sys_updated_on 字段的值。确认日期与列添加到表中的预期时间匹配。如果它是从另一个实例导入的，则可能会显示列创建时的时间点。连接器中的 CDC （增量更新）机制可能不会注意到添加了日期为过去的记录。在这种情况下，触发 sys_dictionary 表的重新加载。