Snowflake Connector for ServiceNow® 版本说明

备注

Snowflake Connector For ServiceNow® 版本 1 已被弃用,被 V2 连接器取而代之。有关 V2 版本说明,请参阅 Snowflake Connector for ServiceNow® V2 版本说明。 有关 V2 的更多信息,请参阅 Snowflake Connector for ServiceNow®

本主题提供 Snowflake Connector for ServiceNow® 的版本说明。有关其他信息,请参阅 Snowflake Connector for ServiceNow

版本 4.21.1(2024 年 3 月 14 日)

行为变更

不适用。

新功能

不适用。

错误修复

  • 修复 MERGE_INTO_SINK_TABLE 任务在特定连接器状态和空事件日志表上失败的问题。

版本 4.21.0(2024 年 3 月 8 日)

行为变更

不适用。

新功能

  • 添加新过程 EXPORT_CONNECTOR_STATE(),用于导出连接器的状态和配置,以便在 GA 版本的应用程序中导入。

错误修复

  • 在创建展平视图的任务中添加显式超时。

版本 4.20.1(2023 年 12 月 20 日)

行为变更

不适用。

新功能

不适用。

错误修复

  • 修正了在无必要权限的情况下重复使用目标数据库的错误。如果连接器重复使用了目标数据库,例如重新安装了连接器,则即使后续授予了表的所有权,如果不具备对目标数据库中的表的所有权,也可能导致对重复使用的表进行不正确的处理。

  • 如果源表为空,CONNECTOR_STATS 视图会将已完成的引入运行正确显示为 DONE。

版本 4.20.0(2023 年 11 月 30 日)

行为变更

  • 对于增量更新,在成功运行的情况下,只有一个 DONE 引入状态。

  • 添加了跳过引入时的 SKIPPED 引入状态。

  • 现在,EVENT_LOGSYS_UPDATED_ON 列将填充来自 ServiceNow 的原始日期,而非根据 TIMESTAMP_NTZ_OUTPUT_FORMAT 账户参数进行格式化。

新功能

  • 新增 CONFIGURE_TABLES_RANGE_START 过程,允许设置数据范围开始时间时间戳。这会限制初始引入或重新加载期间的数据引入。

  • ENABLED_TABLES 视图将表的数据范围开始时间显示为 UTC 时间戳。

错误修复

  • 修复了设置 TIMESTAMP_OUTPUT_FORMATTIMESTAMP_NTZ_OUTPUT_FORMATTIMESTAMP_TZ_OUTPUT_FORMAT 账户参数时,无法以 AUTO 格式对其进行解析的各种错误。

  • 修复了将 TIMESTAMP_INPUT_FORMAT 账户参数设置为默认的 AUTO 值以外的值时,出现的各种错误。

  • 修复了 CREATE_VIEW_WITH_DISPLAY_VALUES 过程,以正确处理连接器不可见的引用,不会将其包含在创建的视图之中。

版本 4.19.0(2023 年 11 月 6 日)

行为变更

  • 仅当获取的数据已合并到同步表中时, DONE 引入状态才会显示在 CONNECTOR_RUNS_STATESENABLED_TABLESTABLES_STATE 之中。

  • 在日志表中使用 sys_created_on 取代 sys_updated_on。在升级到最新版本的连接器之前,请确保您有权访问 sys_audit_delete 表中的 sys_created_on 列。如果遇到任何问题,请联系支持部门。

新功能

不适用。

错误修复

  • 如果引入运行正在运行,则在 CONNECTOR_STATS 视图的 RUN_END_TIME 列中显示 NULL,而非 SYSDATE()

  • 在恢复引入时,不会不必要地启动初始加载。

版本 4.18.0(2023 年 10 月 19 日)

行为变更

  • 移除了 CONNECTOR_STATS 视图中的 TOTAL_ROWS 列。

  • 移除了 WORKER_STATE 视图中的 ROW_COUNT 列。

  • 对于异步任务,将事件日志中的更新和删除移动并合并到同步表中,从而提高数据引入速度。在更改之前,引入循环会提取数据,将其插入事件日志,并将更新合并到同步表中。合并操作通常较为漫长,会造成数据引入的吞吐量大幅度下降。异步合并会将长时间的操作移动到后台,从而提高吞吐量。性能提升可能会受到 ServiceNow 实例性能的限制。

  • 现在,异步合并会造成引入的数据在同步表中延后显示。数据在事件日志中立即可用,但同步表要在异步合并完成后才会同步。如果在数据引入期间,连接器停止,则同步表中的数据可能不完整。启动连接器可以恢复引入并同步数据。

  • CONNECTOR_RUNS_STATESENABLED_TABLES 视图中的 DONE 引入状态现在代表数据在事件日志表中可用;但不一定在同步表中可用。由于异步合并,同步表可能需要一些时间才能同步。在将来的版本中,此行为可能会发生更改。

