Snowflake Connector for ServiceNow® V2 版本说明¶

行为变更¶

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

新功能¶

• 现在可以使用 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

新功能¶

不适用。

错误修复¶

不适用。