SDK コンポーネントの選択

コネクタのネイティブ SDK は複数のコンポーネントで構成されており、その一部は独立しており、一部は動作するために相互に依存しています。このセクションでは、コネクタでオンにするコンポーネントをカスタマイズする方法について説明します。さらに、各コンポーネントについて簡単に説明し、それらの依存関係についても紹介します。

コンポーネントの有効化/無効化

コンポーネントは、Snowflakeデータベースオブジェクトレベルで有効化または無効化されます。つまり、実行された setup.sql ファイルは、何が有効化または無効化されたかに関する信頼できる情報源となります。初めて使用する場合は、 all.sql が提供する SDK ファイルを使用することをお勧めします。このファイルには、 SDK の基本機能がすべて含まれています(タスクリアクターを除く)。

実行するには、コネクタの setup.sql ファイルに次の行を追加します。

EXECUTE IMMEDIATE FROM 'native-connectors-sdk-components/all.sql';
Copy

経験豊富なユーザーの場合は、有効化および無効化された機能をカスタマイズできます。実行するには、必要に応じて EXECUTE IMMEDIATE ステートメントを追加および削除します。機能に必要なファイルを除外すると、機能が壊れることに注意してください。

-- Core connector objects
EXECUTE IMMEDIATE FROM 'core.sql';

-- Connector configuration prerequisites
EXECUTE IMMEDIATE FROM 'prerequisites.sql';

-- Connector configuration flow
EXECUTE IMMEDIATE FROM 'configuration/app_config.sql';
EXECUTE IMMEDIATE FROM 'configuration/connector_configuration.sql';
Copy

コンポーネント

以下のセクションには、コネクタのネイティブ SDK コンポーネントのリストと簡単な説明、および各コンポーネントに必要なその他のコンポーネントのリストが含まれています。詳細については、 Snowflake Native SDK for Connectors リファレンス をご参照ください。

コアコンポーネント

コアコンポーネントは、アプリケーションの内部ステータスのスキーマ、ロール、永続性レイヤーなど、コネクタの基本オブジェクトを作成する役割を担います。

依存関係

このコンポーネントは他のコンポーネントに依存しません。

アプリケーション構成コンポーネント

アプリケーション構成コンポーネントは、アプリケーションの内部構成を保存および読み取るための永続性レイヤーです。

依存関係

このコンポーネントは他のコンポーネントに依存しません。

前提条件コンポーネント

前提条件はウィザードのオプションの一部です。通常は、コネクタ自体の外部で満たす必要がある構成と初期設定についてエンドユーザーに通知することをサポートします。

依存関係

  • コアコンポーネント

コネクタ構成コンポーネント

コネクタ構成は、シンクデータベース、データ所有者ロール、ウェアハウスなどの一般的なコネクタプロパティを構成するウィザードステップです。

依存関係

  • コアコンポーネント

  • アプリケーション構成コンポーネント

接続構成コンポーネント

接続構成は、認証や承認のプロパティやメソッドなど、コネクタの外部ソースシステムとの通信に関連するプロパティを構成するウィザードステップです。

依存関係

  • コアコンポーネント

  • アプリケーション構成コンポーネント

構成コンポーネントの完了

コネクタの完了は、外部ソースシステムとコネクタ固有の構成への最終的な接続チェックを実行するウィザードステップです。

依存関係

  • コアコンポーネント

  • 推奨: アプリケーション構成コンポーネント

一時停止/再開コンポーネント

一時停止/再開コンポーネントは、クレジットの消費を停止するために、必要なときにコネクタを一時停止および再開するオプションを提供します。

依存関係

  • コアコンポーネント

  • 推奨: アプリケーション構成コンポーネント

  • 推奨: 構成コンポーネントの完了

インジェスチョンコンポーネント

インジェスチョンコンポーネントは、外部ソースシステムからSnowflakeに取り込まれるデータを定義する抽象化と永続性を提供します。

依存関係

このコンポーネントは他のコンポーネントに依存しませんが、複数のSQLファイルを実行する必要があります。

スケジューラーコンポーネント

スケジューラーコンポーネントを使用すると、下にあるSnowflakeタスクを使用して、構成に応じてコネクタ内でタスクをトリガーするメカニズムを提供できます。

依存関係

  • コアコンポーネント

  • アプリケーション構成コンポーネント

  • コネクタ構成コンポーネント

コネクタ統計コンポーネント

コネクタの統計コンポーネントは、実行されたインジェスチョンタスクのメタデータを確認するのに便利なビューを提供します。コネクタを介して流れるデータの量を監視するのに役立ちます。

依存関係

  • インジェスチョンコンポーネント

同期ステータスコンポーネント

同期ステータスコンポーネントは、最後のデータ同期がいつ行われたかをすばやく確認するためのビューを提供します。

依存関係

  • インジェスチョンコンポーネント

  • コネクタ統計コンポーネント

タスクリアクターコンポーネント

タスクリアクターは、ワークアイテムをキューに入れ、複数のワーカータスクに分散させるメカニズムを提供するコンポーネントです。作業負荷が膨大な場合は、ワーカーの数を変更して増やすことができます。

依存関係

このコンポーネントは他のコンポーネントに依存しません。