

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Trabalhando com o Amazon Quick Sight Topics
<a name="topics"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Os *tópicos* são coleções de um ou mais conjuntos de dados que representam uma área temática sobre a qual seus usuários corporativos podem fazer perguntas. 

Com a preparação automatizada de dados do Quick Sight, você recebe uma assistência baseada em ML para ajudá-lo a criar um tópico relevante para seus usuários finais. O primeiro processo começa pela seleção e pela classificação automatizadas de campos, algo como abaixo:
+ A preparação automatizada de dados escolhe um pequeno número de campos a serem incluídos por padrão para criar um espaço de dados focado para os leitores explorarem.
+ A preparação automatizada de dados seleciona campos que você usa em outros ativos, como relatórios e painéis. 
+ A preparação automatizada de dados também importa quaisquer campos adicionais de qualquer análise relacionada em que um tópico esteja ativado. 
+ Ela identifica datas, dimensões e medidas para saber como os campos podem ser usados nas respostas.

Esse conjunto automático de campos ajuda o autor a começar a usar rapidamente o analytics de linguagem natural. Os autores sempre podem excluir ou incluir campos, conforme necessário, usando o seletor **Incluir**.

Em seguida, a preparação automatizada de dados continua com o processo, rotulando automaticamente os campos e identificando sinônimos. A preparação automatizada de dados atualiza os nomes dos campos com nomes e sinônimos amigáveis usando termos comuns. Por exemplo, um campo `SLS_PERSON` pode ser renomeado como `Sales person` e ter sinônimos atribuídos, incluindo: `salesman`, `saleswoman`, agente e `sales representative`. Embora você possa permitir que a preparação automatizada de dados faça grande parte do trabalho, vale a pena revisar os campos, os nomes e os sinônimos para personalizá-los ainda mais para seus usuários finais. Por exemplo, se os usuários se referirem a um profissional de vendas como “representante” ou “revendedor” em uma conversa casual, você dará suporte a esse termo adicionando `rep` e `dealer` aos sinônimos de `SLS_PERSON`. 

Por fim, a preparação automatizada de dados detecta o tipo semântico de cada campo, amostrando seus dados e examinando os formatos aplicados pelo autor durante a análise. A preparação automatizada de dados atualiza a configuração do campo automaticamente, definindo formatos para os valores usados para cada campo. Portanto, as respostas às perguntas são fornecidas nos formatos esperados para datas, moedas, identificadores, valores booleanos, pessoas etc. 

Para saber mais sobre como trabalhar com tópicos, continue nas seções a seguir neste capítulo.

**Topics**
+ [Tópicos de navegação](navigating-topics.md)
+ [Criação de tópicos do Quick Sight](topics-create.md)
+ [Espaço de trabalho de tópicos](topics-interface.md)
+ [Trabalhando com conjuntos de dados em um tópico do Quick Sight](topics-data.md)
+ [Como criar tópicos do Quick Sight natural-language-friendly](topics-natural-language.md)
+ [Compartilhando tópicos do Quick Sight](topics-sharing.md)
+ [Gerenciando permissões de tópicos do Amazon Quick Sight](topics-sharing-permissions.md)
+ [Analisando o desempenho e o feedback do tópico do Quick Sight](topics-performance.md)
+ [Atualizando índices de tópicos do Quick Sight](topics-index.md)
+ [Trabalhe com tópicos do Quick Sight usando o Amazon Quick Sight APIs](topics-cli.md)

# Tópicos de navegação
<a name="navigating-topics"></a>

No Quick Sight, há mais de uma maneira de criar e gerenciar um tópico. Você pode começar em uma página inicial ou página de “início” do Amazon Quick. Ou você pode começar dentro de uma análise.

**Topics**
+ [De uma página inicial do Amazon Quick](starting-from-home.md)
+ [De uma análise do Amazon Quick Sight](starting-from-sheets.md)
+ [Navegando por perguntas em uma análise do Amazon Quick Sight](starting-from-questions-on-sheets.md)

# De uma página inicial do Amazon Quick
<a name="starting-from-home"></a>

Na página de início rápido, você pode criar e gerenciar tópicos selecionando **Tópicos** no painel de navegação à esquerda. O Quick fornece um fluxo de trabalho guiado para a criação de tópicos. Você pode sair do fluxo de trabalho guiado e retornar a ele mais tarde, sem interromper seu trabalho. 

Quando você cria um tópico, seus usuários corporativos podem fazer perguntas sobre ele. A qualquer momento, você pode abrir um tópico para alterá-lo ou revisar seu desempenho.

Para abrir um tópico, escolha o nome do tópico.

Se, a qualquer momento, você quiser retornar a uma lista de todos os seus tópicos, escolha **Todos os tópicos** à esquerda do espaço de trabalho do tópico.

# De uma análise do Amazon Quick Sight
<a name="starting-from-sheets"></a>

Para começar com uma análise do Amazon Quick Sight, abra a análise que você deseja usar com a preparação automatizada de dados.

Para abrir ou criar um tópico, escolha o ícone do tópico na barra de navegação superior.

A qualquer momento, você pode abrir um tópico para alterá-lo ou revisar seu desempenho.

Para abrir um tópico com base em uma análise, escolha o nome do tópico na barra de navegação superior, se ele ainda não estiver exibido. Em seguida, selecione o ícone de reticências verticais (` ⋮ `) na barra de navegação superior. 

Para ver informações sobre o tópico, selecione **Sobre o tópico**.

Para visualizar os campos de dados incluídos no tópico, selecione **Campos de dados** na lista de guias.

# Navegando por perguntas em uma análise do Amazon Quick Sight
<a name="starting-from-questions-on-sheets"></a>

Ao navegar pelas perguntas e respostas de um tópico em uma análise, você pode saber como o tópico está sendo usado. Essas informações podem avisar você para fazer ajustes, se necessário. 

Partindo de uma análise que já está vinculada a um tópico, selecione a barra de pesquisa na barra de navegação superior e, em seguida, insira uma pergunta. A resposta é exibida em uma tela de tópico que também exibe todas as opções disponíveis para trabalhar com o tópico em uma análise. 
+ Para alterar o tipo de elemento visual exibido na resposta, selecione o ícone de tipo (que é semelhante a um gráfico de barras).
+ Para visualizar sugestões de melhoria, selecione o balão de diálogo, que é destacado se você tem sugestões não visualizadas.
+ Para visualizar insights relacionados a uma pergunta, selecione o ícone da lâmpada.
+ Para adicionar ou remover uma pergunta do quadro de avisos, alterne o ícone para **Adicionar ao quadro de avisos** ou **Remover do quadro de avisos**. Você pode visualizar o quadro de avisos ao selecionar o ícone do quadro de avisos na barra de navegação superior.
+ Para visualizar informações sobre esse tópico, selecione o *i* minúsculo circundado (` ![\[alt text not found\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/images/status-info.png) `).
+ Selecione o menu de reticências (` … `) para executar uma das seguintes ações: 
  + **Exportar para CSV**: exporte os dados exibidos no elemento visual selecionado.
  + **Copiar ID da solicitação**: capture o ID da solicitação deste processo para solução de problemas. O Amazon Quick Sight gera uma ID de solicitação alfanumérica para identificar de forma exclusiva cada processo. 
  + **Compartilhar este elemento visual**: compartilhe com segurança um URL para o tópico usado no elemento visual.
  + **Detalhamento da resposta**: para visualizar uma explicação detalhada da sua resposta.

Na parte inferior da tela do tópico, você pode adicionar ou alterar variações na pergunta ao selecionar **Editar variantes da pergunta**. Além disso, na parte inferior, quando estiver satisfeito com a pergunta e a resposta, marque o tópico como revisado escolhendo **Marcar como revisado**. Ou, se você perceber que um tópico revisado anteriormente precisa ser revisado de novo, escolha **Desmarcar como revisado**. 

A qualquer momento, você pode abrir um tópico para alterá-lo ou revisar seu desempenho. Para trabalhar diretamente com as configurações de um tópico, como quais campos estão incluídos ou quais sinônimos eles têm, use a página **Tópicos**.

**Abrir um tópico vinculado a uma análise**

1. Abra a página Amazon Quick Sight **Topics** na página de início rápido, selecionando **Tópicos** no painel de navegação à esquerda.

   Se quiser manter sua análise aberta, você pode abrir a página **Tópicos** em uma nova guia ou janela do navegador.

