SQLクエリを使用したデータ資産の作成

接続からのデータの動的ビューをプロジェクトに追加するには、特定のデータを選択する SQL クエリを作成します。

一部の機能は、すべてのプランで利用できるわけではありません。 IBM Knowledge Catalog レガシー・サービス・プランおよび IBM watsonx.data intelligence プランを参照。

ダイナミック・ビューを追加するには

  1. プロジェクトページで「アセット」タブをクリックし、「新規アセット」＞「データのダイナミックビューを作成」をクリックします。

  2. データ選択方法はSQLクエリを書くを選択したままにしてください。

  3. 名前と、任意で説明を入力する。 名前または説明に使用できる最大文字数は、それぞれ100文字です。 また、必要に応じて検索用のタグを追加することもできる。

  4. 既存の接続資産をデータのソースとして選択します。 接続はSQLクエリーをサポートしなければならない。

  5. SQL クエリー作成します。 SQL クエリー自分で作成することもできるし、プレーンテキストのクエリー入力し、利用可能なモデルの1つを使ってSQLに変換することもできる。

    プレーンテキストのクエリで動作するオプションは、技術プレビュー機能です。 技術プレビュー機能は、開発およびテストに使用できますが、本番環境での使用は想定していません。

    プレーンテキストのクエリを使用するには、プロジェクトで自然言語クエリを有効にする必要がありますが、これは1回限りの操作です。 詳細は、 データ・インテリジェンス・ツールの設定を参照。

    より正確で文脈に応じたSQL出力を得るには、 クエリーサンプルをアップロードすることでモデルに追加の文脈を提供できます。 詳細については、 「テキストからSQLへの変換における追加コンテキストの提供」 を参照してください。

    覚えておいてください： 生成されたクエリは実行ごとに同一であるとは保証されないため、差異が生じる可能性があります。

    1. SQL タブの自由形式テキストエリアにクエリーを入力し、利用可能なモデル（モデルアイコンを選択）のいずれかを選択して ステートメントを生成します。

      ヒント: は、テキストをSQLに変換 meta-llama/llama-3-3-70b model するためのプロンプト指示に従う能力に優れており、したがって モデル Granite と比較してより正確な結果を提供する可能性があります。

      クエリー、以下の例のようになります：「支払いタイプを持つすべてのトランザクションを取得する"、または "条件と患者を結合し、最初の100行を取得する"

      クエリー入力する際、モデルへのカスタムプロンプトとなる追加情報を提供することができます。 その追加情報の前には、免責事項 Note: 。 次に例を示します。

      Show records in customer_spend where the spending score is less than 50 and age is between 30 and 50.
Note: include the relevant columns and do not include all the columns

    2. 生成されたSQL ステートメント SQLエリアにコピーする。 必要に応じてSQL クエリー更新することができます。

    また、動的ビューのデータを選択するSQL クエリー直接入力することもできます。

    例:

    SELECT name, address, client_id FROM BANK1.BANK_CLIENTS WHERE account_type='CHECKING' AND online_access='YES'

    このクエリは、当座預金口座にオンラインでアクセスできる顧客の名前、住所、顧客 ID を含む列を含むビューを作成します。 ソースはBANK_CLIENTSデータベース・テーブルです。

  6. オプション： データ製品を生成するためにこの資産作成する場合は、プロジェクトからパラメータセットを選択して、カスタマイズ可能なクエリー作成できます。

    パラメータセットで作業する場合は、各パラメータをデータ値で接続します。 クエリー内のすべてのパラメータ名は、パラメータセット内の対応する名前と一致しなければならない。 パラメータを指定するには、次の構文を使う：'#<パラメータ名>#'.

    例:

    SELECT * FROM PUBLIC.COURSES WHERE PUBLIC.COURSES.SEMESTER='#TERM#' AND PUBLIC.COURSES.COURSE_NAME='#COURSE#'

  7. オプション： クエリーテストしてSQLを検証します。 そうでない場合は、 Createをクリックした時点でクエリー検証されます。 アセットを作成する前に、SQLエラーを修正する必要があります。

アセットがプロジェクトのアセットページに追加されます。 動的ビューを他のデータ資産と区別するため、該当する資産には参照データアイコン（参照データ資産）が付与されます。プロジェクトでフォルダ機能が有効化されている場合、動的ビューは常にルートフォルダ内に作成されますが、動的ビューを整理するために任意のサブディレクトリへ移動することが可能です。

次のステップ