Snowflake Connector for ServiceNow® V2 版本说明¶

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 修复了当响应中的标头名称与预期格式不匹配时，导致来自 ServiceNow® 的 API 响应的解析过程失败的错误。

• 修复了在表上运行经筛选的重新加载时导致连接器状态和配置导出失败的错误。

行为变更¶

不适用

新功能¶

• DELETE_TABLE 过程现在接受可选的 drop_related_objects 布尔参数。当此参数设置为 true 时，该程序将删除与表相关的所有对象，如展平视图、事件日志表和接收器表。

• 经筛选的重新加载功能现在支持检测删除内容，并且可以在 RELOAD_TABLE 过程中使用 sys_ids 参数时筛选掉这些记录。在此版本之前，经筛选的重新加载功能仅检测数据更新和插入。

错误修复¶

• 更正了运行经筛选的重新加载时 CONNECTOR_STATS 视图引入行统计信息中的错误。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 恢复了可能导致仓库消耗增加的性能优化。

行为变更¶

• 要查看重新加载的表的配置详细信息，请使用新 RELOADED_TABLES 视图而不是 CONFIGURED_TABLES 视图。这个新视图包括 CONFIGURED_TABLES 视图中表的配置值以及新列，这些新列提供有关用于表的重新加载配置和表的重新加载状态的信息。有关更多信息，请参阅 关于监控连接器。

新功能¶

• 添加了对 OAuth 客户端凭据授权流的支持。在设置 OAuth 时，我们建议您使用此流，而不是 OAuth 身份验证代码授权流。有关更多信息，请参阅 设置 OAuth。如果连接器已配置了其他 OAuth 流，然后您将其配置为使用客户端凭据授权流，则建议您执行以下任务（如果可行）：

  • 重新创建密钥和安全集成对象，以使用客户端凭据。有关说明，请参阅 创建安全集成和创建密钥对象。

  • 将连接更新到 ServiceNow 实例以使用新凭据。有关更多信息，请参阅 将连接更新到 ServiceNow® 实例。

• 向 RELOAD_TABLE 过程中添加了新的配置参数。此参数允许您重新加载表中的特定记录，而不是整个表。有关更多信息，请参阅 经筛选的重新加载。

• 在包含引用字段的视图中，带 __DISPLAY_VALUE 后缀的列包含引用字段的数据，现在显示最新数据。以前，这些列总是返回从相同表中引入的原始值的显示值。要启用此功能（包括在现有视图中），请调用 CREATE_VIEW_WITH_DISPLAY_VALUES 存储过程。有关更多信息，请参阅 创建包含引用字段的视图。

错误修复¶

• 改进了启用新表以进行引入时初始测试请求的性能。

• 改进了当返回的错误代码格式与预期格式不同时的错误处理过程。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

修复了以下问题：当视图包含已启用 fetch_display_values 的表中的数据时，展平视图中的引用列会显示不完整的数据。

行为变更¶

展开视图现在始终按字母顺序显示列。以前，这些视图有时以随机顺序显示列。

新功能¶

不适用

错误修复¶

• 修复了以下问题：当视图包含引用字段时，视图中包含的数据会在列之间移动。

• 修复了以下问题：无法正确重新创建展平视图。

• 对于已启用 fetch_display_values 的表，修复了以下问题：在引入过程停止之前，连接器仅检索表的单个页面（最多 10,000 条记录）。但是，您必须重新加载这些表才能对其应用修复，包括通过全局连接器设置启用 fetch_display_values 的表。有关如何重新加载表的说明，请参阅 重新加载表中的数据。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

修复了以下问题：调用 CONFIGURE_DISPLAY_VALUE_FETCHING 存储过程无法为表配置默认显示值，并且导致 Snowflake Connector for ServiceNow® V2 停止响应。

行为变更¶

不适用

新功能¶

• 添加了新的 CONFIGURE_DISPLAY_VALUE_FETCHING 程序。它用于设置用于处理显示值的全局默认配置。还可以使用以下 ENABLE_TABLE 程序在表级别配置显示值同步。

• 现在可以提取具有解析显示值的数据，而不仅仅是原始数据。