1. Para abrir um tópico, escolha o nome do tópico. Se você saiu recentemente da página de análise, o nome provavelmente ainda é exibido na barra de pesquisa na parte superior da tela.

1. Se, a qualquer momento, você quiser retornar a uma lista de todos os seus tópicos, escolha **Todos os tópicos** à esquerda do espaço de trabalho do tópico.

# Criação de tópicos do Quick Sight
<a name="topics-create"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Para ativar as perguntas dos seus conjuntos de dados, você precisa criar um tópico. O Quick Sight fornece um fluxo de trabalho guiado para criar tópicos. Você pode sair do fluxo de trabalho guiado e retornar a ele mais tarde, sem interromper seu trabalho. 

Existem duas maneiras de criar um tópico:
+ Crie o tópico selecionando um conjunto de dados. Ao criar tópicos no Quick Sight, você pode adicionar vários conjuntos de dados a eles e também habilitar os tópicos nas análises. 
+ Crie o tópico usando uma análise. Quando você cria um tópico em uma análise ou vincula um tópico existente a uma análise, a preparação automatizada de dados aprende com a forma como você analisa seus dados e os aplica automaticamente ao seu tópico. 

Depois de compartilhar seu tópico com os leitores do Quick e eles o usarem para fazer perguntas na barra de pesquisa, você poderá ver um resumo do desempenho do tópico. Você também pode ver uma lista de tudo o que os usuários perguntaram e quão bem foram respondidos, além de todas as respostas que você verificou. Analisar o feedback é importante para que seus usuários corporativos possam continuar recebendo as visualizações e respostas corretas às suas perguntas.

## Criar um tópico
<a name="topics-create-how"></a>

Use o procedimento a seguir para criar um tópico.

**Para criar um tópico**

1. Na página inicial do Quick, escolha **Tópicos**.

1. Na página **Tópicos** que se abre, escolha **Criar tópico** no canto superior direito.

1. Na página **Criar tópico** que se abre, faça o seguinte:

   1. Em **Nome do tópico**, insira um nome descritivo para o tópico.

      Seus usuários corporativos identificam o tópico por esse nome e o usam para fazer perguntas.

   1. Em **Descrição**, insira uma descrição para o tópico.

      Seus usuários podem usar essa descrição para obter mais detalhes sobre o tópico.

   1. Escolha **Continuar**.

1. Na página **Adicionar dados ao tópico** que é aberta, escolha uma das seguintes opções:
   + Para adicionar um ou mais conjuntos de dados que você possui ou para os quais tem permissão, escolha **Conjuntos de dados** e, em seguida, selecione os conjuntos de dados que você deseja adicionar.
   + Para adicionar conjuntos de dados de painéis que você criou ou que foram compartilhados com você, escolha **Conjuntos de dados em um painel** e selecione um painel na lista.

1. Escolha **Adicionar dados**.

   Seu tópico é criado e a página desse tópico é aberta. A próxima etapa é configurar os metadados do tópico natural-language-friendly para torná-los acessíveis aos seus leitores. Para obter mais informações, consulte [Como criar tópicos do Quick Sight natural-language-friendly](topics-natural-language.md). Ou vá para o próximo tópico para explorar o espaço de trabalho do tópico.

# Espaço de trabalho de tópicos
<a name="topics-interface"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Depois que você criar um tópico ou quando escolher um tópico existente na lista da página **Tópicos**, o tópico é aberto na área de trabalho desse tópico. Aqui são exibidas quatro guias que você pode usar conforme descrito nas seções a seguir. O Quick Sight fornece um fluxo de trabalho guiado para tópicos. Você pode sair do fluxo de trabalho guiado e retornar a ele mais tarde, sem interromper seu trabalho. 

## Resumo
<a name="topics-interface-summary"></a>

A guia **Resumo** tem três áreas importantes:
+ **Sugestões** — As sugestões fornecem step-by-step orientação sobre como você pode melhorar um tópico. Essas etapas ajudam você a entender como criar tópicos com melhor desempenho.

  Para seguir uma sugestão, escolha o botão de ação no banner Sugestão e siga as etapas recomendadas.

  Atualmente, há oito sugestões predefinidas que são oferecidas na ordem mostrada na tabela a seguir. Depois que você concluir uma etapa para uma sugestão, uma nova sugestão será oferecida quando você retornar à guia **Resumo**.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/quick/latest/userguide/topics-interface.html)
+ **Métricas e indicadores-chave de desempenho (KPIs) sobre engajamento e desempenho em tópicos** — Nesta seção, você pode ver como seus leitores interagem com seus tópicos e quais comentários e avaliações eles dão sobre as respostas fornecidas. Você pode ver o envolvimento de todas as perguntas feitas pelos usuários ou selecionar uma pergunta específica. Você também pode alterar o intervalo de tempo das métricas de um ano para uma semana.

  Para obter mais informações, consulte [Analisando o desempenho e o feedback do tópico do Quick Sight](topics-performance.md).
+ **Conjuntos de dados**: esta seção mostra os conjuntos de dados que foram usados para criar o tópico. Nesta seção, você pode adicionar conjuntos de dados ou importar conjuntos de dados de painéis existentes. Você também pode editar os metadados de um conjunto de dados de tópico, definir uma programação de atualização de dados, alterar o nome do conjunto de dados e muito mais. Para obter mais informações, consulte [Trabalhando com conjuntos de dados em um tópico do Quick Sight](topics-data.md).

## Dados
<a name="topics-interface-data"></a>

A guia **Dados** mostra todos os campos incluídos no tópico. Aqui você configura os metadados do tópico para criar seu tópico natural-language-friendly e melhorar o desempenho do tópico. Para obter mais informações, consulte [Como criar tópicos do Quick Sight natural-language-friendly](topics-natural-language.md).

## Atividade do usuário
<a name="topics-interface-user"></a>

Essa guia mostra todas as perguntas que o tópico recebe e o feedback geral de cada pergunta. Você pode ter uma visão geral de quantas perguntas foram feitas e que porcentagem delas foi positiva e negativa. Você pode filtrar por feedback e se alguém deixou um comentário com o feedback. Para obter mais informações, consulte [Analisando o desempenho e o feedback do tópico do Quick Sight](topics-performance.md).

## Respostas verificadas
<a name="topics-interface-answers"></a>

*Respostas verificadas* são perguntas para as quais você pré-configurou elementos visuais. Você pode criar uma resposta verificada para uma pergunta fazendo a pergunta na barra de pesquisa e marcando-a como revisada. Ao usar a guia **Respostas verificadas**, você pode revisar suas respostas verificadas e o feedback que elas recebem dos seus usuários.

# Trabalhando com conjuntos de dados em um tópico do Quick Sight
<a name="topics-data"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Ao criar um tópico, você pode adicionar conjuntos de dados a ele ou importar conjuntos de dados de painéis existentes. A qualquer momento, você pode editar os metadados de um conjunto de dados e definir uma programação de atualização de dados. Você também pode adicionar campos a um conjunto de dados em um tópico ao criar campos calculados, filtros ou entidades denominadas.

**Topics**
+ [Adicionar conjuntos de dados a um tópico no Amazon Quick Sight](topics-data-add.md)
+ [Adicionar conjuntos de dados com segurança em nível de linha (RLS) a um tópico do Amazon Quick Sight](topics-data-rls.md)
+ [Atualizando conjuntos de dados em um tópico do Quick Sight](topics-data-refresh.md)
+ [Removendo conjuntos de dados de um tópico do Amazon Quick Sight](topics-data-remove.md)
+ [Adicionar campos calculados a um conjunto de dados de tópicos do Amazon Quick Sight](topics-data-calculated-fields.md)
+ [Adicionar filtros a um conjunto de dados de tópicos do Amazon Quick Sight](topics-data-filters.md)
+ [Adicionar entidades nomeadas a um conjunto de dados de tópicos do Amazon Quick Sight](topics-data-entities.md)

# Adicionar conjuntos de dados a um tópico no Amazon Quick Sight
<a name="topics-data-add"></a>

A qualquer momento, você pode adicionar conjuntos de dados a um tópico. Use o procedimento a seguir para saber como.

**Adicionar conjuntos de dados a um tópico**

1. Abra o tópico ao qual você deseja adicionar um ou mais conjuntos de dados.

1. Na página **Resumo**, escolha **Dados**. Em seguida, em **Conjuntos de dados**, escolha **Adicionar conjuntos** de dados.