新功能

不适用。

错误修复

  • 修复了 CREATE_VIEW_WITH_DISPLAY_VALUES 过程,以正确处理将 SQL 关键字作为名称的列;例如,名为 GROUP 或 LIMIT 的列。

  • 修复了 CREATE_VIEW_WITH_DISPLAY_VALUES 过程,以正确处理连接器不可见的引用,不会将其包含在创建的视图之中。

版本 4.17.1(2023 年 10 月 9 日)

行为变更

不适用。

新功能

不适用。

错误修复

  • 新增在配置表的引入计划时,对受支持 cron 值的验证。

  • 降低了搜索待引入表的查询的复杂性。

  • 修复了一个问题,确保在某些行处于隐藏状态时,对元数据表的访问验证不会失败。

  • 修复了时间戳格式设置问题,确保即使更改了账户上的默认时间戳格式,时间戳也能正常发挥作用。

版本 4.17.0(2023 年 9 月 27 日)

行为变更

不适用。

新功能

  • 现在,数据的初始加载使用 INSERT 命令实现,而非 MERGE 命令。

错误修复

  • 修复了对非 UTC 时区中的 ServiceNow 时间戳处理不正确的问题。

  • 减少了将工作节点分配给表时的锁定超时次数。

版本 4.16.0(2023 年 9 月 5 日)

行为变更

  • 具有自定义计划的表在启用后不会立即引入。相反,初始加载将在计划的引入时间执行。

新功能

  • 新增内部连接器数据垃圾回收机制,可优化连接器内部存储空间的使用。

错误修复

  • 修复了 CREATE_VIEW_WITH_DISPLAY_VALUES 过程的一个问题,使其在创建视图时不会引用非 VARIANT 列。

  • 修复了一个问题,使得 CONFIGURE_WAREHOUSE 过程在处于 RELOADING_DISABLED 状态时不会恢复重新加载任务。

版本 4.15.0(2023 年 8 月 25 日)

行为变更

  • TABLES_STATE 视图中的 SCHEDULE_INTERVAL 列和 data_ingestion_schedule 键的值现为 cron 表达式。

  • TABLES_STATE 视图中删除了 CURRENT_EPOCH 列。

新功能

  • 添加了 CONFIGURE_TABLES_SCHEDULE 过程,允许设置间隔时间和自定义计划。

错误修复

  • 修复了 CREATE_VIEW_WITH_DISPLAY_VALUES 过程的问题,允许在多个引用指向同一表时启用显示值视图。

  • 减少了死锁的数量,并消除了将工作节点分配到表时的重复分配。

  • 修复了 CONNECTOR_STATS 的问题,可在 UPDATEDROWS 列中显示正确计数。

版本 4.14.0(2023 年 8 月 9 日)

行为变更

  • TABLES_STATE 视图中的 SCHEDULE_INTERVAL 列类型更改为 VARCHAR。

新功能

不适用。

错误修复

  • 修复了在无权访问 sys_table_rotation 或日志表时的日志问题,以提供更有意义的消息。

  • 修复了 PREFILL_CONFIG_TABLE 过程的问题,可筛选出表名为空或为 null 的行。

  • 修复了目标架构验证,可为架构中超过 10000 个列启用表。

  • 修复了 SHOW_REFERENCES_OF_TABLE 过程中引用空 display_field 或未跳过 reference_table 属性的问题。

版本 4.13.0(2023 年 7 月 17 日)

行为变更

不适用。

新功能

  • 添加了 CREATE_VIEW_WITH_DISPLAY_VALUES 过程,用于创建具有显示值的视图。新创建的视图类似于展平表视图,但引用的列将替换为值。

  • 添加了 DELETE_TABLE 过程,允许从配置中移除表以及引入历史记录。

错误修复

不适用。

版本 4.12.0(2023 年 7 月 5 日)

行为变更

  • 现在,处于 RELOADING_CANCELLED 状态的表在 ENABLED_TABLES 视图中会被视为已启用。

