すべてのプロダクト
Search
ドキュメントセンター

Data Management:チュートリアル: Dify と NL2SQL を使用して ChatBI アプリケーションを構築し、簡単なデータ分析を実現する

最終更新日:Nov 22, 2025

Data Management (DMS) 上の Dify と自然言語から SQL (NL2SQL) への変換に基づいて構築された ChatBI は、データ分析を再定義します。ChatBI は AI ツールを使用してユーザーの質問を理解し、自然言語で応答します。次に、NL2SQL を使用して自然言語を SQL に変換します。Dify は SQL を実行し、結果を可視化として表示します。このソリューションは、データ分析を組織全体に拡張し、ビジネスの応答を高速化し、データインサイトを簡単に取得するのに役立ちます。

前提条件

ステップ 1: ChatBI に必要な AliyunDMS プラグインをインストールする

  1. DMS コンソール V5.0 にログインします。
  2. 左上隅の 2023-01-28_15-57-17.png アイコンにポインターを移動し、[すべての機能] > [データ+AI] > [Dify] を選択します。

    説明

    DMS コンソールを通常モードで使用する場合は、トップナビゲーションバーで [データ+AI] > [Dify] を選択します。

    image

  3. 対象のワークスペースの名前をクリックします。

  4. 左側のナビゲーションウィンドウで、image > [Studio] を選択します。

  5. 右上隅にある [プラグイン] をクリックし、次に [プラグインのインストール] をクリックします。

  6. インストールソースを選択し、TONGYI および AliyunDMS プラグインをインストールします。

    • [マーケットプレイス] から TONGYI プラグインをインストールします。

    • [DMS プラグイン] から AliyunDMS プラグインをインストールします。

  7. プラグインがインストールされるのを待ちます。

    プラグインリストに AliyunDMS と TONGYI プラグインが表示されると、インストールは成功です。

ステップ 2: AliyunDMS プラグインを権限付与する

  1. AliyunDMS プラグインをクリックし、次に [API キー権限付与設定] をクリックします。

  2. 必要なプラグインのエディションに基づいて [DMS API キー] を設定するかどうかを決定します。

    説明
    • Basic Edition: API キーは不要です。

    • Enterprise Edition: <AccessKeyID>:<AccessKeySecret> フォーマットの DMS API キーが必要です。AccessKey ID と AccessKey Secret は、Alibaba Cloud アカウントに関連付けられている必要があります。

  3. [保存] をクリックします。

    コンポーネントページに [1 権限付与] が表示されると、権限付与は成功です。

ステップ 3: Qwen モデルの API キーを設定する

  1. [Studio] ページで、アカウント名をクリックし、[設定] を選択します。

  2. [モデルプロバイダー] ページで、TONGYI (Qwen) モデルの横にある [設定] をクリックして、その [API キー] を設定します。

    Alibaba Cloud Model Studio から API キー を取得できます。

  3. [保存] をクリックします。

ステップ 4: ChatBI テンプレートを適用する

  1. [Studio] > [すべて] ページで、[アプリテンプレートから作成] をクリックします。

  2. 左側のテンプレートナビゲーションウィンドウで、[DMS Data+AI] をクリックします。

    このカテゴリには、DMS が提供する一連のテンプレートが含まれています。

  3. [ChatBI プラグアンドプレイ (統合版 V6) からアプリを作成] カードにポインターを移動し、[このテンプレートを使用] をクリックします。

  4. 表示されるダイアログボックスで、[作成] をクリックします。

    ページに ChatBI プラグアンドプレイブロックが表示されると、作成は成功です。

ステップ 5: デモを実行し、ChatBI Agent を試す

  1. ChatBI プラグアンドプレイテンプレートをクリックします。

    ChatBI テンプレートには、組み込みのデモデータセットが含まれています。

  2. 右上隅にある [プレビュー] をクリックして、ChatBI Agent を試します。

    Agent に質問してデータをクエリします。

ステップ 6: 独自の ChatBI Agent を設定する

  1. image をクリックし、db_connection_url 変数を編集して、その値を対象データベースの内部またはパブリックエンドポイントに変更します。

    説明

    db_connection_url は、ワークフローで使用されるグローバル環境変数です。demo_db に設定すると、プラグインの組み込みデータセットが自動的に読み込まれます。

    サポートされているデータベースタイプとエンドポイントフォーマットは次のとおりです:

    • MySQL: mysql+pymysql://<user>:<password>@<host>:<port>/<database>

    • PostgreSQL: postgresql+psycopg2://<user>:<password>@<host>:<port>/<database>

    • SQL Server: mssql+pymssql://<user>:<password>@<host>:<port>/<database>

    • Oracle: oracle+oracledb://<user>:<password>@<host>:<port>/<service_name>

    • Clickhouse: clickhouse+native://<user>:<password>@<host>:<port>/<database>

    • MongoDB: mongodb://<user>:<password>@<host>:<port>/<database>"

  2. [保存] をクリックします。

  3. データベースの接続方法に応じて、Dify の出力 IP アドレスまたは内部 IP アドレスをデータベースのホワイトリストに追加します。

    • インターネット経由でデータベースに接続する場合は、Dify のパブリック出力 IP アドレスをデータベースのホワイトリストに追加します。

      Query DIFY Public Egress IP ノードを実行して、特定の IP アドレスを取得します。

    • VPC を介してデータベースに接続する場合は、Dify が存在する VPC の IPv4 CIDR ブロックをデータベースのホワイトリストに追加します。

  4. IP アドレスを追加した後、[プレビュー] をクリックし、対象データベースのデータについて Agent に質問します。