错误修复¶

• 修复了连接器状态导出过程。

• 改进了对 DNS 错误的处理。

• CREATE_VIEW_WITH_DISPLAY_VALUES 和 ENABLE_REFERENCED_TABLES 程序现在处理包含的列配置。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 当要导出的表具有不完整的配置时，连接器现在可以处理异常。

• 如果未创建 GET_TROUBLESHOOTING_DATA 程序，则升级过程不再失败。

• 当内部状态快照因其大小而未创建时，连接器不再出现故障。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 添加了迁移功能，以支持数据导出中的旧同步状态。

行为变更¶

• 更改了用于存储连接器内部状态的导出过程。

  除了在 __CONNECTOR_STATE_EXPORT 表中存储元数据外，数据还可分成多个带 _SFSDKEXPORT_V1 后缀的表。

新功能¶

• Snowflake Connector for ServiceNow® V2 现在支持其他区域的灾难恢复。

• 添加了以下支持：使用 ENABLE_TABLE 程序在表级别配置删除同步。

  有关使用 ENABLE_TABLE 程序的更多信息，请参阅 使用自定义配置启用单个表。

错误修复¶

• 现在，ServiceNow API 中的异常响应可以在程序（例如 CHECK_ROW_COUNT）中正确处理。

行为变更¶

• 现在，新安装的版本必须共享事件。

新功能¶

• 现在可以使用 RESET_PAGE_SIZE 程序，而不是使用默认连接器的值。

• 如果连接器的默认页面大小设置为无效值，则连接器将使用建议值 10,000。

错误修复¶

• 若工作节点任务在发现初始表页大小时达到 API 超时，引入就会失败。

行为变更¶

不适用

新功能¶

• 添加建立 http 连接的超时。

错误修复¶

不适用

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 如果 Snowflake 没有收到引入表上最新记录的时间戳，增量更新将不再失败。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 当事件日志表为空时，增量更新不再失败。

• 当从源更新记录期间由于存在过期行而导致提取的批次为空时，增量引入不再失败。

行为变更¶

修改了增量更新期间应用的 ServiceNow API 请求排序规则，以消除从多个读取副本读取数据时的数据丢失。

新功能¶

不适用

错误修复¶

当 ServiceNow 实例无法访问时，页面大小不再减小。

行为变更¶

不适用

新功能¶

不适用

错误修复¶

• 修复了 UPDATE_CONNECTION_CONFIGURATION 程序中的配置验证。

行为变更¶

• 在更新和删除开始时添加对最新时间戳的请求。

新功能¶

• UPDATE_CONNECTION_CONFIGURATION 程序已添加。此程序允许更改连接器使用的外部访问集成和密钥对象。

• 连接器 HTTP 请求中的用户代理标头现在设置为 snowflake-connector-for-service-now。

错误修复¶

• 从容应对 HTTP 客户端超时错误。

  出现此类错误时，缩小页面大小。

• ServiceNow® 和 Snowflake 的时间差异不再导致数据丢失。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 针对特定用户的迁移脚本修复。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 在 row_filter 和 data_range_start_time 都设置好的情况下修复 RELOAD_TABLE 程序。以前没有正确清理行筛选同步状态。

• 当连接器无法克服与身份验证相关的错误时，改进数据引入过程中的错误处理。在这种情况下，连接器现在应该能够更早地检测到错误并停止引入过程。

行为变更¶

不适用。

新功能¶

• ENABLE_TABLE 程序中的 row_filter 字段现在可接受筛选表达式中任意数量的空白字符，而不是只允许表达式元素之间有一个空格。

  有关更多信息，请参阅 使用自定义配置启用单个表。

错误修复¶

• 现在在重新加载表期间，行筛选和列筛选都已考虑在内。

• 行筛选器现在可按预期用于无 sys_updated_on 列的表

行为变更¶

不适用。

新功能¶

现在可以在用户拥有的任务中调用程序 CHECK_ROW_COUNT、ENABLE_TABLE （无自定义配置参数）和 SHOW_REFERENCES_OF_TABLE。

错误修复¶

