本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 使用 Amazon Quick Sight 主题
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：Amazon Quick 管理员和作者 |
*主题*是一个或多个数据集的集合，这些数据集代表了您的业务用户可以提问的主题领域。
借助 Quick Sight 自动数据准备功能，您可以获得由 ML 支持的帮助，帮助您创建与最终用户相关的主题。第一个过程从自动字段选择和分类开始，如下所示：
+ 默认情况下，自动数据准备会选择少量字段以创建有针对性的数据空间供读者浏览。
+ 自动数据准备会选择您在其他资产（如报告和仪表板）中使用的字段。
+ 自动数据准备还会从启用主题的任何相关分析中导入任何其他字段。
+ 它可以识别日期、维度和度量，以了解如何在答案中使用字段。
这组自动字段可帮助作者快速开始使用自然语言分析。作者可以随时使用**包含**切换按钮根据需要排除字段或包含其他字段。
接下来，通过自动标记字段和识别同义词，继续自动准备数据。自动数据准备会使用常用术语更新带有友好名称和同义词的字段名称。例如，可以将 `SLS_PERSON` 字段重命名为 `Sales person`，并分配同义词，包括:`salesman`、`saleswoman`、代理和 `sales representative`。尽管您可以让自动数据准备完成大部分工作，但还是值得查看字段、名称和同义词，以便为最终用户进一步对其进行自定义。例如，如果用户在随意交谈中将销售人员称为“代表”或“经销商”，则您可以通过在 `SLS_PERSON` 的同义词中添加 `rep` 和 `dealer` 来支持此术语。
最后，自动数据准备通过对每个字段的数据进行采样并检查作者在分析期间应用于该字段的格式，来检测每个字段的语义类型。自动数据准备会自动更新字段配置，为每个字段使用的值设置格式。因此，问题的答案以日期、货币、标识符、布尔值、人员等预期格式提供。
要了解有关使用主题的更多信息，请继续阅读本章的以下部分。
**Topics**
+ [浏览话题](navigating-topics.md)
+ [创建 “快速浏览” 主题](topics-create.md)
+ [主题工作区](topics-interface.md)
+ [在 Quick Sight 主题中使用数据集](topics-data.md)
+ [制作 “快速视觉” 话题 natural-language-friendly](topics-natural-language.md)
+ [分享快速浏览话题](topics-sharing.md)
+ [管理 Amazon Quick Sight 主题权限](topics-sharing-permissions.md)
+ [查看 Quick Sight 主题表现和反馈](topics-performance.md)
+ [刷新快速浏览主题索引](topics-index.md)
+ [使用 Amazon Quick Sight 处理 Quick Sight 主题 APIs](topics-cli.md)
# 浏览话题
在 Quick Sight 中，创建和管理主题的方法不止一种。您可以从 Amazon Quick 主页或 “开始” 页面开始。或者，您可以从分析的内部开始。
**Topics**
+ [来自 Amazon Quick 主页](starting-from-home.md)
+ [来自亚马逊 Quick Sight 的分析](starting-from-sheets.md)
+ [在 Amazon Quick Sight 分析中浏览问题](starting-from-questions-on-sheets.md)
# 来自 Amazon Quick 主页
在快速入门页面上，您可以通过选择左侧导航窗格中的**主题**来创建和管理主题。Quick 提供了用于创建主题的指导式工作流程。您可以退出引导式工作流程并稍后再回来，这不会中断您的工作。
当您创建主题时，您的企业用户可以提出有关该主题的问题。您可以随时打开主题进行更改或审查其效果。
要打开主题，请选择主题名称。
如果您想随时返回到所有主题的列表，请选择主题工作区左侧的**所有主题**。
# 来自亚马逊 Quick Sight 的分析
要从 Amazon Quick Sight 分析开始，请打开要用于自动数据准备的分析。
要打开或创建主题，请选择顶部导航栏中的主题图标。
您可以随时打开主题进行更改或审查其效果。
要打开分析中的主题，请在顶部导航栏中选择主题名称（如果尚未显示）。然后在顶部导航栏上选择垂直省略号图标 (` ⋮ `)。
要查看有关该主题的信息，请选择**关于主题**。
要查看主题中包含的数据字段，请在选项卡列表中选择**数据字段**。
# 在 Amazon Quick Sight 分析中浏览问题
通过浏览分析中主题的问题和答案，您可以了解该主题的使用情况。这些信息可以通知您在必要时进行调整。
从已链接到主题的分析中开始，选择顶部导航栏上的搜索栏，然后输入问题。答案显示在主题屏幕上，该屏幕还显示了在分析中使用该主题的所有可用选项。
+ 要更改答案中显示的视觉对象类型，请选择类型图标（类似于条形图）。
+ 要查看改进建议，请选择对话气泡（如果您有未查看的建议，该对话框会突出显示）。
+ 要查看与问题相关的见解，请选择灯泡图标。
+ 要在插接板上添加或删除问题，请切换**添加到插接板**或**从插接板中删除**图标。您可以通过从顶部导航栏中选择插接板图标来查看插接板。
+ 要查看有关此主题的信息，请选择带圆圈的小写字母 *i* (` ![\[alt text not found\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/images/status-info.png) `)。
+ 选择省略号菜单 (` … `) 以执行以下操作之一：
+ **导出至 CSV** – 导出所选视觉对象中显示的数据。
+ **复制请求 ID** – 获取此过程的请求 ID 以进行问题排查。Amazon Quick Sight 会生成一个字母数字请求编号来唯一标识每个流程。
+ **共享此视觉对象** – 安全地共享视觉对象中使用的主题的 URL。
+ **答案细分** – 查看答案的详细解释。
在主题屏幕的底部，您可以通过选择**编辑问题变体**来添加或更改问题的变体。同样在底部，您对问题和答案感到满意时，选择**标记为已审查**以将主题标记为已审查。或者，如果您发现之前审查的主题需要进一步审查，请选择**取消标记为已审查**。
您可以随时打开主题进行更改或审查其效果。要直接使用主题的设置（例如包含哪些字段或它们有哪些同义词），请使用**主题**页面。
**打开链接到分析的主题**
1. 在左侧导航窗格中选择****主题****，从快速入门页面打开 Amazon Quick Sight Topics 页面。
如果您想让分析保持打开状态，可以在新的浏览器选项卡或窗口中打开**主题**页面。
1. 要打开主题，请选择主题名称。如果您最近离开了分析页面，则该名称可能仍会显示在屏幕顶部的搜索栏中。
1. 如果您想随时返回到所有主题的列表，请选择主题工作区左侧的**所有主题**。
# 创建 “快速浏览” 主题
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：Amazon Quick 管理员和作者 |
要为数据集开启提问，您必须创建一个主题。Quick Sight 为创建主题提供了指导性工作流程。您可以退出引导式工作流程并稍后再回来，这不会中断您的工作。
可以使用两种方法创建主题：
+ 通过选择数据集来创建主题。在 Quick Sight 中创建主题时，可以向其中添加多个数据集，也可以在分析中启用主题。
+ 使用分析创建主题。当您在分析中创建主题或将现有主题链接到分析时，自动数据准备会从您分析数据的方式中学习，并自动将其应用于您的主题。
在你与 Quick 读者分享你的话题并让他们用它在搜索栏中提问之后，你可以看到该主题的表现摘要。您还可以查看用户询问的所有内容、回复情况以及您已验证的任何答案的列表。查看反馈非常重要，这样您的业务用户才能继续获得正确的可视化效果和问题答案。
## 创建主题
使用以下过程创建主题。
**要创建主题，请执行以下操作**
1. 在快速主页上，选择**主题**。
1. 在打开的**主题**页面上，选择右上角的**创建主题**。
1. 在打开的 “**创建主题**” 页面上，执行以下操作：
1. 对于**主题名称**，输入主题的描述性名称。
您的业务用户将使用此名称识别主题并用它来提问。
1. 对于**描述**，输入主题的描述。
您的用户可以使用此描述来获取有关该主题的更多详细信息。
1. 选择**继续**。
1. 在打开的**将数据添加到主题**页面上，选择以下选项之一：
+ 要添加一个或多个您拥有或有权访问的数据集，请选择**数据集**，然后选择要添加的一个或多个数据集。
+ 要从您创建或与您共享的仪表板中添加**数据集，请从仪表板**中选择数据集，然后从列表中选择仪表板。
1. 选择**添加数据**。
您的主题已创建，将打开该主题的页面。下一步是配置主题元数据以 natural-language-friendly供读者使用。有关更多信息，请参阅 [制作 “快速视觉” 话题 natural-language-friendly](topics-natural-language.md)。或者继续进入下一个主题以探索主题工作区。
# 主题工作区
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：Amazon Quick 管理员和作者 |
创建主题后，或者从**主题**页面的列表中选择现有主题时，该主题将打开到主题的工作区。此处将显示四个选项卡，您可以按照以下部分所述使用。Quick Sight 为主题提供了指导性工作流程。您可以退出引导式工作流程并稍后再回来，这不会中断您的工作。
## Summary
**摘要**选项卡有三个重要区域：
+ **建议** — 建议为如何改进主题提供 step-by-step指导。这些步骤可以帮助您了解如何创建效果更好的主题。
要遵循建议，请在“建议”横幅中选择“操作”按钮，然后按照建议的步骤进行操作。
目前，有八个预设建议按下表所示的顺序提供。完成建议步骤后，返回到**摘要**选项卡时，系统会提供新的建议。
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/zh_cn/quick/latest/userguide/topics-interface.html)
+ **关于话题参与度和绩效的指标和关键绩效指标 (KPIs)** — 在本节中，您可以看到读者如何与您的主题互动，以及他们对所提供的答案给出的反馈和评分。您可以查看用户提出的所有问题的参与度，也可以选择特定问题。您也可以将指标的时间跨度从一年更改为一周。
有关更多信息，请参阅 [查看 Quick Sight 主题表现和反馈](topics-performance.md)。
+ **数据集** – 本节显示用于创建主题的数据集。在本节中，您可以添加其他数据集或从现有控制面板导入数据集。您还可以编辑主题数据集的元数据、设置数据刷新计划、更改数据集的名称等。有关更多信息，请参阅 [在 Quick Sight 主题中使用数据集](topics-data.md)。
## 数据
**数据**选项卡显示主题中包含的所有字段。在这里，您可以配置主题元数据以创建您的主题 natural-language-friendly并提高主题效果。有关更多信息，请参阅 [制作 “快速视觉” 话题 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. 在打开的**数据集**页面上，选择要添加的一个或多个数据集，然后选择**添加数据集**。
数据集已添加到主题中，并对数据集的唯一字符串值进行索引。您可以立即编辑字段配置。有关更多信息，请参阅 [刷新快速浏览主题索引](topics-index.md)。有关编辑字段配置的更多信息，请参阅[制作 “快速视觉” 话题 natural-language-friendly](topics-natural-language.md)。
# 将具有行级安全 (RLS) 的数据集添加到 Amazon Quick Sight 主题中
您可以向主题中添加包含行级安全 (RLS) 的数据集。主题中的所有字段都遵循应用于数据集的 RLS 规则。例如，如果用户问 “按地区向我显示销售额”，则返回的数据将基于用户对基础数据的访问权限。因此，如果只允许他们看到东部区域，那么答案中只会显示东部地区的数据。
RLS 规则适用于用户提问时的自动建议。用户输入问题时，只会向他们建议他们有权访问的值。如果用户输入了有关他们无权访问的维度值的问题，则他们不会得到该值的答案。例如，假设同一个用户正在输入问题“向我显示西部区域的销售额。” 在这种情况下，即使他们提问，也得不到建议或答案，因为他们没有该区域的 RLS 访问权限。
默认情况下，Quick Sight 允许用户根据用户在 RLS 中的权限询问有关字段的问题。如果您的字段包含要限制访问的敏感数据，则继续使用此选项。如果您的字段不包含敏感信息，并且您希望所有用户都能在建议中看到这些信息，则可以选择允许对字段中的所有值提问。
**允许对所有字段提问**
1. 从 Quick 主页中，选择**数据**。
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 主题中刷新数据集
将数据集添加到主题时，可以指定希望数据集的刷新频率。刷新主题中的数据集时，将使用任何新的和更新的信息刷新该主题的索引。
当您将数据集添加到主题时，数据集不会被复制。创建了由唯一字符串值组成的索引，并且未对指标进行索引。例如，存储为整数的度量不会被索引。所提问题始终根据数据集中的数据获取最新的销售指标。
有关刷新主题索引的更多信息，请参阅 [刷新快速浏览主题索引](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 主题数据集添加筛选条件
有时，您的业务用户（读者）可能会提出包含映射到数据中多个值单元格的术语的问题。例如，假设您的一位读者问：“向我展示西方的每周销售趋势。” 在此例中，*West* 同时指 `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. 完成后，选择**保存**。
命名实体将添加到主题中的字段列表。您可以为其添加或编辑描述并添加同义词，使其适合自然语言。
# 制作 “快速视觉” 话题 natural-language-friendly
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：Amazon Quick 管理员和作者 |
创建主题时，Quick Sight 会创建、存储和维护一个索引，其中包含该主题中数据的定义。该索引用于生成正确答案，在有人提问时提供自动完成建议，以及建议术语与列或数据值的映射。这就是如何在读者的提问中解释关键术语并将其映射到您的数据中。
为了帮助解释您的数据并更好地回答读者的问题，请尽可能多地提供有关您的数据集及其相关字段的信息。
使用以下过程来完成此操作，使您的主题更加丰富 natural-language-friendly。
**提示**
您可以使用批量操作一次编辑多个字段。按照以下步骤批量编辑主题中的字段。
**批量编辑主题中的字段**
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：将字段重命名为 natural-language-friendly
数据集中的字段通常根据技术命名约定命名。您可以通过重命名字段名称并添加描述，使主题中的字段名称更加便于用户记忆。
字段名称用于理解这些字段，并将它们与读者提问中的术语相关联。当您的字段名称易于使用时，可以更轻松地在数据和读者的问题之间建立联系。这些易记名称也作为问题答案的一部分呈现给读者，以提供更多的上下文信息。
**重命名字段并添加描述**
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 使用默认聚合为 `count distinct` 的字段 `Product ID` 来回答问题。这样做会生成一个视觉对象，其中显示产品 ID 的不同数量。
*不允许的聚合*是被排除在外、不用于在字段上回答问题的聚合。即使问题明确要求不允许的聚合，也会将其排除在外。例如，假设您指定 `Product ID` 字段永远不按 `sum` 进行聚合。即使你的一个读者问：“昨天总共售出了多少产品？” `sum` 不是用来回答这个问题的。
如果在字段上错误地应用了聚合函数，我们建议您为该字段设置不允许的聚合。
**设置字段聚合**
1. 打开要更改的主题。
1. 在主题中，选择**数据**选项卡。
1. 在**字段**部分中，选择最右侧的向下箭头以展开有关字段的信息。
1. 对于**默认聚合**，选择要在默认情况下聚合字段的聚合。
您可以按总和、平均值、最大值和最小值聚合度量。您可以按计数和不同计数来聚合维度。
1. （可选）对于 “**不允许的**聚合”，请选择您不想使用的聚合。
1. （可选）如果您不想在筛选器中聚合该字段，请选择 “**从不在筛选器中聚合**”。
### 指定如何格式化字段值
如果你想解释如何格式化字段中的值，你可以这样做。例如，假设您有字段 `Order Sales Amount`，其中包含要格式化为美元的值。在这种情况下，您可以解释在答案中使用时如何将字段中的值格式化为美元。
**指定如何格式化字段值**
1. 打开要更改的主题。
1. 在主题中，选择**数据**选项卡。
1. 在**字段**部分中，选择最右侧的向下箭头以展开有关字段的信息。
1. 对于**值格式**，选择格式化字段中值的方式。
### 指定字段语义类型
字段*语义类型*是字段中数据所表示的信息类型。例如，您可能有一个包含位置数据、货币数据、年龄数据或布尔数据的字段。您可以为字段指定语义类型和其他语义子类型。指定这些内容有助于理解存储在字段中的数据的含义。
使用以下过程指定字段语义类型和子类型。
**指定字段语义类型**
1. 打开要更改的主题。
1. 在主题中，选择**数据**选项卡。
1. 在**字段**部分中，选择最右侧的向下箭头以展开有关字段的信息。
1. 对于**语义类型**，选择数据表示的信息类型。
对于度量，您可以选择持续时间、日期部分、位置、布尔值、货币、百分比、年龄、距离和标识符类型。对于维度，您可以选择日期部分、位置、布尔值、人员、组织和标识符类型。
1. 对于**语义子类型**，选择选项以进一步指定数据表示的信息类型。
此处的选项取决于您选择的语义类型以及与该字段关联的角色。有关度量和维度的语义类型及其关联子类型的列表，请参阅下表。
| 语义类型 | 语义子类型 | 适用于以下对象 |
| --- | --- | --- |
| 天数 | | 度量 |
| 布尔值 | | 维度和度量 |
| 货币 | USD 欧元 GBP | 度量 |
| 日期部分 | 天 周 Month Year 季度 | 维度和度量 |
| 距离 | 公里 计量器 码 英尺 | 度量 |
| Duration | 秒 分钟 小时 天 | 度量 |
| 标识符 | | 维度和度量 |
| 位置 | 邮政编码 Country（国家/地区） 州 City（城市） | 维度和度量 |
| Organization（组织） | | Dimensions |
| 百分比 | | 度量 |
| 人员 | | Dimensions |
# 分享快速浏览话题
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：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 管理员和作者 |
创建主题并与用户共享后，您可以审查该主题的效果。当有人使用你的话题提问或提供关于回复效果的反馈时，它会记录在主题的 “**摘要**” 和 “**用户活动**” 选项卡上。
在主题的**摘要**选项卡上，您可以查看一段时间内（从七天到一年）提出的问题数量的历史数据。您还可以看到收到正面反馈、负面反馈或未收到反馈的问题以及无法回答的问题的分布情况。
在**用户活动**选项卡上，您可以看到用户提出的问题列表以及他们留下的任何正面或负面反馈以及评论。
审查这些信息可以帮助您确定主题是否满足用户的需求。例如，假设您的主题收到了来自用户的大量负面反馈。当您查看用户活动时，您会注意到有几个用户对一个问题发表了评论，这些评论向他们显示了错误的数据。作为响应，您检查了他们提出的问题，发现他们使用了意料之外的术语。您决定将该术语作为同义词添加到主题的正确字段中。随着时间的推移，您注意到正面反馈有所增加。
## 审查主题效果
使用以下步骤查看主题的效果。
**查看主题的效果**
1. 在快速入门页面上，选择左侧**的主题**。
1. 在打开的**主题**页面上，打开要审查的主题。
随即将打开主题，**统计数据**部分显示该主题的统计数据。
1. （可选）要更改图表中显示的历史数据数量，请选择以下选项之一：**7 天**、**30 天**、**90 天**、**120 天**或 **12 个月**。
1. （可选）要从数据中删除无法回答的问题，请清除**包括无法回答的数据**。
1. （可选）要从数据中删除未收到反馈的问题，请清除**包括无反馈数据**。
## 审查主题问题和反馈
使用以下过程审查主题的问题和反馈。
**审查主题问题和反馈**
1. 在快速入门页面上，选择**主题**。
1. 在打开的**主题**页面上，打开要审查其反馈的主题。
1. 在打开的“主题”页面上，选择**用户活动**选项卡。
将显示该主题的用户活动。在前面部分，您可以看到所提问题的总数以及可以回答和无法回答的问题数量。您还可以查看评为正面和负面的问题所占的百分比。此外，您还可以看到已消除歧义的问题所占的百分比。这意味着有人输入了问题，并将问题中的一个单词映射到主题中的一个字段。
您可以选择这些统计数据中的任何一个以筛选问题列表。
1. （可选）要查看用户对问题留下的评论，请选择问题右侧的向下箭头。
评论显示在左侧。
1. （可选）要查看用于回答问题的字段，请选择问题右侧的向下箭头。
使用的字段显示在右侧。选择字段名称以编辑其元数据。
1. （可选）要查看已消除歧义的问题，请选择问题右侧的向下箭头，其中术语以红色突出显示。
显示了术语的描述以及用于消除歧义的字段。要为字段添加同义词，请选择**添加同义词**。
1. （可选）要查看问题是如何回答的，请选择列表中问题旁边的**查**看。
1. （可选）要筛选问题列表，请选择右侧的**筛选条件**，然后按以下选项之一筛选。
+ **查看所有问题** – 此选项可删除所有筛选条件并显示主题已收到的所有问题。
+ **可回答** – 此选项将问题列表筛选为可回答的问题。可回答的问题是 Q 能够回答的问题。
+ **无法回答** – 此选项将问题列表筛选为无法回答的问题。无法回答的问题是 Q 无法回答的问题。
+ **消除歧义** – 此选项将问题列表筛选为已消除歧义的问题，即带有用户手动将字段映射到的术语的问题。
+ **无反馈** – 此选项将问题列表筛选为未收到反馈的问题。
+ **负面反馈** – 此选项将问题列表筛选为收到负面反馈的问题。
+ **正面反馈** – 此选项将问题列表筛选为收到正面反馈的问题。
+ **无评论** – 此选项将问题列表筛选为未收到用户评论的问题。
+ **有评论** – 此选项将问题列表筛选为收到用户评论的问题。
+ **用户** – 此选项将问题列表筛选为使用您输入的特定用户名的用户提出的问题。
# 刷新快速浏览主题索引
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：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 处理 Quick Sight 主题 APIs
| |
| --- |
| 适用于：企业版 |
| |
| --- |
| 目标受众：Amazon Quick 开发者 |
使用本节学习如何使用 Amazon Quick Sight 命令行界面 (CLI) 处理 Quick Sight 主题。
**先决条件**
在开始之前，请确保您拥有一个 AWS Identity and Access Management (IAM) 角色，该角色可向 CLI 用户授予调用 Quick Sight API 操作的访问权限。下表显示必须向 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` API 操作的 IAM 策略。
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"quicksight:ListTopics"
],
"Resource": "*"
}
]
}
```
------
配置了使用 Quick Sight 创建 Quick Sight 主题的权限后 APIs，请使用以下主题来创建和使用 Quick Sight 主题 APIs。
**Topics**
+ [使用 Quick Sight 处理 Quick Sight 主题 APIs](topic-cli-examples.md)
+ [使用 Quick Sight CLI 配置 Quick Sight 主题刷新计划](topic-refresh-apis.md)
+ [在内部和之间复制和迁移 Quick Sight 主题 AWS 账户](topic-cli-walkthroughs.md)
+ [使用 Quick Sight 在 Quick Sight 主题中创建和修改已审阅的 APIs](topic-reviewed-answer-apis.md)
# 使用 Quick Sight 处理 Quick Sight 主题 APIs
以下示例创建了一个新主题。
```
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
```
以下示例提供了 Quick 账户中所有主题的列表。
```
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`参数向 Quick 账户用户授予读取和作者权限。要向账户用户授予读取权限，请输入以下值：`"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 命令查看 Quick 账户中每个主题的列表。
```
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 在 Quick Sight 主题中创建和修改已审阅的 APIs
创建 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 将更新的已审核答案添加到主题。