管理、更新和卸载 Snowflake Connector for ServiceNow®V2¶

暂停和恢复 Snowflake Connector for ServiceNow®V2¶

以下各节介绍如何暂停和恢复连接器。

CALL PAUSE_CONNECTOR();

CALL RESUME_CONNECTOR();

更改连接器使用的仓库¶

如果要更改连接器使用的仓库或添加专用仓库，请通过调用以下命令执行此操作：

CALL UPDATE_WAREHOUSE('<warehouse_name>');

Copy

其中：

warehouse_name

指定连接器应使用的仓库的名称。

删除表¶

如需删除表（例如无意中启用的表）并且不在 :ref:`监控连接器的视图 <label-monitoring_the_servicenow_connector_v2>`中显示该表，请使用以下过程：

CALL DELETE_TABLE('<table_name>');

Copy

其中：

table_name

指定要删除的表的名称。该表必须 已禁用，并且未在 重新加载。

USE ROLE ACCOUNTADMIN;
GRANT OWNERSHIP ON TABLE <destination_database>.<destination_schema>.<table_name> TO ROLE <account_role> REVOKE CURRENT GRANTS;
USE ROLE <account_role>;
DROP TABLE <destination_database>.<destination_schema>.<table_name>;

更新连接器使用的刷新令牌¶

如果您使用 OAuth 身份验证设置连接器，必须定期更新刷新令牌。否则，一旦令牌过期，连接器将无法再访问 ServiceNow®。默认情况下，令牌在生成 90 天后过期。

如果您为连接器配置 电子邮件警报，会在每月的第一天收到更新刷新令牌的提醒。如果令牌过期，当连接器无法访问 ServiceNow® 时，您会收到一封电子邮件。

更新基本身份验证的 ServiceNow® 密码¶

要更新密码，您需要找到一个现有的密钥并使用 ALTER SECRET 命令进行修改。

1. 使用 Snowsight 或 SQL 命令确定密钥对象的完全限定名称。

   1. 要使用 Snowsight 获取密钥，请执行以下操作：

      1. 以具有 ACCOUNTADMIN 角色的用户身份登录 Snowsight。

      2. 在左侧导航栏中，选择 Data Products » Apps。

      3. 搜索 Snowflake Connector for ServiceNow，然后选择连接器的磁贴。

      4. 在顶部导航菜单中，选择 Settings » Authentication。

         Authentication 部分显示了密钥对象，例如：CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD.SECRET。

   2. 要使用 SQL 命令获取密钥对象的完整限定名称，请查询 CONNECTOR_CONFIGURATION 视图：

      SELECT value FROM connector_configuration WHERE config_key = 'secret';
      

      Copy

2. 暂停 连接器。

3. 通过运行 ALTER SECRET 命令、更改 PASSWORD 参数来更新密钥对象。

4. 恢复 连接器。

   密码现已更新并由连接器使用。

更新与 ServiceNow® 实例的连接¶

您可以更新与 ServiceNow® 实例的连接。它允许更改连接器使用的外部访问集成和密钥。它还可以解决密钥从连接器中的外部访问 UDF 分离的问题。

可通过以下步骤更新连接配置：

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': '<servicenow_base_url>',
  'secret': '<secret_name>',
  'external_access_integration': '<external_access_integration_name>'
});

其中：

servicenow_base_url

指定连接器应使用的 ServiceNow® 实例的 URL。URL 必须设置为与安装连接器时相同的值，格式如下：

https://<servicenow_instance_name>.service-now.com

Copy

不支持更改 ServiceNow® 实例 URL。

secret_name

指定 密钥对象的完整限定名称，该对象包含用于向 ServiceNow® 验证身份的凭证。

您必须按以下格式指定密钥对象的完称：

<database_name>.<schema_name>.<secret_name>

Copy

数据库、架构和密钥的名称必须是有效的 对象标识符。

external_access_integration_name

为该 :ref:`外部访问集成 ServiceNow® <label-servicenow_connector_prereqs_external_access_integration_v2>`制定名称.

集成的名称必须是有效的 对象标识符。

例如，要更新与 ServiceNow® 实例的连接，请执行以下操作：

• 包含 URL https://myinstance.service-now.com。

• 使用存储在 secretsdb.apiauth.servicenow_creds_oauth_code 中的密钥。