不适用。

行为变更¶

不适用。

新功能¶

现在可以进行行筛选。 行筛选支持根据对表列进行评估的条件筛选所引入的表行。使用 ENABLE_TABLE 程序设置行筛选条件。

有关更多信息，请参阅 使用为 ServiceNow® 数据设置数据引入 中 的自定义配置启用单个表。

错误修复¶

提高先前版本迁移脚本的性能。

行为变更¶

不适用。

新功能¶

不适用

错误修复¶

提高先前版本迁移脚本的性能。

行为变更¶

不适用。

新功能¶

在开始引入表时添加一种获取表架构的默认方法。这应该有助于解决连接器因第一条引入行遇到 ACLs 而无法开始引入表的问题。

错误修复¶

• 修复 RUN_HEALTHCHECK 在特定情况下有时无法发送连接器状态的问题。

行为变更¶

不适用。

新功能¶

变更用于提取表架构的端点。从版本 5.4.0 及更高版本开始，使用 CREATE_VIEW_WITH_DISPLAY_VALUES、SHOW_REFERENCES_OF_TABLE 和 ENABLE_TABLE``（使用列筛选时）程序时，不再需要 ServiceNow® 中的 ``ADMIN 角色。

错误修复¶

从版本 5.4.0 及更高版本开始，新事件日志表 DELETE 事件包括 RAW 列，该值被设置为来自最新更新事件而不是第一个插入事件。先前存在的事件日志表事件保持不变。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

修复了对传递给 FINALIZE_CONNECTOR_CONFIGURATION 程序的对象中 journal_table 属性空值的处理。现在也可以跳过 journal_table 参数。

行为变更¶

不适用。

新功能¶

为 FINALIZE_CONNECTOR_CONFIGURATION 添加可选的 table_name 和 sys_id 实参，用于协助日志表验证。

错误修复¶

• 改进 SET_CONNECTION_CONFIGURATION 中的 URL 验证，支持自定义 ServiceNow® 域。

行为变更¶

不适用。

新功能¶

CHECK_ROW_COUNT 过程中的 max_sys_created_on 实参现在默认为 NULL。

错误修复¶

• 如果配置尚未成功完成，请不要启动运行状况检查报告。

• 修复 SHOW_REFERENCES_OF_TABLE，以在返回值中包含给定表的自引用。

• 修复 CREATE_VIEW_WITH_DISPLAY_VALUES，以处理表引用自身时的情况。

行为变更¶

• 向 ServiceNow® 发出 API 调用的外部函数被替换为外部访问。

• 许多过程的签名和行为均已更改。责任划分可参见下表：

先前的过程	新过程
CONFIGURE_CONNECTOR	几个专门的过程 CONFIGURE_*。
CONFIGURE_WAREHOUSE	UPDATE_WAREHOUSE
STOP_CONNECTOR	PAUSE_CONNECTOR
START_CONNECTOR	在使用工作表时，安装应用程序的几个过程。
PREFILL_CONFIG_TABLE	GET_AVAILABLE_TABLES
ENABLE_TABLE_WITH_COLUMNS	ENABLE_TABLE
ENABLE_TABLES(VARCHAR, BOOLEAN)	ENABLE_TABLES(ARRAY), DISABLE_TABLES(ARRAY)
TEST_SN_CONNECTION	TEST_CONNECTION
CHECK_SN_ROW_COUNT	CHECK_ROW_COUNT
GET_STATUS
GET_CONNECTION_STATUS
GET_VERSION
RUN_UPGRADE

• 过程返回一个具有 response_code 属性的对象。具有可选错误原因的过程结果直接显示在响应中。

• 多个视图的签名和行为已更改。责任划分可参见下表：

  先前的视图	新视图
  ENABLED_TABLES	CONFIGURED_TABLES、TABLES_STATE
  CONNECTOR_RUNS_STATE	包含在 GET_TROUBLESHOOTING_DATA 过程中。
  CONNECTOR_STATS	AGGREGATED_CONNECTOR_STATS
  	SYNC_STATUS

新功能¶

不适用。

错误修复¶

不适用。