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á.
# Usando parâmetros do conjunto de dados no Amazon Quick
No Amazon Quick, os autores podem usar parâmetros do conjunto de dados na consulta direta para personalizar dinamicamente seus conjuntos de dados e aplicar lógica reutilizável a seus conjuntos de dados. Um *parâmetro de conjunto de dados* é um parâmetro criado no nível do conjunto de dados. É consumido por um parâmetro de análise por meio de controles, campos calculados, filtros, ações URLs, títulos e descrições. Para obter mais informações sobre parâmetros de análise, consulte [Parâmetros no Amazon Quick](parameters-in-quicksight.md). Abaixo, a lista descreve três ações que podem ser executadas com os parâmetros de conjunto de dados:
+ **SQL personalizado na consulta direta**: os proprietários do conjunto de dados podem inserir parâmetros de conjunto de dados no SQL personalizado de um conjunto de dados de consulta direta. Quando esses parâmetros são aplicados a um controle de filtro em uma análise rápida, os usuários podem filtrar seus dados personalizados com mais rapidez e eficiência.
+ **Variáveis repetíveis**: valores estáticos que aparecem em vários locais na página do conjunto de dados podem ser modificados em uma ação usando parâmetros personalizados de conjunto de dados.
+ **Mover campos calculados para conjuntos** de dados — autores rápidos podem copiar campos calculados com parâmetros em uma análise e migrá-los para o nível do conjunto de dados. Isso evita que os campos calculados no nível da análise sejam modificados acidentalmente e que os campos calculados sejam compartilhados em várias análises.
Em algumas situações, os parâmetros do conjunto de dados melhoram o desempenho do controle de filtros para conjuntos de dados de consulta direta que exigem SQL personalizado complexo e simplificam a lógica de negócios no nível do conjunto de dados.
**Topics**
+ [Limitações dos parâmetros de conjunto de dados](#dataset-parameters-limitations)
+ [Criação de parâmetros do conjunto de dados no Amazon Quick](dataset-parameters-SQL.md)
+ [Inserção dos parâmetros de conjunto de dados no SQL personalizado](dataset-parameters-insert-parameter.md)
+ [Adição dos parâmetros de conjunto de dados aos campos calculados](dataset-parameters-calculated-fields.md)
+ [Adição dos parâmetros de conjunto de dados aos filtros](dataset-parameters-dataset-filters.md)
+ [Usando parâmetros do conjunto de dados em análises rápidas](dataset-parameters-analysis.md)
+ [Casos de uso avançados dos parâmetros de conjunto de dados](dataset-parameters-advanced-options.md)
## Limitações dos parâmetros de conjunto de dados
Esta seção aborda as limitações conhecidas que você pode encontrar ao trabalhar com parâmetros de conjunto de dados no Amazon Quick.
+ Quando os leitores do painel agendam relatórios enviados por e-mail, os controles selecionados não se propagam para os parâmetros do conjunto de dados incluídos no relatório anexado ao e-mail. Em vez disso, os valores padrão dos parâmetros são usados.
+ Os parâmetros do conjunto de dados não podem ser inseridos no SQL personalizado dos conjuntos de dados armazenados no SPICE.
+ Os padrões dinâmicos só podem ser configurados na página de análise da análise que está usando o conjunto de dados. Você não pode configurar um padrão dinâmico no nível do conjunto de dados.
+ A opção **Selecionar tudo** não é compatível com controles de vários valores de parâmetros de análise que são mapeados para parâmetros do conjunto de dados.
+ Os controles em cascata não são compatíveis com os parâmetros de conjunto de dados.
+ Os parâmetros de conjunto de dados só podem ser usados pelos filtros do conjunto de dados quando o conjunto de dados está usando a consulta direta.
+ Em uma consulta SQL personalizada, apenas 128 parâmetros de conjuntos de dados podem ser usados.
# Criação de parâmetros do conjunto de dados no Amazon Quick
Use os procedimentos a seguir para começar a usar os parâmetros do conjunto de dados.
**Criar um novo parâmetro de conjunto de dados**
1. **Na página de início rápido, escolha **Dados** à esquerda, escolha as reticências (três pontos) ao lado do conjunto de dados que você deseja alterar e, em seguida, escolha Editar.**
1. Na página **Conjunto de dados** que se abre, escolha **Parâmetros** à esquerda e selecione o ícone (\$1) para criar um novo parâmetro de conjunto de dados.
1. No pop-up **Criar novo parâmetro** exibido, insira um nome de parâmetro na caixa **Nome**.
1. No menu suspenso **Tipo de dados**, escolha o tipo de dados do parâmetro que você deseja. Os tipos de dados compatíveis são `String`, `Integer`, `Number` e `Datetime`. Essa opção não pode ser alterada após a criação do parâmetro.
1. Em **Valor padrão**, insira o valor padrão que você deseja que o parâmetro tenha.
**nota**
Quando você mapeia um parâmetro de conjunto de dados para um parâmetro de análise, um valor padrão diferente pode ser escolhido. Quando isso acontece, o valor padrão configurado aqui é substituído pelo novo valor padrão.
1. Em **Valores**, escolha o tipo de valor que você deseja que o parâmetro tenha. Os parâmetros de **valor único** oferecem suporte a menus suspensos, campos de texto e controles de lista de seleção única. Os parâmetros de **múltiplos valores** oferecem suporte a controles suspensos de seleção múltipla. Essa opção não pode ser alterada após a criação do parâmetro.
1. Quando você terminar de configurar o novo parâmetro, escolha **Criar** para criar o parâmetro.
# Inserção dos parâmetros de conjunto de dados no SQL personalizado
Você pode inserir parâmetros de conjunto de dados no SQL personalizado de um conjunto de dados no modo de consulta direta fazendo referência a ele com `<<$parameter_name>>` na instrução SQL. No runtime, os usuários do painel podem inserir valores de controle de filtro associados a um parâmetro de conjunto de dados. Em seguida, eles podem ver os resultados nos elementos visuais do painel depois que os valores se propagam para a consulta SQL. Você pode usar parâmetros para criar filtros básicos com base na entrada do cliente nas cláusulas `where`. Como alternativa, você pode adicionar cláusulas `case when` ou `if else` para alterar dinamicamente a lógica da consulta SQL com base na entrada de um parâmetro.
Por exemplo, digamos que você queira adicionar uma cláusula `WHERE` ao seu SQL personalizado que filtra dados com base no nome da região de um usuário final. Nesse caso, você cria um parâmetro de valor único chamado `RegionName`:
```
SELECT *
FROM transactions
WHERE region = <<$RegionName>>
```
Você também pode permitir que os usuários forneçam múltiplos valores ao parâmetro:
```
SELECT *
FROM transactions
WHERE region in (<<$RegionNames>>)
```
No exemplo mais complexo abaixo, um autor de conjunto de dados refere-se a dois parâmetros de conjunto de dados duas vezes, com base no nome e no sobrenome de um usuário, que podem ser selecionados em um controle de filtro do painel:
```
SELECT Region, Country, OrderDate, Sales
FROM transactions
WHERE region=
(Case
WHEN <<$UserFIRSTNAME>> In
(select firstname from user where region='region1')
and <<$UserLASTNAME>> In
(select lastname from user where region='region1')
THEN 'region1'
WHEN <<$UserFIRSTNAME>> In
(select firstname from user where region='region2')
and <<$UserLASTNAME>> In
(select lastname from user where region='region2')
THEN 'region2'
ELSE 'region3'
END)
```
Você também pode usar parâmetros em cláusulas `SELECT` para criar novas colunas em um conjunto de dados utilizando a entrada do usuário:
```
SELECT Region, Country, date,
(case
WHEN <<$RegionName>>='EU'
THEN sum(sales) * 0.93 --convert US dollar to euro
WHEN <<$RegionName>>='CAN'
THEN sum(sales) * 0.78 --convert US dollar to Canadian Dollar
ELSE sum(sales) -- US dollar
END
) as "Sales"
FROM transactions
WHERE region = <<$RegionName>>
```
Para criar uma consulta SQL personalizada ou editar uma consulta existente antes de adicionar um parâmetro de conjunto de dados, consulte [Como usar SQL para personalizar dados](adding-a-SQL-query.md).
Ao aplicar SQL personalizado com um parâmetro de conjunto de dados, `<<$parameter_name>>` é usado como um valor de espaço reservado. Quando um usuário escolhe um dos valores de parâmetros de um controle, o Quick substitui o espaço reservado pelos valores que o usuário seleciona no painel.
No exemplo a seguir, o usuário insere uma nova consulta SQL personalizada que filtra os dados por estado:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
O valor padrão do parâmetro é aplicado à consulta SQL e os resultados aparecem no **Painel de visualização**.
# Adição dos parâmetros de conjunto de dados aos campos calculados
Você também pode adicionar parâmetros de conjunto de dados às expressões de campo calculado usando o `${parameter_name}` de formato.
Ao criar um cálculo, você pode escolher entre os parâmetros existentes na lista de parâmetros na lista **Parâmetros**. Você não pode criar um campo calculado que contenha um parâmetro de vários valores.
Para obter mais informações sobre como adicionar campos calculados, consulte [Usando campos calculados com parâmetros no Amazon Quick](parameters-calculated-fields.md).
# Adição dos parâmetros de conjunto de dados aos filtros
Para conjuntos de dados no modo de consulta direta, os autores do conjunto de dados podem usar parâmetros de conjunto de dados em filtros sem SQL personalizado. Os parâmetros de conjunto de dados não poderão ser adicionados aos filtros se o conjunto de dados estiver no SPICE.
**Adicionar um parâmetro de conjunto de dados a um filtro**
1. Abra a página do conjunto de dados para o qual você deseja criar um filtro. Escolha **Filtros** à esquerda, e depois **Adicionar filtro**.
1. Insira o nome que você deseja para o filtro e escolha o campo que deseja filtrar no menu suspenso.
1. Depois de criar o novo filtro, navegue até o filtro no painel **Filtros**, escolha as reticências (três pontos) ao lado do filtro, e depois **Editar**.
1. Em **Tipo de filtro**, escolha **Filtro personalizado**.
1. Em **Condição de filtro**, escolha a condição desejada.
1. Selecione a caixa **Usar parâmetro** e escolha o parâmetro de conjunto de dados que você deseja que o filtro use.
1. Quando terminar de fazer alterações, escolha **Aplicar**.
# Usando parâmetros do conjunto de dados em análises rápidas
Ao criar um parâmetro de conjunto de dados, depois de adicionar o conjunto de dados a uma análise, mapeie o parâmetro de conjunto de dados para um parâmetro de análise novo ou existente. Depois de mapear um parâmetro de conjunto de dados para um parâmetro de análise, você pode usá-los com filtros, controles e qualquer outro recurso de parâmetro de análise.
Você pode gerenciar os parâmetros de conjunto de dados no painel **Parâmetros** da análise que está usando o conjunto de dados ao qual os parâmetros pertencem. Na seção **Parâmetros de conjunto de dados** do painel **Parâmetros**, você pode optar por ver somente os parâmetros de conjunto de dados não mapeados (padrão). Como alternativa, você pode optar por ver todos os parâmetros de conjunto de dados mapeados e não mapeados escolhendo **TUDO** na lista suspensa **Visualização**.
## Mapeando parâmetros do conjunto de dados em novas análises rápidas
Ao criar uma nova análise em um conjunto de dados que contém parâmetros, você precisa mapear os parâmetros de conjunto de dados para a análise antes de poder usá-los. Isso também é verdade quando você adiciona um conjunto de dados com parâmetros a uma análise. Você pode visualizar todos os parâmetros não mapeados em uma análise no painel **Parâmetros** da análise. Como alternativa, escolha **VISUALIZAR** na mensagem de notificação que aparece no canto superior direito da página ao criar a análise ou adicionar o conjunto de dados.
**Mapear um parâmetro de conjunto de dados para um parâmetro de análise**
1. Abra o [console Quick](https://quicksight.aws.amazon.com/).
1. Escolha a análise que você deseja alterar.
1. Escolha o ícone **Parâmetros** para abrir o painel **Parâmetros**.
1. Escolha as reticências (três pontos) ao lado do parâmetro de conjunto de dados que você deseja mapear, selecione **Mapear parâmetro**, depois o parâmetro de análise para o qual você deseja mapear o parâmetro de conjunto de dados.
Se a sua análise não tiver nenhum parâmetro de análise, você poderá escolher **Mapear parâmetro** e **Criar novo** para criar um parâmetro de análise que seja mapeado automaticamente para o parâmetro de conjunto de dados após a criação.
1. (Opcional) No pop-up **Criar novo parâmetro** exibido, em **Nome**, insira um nome para o novo parâmetro de análise.
1. (Opcional) Em **Valor padrão estático**, escolha o valor padrão estático que você deseja para o parâmetro.
1. (Opcional) Escolha **Definir um padrão dinâmico** para definir um padrão dinâmico para o novo parâmetro.
1. Na tabela **Parâmetros de conjunto de dados mapeados**, você verá o parâmetro do conjunto de dados que está mapeando para o novo parâmetro de análise. Você pode adicionar outros parâmetros de conjunto de dados a esse parâmetro de análise escolhendo o menu suspenso **ADICIONAR PARÂMETRO DE CONJUNTO DE DADOS** e, em seguida, selecionando o parâmetro que deseja mapear. Você pode remover o mapeamento de um parâmetro de conjunto de dados escolhendo o botão **Remover** ao lado do parâmetro do conjunto de dados que deseja remover.
Para obter mais informações sobre como criar parâmetros de análise, consulte [Configurando parâmetros no Amazon Quick](parameters-set-up.md).
Quando você mapeia um parâmetro de conjunto de dados a um parâmetro de análise, o parâmetro de análise representa o parâmetro de conjunto de dados onde quer que seja usado na análise.
Você também pode mapear e remover o mapeamento de parâmetros de conjunto de dados para parâmetros de análise na janela **Editar parâmetro**. Para abrir a janela **Editar parâmetro**, navegue até o painel **Parâmetros**, selecione as reticências (três pontos) ao lado do parâmetro de análise que deseja alterar e escolha **Editar parâmetro**. Você pode adicionar outros parâmetros de conjunto de dados a esse parâmetro de análise escolhendo o menu suspenso **ADICIONAR PARÂMETRO DE CONJUNTO DE DADOS** e, em seguida, selecionando o parâmetro que deseja mapear. Você pode remover o mapeamento de um parâmetro de conjunto de dados escolhendo o botão **Remover** ao lado do parâmetro do conjunto de dados que deseja remover. Você também pode remover todos os parâmetros de conjunto de dados mapeados escolhendo **REMOVER TUDO**. Quando terminar de fazer alterações, escolha **Atualizar**.
Quando você exclui um parâmetro de análise, o mapeamento de todos os parâmetros de conjunto de dados são removidos da análise e aparecem na seção **NÃO MAPEADO** do painel **Parâmetros**. Você só pode mapear um parâmetro de conjunto de dados a um parâmetro de análise por vez. Para mapear um parâmetro de conjunto de dados a um parâmetro de análise diferente, remova o mapeamento do parâmetro de conjunto de dados e mapeie-o para o novo parâmetro de análise.
## Adição dos controles de filtro a parâmetros de análise mapeados
Depois de mapear um parâmetro do conjunto de dados para um parâmetro de análise no Quick, você pode criar controles de filtro para filtros, ações, campos calculados, títulos, descrições e. URLs
**Adicionar um controle a um parâmetro mapeado**
1. No painel **Parâmetros** da página de análise, escolha as reticências (três pontos) ao lado do parâmetro de análise mapeado que você deseja, e depois **Adicionar controle**.
1. Na janela **Adicionar controle** exibida, insira o **Nome** desejado e escolha o **Estilo** que deseja para o controle. Para controles de valor único, escolha entre `Dropdown`, `List` e `Text field`. Para controles de vários valores, escolha `Dropdown`.
1. Escolha **Adicionar** para criar o controle.
# Casos de uso avançados dos parâmetros de conjunto de dados
Esta seção aborda opções e casos de uso mais avançados que funcionam com parâmetros de conjunto de dados e controles suspensos. Use as instruções a seguir para criar valores suspensos dinâmicos com parâmetros de conjunto de dados.
## Como usar controles de vários valores com parâmetros de conjunto de dados
Quando você usa parâmetros de conjunto de dados que são inseridos no SQL personalizado de um conjunto de dados, os parâmetros de conjunto de dados geralmente filtram os dados por valores de uma coluna específica. Se você criar um controle suspenso e atribuir o parâmetro como valor, o menu suspenso mostrará somente o valor que o parâmetro filtrou. O procedimento a seguir mostra como você pode criar um controle mapeado a um parâmetro de conjunto de dados e todos os valores não filtrados.
**Preencher todos os valores atribuídos em um controle suspenso**
1. Crie um novo conjunto de dados de coluna única no SPICE ou na consulta direta que inclua todos os valores exclusivos do conjunto de dados original. Por exemplo, digamos que seu conjunto de dados original esteja usando o seguinte SQL personalizado:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
Para criar uma tabela de coluna única com todos os estados de origem exclusivos, aplique o seguinte SQL personalizado ao novo conjunto de dados:
```
SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc
```
A expressão SQL retorna todos os estados exclusivos em ordem alfabética. O novo conjunto de dados não tem nenhum parâmetro de conjunto de dados.
1. Insira um **Nome** para o novo conjunto de dados, depois salve e publique o conjunto de dados. Em nosso exemplo, o novo conjunto de dados chama-se `State Codes`.
1. Abra a análise que contém o conjunto de dados original e adicione o novo conjunto de dados à análise. Para obter informações sobre como adicionar conjuntos de dados a uma análise existente, consulte [Como adicionar um conjunto de dados a uma análise](adding-a-data-set-to-an-analysis.md).
1. Navegue até o painel **Controles** e encontre o controle suspenso que deseja editar. Escolha as reticências (três pontos) ao lado do controle e **Editar**.
1. No **Controle de formato** que aparece à esquerda, escolha **Vincular a um campo de conjunto de dados** na seção **Valores**.
1. No menu suspenso **Conjunto de dados** exibido, escolha o novo conjunto de dados que você criou. No nosso exemplo, o conjunto de dados `State Codes` é escolhido.
1. Para o menu suspenso **Campo** exibido, escolha o campo apropriado. No nosso exemplo, o campo `origin_state_abr` é escolhido.
Depois que você terminar de vincular o controle ao novo conjunto de dados, todos os valores exclusivos aparecerão no menu suspenso do controle. Isso inclui os valores filtrados pelo parâmetro de conjunto de dados.
## Como usar controles com as opções Selecionar tudo
Por padrão, quando um ou mais parâmetros de conjunto de dados são mapeados para um parâmetro de análise e adicionados a um controle, a opção `Select all` não fica disponível. O procedimento a seguir mostra uma solução alternativa que usa o mesmo cenário de exemplo da seção anterior.
**nota**
Essa instrução é para conjuntos de dados que são pequenos o suficiente para serem carregados na consulta direta. Se você tiver um conjunto de dados grande e quiser usar a opção `Select All`, é recomendável carregar o conjunto de dados no SPICE. No entanto, se você quiser usar a opção `Select All` com parâmetros de conjunto de dados, este passo a passo descreve uma maneira de fazer isso.
Para começar, digamos que você tenha um conjunto de dados de consulta direta com SQL personalizado que contenha um parâmetro de vários valores chamado `States`:
```
select * from all_flights
where origin_state_abr in (<<$States>>)
```
**Usar a opção Selecionar tudo em um controle que usa parâmetros de conjunto de dados**
1. No painel **Parâmetros** da análise, localize o parâmetro de conjunto de dados que deseja usar e escolha **Editar** nas reticências (três pontos) ao lado do parâmetro.
1. Na janela **Editar parâmetro** exibida, insira um novo valor padrão na seção **Múltiplos valores padrão estáticos**. No nosso exemplo, o valor padrão é ` All States`. Observe que o exemplo usa um caractere de espaço inicial para que o valor padrão apareça como o primeiro item no controle.
1. Escolha **Atualizar** para atualizar o parâmetro.
1. Navegue até o conjunto de dados que contém o parâmetro do conjunto de dados que você está usando no. analysis-by-analysis Edite o SQL personalizado do conjunto de dados para incluir um caso de uso padrão para seus novos múltiplos valores padrão estáticos. Usando o exemplo ` All States`, a expressão SQL aparece da seguinte forma:
```
select * from public.all_flights
where
' All States' in (<<$States>>) or
origin_state_abr in (<<$States>>)
```
Se o usuário escolher ` All States` no controle, a nova expressão SQL retornará todos os registros exclusivos. Se o usuário escolher um valor diferente do controle, a consulta retornará valores que foram filtrados pelo parâmetro de conjunto de dados.
### Como usar controles com as opções Selecionar tudo e vários valores
Você pode combinar o procedimento `Select all` anterior com o método de controle de múltiplos valores discutido anteriormente, a fim de criar controles suspensos que contenham um valor `Select all` além de múltiplos valores que o usuário pode selecionar. Essa instrução pressupõe que você tenha seguido os procedimentos anteriores, que saiba como mapear os parâmetros de conjunto de dados aos parâmetros de análise e que possa criar controles em uma análise. Para obter mais informações sobre o mapeamento de parâmetros de análise, consulte [Mapeando parâmetros do conjunto de dados em novas análises rápidas](dataset-parameters-analysis.md#dataset-parameters-map-to-analysis). Para obter mais informações sobre a criação de controles em uma análise que está usando parâmetros de conjunto de dados, consulte [Adição dos controles de filtro a parâmetros de análise mapeados](dataset-parameters-analysis.md#dataset-parameters-analysis-filter-control).
**Adicionar múltiplos valores a um controle com a opção Selecionar tudo e um parâmetro de conjunto de dados mapeado**
1. Abra a análise que tem o conjunto de dados original com uma expressão SQL `Select all` personalizada e um segundo conjunto de dados que inclui todos os valores possíveis da coluna filtrada existente no conjunto de dados original.
1. Navegue até o conjunto de dados secundário que foi criado anteriormente para retornar todos os valores de uma coluna filtrada. Adicione uma expressão SQL personalizada que adicione sua opção `Select all` configurada anteriormente à consulta. O exemplo a seguir adiciona o registro ` All States` ao topo da lista de valores retornados do conjunto de dados:
```
(Select ' All States' as origin_state_abr)
Union All
(SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc)
```
1. Volte para a análise à qual os conjuntos de dados pertencem e mapeie o parâmetro de conjunto de dados que você está usando ao parâmetro de análise criado na terceira etapa do procedimento anterior. O parâmetro de análise e o parâmetro de conjunto de dados podem ter o mesmo nome. No nosso exemplo, o parâmetro de análise chama-se `States`.
1. Crie um novo controle de filtro ou edite um controle de filtro existente e escolha **Ocultar Selecionar tudo** para ocultar a opção desabilitada **Selecionar tudo** que aparece nos controles de vários valores.
Depois de criar o controle, os usuários podem usar o mesmo controle para selecionar todos ou múltiplos valores de uma coluna filtrada em um conjunto de dados.