在 SQL 查詢中使用參數

本文說明如何在 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;

若要將參數新增至查詢：

1. 將游標放在您想要在查詢中放置 參數的位置。

2. 按一下 新增參數 以插入新的參數。

   這會建立具有預設名稱的新參數，parameter。 若要變更預設名稱，請在查詢編輯器中取代它。 您也可以在編輯器中輸入冒號並接著輸入參數名稱（:parameter_name）以新增參數。

編輯查詢參數

若要編輯參數，請執行下列動作：

1. 按兩下 在參數名稱旁邊。 參數詳細資訊 對話框隨即出現，並包含下列配置選項：

   • Keyword：代表查詢中參數的 關鍵詞。 只能藉由直接更新查詢中的文字來變更 關鍵詞。

   • 顯示名稱：Genie 在聊天體驗中使用的人類易讀的名稱。 當 Genie 使用參數化查詢產生回應時，它會在回應中包含顯示名稱和相關聯的值。

   • 類型：支援的型別包括 String、Date、日期和時間，以及 Numeric。

     • 預設類型為 String。
     • Numeric 資料類型可讓您在 Decimal 與 Integer之間指定 。 預設數值類型為 十進位。

     備註

     如果實際輸入值不符合選取的參數類型，Genie 會將輸入值視為不正確的類型，這可能會導致結果不正確。

2. 按兩下UI的另一部分以關閉對話框。

參數化查詢回應

當回應中使用參數的確切文字時，回應會標示為受信任。 這表示 Genie 會根據空間的內容識別出使用者問題與範例問題或查詢的意圖相符。

信任 標籤可讓使用者知道 Genie 的回應是以經過審查的 SQL 查詢為基礎。 他們可以看到回應中使用的產生的 SQL 和參數值。