この記事では、Genie 空間で SQL 命令の例を記述するときにパラメーターを使用する方法について説明します。
パラメーターを使用する理由
パラメーターを使用すると、実行時に置き換えられる特定の値のプレースホルダーを含むクエリの例を記述できます。 Genie はパラメーターを使用して、ユーザーの質問から特定の入力を受け取り、サンプル クエリの構造を再利用して、検証済みの回答を信頼できる資産として提供できます。 たとえば、前の SQL クエリを調整して、o.forecastcategory 値でフィルター処理するパラメーターを含めることができます。これにより、クエリでは、さまざまな予測カテゴリでタグ付けされた営業案件に関する質問に対処できます。 パラメーター化されたクエリを使用して信頼できる資産としてラベル付けされた応答を生成する方法の詳細については、「AI/BI Genie スペースで信頼された資産を使用する」を参照してください。
次のクエリ例では、リージョン別に開いているパイプライン値の販売機会の合計を計算します。
o.forecastcategory 値のパラメーターが含まれています。 パラメーターは、名前付きパラメーター マーカーと同じ構文を使用します。 Genie 空間でパラメーターを使用する方法の詳細については、「クエリ パラメーターを操作する 」および「名前付きパラメーター マーカー 」を参照してください。
-- 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;
クエリにパラメーターを追加するには、次の操作を行います。
パラメーターをクエリに配置する場所にカーソルを配置します。
新しいパラメーターを挿入するには、[パラメーターの追加] をクリックします。
これは、既定の名前の
parameterを用いて新しいパラメーターを作成します。 既定の名前を変更するには、クエリ エディターでその名前を置き換えます。 パラメーターを追加するには、コロンを入力し、その後にパラメーター名 (:parameter_name) をエディターに入力します。
クエリ パラメーターを編集する。
パラメーターを編集するには、次の操作を行います。
パラメーター名の横にある
をクリックします。
[パラメーターの詳細] ダイアログが表示され、次の構成オプションが記載されます。キーワード: クエリ内のパラメーターを表すキーワード。 キーワードは、クエリ内のテキストを直接更新することによってのみ変更できます。
表示名: Genie がチャット エクスペリエンスで使用する人間が判読できる名前。 Genie は、パラメーター化されたクエリを使用して応答を生成するときに、応答に表示名と関連付けられた値を含めます。
型: サポートされている型には、文字列、日付、日付と時刻、および 数値があります。
- 既定の型は String です。
- Numeric データ型では、Decimal と Integer の間を指定できます。 既定の数値型は Decimal です。
注
実際の入力値が選択したパラメーター型と一致しない場合、Genie は入力値を正しくない型として扱い、結果が不正確になることがあります。
ダイアログを閉じるには、UI の他の部分をクリックします。
パラメーター化されたクエリ応答
応答でパラメーターの正確なテキストが使用されると、応答は信頼済みとしてマークされます。 つまり、Genie は、空間のコンテキストに基づいて、ユーザーの質問が質問またはクエリの例の意図と一致したことを意味します。
信頼された ラベルを使用すると、Genie の応答が検証済みの SQL クエリに基づいて行われることがわかります。 生成された SQL 値と、応答で使用されるパラメーター値を確認できます。