1. Na página **Adicionar conjuntos de dados** que é aberta, escolha os conjuntos de dados que você deseja atualizar e, em seguida, escolha **Adicionar conjuntos de dados**.

   O conjunto de dados é adicionado ao tópico e os valores de string exclusivos do conjunto de dados são indexados. Você pode editar as configurações dos campos imediatamente. Para obter mais informações, consulte [Atualizando índices de tópicos do Quick Sight](topics-index.md). Para obter mais informações sobre edição de configurações de campo, consulte[Como criar tópicos do Quick Sight natural-language-friendly](topics-natural-language.md).

# Adicionar conjuntos de dados com segurança em nível de linha (RLS) a um tópico do Amazon Quick Sight
<a name="topics-data-rls"></a>

Você pode adicionar conjuntos de dados que contêm segurança em nível de linha (RLS) aos tópicos. Todos os campos de um tópico respeitam as regras de RLS aplicadas ao conjunto de dados. Por exemplo, se um usuário perguntar “mostre-me vendas por região”, os dados retornados se baseiam no acesso do usuário aos dados subjacentes. Então, se eles só tiverem permissão para ver a região Leste, somente os dados da região Leste aparecerão na resposta.

As regras de RLS são aplicadas às sugestões automáticas quando os usuários estão fazendo perguntas. À medida que os usuários inserem perguntas, somente os valores aos quais eles têm acesso são sugeridos a eles. Se um usuário inserir uma pergunta sobre um valor dimensional ao qual não tem acesso, não receberá respostas para esse valor. Por exemplo, suponha que o mesmo usuário esteja inserindo a pergunta “mostre-me vendas na região oeste”. Nesse caso, ele não receberá qualquer sugestão ou resposta, mesmo que pergunte, porque não tem acesso a RLS naquela região.

Por padrão, o Quick Sight permite que os usuários façam perguntas sobre campos com base nas permissões do usuário no RLS. Continue a usar essa opção se o campo contiver dados confidenciais aos quais você deseja restringir o acesso. Se seus campos não contiverem informações confidenciais e você quiser que todos os usuários vejam as informações nas sugestões, você pode optar por permitir perguntas para todos os valores no campo.

**Permitir perguntas para todos os campos**

1. Na página inicial do Quick, escolha **Dados**.

1. **Na guia **Conjuntos** de dados, escolha o conjunto de dados ao qual você adicionou o RLS e, em seguida, escolha Editar conjunto de dados.**

   Para obter mais informações sobre a adição de RLS a um conjunto de dados, consulte [Usando a segurança em nível de linha no Amazon Quick](row-level-security.md).

1. Na página de preparação de dados, escolha o menu de campo (os três pontos) para um campo que você deseja permitir e, em seguida, escolha **Segurança em nível de linha**.

1. Na página **Segurança em nível de linha para Quick** que se abre, escolha **Permitir que os usuários façam perguntas sobre todos os valores desse campo**.

1. Escolha **Aplicar**.

1. Ao terminar de editar o conjunto de dados, escolha **Salvar e publicar** na barra de ferramentas azul no canto superior direito.

1. Adicione o conjunto de dados ao seu tópico. Para obter mais informações, consulte a seção anterior, [Adicionar conjuntos de dados a um tópico no Amazon Quick Sight](topics-data-add.md).

Se você, no momento, permite que os usuários façam perguntas sobre todos os valores, mas deseja implementar as regras de RLS do conjunto de dados para proteger informações confidenciais, repita as etapas de 1 a 4 e escolha **Permitir que os usuários façam perguntas sobre este campo com base nas permissões deles**. Depois de concluir, atualize o conjunto de dados no tópico. Para obter mais informações, consulte [Atualizando conjuntos de dados em um tópico do Quick Sight](topics-data-refresh.md).

# Atualizando conjuntos de dados em um tópico do Quick Sight
<a name="topics-data-refresh"></a>

Ao adicionar um conjunto de dados a um tópico, você pode especificar com que frequência deseja que esse conjunto de dados seja atualizado. Quando você atualiza conjuntos de dados em um tópico, o índice é atualizado para esse tópico com todas as informações novas e atualizadas. 

Seus conjuntos de dados não são replicados quando você os adiciona a um tópico. Um índice de valores de sequência de caracteres exclusivos é criado e as métricas não são indexadas. Por exemplo, medidas armazenadas como números inteiros não são indexadas. As perguntas feitas sempre buscam as métricas de vendas mais recentes com base nos dados do seu conjunto de dados.

Para obter mais informações sobre a atualização do índice do tópico, consulte [Atualizando índices de tópicos do Quick Sight](topics-index.md).

Você pode definir uma programação de atualização de um conjunto de dados em um tópico ou atualizar o conjunto de dados manualmente. Você também pode ver quando os dados foram atualizados pela última vez. 

**Definir uma programação de atualização de um conjunto de dados de tópicos**

1. Abra o tópico que você deseja alterar.

1. Na página **Resumo**, escolha **Dados**. Em seguida, em **Conjuntos de dados**, expanda o conjunto de dados para o qual você deseja definir um cronograma de atualização.

1. Escolha **Adicionar programação** e, em seguida, execute uma das ações a seguir na página **Adicionar programação de atualização** que é aberta.
   + Se o conjunto de dados for um conjunto de dados do SPICE, selecione **Atualizar tópico quando o conjunto de dados for importado para o SPICE**.

     Atualmente, não há suporte para SPICE conjuntos de dados de atualização horária. SPICEconjuntos de dados configurados para serem atualizados a cada hora são automaticamente convertidos em uma atualização diária. Para obter mais informações sobre a definição de programações de atualização para conjuntos de dados do SPICE, consulte [Como atualizar dados do SPICE](refreshing-imported-data.md).
   + Se o conjunto de dados for um conjunto de dados de consulta direta, faça o seguinte:

     1. Em **Fuso horário**, escolha um fuso horário.

     1. Em **Repetições**, escolha com que frequência você deseja que a atualização ocorra. Você pode optar por atualizar o conjunto de dados diariamente, semanalmente ou mensalmente.

     1. Em **Hora da atualização**, insira a hora em que você deseja que a atualização seja iniciada.

     1. Em **Iniciar primeira atualização em**, escolha uma data na qual você deseja começar a atualizar o conjunto de dados.

1. Escolha **Salvar**.

**Atualizar manualmente um conjunto de dados**

1. Na página **Resumo do** tópico, escolha **Dados**. Em seguida, em **Conjuntos de dados**, escolha o conjunto de dados que você deseja atualizar.

1. Escolha **Atualizar agora**.

**Visualizar o histórico de atualizações de um conjunto de dados**

1. Na página **Resumo do** tópico, escolha **Dados**. Em seguida, em **Conjuntos de dados**, escolha o conjunto de dados do qual você deseja ver o histórico de atualização.

1. Selecione **Visualizar histórico**.

   A página **Histórico de atualizações** é aberta com uma lista das horas em que o conjunto de dados foi atualizado.

# Removendo conjuntos de dados de um tópico do Amazon Quick Sight
<a name="topics-data-remove"></a>

Você pode remover conjuntos de dados de um tópico. Remover conjuntos de dados de um tópico não os exclui do Quick Sight. 

Use o procedimento a seguir para remover um conjunto de dados de um tópico.

**Remover um conjunto de dados de um tópico**

1. Abra o tópico que você deseja alterar.

1. Na página **Resumo**, escolha **Dados**. Em seguida, em **Conjuntos de dados**, escolha o menu do conjunto de dados (os três pontos) à direita e escolha **Remover** do tópico.

1. Na página **Tem certeza de que deseja excluir?** que é aberta, escolha **Excluir** para remover o conjunto de dados do tópico. Escolha **Cancelar** se você não quiser remover o conjunto de dados do tópico.

# Adicionar campos calculados a um conjunto de dados de tópicos do Amazon Quick Sight
<a name="topics-data-calculated-fields"></a>

Você pode criar novos campos em um tópico ao criar campos calculados. *Campos calculados* são campos que usam uma combinação de um ou dois campos de um conjunto de dados com uma função compatível para criar novos dados. 

Por exemplo, se o conjunto de dados contiver colunas para vendas e despesas, você poderá combiná-las em um campo calculado com uma função simples para criar uma coluna de lucro. A função pode ser assim: `sum({Sales}) - sum({Expenses})`.

**Adicionar um campo calculado a um tópico**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Em **Ações**, escolha **Adicionar campo calculado**.