新功能

不适用。

错误修复

  • 修复了重新加载任务的问题。现在,只有 ENABLED_TABLESDISABLE_TABLES 过程实参中所提供的表的重新加载任务才会恢复或暂停。最后一个表被禁用时,元数据表的重新加载任务将暂停,并在启用第一个表时恢复。

  • 修复了 ENABLE_REFERENCED_TABLES 不引发 TypeError: Cannot read properties of null 异常的问题。

  • 修复了版本 4.11.0 的升级迁移错误问题。

  • 修复了 PREFILL_CONFIG_TABLE 过程的问题,以处理来自 ServiceNow 的不正确响应。

  • 修复了 START_CONNECTOR 过程的问题,在所有表均已禁用时不恢复任务。

版本 4.11.0(2023 年 6 月 16 日)

行为变更

  • 不再为未引入元数据的表创建空视图。

  • 截断和加载策略会填充目标表以及 sys_id 事件日志表中的 sys_idlast_update_dateis_deleted 列。

新功能

  • ENABLED_TABLES 视图添加了 FLATTENED_VIEWS_STATUS 和 FLATTENED_VIEWS_LAST_UPDATED 列。

错误修复

  • 修复了 CHECK_RECORD_HISTORY 过程的问题,不使用未记录的查询参数按 sys_id 筛选行。

版本 4.10.0(2023 年 6 月 7 日)

行为变更

不适用。

新功能

  • 在连接器启动时,将验证对必需元数据表中必要字段的访问权限。

  • 选择用于引入特定表的列发生更改时,将重新创建展平视图。

错误修复

  • 修复了 CHECK_RECORD_HISTORY 的问题,不接受 sys_id 空字符串。

版本 4.9.0(2023 年 5 月 31 日)

行为变更

不适用。

新功能

  • 在 FORBIDDEN 状态下,为 GET_CONNECTION_STATUS 的错误响应添加了 tableName 属性。

  • 添加了 ENABLE_TABLES_WITH_COLUMNS 过程,允许选择要引入的表列。展平视图仅显示配置的列。

  • 添加了 ENABLE_TABLESDISABLE_TABLES 过程,可接受 ARRAY 类型的实参。先前接受 BOOLEAN 作为第二个参数的 ENABLE_TABLES 过程现已弃用。

  • ENABLED_TABLES 视图显示所包含列的列表。

错误修复

  • 修复了 CHECK_RECORD_HISTORY 的问题,可在审计表中搜索特定 sys_id 时使用正确的查询。

版本 4.8.0(2023 年 5 月 9 日)

行为变更

不适用。

新功能

  • 无法再使用 CONFIGURE_CONNECTOR_TABLES 过程更改元数据表的配置。

  • 添加了 SHOW_REFERENCES_OF_TABLE 过程,可返回给定表的所有引用。

  • 改进了视图创建日志记录。

错误修复

  • 修复了 TOP_CONNECTOR 过程的问题,在调用此过程时返回正确消息而非 null。

  • 修复了在收到防火墙错误时不缩小页面大小、不重试请求的问题。

  • 修复了问题,以改进对无效 ServiceNow 实例名称的处理。

版本 4.7.0(2023 年 4 月 7 日)

行为变更

不适用。

新功能

  • 修改了元数据表的计划,以使用所启用的最低表计划。

错误修复

不适用。

版本 4.6.0(2023 年 3 月 31 日)

行为变更

  • 连接器不再向自身授予在目标架构中创建的表的访问权限。相反,连接器会使用表和视图所有权来访问目标架构中的表。

新功能

  • ENABLED_TABLES 视图添加了 PAGE_SIZE 列。

  • 修改了 START_CONNECTOR 存储过程,以便在 ServiceNow 请求失败时返回更详细的错误。

  • 修改了 GET_STATUS 存储过程,以返回电子邮件通知失败的消息。

  • 添加了每月提醒,以刷新用于电子邮件通知的 OAuth 令牌。

错误修复

  • 修复了允许工作节点在同时启动时每分钟选择多个表的问题。

  • 修复了在初始引入表期间,创建目标和事件日志表之前禁止重新加载表的问题。

  • 修复了允许连接器使用托管目标架构的问题。

  • 修复了即使未配置日志表,旧行也会在轮换表中标记为已删除的问题。

版本 4.5.0(2023 年 3 月 16 日)

行为变更

不适用。

新功能

错误修复

不适用。

语言: 中文