透過使用主題，你可以提供大型主題導向指令，幫助 Fabric 資料代理產生 SQL。 資料代理不會隨每個問題傳送所有主題內容，而是搜尋內容，並提供與問題相關的部分給 NL2SQL 工具。
當你有大量可依主題組織的指引時，才使用主題。 例如，你可以建立銷售、庫存和客戶保留的區塊，然後提供適用於每個主題的業務定義和查詢指引。
Note
主題目前處於預覽階段，僅在 預覽執行時提供 SQL 資料來源。
主題與資料來源指示
主題與資料來源指示為查詢產生工具提供不同類型的上下文：
| Configuration | 資料代理如何使用它 | 何時使用它 |
|---|---|---|
| 主題 | 資料代理會搜尋主題內容，並將相關區段傳送至 NL2SQL。 | 用於較長的指令，這些指令可分成不同主題，而且只有當問題與特定主題相關時才需要用到。 |
| 數據源指示 | 資料代理每次使用資料來源時，都會將指令傳送給查詢產生工具。 | 用於規則與上下文，適用於所有寄送給資料來源的問題。 |
例如，如果每個查詢都必須使用該定義，則在資料來源指令中加入全組織的財政年度定義。 如果該指引只在與客戶留存相關的問題中才需要，請將計算客戶留存的詳細指引放在客戶留存主題中。
你可以將主題和資料來源指示一起使用。 當題目需要兩者時，NL2SQL 會接收資料來源指示及相關主題內容。
新增主題導向指示
你可以為每個支援的 SQL 資料來源新增最多 100 萬字元的主題內容。
打開你的 Fabric 資料代理程式，選擇一個 SQL 資料來源。
在資料來源設定中，開啟 資料來源主題。
輸入你以主題為基礎的指示。 使用Markdown標題將內容組織成不同主題。
儲存資料代理設定。
測驗題目會對應到個別主題，也可以是需要多題的題目。
主題內容結構
使用描述性的 Markdown 標題，讓資料代理能找到問題的正確區塊。 將該主題的所有指導資料放在相應的標題下。
## Customer retention
Use the CustomerSubscription table for retention questions.
### Retained customers
A customer is retained when IsActive is 1 and RenewalDate is after the reporting date.
### Churn rate
Calculate churn rate as the number of subscriptions canceled during the period divided by the number of active subscriptions at the start of the period.
## Inventory
Use the InventorySnapshot table for current inventory questions.
### Low-stock products
A product is low in stock when QuantityOnHand is less than ReorderPoint.
當使用者詢問流失時，資料代理可以取得客戶留存指引，而不必將無關的庫存指引送至 NL2SQL。
在執行步驟中檢閱已擷取的主題
測試完問題後，請檢視 開放資料來源主題 執行步驟，看看資料代理選擇了哪些主題內容。 輸入會顯示航向路徑及選擇主題的原因。 輸出顯示提供給 NL2SQL 的指令。
最佳做法
- 使用與人們提問中使用術語相符的標題。
- 保持每個主題自成一體。 在同一主題標題下包含相關的商業定義、表格、欄位、關係、篩選條件及計算規則。
- 使用副標題來區分廣泛主題中的相關情境。
- 在資料來源說明中加入必須適用於每個 SQL 問題的規則，而不是在多個主題重複使用。
- 避免不同主題與資料來源指引之間出現重複或互相矛盾的內容。
- 測驗直接問題、替代措辭，以及需要涵蓋多個主題內容的題目。