メインコンテンツまでスキップ

SQL クエリでパラメーターを使用する

この記事では、SQL Genieスペースに例 命令を書くときにパラメーターを使用する方法について説明します。

なぜパラメーターを使用するのですか?​

パラメーターを使用すると、実行時に置き換えられる特定の値のプレースホルダーを使用してクエリの例を記述できます。 パラメーターを使用すると、 Genie ユーザーの質問から特定の入力を受け取り、サンプル クエリの構造を再利用して、検証済みの回答を信頼できる資産として提供できます。 たとえば、前の SQL クエリを調整して、 o.forecastcategory 値でフィルター処理するパラメーターを含めると、クエリでさまざまな予測カテゴリにタグ付けされた営業案件に関する質問に対処できます。 パラメーター化されたクエリを使用して、信頼できる資産としてラベル付けされた応答を生成する方法の詳細については、「AI/BI Genie スペースで信頼できる資産を使用する」を参照してください。

次のクエリ例では、地域別のオープン パイプライン値の合計販売案件を計算します。これには、 o.forecastcategory 値のパラメーターが含まれています。パラメーター は、名前付きパラメーター マーカーと同じ構文を使用します。 Genieスペースでパラメーターを使用する方法の詳細については、「クエリ パラメーターの操作」および「名前付きパラメーター マーカー」を参照してください。

SQL
-- Return our current pipeline at a stage by region.
-- Opportunities are only considered pipelines if they are tagged as such.
  SELECT
    a.region__c AS `Region`,
    sum(o.amount) AS `Open Pipeline`
  FROM
    sales.crm.opportunity o
    JOIN sales.crm.accounts a ON o.accountid = a.id
  WHERE
    o.forecastcategory = :forecast_category AND
    o.stagename NOT ILIKE '%closed%'
  GROUP BY ALL;

クエリにパラメーターを追加するには:

  1. クエリ内のパラメーターを配置する場所にカーソルを置きます。

  2. パラメーターを追加 をクリックし、新しいパラメーターを追加します。

    これにより、デフォルト名が parameterの新しいパラメーターが作成されます。 デフォルト名を変更するには、クエリエディタで名前を置き換えます。エディターにコロンの後にパラメーター名 (:parameter_name) を入力して、パラメーターを追加することもできます。

クエリ パラメーターの編集​

パラメーターを編集するには、次の手順を実行します。

  1. パラメーター名の横にある 歯車アイコン をクリックします。 パラメーターの詳細 ダイアログが表示され、次の構成オプションが表示されます。

    • キーワード : クエリ内のパラメーターを表すキーワード。 キーワードは、クエリ内のテキストを直接更新することによってのみ変更できます。

    • 表示名 : Genie がチャット エクスペリエンスで使用する人間が読める名前。Genie がパラメーター化されたクエリを使用して応答を生成すると、表示名と関連する値が応答に含まれます。

    • 型 : サポートされている型には、 文字列 、 日付 、 日付と時刻 、 数値 があります。

      • デフォルト型は 文字列 です。

      • 数値 データ型では、 10 進数 と 整数 のどちらかを指定できます。デフォルトの数値型は 10 進数 です。

注記

実際の入力値が選択したパラメーターの種類と一致しない場合、 Genie は入力値を誤った種類として扱い、結果が不正確になる可能性があります。

  1. UI の別の部分をクリックして、ダイアログを閉じます。

パラメーター化されたクエリ応答​

パラメーターの正確なテキストが応答で使用されると、応答は信頼済みとしてマークされます。これは、Genie がスペースのコンテキストに基づいて、ユーザーの質問が例の質問またはクエリの意図と一致したことを特定したことを意味します。

Trusted ラベルは、Space のユーザーに、Genie の応答が吟味された SQL クエリに基づいていることを知らせます。レスポンスで使用される生成された SQL 値とパラメータ値を確認できます。

に最終更新