Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Uso de parámetros de conjuntos de datos en Amazon Quick
En Amazon Quick, los autores pueden usar parámetros de conjuntos de datos en consultas directas para personalizar dinámicamente sus conjuntos de datos y aplicar una lógica reutilizable a sus conjuntos de datos. Un *parámetro de conjunto de datos* es un parámetro creado a nivel de conjunto de datos. Un parámetro de análisis lo consume a través de controles, campos calculados, filtros, acciones URLs, títulos y descripciones. Para obtener más información sobre los parámetros de análisis, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md). La siguiente lista describe tres acciones que se pueden realizar con los parámetros del conjunto de datos:
+ **SQL personalizado en la consulta directa**: los propietarios del conjunto de datos pueden insertar los parámetros del conjunto de datos en el SQL personalizado de un conjunto de datos de consulta directa. Cuando estos parámetros se aplican a un control de filtro en un análisis rápido, los usuarios pueden filtrar sus datos personalizados de forma más rápida y eficiente.
+ **Variables repetibles**: los valores estáticos que aparecen en varias ubicaciones de la página del conjunto de datos se pueden modificar en una sola acción mediante los parámetros del conjunto de datos personalizados.
+ **Mover los campos calculados a conjuntos** de datos: los autores rápidos pueden copiar los campos calculados con los parámetros de un análisis y migrarlos al nivel del conjunto de datos. Esto evita que los campos calculados a nivel de análisis se modifiquen accidentalmente y que los campos calculados se compartan en varios análisis.
En algunas situaciones, los parámetros del conjunto de datos mejoran el rendimiento del control de filtros para los conjuntos de datos de consulta directa que requieren un SQL personalizado complejo y simplifican la lógica empresarial a nivel del conjunto de datos.
**Topics**
+ [Limitaciones de los parámetros del conjunto de datos](#dataset-parameters-limitations)
+ [Creación de parámetros de conjuntos de datos en Amazon Quick](dataset-parameters-SQL.md)
+ [Inserción de parámetros de conjunto de datos en un SQL personalizado](dataset-parameters-insert-parameter.md)
+ [Incorporación de parámetros conjuntos de datos en los campos calculados](dataset-parameters-calculated-fields.md)
+ [Incorporación de parámetros de conjunto de datos a los filtros](dataset-parameters-dataset-filters.md)
+ [Uso de los parámetros del conjunto de datos en los análisis rápidos](dataset-parameters-analysis.md)
+ [Casos de uso avanzados de los parámetros del conjunto de datos](dataset-parameters-advanced-options.md)
## Limitaciones de los parámetros del conjunto de datos
En esta sección se describen las limitaciones conocidas que puede encontrar al trabajar con parámetros de conjuntos de datos en Amazon Quick.
+ Cuando los lectores del panel programan los informes enviados por correo electrónico, los controles seleccionados no se propagan a los parámetros del conjunto de datos que se incluyen en el informe adjunto al correo electrónico. En su lugar, se utilizan los valores predeterminados de los parámetros.
+ Los parámetros del conjunto de datos no se pueden insertar en el SQL personalizado de los conjuntos de datos almacenados en SPICE.
+ Los valores predeterminados dinámicos solo se pueden configurar en la página de análisis del análisis que utiliza el conjunto de datos. No puede configurar un valor predeterminado dinámico a nivel del conjunto de datos.
+ La opción **Seleccionar todo** no se admite en los controles de varios valores de los parámetros de análisis que están asignados a los parámetros del conjunto de datos.
+ Los controles en cascada no son compatibles con los parámetros del conjunto de datos.
+ Los filtros del conjunto de datos solo pueden usar los parámetros del conjunto de datos cuando el conjunto de datos utiliza la consulta directa.
+ En una consulta SQL personalizada, solo se pueden usar 128 parámetros del conjunto de datos.
# Creación de parámetros de conjuntos de datos en Amazon Quick
Utilice los siguientes procedimientos para empezar a utilizar los parámetros del conjunto de datos.
**Creación de un nuevo parámetro de conjunto de datos**
1. En la página de inicio rápido, selecciona **Datos** a la izquierda, elige los puntos suspensivos (tres puntos) situados junto al conjunto de datos que quieres cambiar y, a continuación, selecciona **Editar**.
1. En la página **Conjunto de datos** que se abre, elija **Parámetros** a la izquierda y, a continuación, elija el icono (\$1) para crear un nuevo parámetro del conjunto de datos.
1. En la ventana emergente **Crear nuevo parámetro** que aparece, introduzca un nombre de parámetro en el cuadro **Nombre**.
1. En el menú desplegable **Tipo de datos**, elija el tipo de datos de parámetro que desee. Los tipos de datos admitidos son `String`, `Integer`, `Number` y `Datetime`. Esta opción no se puede cambiar después de crear el parámetro.
1. En **Valor predeterminado**, introduzca el valor predeterminado que desee que tenga el parámetro.
**nota**
Al asignar un parámetro del conjunto de datos a un parámetro de análisis, se puede elegir un valor predeterminado diferente. Cuando esto sucede, el valor predeterminado configurado aquí se reemplaza por el nuevo valor predeterminado.
1. En **Valores**, elija el tipo de valor que desee que tenga el parámetro. Los parámetros de **valor único** admiten controles desplegables de selección única, campos de texto y listas. Los parámetros de **valores múltiples** admiten controles desplegables de selección múltiple. Esta opción no se puede cambiar después de crear el parámetro.
1. Cuando haya terminado de configurar el nuevo parámetro, elija **Crear** para crear el parámetro.
# Inserción de parámetros de conjunto de datos en un SQL personalizado
Puede insertar los parámetros del conjunto de datos en el SQL personalizado de un conjunto de datos en el modo de consulta directa haciendo referencia a ellos con `<<$parameter_name>>` en la instrucción SQL. En tiempo de ejecución, los usuarios del panel de control pueden introducir valores de control de filtro asociados a un parámetro del conjunto de datos. Luego, pueden ver los resultados en los elementos visuales del panel una vez que los valores se propaguen a la consulta SQL. Puede usar los parámetros para crear filtros básicos basados en las entradas de los clientes en las cláusulas `where`. Como alternativa, puede añadir cláusulas `case when` o `if else` para cambiar dinámicamente la lógica de la consulta SQL en función de la entrada de un parámetro.
Por ejemplo, supongamos que desea añadir una cláusula `WHERE` a su SQL personalizado que filtre los datos en función del nombre de la región del usuario final. En este caso, se crea un parámetro de valor único denominado `RegionName`:
```
SELECT *
FROM transactions
WHERE region = <<$RegionName>>
```
También puede permitir que los usuarios proporcionen varios valores al parámetro:
```
SELECT *
FROM transactions
WHERE region in (<<$RegionNames>>)
```
En el siguiente ejemplo, más complejo, el autor de un conjunto de datos hace referencia a dos parámetros del conjunto de datos dos veces en función del nombre y los apellidos del usuario, que se pueden seleccionar en el control de filtro de un panel de control:
```
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)
```
También puede usar los parámetros de las cláusulas `SELECT` para crear nuevas columnas en un conjunto de datos a partir de la entrada del usuario:
```
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 crear una consulta SQL personalizada o editar una consulta existente antes de añadir un parámetro de conjunto de datos, consulte [Uso de SQL para personalizar los datos](adding-a-SQL-query.md).
Cuando se aplica un SQL personalizado con un parámetro de conjunto de datos, `<<$parameter_name>>` se utiliza como valor de marcador de posición. Cuando un usuario elige uno de los valores de los parámetros de un control, Quick reemplaza el marcador de posición por los valores que el usuario selecciona en el panel de control.
En el siguiente ejemplo, el usuario introduce una nueva consulta SQL personalizada que filtra los datos por estado:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
El valor predeterminado del parámetro se aplica a la consulta SQL y los resultados aparecen en el **panel de vista previa**.
# Incorporación de parámetros conjuntos de datos en los campos calculados
También puede agregar parámetros del conjunto de datos a las expresiones de campo calculadas mediante el formato `${parameter_name}`.
Cuando crea un cálculo, puede elegir parámetros existentes de la lista de parámetros bajo la lista **Parámetros**. No puede crear un campo calculado que contenga parámetros de varios valores.
Para obtener más información sobre cómo agregar campos calculados, consulte [Uso de campos calculados con parámetros en Amazon Quick](parameters-calculated-fields.md).
# Incorporación de parámetros de conjunto de datos a los filtros
Para los conjuntos de datos en modo de consulta directa, los autores de los conjuntos de datos pueden usar los parámetros del conjunto de datos en los filtros sin un SQL personalizado. Los parámetros del conjunto de datos no se pueden añadir a los filtros si el conjunto de datos está en SPICE.
**Adición de un parámetro de conjunto de datos a un filtro**
1. Abra la página del conjunto de datos para el que quiere crear un filtro. Seleccione **Filtros** a la izquierda y, a continuación, seleccione **Agregar filtro**.
1. Introduzca el nombre que quiere que tenga el filtro y elija el campo que quiere filtrar en el menú desplegable.
1. Tras crear el nuevo filtro, navegue hasta el filtro en el panel **Filtros**, elija los puntos suspensivos (tres puntos) situados junto al filtro y, a continuación, elija **Editar**.
1. En **Tipo de filtro**, elija **Filtro personalizado**.
1. En **Condición de filtro**, elija la condición que desee.
1. Seleccione la casilla **Usar parámetro** y elija el parámetro del conjunto de datos que desee que use el filtro.
1. Cuando termine de realizar los cambios, elija **Aplicar**.
# Uso de los parámetros del conjunto de datos en los análisis rápidos
Una vez que haya creado un parámetro de conjunto de datos, después de añadir el conjunto de datos a un análisis, asigne el parámetro del conjunto de datos a un parámetro de análisis nuevo o existente. Después de asignar un parámetro del conjunto de datos a un parámetro de análisis, puede usarlos con filtros, controles y cualquier otra característica de los parámetros de análisis.
Puede administrar los parámetros del conjunto de datos en el panel **Parámetros** del análisis que utiliza el conjunto de datos al que pertenecen los parámetros. En la sección **Parámetros del conjunto de datos** del panel **Parámetros**, puede elegir ver solo los parámetros del conjunto de datos no asignados (opción predeterminada). Como alternativa, puede elegir ver todos los parámetros del conjunto de datos asginados y no asginados seleccionando **TODOS** en el menú desplegable **Visualización**.
## Mapeo de los parámetros del conjunto de datos en los nuevos análisis rápidos
Cuando crea un análisis nuevo a partir de un conjunto de datos que contiene parámetros, debe asginar los parámetros del conjunto de datos al análisis antes de poder usarlos. Esto también ocurre cuando se agrega un conjunto de datos con parámetros a un análisis. Puede ver todos los parámetros no asginados de un análisis en el panel **Parámetros** del análisis. Como alternativa, elija **VER** en el mensaje de notificación que aparece en la parte superior derecha de la página al crear el análisis o añadir el conjunto de datos.
**Asignación de un parámetro del conjunto de datos a un parámetro de análisis**
1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).
1. Elija el análisis que desee cambiar.
1. Elija el icono **Parámetros** para abrir el panel **Parámetros**.
1. Elija los puntos suspensivos (tres puntos) situados junto al parámetro del conjunto de datos que desee asignar, elija **Asignar parámetro** y, a continuación, elija el parámetro de análisis al que desee asignar el parámetro del conjunto de datos.
Si su análisis no tiene ningún parámetro de análisis, puede elegir **Asignar parámetro** y **Crear nuevo** para crear un parámetro de análisis que se asigne automáticamente al parámetro del conjunto de datos al crearlo.
1. (Opcional) En la ventana emergente **Crear nuevo parámetro** que aparece, introduzca un nombre para el nuevo parámetro de análisis en **Nombre**.
1. (Opcional) En **Valor predeterminado estático**, elija el valor predeterminado estático que desee que tenga el parámetro.
1. (Opcional) Seleccione **Establecer un valor predeterminado dinámico** para establecer un valor predeterminado dinámico para el nuevo parámetro.
1. En la tabla de **Parámetros del conjunto de datos asignados**, verá el parámetro del conjunto de datos que está asignado al nuevo parámetro de análisis. Puede agregar otros parámetros del conjunto de datos a este parámetro de análisis; para ello, seleccione el menú desplegable **AÑADIR TODOS LOS PARÁMETROS DEL CONJUNTO DE DATOS** y, a continuación, elija el parámetro que desee asignar. Para desasignar un parámetro del conjunto de datos, seleccione el botón **Eliminar** situado junto al parámetro del conjunto de datos que desea eliminar.
Para obtener más información sobre la creación de parámetros de análisis, consulte [Configuración de parámetros en Amazon Quick](parameters-set-up.md).
Al asignar un parámetro de conjunto de datos a un parámetro de análisis, el parámetro de análisis representa el parámetro del conjunto de datos independientemente de dónde se utilice en el análisis.
También puede asignar y desasignar los parámetros del conjunto de datos a los parámetros de análisis en la ventana **Editar parámetro**. Para abrir la ventana **Editar parámetro**, vaya al panel **Parámetros**, elija los puntos suspensivos (tres puntos) situados junto al parámetro de análisis que desee cambiar y, a continuación, elija **Editar parámetro**. Puede agregar otros parámetros del conjunto de datos a este parámetro de análisis; para ello, seleccione el menú desplegable **AÑADIR TODOS LOS PARÁMETROS DEL CONJUNTO DE DATOS** y, a continuación, elija el parámetro que desee asignar. Para desasignar un parámetro del conjunto de datos, seleccione el botón **Eliminar** situado junto al parámetro del conjunto de datos que desea eliminar. También puede eliminar todos los parámetros del conjunto de datos asignados si elige **ELIMINAR TODOS**. Cuando haya terminado de realizar los cambios, elija **Actualizar**.
Al eliminar un parámetro de análisis, todos los parámetros del conjunto de datos se desasignan del análisis y aparecen en la sección **SIN ASIGNAR** del panel **Parámetros**. Solo puede asignar un parámetro de conjunto de datos a un parámetro de análisis a la vez. Para asignar un parámetro del conjunto de datos a un parámetro de análisis diferente, desasigne el parámetro del conjunto de datos y, a continuación, asígnelo al nuevo parámetro de análisis.
## Incorporación de controles de filtro a los parámetros de análisis asignados
Después de asignar un parámetro del conjunto de datos a un parámetro de análisis en Quick, puede crear controles de filtro para filtros, acciones, campos calculados, títulos, descripciones y URLs.
**Adición de un control a un parámetro asignado**
1. En el panel **Parámetros** de la página de análisis, elija los puntos suspensivos (tres puntos) situados junto al parámetro de análisis asignado que desee y, a continuación, elija **Añadir control**.
1. En la ventana **Añadir control** que aparece, introduzca el **Nombre** que desee y elija el **Estilo** que quiere que tenga el control. Para los controles de un solo valor, elija entre `Dropdown`, `List` y `Text field`. Para los controles con varios valores, elija `Dropdown`.
1. Para crear el control, elija **Añadir**.
# Casos de uso avanzados de los parámetros del conjunto de datos
En esta sección, se describen opciones y casos de uso más avanzados que funcionan con parámetros del conjunto de datos y controles desplegables. Use los siguientes tutoriales para crear valores desplegables dinámicos con parámetros del conjunto de datos.
## Uso de controles de varios valores con parámetros del conjunto de datos
Cuando utiliza parámetros del conjunto de datos que se insertan en el SQL personalizado de un conjunto de datos, los parámetros del conjunto de datos suelen filtrar los datos por valores de una columna específica. Si crea un control desplegable y asigna el parámetro como valor, el menú desplegable solo muestra el valor que filtró el parámetro. El procedimiento siguiente muestra cómo se puede crear un control que esté asignado a un parámetro de conjunto de datos y muestre todos los valores sin filtrar.
**Relleno de todos los valores asignados en un control desplegable**
1. Cree un nuevo conjunto de datos de una sola columna en SPICE o realice una consulta directa que incluya todos los valores únicos del conjunto de datos original. Por ejemplo, supongamos que el conjunto de datos original utiliza el siguiente SQL personalizado:
```
select * from all_flights
where origin_state_abr = <<$State>>
```
Para crear una tabla de una sola columna con todos los estados de origen únicos, aplique el siguiente SQL personalizado al nuevo conjunto de datos:
```
SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc
```
La expresión SQL devuelve todos los estados únicos en orden alfabético. El conjunto de datos nuevo no tiene parámetros de conjunto de datos.
1. Introduzca un **Nombre** para el nuevo conjunto de datos y, a continuación, guarde y publique el conjunto de datos. En nuestro ejemplo, el nuevo conjunto de datos se llama `State Codes`.
1. Abra el análisis que contiene el conjunto de datos original y añada el nuevo conjunto de datos al análisis. Para obtener información sobre cómo agregar conjuntos de datos a un análisis existente, consulte [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md).
1. Navegue hasta el panel **Controles** y busque el control desplegable que desee editar. Seleccione los puntos suspensivos (tres puntos) situados junto al control y, a continuación, elija **Editar**.
1. En el **Control de formato** que aparece a la izquierda, seleccione **Enlazar a un campo del conjunto de datos** en la sección **Valores**.
1. En el menú desplegable **Conjunto de datos** que aparece, elija el nuevo conjunto de datos que ha creado. En nuestro ejemplo, se elige el conjunto de datos `State Codes`.
1. En el menú desplegable **Campo** que aparece, elija el campo correspondiente. En nuestro ejemplo, se elige el campo `origin_state_abr`.
Cuando termine de vincular el control al nuevo conjunto de datos, todos los valores únicos aparecen en el menú desplegable del control. Estos incluyen los valores que se filtran según el parámetro del conjunto de datos.
## Uso de controles con la opción “Seleccionar todo”
De forma predeterminada, cuando uno o más parámetros del conjunto de datos se asignan a un parámetro de análisis y se agregan a un control, la opción `Select all` no está disponible. El procedimiento siguiente muestra una solución alternativa que utiliza el mismo escenario de ejemplo de la sección anterior.
**nota**
Este tutorial es para conjuntos de datos que son lo suficientemente pequeños como para cargarse en una consulta directa. Si tiene un conjunto de datos grande y quiere usar la opción `Select All`, se recomienda cargar el conjunto de datos en SPICE. Sin embargo, si desea utilizar la opción `Select All` con los parámetros del conjunto de datos, en este tutorial se describe una forma de hacerlo.
Para empezar, supongamos que tiene un conjunto de datos de consulta directa con SQL personalizado que contiene un parámetro de varios valores llamado `States`:
```
select * from all_flights
where origin_state_abr in (<<$States>>)
```
**Uso de la opción “Seleccionar todo” en un control que usa parámetros del conjunto de datos**
1. En el panel **Parámetros** del análisis, busque el parámetro del conjunto de datos que desee usar y elija **Editar** en los puntos suspensivos (tres puntos) situados junto al parámetro.
1. En la ventana **Editar parámetro** que aparece, introduzca un nuevo valor predeterminado en la sección **Valores predeterminados múltiples estáticos**. En nuestro ejemplo, el valor predeterminado es ` All States`. Tenga en cuenta que en el ejemplo se utiliza un espacio inicial para que el valor predeterminado aparezca como primer elemento del control.
1. Seleccione **Actualizar** para actualizar el parámetro.
1. Navegue hasta el conjunto de datos que contiene el parámetro del conjunto de datos que está utilizando en el. analysis-by-analysis Edite el SQL personalizado del conjunto de datos para incluir un caso de uso predeterminado para sus nuevos valores predeterminados múltiples estáticos. En el ejemplo ` All States`, la expresión SQL aparece de la siguiente manera:
```
select * from public.all_flights
where
' All States' in (<<$States>>) or
origin_state_abr in (<<$States>>)
```
Si el usuario elige ` All States` en el control, la nueva expresión SQL devuelve todos los registros únicos. Si el usuario elige un valor diferente del control, la consulta devuelve los valores filtrados por el parámetro del conjunto de datos.
### Uso de controles con las opciones “Seleccionar todo” y varios valores
Puede combinar el procedimiento `Select all` anterior con el método de control de varios valores descrito anteriormente para crear controles desplegables que contengan un valor `Select all` además de varios valores que el usuario puede seleccionar. En este tutorial se supone que ha seguido los procedimientos anteriores, que sabe cómo asignar los parámetros del conjunto de datos a los parámetros de análisis y que puede crear controles en un análisis. Para obtener más información sobre la asignación de parámetros de análisis, consulte [Mapeo de los parámetros del conjunto de datos en los nuevos análisis rápidos](dataset-parameters-analysis.md#dataset-parameters-map-to-analysis). Para obtener más información sobre la creación de controles en un análisis que utiliza parámetros del conjunto de datos, consulte [Incorporación de controles de filtro a los parámetros de análisis asignados](dataset-parameters-analysis.md#dataset-parameters-analysis-filter-control).
**Adición de varios valores a un control con la opción “Seleccionar todo” y un parámetro de conjunto de datos asignado**
1. Abra el análisis que contiene el conjunto de datos original con una expresión SQL `Select all` personalizada y un segundo conjunto de datos que incluya todos los valores posibles de la columna filtrada que existe en el conjunto de datos original.
1. Navegue hasta el conjunto de datos secundario que se creó anteriormente para devolver todos los valores de una columna filtrada. Agregue una expresión SQL personalizada que añada la opción `Select all` previamente configurada a la consulta. En el siguiente ejemplo, se agrega el registro ` All States` al principio de la lista de valores devueltos del conjunto de datos:
```
(Select ' All States' as origin_state_abr)
Union All
(SELECT distinct origin_state_abr FROM all_flights
order by origin_state_abr asc)
```
1. Regrese al análisis al que pertenecen los conjuntos de datos y asigne el parámetro del conjunto de datos que está utilizando al parámetro de análisis que creó en el paso 3 del procedimiento anterior. El parámetro de análisis y el parámetro del conjunto de datos pueden tener el mismo nombre. En nuestro ejemplo, el parámetro de análisis se llama `States`.
1. Cree un nuevo control de filtro o edite un control de filtro existente y elija **Ocultar Seleccionar todo** para ocultar la opción **Seleccionar todo** desactivada que aparece en los controles de varios valores.
Una vez creado el control, los usuarios pueden usar el mismo control para seleccionar todos o varios valores de una columna filtrada en un conjunto de datos.