• 使用名为 servicenow_external_access_integration 的外部访问集成。

运行以下命令：

CALL UPDATE_CONNECTION_CONFIGURATION({
  'service_now_url': 'https://myinstance.service-now.com',
  'secret': 'SECRETSDB.APIAUTH.SERVICENOW_CREDS_OAUTH_CODE',
  'external_access_integration': 'SERVICENOW_API_INTEGRATION'
});

更新配置只能由具有 ADMIN 应用程序角色授予权限的用户执行。此外，要运行过程，连接器必须处于 paused 状态。请参阅 暂停连接器。

导出连接器状态¶

可以导出当前连接器状态和配置的快照。在重新安装连接器以保留已启用的表和引入状态时，或者在将目标架构复制到故障转移区域以帮助进行灾难恢复时，具有导出的连接器状态的快照非常有用。

可以通过以下过程导出状态：

CALL EXPORT_CONNECTOR_STATE();

Copy

此过程会在目标架构中创建一个具有导出状态的新 __CONNECTOR_STATE_EXPORT 表。要执行导出，必须满足以下条件：

• 导出只能由具有 ADMIN 应用程序角色授予权限的用户执行。

• 没有正在进行的表 重新加载。

只要满足以下条件，每次连接器根据 配置的时间表 触发引入时，配置也会自动导出：

• 至少有一个表已启用引入功能。

• 没有正在进行的表重新加载。

卸载应用程序¶

本节介绍如何使用 Snowsight 和工作表卸载应用程序，以及如何移除由连接器创建但需要由用户有意移除的对象。

升级连接器¶

连接器会自动升级，这意味着用户无需执行任何操作即可获得最新的应用程序。

缩放连接器¶

如果需要引入许多 ServiceNow® 表，并且您希望增加并发引入的表数量，可以通过以下方式更改参数：

CALL CONFIGURE_CONCURRENCY(<number>);

Copy

其中：

number

指定能够同时引入表的最大工作线程数。默认情况下，此值设置为 10。

在考虑提高并发性的同时，还应更改用于数据引入的仓库的大小。如果您遇到任何速度变慢的情况，请尝试调整仓库的大小。有关更多信息，请参阅 使用仓库。

使用与 ServiceNow® 数据相同的数据库和架构重新安装连接器¶

重新安装连接器的步骤如下：

1. 查询 TABLES_STATE 视图并验证当前没有表处于 RELOADING 状态：

   SELECT TABLE_NAME FROM TABLES_STATE WHERE STATUS = 'RELOADING';
   

   Copy

2. 如果当前正在重新加载任何表，请等待重新加载完成或将其 取消。

3. 调用以下存储过程以停止连接器：

   CALL PAUSE_CONNECTOR();
   

   Copy

4. 导出连接器的状态和配置。有关详细信息，请参阅 本节。

   重要

   建议在删除连接器应用程序 之前 导出连接器的状态和配置。这样就可以在新安装中保留所有自定义选项（例如，已启用同步功能的表及其时间表）和状态及其最新更改。

   如果您已经删除了连接器，但包含引入数据的数据库和架构保持完好，您仍然可以依靠自动导出的状态重新安装连接器，但重新安装的连接器可能会重复引入某些记录。

5. 移除连接器，转移目标架构中表和视图的所有权。

6. 通过以下步骤安装连接器：

   • 使用 Snowsight 重新安装连接器 （首选）。

   • 使用 SQL 重新安装连接器。

在安装过程中：

• 提供以前使用的数据库和架构。

  安装后，连接器将检测到数据库和架构包含引入的数据，并从重新安装前所处的位置继续引入。如果导出了连接器状态，并且在安装过程中成功导入了该状态，则先前引入的表将自动启用，并使用相同的计划和配置。否则，您需要手动启用所有表，并执行配置其计划等操作，以恢复引入。

  使用 SQL 命令重新安装时，请务必按照 SQL 安装指南中的说明，将目标架构中的视图和表的所有权转移到连接器。否则，连接器将无法访问这些表和视图，从而无法恢复引入。

• 提供相同的 ServiceNow® 实例名称。

• 对于其他实参，您可以再次使用 安装连接器时创建的对象，或者您也可以使用新对象。