本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 使用 Amazon Quick Sight 主題
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
*主題*是一或多個資料集的集合，代表您的商業使用者可以提出問題的主題領域。
透過 Quick Sight 自動化資料準備，您可以取得採用 ML 技術的協助，協助您建立與最終使用者相關的主題。第一個程序從自動欄位選取和分類開始，過程如下：
+ 根據預設，自動化資料準備會選擇要包含的少量欄位，以建立焦點資料空間供讀者探索。
+ 自動化資料準備會選取您在報告和儀表板等其他資產中使用的欄位。
+ 自動化資料準備也會從啟用主題的任何相關分析匯入任何其他欄位。
+ 它識別日期、維度和量值，以學習如何在答案中使用欄位。
這組自動選取的欄位可協助作者快速開始自然語言分析。作者可以根據需要使用**包含**切換開關，永遠排除欄位，或包含其他欄位。
接著，自動化資料準備會透過自動標記欄位和識別同義詞來繼續程序。自動化資料準備會使用常用詞彙，以易記的名稱和同義詞更新欄位名稱。例如，`SLS_PERSON` 欄位可能會重新命名為 `Sales person`，並指定同義字，包括：`salesman`、`saleswoman`、agent 和 `sales representative`。雖然您可以讓自動化資料準備執行大部分的工作，但值得檢閱欄位、名稱和同義詞，以進一步為您的最終使用者自訂它們。例如，如果使用者在輕鬆交談中將銷售人員稱為 "rep" 或 "dealer"，則您可以透過將 `rep` 和 `dealer` 新增至 `SLS_PERSON` 的同義字來實現支援。
最後，自動化資料準備會透過取樣其資料並檢查作者在分析期間套用的格式，來偵測每個欄位的語意類型。自動化資料準備會自動更新欄位組態，設定用於每個欄位的值格式。因此，問題的答案對於日期、貨幣、識別符、布林值、人員等會以預期格式提供。
若要進一步了解如何使用主題，請繼續前往本章中的下列章節。
**Topics**
+ [導覽主題](navigating-topics.md)
+ [建立 Quick Sight 主題](topics-create.md)
+ [主題工作空間](topics-interface.md)
+ [在 Quick Sight 主題中使用資料集](topics-data.md)
+ [讓 Quick Sight natural-language-friendly](topics-natural-language.md)
+ [共用 Quick Sight 主題](topics-sharing.md)
+ [管理 Amazon Quick Sight 主題許可](topics-sharing-permissions.md)
+ [檢閱 Quick Sight 主題效能和意見回饋](topics-performance.md)
+ [重新整理 Quick Sight 主題索引](topics-index.md)
+ [使用 Amazon Quick Sight APIs 處理 Quick Sight 主題](topics-cli.md)
# 導覽主題
在 Quick Sight 中，有一種以上的方法來建立和管理主題。您可以在 Amazon Quick 首頁或「開始」頁面上開始。您也可以從分析內部開始。
**Topics**
+ [從 Amazon Quick 首頁](starting-from-home.md)
+ [從 Amazon Quick Sight 分析](starting-from-sheets.md)
+ [在 Amazon Quick Sight 分析中瀏覽問題](starting-from-questions-on-sheets.md)
# 從 Amazon Quick 首頁
從快速入門頁面，您可以在左側導覽窗格中選取主題來建立和管理**主題**。快速提供建立主題的引導式工作流程。您可以隨時退出引導式工作流程和返回，從而不打斷您的工作。
當您建立主題時，您的商業使用者可以提出有關該主題的問題。您可以隨時開啟某個主題來變更它，或檢視它的效能。
若要開啟主題，請選擇相應的主題名稱。
若要返回所有主題清單，請選擇主題工作空間左側的**所有主題**。
# 從 Amazon Quick Sight 分析
若要從 Amazon Quick Sight 分析開始，請開啟您要搭配自動化資料準備 使用的分析。
若要開啟或建立主題，請選擇頂端導覽列中的主題圖示。
您可以隨時開啟某個主題來變更它，或檢視它的效能。
若要從分析開啟主題，請在頂端導覽列中選擇相應主題名稱 (如果尚未顯示)。然後選取頂端導覽列上的垂直省略符號圖示 (` ⋮ `)。
若要檢視相應主題的資訊，請選取**關於主題**。
若要檢視主題中包含的資料欄位，請在索引標籤清單中選取**資料欄位**。
# 在 Amazon Quick Sight 分析中瀏覽問題
透過導覽分析中某個主題的問題和答案，您可以了解該主題的使用情況。您可以據此做出必要調整。
從已連結至主題的分析中開始，選取頂端導覽列上的搜尋列，然後輸入問題。答案會顯示在主題畫面上，其中也會顯示可在分析中使用主題的所有可用選項。
+ 若要變更答案中顯示的視覺化效果類型，請選取類型圖示 (類似長條圖)。
+ 若要檢視改善建議，請選取對話氣泡，如果您有未檢視的建議，氣泡會反白顯示。
+ 若要檢視與問題相關的洞見，請選取燈泡圖示。
+ 若要從 Pinboard 中新增或移除問題，請切換**新增至 Pinboard** 或**從 Pinboard 中移除**圖示。您可以從頂端導覽列中選取 Pinboard 圖示來檢視相應 Pinboard。
+ 若要檢視有關此主題的資訊，請選取帶有圓圈的小寫字母 *i* (` ![\[alt text not found\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/images/status-info.png) `)。
+ 選取省略符號選單 (` … `) 以執行下列其中一項：
+ **匯出至 CSV**：匯出所選視覺化效果中顯示的資料。
+ **複製請求 ID**：擷取此程序的請求 ID 以進行疑難排解。Amazon Quick Sight 會產生英數字元請求 ID，以唯一識別每個程序。
+ **共用此視覺化效果**：安全地共用視覺化效果中使用的主題的 URL。
+ **答案明細**：檢視答案的詳細解釋。
在主題畫面的底部，您可以透過選取**編輯問題變體**來新增或變更問題的變體。同樣在底部，當您對問題和答案感到滿意時，可以透過選擇**標示為已檢閱**將主題標記為已檢閱。或者，如果您發現先前檢閱的主題需要進一步檢閱，請選擇**取消表示為已檢閱**。
您可以隨時開啟某個主題來變更它，或檢視它的效能。若要直接使用主題的設定 (例如包含哪些欄位或具有哪些同義字)，請使用**主題**頁面。
**開啟連結到分析的主題**
1. 在左側導覽窗格中選取**主題**，從快速開始頁面開啟 Amazon Quick Sight **主題**頁面。
若要保持分析開啟，可以在新的瀏覽器索引標籤或視窗中開啟**主題**頁面。
1. 若要開啟主題，請選擇相應的主題名稱。如果您最近導覽離開分析頁面，名稱可能仍會顯示在畫面頂端的搜尋列中。
1. 若要返回所有主題清單，請選擇主題工作空間左側的**所有主題**。
# 建立 Quick Sight 主題
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
若要針對資料集開啟問題，您必須建立主題。Quick Sight 提供建立主題的引導式工作流程。您可以隨時退出引導式工作流程和返回，從而不打斷您的工作。
有兩種方法可以建立主題：
+ 透過選取資料集來建立主題。當您在 Quick Sight 中建立主題時，您可以將多個資料集新增至它們，也可以在分析中啟用主題。
+ 透過分析建立主題。當您在分析中建立主題，或將現有主題連結至分析時，自動化資料準備會從您分析資料的方式中學習，並自動將其套用至您的主題。
與 Quick Readers 共用主題後，他們會使用它在搜尋列中提出問題，您可以查看主題執行情況的摘要。您也可以查看使用者要求的所有項目清單及其回應程度，以及您已驗證的任何答案。檢閱意見回饋非常重要，這樣您的商業使用者可以繼續獲得其問題的正確視覺化效果和答案。
## 建立主題
透過以下程序建立主題。
**若要建立主題**
1. 在快速首頁上，選擇**主題**。
1. 在開啟**的主題**頁面上，選擇右上角的**建立主題**。
1. 在開啟的**建立主題**頁面上，執行下列動作：
1. 針對**主題名稱**，輸入主題的描述性名稱。
業務使用者透過該名稱識別主題並使用它來提出問題。
1. 針對**描述**，請輸入主題的描述。
使用者可以使用此描述詳細了解該主題。
1. 選擇**繼續**。
1. 在開啟的**將資料新增至主題**頁面上，選擇以下選項之一：
+ 若要新增您擁有或有權存取的一個或多個資料集，請選擇**資料集**，然後選取要新增的一個或多個資料集。
+ 若要從已建立或已與您共用的儀表板新增資料集，**請從儀表板中選擇資料集**，然後從清單中選擇儀表板。
1. 選擇**新增資料**。
主題已建立，並且該主題的頁面將開啟。下一步是設定主題中繼資料，使其易於讀者理解。如需詳細資訊，請參閱[讓 Quick Sight natural-language-friendly](topics-natural-language.md)。或在下一主題中探索主題工作空間。
# 主題工作空間
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
建立主題後，或從**主題**頁面上的清單中選擇現有主題時，該主題將會開啟到該主題的工作空間。此處顯示四個索引標籤，您可以按照以下各章節內容中的描述進行使用。Quick Sight 提供主題的引導式工作流程。您可以隨時退出引導式工作流程和返回，從而不打斷您的工作。
## 摘要
**摘要**索引標籤包含三個重要區域：
+ **建議**：建議為如何改善主題提供逐步指導。這些步驟可協助您了解如何建立效果更好的主題。
若要遵循建議，請選擇建議橫幅中的動作按鈕，並按照建議的步驟進行操作。
目前，依下表所示順序提供八個預設建議。當您在完成一個建議步驟後返回**摘要**索引標籤時，系統會提供新的建議。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_tw/quick/latest/userguide/topics-interface.html)
+ **有關主題互動和效能的指標和關鍵績效指標 (KPI)**：在本區段中，您可以查看讀者如何與主題互動，以及他們對所提供的答案給出的意見回饋和評等。您可以檢視使用者提出的所有問題的互動情況，或選取特定問題。您還可以變更指標的時間跨度，從一年到一週。
如需詳細資訊，請參閱[檢閱 Quick Sight 主題效能和意見回饋](topics-performance.md)。
+ **資料集**：此區段顯示用於建立主題的資料集。在此區段中，您可以新增其他資料集，或從現有儀表板匯入資料集。您也可以編輯主題資料集的中繼資料、設定資料重新整理排程、變更資料集的名稱等。如需詳細資訊，請參閱[在 Quick Sight 主題中使用資料集](topics-data.md)。
## 資料
**資料**索引標籤顯示主題中包含的所有欄位。您可以在此處設定主題中繼資料，讓您的主題符合自然語言，並提高主題效能。如需詳細資訊，請參閱[讓 Quick Sight natural-language-friendly](topics-natural-language.md)。
## 使用者活動
此索引標籤顯示主題收到的所有問題，以及每個問題的整體意見回饋。您可以概覽提出的問題數量，以及正面和負面意見回饋的百分比。您可以按意見回饋以及意見回饋中是否留下評論進行篩選。如需詳細資訊，請參閱[檢閱 Quick Sight 主題效能和意見回饋](topics-performance.md)。
## 已驗證的答案
*已驗證的答案*是您已為其預先設定視覺化效果的問題。您可以在搜尋列中提出問題，然後將問題標記為已檢閱，以建立已驗證的問題答案。透過使用**已驗證的答案**索引標籤，您可以檢視經過驗證的答案，使用者對這些答案的意見回饋。
# 在 Quick Sight 主題中使用資料集
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
建立主題時，您可以向其中新增其他資料集，或從現有儀表板匯入資料集。您可以隨時編輯資料集的中繼資料，並設定資料重新整理排程。您也可以透過建立計算欄位、篩選條件或具名實體，來為主題中的資料集新增欄位。
**Topics**
+ [將資料集新增至 Amazon Quick Sight 中的主題](topics-data-add.md)
+ [將具有資料列層級安全性 (RLS) 的資料集新增至 Amazon Quick Sight 主題](topics-data-rls.md)
+ [重新整理 Quick Sight 主題中的資料集](topics-data-refresh.md)
+ [從 Amazon Quick Sight 主題移除資料集](topics-data-remove.md)
+ [將計算欄位新增至 Amazon Quick Sight 主題資料集](topics-data-calculated-fields.md)
+ [將篩選條件新增至 Amazon Quick Sight 主題資料集](topics-data-filters.md)
+ [將具名實體新增至 Amazon Quick Sight 主題資料集](topics-data-entities.md)
# 將資料集新增至 Amazon Quick Sight 中的主題
您可以隨時將資料集新增至主題。透過以下程序了解操作方式。
**將資料集新增至主題**
1. 開啟您想要新增一個或多個資料集的主題。
1. 在**摘要**頁面上，選擇**資料**。然後，在**資料集**下，選擇**新增資料集**。
1. 在開啟的**新增資料集**頁面上，選擇要新增的一個或多個資料集，然後選擇**新增資料集**。
資料集會新增至主題，且資料集的唯一字串值會編製索引。您可以立即編輯欄位組態。如需詳細資訊，請參閱[重新整理 Quick Sight 主題索引](topics-index.md)。如需編輯欄位組態的詳細資訊，請參閱 [讓 Quick Sight natural-language-friendly](topics-natural-language.md)。
# 將具有資料列層級安全性 (RLS) 的資料集新增至 Amazon Quick Sight 主題
您可以將包含資料列層級安全性 (RLS) 的資料集新增至主題。主題中的所有欄位均會遵循套用於資料集的 RLS 規則。例如，如果使用者詢問「按區域顯示銷售額」，則傳回的資料是根據使用者對基礎資料的存取。因此，如果他們只被允許查看東部區域，則答案中只會顯示東部區域的資料。
RLS 規則套用於使用者提問時的自動建議。當使用者輸入問題時，系統只會向其建議其有權存取的值。如果使用者輸入有關其無權存取的維度值的問題，其將無法取得有關該值的答案。例如，假設相同使用者輸入問題「顯示西部地區的銷售額」。在這種情況下，即使他們提出問題，他們也不會得到建議或答案，因為他們沒有該區域的 RLS 存取權。
根據預設，Quick Sight 允許使用者根據使用者在 RLS 中的許可來詢問有關欄位的問題。如果欄位包含您想要限制存取的敏感資料，請繼續使用此選項。如果您的欄位不包含敏感資訊，且您希望所有使用者在建議中查看資訊，則您可以選擇允許 欄位內所有值的問題。
**允許對全部欄位提問**
1. 在快速首頁中，選擇**資料**。
1. 在**資料集**索引標籤下，選擇您新增 RLS 的資料集，然後選擇**編輯資料集**。
如需新增 RLS 到 資料集的詳細資訊，請參閱 [在 Amazon Quick 中使用資料列層級安全性](row-level-security.md)。
1. 在資料準備頁面上，選擇您要允許 之欄位的欄位選單 （三個點），然後選擇**資料列層級安全性 **。
1. 在開啟**的快速資料列層級安全性**頁面上，選擇**允許使用者詢問有關此欄位上所有值的問題**。
1. 選擇**套用**。
1. 完成資料集編輯後，選擇右上角藍色工具列中的**儲存並發布**。
1. 將資料集新增至您的主題。如需詳細資訊，請參閱前一節：[將資料集新增至 Amazon Quick Sight 中的主題](topics-data-add.md)。
如果您目前允許使用者針對所有的值提問，但想要實作資料集的 RLS 規則以保護敏感訊息，請重複步驟 1–4 並選擇**允許使用者根據其許可詢問有關此欄位的問題**。完成後，請重新整理主題中的資料集。如需詳細資訊，請參閱[重新整理 Quick Sight 主題中的資料集](topics-data-refresh.md)。
# 重新整理 Quick Sight 主題中的資料集
將資料集新增至主題時，您可以指定希望該資料集重新整理的頻率。當您重新整理主題中的資料集時，會使用任何新的和更新的資訊重新整理該主題的索引。
當您將資料集新增至主題時，資料集不會進行複寫。建立唯一字串值的索引，指標不會編製索引。例如，存放為整數的量值不會編製索引。詢問的問題一律會根據資料集中的資料擷取最新的銷售指標。
如需重新整理主題索引的詳細資訊，請參閱 [重新整理 Quick Sight 主題索引](topics-index.md)
您可以為主題中的資料集設定重新整理排程，或手動重新整理資料集。您也可以查看上次重新整理資料的時間。
**設定主題資料集的重新整理排程**
1. 開啟您要變更的主題。
1. 在**摘要**頁面上，選擇**資料**。然後，在**資料集**下，展開您要為其設定重新整理排程的資料集。
1. 選擇**新增排程**，然後在開啟的**新增重新整理排程**頁面中執行以下操作之一。
+ 如果資料集是 SPICE 資料集，則選擇**將資料集匯入 SPICE 時重新整理主題**。
目前不支援每小時重新整理SPICE資料集。設定為每小時重新整理的SPICE資料集會自動轉換為每日重新整理。如需設定 SPICE 資料集重新整理排程的詳細資訊，請參閱 [重新整理 SPICE 資料](refreshing-imported-data.md)。
+ 如果資料集是直接查詢資料集，則執行下列操作：
1. 針對**時區**，選擇所需時區。
1. 針對**重複頻率**，選擇所需的重新整理頻率。您可以選擇每天、每週或每月重新整理資料集一次。
1. 針對**重新整理時間**，輸入您希望重新整理開始的時間。
1. 針對**開始首次重新整理日期**，選擇您想要開始重新整理資料集的日期。
1. 選擇**儲存**。
**手動重新整理資料集**
1. 在主題**摘要**頁面上，選擇**資料**。然後，在**資料集**下，選擇您要重新整理的資料集。
1. 選擇**立即重新整理**。
**檢視資料集的重新整理歷史記錄**
1. 在主題**摘要**頁面上，選擇**資料**。然後，在**資料集下**，選擇要查看重新整理歷史記錄的資料集。
1. 選擇 **View history (檢視歷程記錄)**。
**更新歷史記錄**頁面將開啟，其中包含資料集重新整理時間的清單。
# 從 Amazon Quick Sight 主題移除資料集
您可以從主題中移除資料集。從主題移除資料集並不會從 Quick Sight 中刪除資料集。
透過以下程序從主題中移除資料集。
**從主題中移除資料集**
1. 開啟您要變更的主題。
1. 在**摘要**頁面上，選擇**資料**。然後，在**資料集**下，選擇右側的資料集選單 （三個點），然後選擇**從主題中移除**。
1. 在開啟的「**您確定要刪除嗎？**」頁面上，選擇**刪除**以從主題中移除資料集。如果您不想從主題中移除資料集，請選擇**取消**。
# 將計算欄位新增至 Amazon Quick Sight 主題資料集
您可以透過建立計算欄位在主題中建立新欄位。*計算欄位*是結合資料集中的一個或兩個欄位與支援的函數建立新資料的欄位。
例如，如果資料集包含銷售和費用資料欄，您可以在計算欄位中使用簡單的函數將它們結合起來，以建立利潤資料欄。該函數類似於：`sum({Sales}) - sum({Expenses})`。
**將計算欄位新增至主題**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 針對**動作**，選擇**新增計算欄位**。
1. 在開啟的計算編輯器中，執行下列動作：
1. 為計算欄位指定一個易於理解的名稱。
1. 針對右側的**資料集**，選擇要用於計算欄位的資料集。
1. 在左側的計算編輯器中輸入計算。
您可以在右側的**欄位**窗格中查看資料集中的欄位清單。您也可以在右側的**函數**窗格中查看支援的函數清單。
如需有關可用於在 Quick Sight 中建立計算的函數和運算子的詳細資訊，請參閱 [Amazon Quick 的計算欄位函數和運算子參考函式和運算子](calculated-field-reference.md)。
1. 完成時，選擇**儲存**。
計算欄位將會新增到主題中的欄位清單中。您可以為其新增描述並設定中繼資料，以使其更符合自然語言。
# 將篩選條件新增至 Amazon Quick Sight 主題資料集
有時，業務使用者 (讀者) 提出的問題可能會包含映射至資料中多個值儲存格的字詞。例如，假設其中一個讀者問：「顯示我西部的每週銷售趨勢」。本例中的西部地區**指的是 `Region` 欄位中的 `Northwest` 和 `Southwest` 值，並且要求對資料進行篩選以產生答案。您可以向主題新增篩選條件以支援此類請求。
**將篩選條件新增至主題**
1. 開啟您要新增篩選條件的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 針對**動作**，選擇**新增篩選條件**。
1. 在開啟的**篩選條件組態**頁面中，執行下列操作：
1. 針對**名稱**，輸入易於理解的篩選條件名稱。
1. 針對**資料集**，選擇要套用篩選條件的資料集。
1. 針對**欄位**，選擇要篩選的欄位。
根據您選擇之欄位的類型，提供的篩選選項有所不同。
+ 如果選擇的是文字欄位 (例如 `Region`)，請執行下列操作：
1. 針對**篩選條件類型**，選擇所需的篩選條件類型。
如需有關篩選文字欄位的詳細資訊，請參閱 [新增文字篩選條件](add-a-text-filter-data-prep.md)。
1. 針對**規則**，選擇一個規則。
1. 針對**值**，輸入一個或多個值。
+ 如果選擇的是日期欄位 (例如 `Date`)，請執行下列操作：
1. 針對**篩選條件類型**，選擇所需的篩選類型，然後輸入要套用篩選條件的一個或多個日期。
如需有關篩選日期欄位的詳細資訊，請參閱 [新增日期篩選條件](add-a-date-filter2.md)。
+ 如果選擇的是數值欄位 (例如 `Compensation`)，請執行下列操作：
1. 針對**彙總**，選擇彙總篩選值的方式。
1. 針對**規則**，選擇篩選條件規則，然後輸入規則的值。
如需有關篩選數值欄位的詳細資訊，請參閱 [新增數值篩選條件](add-a-numeric-filter-data-prep.md)。
1. (選用) 若要指定何時套用篩選條件，請選擇**在使用資料集時套用篩選條件**，然後選擇下列選項之一：
+ **永遠套用**：選擇此選項時，只要您指定的資料集中的任何資料欄連結到問題，就會套用篩選條件。
+ **永遠套用 (除非問題導致資料集中的明確篩選條件)**：選擇此選項時，只要您指定的資料集中的任何資料欄連結到問題，就會套用篩選條件。但是，如果問題提到同一欄位上的一個明確篩選條件，則不會套用該篩選條件。
1. 完成時，選擇**儲存**。
篩選條件會新增到話題中的篩選條件清單。您可以編輯該篩選條件的描述，或調整其套用時機。
# 將具名實體新增至 Amazon Quick Sight 主題資料集
當詢問有關某個主題的問題時，讀者可能會指向多個資料欄中的資料，而沒有明確說明每一欄。例如，他們可能會詢問交易的地址。他們實際上的意思是想要取得交易發生所在的分支機構名稱、州和城市。您可以建立一個具名實體來支援這類請求。
*具名實體*是在答案中一起顯示的欄位集合。例如，以上面的交易地址為例，您可以建立一個名為 `Address` 的具名實體。然後，您可以向其中新增資料集中已存在的 `Branch Name`、`State` 和 `City` 資料欄。當有人詢問有關地址的問題時，答案會顯示交易發生所在的分支機構、州和城市。
**將具名實體新增至主題**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 針對**動作**，選擇**新增具名實體**。
1. 在開啟的**具名實體**頁面中，執行以下操作：
1. 針對**資料集**，選擇一個資料集。
1. 針對**名稱**，輸入易於理解的具名實體名稱。
1. 針對**描述**，輸入具名實體的描述。
1. (選用) 針對**同義字**，新增您認為讀者可能用來指代具名實體或其包含之資料的任何替代名稱。
1. 選擇**新增欄位**，然後從清單中選擇一個欄位。
再次選擇**新增欄位**以新增另一個欄位。
此處列出的欄位的順序是它們在答案中出現的順序。若要移動欄位，請選擇欄位名稱左側的六個點，然後將欄位拖放到所需的順序。
1. 完成時，選擇**儲存**。
具名實體將會新增到主題中的欄位清單中。您可以新增或編輯它的描述，並向其新增同義字，以使其更符合自然語言。
# 讓 Quick Sight natural-language-friendly
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
當您建立主題時，Quick Sight 會建立、存放和維護索引，其中包含該主題中資料的定義。此索引用於產生正確的答案、在有人提出問題時提供自動完成建議，以及建議詞彙與資料欄或資料值的映射。這是如何在讀者的問題中解譯關鍵術語並映射到資料的方式。
為了協助解譯您的資料並更好地回答讀者的問題，請盡可能提供有關資料集及其相關欄位的詳細資訊。
透過下列程序讓主題更加更符合自然語言。
**提示**
您可以使用大量動作一次編輯多個欄位。透過以下程序批次編輯主題中的欄位。
**批次編輯主題中的欄位**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**下，選取要變更的兩個或多個欄位。
1. 選擇清單頂端的**大量動作**。
1. 在開啟的**大量動作**頁面中，根據需要設定欄位，然後選擇**套用至**。
下列步驟說明組態選項。
## 步驟 1：為資料集提供易於理解的名稱和描述
資料集的命名通常基於技術命名慣例，因此其名稱可能不是讀者常用的名稱。建議您為資料集提供易於理解的名稱和描述，提供其所包含之資料的詳細資訊。這些易記名稱和描述用於了解資料集內容，並根據讀者的問題選取資料集。資料集名稱也會向讀取器顯示，以提供答案的其他內容。
例如，如果資料集名為 `D_CUST_DLY_ORD_DTL`，您可以在主題中將其重新命名為 `Customer Daily Order Details`。如此一來，當讀者在主題的搜尋列中看到它時，他們可以快速判斷資料是否與其相關。
**為資料集提供易於理解的名稱和描述**
1. 開啟您要變更的主題。
1. 在**摘要**索引標籤上，選擇**資料**。然後，在**資料集**下，選擇資料集最右側的向下箭頭來展開資料集。
1. 選擇左側資料集名稱旁的鉛筆圖示，然後輸入易於理解的名稱。建議使用讀者能夠理解的名稱。
1. 針對**描述**，輸入資料集的描述，以描述其包含的資料。
## 步驟 2：指示如何在資料集中使用日期欄位
如果您的資料集包含日期和時間資訊，我們建議您在回答問題時使用該資訊。如果主題中有多個日期時間資料欄，則這麼做尤其重要。
在某些情況下，一個主題中有多個有效日期資料欄，例如訂單日期和發貨日期。在這些情況下，您可以透過指定預設日期來協助讀者回答問題。如果預設日期不能回答他們的問題，讀者可以選擇其他日期。
您也可以指定時間基礎，以判斷日期時間資料欄的精細程度。資料集的*時間基礎*是資料集中所有量值支援的最低時間精細程度。此設定有助於彙總不同時間維度的資料集中的指標，並適用於支援單一日期時間精細度的資料集。可以為具有大量指標的非標準化資料集設定此選項。例如，如果某個資料集支援每日彙總多個指標，則您可以將該資料集的時間基礎設定為**每天**。然後，這會用來判斷如何彙總指標。
**設定資料集的預設日期和時間基礎**
1. 開啟您要變更的主題。
1. 在**摘要**索引標籤上，選擇**資料**。然後，在**資料集**下，選擇資料集最右側的向下箭頭來展開資料集。
1. 針對**預設日期**，選擇一個日期欄位。
1. 針對**時間基礎**，選擇您要在資料集中彙總指標的最低精細程度。您可以每天、每週、每月、每季或每年彙總一次主題中的指標。
## 步驟 3：排除未使用的欄位
當您將資料集新增至主題時，預設會新增資料集中的所有資料欄 (欄位)。如果資料集包含您或讀者不使用的欄位，或者您不想包含在答案中的欄位，您可以將它們從主題中排除。排除這些欄位會從答案和索引中移除它們，並改善讀者收到的答案的準確性。
**在主題中排除欄位**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中的**包含**下，按一下切換圖示。
## 步驟 4：將欄位重新命名為易於理解的名稱
資料集中的欄位通常根據技術命名慣例來命名。您可以透過重新命名欄位名稱並新增描述，使主題中的欄位名稱更加易於理解。
欄位名稱用於了解欄位，並將其連結到讀者問題中的術語。當您的欄位名稱易於使用時，更容易在資料和讀者的問題之間繪製連結。這些易於理解的名稱也會作為問題答案的一部分呈現給讀者，以提供更多相關資訊。
**重新命名欄位並新增描述**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中，選擇欄位最右側的向下箭頭將其展開。
1. 選擇左側欄位名稱旁的鉛筆圖示，然後輸入易於理解的名稱。
1. 針對**描述**，輸入欄位描述。
## 步驟 5：為欄位和欄位值新增同義字
即使您將欄位名稱更新為使用者易於理解的名稱並為其提供描述，讀者仍可能使用不同的名稱來指代它們。例如，在讀者的問題中，`Sales` 欄位可能被稱為 `revenue`、`rev` 或 `spending`。
為了協助理解這些術語並將其對應至正確的欄位，您可以將一或多個同義詞新增至您的欄位。這樣做可提高準確性。
如同欄位名稱，讀者可能會使用不同的名稱來指代欄位中的特定值。例如，如果欄位包含值 `NW`、`SE`、`NE` 和 `SW`，您可以為這些值新增同義字。您可以為 `NW` 新增同義字 `Northwest`，為 `SE` 新增同義字 `Southeast`，以此類推。
**為欄位新增同義字**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段的**同義字**下，選擇欄位的鉛筆圖示，輸入單字或片語，然後按鍵盤上的 Enter 鍵。若要新增另一個同義字，請選擇 **\$1** 圖示。
**為欄位中的值新增同義字**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中，選擇最右側的向下箭頭，以展開有關該欄位的資訊。
1. 在右側的**值預覽**下，選擇**設定值同義字**。
1. 在開啟的**欄位值同義字**頁面上，選擇**新增**，然後執行以下操作：
1. 針對**值**，選擇要為其新增同義字的值。
1. 針對**同義字**，輸入該值的一個或多個同義字。
1. 選擇**儲存**。
1. 若要新增另一個值的同義字，請重複步驟 5-6。
1. 完成時請選擇**完成**。
## 步驟 6：詳細說明您的欄位
為了協助解譯如何使用您的資料來回答讀者的問題，您可以進一步說明資料集中的欄位。
您可以說出資料集中的欄位是維度還是度量，並指定應如何彙總該欄位。您也可以闡明欄位中的值應如何格式化，以及欄位中的資料類型。設定這些額外的設定有助於在讀者提出問題時，為您的讀者建立準確的答案。
使用以下程序來進一步說明您的欄位。
### 指派欄位角色
資料集中的每個欄位都是維度或量值。*維度*是類別資料，*量值*是量化資料。知道欄位是維度還是度量，會決定哪些操作可以和不可以對欄位執行。
例如，設定欄位 `Patient ID`、 `Employee ID`和 `Ratings`有助於將這些欄位解譯為整數。此設定表示在測量欄位時，不會彙總欄位。
**設定欄位角色**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中，選擇最右側的向下箭頭，以展開有關該欄位的資訊。
1. 針對**角色**中，選擇一個角色。
您可以選擇量值或維度。
1. (選用) 如果量值是反比值 (例如，數字越小越好)，請選擇**反轉量值**。
這說明如何解譯和顯示此欄位中的值。
### 設定欄位彙總
設定欄位彙總有助於判斷當這些欄位跨多個資料列彙總時，應該或不應該使用哪個函數。您可以為欄位設定預設彙總和不允許的彙總。
*預設彙總*是當讀者的問題中沒有明確提及或指出彙總函數時所套用的彙總。例如，假設您的讀者問：「昨天售出了多少產品？」 在本例中，Q 會使用欄位 `Product ID` (其預設彙總為 `count distinct`) 來回答問題。這樣做會產生顯示相異產品 ID 計數的視覺化效果。
*不允許的彙總*是不能在回答問題時在欄位上使用的彙總。即使問題中明確要求不允許的彙總，它們也會被排除。例如，假設您指定 `Product ID` 欄位不得使用 `sum` 彙總。即使其中一位讀者詢問，「昨天售出了多少產品？」 `sum` 不會用來回答問題。
如果彙總函數錯誤地套用至欄位，建議您為欄位設定不允許的彙總。
**設定欄位彙總**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中，選擇最右側的向下箭頭，以展開有關該欄位的資訊。
1. 對於**預設彙總**，選擇預設要彙總欄位的彙總。
您可以使用總和、平均值、最大值和最小值彙總量值。您可以使用計數和相異計數彙總維度。
1. （選用） 對於**不允許的彙總**，請選擇您不想使用的彙總。
1. （選用） 如果您不想彙總篩選條件中的欄位，請選擇**永不彙總篩選條件。**
### 指定格式化欄位值的方式
如果您想要解釋如何格式化欄位中的值，您可以這樣做。例如，假設您有一個欄位 `Order Sales Amount`，其中包含要格式化為美元的值。在這種情況下，您可以解釋如何在答案中使用 將欄位中的值格式化為美元。
**指定格式化欄位值的方式**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中，選擇最右側的向下箭頭，以展開有關該欄位的資訊。
1. 針對**值格式**，選擇要格式化欄位值的方式。
### 指定欄位語義類型
欄位*語意類型*是欄位中的資料所表示之資訊的類型。例如，您可能有一個包含位置資料、貨幣資料、年齡資料或布林值資料的欄位。您可以為該欄位指定語意類型和其他語意子類型。指定這些項目有助於了解存放在您欄位中之資料的意義。
透過以下程序指定欄位語意類型和子類型。
**指定欄位語義類型**
1. 開啟您要變更的主題。
1. 在該主題中，選擇**資料**索引標籤。
1. 在**欄位**區段中，選擇最右側的向下箭頭，以展開有關該欄位的資訊。
1. 針對**語意類型**，選擇資料表示的資訊類型。
針對量值，您可以選取持續時間、日期構成部分、位置、布林值、貨幣、百分比、年齡、距離和識別符類型。針對維度，您可以選取日期構成部分、位置、布林值、人員、組織和識別符類型。
1. 針對**語意子類型**，選擇一個選項，以進一步指定資料表示的資訊類型。
此處顯示的選項取決於您選擇的語義類型以及與相應欄位關聯的角色。有關量值和維度的語義類型及其關聯子類型的清單，請參閱下表。
| 語意類型 | 語意子類型 | 適用於 |
| --- | --- | --- |
| 年齡 | | 量值 |
| Boolean | | 維度和量值 |
| Currency | 美元 歐元 英鎊 | 量值 |
| 日期構成部分 | 天 週 月 年 季 | 維度和量值 |
| 距離 | 公哩 計量 英碼 英尺 | 量值 |
| 持續時間 | 秒 分鐘 小時 天 | 量值 |
| 識別符 | | 維度和量值 |
| Location | 郵遞區號 國家/地區 State 城市 | 維度和量值 |
| 組織 | | 維度 |
| 百分比 | | 量值 |
| 個人 | | 維度 |
# 共用 Quick Sight 主題
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
建立主題後，您可以與組織中的其他人共用。共用主題可讓您的使用者選取主題，並在搜尋列中詢問相關問題。與使用者共用主題後，您可以向他們指派許可，指定誰可以變更主題。
**共用主題**
1. 在快速入門頁面上，選擇左側**的主題**。
1. 在開啟的**主題**頁面上，開啟您要共用的主題。
1. 在開啟的頁面上，選擇右上角的**共用**。
1. 在開啟的**與使用者共用主題**頁面上，選擇您要與之共用主題的一個或多個使用者。
您可以使用搜尋列按電子郵件地址搜尋使用者。
1. 選擇**許可**資料欄下的**檢視者**或**共同擁有者**，為使用者指派許可。
如需這些許可的詳細資訊，請參閱下一章節：[管理 Amazon Quick Sight 主題許可](topics-sharing-permissions.md)。
1. 選取完使用者後，選擇**共用**。
# 管理 Amazon Quick Sight 主題許可
當您與組織中的其他人共用主題時，您可能想要控制誰可以變更主題。為此，請指定哪些使用者是檢視者，哪些使用者是共同擁有者。*檢視器*從清單中選取主題時，可以在搜尋列中查看主題，但無法變更主題資料。*共同擁有者*可以在搜尋列中查看主題，也可以變更主題。
**為使用者指派主題許可**
1. 在快速入門頁面中，選擇**主題**。
1. 在開啟**的主題**頁面上，開啟您要管理許可的主題。
1. 在開啟的主題頁面上，選擇右上角的**共用**。
1. 在開啟的**與使用者共用主題**頁面上，選擇**管理主題存取**。
1. 在開啟的**管理主題許可**頁面上，找到要為其授予存取許可的使用者，然後針對**許可**，選擇以下選項之一：
+ 若要允許使用者檢視和變更主題，請選擇**共同擁有者**。
+ 若要僅允許使用者檢視主題，請選擇**檢視者**。
# 檢閱 Quick Sight 主題效能和意見回饋
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
建立主題並與使用者共用後，您可以檢視主題的效能。當有人使用您的主題提出問題或提供有關回應效果的意見回饋時，它會記錄在主題的**摘要**和**使用者活動**索引標籤上。
在主題的**摘要**索引標籤上，您可以檢視一段時間內 (7 天到一年) 提出的問題數量的歷史資料。您還可以查看收到正面意見回饋、負面意見回饋或沒有意見回饋，以及無法回答的問題的分佈情況。
在**使用者活動**索引標籤上，您可以查看使用者提出的問題，以及留下的任何正面或負面意見回饋和評論的清單。
檢視這些資訊可以協助您判斷相應主題是否滿足使用者的需求。例如，假設某個主題收到了使用者大量的負面意見回饋。當您檢閱使用者活動時，您注意到有幾個使用者對顯示錯誤資料的問題留下評論。為了改善這種狀況，您查看了使用者提出的問題，並注意到他們使用了您沒有預料到的字詞。您決定將該字詞作為同義字新增到主題中的相應欄位。一段時間後，您注意到正面意見回饋有所增加。
## 檢視主題效能
透過以下程序檢視主題的效能。
**檢視主題的效能**
1. 在快速入門頁面上，選擇左側**的主題**。
1. 在開啟的**主題**頁面上，開啟您要檢視的主題。
主題將開啟，**統計資料**區段顯示該主題的統計資料。
1. (選用) 若要變更圖表中顯示的歷史資料量，請選擇下列選項之一：**7 天**、**30 天**、**90 天**、1**20 天**或 **12 個月**。
1. (選用) 若要從資料中移除無法回答的問題，請取消核取**包含無法回答的資料**。
1. (選用) 若要從資料中移除未收到意見回饋的問題，請取消核取**包含無意見回饋的資料**。
## 檢視主題問題和意見回饋
透過下列程序檢視主題中的問題和意見回饋。
**檢視主題問題和意見回饋**
1. 在快速入門頁面上，選擇**主題**。
1. 在開啟的**主題**頁面上，開啟您若檢視意見回饋的主題。
1. 在開啟的主題頁面上，選擇**使用者活動**索引標籤。
此時會顯示該主題的使用者活動。在頂端，您可以看到提出的問題總數，以及可回答和無法回答的問題數。您也可以看到被評為正面和負面的問題答案的百分比。此外，您還可以看到已消除歧義的問題的百分比。這表示有人輸入了一個問題並將問題中的單字之一映射到主題中的欄位。
您可以選擇任何這些統計資料來篩選問題清單。
1. (選用) 若要檢視使用者在問題中留下的評論，請選擇問題右側的向下箭頭。
評論顯示在左側。
1. (選用) 若要檢視用於回答問題的欄位，請選擇問題右側的向下箭頭。
使用的欄位顯示在右側。選擇欄位名稱可編輯其中繼資料。
1. (選用) 若要檢視已消除歧義的問題，請選擇帶有紅色反白顯示之字詞的問題右側的向下箭頭。
此時會顯示該字詞的描述以及用於消除歧義的欄位。若要為欄位新增同義字，請選擇**新增同義字**。
1. （選用） 若要檢視問題的回應方式，請選擇清單中問題旁的**檢視**。
1. (選用) 若要篩選問題清單，請選擇右側的**篩選依據**，然後按以下選項之一進行篩選。
+ **查看所有問題**：此選項會移除所有篩選條件，並顯示主題已收到的所有問題。
+ **可回答**：此選項會篩選出可回答的問題。可回答的問題是 Q 能夠回答的問題。
+ **無法回答**：此選項會篩選出無法回答的問題。無法回答的問題是 Q 無法回答的問題。
+ **已消除歧義**：此選項會篩選出已消除歧義的問題，即使用者手動將欄位映射到特定字詞的問題。
+ **無意見回饋**：此選項會篩選出未收到任何意見回饋的問題。
+ **負面**：此選項會篩選出收到負面意見回饋的問題。
+ **正面**：此選項會篩選出收到正面意見回饋的問題。
+ **無評論**：此選項會篩選出未收到使用者評論的問題。
+ **有評論**：此選項會篩選出收到使用者評論的問題。
+ **使用者**：此選項會篩選出您輸入的特定使用者名稱對應之使用者提出的問題。
# 重新整理 Quick Sight 主題索引
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 管理員和作者 |
當您建立主題時，Quick Sight 會建立、存放和維護索引，其中包含該主題中資料的定義。此索引不會公開給 Quick Sight 作者。它也不是主題中包含的資料集的複本。指標不會編製索引。例如，存放為整數的量值不會編製索引。
主題索引是主題中包含之欄位的唯一字串值的索引。此索引用於產生正確的答案、在有人提出問題時提供自動完成建議，以及建議詞彙與資料欄或資料值的映射。
若要重新整理主題索引，請重新整理主題中的資料集。您可以手動重新整理主題中的所有資料集，或重新整理單一資料集。您也可以檢視資料集重新整理歷史記錄，以監控過去的重新整理，並為主題中的每個資料集設定定期重新整理排程。針對 SPICE 資料集，您可以將主題索引重新整理排程與 SPICE 重新整理排程同步。如需設定 SPICE 重新整理排程的詳細資訊，請參閱 [依排程重新整理資料集。](refreshing-imported-data.md#schedule-data-refresh)。
**注意**
目前不支援每小時重新整理排程。您可以設定重新整理排程，每天最多重新整理主題中的資料集一次。
建議您定期更新主題索引，以確保記錄最新的定義和值。完成主題索引更新大約需要 15 到 30 分鐘，具體取決於主題中包含的資料集的數量和大小。
**重新整理主題索引**
1. 在快速入門頁面上，選擇**主題**。
1. 在開啟的**主題**頁面上，開啟要重新整理的主題。
主題將開啟**摘要**索引標籤，其中頁面底部會顯示主題中包含的資料集。頁面右上角還會顯示主題上次重新整理的時間。
1. 選擇右上角的**已重新整理**，然後選擇**重新整理資料**以重新整理主題索引。手動執行此操作會重新整理主題中的所有資料集。
如需重新整理主題中個別資料集的詳細資訊，請參閱 [重新整理 Quick Sight 主題中的資料集](topics-data-refresh.md)。
# 使用 Amazon Quick Sight APIs 處理 Quick Sight 主題
| |
| --- |
| 適用於：企業版 |
| |
| --- |
| 目標對象：Amazon Quick 開發人員 |
使用本節了解如何使用 Amazon Quick Sight 命令列界面 (CLI) 來使用 Quick Sight 主題。
**先決條件**
開始之前，請確定您具有授予 CLI 使用者呼叫 Quick Sight API 操作存取權的 AWS Identity and Access Management (IAM) 角色。下表顯示了必須將哪些許可新增至 IAM 政策才能使用特定 API 操作。若要使用所有主題 API 操作，請新增 資料表中列出的所有許可。
| API 操作 | IAM 政策 |
| --- | --- |
| `CreateTopic` | `quicksight:CreateTopic` `quicksight:PassDataSet` |
| `ListTopics` | `quicksight:ListTopics` |
| `DescribeTopic` | `quicksight:DescribeTopic` |
| `DescribeTopicPermissions` | `quicksight:DescribeTopicPermissions` |
| `DescribeTopicRefresh` | `quicksight:DescribeTopicRefresh` |
| `DeleteTopic` | `quicksight:DeleteTopic` |
| `UpdateTopic` | `quicksight:UpdateTopic` `quicksight:PassDataSet` |
| `UpdateTopicPermissions` | `quicksight:UpdateTopicPermissions` |
| `CreateTopicRefreshSchedule` | `quicksight:CreateTopicRefreshSchedule` |
| `ListTopicRefreshSchedules` | `quicksight:ListTopicRefreshSchedules` |
| `DescribeTopicRefreshSchedule` | `quicksight:DescribeTopicRefreshSchedule` |
| `UpdateTopicRefreshSchedule` | `quicksight:UpdateTopicRefreshSchedule` |
| `DeleteTopicRefreshSchedule` | `quicksight:DeleteTopicRefreshSchedule` |
| `BatchCreateTopicReviewedAnswer` | `quicksight:BatchCreateTopicReviewedAnswer` |
| `BatchDeleteTopicReviewedAnswer` | `quicksight:BatchDeleteTopicReviewedAnswer` |
| `ListTopicReviewedAnswers` | `quicksight:ListTopicReviewedAnswers` |
下面的範例顯示允許使用者使用 `ListTopics` 操作的 IAM 政策。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"quicksight:ListTopics"
],
"Resource": "*"
}
]
}
```
------
設定使用 Quick Sight APIs 建立 Quick Sight 主題的許可後，請使用下列主題來建立和使用 Quick Sight 主題 APIs。
**Topics**
+ [使用 Quick Sight APIs 處理 Quick Sight 主題](topic-cli-examples.md)
+ [使用 Quick Sight CLI 設定 Quick Sight 主題重新整理排程](topic-refresh-apis.md)
+ [在 和 之間複製和遷移 Quick Sight 主題 AWS 帳戶](topic-cli-walkthroughs.md)
+ [使用 Quick Sight APIs 在 Quick Sight 主題中建立和修改已檢閱的答案](topic-reviewed-answer-apis.md)
# 使用 Quick Sight APIs 處理 Quick Sight 主題
下列範例會建立新的主題。
```
aws quicksight create-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC
```
您也可以使用 CLI 骨架檔案搭配下列命令來建立新的主題。如需 CLI 骨架檔案的詳細資訊，請參閱《*Amazon Quick Sight 開發人員指南*》中的[使用 CLI 骨架檔案](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)。
```
aws quicksight create-topic
--cli-input-json file://createtopic.json
```
當您建立新主題時，資料集重新整理組態不會複製到主題。若要為新主題設定主題重新整理排程，您可以進行 `create-topic-refresh-schedule` API 呼叫。如需使用 CLI 設定主題重新整理排程的詳細資訊，請參閱 [使用 Quick Sight CLI 設定 Quick Sight 主題重新整理排程](topic-refresh-apis.md)。
建立第一個主題之後，您可以更新、刪除、列出或請求主題摘要。
下列範例會更新主題。
```
aws quicksight update-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC
```
您也可以使用 CLI 骨架檔案搭配下列命令來更新主題。如需 CLI 骨架檔案的詳細資訊，請參閱《*Amazon Quick Sight 開發人員指南*》中的[使用 CLI 骨架檔案](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)。
```
aws quicksight update-topic
--cli-input-json file://updatetopic.json
```
下列範例提供快速帳戶中所有主題的清單。
```
aws quicksight list-topics
--aws-account-id AWSACCOUNTID
```
下列範例會刪除主題。
```
aws quicksight delete-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```
下列範例提供如何設定主題的資訊。
```
aws quicksight describe-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```
下列命令會更新主題的許可。
```
aws quicksight update-topic-permissions
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--grant-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic
--revoke-permissions Principal=arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/USERNAME,Actions=quicksight:DescribeTopic
```
使用 `grant-permissions` 參數將讀取和撰寫許可授予快速帳戶使用者。若要授予帳戶使用者讀取許可，請輸入值：`"quicksight:DescribeTopic"`。若要向帳戶使用者授予許可，請輸入下列值：
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`
`RevokePermissions` 參數會撤銷授予帳戶使用者的所有許可。
下列命令說明主題的所有許可。
```
aws quicksight describe-topic-permissions
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```
建立 Quick Sight 主題之後，您可以使用 Amazon Quick Sight APIs 來[設定主題重新整理排程](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis)、在[帳戶內或帳戶之間遷移 Quick Sight 主題](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs)，以及[建立檢閱過的答案](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis)。
# 使用 Quick Sight CLI 設定 Quick Sight 主題重新整理排程
下列命令會建立主題的重新整理排程。
```
aws quicksight create-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-arn DATASETARN
--refresh-schedule REFRESHSCHEDULE
```
建立主題的重新整理排程後，您可以更新、刪除、列出或請求主題的重新整理排程摘要。
下列命令會更新主題的重新整理排程。
```
aws quicksight update-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
--refresh-schedule REFRESHSCHEDULE
```
下列範例提供設定為主題的所有重新整理排程清單。
```
aws quicksight list-topic-refresh-schedules
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```
以下範例會刪除主題重新整理排程。
```
aws quicksight delete-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```
以下範例會獲取相應主題有關重新整理排程設定的資訊。
```
aws quicksight describe-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```
# 在 和 之間複製和遷移 Quick Sight 主題 AWS 帳戶
您可以使用 Quick Sight 命令列界面 (CLI)，將 Quick Sight 主題從一個帳戶遷移到另一個帳戶。您可以使用 Quick Sight CLI 重複重複使用相同的主題，而不是在多個儀表板、命名空間或帳戶中手動複寫相同的主題。此功能可節省 Quick Sight 作者的時間，並為跨多個儀表板的儀表板讀者建立標準化主題體驗。
若要使用 Quick Sight CLI 遷移主題，請使用下列程序
**將主題遷移至另一個帳戶**
1. 首先，找到要遷移的主題。您可以使用 `list-topics` API 命令檢視快速帳戶中每個主題的清單。
```
aws quicksight list-topics --aws-account-id AWSACCOUNTID
```
1. 在您擁有主題清單後，找到您要遷移的主題，並`describe-topic`呼叫 以接收主題組態的 JSON 結構。
```
aws quicksight describe-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```
以下是 `describe-topic` API 回應的範例。
```
{
"Status": 200,
"TopicId": "TopicExample",
"Arn": "string",
"Topic": [
{
"Name": "{}",
"DataSets": [
{
"DataSetArn": "{}",
"DataSetName": "{}",
"DataSetDescription": "{}",
"DataAggregation": "{}",
"Filters": [],
"Columns": [],
"CalculatedFields": [],
"NamedEntities": []
}
]
}
],
"RequestId": "requestId"
}
```
1. 使用 JSON 回應來建立骨架檔案，您可以在其他 Quick 帳戶中輸入新`create-topic`呼叫。使用骨架檔案進行 API 呼叫之前，請務必變更骨架檔案中的 AWS 帳戶 ID 和資料集 ID，以符合您要新增新主題的 AWS 帳戶 ID 和資料集 ID。如需 CLI 骨架檔案的詳細資訊，請參閱《*Amazon Quick Sight 開發人員指南*》中的[使用 CLI 骨架檔案](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)。
```
aws quicksight create-topic --aws-account-id AWSACCOUNTID \
--cli-input-json file://./create-topic-cli-input.json
```
`create-topic` 呼叫 Quick Sight API 之後，新主題會出現在您的帳戶中。若要確認新主題是否存在，`list-topics`請呼叫 Quick Sight API。如果複製的來源主題包含已驗證的答案，則這些答案不會遷移到新主題。若要查看原始主題所有已驗證的答案的清單，請使用 `describe-topic` API 呼叫。
# 使用 Quick Sight APIs 在 Quick Sight 主題中建立和修改已檢閱的答案
建立 Quick Sight 主題之後，您可以使用 Quick Sight APIs 來建立、列出、更新和刪除主題的重構答案。
以下命令批次會為 Quick Sight 主題建立最多 100 個已檢閱的答案。
```
aws quicksight batch-create-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \
—answers ANSWERS
```
您也可以使用下列命令，從 CLI 骨架檔案批次建立已檢閱答案。如需 CLI 骨架檔案的詳細資訊，請參閱《*Amazon Quick Sight 開發人員指南*》中的[使用 CLI 骨架檔案](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)。
```
aws quicksight batch-create-topic-reviewed-answer \
--cli-input-json file://createTopicReviewedAnswer.json
```
以下命令列出 Quick Sight 主題中所有已檢閱的答案。
```
aws quicksight list-topic-reviewed-answers \
--aws-account-id AWSACCOUNTID \
--topic-id TOPICID \
```
以下範例可為主題批次刪除多達 100 個已檢閱答案。
```
aws quicksight batch-delete-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \
—answer-ids: ["AnswerId1, AnswerId2…"]
```
您也可以使用下列命令，從 CLI 骨架檔案批次建立主題的已檢閱答案。如需 CLI 骨架檔案的詳細資訊，請參閱《*Amazon Quick Sight 開發人員指南*》中的[使用 CLI 骨架檔案](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html)。
```
aws quicksight batch-delete-topic-reviewed-answer \
--cli-input-json file://deleteTopicReviewedAnswer.json
```
若要更新已檢閱答案，請使用 `batch-delete-topic-reviewed-answer` API 從主題中刪除現有的答案。然後，使用 `batch-create-topic-reviewed-answer` API 將更新的已檢閱答案新增至主題。