テキストプロンプトから SQL 変換を生成する
SQL アシスタントを使用すると、実現したい変換を記述するテキスト プロンプトから SQL 変換を生成できます。たとえば、列を選択したり、テーブルを結合したり、レコードをフィルタリングしたりできます。
クエリは、テキスト プロンプトとデータセット情報に基づいて生成 AI を使用し、ターゲット データ プラットフォームの構文を使用して生成されます。
テキスト プロンプトとデータセット情報は、サード パーティの生成 AI (GenAI) モデルに送信され、SQL コードが生成されます。この情報は顧客データとして扱われ、AWS Bedrock 上の Qlik Cloud または GenAI モデルのトレーニングには使用されません。詳細は、共有される情報をご覧ください。
有無
GenAI モデルは、Qlik Cloud テナントと同じリージョンの AWS Bedrock Anthropic でホストされます。SQL アシスタントは、次の Qlik 地域のテナントで利用できます。
-
米国東部 (北バージニア)
-
アジア太平洋 (シドニー)
-
ヨーロッパ(フランクフルト)
-
ヨーロッパ (アイルランド)
SQL アシスタントは、Administration のテナント管理者によってテナント レベルで有効にする必要があります。
-
[設定] > [機能コントロール] で、生成 AI ベースの SQL アシスタントを有効にします。
SQL アシスタントは Qlik Cloud Government では使用できません。
SQL アシスタントを使用して SQL クエリを生成する
SQL アシスタントは、データの変換タスクの SQL 変換で使用できます。SQL 変換に少なくとも 1 つのデータセットを追加する必要があります。
SQL 変換の詳細については、「SQL 変換の追加」を参照してください。
-
[SQL アシスタント] をクリックします。
SQL アシスタントはテキスト プロンプトとともに開きます。
-
プロンプトに、実現したい変換の説明を入力します。
例: 売上高が 500 万を超えるすべての顧客をリストします。各顧客の総売上高と総機会数を含めます。
ヒント メモプロンプトで列を参照する場合は、選択したデータセットにその列が存在することを確認してください。 -
[生成] をクリックします。
-
SQL に表示される生成された SQL クエリを確認します。
[] または [] をクリックして結果を評価できます。これにより、Qlik は SQL アシスタントのエクスペリエンスを向上させることができます。
生成された変換が正確でないと思われる場合、または何かを変更する場合は、[プロンプトの編集] をクリックし、プロンプトに変更を加えて新しいクエリを生成します。
-
結果の SQL クエリに満足したら、[適用] をクリックして SQL 変換にコピーします。
-
[パラメーターの抽出] をクリックします。
-
[テーブルの説明] をクリックします。
-
結果のデータセットを結果で確認します。[データの表示] をクリックして、結果のデータサンプルを表示することもできます。
-
結果に満足したら、[OK] をクリックして SQL 変換を保存し、適用します。
共有される情報
次の情報は、クエリを生成するために生成 AI モデルと共有されます。
-
テキスト プロンプト
-
クエリをターゲット データ プラットフォームに適応させるための追加の生成手順。
例: Snowflake 互換の構文で SQL クエリを生成する -
データセット名と説明。
-
列名、データ型、サイズ。
-
主キー列 (一意の識別子)。
-
データセット間の関係
例: 「order_detail」は、「order_id」キーを使用して「order」に添付されます。
使用制限
SQL アシスタントには次の使用制限が適用されます。
-
1 回の呼び出し: 18,000 個のトークン。
この値を超える場合は、不要なデータセットを削除するか、プロンプトでより簡単な説明を入力してください。
-
1 日あたり (テナントあたり): 100 万個のトークン
-
1 月あたり (テナントあたり): 1,000 万個のトークン
使用量を計算する場合、トークンは 6 文字を表します。GenAI モデルへの呼び出しは、次のもので構成されます。
-
SQL クエリを生成するための一般的な手順。この部分は固定サイズです。
-
テキスト プロンプト。
-
データセット内のメタデータのスキーマ表現。多数のデータセットを選択した場合、この部分は非常に大きくなる可能性があります。
制限事項
-
増分 SQL 生成はサポートされていません。詳細は、SQL 変換の追加をご覧ください。
-
現在のテーブル内のデータのみを変換できます。以前のテーブル、変更テーブル、ライブ ビューはサポートされていません。テーブルとビューの詳細については、クラウド データ ウェアハウスのデータセット アーキテクチャ を参照してください。
-
プラットフォームに依存しない関数は使用されません。例: $CONCAT)
ベスト プラクティス
-
関連する列の名前が異なる場合は、ソース データセットのデータ モデルに必要なすべてのリレーションシップが含まれていることを確認します。一般に、GenAI モデルは、定義されたリレーションシップなしに同じ名前の列を関連付けます。
例: Orders の ShipVia 列を Shippers の shipper_id 列に関連付ける必要がある場合、SQL 変換を生成する前にデータ モデルでリレーションシップを作成する必要があります。
-
変換に必要なソース データセットのみを選択します。ソース データが古くなると、不正確な結果や無関係な結果が発生し、トークンの使用量が増える可能性があります。
-
名前がわかりにくい列やデータセットを識別するために、プロンプトに説明を追加できます。
例: cus_ct には顧客データセットが含まれます。