Snowflake Connector for PostgreSQL を使用した Snowsight の設定

重要

PostgreSQL 用Snowflakeコネクタにご興味をお持ちいただきありがとうございます。現在、大幅に改善されたエクスペリエンスを提供する次世代ソリューションに焦点を当てています。したがって、このコネクタを一般提供ステータスに移行することは、現在の製品ロードマップにはありません。このコネクタはプレビュー機能として引き続き使用できますが、将来のバグ修正および改善のサポートは保証されないことに注意してください。新しいソリューションは PostgreSQL 用Openflowコネクタ として利用可能で、より優れたパフォーマンス、カスタマイズ性、強化された展開オプションが含まれます。

注釈

AUTOCOMMIT パラメーターがfalseに設定されているアカウントの場合は、 SQL コマンド ALTER SESSION SET AUTOCOMMIT=TRUE を使用して、構成中にセッションレベルでtrueに設定する必要があります。

Snowflake Connector for PostgreSQL を使用して Snowsight を構成するプロセスには、次のステップが含まれます。

コネクタのログの構成

Snowflake Connector for PostgreSQL は、イベントテーブルを使用してコネクタコードによって生成されたイベントとログを保存します。イベントテーブルの設定は必須のステップです。

注釈

コネクタに使用されるアカウントに対してイベントテーブルがすでに構成されている場合は、このステップをスキップしてください。

イベントテーブルを作成するには、次を実行します。

CREATE EVENT TABLE IF NOT EXISTS <fully_qualified_event_table_name> CHANGE_TRACKING = TRUE;
ALTER ACCOUNT SET EVENT_TABLE = <fully_qualified_event_table_name>;

条件:

fully_qualified_event_table_name

イベントテーブルの名前を指定します。

イベントテーブル の詳細については、`こちら<https://other-docs.snowflake.com/en/native-apps/consumer-enable-logging>`__をご参照ください。

Snowflake Connector for PostgreSQL のインストール

次の手順では、コネクタをインストールする方法について説明します。

  1. ACCOUNTADMIN ロールを持つユーザーとして Sign in to Snowsight

  2. In the navigation menu, select Marketplace » Snowflake Marketplace

  3. Snowflake Connector for PostgreSQL を検索し、コネクタのタイルを選択します。

  4. Snowflake Connector for PostgreSQL のページで、 Get を選択します。

    これにより、インストールプロセスの最初の部分を開始するために使用するダイアログが表示されます。

    ダイアログで、次のように構成します。

    1. Warehouse used for installation フィールドで、コネクタのインストールに使用するウェアハウスを選択します。

      注釈

      これは、コネクタが MySQL データベースからのデータを同期するために使用するウェアハウスとは異なります。後のステップで、この目的のために別のウェアハウスを作成します。

    2. オプションで、 Options » Application name ではアプリケーションの名前を変更できます。

    3. Get を選択します。

  5. ダイアログが Successfully Installed の通知とともに表示されます。構成を続けるには、 Configure を選択します。

    ダイアログが閉じ、 Snowflake Connector for PostgreSQL ページに、コネクタを構成および管理するための UI が表示されます。

オプション: Snowflake Connector for PostgreSQL の複数のインスタンスをインストールする

Snowflakeアカウントに、同じコネクタアプリケーションの複数のインスタンスをインストールできます。

追加のアプリケーションインスタンスをインストールするには、次を実行します。

  1. Sign in to Snowsight

  2. In the navigation menu, select Marketplace » Snowflake Marketplace

  3. 別のインスタンスをインストールするアプリケーションを選択します。アプリケーションの詳細ページが表示されます。

  4. Add instance をクリックします。インストールダイアログが表示されます。

  5. インスタンス名を指定し、インストール中に使用するウェアハウスを選択します。

  6. Get を選択し、インストールプロセスを開始します。

コネクタインスタンスの追加には数分かかる場合があります。インストールプロセスが完了すると、メールで通知が届きます。

注意

