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_LOG
表SYS_UPDATED_ON
列将填充来自 ServiceNow 的原始日期,而非根据TIMESTAMP_NTZ_OUTPUT_FORMAT
账户参数进行格式化。
新功能¶
新增
CONFIGURE_TABLES_RANGE_START
过程,允许设置数据范围开始时间时间戳。这会限制初始引入或重新加载期间的数据引入。ENABLED_TABLES
视图将表的数据范围开始时间显示为 UTC 时间戳。
错误修复¶
修复了设置
TIMESTAMP_OUTPUT_FORMAT
、TIMESTAMP_NTZ_OUTPUT_FORMAT
和TIMESTAMP_TZ_OUTPUT_FORMAT
账户参数时,无法以AUTO
格式对其进行解析的各种错误。修复了将
TIMESTAMP_INPUT_FORMAT
账户参数设置为默认的AUTO
值以外的值时,出现的各种错误。修复了
CREATE_VIEW_WITH_DISPLAY_VALUES
过程,以正确处理连接器不可见的引用,不会将其包含在创建的视图之中。
版本 4.19.0(2023 年 11 月 6 日)¶
行为变更¶
仅当获取的数据已合并到同步表中时,
DONE
引入状态才会显示在CONNECTOR_RUNS_STATES
、ENABLED_TABLES
和TABLES_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_STATES
和ENABLED_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_TABLES
和DISABLE_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_id
、last_update_date
和is_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_TABLES
和DISABLE_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 日)¶
行为变更¶
不适用。
新功能¶
此版本是连接器的第一个公开发布版本。有关更多信息,请参阅 关于 Snowflake Connector for ServiceNow。
错误修复¶
不适用。