Snowflake Connector for ServiceNow® V2 版本说明¶

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• Changed the column used for API request length validation.

行为变更¶

• The connector no longer has a 128 MB memory limit for uncompressed responses from the ServiceNow API.

新功能¶

不适用。

错误修复¶

不适用。

行为变更¶

• Custom journal tables are currently disabled. They'll be restored with new functionality in a future release.

• When you pause the connector, only worker tasks are forcefully canceled. Other tasks keep running until they finish, so pausing might take a bit longer.

新功能¶

• The connector now lets you use NOT LIKE and NOT IN operators for row filtering, so you can filter your data more flexibly during ingestion.

错误修复¶

• The connector now retries curl errors more times, making it more resilient to network issues in Azure deployments.

行为变更¶

不适用。

新功能¶

• Improved logging of HTML responses.

• Improved error handling for External Access.

错误修复¶

不适用。

行为变更¶

不适用。

新功能¶

• 通过在必要时减小页面大小，改进了数据解压缩期间对大响应大小的处理。

错误修复¶

不适用。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 修复了导致在状态导入期间错误创建架构表的问题。

• 修复了筛选重新加载模式下的以下问题：某些状态事件可能会以错误的顺序保存，从而导致错过更新。

• Improved handling of large responses from ServiceNow.

• 添加了 ServiceNow 响应属性的更详细日志记录。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 修复了连接器全局配置为提取显示值时，在重新加载期间可能导致元数据表引入错误的问题。由于此问题，没有为某些表创建展平视图。如果出现此问题，则必须重新加载以下元数据表：

  • sys_dictionary

  • sys_db_object

  • sys_glide_object

行为变更¶

• 对于 sys_created_on 或 sys_updated_on 列中值为空的记录，仅当记录自上次引入以来发生更改时，连接器才会插入更新事件。以前，无论记录是否更改，连接器都会在每个引入周期向事件日志表中插入更新事件。这种行为可能导致事件日志表无限增长，即使表中未发现任何更改也不例外。

新功能¶

不适用。

错误修复¶

• 增加了连接器在筛选引入期间尝试的页面大小范围。在提取数据时，连接器现在应该更能抵御来自 ServiceNow® API 的超时错误。

• 修复了内部清理任务，以保留执行引入所需的内部连接器信息。以前，移除此信息时，可能会导致引入失败。

• 修复了创建展平视图时出现的错误。此错误是由内部连接器表中缺少一列引起的。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 修复了重新加载表时页面大小保持不变的问题。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 修复了对字符串值使用行筛选表达式时可能导致连接器状态导出失败的问题。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 修复了可能导致 HTTP 响应解析失败的问题。在某些情况下，此问题可能导致连接器无法从 ServiceNow® 引入数据。

行为变更¶

不适用。

新功能¶

• Added support for continuous schedules. You can use this feature to set an ingestion schedule for up to 20 tables that will be executed every one minute. Snowflake recommends using continuous schedules carefully and only for tables that require near-real-time data in Snowflake. To enable this feature, you can use the ENABLE_TABLE or CONFIGURE_TABLES_SCHEDULE procedures. To learn more, see Specifying the Synchronization Schedule.

• 可以同时引入的最大表数已从 30 个增加到 50 个。此更新可以提高仓库利用率并提高整体性能。要了解更多信息，请参阅 扩展连接器。

错误修复¶

• 并行引入多个表时，连接器更稳定，性能更高。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

• 修复了导致连接器状态导出失败的错误。

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

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

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

行为变更¶

不适用。

新功能¶

• The DELETE_TABLE procedure now accepts an optional drop_related_objects boolean parameter. When this parameter is set to true, the procedure drops all the objects related to the table, such as the flattened views, the event log table, and the sink table.

• The filtered reload feature now supports detection of deletes and can filter out these records when using the sys_ids parameter in the RELOAD_TABLE procedure. Prior to this release, the filtered reload feature only detected data updates and insertion.

错误修复¶

• Corrected error in CONNECTOR_STATS view ingested row statistics when running filtered reload.

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

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

行为变更¶

• 要查看重新加载的表的配置详细信息，请使用新 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 程序，则升级过程不再失败。

• The connector no longer fails when an internal state snapshot isn't created because of its size.

行为变更¶

不适用。

新功能¶

不适用。

错误修复¶

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

行为变更¶

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

  除了在 __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

新功能¶

不适用。

错误修复¶

不适用。