使用 Snowsight 安装和配置连接器

Snowflake Connector for ServiceNow® 受 Connector 条款 的约束。

本主题介绍如何通过 Snowsight 安装和配置 Snowflake Connector for ServiceNow®。

本主题内容：

安装 Snowflake Connector for ServiceNow®

以下过程描述了如何安装连接器：

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

  2. 在导航菜单中，选择 Data Products » Marketplace。

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

  4. 在 Snowflake Connector for ServiceNow® 页面中，选择 Get。

    这将显示一个对话框，您可以使用该对话框开始安装过程的初始部分。

    在对话框中配置以下内容：

    1. 在 Database name 字段中，输入要用作连接器实例的数据库的数据库名称。该数据库是自动为您创建的。

    2. 在 Warehouse used for installation 字段中，选择要用于安装连接器的仓库。

      备注

      这与连接器用于同步来自 ServiceNow 的数据的仓库不同。在后续步骤中，您将为此目的创建一个单独的仓库。

    3. 在 Which roles, in addition to ACCOUNTADMIN, can access this database? 字段中，添加您希望有权访问数据库的其他角色。

    4. 选择 Get。

  5. 此时将出现一个带有通知的对话框：``<Your database name> 现在可以在您的账户中使用。``要继续配置，请选择 Manage。

    之后对话框关闭，并且 Snowflake Connector for ServiceNow® 页面显示用于配置和管理连接器的 UI。

设置与 ServiceNow 的连接

以下过程描述了如何设置与 ServiceNow 的连接:

  1. 在 Connections 部分，选择 Connect 以配置设置与 ServiceNow 实例的连接。

    这会显示 Connect to ServiceNow 对话框。

  2. 在 ServiceNow Instance 字段中，输入 ServiceNow 实例的名称。

    这是您的 ServiceNow 实例主机名的第一部分。例如，如果指向您的 ServiceNow 实例的 URL 为：

    https://myinstance.service-now.com
    Copy

    实例的名称将是 myinstance。

  3. 在 Authentication Method 字段中，选择您要用于允许连接器连接到 ServiceNow 实例的身份验证方法。

    您可以选择基本身份验证（用户名和密码）或 OAuth。

  4. 如果您选择了 Basic authentication，请在 ServiceNow username 和 ServiceNow password 字段中输入您的 ServiceNow 账户的凭据。

  5. 如果您选择了 OAuth，请在 ServiceNow 中创建一个应用程序注册表，并用它来配置连接器。

    要创建应用程序注册表，请执行以下操作：

    1. 登录 ServiceNow 实例，然后选择 Homepage。

    2. 搜索 OAuth，然后选择 Application Registry。

    3. 选择 New,，然后选择 Create an OAuth API endpoint for external clients。

      系统会显示应用程序注册表的配置页，如下图所示：

      在左侧的 ServiceNow 中显示应用程序注册表页。

    4. 在 ServiceNow 中的字段 Name 中，输入 OAuth 应用程序注册表的名称。

    5. 在连接器 UI 中，复制 Redirect URL 字段中的值。

      该值由连接器生成。

    6. 在 ServiceNow 中，将此值粘贴到 Redirect URL 字段。

    7. 如果需要，请在 ServiceNow 中更新字段 Refresh Token Lifespan 和 Access Token Lifespan 的值。

      • Snowflake 建议将访问令牌的有效期设置为至少 600 秒。

      • 对于刷新令牌的有效期，请指定值为 7776000（90 天）。

    8. 在 ServiceNow 中，选择 Submit。

      OAuth 应用程序注册表显示在应用程序注册表列表中。

    9. 在 ServiceNow 中，选择您刚刚创建的应用程序注册表。

      注意， ServiceNow 为 Client ID 和 Client Secret 字段创建了值。

    10. 在 ServiceNow 中，复制 Client ID 的值。

    11. 将此值粘贴到连接器 UI 中的 Client ID 字段中。

    12. 在 ServiceNow 中，复制 Client Secret 的值。

    13. 将此值粘贴到连接器 UI 中的 Client Secret 字段中。

      该连接器使用一个 `密钥`_（一种架构级对象）来存储用于对 ServiceNow 实例进行身份验证的访问令牌。连接器使用此密钥对象进行安全集成和 API 集成，以便连接到 ServiceNow 实例。

      密钥、安全集成和 API 集成会在安装连接器时自动创建。

    14. 要指定如何配置密钥对象、安全集成和 API 集成，请选择 Advanced Settings，并填写以下字段：

      字段

      描述

      Secret Name

      密钥的名称。连接器生成该值。您无法更改该值。

      Authorization URL

      用于对 ServiceNow 实例进行身份验证的 URL。此 URL 应采用以下格式：

      https://<instance_name>.service-now.com/oauth_token.do
      Copy

      其中 instance_name 是 ServiceNow 实例的名称。

      Token URL

      用于请求 ServiceNow 实例的刷新令牌的 URL。此 URL 应采用以下格式：

      https://<instance_name>.service-now.com/oauth_token.do
      Copy

      其中 instance_name 是 ServiceNow 实例的名称。

      Allowed Prefix

      您的 ServiceNow 实例的 URL。

      这限制了这些连接设置的使用。这些设置只能用于连接具有指定前缀的 URLs。

  6. 在连接器 UI 中，选择 Connect。

    此时会出现一个对话框，要求您使用用户名和密码登录到 ServiceNow 实例。提供您希望连接器进行身份验证的用户的凭据，它需要 准备 ServiceNow® 实例 中列出的权限。

  7. 登录后，确认要允许连接器连接到 ServiceNow® 账户。选择 Allow。

    备注

    如果您在不需要提供凭据的情况下被直接重定向到此对话框，则表示您已经登录到 ServiceNow 实例。确保使用连接器应使用的用户登录，并且该用户具有必要的权限。注意：当前登录的用户显示在对话框的右上角。

    新的 ServiceNow 连接会出现在 Connection 区域。

