從文字提示產生 SQL 轉換
您可以使用 SQL 助理從文字提示產生 SQL 轉換，您可在此描述要達到的轉換。例如，您可以選取欄、聯結表格或篩選記錄。
會根據文字提示和資料集資訊，使用生成式 AI 產生查詢，並使用目標資料平台的語法。
文字提示和資料集資訊會傳送至第三方生成式 AI (GenAI) 模型，以產生 SQL 代碼。資訊會被視為客戶資料，不會用來訓練 Qlik Cloud 或 AWS Bedrock 上的 GenAI 模型。如需詳細資訊，請參閱分享的資訊。
可用性
GenAI 模型在與 Qlik Cloud 租用戶相同的區域，託管於 AWS Bedrock Anthropic。SQL 助理可用於下列 Qlik 區域的租用戶：
-
美國東部 (北維吉尼亞州)
-
亞太地區 (雪梨)
-
歐洲 (法蘭克福)
-
歐洲 (愛爾蘭)
必須由租用戶管理員在 管理 中於租用戶層級啟用 SQL 助理。
-
在設定 > 功能控制中啟用基於生成式 AI 的 SQL 助理。
SQL 助理無法用於 Qlik Cloud 政府。
透過 SQL 助理產生 SQL 查詢
SQL 助理可用於轉換資料任務中的 SQL 轉換。您必須已將至少一個資料集新增至 SQL 轉換。
如需更多關於 SQL 轉換的資訊，請參閱 新增 SQL 轉換。
-
按一下 SQL 助理。
就會開啟 SQL 助理，內含文字提示。
-
在提示中針對您要達成的轉換輸入描述。
範例：列出銷售額超過 5 百萬的所有客戶。包括每個客戶的總銷售額和總商機。
提示備註若您在提示中參考欄，請確認這存在於所選資料集。 -
按一下產生。
-
檢閱產生的 SQL 查詢，這會顯示在 SQL 中。
您可以按一下
或 
，以評價結果。這將可協助 Qlik 改善 SQL 助理的體驗。若產生的轉換看起來不準確，或者您想要變更內容，按一下編輯提示，以對提示進行變更並產生新的查詢。
-
若您滿意產生的 SQL 查詢，按一下套用以複製到 SQL 轉換。
-
按一下擷取參數。
-
按一下描述表格。
-
在結果中查看產生的資料集。您也可以按一下檢視資料以檢視結果的資料樣本。
-
若您滿意結果，按一下「確定」，以儲存並套用 SQL 轉換。
分享的資訊
會與生成式 AI 模型分享下列資訊，以產生查詢。
-
文字提示
-
其他產生說明用來根據目標資料平台調整查詢。
範例：以 Snowflake 相容語法產生 SQL 查詢 -
資料集名稱和描述。
-
欄名稱、資料類型和大小。
-
主要金鑰欄 (唯一識別碼)。
-
資料集之間的關係
範例：「order_detail」附加至使用「order_id」金鑰的「order」。
使用限制
下列使用限制適用於 SQL 助理。
-
單一呼叫：18000 個 Token。
若超過此數目，移除不需要的資料集，或在提示中提供比較不複雜的描述。
-
每日 (每個租用戶)：1 百萬個 Token
-
每月 (每個租用戶)：1 千萬個 Token
計算使用量時，一個 Token 代表 6 個字元。對 GenAI 模型的呼叫包括：
-
用來產生 SQL 查詢的一般說明。此部分是固定大小。
-
文字提示。
-
資料集的中繼資料的結構描述呈現。若您已選取大量資料集，此部分可能非常龐大。
限制
-
不支援增量 SQL 產生。如需詳細資訊，請參閱新增 SQL 轉換。
-
您只能在目前的表格中轉換資料。不支援之前表格、變更表格和即時檢視。如需關於表格和檢視的詳細資訊，請參閱 雲端資料倉庫中的資料集架構。
-
不使用平台獨立函數，例如 $CONCAT)。
最佳做法
-
若相關的欄有不同的名稱，確認來源資料集中的資料模型包括所有必需關係。一般而言，GenAI 模型將會關聯名稱相同的欄，而沒有定義的關係。
範例：若 Orders 中的 ShipVia 欄應關聯至 Shippers 中的 shipper_id 欄，您應先在資料模型中建立關係，再產生 SQL 轉換。
-
僅選取轉換所需的來源資料集。過時的來源資料可能會造成不正確或不相關的結果，並增加 Token 使用量。
-
您可以在提示中新增描述，以識別名稱不明顯的欄或資料集。
範例：cus_ct 包含客戶資料集。