1. No editor de cálculos que é aberto, faça o seguinte:

   1. Dê ao campo calculado um nome amigável.

   1. Em **Conjuntos de dados** à direita, escolha um conjunto de dados que você deseja usar para o campo calculado.

   1. Insira um cálculo no editor de cálculos à esquerda.

      Você pode ver uma lista de campos do conjunto de dados no painel **Campos** à direita. Você também pode ver uma lista de funções compatíveis no painel **Funções** à direita.

      Para obter mais informações sobre as funções e os operadores que você pode usar para criar cálculos no Quick Sight, consulte [Função de campo calculada e referência do operador para o Amazon QuickFunções e operadores](calculated-field-reference.md) o.

1. Quando terminar, escolha **Save (Salvar)**.

   O campo calculado é adicionado à lista de campos no tópico. Você pode adicionar uma descrição a ele e configurar metadados para torná-lo mais amigável para linguagem natural.

# Adicionar filtros a um conjunto de dados de tópicos do Amazon Quick Sight
<a name="topics-data-filters"></a>

Às vezes, seus usuários corporativos (leitores) podem fazer perguntas que contêm termos mapeados para várias células de valores nos dados. Por exemplo, digamos que um de seus leitores pergunte: “Mostre-me a tendência de vendas semanais no oeste”. Neste exemplo, *Oeste* refere-se aos valores de `Northwest` e `Southwest` no campo `Region`, exigindo que os dados sejam filtrados para gerar uma resposta. Você pode adicionar filtros a um tópico para oferecer suporte a solicitações como essas.

**Adicionar um filtro a um tópico**

1. Abra o tópico ao qual você deseja adicionar um filtro.

1. No tópico, escolha a guia **Dados**.

1. Em **Ações**, selecione **Adicionar filtro**.

1. Na página **Configuração do filtro** que é aberta, faça o seguinte:

   1. Em **Nome**, insira um nome amigável para o filtro.

   1. Em **Conjunto de dados**, escolha um conjunto de dados ao qual você deseja aplicar o filtro.

   1. Em **Campo**, escolha o campo que você deseja filtrar.

      Dependendo do tipo de dados do campo que você escolher, serão oferecidas diferentes opções de filtragem.
      + Se você selecionou um campo de texto (por exemplo, `Region`), faça o seguinte:

        1. Em **Tipo de filtro**, escolha o tipo de filtro que você deseja.

           Para obter mais informações sobre campos de filtro de texto, consulte [Como adicionar filtros de texto](add-a-text-filter-data-prep.md).

        1. Em **Regra**, escolha uma regra.

        1. Em **Valor**, insira um ou mais valores.
      + Se você selecionou um campo de data (por exemplo, `Date`), faça o seguinte:

        1. Em **Tipo de filtro**, escolha o tipo de filtro que você deseja e, em seguida, insira a data ou datas às quais você deseja aplicar o filtro.

           Para obter mais informações sobre filtro de datas, consulte [Como adicionar filtros de data](add-a-date-filter2.md).
      + Se você selecionou um campo numérico (por exemplo, `Compensation`), faça o seguinte:

        1. Em **Agregação**, escolha como você deseja agregar os valores filtrados.

        1. **Em Regra**, escolha uma regra para o filtro e, em seguida, insira um valor para essa regra.

        Para obter mais informações sobre filtros de campos numéricos, consulte [Como adicionar filtros numéricos](add-a-numeric-filter-data-prep.md).

   1. (Opcional) Para especificar quando o filtro será aplicado, escolha **Aplicar o filtro sempre que o conjunto de dados for usado** e, em seguida, escolha uma das seguintes opções:
      + **Aplicar sempre**: quando você escolhe essa opção, o filtro é aplicado sempre que qualquer coluna do conjunto de dados especificado está vinculada a uma pergunta.
      + **Aplicar sempre, a menos que uma pergunta resulte em um filtro explícito do conjunto de dados**: quando você escolhe essa opção, o filtro é aplicado sempre que qualquer coluna do conjunto de dados especificado é vinculada a uma pergunta. No entanto, se a pergunta mencionar um filtro explícito no mesmo campo, o filtro não será aplicado.

   1. Quando terminar, escolha **Save (Salvar)**.

      O filtro será adicionado à lista de filtros do tópico. Você pode editar a descrição dele ou ajustar quando o filtro é aplicado.

# Adicionar entidades nomeadas a um conjunto de dados de tópicos do Amazon Quick Sight
<a name="topics-data-entities"></a>

Ao fazerem perguntas sobre seu tópico, os leitores podem se referir a várias colunas de dados sem declarar cada coluna explicitamente. Por exemplo, eles podem perguntar o endereço de uma transação. O que eles realmente querem dizer é que querem o nome da agência, o estado e a cidade em que a transação foi feita. Para oferecer suporte a solicitações como essa, você pode criar uma entidade denominada.

Uma *entidade denominada* é uma coleção de campos que são exibidos juntos em uma resposta. Por exemplo, usando o exemplo de endereço da transação, você pode criar uma entidade denominada `Address`. Em seguida, você pode adicionar a ela as colunas `Branch Name`, `State` e `City`, que já existem no conjunto de dados. Quando alguém faz uma pergunta sobre endereço, a resposta mostra a filial, o estado e a cidade em que a transação ocorreu.

**Adicionar uma entidade denominada a um tópico**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Em **Ações**, escolha **Adicionar entidade denominada**.

1. Na página **Entidade denominada** que é aberta, faça o seguinte:

   1. Em **Conjunto de dados**, escolha um conjunto de dados.

   1. Em **Nome**, insira um nome amigável para a entidade denominada.

   1. Em **Descrição**, insira uma descrição da entidade denominada.

   1. (Opcional) Em **Sinônimos**, adicione quaisquer nomes alternativos que você acha que seus leitores podem usar para se referir à entidade denominada ou aos dados que ela contém.

   1. Escolha **Adicionar campo** e, em seguida, escolha um campo na lista.

      Escolha **Adicionar campo** novamente para adicionar outro campo.

      A ordem dos campos listados aqui é a ordem em que eles aparecem nas respostas. Para mover um campo, escolha os seis pontos à esquerda do nome do campo e arraste e solte o campo na ordem desejada.

   1. Quando terminar, escolha **Save (Salvar)**.

   A entidade denominada é adicionada à lista de campos do tópico. Você pode editar uma descrição e adicionar sinônimos a ele para torná-lo mais amigável para linguagem natural.

# Como criar tópicos do Quick Sight natural-language-friendly
<a name="topics-natural-language"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Quando você cria um tópico, o Quick Sight cria, armazena e mantém um índice com definições para os dados desse tópico. Esse índice é usado para gerar respostas corretas, fornecer sugestões de preenchimento automático quando alguém faz uma pergunta e sugerir mapeamentos de termos para colunas ou valores de dados. É assim que os termos-chave podem ser interpretados nas perguntas de seus leitores e mapeados em seus dados. 

Para ajudar a interpretar seus dados e responder melhor às perguntas dos leitores, forneça o máximo possível de informações sobre seus conjuntos de dados e seus campos associados.

Use os procedimentos a seguir para fazer isso, ampliando seus tópicos natural-language-friendly.

**dica**  
Você pode editar vários campos de uma vez usando ações em massa. Use o procedimento a seguir para editar campos em massa em um tópico.

**Editar campos em massa em um tópico**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Em **Campos**, selecione dois ou mais campos que você deseja alterar.

1. Escolha **Ações em massa** na parte superior da lista.

1. Na página **Ações em massa** que é aberta, configure os campos como quiser e escolha **Aplicar a**.

   As opções de configuração são descritas nas etapas a seguir.

## Etapa 1: dar nomes e descrições amigáveis aos conjuntos de dados
<a name="topics-natural-language-dataset-name"></a>

Os nomes dos conjuntos de dados muitas vezes se baseiam em convenções técnicas de nomenclatura que os leitores talvez não usem naturalmente para se referir a eles. Recomendamos que você dê nomes e descrições amigáveis aos seus conjuntos de dados para fornecer mais informações sobre os dados que eles contêm. Esses nomes e descrições amigáveis são usados para entender o conteúdo do conjunto de dados e selecionar um conjunto de dados com base na pergunta do leitor. Os nomes dos conjuntos de dados também são mostrados ao leitor para fornecer contexto adicional para uma resposta.

Por exemplo, se seu conjunto de dados for denominado `D_CUST_DLY_ORD_DTL`, você poderá renomeá-lo no tópico para `Customer Daily Order Details`. Dessa forma, quando seus leitores o veem listado na barra de pesquisa do seu tópico, eles podem determinar rapidamente se os dados são relevantes para eles ou não.