AliyunDMS Enterprise Edition および Basic Edition プラグインの機能

プラグイン

説明

Enterprise Edition

Basic Edition

DMS NL2SQL (Basic Edition)

組み込みの NL2SQL アルゴリズム (Agile Edition)。アジャイルな自然言語から SQL へのアルゴリズムは、SQL 結果のリアルタイムストリーミング出力を提供します。

DMS NL2SQL (Enterprise Edition)

以下の特徴を持つ組み込みの NL2SQL アルゴリズム (Enterprise Edition):

  • ナレッジベース設定のためのシンプルで直感的なインターフェイス。

  • 正確なクエリ変換のための高度な自然言語から SQL へのアルゴリズム。

  • データベースアカウントとパスワードを設定する必要はありません。

×

DMS SQL Executor (Basic Edition)

データベースに接続して SQL を実行するには、データベースアカウントとパスワードが必要です。MySQL、PostgreSQL、SQL Server、Oracle、ClickHouse、および MongoDB データベースへの接続をサポートします。

DMS SQL Executor (Enterprise Edition)

  • パスワード不要の認証メカニズムを使用します。ワークフローでデータベースアカウントとパスワードを設定する必要がなく、アカウントとパスワードの漏洩を効果的に防ぎます。

  • 30 を超える主要なデータソースへの接続をサポートします。

  • 強力なエンタープライズグレードの管理および制御機能:

    • きめ細かなリソースアクセス権限管理。

    • 操作の完全な監査証跡。

    • 厳格な SQL コンプライアンスチェック。

×

DMS データ可視化

SQL 実行結果を ECharts チャートに変換します。縦棒グラフ、折れ線グラフ、円グラフ、およびテーブルをサポートします。

AliyunDMS Enterprise Edition プラグインを使用する

AliyunDMS Enterprise Edition プラグインを使用するには、ステップ 4: ChatBI テンプレートを適用する[ChatBI プラグアンドプレイ (Enterprise Edition V6)] テンプレートを選択してアプリケーションを作成します。

注意

ChatBI Enterprise Edition テンプレートを使用する前に、AliyunDMS プラグインの権限付与に使用される DMS API KEY が、DMS へのログインに使用する Alibaba Cloud アカウントに属していることを確認してください。

Enterprise プラグインの設定

DMS NL2SQL

このプラグインを設定する前に、対象のデータベースインスタンスを DMS に追加し、インスタンスのセキュリティホスティングを有効にしてください。

image

パラメーターの説明:

  • 質問: SQL に変換したい自然言語を入力します。

  • DMS 登録済みデータベース: DMS でホストされているデータベースのタイプと名前を選択します。

  • DMS API KEY: プラグインを呼び出すために必要な DMS API KEY。ここにキーを入力すると、プラグインの権限付与時に指定したキーが上書きされます。

  • ドメイン知識: ビジネスシナリオに固有のドメイン知識を入力して、NL2SQL の精度を向上させます。

  • モデル: SQL を生成するための大規模言語モデル (LLM) を選択します。デフォルトでは、DMS-AI/XiYan-SQL-32B が使用されます。適応モデルを選択すると、NL2SQL アルゴリズムは質問の複雑さに応じて適切なモデルを自動的に選択します。

  • カスタムモデル: 非公開でデプロイされたモデルの ID。

  • 推論の労力: NL2SQL アルゴリズムの推論の深さ。深さが大きいほど、SQL の生成に必要な時間が増加します。オプション: 標準 (推奨)、および エキスパート。デフォルトでは、バランスの取れたパフォーマンスのために 標準 (推奨) が使用されます。

DMS SQL Executor

image

パラメーターの説明:

  • SQL: 実行する SQL 文。

  • DMS 登録済みデータベース: DMS でホストされているデータベースのタイプと名前を選択します。

  • DMS API KEY: プラグインを呼び出すために必要な DMS API KEY。ここにキーを入力すると、プラグインの権限付与時に指定したキーが上書きされます。

  • Dify のリージョン ID: Dify インスタンスが配置されているリージョンを選択します。

  • 出力フォーマット: Markdown または JSON を選択します。デフォルトでは、Markdown が使用されます。

  • タイムアウト (秒): SQL 実行のタイムアウト期間。