Snowflake Connector for ServiceNow® V2 版本说明¶
本主题提供 Snowflake Connector for ServiceNow® V2 的版本说明。有关其他信息,请参阅 Snowflake Connector for ServiceNow。
Version 5.25.2 (September 12, 2025)¶
行为变更¶
不适用
新功能¶
Improved logging of HTML responses.
Improved error handling for External Access.
错误修复¶
不适用
Version 5.25.1 (September 10, 2025)¶
行为变更¶
不适用
新功能¶
通过在必要时减小页面大小,改进了数据解压缩期间对大响应大小的处理。
错误修复¶
不适用
Version 5.25.0 (September 5, 2025)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了导致在状态导入期间错误创建架构表的问题。
修复了筛选重新加载模式下的以下问题:某些状态事件可能会以错误的顺序保存,从而导致错过更新。
Improved handling of large responses from ServiceNow.
添加了 ServiceNow 响应属性的更详细日志记录。
版本 5.24.0(2025 年 6 月 23 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了连接器全局配置为提取显示值时,在重新加载期间可能导致元数据表引入错误的问题。由于此问题,没有为某些表创建展平视图。如果出现此问题,则必须重新加载以下元数据表:
sys_dictionary
sys_db_object
sys_glide_object
版本 5.23.0(2024 年 6 月 12 日)¶
行为变更¶
对于
sys_created_on
或sys_updated_on
列中值为空的记录,仅当记录自上次引入以来发生更改时,连接器才会插入更新事件。以前,无论记录是否更改,连接器都会在每个引入周期向事件日志表中插入更新事件。这种行为可能导致事件日志表无限增长,即使表中未发现任何更改也不例外。
新功能¶
不适用
错误修复¶
增加了连接器在筛选引入期间尝试的页面大小范围。在提取数据时,连接器现在应该更能抵御来自 ServiceNow® API 的超时错误。
修复了内部清理任务,以保留执行引入所需的内部连接器信息。以前,移除此信息时,可能会导致引入失败。
修复了创建展平视图时出现的错误。此错误是由内部连接器表中缺少一列引起的。
版本 5.22.3(2025 年 5 月 26 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了重新加载表时页面大小保持不变的问题。
版本 5.22.1(2025 年 4 月 28 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了对字符串值使用行筛选表达式时可能导致连接器状态导出失败的问题。
版本 5.22.0(2025 年 4 月 24 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了可能导致 HTTP 响应解析失败的问题。在某些情况下,此问题可能导致连接器无法从 ServiceNow® 引入数据。
版本 5.21.0(2024 年 4 月 15 日)¶
行为变更¶
不适用
新功能¶
错误修复¶
并行引入多个表时,连接器更稳定,性能更高。
版本 5.20.0(2024 年 4 月 8 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了导致连接器状态导出失败的错误。
版本 5.19.1(2025 年 3 月 25 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了当响应中的标头名称与预期格式不匹配时,导致来自 ServiceNow® 的 API 响应的解析过程失败的错误。
修复了在表上运行经筛选的重新加载时导致连接器状态和配置导出失败的错误。
版本 5.19.0(2025 年 3 月 20 日)¶
行为变更¶
不适用
新功能¶
DELETE_TABLE
过程现在接受可选的drop_related_objects
布尔参数。当此参数设置为true
时,该程序将删除与表相关的所有对象,如展平视图、事件日志表和接收器表。经筛选的重新加载功能现在支持检测删除内容,并且可以在
RELOAD_TABLE
过程中使用sys_ids
参数时筛选掉这些记录。在此版本之前,经筛选的重新加载功能仅检测数据更新和插入。
错误修复¶
更正了运行经筛选的重新加载时
CONNECTOR_STATS
视图引入行统计信息中的错误。
版本 5.18.1(2025 年 3 月 10 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
恢复了可能导致仓库消耗增加的性能优化。
版本 5.18.0(2025 年 2 月 28 日)¶
行为变更¶
要查看重新加载的表的配置详细信息,请使用新
RELOADED_TABLES
视图而不是CONFIGURED_TABLES
视图。这个新视图包括CONFIGURED_TABLES
视图中表的配置值以及新列,这些新列提供有关用于表的重新加载配置和表的重新加载状态的信息。有关更多信息,请参阅 关于监控连接器。
新功能¶
添加了对 OAuth 客户端凭据授权流的支持。在设置 OAuth 时,我们建议您使用此流,而不是 OAuth 身份验证代码授权流。有关更多信息,请参阅 设置 OAuth。如果连接器已配置了其他 OAuth 流,然后您将其配置为使用客户端凭据授权流,则建议您执行以下任务(如果可行):
重新创建密钥和安全集成对象,以使用客户端凭据。有关说明,请参阅 创建安全集成和创建密钥对象。
将连接更新到 ServiceNow 实例以使用新凭据。有关更多信息,请参阅 将连接更新到 ServiceNow® 实例。
向
RELOAD_TABLE
过程中添加了新的配置参数。此参数允许您重新加载表中的特定记录,而不是整个表。有关更多信息,请参阅 经筛选的重新加载。在包含引用字段的视图中,带
__DISPLAY_VALUE
后缀的列包含引用字段的数据,现在显示最新数据。以前,这些列总是返回从相同表中引入的原始值的显示值。要启用此功能(包括在现有视图中),请调用CREATE_VIEW_WITH_DISPLAY_VALUES
存储过程。有关更多信息,请参阅 创建包含引用字段的视图。
错误修复¶
改进了启用新表以进行引入时初始测试请求的性能。
改进了当返回的错误代码格式与预期格式不同时的错误处理过程。
版本 5.17.1(2025 年 2 月 7 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了以下问题:当视图包含已启用 fetch_display_values
的表中的数据时,展平视图中的引用列会显示不完整的数据。
版本 5.17.0(2025 年 1 月 31 日)¶
行为变更¶
展开视图现在始终按字母顺序显示列。以前,这些视图有时以随机顺序显示列。
新功能¶
不适用
错误修复¶
修复了以下问题:当视图包含引用字段时,视图中包含的数据会在列之间移动。
修复了以下问题:无法正确重新创建展平视图。
对于已启用
fetch_display_values
的表,修复了以下问题:在引入过程停止之前,连接器仅检索表的单个页面(最多 10,000 条记录)。但是,您必须重新加载这些表才能对其应用修复,包括通过全局连接器设置启用fetch_display_values
的表。有关如何重新加载表的说明,请参阅 重新加载表中的数据。
版本 5.16.1(2025 年 1 月 24 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了以下问题:调用 CONFIGURE_DISPLAY_VALUE_FETCHING
存储过程无法为表配置默认显示值,并且导致 Snowflake Connector for ServiceNow® V2 停止响应。
版本 5.16.0(2025 年 1 月 15 日)¶
行为变更¶
不适用
新功能¶
添加了新的
CONFIGURE_DISPLAY_VALUE_FETCHING
程序。它用于设置用于处理显示值的全局默认配置。还可以使用以下ENABLE_TABLE
程序在表级别配置显示值同步。现在可以提取具有解析显示值的数据,而不仅仅是原始数据。
错误修复¶
修复了连接器状态导出过程。
改进了对 DNS 错误的处理。
CREATE_VIEW_WITH_DISPLAY_VALUES
和ENABLE_REFERENCED_TABLES
程序现在处理包含的列配置。
版本 5.15.2(2025 年 1 月 7 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
当要导出的表具有不完整的配置时,连接器现在可以处理异常。
如果未创建
GET_TROUBLESHOOTING_DATA
程序,则升级过程不再失败。当内部状态快照因其大小而未创建时,连接器不再出现故障。
版本 5.15.1(2024 年 12 月 6 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
添加了迁移功能,以支持数据导出中的旧同步状态。
版本 5.15.0(2024 年 12 月 3 日)¶
行为变更¶
更改了用于存储连接器内部状态的导出过程。
除了在
__CONNECTOR_STATE_EXPORT
表中存储元数据外,数据还可分成多个带_SFSDKEXPORT_V1
后缀的表。
新功能¶
Snowflake Connector for ServiceNow® V2 现在支持其他区域的灾难恢复。
添加了以下支持:使用
ENABLE_TABLE
程序在表级别配置删除同步。有关使用
ENABLE_TABLE
程序的更多信息,请参阅 使用自定义配置启用单个表。
错误修复¶
现在,ServiceNow API 中的异常响应可以在程序(例如
CHECK_ROW_COUNT
)中正确处理。
版本 5.14(2024 年 11 月 18 日)¶
行为变更¶
现在,新安装的版本必须共享事件。
新功能¶
现在可以使用
RESET_PAGE_SIZE
程序,而不是使用默认连接器的值。如果连接器的默认页面大小设置为无效值,则连接器将使用建议值 10,000。
错误修复¶
若工作节点任务在发现初始表页大小时达到 API 超时,引入就会失败。
版本 5.13(2024 年 10 月 29 日)¶
行为变更¶
不适用
新功能¶
添加建立 http 连接的超时。
错误修复¶
不适用
版本 5.12(2024 年 10 月 16 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
如果 Snowflake 没有收到引入表上最新记录的时间戳,增量更新将不再失败。
版本 5.11.1(2024 年 10 月 8 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
当事件日志表为空时,增量更新不再失败。
当从源更新记录期间由于存在过期行而导致提取的批次为空时,增量引入不再失败。
版本 5.11.0(2024 年 10 月 7 日)¶
行为变更¶
修改了增量更新期间应用的 ServiceNow API 请求排序规则,以消除从多个读取副本读取数据时的数据丢失。
新功能¶
不适用
错误修复¶
当 ServiceNow 实例无法访问时,页面大小不再减小。
版本 5.10.1(2024 年 9 月 6 日)¶
行为变更¶
不适用
新功能¶
不适用
错误修复¶
修复了
UPDATE_CONNECTION_CONFIGURATION
程序中的配置验证。
版本 5.10.0(2024 年 8 月 30 日)¶
行为变更¶
在更新和删除开始时添加对最新时间戳的请求。
新功能¶
UPDATE_CONNECTION_CONFIGURATION
程序已添加。此程序允许更改连接器使用的外部访问集成和密钥对象。连接器 HTTP 请求中的用户代理标头现在设置为
snowflake-connector-for-service-now
。
错误修复¶
从容应对 HTTP 客户端超时错误。
出现此类错误时,缩小页面大小。
ServiceNow® 和 Snowflake 的时间差异不再导致数据丢失。
版本 5.9.1(2024 年 8 月 14 日)¶
行为变更¶
不适用。
新功能¶
不适用。
错误修复¶
针对特定用户的迁移脚本修复。
版本 5.9.0(2024 年 8 月 8 日)¶
行为变更¶
不适用。
新功能¶
不适用。
错误修复¶
在
row_filter
和data_range_start_time
都设置好的情况下修复RELOAD_TABLE
程序。以前没有正确清理行筛选同步状态。当连接器无法克服与身份验证相关的错误时,改进数据引入过程中的错误处理。在这种情况下,连接器现在应该能够更早地检测到错误并停止引入过程。
版本 5.8.0(2024 年 7 月 23 日)¶
行为变更¶
不适用。
新功能¶
ENABLE_TABLE
程序中的row_filter
字段现在可接受筛选表达式中任意数量的空白字符,而不是只允许表达式元素之间有一个空格。有关更多信息,请参阅 使用自定义配置启用单个表。
错误修复¶
现在在重新加载表期间,行筛选和列筛选都已考虑在内。
行筛选器现在可按预期用于无
sys_updated_on
列的表
版本 5.7.0(2024 年 7 月 11 日)¶
行为变更¶
不适用。
新功能¶
现在可以在用户拥有的任务中调用程序 CHECK_ROW_COUNT、ENABLE_TABLE (无自定义配置参数)和 SHOW_REFERENCES_OF_TABLE。
错误修复¶
不适用。
版本 5.6.0(2024 年 7 月 5 日)¶
行为变更¶
不适用。
新功能¶
现在可以进行行筛选。 行筛选支持根据对表列进行评估的条件筛选所引入的表行。使用 ENABLE_TABLE
程序设置行筛选条件。
有关更多信息,请参阅 使用为 ServiceNow® 数据设置数据引入 中 的自定义配置启用单个表。
错误修复¶
提高先前版本迁移脚本的性能。
版本 5.5.1(2024 年 6 月 28 日)¶
行为变更¶
不适用。
新功能¶
不适用
错误修复¶
提高先前版本迁移脚本的性能。
版本 5.5.0(2024 年 6 月 24 日)¶
行为变更¶
不适用。
新功能¶
在开始引入表时添加一种获取表架构的默认方法。这应该有助于解决连接器因第一条引入行遇到 ACLs 而无法开始引入表的问题。
错误修复¶
修复
RUN_HEALTHCHECK
在特定情况下有时无法发送连接器状态的问题。
版本 5.4.0(2024 年 6 月 10 日)¶
行为变更¶
不适用。
新功能¶
变更用于提取表架构的端点。从版本 5.4.0 及更高版本开始,使用 CREATE_VIEW_WITH_DISPLAY_VALUES
、SHOW_REFERENCES_OF_TABLE
和 ENABLE_TABLE``(使用列筛选时)程序时,不再需要 ServiceNow® 中的 ``ADMIN
角色。
错误修复¶
从版本 5.4.0 及更高版本开始,新事件日志表 DELETE
事件包括 RAW
列,该值被设置为来自最新更新事件而不是第一个插入事件。先前存在的事件日志表事件保持不变。
版本 5.3.0(2024 年 5 月 17 日)¶
行为变更¶
不适用。
新功能¶
不适用。
错误修复¶
修复了对传递给 FINALIZE_CONNECTOR_CONFIGURATION
程序的对象中 journal_table
属性空值的处理。现在也可以跳过 journal_table
参数。
版本 5.2.0(2024 年 5 月 10 日)¶
行为变更¶
不适用。
新功能¶
为 FINALIZE_CONNECTOR_CONFIGURATION
添加可选的 table_name 和 sys_id
实参,用于协助日志表验证。
错误修复¶
改进
SET_CONNECTION_CONFIGURATION
中的 URL 验证,支持自定义 ServiceNow® 域。
版本 5.1.0(2024 年 4 月 29 日)¶
行为变更¶
不适用。
新功能¶
CHECK_ROW_COUNT
过程中的 max_sys_created_on
实参现在默认为 NULL
。
错误修复¶
如果配置尚未成功完成,请不要启动运行状况检查报告。
修复
SHOW_REFERENCES_OF_TABLE
,以在返回值中包含给定表的自引用。修复
CREATE_VIEW_WITH_DISPLAY_VALUES
,以处理表引用自身时的情况。
版本 5.0.0(2024 年 4 月 23 日)¶
版本为 5.0.0 的初始版本。
行为变更¶
向 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
新功能¶
不适用。
错误修复¶
不适用。