**Dar a um conjunto de dados um nome e uma descrição amigáveis**

1. Abra o tópico que você deseja alterar.

1. Na guia **Resumo**, escolha **Dados**. Em seguida, em **Conjuntos de dados**, escolha a seta para baixo na extremidade direita do conjunto de dados para expandi-lo.

1. Escolha o ícone do lápis ao lado do nome do conjunto de dados à esquerda e, em seguida, insira um nome amigável. Recomendamos usar um nome que seus leitores entendam.

1. Em **Descrição**, insira uma descrição para o conjunto de dados que descreva os dados que ele contém.

## Etapa 2: instrua como usar campos de data em seus conjuntos de dados
<a name="topics-natural-language-dataset-time-basis"></a>

Se seu conjunto de dados contiver informações de data e hora, recomendamos instruir como usar essas informações ao responder perguntas. Fazer isso é especialmente importante se houver várias colunas de data e hora em um tópico.

Em alguns casos, há várias colunas de datas válidas em um tópico, como data do pedido e data de envio. Nesses casos, você pode ajudar os leitores especificando uma data padrão a ser usada para responder suas perguntas. Os leitores poderão escolher uma data diferente se a data padrão não responder à pergunta.

Você também pode determinar o quão granular deve ser com suas colunas de data e hora especificando uma base horária. A *base de tempo* de um conjunto de dados é o nível mais baixo de granularidade do tempo compatível com todas as medidas do conjunto de dados. Essa configuração ajuda a agregar métricas no conjunto de dados em diferentes dimensões de tempo e é aplicável a conjuntos de dados que oferecem suporte a uma única granularidade de data e hora. Essa opção pode ser definida para conjuntos de dados desnormalizados com um grande número de métricas. Por exemplo, se um conjunto de dados for compatível com várias métricas em uma agregação diária, você poderá definir a base de tempo desse conjunto de dados como **Diária**. Em seguida, isso é usado para determinar como agregar métricas.

**Definir uma base padrão de data e hora para um conjunto de dados**

1. Abra o tópico que você deseja alterar.

1. Na guia **Resumo**, escolha **Dados**. Em seguida, em **Conjuntos de dados**, escolha a seta para baixo na extremidade direita do conjunto de dados para expandi-lo.

1. Em **Data padrão**, escolha um campo de data.

1. Em **Base temporal**, escolha o nível mais baixo de granularidade ao qual você deseja agregar métricas no conjunto de dados. Você pode agregar métricas em um tópico no nível diário, semanal, mensal, trimestral ou anual.

## Etapa 3: excluir campos não utilizados
<a name="topics-natural-language-exclude-fields"></a>

Quando você adiciona um conjunto de dados a um tópico, todas as colunas (campos) do conjunto de dados são adicionadas por padrão. Se o conjunto de dados contiver campos que você ou seus leitores não usam ou que você não deseja incluir nas respostas, poderá excluí-los do tópico. A exclusão desses campos os remove das respostas e do índice e melhora a precisão das respostas que seus leitores recebem.

**Excluir campos em um tópico**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, em **Incluir**, desative o ícone.

## Etapa 4: renomear campos para serem natural-language-friendly
<a name="topics-natural-language-rename-fields"></a>

Os campos de um conjunto de dados geralmente são denominados com base em convenções técnicas de nomenclatura. Você pode tornar seus nomes de campo mais fáceis de usar nos tópicos renomeando-os e adicionando descrições. 

Os nomes dos campos são usados para entender os campos e vinculá-los aos termos nas perguntas dos seus leitores. Quando seus nomes de campo são fáceis de usar, é mais fácil estabelecer links entre os dados e a pergunta do leitor. Esses nomes amigáveis também são apresentados aos leitores como parte da resposta à pergunta para fornecer contexto adicional.

**Renomear e adicionar descrições a um campo**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, escolha a seta para baixo na extremidade direita do campo para expandi-lo.

1. Escolha o ícone do lápis ao lado do nome do campo à esquerda e, em seguida, insira um nome amigável.

1. No campo **Descrição**, insira uma descrição do campo.

## Etapa 5: adicionar sinônimos a campos e valores de campo
<a name="topics-natural-language-synonyms"></a>

Mesmo que você atualize os nomes dos campos para que sejam amigáveis e forneça uma descrição para eles, os leitores ainda poderão usar nomes diferentes para se referir a eles. Por exemplo, um campo `Sales` pode ser chamado de `revenue`, `rev` ou `spending` nas perguntas do leitor.

Para ajudar a entender esses termos e mapeá-los para os campos corretos, você pode adicionar um ou mais sinônimos aos seus campos. Fazer isso melhora a precisão.

Assim como acontece com os nomes dos campos, os leitores podem usar nomes diferentes para se referir a valores específicos dos campos. Por exemplo, se você tiver um campo que contém os valores `NW`, `SE`, `NE` e `SW`, poderá adicionar sinônimos para esses valores. Você pode adicionar `Northwest` para `NW`, `Southeast` para `SE` etc.

**Adicionar sinônimos a um campo**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, em **Sinônimos**, escolha o ícone do lápis para o campo, insira uma palavra ou frase e pressione Enter no teclado. Para adicionar outro sinônimo, escolha o ícone **\$1**.

**Adicionar sinônimos para um valor em um campo**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, escolha a seta para baixo na extremidade direita para expandir as informações sobre o campo.

1. Em **Visualização de valor** à direita, escolha **Configurar sinônimos de valor**.

1. Na página **Sinônimos de valores de campo** que é aberta, escolha **Adicionar** e faça o seguinte:

   1. Em **Valor**, escolha o valor ao qual você deseja adicionar sinônimos.

   1. Em **Sinônimos**, insira um ou mais sinônimos para o valor.

1. Escolha **Salvar**.

1. Para adicionar sinônimos para outro valor, repita as etapas 5 e 6.

1. Quando terminar, escolha **Concluído**.

## Etapa 6: Explique mais sobre seus campos
<a name="topics-natural-language-semantics"></a>

Para ajudar a interpretar como usar seus dados para responder às perguntas dos leitores, você pode explicar mais sobre os campos em seus conjuntos de dados. 

Você pode dizer se um campo no seu conjunto de dados é uma dimensão ou uma medida e especificar como esse campo deve ser agregado. Você também pode esclarecer como os valores de um campo devem ser formatados e que tipos de dados estão no campo. Definir essas configurações adicionais ajuda a criar respostas precisas para seus leitores quando eles fazem uma pergunta.

Use os procedimentos a seguir para explicar mais sobre seus campos.

### Atribuir perfis do campo
<a name="topics-natural-language-semantics-role"></a>

Cada campo do conjunto de dados é uma dimensão ou uma medida. *Dimensões* são dados categóricos, e as *medidas* são dados quantitativos. Saber se um campo é uma dimensão ou uma medida determina quais operações podem ou não ser executadas em um campo. 

Por exemplo, definir os campos `Patient ID``Employee ID`, e `Ratings` ajuda a interpretar esses campos como números inteiros. Essa configuração significa que os campos não serão agregados à medida que forem medidos.

**Definir o perfil de um campo**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, escolha a seta para baixo na extremidade direita para expandir as informações sobre o campo.

1. Em **Perfil**, escolha um perfil.

   Você pode escolher uma medida ou uma dimensão.

1. (Opcional) Se sua medida for inversamente proporcional (por exemplo, quanto menor o número, melhor), escolha **Medida invertida**.

   Isso explica como interpretar e exibir os valores nesse campo.

### Definir agregações de campos
<a name="topics-natural-language-semantics-aggregation"></a>

Definir agregações de campos ajuda a determinar qual função deve ou não ser usada quando esses campos são agregados em várias linhas. Você pode definir uma agregação padrão para um campo e uma agregação não permitida.

Uma *agregação padrão* é a agregação aplicada quando não há qualquer função de agregação explícita mencionada ou identificada na pergunta de um leitor. Por exemplo, digamos que um de seus leitores pergunte: “Quantos produtos foram vendidos ontem?” Nesse caso, Q usa o campo `Product ID`, que tem uma agregação padrão de `count distinct`, para responder à pergunta. Isso resulta em um elemento visual que mostra a contagem distinta de ID do produto.

