先决条件

先决条件步骤是连接器向导阶段的第一步。这一步是完全可选的，但如果最终用户需要在原生应用程序之外或整个 Snowflake 上下文中执行一些其他设置，建议执行这一步。例如，在要引入数据的源系统中设置身份验证和授权。

要设置先决条件，必须在连接器安装过程中将先决条件插入 STATE.PREREQUISITES 表中。该表中的大多数列应该是不言自明的。URL 列应用于向最终用户提供所需设置的更多信息。如果在先决条件中需要提供更自定义的内容，则应使用 custom_properties 列。

先决条件阶段包括两个步骤：

  1. 将先决条件标记为已完成

  2. 完成步骤

要求

在原生应用程序安装过程中，先决条件至少需要执行以下 sql 文件：

  • core.sql

  • configuration/prerequisites.sql

将先决条件标记为已完成

这一步可以通过两种不同的方式来实现。可以逐个将先决条件标记为已完成，也可以将所有先决条件一起标记为已完成。最终结果是相同的，每个先决条件的 is_completed 值都设置为 true。通过以下过程处理这一步：

  • PUBLIC.MARK_ALL_PREREQUISITES_AS_DONE()

  • PUBLIC.UPDATE_PREREQUISITE(ID VARCHAR, IS_COMPLETED BOOLEAN)

这两个过程都要求连接器处于 CONFIGURING 状态，并且配置状态不能是 FINALIZED。

完成步骤

要完成先决条件步骤，请调用 PUBLIC.COMPLETE_PREREQUISITES_STEP() 过程。除非连接器处于 CONFIGURING 状态且配置状态为 INSTALLED，否则此过程无效。

如果是这样，则状态将更新为以下值：

{
    "status": "CONFIGURING",
    "configurationStatus": "PREREQUISITES_DONE"
}
Copy

此过程要求连接器处于 CONFIGURING 状态，并且配置状态不能是 FINALIZED。

语言: 中文