完成这些步骤后，向导将创建连接器工作所需的位于连接器数据库外部的以下对象：

  • 用于存储密钥对象的具有 SERVICENOW_GZSTZTP0KHD 架构的数据库 CONNECTORS_UI；

  • CONNECTORS_UI.SERVICENOW_GZSTZTP0KHD 中名为 SECRET 的具有 ServiceNow 凭据的密钥对象，

  • 名为 SERVICENOW_GZSTZTP0KHD_INTEGRATION 的安全集成，用于在 Snowflake 和第三方 OAuth 2.0 服务之间集成（如果选择 OAuth 身份验证作为授权方式），

  • API 集成，用于与 SERVICENOW_GZSTZTP0KHD_API 与 ServiceNow 通信。

这些对象的名称 不得 更改。因为连接器通过名称来引用它们。更改它们的名称或删除它们会破坏引用和连接器。

配置 Snowflake Connector for ServiceNow®

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

  2. 在导航菜单中，选择 Data Products » Marketplace。

  3. 搜索 Snowflake Connector for ServiceNow®，然后选择它。

  4. 在连接器的状态下，选择 Configure。

    这会显示 Configure Connector 对话框。

    备注

    默认情况下，这些字段设置为配置连接器时创建的对象的名称。Snowflake 建议对这些字段使用新对象。但是，如果需要（例如，如果您要重新安装连接器），您可以指定现有对象的名称。

    在此对话框中，请填写以下字段：

    字段

    描述

    Warehouse

    连接器的新的专用虚拟仓库的标识符。

    为您的账户指定一个唯一的名称。仓库的名称必须是有效的 对象标识符。

    备注

    请勿指定您在连接器安装开始时选择的同一仓库。

    配置过程创建一个具有指定名称的新 Large 仓库。

    Destination Database

    新数据库的标识符，该数据库将包含 Snowflake 中 ServiceNow 数据的架构和表。

    为您的账户指定一个唯一的名称。数据库名称必须是有效的 对象标识符。

    配置过程会创建一个具有指定名称的新数据库。

    Destination Schema

    将包含 Snowflake 中的 ServiceNow 数据的新架构的标识符。

    Snowflake Connector for ServiceNow® 将 ServiceNow 数据引入到此架构的表中。

    为您的账户指定一个唯一的名称。架构名称必须是有效的 对象标识符。

    配置过程会创建具有指定名称的新架构。

    Role

    连接器的新自定义角色的标识符。此角色允许连接器执行以下操作：

    • 创建和管理数据引入任务。

    • 使用专用仓库。

    • 访问密钥和 API 集成以连接到 ServiceNow 实例。

    该角色同时也是包含由连接器引入 ServiceNow 数据的表和视图的所有者。

    为您的账户指定一个唯一的名称。角色的名称必须是有效的 对象标识符。

    配置过程会创建具有指定名称的新角色。

    虽然建议在开始引入后创建单独的、更细化的角色来访问引入的数据，但您可以使用此角色来查询引入的数据，还可以用额外的权限进行扩展。反之，不允许撤销连接器所需的对象的角色权限，亦不允许更改具有引入数据的表和视图的角色所有权，否则会破坏连接器。

    Journal table

    （可选）要启用已删除记录的传播，请将其设置为充当已删除记录信息源的表。

    您可以使用 sys_audit_delete 表或自定义日志表作为有关已删除记录的信息源。

    如果您不想引入 ServiceNow 中的已删除记录放入 Snowflake 中，请将此字段留空。

    备注

    确保连接器的 ServiceNow 用户有权访问指定的日志表。

  5. 选择 Configure。

对话框关闭，连接器的状态更改为 Provisioning。配置过程可能需要几分钟才能完成。

Connector Objects 部分显示在安装和配置期间自动创建的对象。连接器使用这些对象从 ServiceNow 实例引入数据。要查看对象的详细信息，请选择相应对象。

如果配置过程成功完成，显示的状态将更改为 Inactive。

连接器按名称引用仓库、目标数据库、目标架构和角色。更改这些对象的名称或删除它们将导致引用中断，从而破坏连接器。请勿重命名仓库，而是使用 CONFIGURE_WAREHOUSE 存储过程更改连接器使用的仓库。

排除配置过程中的错误

如果在配置过程中发生错误，连接器状态将更改为 Incomplete。要识别并解决错误，请执行以下错误：

  1. 选择 Retry Setup 再次显示配置对话框。

  2. 检查任何字段下的错误消息。

  3. 修复字段中的问题，然后选择 Configure 再次开始配置过程。

后续步骤

安装并配置连接器后，执行“ 为 ServiceNow® 数据设置数据引入”中描述的步骤。

语言: 中文