Openflow Connector for Excel を設定する¶

前提条件¶

1. Openflow Connector for Excel について を確認してください。

2. Openflowを設定した ことを確認します。

認証情報を取得する¶

このセクションでは、コネクタを構成するための認証情報を取得する手順について説明します。データソースによって異なります、

• AWS 認証情報を取得する

• SharePoint 認証情報を取得する

Snowflakeアカウントを設定する¶

Snowflakeアカウント管理者として、以下のタスクを実行します。

1. 新しいロールを作成するか、既存のロールを使用します。

2. タイプを SERVICE として、新しいSnowflakeサービスユーザーを作成します。

3. Snowflakeサービスユーザーに、前の手順で作成したロールを付与します。

4. ステップ2のSnowflake SERVICE ユーザーを key-pair auth で構成します。

5. 強く推奨 Openflowがサポートするシークレットマネージャ（AWS、Azure、Hashicorpなど）を構成し、公開キーと秘密キーをシークレットストアに格納します。

   注釈

   シークレットマネージャを使用しない場合は、組織のセキュリティポリシーに従って、キーペア認証に使用する公開キーと秘密キーファイルを保護する責任があります。

   1. シークレットマネージャを構成したら、その認証方法を決定します。AWS 上では、他のシークレットを永続化する必要がないように、Openflowに関連付けられた EC2 インスタンスロールを使用することを推奨します。

   2. Openflowで、右上のハンバーガーメニューから、このSecrets Managerに関連する Parameter Provider を構成します。 Controller Settings » Parameter Provider に移動し、パラメーターの値をフェッチします。

   3. この時点で、すべての認証情報を関連するパラメーターパスで参照することができるため、機密性の高い値をOpenflow内で永続化する必要はありません。

6. 他のSnowflakeユーザーが、コネクタによって取り込まれた生の取り込みドキュメントやとテーブルへのアクセスを必要とする場合は（Snowflakeでのカスタム処理のためなど）、それらのユーザーにステップ1で作成したロールを付与します。

7. 取り込んだデータを格納するコネクタ用に、Snowflakeでデータベースとスキーマを作成します。最初のステップで作成したロールに必要な データベース権限 を付与します。ロールのプレースホルダーを実際の値で置き換え、以下の SQL コマンドを使用します。

   CREATE DATABASE excel_destination_db;
   CREATE SCHEMA excel_destination_db.excel_destination_schema;
   GRANT USAGE ON DATABASE excel_destination_db TO ROLE <excel_connector_role>;
   GRANT USAGE ON SCHEMA excel_destination_db.excel_destination_schema TO ROLE <excel_connector_role>;
   GRANT CREATE TABLE ON SCHEMA excel_destination_db.excel_destination_schema TO ROLE <excel_connector_role>;
   

   Copy

8. コネクタで使用するウェアハウスを作成するか、既存のウェアハウスを使用します。まずは最小のウェアハウスサイズから始め、複製するテーブルの数や転送するデータ量に応じて異なるサイズを試してみてください。テーブル数が大きい場合は、通常、ウェアハウスのサイズを大きくするよりも、 マルチクラスターウェアハウス を使用した方がスケーリングが向上します。

9. コネクタで使用するロールを持つユーザーが、ウェアハウスを使用するために必要な権限を持っていることを確認します。権限がない場合は、ロールに必要な権限を付与してください。

   CREATE WAREHOUSE excel_connector_warehouse WITH WAREHOUSE_SIZE = 'X-Small';
   GRANT USAGE ON WAREHOUSE excel_connector_warehouse TO ROLE <excel_connector_role>;
   

   Copy

コネクタを設定する¶

データエンジニアとして、以下のタスクを実行してコネクタをインストールおよび構成します。

フローを実行する¶

1. プレーンを右クリックし、 Enable all Controller Services を選択します。

2. インポートしたプロセスグループを右クリックし、 Start を選択します。コネクタがデータの取り込みを開始します。

生成されたテーブル名¶

コネクタは、以下のテンプレートを使用して名前を付けた宛先テーブルを作成します: {PREFIX}{FILENAME}_{RANGE}。名前は常に 二重引用符で囲まれた識別子 になります。

• {PREFIX} は、 prfx_ のように、 Destination Table Prefix パラメーターの値で置き換えられます。

• {FILENAME} は、 file1.xlsx や folder/file2.xlsx のように、取り込まれたファイルのフルパスに置き換えられます。

• {RANGE} は次に置き換えられます。

  • Ranges パラメーターの値が空の場合、取り込まれたシートの名前。

  • Sheet1!A1:B2 のように、 Ranges パラメーターで指定された取り込み範囲のある取り込まれたシートの名前。

生成されたテーブル名の例:

• "file1.xlsx_Sheet1"

• "prfx_folder/file2.xlsx_Sheet1!A1:B2"

（オプション）現在実行中のコネクタを再構成する¶

コネクタのパラメーターは、コネクタがデータの取り込みを開始した後で再構成できます。取り込まれたファイルや範囲を変更する必要がある場合は、以下の手順を実行して、データが適切にSnowflakeに送信されるようにします。

1. コネクタを停止する: すべてのOpenflowプロセッサーが停止していることを確認します。

2. 構成設定にアクセスする: Openflow内のコネクタの構成設定に移動します。

3. パラメーターを変更する: 必要に応じてパラメーターを調整します。

4. コネクタを起動する: コネクタを起動し、すべてのコントローラサービスが起動していることも確認します。