コンテンツにスキップ

DataFlux Func 経由で接続

DataFlux Func はスクリプトの開発・実行プラットフォームです。外部データソースは、デプロイ済みの Func とそのコネクタを介してデータにアクセスし、その結果をGuanceに渡してクエリおよび表示します。

この方式は、既存の Func 環境に適しているほか、スクリプトによる加工、サードパーティ API の呼び出し、カスタムチャートのデータ構造が必要なユースケースにも適しています。QueryHub とは異なり、Func の接続設定とスクリプトは Func プラットフォームで管理します。既存の Func データソースは、従来の ID とクエリ方法を引き続き使用します。

準備

  • 対象のワークスペースにデプロイおよび接続済みの DataFlux Func があること。未デプロイの場合は、Func クイックスタートを参照してください。
  • Func の実行環境から対象のデータソースにアクセスでき、使用するアカウントに必要なクエリ権限があること。

コンソールでデータソースを追加

  1. インテグレーション > 外部データソースに移動し、データソースを追加をクリックします。
  2. DataFlux Func 経由で接続を選択します。
  3. 一覧から接続済みの DataFlux Func を選択します。
  4. データソースタイプを選択し、接続情報を入力します。
設定項目 意味と入力方法
DataFlux Func 対象データソースへの接続を担当する Func インスタンス。ネットワーク到達可能で、現在のワークスペースに関連付け済みのインスタンスを選択してください。
データソースタイプ 対象データベースまたはサービスの実際のタイプ。選択肢は、選択した Func のコネクタ機能に準じます。
データソース ID この接続設定を識別するために使用します。ページの指示に従って設定してください。既存の Func コネクタを再利用する場合は、そのコネクタ ID と一致させ、データベース名や API Key で代用しないでください。
タイトル データソースの一覧およびクエリセレクターでの表示名。
ホストアドレス、ポート データソースの実際の接続先アドレス。データベースまたはサービスの管理者から提供されます。管理コンソールの URL は入力しないでください。
データベース リレーショナルデータベース接続でアクセスするデータベース名。テーブル名ではありません。
ユーザー名、パスワード 対象データベースまたはサービスへのアクセス認証情報。ワークスペースのログインアカウントではありません。

コネクタによってフィールドは異なります。ページに表示される現在のタイプに必要な情報を入力し、完了後に接続をテストして保存します。操作権限を設定する場合は、ワークスペースおよび外部データソースの権限ルールに従います。

クエリで使用する

  1. メトリクス分析またはチャートにデータソースクエリを追加します。
  2. Func 経由で接続したデータソースを選択します。
  3. そのコネクタがサポートするネイティブクエリ文を入力し、クエリを実行するか結果を更新します。
  4. 返却された構造に基づいて表示方法を選択します。

たとえば、MySQL テーブル orders に id、total、status が含まれる場合、支払済み注文をクエリできます。

SELECT id, total FROM orders WHERE status = 'paid' ORDER BY id LIMIT 10

ここでは、選択した Func コネクタがサポートする構文を使用します。クエリテキストを変更して QueryHub に切り替えることはできません。

スクリプト処理が必要な場合

直接クエリで要件を満たせない場合は、Func で対応するタイプのコネクタを作成し、コネクタ ID を介してオブジェクトを取得し、カスタム関数を記述して結果を処理できます。

mysql = DFF.CONN('mysql')

ここでの 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 コネクタに変更する必要はありません。

フィードバック

このページは役に立ちましたか?