インジェストされたデータの破損を避けるため、コネクタ構成中は、常に他のすべてのネイティブアプリケーションとは異なるデータベーススキーマを使用します。

インストールされたコネクタアプリケーションインスタンスにアクセスするには、次を実行します。

  1. Sign in to Snowsight

  2. :go-to:`アプリ`

  3. アプリケーションインスタンスを選択して、アクセスします。

Snowflake Connector for PostgreSQL の構成

  1. ACCOUNTADMIN ロールを持つユーザーとして Sign in to Snowsight

  2. :go-to:`アプリ`

  3. Snowflake Connector for PostgreSQL を検索してから、選択します。インストールウィザードページに移動し、構成プロセスを行います。

アプリケーションを次のように構成します。

ステップ1: 前提条件を完了する

データベースとエージェントを設定するには、次の前提条件のステップを完了してください。

完了したステップごとに、 Mark as done を選択します。

Start configuration を選択します。

ステップ2: 構成する

構成ダイアログで、次のフィールドに値を入力します。

フィールド

説明

Compute Warehouse

コネクタ専用の新しい仮想ウェアハウスの識別子。このウェアハウスは、エージェントから取得したデータを処理し、ターゲットテーブルに格納するために使用されます。

アカウントに一意の名前を指定します。ウェアハウスの名前は、有効な オブジェクト識別子 である必要があります。

注釈

コネクタのインストールの開始時に選択したものと同じウェアハウスを指定しないでください。

構成プロセスにより、指定された名前で新しい X-Small ウェアハウスが作成されます。

Operational Warehouse

コネクタ専用の新しい仮想ウェアハウスの識別子。このウェアハウスは、コネクタとそのエージェントのアクティビティを管理するために使用されます。

アカウントに一意の名前を指定します。ウェアハウスの名前は、有効な オブジェクト識別子 である必要があります。

注釈

コネクタのインストールの開始時に選択したものと同じウェアハウスを指定しないでください。

構成プロセスにより、指定された名前で新しい X-Small ウェアハウスが作成されます。

Role

エージェント用の新しいカスタムロールの識別子。

アカウントに一意の名前を指定します。ロールの名前は、有効な オブジェクト識別子 である必要があります。

構成プロセスにより、指定された名前で新しいロールが作成されます。

User

エージェントがSnowflakeの認証に使用する新しいユーザーの識別子。

選択したデータベース内で一意の名前を指定します。ユーザーの名前は、有効な オブジェクト識別子 である必要があります。

構成プロセスでは、指定された名前とタイプ SERVICE の新しいユーザーが作成されます。

注釈

デフォルトでは、フィールドはコネクタの構成時に作成されるオブジェクトの名前に設定されます。Snowflakeは、これらのフィールドに新しいオブジェクトを使用することをお勧めします。ただし、必要に応じて既存のオブジェクトの名前を指定できます(例: コネクタを再インストールする場合)。

Configure を選択します。

ステップ3: エージェント接続を確認する

次のようにして、エージェントとSnowflakeの接続を確認します。

  1. エージェントの初期構成ファイルを生成するには、 Generate file を選択します。

    注意

    Generate file をクリックするたびに、エージェントのユーザーのための仮アクセスキーの新しいセットが入った新しいファイルが生成されます。ユーザーは、認証にこれらの新しいキーを使用するように自動的に変更されます。すでに別のキーセットでエージェントを実行している場合は、Snowflakeから切断され、動作しなくなります。

  2. 生成された snowflake.json ファイルを使用して、 Snowflake Connector for PostgreSQL エージェントコンテナの設定 で説明されているようにエージェントの構成に進みます。その後、Snowsightに戻ります。

  3. Refresh を選択し、エージェントとの接続を確認します。アプリケーションはエージェントが正常に接続されたことを確認し、確認ダイアログが表示されます。

  4. Define data to sync を選択して続行します。

次のステップ

これらの手順を完了したら、 Snowflake Connector for PostgreSQL エージェントコンテナの設定 のステップに従います。