DataFlux Func 経由で接続¶
DataFlux Func はスクリプトの開発・実行プラットフォームです。外部データソースは、デプロイ済みの Func とそのコネクタを介してデータにアクセスし、その結果をGuanceに渡してクエリおよび表示します。
この方式は、既存の Func 環境に適しているほか、スクリプトによる加工、サードパーティ API の呼び出し、カスタムチャートのデータ構造が必要なユースケースにも適しています。QueryHub とは異なり、Func の接続設定とスクリプトは Func プラットフォームで管理します。既存の Func データソースは、従来の ID とクエリ方法を引き続き使用します。
準備¶
- 対象のワークスペースにデプロイおよび接続済みの DataFlux Func があること。未デプロイの場合は、Func クイックスタートを参照してください。
- Func の実行環境から対象のデータソースにアクセスでき、使用するアカウントに必要なクエリ権限があること。
コンソールでデータソースを追加¶
- インテグレーション > 外部データソースに移動し、データソースを追加をクリックします。
- DataFlux Func 経由で接続を選択します。
- 一覧から接続済みの DataFlux Func を選択します。
- データソースタイプを選択し、接続情報を入力します。
| 設定項目 | 意味と入力方法 |
|---|---|
| DataFlux Func | 対象データソースへの接続を担当する Func インスタンス。ネットワーク到達可能で、現在のワークスペースに関連付け済みのインスタンスを選択してください。 |
| データソースタイプ | 対象データベースまたはサービスの実際のタイプ。選択肢は、選択した Func のコネクタ機能に準じます。 |
| データソース ID | この接続設定を識別するために使用します。ページの指示に従って設定してください。既存の Func コネクタを再利用する場合は、そのコネクタ ID と一致させ、データベース名や API Key で代用しないでください。 |
| タイトル | データソースの一覧およびクエリセレクターでの表示名。 |
| ホストアドレス、ポート | データソースの実際の接続先アドレス。データベースまたはサービスの管理者から提供されます。管理コンソールの URL は入力しないでください。 |
| データベース | リレーショナルデータベース接続でアクセスするデータベース名。テーブル名ではありません。 |
| ユーザー名、パスワード | 対象データベースまたはサービスへのアクセス認証情報。ワークスペースのログインアカウントではありません。 |
コネクタによってフィールドは異なります。ページに表示される現在のタイプに必要な情報を入力し、完了後に接続をテストして保存します。操作権限を設定する場合は、ワークスペースおよび外部データソースの権限ルールに従います。
クエリで使用する¶
- メトリクス分析またはチャートにデータソースクエリを追加します。
- Func 経由で接続したデータソースを選択します。
- そのコネクタがサポートするネイティブクエリ文を入力し、クエリを実行するか結果を更新します。
- 返却された構造に基づいて表示方法を選択します。
たとえば、MySQL テーブル orders に id、total、status が含まれる場合、支払済み注文をクエリできます。
ここでは、選択した Func コネクタがサポートする構文を使用します。クエリテキストを変更して QueryHub に切り替えることはできません。
スクリプト処理が必要な場合¶
直接クエリで要件を満たせない場合は、Func で対応するタイプのコネクタを作成し、コネクタ ID を介してオブジェクトを取得し、カスタム関数を記述して結果を処理できます。
ここでの mysql は Func 内の MySQL コネクタの ID であり、データソースタイプ名、テーブル名、ワークスペース ID ではありません。
- 外部 MySQL をクエリする場合は、MySQL タイプのコネクタを作成して使用します。
- スクリプトでGuance API を呼び出す必要がある場合は、必要に応じて対応するコネクタを作成し、ワークスペース API Key を設定します。
API Key は管理 > API Key 管理で作成できます。詳細は API Key 管理を参照してください。ワークスペース API Key をデータベースのパスワードフィールドに入力しないでください。
詳細な手順と返却形式については、カスタムクエリ関数を参照してください。
管理とメンテナンス¶
インテグレーション > 外部データソースで、データソースタイプ、ID、関連付けられた Func、ステータスを確認し、権限に応じて設定を編集または削除します。
- 既存データソースの ID およびクエリ参照は従来のルールを維持します。QueryHub のエントリが追加されても自動移行されません。
- データベースのパスワードまたはネットワークが変更された場合は、実際に使用する Func 接続設定を更新し、クエリを再検証します。
- 接続を削除する前に、関連するチャートおよびスクリプトの参照関係を確認してください。削除後は、既存の参照でクエリを継続できない可能性があります。
既存の TiDB Cloud Lake 専用接続については、引き続き対応ガイドを参照してください。Func コネクタに変更する必要はありません。
