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

注釈

Snowflake Connector for MySQL は コネクタ規約 に従います。

注釈

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

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

このトピックの内容:

コネクタのログの構成

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

注釈

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

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

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

条件:

fully_qualified_event_table_name

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

イベントテーブル の詳細については、 こちら をご参照ください。

Snowflake Connector for MySQL のインストール

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

  1. ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。

  2. 左側のナビゲーションで Data Products » Marketplace を選択します。

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

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

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

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

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

      注釈

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

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

    3. Get を選択します。

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

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

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

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

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

  1. Snowsight にサインインします。

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

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

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

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

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

注意

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

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

  1. Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Apps を選択します。

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

Snowflake Connector for MySQL の構成

  1. ACCOUNTADMIN ロールを持つユーザーとして Snowsight にサインインします。

  2. ナビゲーションメニューで Data Products » Apps を選択します。

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

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

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

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

ステップ

説明

Provide access to the source database

Snowflake Connector for MySQL データソースの前提条件

Download and install the Agent

Snowflake Connector for MySQL エージェントコンテナの設定

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

Start configuration を選択します。

ステップ2: 構成する

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

フィールド

説明

Compute Warehouse

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

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

注釈

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

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

Operational Warehouse

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

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

注釈

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

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

Role

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

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

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

User

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

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

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

注釈

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

Configure を選択します。

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

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

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

注釈

ファイルを再度生成することもできますが、エージェントが使用するユーザーに対して新しい一時的な秘密キーが生成されます。この処理により、以前に生成されたファイルのキーは無効になります。

生成されたファイルを使用して、以前にダウンロードしたエージェントを構成します。

Refresh を選択し、エージェントとの接続を確認します。

接続に成功するとダイアログが表示されます。 Define data to sync を選択してコネクタのホームページに移動します。

次のステップ

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