*Agregações não permitidas* são agregações que são excluídas do uso em um campo para responder a uma pergunta. Elas são excluídas mesmo que a pergunta solicite especificamente uma agregação não permitida. Por exemplo, digamos que você especifique que o campo `Product ID` nunca deve ser agregado por `sum`. Mesmo que um de seus leitores pergunte: “Quantos produtos totais foram vendidos ontem?” `sum` não é usado para responder à pergunta.

Se as funções agregadas forem aplicadas incorretamente em um campo, recomendamos que você defina agregações não permitidas para o campo.

**Definir agregações de campo**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, escolha a seta para baixo na extremidade direita para expandir as informações sobre o campo.

1. Em **Agregação padrão**, escolha a agregação que você deseja agregar no campo por padrão.

   Você pode agregar medidas por soma, média, máximo e mínimo. Você pode agregar dimensões por contagem e contagem de diferentes.

1. (Opcional) Em **Agregações não permitidas**, escolha uma agregação que você não queira usar.

1. (Opcional) Se você não quiser agregar o campo em um filtro, escolha **Nunca agregar em um** filtro.

### Especificar como formatar valores de campo
<a name="topics-natural-language-semantics-values"></a>

Se quiser explicar como formatar os valores em seus campos, você pode fazer isso. Por exemplo, digamos que você tenha o campo `Order Sales Amount`, que contém valores que você deseja formatar como dólares dos EUA. Nesse caso, você pode explicar como formatar os valores no campo como moeda dos EUA quando usados nas respostas.

**Especificar como formatar valores de campo**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, escolha a seta para baixo na extremidade direita para expandir as informações sobre o campo.

1. Em **Formato do valor**, escolha como você deseja formatar os valores no campo.

### Especificar os tipos de semânticas dos campos
<a name="topics-natural-language-semantics-types"></a>

Um *tipo de semântica* de campo é o tipo de informações representadas pelos dados de um campo. Por exemplo, você pode ter um campo que contém dados de local, dados de moeda, dados de idade ou dados booleanos. Você pode especificar um tipo de semântica e um subtipo de semântica adicional para os campos. Especificar isso ajuda a entender o significado dos dados armazenados em seus campos.

Use o procedimento a seguir para especificar tipos e subtipos de semânticas dos campos.

**Especificar tipos de semânticas dos campos**

1. Abra o tópico que você deseja alterar.

1. No tópico, escolha a guia **Dados**.

1. Na seção **Campos**, escolha a seta para baixo na extremidade direita para expandir as informações sobre o campo.

1. Em **Tipo de semântica**, escolha o tipo de informações que os dados representam.

   Em medidas, você pode selecionar duração, parte da data, local, booleano, moeda, porcentagem, idade, distância e tipos de identificador. Em dimensões, você pode selecionar parte da data, local, booleano, pessoa, organização e tipos de identificador.

1. Em **subtipo de semântica**, escolha uma opção para especificar mais o tipo de informações que os dados representam.

   As opções mostradas aqui dependem do tipo de semântica que você escolheu e do perfil associado ao campo. Para obter uma lista de tipos de semântica e seus subtipos associados para medidas e dimensões, consulte a tabela a seguir.


| Tipo de semântica | Subtipo de semântica | Disponível para o seguinte | 
| --- | --- | --- | 
|  Idade  |  | Medidas | 
|  Booleano  |  | Dimensões e medidas | 
|  Moeda  |  USD EUR GBP  | Medidas | 
|  Parte da data  |  Dia Semana Mês Ano Trimestre  | Dimensões e medidas | 
|  Distância  |  Quilômetro Metro Jarda Pé  | Medidas | 
|  Duração  |  Segundo Minuto Hora Dia  | Medidas | 
|  Identificador  |  | Dimensões e medidas | 
|  Local  |  Código postal País Estado Cidade  | Dimensões e medidas | 
|  Organização  |  | Dimensões | 
|  Porcentagem  |  | Medidas | 
|  Pessoa  |  | Dimensões | 

# Compartilhando tópicos do Quick Sight
<a name="topics-sharing"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Depois de criar um tópico, você pode compartilhá-lo com outras pessoas na sua organização. Compartilhar um tópico permite que seus usuários selecionem o tópico e façam perguntas sobre ele na barra de pesquisa. Depois de compartilhar um tópico com os usuários, você pode atribuir permissões a eles que especificam quem pode alterar o tópico.

**Compartilhar um tópico**

1. Na página de início rápido, escolha **Tópicos** à esquerda.

1. Na página **Tópicos** que é aberta, abra o tópico que você deseja compartilhar.

1. Na página que é aberta, escolha **Compartilhar** no canto superior direito.

1. Na página **Compartilhar tópico com usuários** que é aberta, escolha o usuário ou usuários com quem você deseja compartilhar o tópico.

   Você pode usar a barra de pesquisa para procurar usuários por endereço de e-mail.

1. Escolha **Visualizador** ou **Coproprietário** na coluna **Permissão** para atribuir permissões aos usuários.

   Para obter mais informações sobre essas permissões, consulte a seção a seguir, [Gerenciando permissões de tópicos do Amazon Quick Sight](topics-sharing-permissions.md).

1. Quando terminar de selecionar os usuários, escolha **Compartilhar**.

# Gerenciando permissões de tópicos do Amazon Quick Sight
<a name="topics-sharing-permissions"></a>

Ao compartilhar seus tópicos com outras pessoas em sua organização, talvez você queira controlar quem pode alterá-los. Para fazer isso, especifique quais usuários são visualizadores e quais são coproprietários. *Os espectadores* podem ver o tópico na barra de pesquisa quando selecionam um tópico da lista, mas não podem alterar os dados do tópico. *Os coproprietários* podem ver o tópico na barra de pesquisa e também podem alterar o tópico.

**Atribuir permissões de tópicos aos usuários**

1. Na página de início rápido, escolha **Tópicos**.

1. Na página **Tópicos** que se abre, abra o tópico para o qual você deseja gerenciar permissões.

1. Na página do tópico que é aberta, escolha **Compartilhar** no canto superior direito.

1. Na página **Compartilhar tópico com usuários** que é aberta, escolha **Gerenciar acesso ao tópico**.

1. Na página **Gerenciar permissões do tópico** que é aberta, encontre o usuário para o qual você deseja gerenciar o acesso e, em **Permissão**, escolha uma das seguintes opções:
   + Para permitir que um usuário visualize e altere o tópico, escolha **Coproprietário**.
   + Para permitir que um usuário visualize somente o tópico, escolha **Visualizador**.

# Analisando o desempenho e o feedback do tópico do Quick Sight
<a name="topics-performance"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Depois de criar um tópico e compartilhá-lo com os usuários, você pode revisar o desempenho desse tópico. Quando alguém usa seu tópico para fazer uma pergunta ou fornecer feedback sobre a qualidade da resposta, ela é registrada nas guias **Resumo** e **Atividade do usuário do** tópico.

Na guia **Resumo** do tópico, você pode visualizar dados históricos do número de perguntas feitas ao longo do tempo, em períodos de sete dias a um ano. Você também pode ver uma distribuição de perguntas que receberam feedback positivo, negativo ou nenhum feedback, além de perguntas que não tiveram resposta.

Na guia **Atividade do usuário**, você pode visualizar uma lista das perguntas que os usuários fizeram e qualquer feedback e comentários positivos ou negativos que eles deixaram.

Analisar essas informações pode ajudar você a determinar se o tópico está atendendo às necessidades dos usuários. Por exemplo, digamos que você tenha um tópico que esteja recebendo feedback negativo dos usuários. Ao revisar sua atividade de usuário, você percebe que vários usuários estão deixando comentários sobre uma pergunta que mostrou os dados errados. Em resposta, você examina as perguntas que eles fizeram e percebe que eles estavam usando um termo que você não previu. Você decide adicionar esse termo como sinônimo ao campo correto no tópico. Com o tempo, você percebe um aumento no feedback positivo.

## Analisar o desempenho do tópico
<a name="topics-performance-statistics"></a>

Use o procedimento a seguir para visualizar o desempenho de um tópico.

**Visualizar o desempenho de um tópico**

1. Na página de início rápido, escolha **Tópicos** à esquerda.

1. Na página **Tópicos** que é aberta, abra o tópico que você deseja analisar.

   O tópico é aberto e a seção **Estatísticas** mostra as estatísticas do tópico.

1. (Opcional) Para alterar o volume de dados históricos mostrados no gráfico, escolha uma das seguintes opções: **7 dias**, **30 dias**, **90 dias**, **120 dias** ou **12 meses**.

