前提条件¶

前提条件のステップは、コネクタのウィザードフェーズの最初のステップです。この手順は完全にオプションですが、エンドユーザーがネイティブアプリまたはSnowflakeコンテキスト全体の外部で追加のセットアップを実行する必要がある場合は、このステップを実行することをお勧めします。この例としては、データが取り込まれるソースシステムで認証と承認を設定することが挙げられます。

前提条件を設定するには、コネクタのインストール中にそれらを STATE.PREREQUISITES テーブルに挿入する必要があります。このテーブルの列のほとんどは、説明を要しないはずです。URL 列は、エンドユーザーに必要な設定に関する詳細情報を提供するために使用されます。前提条件でさらにカスタムのものを提供する必要がある場合は、 custom_properties 列を使用する必要があります。

前提条件フェーズは2つのステップで構成されます。

前提条件を完了としてマークする
ステップの完了

要件¶

前提条件として、ネイティブアプリのインストール中に少なくとも次のSQLファイルを実行する必要があります。

core.sql
configuration/prerequisites.sql

前提条件を完了としてマークする¶

このステップは2つの異なる方法で実行できます。前提条件は、1つずつ完了としてマークすることも、すべてをまとめて完了としてマークすることもできます。最終結果は同じで、各前提条件の 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 でないことが求められます。