1. (Opcional) Para remover perguntas que não tiveram resposta com base nos dados, desmarque **Incluir dados sem resposta**.

1. (Opcional) Para remover perguntas que não receberam feedback com base nos dados, desmarque **Incluir dados sem feedback**.

## Como analisar perguntas e feedback do tópico
<a name="topics-performance-user-activity"></a>

Use os procedimentos a seguir para analisar as perguntas e o feedback de um tópico.

**Analisar perguntas e feedback do tópico**

1. Na página de início rápido, escolha **Tópicos**.

1. Na página **Tópicos** que é aberta, abra o tópico cujo feedback você deseja revisar.

1. Na página do tópico que é aberta, escolha a guia **Atividade do usuário**.

   A atividade do usuário no tópico é mostrada. Na parte superior, é possível visualizar o número total de perguntas feitas e o número de perguntas que foram respondidas e não respondidas. Você também pode visualizar a porcentagem de perguntas que foram classificadas como positivas e negativas. Além disso, você pode visualizar a porcentagem de perguntas sem ambiguidade. Isso significa que alguém inseriu uma pergunta e mapeou uma das palavras da pergunta para um campo no tópico.

   Você pode escolher qualquer uma dessas estatísticas para filtrar a lista de perguntas.

1. (Opcional) Para ver um comentário deixado por um usuário sobre uma pergunta, escolha a seta para baixo à direita da pergunta.

   O comentário é mostrado à esquerda.

1. (Opcional) Para visualizar os campos usados para responder a uma pergunta, escolha a seta para baixo à direita da pergunta.

   Os campos usados são mostrados à direita. Escolha um nome de campo para editar seus metadados.

1. (Opcional) Para ver uma pergunta sem ambiguidade, escolha a seta para baixo à direita de uma pergunta com um termo destacado em vermelho. 

   Uma descrição do termo e do campo que foi usado para eliminar a ambiguidade é mostrada. Para adicionar sinônimos ao campo, escolha **Adicionar sinônimos**.

1. (Opcional) Para ver como uma pergunta foi respondida, escolha **Exibir** ao lado da pergunta na lista.

1. (Opcional) Para filtrar a lista de perguntas, escolha **Filtrar por** à direita e, em seguida, filtre por uma das opções a seguir.
   + **Ver todas as perguntas**: esta opção remove todos os filtros e mostra todas as perguntas que um tópico recebeu.
   + **Respondidas**: esta opção filtra a lista de perguntas para mostrar as que foram respondidas. Perguntas respondidas são perguntas às quais Q foi capaz de responder.
   + **Sem resposta**: esta opção filtra a lista de perguntas para mostrar as que não puderam ser respondidas. Perguntas sem resposta são perguntas às quais Q não conseguiu responder.
   + **Sem ambiguidade**: esta opção filtra a lista de perguntas para mostrar as que não tinham ambiguidade, ou seja, perguntas com termos para os quais os usuários mapearam manualmente um campo.
   + **Sem feedback**: esta opção filtra a lista de perguntas para mostrar as que não receberam feedback.
   + **Negativo**: esta opção filtra a lista de perguntas para mostrar as que receberam feedback negativo.
   + **Positivo**: esta opção filtra a lista de perguntas para mostrar as que receberam feedback positivo.
   + **Sem comentários**: esta opção filtra a lista de perguntas para mostras as que não receberam comentários dos usuários.
   + **Com comentários**: esta opção filtra a lista de perguntas para mostras as que receberam comentários dos usuários.
   + **Usuário**: esta opção filtra a lista de perguntas para mostra as que foram feitas por um usuário com um nome de usuário específico inserido por você.

# Atualizando índices de tópicos do Quick Sight
<a name="topics-index"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: administradores e autores do Amazon Quick  | 

Quando você cria um tópico, o Quick Sight cria, armazena e mantém um índice com definições para os dados desse tópico. Esse índice não está exposto aos autores do Quick Sight. Também não é uma cópia dos conjuntos de dados incluídos em um tópico. As métricas não são indexadas. Por exemplo, medidas armazenadas como números inteiros não são indexadas.

O índice do tópico é um índice de valores de strings exclusivos para campos incluídos em um tópico. Esse índice é usado para gerar respostas corretas, fornecer sugestões de preenchimento automático quando alguém faz uma pergunta e sugerir mapeamentos de termos para colunas ou valores de dados.

Para atualizar o índice de um tópico, atualize os conjuntos de dados no tópico. Você pode atualizar manualmente todos os conjuntos de dados de um tópico ou atualizar um conjunto de dados individual. Você também pode visualizar o histórico de atualizações do conjunto de dados para monitorar atualizações anteriores e definir uma programação de atualizações recorrente para cada conjunto de dados do tópico. Para conjuntos de dados do SPICE, você pode sincronizar a programação de atualização do índice de tópicos com a programação de atualização do SPICE. Para obter mais informações sobre a definição de programações de atualização do SPICE, consulte [Como atualizar um conjunto de dados em uma programação](refreshing-imported-data.md#schedule-data-refresh).

**nota**  
Atualmente, não há suporte para agendas de atualização por hora. Você pode definir um cronograma de atualização para atualizar os conjuntos de dados em um tópico até uma vez por dia.

Recomendamos que você atualize os índices dos tópicos regularmente para garantir que as definições e os valores mais recentes sejam registrados. A atualização de um índice de tópicos leva aproximadamente 15 a 30 minutos, dependendo do número e do tamanho dos conjuntos de dados incluídos no tópico.

**Atualizar um índice de tópicos**

1. Na página de início rápido, escolha **Tópicos**.

1. Na página **Tópicos** que é aberta, abra o tópico que você deseja atualizar.

   O tópico é aberto na guia **Resumo**, que mostra os conjuntos de dados incluídos no tópico na parte inferior da página. Ela também mostra a última vez em que o tópico foi atualizado, no canto superior direito.

1. Escolha **Atualizado** no canto superior direito para atualizar o índice do tópico e, em seguida, escolha **Atualizar dados**. Fazer isso manualmente atualiza todos os conjuntos de dados do tópico.

   Para obter mais informações sobre a atualização de conjuntos de dados individuais em um tópico, consulte [Atualizando conjuntos de dados em um tópico do Quick Sight](topics-data-refresh.md).

# Trabalhe com tópicos do Quick Sight usando o Amazon Quick Sight APIs
<a name="topics-cli"></a>


|  | 
| --- |
|  Aplica-se a: Enterprise Edition  | 


|  | 
| --- |
|    Público-alvo: desenvolvedores do Amazon Quick  | 

Use esta seção para aprender a trabalhar com tópicos do Quick Sight usando a interface de linha de comando (CLI) do Amazon Quick Sight.

**Pré-requisitos**

Antes de começar, verifique se você tem uma função AWS Identity and Access Management (IAM) que conceda ao usuário da CLI acesso para chamar as operações da API Quick Sight. A tabela a seguir mostra quais permissões devem ser adicionadas à política do IAM para usar operações de API específicas. Para usar todas as operações de API de tópicos, adicione todas as permissões listadas na tabela.


| Operação de API | Política do 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`  | 

O exemplo a seguir mostra uma política do IAM que permite que um usuário use a operação de API `ListTopics`.

------
#### [ JSON ]

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "quicksight:ListTopics"
            ],
            "Resource": "*"
        }
    ]
}
```

------

Depois de configurar as permissões para criar tópicos do Quick Sight com o Quick Sight APIs, use os tópicos a seguir para criar e trabalhar com o tópico do Quick Sight APIs.

**Topics**
+ [Trabalhe com tópicos do Quick Sight usando o Quick Sight APIs](topic-cli-examples.md)
+ [Configure os cronogramas de atualização de tópicos do Quick Sight com a CLI do Quick Sight](topic-refresh-apis.md)
+ [Copie e migre tópicos do Quick Sight dentro e entre Contas da AWS](topic-cli-walkthroughs.md)
+ [Crie e modifique respostas revisadas em tópicos do Quick Sight com o Quick Sight APIs](topic-reviewed-answer-apis.md)

# Trabalhe com tópicos do Quick Sight usando o Quick Sight APIs
<a name="topic-cli-examples"></a>

O exemplo a seguir cria um novo tópico.

```
aws quicksight create-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC
```

Você também pode criar um novo tópico usando um arquivo de esqueleto CLI com o comando a seguir. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de [CLI no Guia](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) do desenvolvedor do *Amazon* Quick Sight.

```
aws quicksight create-topic
--cli-input-json file://createtopic.json
```

Quando você cria um novo tópico, a configuração de atualização do conjunto de dados não é copiada para o tópico. Para definir uma programação de atualização para seu novo tópico, você pode fazer uma chamada de API `create-topic-refresh-schedule`. Para obter mais informações sobre a configuração de programações de atualização de tópicos com a CLI, consulte [Configure os cronogramas de atualização de tópicos do Quick Sight com a CLI do Quick Sight](topic-refresh-apis.md).

Depois de criar seu primeiro tópico, você pode atualizar, excluir, listar ou solicitar um resumo de um tópico.

O exemplo a seguir atualiza um tópico.

```
aws quicksight update-topic
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--topic TOPIC
```

Você também pode atualizar um tópico usando um arquivo de esqueleto CLI com o comando a seguir. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de [CLI no Guia](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) do desenvolvedor do *Amazon* Quick Sight.

```
aws quicksight update-topic
--cli-input-json file://updatetopic.json
```

O exemplo a seguir fornece uma lista de todos os tópicos em uma conta rápida.

```
aws quicksight list-topics 
--aws-account-id AWSACCOUNTID
```

O exemplo a seguir exclui um tópico.

```
aws quicksight delete-topic 
--aws-account-id AWSACCOUNTID 
--topic-id TOPICID
```

O exemplo a seguir fornece informações sobre como um tópico foi configurado.

```
aws quicksight describe-topic 
--aws-account-id AWSACCOUNTID 
--topic-id TOPICID
```

O comando a seguir atualiza as permissões de um tópico.

```
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
```

Use o `grant-permissions` parâmetro para conceder permissões de leitura e autor aos usuários da conta rápida. Para conceder permissões de leitura a um usuário da conta, insira o seguinte valor: `"quicksight:DescribeTopic"`. Para conceder permissões a um usuário da conta, insira os seguintes valores:
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`

O parâmetro `RevokePermissions` revoga todas as permissões concedidas a um usuário da conta.

O comando a seguir descreve todas as permissões de um tópico.

```
aws quicksight describe-topic-permissions 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```

Depois de criar um tópico do Quick Sight, você pode usar o Amazon Quick Sight APIs para [configurar um cronograma de atualização de tópicos](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [migrar tópicos do Quick Sight dentro ou entre contas](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs) e [criar respostas revisadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis).

# Configure os cronogramas de atualização de tópicos do Quick Sight com a CLI do Quick Sight
<a name="topic-refresh-apis"></a>

O comando a seguir cria uma agenda de atualização de um tópico.

```
aws quicksight create-topic-refresh-schedule
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-arn DATASETARN
--refresh-schedule REFRESHSCHEDULE
```

Depois de criar uma agenda de atualização para um tópico, você pode atualizar, excluir, listar ou solicitar um resumo da agenda de atualização do tópico.

O comando a seguir atualiza o cronograma de atualização de um tópico.

```
aws quicksight update-topic-refresh-schedule 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
--refresh-schedule REFRESHSCHEDULE
```

O exemplo a seguir fornece uma lista de todas as agendas de atualização configuradas para um tópico.

```
aws quicksight list-topic-refresh-schedules
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
```

O exemplo a seguir exclui uma programação de atualização de tópicos.

```
aws quicksight delete-topic-refresh-schedule 
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```

O exemplo a seguir fornece informações sobre como a programação de atualização de um tópico Q foi configurada.

```
aws quicksight describe-topic-refresh-schedule  
--aws-account-id AWSACCOUNTID
--topic-id TOPICID
--dataset-id DATASETID
```

# Copie e migre tópicos do Quick Sight dentro e entre Contas da AWS
<a name="topic-cli-walkthroughs"></a>

Você pode migrar seus tópicos do Quick Sight de uma conta para outra com a interface de linha de comando (CLI) do Quick Sight. Em vez de replicar manualmente o mesmo tópico em vários painéis, namespaces ou contas, você pode usar a CLI do Quick Sight para reutilizar o mesmo tópico repetidamente. Esse recurso economiza tempo dos autores do Quick Sight e cria uma experiência de tópico padronizada para leitores de painéis em vários painéis.

Para migrar tópicos com a CLI do Quick Sight, use o procedimento a seguir

**Para migrar um tópico para outra conta**

1. Primeiro, identifique o tópico que você deseja migrar. Você pode ver uma lista de todos os tópicos em sua conta Quick com um comando de `list-topics` API.

   ```
   aws quicksight list-topics --aws-account-id AWSACCOUNTID
   ```

1. Depois de ter uma lista de tópicos, localize o tópico que você deseja migrar e faça uma `describe-topic` chamada para receber uma estrutura JSON da configuração do tópico.

   ```
   aws quicksight describe-topic 
       --aws-account-id AWSACCOUNTID
       --topic-id TOPICID
   ```

   Veja um exemplo de resposta da API `describe-topic`.

   ```
   {
       "Status": 200,
       "TopicId": "TopicExample", 
       "Arn": "string",
       "Topic": [
           {
               "Name": "{}",
               "DataSets": [
               {
               "DataSetArn": "{}",
               "DataSetName": "{}",
               "DataSetDescription": "{}",
               "DataAggregation": "{}",
               "Filters": [],
               "Columns": [],
               "CalculatedFields": [],
               "NamedEntities": []
               }
               ]
           }
       ],
       "RequestId": "requestId"
       }
   ```

1. Use a resposta JSON para criar um arquivo esqueleto que você pode inserir em uma nova `create-topic` chamada em sua outra conta do Quick. Antes de fazer uma chamada de API com seu arquivo esqueleto, certifique-se de alterar o Conta da AWS ID e o ID do conjunto de dados no arquivo esqueleto para que correspondam ao Conta da AWS ID e ao ID do conjunto de dados aos quais você está adicionando o novo tópico. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de [CLI no Guia](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) do desenvolvedor do *Amazon* Quick Sight.

   ```
   aws quicksight create-topic --aws-account-id AWSACCOUNTID \
   --cli-input-json file://./create-topic-cli-input.json
   ```

Depois de fazer uma `create-topic` chamada para a API do Quick Sight, o novo tópico aparece na sua conta. Para confirmar que o novo tópico existe, faça uma `list-topics` chamada para a API Quick Sight. Se o tópico de origem que foi duplicado contiver respostas verificadas, as respostas não serão migradas para o novo tópico. Para visualizar uma lista de todas as respostas verificadas que estão configuradas para o tópico original, use uma chamada de API `describe-topic`.

# Crie e modifique respostas revisadas em tópicos do Quick Sight com o Quick Sight APIs
<a name="topic-reviewed-answer-apis"></a>

Depois de criar um tópico do Quick Sight, você pode usar o Quick Sight APIs para criar, listar, atualizar e excluir respostas revisadas para tópicos.

O comando abaixo em lote cria até 100 respostas revisadas para um tópico do Quick Sight.

```
aws quicksight batch-create-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \                 
—answers ANSWERS
```

Além disso, é possível criar respostas revisadas em lote usando um arquivo de estrutura da CLI com o comando apresentado a seguir. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de [CLI no Guia](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) do desenvolvedor do *Amazon* Quick Sight.

```
aws quicksight batch-create-topic-reviewed-answer \ 
--cli-input-json file://createTopicReviewedAnswer.json
```

O comando abaixo lista todas as respostas revisadas em um tópico do Quick Sight.

```
aws quicksight list-topic-reviewed-answers \
--aws-account-id AWSACCOUNTID \
--topic-id TOPICID \
```

O exemplo apresentado abaixo exclui até cem respostas revisadas em lote de um tópico.

```
aws quicksight batch-delete-topic-reviewed-answer \
--topic-id TOPICID \
--aws-account-id AWSACCOUNTID \                 
—answer-ids: ["AnswerId1, AnswerId2…"]
```

Além disso, é possível criar respostas revisadas de tópicos em lote usando um arquivo de estrutura da CLI com o comando apresentado a seguir. Para obter mais informações sobre arquivos de esqueleto de CLI, consulte Como usar arquivos de esqueleto de [CLI no Guia](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) do desenvolvedor do *Amazon* Quick Sight.

```
aws quicksight batch-delete-topic-reviewed-answer \
--cli-input-json file://deleteTopicReviewedAnswer.json
```

Para atualizar uma resposta revisada, exclua a resposta existente do tópico usando a API `batch-delete-topic-reviewed-answer`. Em seguida, use a API `batch-create-topic-reviewed-answer` para adicionar a resposta revisada atualizada ao tópico.