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.

# Visualice, analice y comparta datos con análisis, paneles e informes en Amazon Quick Sight
<a name="quick-bi"></a>

Amazon Quick Sight es un servicio integral de inteligencia empresarial que le permite transformar los datos sin procesar en información significativa mediante visualizaciones, paneles e informes interactivos. Ya sea que se conecte a bases de datos, prepare conjuntos de datos, cree análisis o comparta paneles con las partes interesadas, Amazon Quick Sight proporciona las herramientas que necesita para tomar decisiones basadas en los datos.

En esta sección se describe el flujo de trabajo completo de Amazon Quick Sight, desde la conexión de datos inicial hasta el intercambio de informes finales. Aprenderá cómo conectarse a diversas fuentes de datos, preparar y transformar sus datos, crear visualizaciones atractivas, crear paneles interactivos y aprovechar las capacidades generativas de inteligencia empresarial para acelerar su flujo de trabajo analítico. Cada tema se basa en el anterior y proporciona una guía completa para maximizar el uso de las potentes funciones de Amazon Quick Sight.

**Topics**
+ [Conexión a los datos en Amazon Quick Sight](working-with-data.md)
+ [Actualización de datos en Amazon Quick Sight](refreshing-data.md)
+ [Preparación de datos en Amazon Quick Sight](preparing-data.md)
+ [Análisis e informes: visualización de datos en Amazon Quick Sight](working-with-visuals.md)
+ [Compartir datos y suscribirse a ellos en Amazon Quick Sight con paneles e informes](working-with-dashboards.md)
+ [Exploración de los paneles interactivos en Amazon Quick Sight](using-dashboards.md)
+ [Obtener información con el aprendizaje automático (ML) en Amazon Quick Sight](making-data-driven-decisions-with-ml-in-quicksight.md)
+ [BI generativa con Quick Sight](quicksight-gen-bi.md)
+ [Solución de problemas de Amazon Quick Sight](troubleshooting.md)
+ [Desarrollo con Amazon Quick Sight](quicksight_dev.md)

# Conexión a los datos en Amazon Quick Sight
<a name="working-with-data"></a>

Las personas que desempeñan diferentes funciones utilizan Amazon Quick Sight para realizar análisis y cálculos avanzados, diseñar paneles de datos, integrar análisis y tomar decisiones mejor informadas. Antes de que eso suceda, alguien que comprenda sus datos debe añadirlos a un conjunto de datos de [Quick](https://docs.aws.amazon.com/quicksuite/latest/userguide/creating-data-sets) Sight. Quick Sight admite conexiones y cargas directas desde diversas [fuentes de datos](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-data-sources).**Capacidades y casos de uso**

**Capacidades de la edición Amazon Quick Standard**  
Una vez que sus datos estén disponibles en la edición Quick Standard, puede hacer lo siguiente:  
+ Transformar el conjunto de datos con el formato de los campos, las jerarquías, las conversiones de tipos de datos y los cálculos.
+ Crear uno o más análisis de datos en función del conjunto de datos que se acaba de crear.
+ Compartir su análisis con otras personas para que puedan ayudarle a diseñarlo.
+ Agregar cuadros, gráficos, más conjuntos de datos y varias páginas (denominadas hojas) a su análisis de datos.
+ Crear contenido visualmente atractivo con formatos y temas personalizados.
+ Hacerlos interactivos mediante parámetros, controles, filtros y acciones personalizadas.
+ Combinar datos de varias orígenes de datos y, a continuación, crear nuevas jerarquías para desglosar y realizar cálculos que solo estén disponibles durante el análisis, como las agregaciones, las funciones de ventana y mucho más.
+ Publicar su análisis como un panel de datos interactivo.
+ Compartir el panel para que otras personas puedan usarlo, incluso si no utilizan el análisis en el que se basa.
+ Añadir más datos para crear más análisis y paneles.

**Capacidades de la edición **Amazon Quick** Enterprise**  
Una vez que sus datos estén disponibles en la edición Quick Enterprise, podrá realizar diferentes acciones en función de su función. Si puede crear conjuntos de datos, diseñar análisis y publicar paneles, podrá hacer todo lo que hacen los usuarios de Standard Edition.   
Además, estos son algunos ejemplos de tareas adicionales que puede realizar:  
+ Cree análisis que utilicen la información de Quick Sight, incluida la información basada en el aprendizaje automático (ML) para la previsión, la detección de anomalías y valores atípicos y la identificación de los factores clave.
+ Diseñar ideas narrativas con texto, colores, imágenes y cálculos.
+ Añada datos de nubes privadas virtuales (VPCs) y fuentes de datos locales, con el cifrado de datos inactivo.
+ Controlar el acceso a los conjuntos de datos al añadir seguridad a nivel de fila y columna.
+ Actualizar los conjuntos de datos importados cada hora.
+ Compartir los informes enviados por correo electrónico.

**Desarrollo de aplicaciones**  
Si desarrolla aplicaciones o usa AWS SDKs y AWS Command Line Interface (AWS CLI), puede hacer lo siguiente y mucho más:  
+ Añadir análisis integrados y paneles interactivos integrados a sitios web y aplicaciones.
+ Utilizar las operaciones de la API para administrar los orígenes de datos y los conjuntos de datos.
+ Actualizar los datos importados con más frecuencia mediante las operaciones de la API de ingesta de datos.
+ Crear scripts, transferir y crear plantillas a partir de análisis y paneles mediante operaciones de API.
+ Asignar a las personas roles de seguridad mediante programación en función de la configuración gestionada por los administradores del sistema.

**Funciones administrativas en Quick**  
Si realiza funciones administrativas en Quick, puede hacer lo siguiente y mucho más:  
+ Administrar la seguridad con carpetas compartidas para organizar el trabajo de sus equipos y ayudarlos a colaborar mediante paneles, análisis y conjuntos de datos.
+ Añada Quick Sight a su VPC para permitir el acceso a los datos de la VPC y de las fuentes de datos locales.
+ Proteger los datos confidenciales con un control de acceso detallado a los orígenes de datos de AWS .
+ Asigne manualmente a las personas el rol de seguridad de Quick Author para que puedan preparar conjuntos de datos, diseñar análisis y publicar paneles de datos a un costo fijo por mes.
+ Asigne manualmente a las personas la función de seguridad de Quick Reader para que puedan interactuar de forma segura con los paneles de datos publicados de forma periódica. pay-per-session 

**Suscripción al panel**  
Si se suscribe a los paneles, puede hacer lo siguiente:  
+ Utilizar los paneles interactivos diseñados por su equipo de expertos y suscribirse a ellos.
+ Disfrutar de una interfaz simplificada y ordenada.
+ Ver las instantáneas del panel de control en el correo electrónico.
+ Concentrarse en tomar decisiones con los datos al alcance de la mano.

Después de conectarse a los datos o importarlos, crear un conjunto de datos para dar forma a los datos y prepararlos para compartirlos y reutilizarlos. Puede ver los conjuntos de datos disponibles en la página de **datos**, a la que puede acceder seleccionando **Datos** en la página de inicio de Amazon Quick Sight. Puede ver las fuentes de datos disponibles y crear un nuevo conjunto de datos en la página **Crear un conjunto de datos**, a la que puede acceder seleccionando **Crear** y luego **Nuevo conjunto de datos** en la página de **datos**.

**Topics**
+ [Orígenes de datos admitidos](supported-data-sources.md)
+ [Conéctese a sus datos con integraciones y conjuntos de datos](connecting-to-data-examples.md)
+ [Cuotas de origen de datos](data-source-limits.md)
+ [Tipos de datos y valores admitidos](supported-data-types-and-values.md)
+ [Trabajar con conjuntos de datos](working-with-datasets.md)
+ [Uso de fuentes de datos en Amazon Quick Sight](working-with-data-sources.md)

# Orígenes de datos admitidos
<a name="supported-data-sources"></a>

Amazon Quick Sight admite diversas fuentes de datos que puede utilizar para proporcionar datos para los análisis. Son compatibles los siguientes orígenes de datos.

## Conexión a datos relacionales
<a name="relational-data-sources"></a>

Puede utilizar cualquiera de los siguientes almacenes de datos relacionales como fuentes de datos para Amazon Quick Sight:
+ Amazon Athena
+ Amazon Aurora
+ AWS Glue Se puede acceder al catálogo de AWS Glue datos mediante servicios compatibles con el catálogo de datos, como Athena o Redshift Spectrum
+  OpenSearch Servicio Amazon
+ Amazon Redshift
+ Amazon Redshift Spectrum
+ Amazon S3
+ Análisis de Amazon S3
+ Apache Impala
+ Apache Spark 2.0 o posterior
+ AWS IoT Analytics
+ Databricks (solo para la plataforma E2) en Spark 1.6 o posterior, hasta la versión 3.0 
+ Exasol 7.1.2 o posterior
+ Google BigQuery
+ MariaDB 10.0 o posterior
+ Microsoft SQL Server 2012 o posterior
+ MySQL 5.7 o posterior
**nota**  
A partir de octubre de 2023, la comunidad MySQL ha dejado de ofrecer soporte a la versión 5.7 de MySQL. Esto significa que Amazon Quick Sight ya no admitirá nuevas funciones, mejoras, correcciones de errores o parches de seguridad para MySQL 5.7. Se prestará soporte para la carga de trabajo de consultas existente en la medida de lo posible. Los clientes de Quick Sight pueden seguir utilizando conjuntos de datos MySQL 5.7 con Quick Sight, pero les recomendamos que actualicen sus bases de datos MySQL (DB) a la versión principal 8.0 o superior. Para ver la declaración que proporciona Amazon RDS, consulte [Amazon RDS Extended Support opt-in behavior is changing. Actualice sus instancias de base de datos de Amazon RDS para MySQL 5.7 antes del 29 de febrero de 2024 para evitar un posible aumento de gastos](https://repost.aws/articles/ARHdQg4IelQS2uyXkNrINw-A/announcement-amazon-rds-extended-support-opt-in-behavior-is-changing-upgrade-your-amazon-rds-for-mysql-5-7-database-instances-before-february-29-2024-to-avoid-potential-increase-in-charges).  
Amazon RDS ha actualizado su configuración de seguridad para Amazon RDS MySQL 8.3. Todas las conexiones de Quick Sight a Amazon RDS MySQL 8.3 están habilitadas para SSL de forma predeterminada. Esta es la única opción disponible para las conexiones de MySQL 8.3.  
TLS 1.2 para conexiones MySQL requiere MySQL versión 5.7.28 o superior. Para las versiones de MySQL anteriores a 5.7.28, Quick Sight recurre a TLS 1.1. Si sus requisitos de seguridad exigen TLS 1.2, asegúrese de que su base de datos MySQL o Aurora MySQL ejecute la versión 5.7.28 o superior.
+ Oracle 12c o posterior
+ PostgreSQL 9.3.1 o posterior
**nota**  
La autenticación basada en SCRAM para PostgreSQL desde Amazon Quick Sight es compatible con los siguientes conectores: PostgreSQL alojado en RDS, Aurora PostgreSQL y Vanilla PostgreSQL. Si se utiliza la versión adecuada del motor PostgreSQL y se configuran las configuraciones correctas en PostgreSQL para SCRAM, no se necesitan configuraciones adicionales en Quick Sight. Si sigue teniendo problemas para establecer una autenticación SCRAM en PostgreSQL desde Quick Sight, cree un ticket de soporte.
+ Presto 0.167 o posterior
+ Snowflake
+ Starburst
+ Trino
+ Teradata 14.0 o posterior
+ Timestream

**nota**  
Para obtener acceso a orígenes de datos adicionales no mencionados aquí, puede vincularlos o importarlos desde orígenes de datos compatibles.

Los clústeres de Amazon Redshift, las bases de datos de Amazon Athena y las instancias de Amazon RDS deben estar en AWS. Las demás instancias de bases de datos deben estar en uno de los siguientes entornos para poder acceder a ellas desde Amazon Quick Sight:
+ Amazon EC2
+ Bases de datos locales (en las instalaciones)
+ Los datos que están en un centro de datos o algún otro entorno accesible a través de Internet

Para obtener más información, consulte [Seguridad de infraestructura en Amazon Quick](infrastructure-and-network-access.md).

## Importación de datos desde archivos
<a name="file-data-sources"></a>

Puede utilizar archivos en Amazon S3 o en la red local (en las instalaciones) como orígenes de datos. Quick Sight admite archivos en los siguientes formatos:
+ CSV y TSV: archivos de texto delimitados por comas y por tabulaciones
+ ELF y CLF: archivos de formato de registro común y ampliado
+ JSON: archivos de datos semiestructurados o sin formato
+ XLSX: archivos de Microsoft Excel

Quick Sight admite la codificación de archivos en UTF-8, pero no en UTF-8 (con BOM).

Los archivos de Amazon S3 comprimidos con zip o gzip ([www.gzip.org](http://www.gzip.org)), se pueden importar tal y como están. Si utilizó otro programa de compresión para archivos en Amazon S3, o si los archivos están en la red local, descomprímalos antes de importarlos.

### Datos JSON
<a name="json-data-sources"></a>

Amazon Quick Sight admite de forma nativa archivos planos JSON y archivos de datos semiestructurados JSON.

Puede cargar un archivo JSON o conectarse a su bucket de Amazon S3 que contiene datos JSON. Amazon Quick Sight realiza automáticamente inferencias de esquemas y tipos en archivos JSON y objetos JSON incrustados. A continuación, aplana el archivo JSON para que pueda analizar y visualizar los datos generados por la aplicación. 

La compatibilidad básica para datos de archivo sin formato JSON incluye lo siguiente:
+ Inferencia del esquema
+ Determinación de los tipos de datos
+ Aplanamiento de los datos
+ Análisis de JSON (objetos incrustados JSON) desde archivos sin formato

La compatibilidad básica para estructuras de archivo JSON (.json) incluye lo siguiente:
+ Registros JSON con estructuras
+ Registros JSON con elementos raíz como matrices

También puede utilizar la función `parseJson` para extraer valores de los objetos JSON en un archivo de texto. Por ejemplo, si el archivo CSV tiene un objeto JSON integrado en uno de los campos, puede extraer un valor de un par clave-valor (KVP) especificado. Para obtener más información acerca de cómo hacerlo, consulte [parseJson](parseJson-function.md).

Las siguientes características de JSON no son compatibles:
+ Lectura de JSON con una estructura que contiene una lista de registros
+ Enumeración de atributos y objetos dentro de un registro JSON; se omiten durante la importación
+ Personalización de carga o de configuración
+ Funciones parseJSON para SQL y análisis
+ Mensajes de error para JSON no válido
+ Extracción de un objeto JSON a partir de una estructura JSON
+ Lectura de registros JSON delimitados

Puede utilizar la función `parseJson` para analizar archivos sin formato durante la preparación de los datos. Esta función permite extraer elementos de listas y estructuras JSON válidas.

Se admiten los siguientes valores JSON:
+ Objeto JSON
+ Cadena (comillas dobles)
+ Número (entero y flotante)
+ Booleano
+ NULL

## Datos de un software como servicio (SaaS)
<a name="service-data-sources"></a>

Quick Sight puede conectarse a una variedad de fuentes de datos de software como servicio (SaaS) mediante una conexión directa o mediante Open Authorization ()OAuth.

Entre los orígenes de SaaS que admiten la conexión directa se incluyen las siguientes:
+ Jira
+ ServiceNow

Las fuentes de SaaS que utilizan OAuth requieren que autorice la conexión en el sitio web de SaaS. Para que esto funcione, Quick Sight debe poder acceder a la fuente de datos de SaaS a través de la red. Estos orígenes pueden ser:
+ Adobe Analytics
+ GitHub
+ Salesforce

  Puede utilizar informes u objetos de las siguientes ediciones de Salesforce como fuentes de datos para Amazon Quick Sight:
  + Enterprise Edition
  + Unlimited Edition
  + Developer Edition

## Fuentes de datos locales
<a name="local-data-sources"></a>

Para conectarse a fuentes de datos locales, debe añadir sus fuentes de datos y una interfaz de red específica de Quick a Amazon Virtual Private Cloud (Amazon VPC). Si se configura correctamente, una VPC basada en Amazon VPC es similar a una red tradicional que puede operar en su propio centro de datos. Le permite proteger y aislar el tráfico entre los recursos. Tiene que definir y controlar los elementos de la red para que se adapten a sus necesidades, sin dejar de aprovechar las ventajas de las redes en la nube y la infraestructura escalable de AWS.

Para obtener información detallada, consulta [Seguridad de infraestructura en Amazon Quick](infrastructure-and-network-access.md).

# Conéctese a sus datos con integraciones y conjuntos de datos
<a name="connecting-to-data-examples"></a>

Puede conectar Amazon Quick Sight a distintos tipos de fuentes de datos. Esto incluye los datos que residen en aplicaciones Software-as-a-Service (SaaS), los archivos planos almacenados en los buckets de Amazon S3, los datos de servicios de terceros, como Salesforce, y los resultados de las consultas de Athena. Utilice los siguientes ejemplos para obtener más información sobre los requisitos para conectarse a orígenes de datos específicos. 

**Topics**
+ [Creación de un conjunto de datos utilizando datos de Amazon Athena](create-a-data-set-athena.md)
+ [Uso de Amazon OpenSearch Service con Amazon Quick Sight](connecting-to-os.md)
+ [Creación de un conjunto de datos utilizando archivos de Amazon S3](create-a-data-set-s3.md)
+ [Creación de un origen de datos con Apache Spark](create-a-data-source-spark.md)
+ [Uso de Databricks en Quick Sight](quicksight-databricks.md)
+ [Creación de un conjunto de datos mediante Google BigQuery](quicksight-google-big-query.md)
+ [Creación de un conjunto de datos con un origen de datos de Hojas de cálculo de Google](create-a-dataset-google-sheets.md)
+ [Creación de un conjunto de datos con un origen de datos de Apache Impala](create-a-dataset-impala.md)
+ [Creación de un conjunto de datos utilizando un archivo de Microsoft Excel](create-a-data-set-excel.md)
+ [Creación de un origen de datos con Presto](create-a-data-source-presto.md)
+ [Uso de Snowflake con Amazon Quick Sight](connecting-to-snowflake.md)
+ [Uso de Starburst con Amazon Quick Sight](connecting-to-starburst.md)
+ [Creación de un orígen de datos y un conjunto de datos a partir de orígenes de SaaS](connecting-to-saas-data-sources.md)
+ [Creación de un conjunto de datos desde Salesforce](create-a-data-set-salesforce.md)
+ [Uso de Trino con Amazon Quick Sight](connecting-to-trino.md)
+ [Creación de un conjunto de datos utilizando un archivo de texto local](create-a-data-set-file.md)
+ [Uso de los datos de Amazon Timestream con Amazon Quick Sight](using-data-from-timestream.md)

# Creación de un conjunto de datos utilizando datos de Amazon Athena
<a name="create-a-data-set-athena"></a>

Utilice el siguiente procedimiento para crear un nuevo conjunto de datos que se conecte a los datos de Amazon Athena o a los datos de consulta federada de Athena.

**Conexión a Amazon Athena**

1. Comience por crear un nuevo conjunto de datos. Elija **Datos** en el panel de navegación de la izquierda.

1. Elija **Crear** y, a continuación, elija **Nuevo conjunto de datos**.

1. 

   1. Para utilizar un perfil de conexión de Athena existente (común), elija la tarjeta de la fuente de datos existente que desee utilizar. Elija **Seleccionar**. 

      Las tarjetas se etiquetan con el icono del origen de datos de Athena y el nombre proporcionados por la persona que creó la conexión.

   1. Para crear un nuevo perfil de conexión de Athena (menos común), siga los siguientes pasos:

      1. Elija **Nueva fuente de datos** y, a continuación, elija la tarjeta de fuente de datos **Athena**.

      1. Elija **Siguiente**.

      1. En **Nombre del origen de datos**, escriba un nombre descriptivo.

      1. En **Grupo de trabajo de Athena**, elija su grupo de trabajo.

      1. Elija **Validar conexión** para probar la conexión.

      1. Elija **Crear origen de datos**.

      1. (Opcional) Seleccione un ARN de rol de IAM para ejecutar las consultas. 

1. En la pantalla **Elija su tabla**, siga estos pasos:

   1. En **Catálogo**, seleccione una de las opciones siguientes:
      + Si utiliza Consulta federada de Athena, elija el catálogo que desee utilizar.
      + En caso contrario, elija **AwsDataCatalog**.

   1. Seleccione una de las siguientes opciones:
      + Para escribir una consulta SQL, seleccione **Usar consulta SQL personalizada**. 
      + Para elegir una base de datos y una tabla, elija el catálogo que contiene las bases de datos en el menú desplegable **Catálogo**. A continuación, elija una base de datos en el menú desplegable de **Base de datos** y elija una tabla de la lista **Tablas** que aparece para su base de datos.

   Si no tiene los permisos correctos, recibirá el siguiente mensaje de error: “You don't have sufficient permissions to connect to this dataset or run this query”. Póngase en contacto con su administrador de Quick para obtener ayuda. Para obtener más información, consulte [Autorización de las conexiones a Amazon Athena](athena.md). 

1. Elija **Editar/obtener vista previa de los datos**. 

1. Cree un conjunto de datos y analice los datos utilizando la tabla al elegir **Visualizar**. Para obtener más información, consulte [Análisis e informes: visualización de datos en Amazon Quick Sight](working-with-visuals.md). 

# Uso de Amazon OpenSearch Service con Amazon Quick Sight
<a name="connecting-to-os"></a>

A continuación, encontrarás información sobre cómo conectarte a tus datos de Amazon OpenSearch Service mediante Amazon Quick Sight.

## Crear una nueva conexión de fuente de datos de Quick Sight para OpenSearch Service
<a name="create-connection-to-es"></a>

A continuación, encontrará información sobre cómo conectarse al OpenSearch Servicio

Para poder continuar, Amazon Quick Sight debe estar autorizado para conectarse a Amazon OpenSearch Service. Si las conexiones no están habilitadas, aparecerá un mensaje de error al intentar conectarse. Un administrador de Quick Sight puede autorizar las conexiones a AWS los recursos. 

**Para autorizar a Quick Sight a iniciar una conexión con el OpenSearch Servicio**

1. Abre el menú haciendo clic en el icono de tu perfil en la parte superior derecha y, a continuación, selecciona **Administrar rápidamente**. Si no ves la opción **Administrar rápido** en el menú de tu perfil, pide ayuda al administrador de Amazon Quick.

1. En **Seguridad y permisos**, seleccione **Añadir o eliminar**.

1. Activa la opción para **OpenSearch**.

1. Elija **Actualizar**.

Una vez que se puede acceder OpenSearch al servicio, se crea una fuente de datos para que las personas puedan usar los dominios especificados.

**Para conectarse al OpenSearch Servicio**

1. Comience por crear un nuevo conjunto de datos. Elija **Datos** en el panel de navegación de la izquierda y, a continuación, elija **Crear un** **conjunto de datos nuevo**.

1. Elige la tarjeta de origen OpenSearch de datos de **Amazon**.

1. En el **campo Nombre de la fuente de datos**, introduce un nombre descriptivo para la conexión a la fuente de datos del OpenSearch servicio, por ejemplo`OpenSearch Service ML Data`. Como puede crear muchos conjuntos de datos a partir de una conexión al OpenSearch Servicio, es mejor mantener el nombre simple.

1. En **Tipo de conexión**, elija la red que desea usar. Puede ser una nube privada virtual (VPC) basada en Amazon VPC o una red pública. La lista de VPCs contiene los nombres de las conexiones de VPC, en lugar de los de VPC. IDs El administrador rápido define estos nombres. 

1. En **Dominio**, elija el dominio de OpenSearch servicio al que desee conectarse. 

1. Selecciona **Validar conexión** para comprobar que puedes conectarte correctamente al OpenSearch Servicio.

1. Elija **Crear origen de datos** para continuar.

1. En **Tablas**, elija la que desee utilizar y, a continuación, seleccione **Seleccionar** para continuar. 

1. Realice una de las siguientes acciones:
   + Para importar los datos al motor en memoria Quick Sight (denominadoSPICE), seleccione **Importar a SPICE para obtener un análisis más rápido**. Para obtener información sobre cómo habilitar la importación de OpenSearch datos, consulte[Autorización de conexiones a Amazon Service OpenSearch](opensearch.md).
   + Para permitir que Quick Sight ejecute una consulta sobre sus datos cada vez que actualice el conjunto de datos o utilice el análisis o el panel, seleccione **Consultar directamente los datos**. 

     Para habilitar la actualización automática en un panel publicado que usa datos del OpenSearch Servicio, el conjunto de datos del OpenSearch Servicio debe usar una consulta directa.

1. Seleccione **Editar/obtener vista** y, a continuación, **Guardar** para guardar el conjunto de datos y cerrarlo.

## Administrar los permisos de los datos OpenSearch del servicio
<a name="dataset-permissions-for-es"></a>

El siguiente procedimiento describe cómo ver, añadir y revocar los permisos para permitir el acceso a la misma fuente de datos del OpenSearch servicio. Las personas que agregue deben ser usuarios activos en Quick Sight antes de poder agregarlas. 

**Edición de los permisos de un origen de datos**

1. Selecciona **Datos** a la izquierda y desplázate hacia abajo para encontrar la tarjeta de origen de datos para tu conexión a Amazon OpenSearch Service. Por ejemplo, `US Amazon OpenSearch Service Data`.

1. Elige el OpenSearch conjunto de datos de **Amazon**.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Permisos**.

   Aparece una lista de permisos actuales.

1. Para añadir permisos, seleccione **Agregar usuarios y grupos** y, a continuación, siga estos pasos:

   1. Agregue usuarios o grupos para que puedan usar el mismo conjunto de datos.

   1. Cuando termine de añadir a todos los usuarios que quiera, elija los **Permisos** que quiera aplicarles.

1. (Opcional) Para editar los permisos, puede elegir **Espectador** o **Propietario**. 
   + Seleccione **Espectador** para permitir el acceso de lectura.
   + Elija **Propietario** para permitir que el usuario edite, comparta o elimine este conjunto de datos de Quick Sight. 

1. (Opcional) Para revocar los permisos, elija **Revocar acceso**. Después de revocar el acceso de una persona, esta no podrá crear nuevos conjuntos de datos a partir de este origen de datos. Sin embargo, sus conjuntos de datos existentes aún tendrán acceso a este origen de datos.

1. Cuando haya terminado, elija **Cerrar**.

## Agregar un nuevo conjunto de datos de Quick Sight para OpenSearch Service
<a name="create-dataset-using-es"></a>

Una vez que tenga una conexión de fuente de datos existente para el OpenSearch Servicio, puede crear conjuntos de datos del OpenSearch Servicio para usarlos en el análisis. 

**Para crear un conjunto de datos mediante Service OpenSearch**

1. En la página de inicio, selecciona **Datos**, **Crear** o **Nuevo conjunto de datos**.

1. Desplázate hacia abajo hasta la tarjeta de fuente de datos de tu conexión OpenSearch de servicio. Si tiene muchos orígenes de datos, puede utilizar la barra de búsqueda situada en la parte superior de la página para buscar el origen de datos cuyo nombre coincida parcialmente.

1. Elige la tarjeta de origen OpenSearch de datos de **Amazon** y, a continuación, selecciona **Crear conjunto de datos**.

1. **En Tablas**, elige el índice de OpenSearch servicios que quieres usar.

1. Elija **Editar/obtener vista previa**.

1. Elija **Guardar** para guardar y cerrar el conjunto de datos. 

## Añadir datos OpenSearch de servicio a un análisis
<a name="open-analysis-add-dataset-for-es"></a>

Una vez que tenga disponible un conjunto de datos de OpenSearch servicios, puede añadirlo a un análisis de Quick Sight. Antes de empezar, asegúrese de tener un conjunto de datos existente que contenga los datos del OpenSearch servicio que desee utilizar.

**Para añadir datos OpenSearch de servicio a un análisis**

1. Seleccione **Análisis** a la izquierda.

1. Realice una de las siguientes acciones:
   + Para crear un análisis nuevo, elija **Nuevo análisis** en la derecha. 
   + Para añadirlo a un análisis existente, abra el análisis que desea editar. 
     + Seleccione el icono del lápiz situado en la parte superior izquierda.
     + Seleccione **Agregar cojunto de datos**.

1. Elija el conjunto OpenSearch de datos de servicio que desee agregar. 

   Para obtener información sobre el uso OpenSearch del servicio en las visualizaciones, consulte[Limitaciones de uso OpenSearch del Servicio](#limitations-for-es). 

1. Para obtener más información, consulte [Working with analyses](https://docs.aws.amazon.com/quicksight/latest/user/working-with-analyses.html).

## Limitaciones de uso OpenSearch del Servicio
<a name="limitations-for-es"></a>

Se aplican las siguientes limitaciones al uso de los conjuntos OpenSearch de datos del Servicio:
+ OpenSearch Los conjuntos de datos de servicio admiten un subconjunto de tipos visuales, opciones de clasificación y opciones de filtro.
+ Para habilitar la actualización automática en un panel publicado que usa datos del OpenSearch Servicio, el conjunto de datos del OpenSearch Servicio debe usar una consulta directa.
+ No se admiten las operaciones de subconsulta múltiple. Para evitar errores durante la visualización, no añada correctamente varios campos a un cuadro de campo, utilice uno o dos campos por visualización y evite utilizar el cuadro de campo **Color**.
+ No se admiten el SQL personalizado.
+ No se admiten las uniones entre conjuntos de datos ni las uniones automáticas.
+ No se admiten campos calculados. 
+ No se admiten campos de texto. 
+ La categoría “otros” no es compatible. Si utilizas un conjunto de datos de OpenSearch servicio con una visualización compatible con la categoría «otros», desactiva la categoría «otros» mediante el menú de la imagen. 

# Creación de un conjunto de datos utilizando archivos de Amazon S3
<a name="create-a-data-set-s3"></a>

Para crear un conjunto de datos con uno o más archivos de texto (.csv, .tsv, .clf o .elf) de Amazon S3, cree un manifiesto para Quick Sight. Quick Sight usa este manifiesto para identificar los archivos que desea usar y los ajustes de carga necesarios para importarlos. Cuando cree un conjunto de datos utilizando Amazon S3, los datos del archivo se importarán automáticamente en [SPICE](spice.md).

Debe conceder acceso a Quick Sight a todos los buckets de Amazon S3 desde los que desee leer archivos. Para obtener información sobre cómo conceder a Quick Sight acceso a AWS los recursos, consulte[Configuración del acceso de Amazon Quick Sight a las fuentes AWS de datos](access-to-aws-resources.md).

**Topics**
+ [Formatos compatibles con los archivos de manifiesto de Amazon S3](supported-manifest-file-format.md)
+ [Creación de conjuntos de datos de Amazon S3](create-a-data-set-s3-procedure.md)
+ [Conjuntos de datos que utilizan archivos S3 en otra cuenta AWS](using-s3-files-in-another-aws-account.md)

# Formatos compatibles con los archivos de manifiesto de Amazon S3
<a name="supported-manifest-file-format"></a>

Los archivos de manifiesto JSON se utilizan para especificar los archivos de Amazon S3 que se van a importar a Quick Sight. Estos archivos de manifiesto JSON pueden utilizar el formato Quick Sight que se describe a continuación o el formato Amazon Redshift que se describe en [Uso de un manifiesto para especificar archivos de datos de la Guía para](https://docs.aws.amazon.com/redshift/latest/dg/loading-data-files-using-manifest.html) desarrolladores de bases de datos de *Amazon Redshift*. No es necesario utilizar Amazon Redshift para utilizar el formato de archivo de manifiesto de Amazon Redshift. 

Si utiliza un archivo de manifiesto de Quick Sight, debe tener la extensión.json, por ejemplo. `my_manifest.json` Si utiliza un archivo de manifiesto de Amazon Redshift, puede tener cualquier extensión. 

Si utiliza un archivo de manifiesto de Amazon Redshift, Quick Sight procesa la `mandatory` opción opcional como lo hace Amazon Redshift. Si no encuentra el archivo asociado, Quick Sight finaliza el proceso de importación y devuelve un error. 

Los archivos que seleccione para la importación deben ser de formato de texto delimitado (por ejemplo, .csv o .tsv), de registro (.clf) o de registro ampliado (.elf), o JSON (.json). Todos los archivos identificados en un archivo de manifiesto deben utilizar el mismo formato de archivo. Además, deben tener el mismo número y tipo de columnas. Quick Sight admite la codificación de archivos en UTF-8, pero no en UTF-8 con marca de orden de bytes (BOM). Si va a importar archivos JSON, para `globalUploadSettings` especifique `format`, pero no `delimiter`, `textqualifier` ni `containsHeader`.

Asegúrese de que todos los archivos que especifique estén en los buckets de Amazon S3 a los que ha concedido acceso a Quick Sight. Para obtener información sobre cómo conceder a Quick Sight acceso a AWS los recursos, consulte[Configuración del acceso de Amazon Quick Sight a las fuentes AWS de datos](access-to-aws-resources.md).

## Formato de archivo de manifiesto para Quick Sight
<a name="quicksight-manifest-file-format"></a>

Los archivos de manifiesto de Quick Sight utilizan el siguiente formato JSON.

```
{
    "fileLocations": [
        {
            "URIs": [
                "uri1",
                "uri2",
                "uri3"
            ]
        },
        {
            "URIPrefixes": [
                "prefix1",
                "prefix2",
                "prefix3"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
```

Utilice los campos del elemento `fileLocations` para especificar los archivos que desea importar y los campos del elemento `globalUploadSettings` para especificar la configuración de importación de dichos archivos, como delimitadores de campo. 

A continuación se describen los elementos del archivo de manifiesto.
+ **fileLocations**: utilice este elemento para especificar los archivos que desea importar. Puede utilizar una de las matrices `URIs` y `URIPrefixes` o las dos para hacerlo. Debe especificar al menos un valor en una o la otra.
  + **URIs**— Utilice esta matriz URIs para enumerar los archivos específicos que se van a importar.

    Quick Sight puede acceder a los archivos de Amazon S3 que se encuentren en cualquier archivo Región de AWS. Sin embargo, debe usar un formato de URI que identifique la AWS región del bucket de Amazon S3 si es diferente del que usa su cuenta Quick.

    URIs se admiten los siguientes formatos.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-manifest-file-format.html)
  + **URIPrefixes**— Utilice esta matriz para enumerar los prefijos de URI para los buckets y carpetas de S3. Se importan todos los archivos de un bucket o carpeta especificados. Quick Sight recupera de forma recursiva los archivos de las carpetas secundarias.

    Quick Sight puede acceder a los buckets o carpetas de Amazon S3 que se encuentren en cualquiera Región de AWS de ellos. Asegúrese de usar un formato de prefijo URI que identifique el bucket de S3 Región de AWS si es diferente del que usa su cuenta de Quick.

    Se admiten los prefijos URI que tengan los siguientes formatos.  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-manifest-file-format.html)
+ **globalUploadSettings**— (Opcional) Utilice este elemento para especificar la configuración de importación de los archivos de Amazon S3, como los delimitadores de campo. Si no se especifica este elemento, Quick Sight utiliza los valores predeterminados para los campos de esta sección.
**importante**  
Para archivos de registro (.clf) y registro ampliado (.elf), solo se aplica el campo **format** de esta sección, por lo que puede omitir el resto de los campos. Si decide incluirlos, sus valores se omiten. 
  + **format**: (opcional) especifique el formato de los archivos que se van a importar. Los formatos válidos son **CSV**, **TSV**, **CLF**, **ELF** y **JSON**. El valor predeterminado es **CSV**.
  + **delimiter**: (opcional) especifique el delimitador de campo del archivo. Este debe asignarse al tipo de archivo especificado en el campo `format`. Los formatos válidos son comas (**,**) para los archivos .csv y tabuladores (**\$1t**) para los archivos .tsv. El valor predeterminado es coma (**,**).
  + **textqualifier**: (opcional) especifique el calificador de texto del archivo. Los formatos válidos son comillas simples (**'**) y comillas dobles (**\$1"**). La barra diagonal inversa inicial es un carácter de escape obligatorio para las comillas dobles en JSON. El valor predeterminado es las comillas dobles (**\$1"**). Si el texto no necesita un calificador de texto, no incluya esta propiedad.
  + **containsHeader**: (opcional) especifique si el archivo tiene una fila de encabezado. Los formatos válidos son **true** o **false**. El valor predeterminado es **true**.

### Ejemplos de archivos de manifiesto para Quick Sight
<a name="quicksight-manifest-file-examples"></a>

A continuación se muestran algunos ejemplos de archivos de manifiesto de Quick Sight completados.

El siguiente ejemplo muestra un archivo de manifiesto que identifica dos archivos .csv específicos para su importación. Estos archivos utilizan comillas dobles como calificadores de texto. Los campos `format`, `delimiter`y `containsHeader` se omiten porque los valores predeterminados son aceptables.

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.csv",
                "https://yourBucket.s3.amazonaws.com/data-file-2.csv"
            ]
        }
    ],
    "globalUploadSettings": {
        "textqualifier": "\""
    }
}
```

El siguiente ejemplo muestra un archivo de manifiesto que identifica un archivo .tsv específico para su importación. Este archivo también incluye un bucket en otra región de AWS que contiene archivos .tsv adicionales para la importación. Los campos `textqualifier` y `containsHeader` se omiten porque los valores predeterminados son aceptables.

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://s3.amazonaws.com/amzn-s3-demo-bucket/data.tsv"
            ]
        },
        {
            "URIPrefixes": [
                "https://s3-us-east-1.amazonaws.com/amzn-s3-demo-bucket/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "TSV",
        "delimiter": "\t"
    }
}
```

El siguiente ejemplo identifica dos buckets que contienen archivos .clf para su importación. Uno está en la Región de AWS misma cuenta de Quick y el otro en una diferente Región de AWS. Los campos `delimiter`, `textqualifier` y `containsHeader` se omiten porque no son aplicables a los archivos de registro.

```
{
    "fileLocations": [
        {
            "URIPrefixes": [
                "https://amzn-s3-demo-bucket1.your-s3-url.com",
                "s3://amzn-s3-demo-bucket2/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CLF"
    }
}
```

En el siguiente ejemplo, se utiliza el formato de Amazon Redshift para identificar un archivo .csv que importar.

```
{
    "entries": [
        {
            "url": "https://amzn-s3-demo-bucket.your-s3-url.com/myalias-test/file-to-import.csv",
            "mandatory": true
        }
    ]
}
```

En el siguiente ejemplo, se utiliza el formato de Amazon Redshift para identificar dos archivos JSON que importar.

```
{
    "fileLocations": [
        {
            "URIs": [
                "https://yourBucket.s3.amazonaws.com/data-file.json",
                "https://yourBucket.s3.amazonaws.com/data-file-2.json"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "JSON"
    }
}
```

# Creación de conjuntos de datos de Amazon S3
<a name="create-a-data-set-s3-procedure"></a>

**Creación de un conjunto de datos de Amazon S3**

1. Consulte [Cuotas de origen de datos](data-source-limits.md) para asegurarse de que su conjunto de archivos de destino no supere las cuotas de origen de datos.

1. Cree un archivo de manifiesto para identificar los archivos de texto que desea importar, utilizando uno de los formatos especificados en [Formatos compatibles con los archivos de manifiesto de Amazon S3](supported-manifest-file-format.md).

1. Guarde el archivo de manifiesto en un directorio local o bien cárguelo en Amazon S3.

1. En la página de inicio rápido, elija **Datos**.

1. En la página de **datos**, elija **Crear** y, a continuación, **Nuevo conjunto de datos**.

1. Selecciona el icono de Amazon S3 y, a continuación, selecciona **Siguiente**.

1. En **Nombre de origen de datos**, escriba una descripción del origen de datos. Este nombre debe ayudarle a distinguir este origen de datos de otros.

1. Para completar el proceso **Cargar un archivo de manifiesto**, realice una de las siguientes acciones:
   + Para utilizar un archivo de manifiesto local, elija **Cargar** y, a continuación, elija **Cargar un archivo de manifiesto JSON**. En **Abrir**, elija un archivo y, a continuación, seleccione **Abrir**.
   + Para utilizar un archivo de manifiesto de Amazon S3, elija **URL** e introduzca la dirección URL del archivo de manifiesto. Para encontrar la dirección URL de un archivo de manifiesto preexistente en la consola de Amazon S3, desplácese hasta el archivo adecuado y elíjalo. Aparece un panel de propiedades, que incluye la URL del enlace. Puede copiar la URL y pegarla en Quick Sight.

1. Elija **Conectar**.

1. Para asegurarse de haber completado la conexión, seleccione **Editar/obtener vista previa de los datos**. De lo contrario, seleccione **Visualize** para crear un análisis utilizando los datos tal y como están. 

   Si selecciona **Editar/obtener vista previa de los datos**, puede especificar un nombre de conjunto de datos como parte de la preparación de los datos. De lo contrario, el nombre del conjunto de datos coincide con el nombre del archivo de manifiesto. 

   Para obtener más información sobre la preparación de datos, consulte [Preparación de datos en Amazon Quick Sight](preparing-data.md).

## Creación de conjuntos de datos basados en varios archivos de Amazon S3
<a name="data-sets-based-on-multiple-s3-files"></a>

Puede utilizar uno de los siguientes métodos para fusionar o combinar archivos de buckets de Amazon S3 dentro de Quick Sight:
+ **Combinar archivos utilizando un manifiesto**: en este caso, los archivos deben tener el mismo número de campos (columnas). Los tipos de datos deben coincidir entre campos en la misma posición en el archivo. Por ejemplo, el primer campo debe tener el mismo tipo de datos en cada archivo. Lo mismo sucede con el segundo campo, el tercer campo y así sucesivamente. Quick Sight toma los nombres de los campos del primer archivo.

  Los archivos deben incluirse en el manifiesto de forma explícita. No obstante, no tienen que estar dentro del mismo bucket de Amazon S3.

  Además, los archivos deben seguir las reglas que se describen en [Formatos compatibles con los archivos de manifiesto de Amazon S3](supported-manifest-file-format.md).

  Para obtener más información sobre cómo combinar archivos utilizando un manifiesto, consulte [Creación de un conjunto de datos utilizando archivos de Amazon S3](create-a-data-set-s3.md).
+ **Combinar archivos sin usar un manifiesto**: para combinar varios archivos en uno sin tener que incluirlos individualmente en el manifiesto, puede utilizar Athena. Con este método puede simplemente consultar sus archivos de texto, como si estuvieran en una tabla de una base de datos. Para obtener más información, consulte la publicación [Analyzing data in Amazon S3 using Athena](https://aws.amazon.com/blogs/big-data/analyzing-data-in-s3-using-amazon-athena/) en el blog de Big Data. 
+ **Utilizar un script para adjuntar archivos antes de importar**: puede utilizar un script diseñado para combinar los archivos antes de cargarlos. 

# Conjuntos de datos que utilizan archivos S3 en otra cuenta AWS
<a name="using-s3-files-in-another-aws-account"></a>

Utilice esta sección para obtener información sobre cómo configurar la seguridad para poder usar Quick Sight para acceder a los archivos de Amazon S3 de otra AWS cuenta. 

Para obtener acceso a los archivos de otra cuenta, el propietario de la otra cuenta primero debe configurar Amazon S3 para concederle los permisos necesarios para leer el archivo. Luego, en Quick Sight, debe configurar el acceso a los depósitos que se compartieron con usted. Una vez finalizados estos dos pasos, puede utilizar un manifiesto para crear un conjunto de datos.

**nota**  
 Para obtener acceso a los archivos de acceso público, no es necesario configurar ninguna seguridad especial. Sin embargo, sí que necesita un archivo de manifiesto.

**Topics**
+ [Configuración de Amazon S3 para permitir el acceso desde una cuenta Quick diferente](#setup-S3-to-allow-access-from-a-different-quicksight-account)
+ [Configuración de Quick Sight para acceder a los archivos de Amazon S3 de otra AWS cuenta](#setup-quicksight-to-access-S3-in-a-different-account)

## Configuración de Amazon S3 para permitir el acceso desde una cuenta Quick diferente
<a name="setup-S3-to-allow-access-from-a-different-quicksight-account"></a>

Utilice esta sección para obtener información sobre cómo configurar los permisos en los archivos de Amazon S3 para que Quick Sight pueda acceder a ellos desde otra AWS cuenta. 

Para obtener información sobre cómo acceder a los archivos de Amazon S3 de otra cuenta desde su cuenta de Quick Sight, consulte[Configuración de Quick Sight para acceder a los archivos de Amazon S3 de otra AWS cuenta](#setup-quicksight-to-access-S3-in-a-different-account). Para obtener más información sobre los permisos de S3, consulte [Administración de permisos de acceso para los recursos de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html) y [¿Cómo puedo configurar permisos en un objeto?](https://docs.aws.amazon.com/AmazonS3/latest/user-guide/set-object-permissions.html)

Puede utilizar el siguiente procedimiento para configurar este acceso desde la consola de S3. O bien, puede conceder permisos mediante AWS CLI o escribiendo un script. Si tiene que compartir una gran cantidad de archivos, puede crear una política de bucket de S3 en la acción `s3:GetObject`. Para utilizar una política de bucket, añádasela a los permisos del bucket, no a los permisos de archivo. Para obtener más información sobre las políticas de bucket, consulte [Ejemplos de política de bucket](https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html) en la *Guía para desarrolladores de Amazon S3*.

**Para configurar el acceso desde una cuenta Quick diferente desde la consola S3**

1. Obtén la dirección de correo electrónico de la AWS cuenta con la que quieres compartir. También puede obtener y utilizar el ID de usuario canónico. *Para obtener más información sobre el usuario canónico IDs, consulta los [identificadores de AWS cuenta](https://docs.aws.amazon.com/general/latest/gr/acct-identifiers.html) en la AWS Referencia general.*

1. Inicie sesión en la consola de Amazon S3 Consola de administración de AWS y ábrala en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Busque el bucket de Amazon S3 que desee compartir con Quick Sight. Elija **Permisos**.

1. Selecciona **Añadir cuenta** y, a continuación, introduce una dirección de correo electrónico o pega un seudónimo canónico para la AWS cuenta con la que quieres compartir. Esta dirección de correo electrónico debe ser la dirección principal para la cuenta de AWS . 

1. Elija **Sí** para **Leer los permisos del bucket** y **Enumerar objetos**.

   Elija **Save** para confirmar.

1. Busque el archivo que desea compartir y abra la configuración de permisos del archivo. 

1. Introduce una dirección de correo electrónico o el seudónimo canónico de la AWS cuenta con la que quieres compartir. Esta dirección de correo electrónico debe ser la principal de la AWS cuenta. 

1. Habilite los permisos de **lectura de objetos** para cada archivo al que Quick Sight necesite acceder. 

1. Notifique al usuario de Quick que los archivos ya están disponibles para su uso.

## Configuración de Quick Sight para acceder a los archivos de Amazon S3 de otra AWS cuenta
<a name="setup-quicksight-to-access-S3-in-a-different-account"></a>

Utilice esta sección para obtener información sobre cómo configurar Quick Sight para poder acceder a los archivos de Amazon S3 de otra AWS cuenta. Para obtener información sobre cómo permitir que otra persona acceda a sus archivos de Amazon S3 desde su cuenta Quick, consulte[Configuración de Amazon S3 para permitir el acceso desde una cuenta Quick diferente](#setup-S3-to-allow-access-from-a-different-quicksight-account).

Utilice el siguiente procedimiento para acceder a los archivos de Amazon S3 de otra cuenta desde Quick Sight. Para poder utilizar este procedimiento, los usuarios de la otra cuenta de AWS deben compartir los archivos de su bucket de Amazon S3 con usted.

**Para acceder a los archivos de Amazon S3 de otra cuenta desde Quick Sight**

1. Compruebe que el usuario o los usuarios de la otra AWS cuenta hayan otorgado a su cuenta permiso de lectura y escritura para el bucket de S3 en cuestión. 

1. Elija el icono de su perfil y, a continuación, seleccione **Administrar Quick Sight**.

1. Elija **Seguridad y permisos**.

1. En **Acceso rápido a los AWS servicios**, selecciona **Administrar**.

1. Elija **Seleccionar buckets de S3**.

1. En la pantalla **Seleccionar buckets de Amazon S3**, elija la pestaña **Buckets de S3 a los que puede acceder en AWS**.

   La pestaña predeterminada se llama **S3 buckets y está vinculada a la cuenta de Quick Sight**. Muestra todos los cubos a los que tiene acceso tu cuenta de Quick. 

1. Realice una de las siguientes acciones:
   + Para añadir todos los buckets que tiene permiso para utilizar, elija **Elegir buckets a los que se puede acceder desde otras cuentas de AWS **. 
   + Si tiene uno o más buckets de Amazon S3 que desee añadir, introduzca sus nombres. Cada uno debe coincidir exactamente con el nombre único del bucket de Amazon S3.

     Si no dispone de los permisos adecuados, verá el mensaje de error “We can't connect to this S3 bucket. Asegúrese de que todos los depósitos de S3 que especifique estén asociados a la AWS cuenta utilizada para crear esta cuenta Quick». Este mensaje de error aparece si no tienes permisos de cuenta ni permisos de Quick Sight.
**nota**  
Para usar Amazon Athena, Quick Sight debe acceder a los buckets de Amazon S3 que utiliza Athena.   
Puede añadirlos aquí uno por uno o utilizar la **opción Elegir depósitos accesibles desde** otras cuentas. AWS 

1. Elija **Select buckets** para confirmar la opción elegida. 

1. Cree un conjunto de datos nuevo basado en Amazon S3 y cargue el archivo de manifiesto. Para obtener más información sobre los conjuntos de datos de Amazon S3, consulte [Creación de un conjunto de datos utilizando archivos de Amazon S3](create-a-data-set-s3.md).

# Creación de un origen de datos con Apache Spark
<a name="create-a-data-source-spark"></a>

Puedes conectarte directamente a Apache Spark mediante Quick Sight, o puedes conectarte a Spark a través de Spark SQL. Con los resultados de las consultas o los enlaces directos a tablas o vistas, puede crear fuentes de datos en Quick Sight. Puede consultar sus datos directamente a través de Spark, o bien importar los resultados de la consulta en [SPICE](spice.md).

Antes de usar Quick Sight con los productos Spark, debes configurar Spark para Quick Sight. 

Quick Sight requiere que tu servidor Spark esté protegido y autenticado mediante LDAP, que está disponible en la versión 2.0 o posterior de Spark. Si Spark está configurado para permitir el acceso no autenticado, Quick Sight rechaza la conexión al servidor. Para usar Quick Sight como cliente de Spark, debes configurar la autenticación LDAP para que funcione con Spark. 

La documentación de Spark contiene información sobre cómo realizar esta configuración. Para comenzar, tiene que configurarlo para habilitar la autenticación LDAP front-end a través de HTTPS. Para obtener información general acerca de Spark, consulte [el sitio web de Apache Spark](http://spark.apache.org/). Para obtener información específica sobre Spark y la seguridad, consulte la [documentación de seguridad de Spark](http://spark.apache.org/docs/latest/security.html). 

Para asegurarte de que has configurado tu servidor para el acceso a Quick Sight, sigue las instrucciones que se indican en. [Requisitos de configuración de la red y de la base de datos](configure-access.md)

# Uso de Databricks en Quick Sight
<a name="quicksight-databricks"></a>

Utilice esta sección para aprender cómo conectarse de Quick Sight a Databricks. 

**Conexión a Databricks**

1. Comience por crear un nuevo conjunto de datos. Selecciona **Datos** en el panel de navegación de la izquierda.

1. Elija **Crear** y, a continuación, **Nuevo conjunto de datos**.

1. Elija la tarjeta de origen de datos de **Databricks**.

1. En **Nombre del origen de datos**, introduzca un nombre descriptivo para su conexión al origen de datos de Databricks, por ejemplo, `Databricks CS`. Como puede crear muchos conjuntos de datos a partir de una conexión a Databricks, es mejor que el nombre sea sencillo.

1. En **Tipo de conexión**, seleccione el tipo de red que utiliza. 
   + **Red pública**: si sus datos se comparten públicamente.
   + **VPC**: si sus datos están dentro de una VPC. 
**nota**  
Si utiliza una VPC y no la ve en la lista, póngase en contacto con su administrador. 

1.  En **Servidor de bases de datos**, introduzca el **Nombre de host o del espacio de trabajo** especificado en los detalles de conexión de Databricks.

1.  En **Ruta HTTP**, introduzca la **URL parcial de la instancia de Spark** especificada en los detalles de su conexión a Databricks.

1.  En **Puerto**, introduzca el **puerto** especificado en los detalles de conexión de Databricks.

1.  En **Nombre de usuario** y **Contraseña**, introduzca sus credenciales de conexión.

1.  Para comprobar que la conexión funciona, haga clic en **Validar conexión**.

1.  Para terminar y crear el origen de datos, haga clic en **Crear origen de datos**.

## Agregar un nuevo conjunto de datos de Quick Sight para Databricks
<a name="quicksight-databricks-create-dataset"></a>

Una vez que tenga una conexión de origen de datos existente para los datos de Databricks, podrá crear conjuntos de datos de Databricks para usarlo en el análisis. 

**Creación de un conjunto de datos con Databricks**

1. Elija **Datos** a la izquierda y, a continuación, desplácese hacia abajo para buscar la tarjeta fuente de datos para su conexión a Databricks. Si tiene muchos orígenes de datos, puede utilizar la barra de búsqueda situada en la parte superior de la página para buscar el origen de datos cuyo nombre coincida parcialmente.

1. Elija la tarjeta de origen de datos de **Databricks** y, a continuación, elija **Crear conjunto de datos**.

1. Para especificar la tabla a la que desea conectarse, primero seleccione el catálogo y el esquema que desee usar. Una vez hecho esto, en **Tablas**, seleccione la tabla que desea usar. Si prefiere usar su propia instrucción SQL, seleccione **Usar consulta SQL personalizada**. 

1. Elija **Editar/obtener vista previa**.

1. (Opcional) Para agregar más datos, siga los siguientes pasos: 

   1. Seleccione **Añadir datos** en la parte superior derecha.

   1. Para conectarse a datos diferentes, seleccione **Cambiar origen de datos** y elija un conjunto de datos diferente. 

   1. Siga las instrucciones de la interfaz de usuario para terminar de añadir datos. 

   1. Tras añadir nuevos datos al mismo conjunto de datos, seleccione **Configurar esta unión **(los dos puntos rojos). Configure una unión para cada tabla adicional. 

   1. Si desea añadir campos calculados, seleccione **Añadir campo calculado**. 

   1. Para añadir un modelo de SageMaker IA, selecciona **Aumentar** con. SageMaker Esta opción solo está disponible en la edición Quick Enterprise.

   1. Desactive la casilla de los campos que desea omitir.

   1. Actualice los tipos de datos que desee cambiar.

1. Cuando haya terminado, elija **Guardar** para guardar y cerrar el conjunto de datos. 

## Guía del administrador de Quick Sight para conectar Databricks
<a name="quicksight-databricks-administration-setup"></a>

Puedes usar Amazon Quick Sight para conectarte a Databricks on. AWS Puedes conectarte a Databricks AWS tanto si te has registrado a través de AWS Marketplace como a través del sitio web de Databricks. 

Antes de poder conectarse a Databricks, debe crear o identificar los recursos existentes que requiere la conexión. Usa esta sección para ayudarte a reunir los recursos que necesitas para conectarte de Quick Sight a Databricks.
+ Para obtener información sobre cómo obtener los detalles de su conexión de Databricks, consulte [Conexiones de ODBC y de JDBC de Databricks](https://docs.databricks.com/integrations/jdbc-odbc-bi.html#get-server-hostname-port-http-path-and-jdbc-url). 
+ Para obtener información sobre cómo obtener sus credenciales de Databricks (token de acceso personal o nombre de usuario y contraseña) para la autenticación, consulte los [requisitos de autenticación](https://docs.databricks.com/integrations/bi/jdbc-odbc-bi.html#authentication-requirements) en la [documentación de Databricks](https://docs.databricks.com/index.html). 

  Para conectarse a un clúster de Databricks, necesita los permisos `Can Attach To` y `Can Restart`. Estos permisos se administran en Databricks. Para obtener más información, consulte [Requisitos de permisos](https://docs.databricks.com/integrations/jdbc-odbc-bi.html#permission-requirements) en la [documentación de Databricks](https://docs.databricks.com/index.html).
+ Si está configurando una conexión privada para Databricks, puede obtener más información sobre cómo configurar una VPC para usarla con Quick Sight; consulte Conexión [a una VPC con Amazon Quick Sight en la documentación de Quick](https://docs.aws.amazon.com/quicksight/latest/user/working-with-aws-vpc.html) Sight. Si la conexión no está visible, compruebe con un administrador del sistema que la red tenga [puntos de conexión de entrada abiertos para Amazon Route 53](https://docs.aws.amazon.com/quicksight/latest/user/vpc-route-53.html). El nombre de host de un espacio de trabajo de Databricks utiliza una IP pública, es necesario que existan reglas de entrada y salida de TCP y UDP de DNS para permitir el tráfico en el puerto DNS 53, para el grupo de seguridad de Route 53. Un administrador debe crear un grupo de seguridad con dos reglas de entrada: una para el DNS (TCP) en el puerto 53 del CIDR de la VPC y otra para el DNS (UDP) para el puerto 53 del CIDR de la VPC. 

  [https://docs.databricks.com/administration-guide/cloud-configurations/aws/privatelink.html](https://docs.databricks.com/administration-guide/cloud-configurations/aws/privatelink.html) 

# Creación de un conjunto de datos mediante Google BigQuery
<a name="quicksight-google-big-query"></a>

**nota**  
Cuando Quick Sight usa y transfiere la información que recibeGoogle APIs, cumple con la [Política de datos de usuario de los servicios de Google API](https://developers.google.com/terms/api-services-user-data-policy).

Google BigQuery es un almacenamiento de datos sin servidor totalmente administrado que los clientes usan para administrar y analizar sus datos. Los clientes de Google BigQuery usan SQL para consultar sus datos sin necesidad de administrar la infraestructura.

## Creación de una conexión a un origen de datos con Google BigQuery
<a name="quicksight-google-big-query-connect"></a>

**Requisitos previos**

Antes de comenzar, asegúrese de que dispone de lo siguiente. Todos estos elementos son necesarios para crear una conexión de origen de datos con Google BigQuery:
+ **ID del proyecto**: ID del proyecto que está asociado a su cuenta de Google. Para encontrarlo, vaya a la Google Cloud consola y elija el nombre del proyecto que quiere conectar a Quick Sight. Copie el identificador del proyecto que aparece en la nueva ventana y grábelo para usarlo más adelante.
+ **Región del conjunto de datos**: región de Google en la que existe el proyecto de Google BigQuery. Para encontrar la región del conjunto de datos, vaya a la consola de Google BigQuery y elija **Explorer**. Busque y amplíe el proyecto al que desea conectarse y, a continuación, elija el conjunto de datos que desee usar. La región del conjunto de datos aparecerá en la ventana emergente que se abrirá.
+ **Credenciales de inicio de sesión de la cuenta de Google**: credenciales de inicio de sesión de su cuenta de Google. Si no dispone de esta información, póngase en contacto con el administrador de la cuenta de Google.
+ **Google BigQueryPermisos**: para conectar tu Google cuenta con Quick Sight, asegúrate de que tu Google cuenta tenga los siguientes permisos:
  + `BigQuery Job User` en el nivel `Project`.
  + `BigQuery Data Viewer` en el nivel `Dataset` o `Table`.
  + `BigQuery Metadata Viewer` en el nivel `Project`.

Para obtener información sobre cómo recuperar la información previa previa, consulte Aproveche [el potencial de la inteligencia empresarial unificada con Google Cloud BigQuery Quick Sight](https://aws.amazon.com/blogs/business-intelligence/unlock-the-power-of-unified-business-intelligence-with-google-cloud-bigquery-and-amazon-quicksight/).

Utilice el siguiente procedimiento para conectar su cuenta Quick con su fuente Google BigQuery de datos.

**Para crear una nueva conexión a una fuente de Google BigQuery datos desde Quick Sight**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. En el panel de navegación izquierdo, selecciona **Datos**.

1. Elija **Crear** y, a continuación, elija **Nuevo conjunto de datos**

1. Elija el mosaico **Google BigQuery**.

1. Agregue los detalles del origen de datos que registró anteriormente en la sección de requisitos previos:
   + **Nombre del origen de datos**: nombre para el origen de datos.
   + **ID de proyecto**: ID de proyecto de Google Platform. Este campo distingue entre mayúsculas y minúsculas.
   + **Región del conjunto de datos**: región del conjunto de datos de la plataforma en la nube de Google del proyecto al que desea conectarse.

1. Seleccione **Iniciar sesión**.

1. En la nueva ventana que se abrirá, especifique las credenciales de inicio de sesión de la cuenta de Google a la que desea conectarse.

1. Elija **Continuar** para conceder acceso a Quick Sight aGoogle BigQuery.

1. Tras crear la nueva conexión al origen de datos, continúe con [Step 4](#gbq-step-4) en el siguiente procedimiento.

## Agregar un nuevo conjunto de datos de Quick Sight para Google BigQuery
<a name="quicksight-google-big-query-create"></a>

Tras crear una conexión de origen de datos con Google BigQuery, podrá crear conjuntos de datos de Google BigQuery para su análisis. Los conjuntos de datos que usan Google BigQuery solo se pueden almacenar en SPICE.

**Creación de un conjunto de datos mediante Google BigQuery**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. En la página de inicio, selecciona **Datos**.

1. Seleccione **Crear** y, a continuación, **Nuevo conjunto de datos**

1. Elija el **Google BigQuery**mosaico y, a continuación, elija **Crear conjunto de datos**.

1. <a name="gbq-step-4"></a>En **Tablas**, realice una de las acciones siguientes:
   + Elija la tabla que desea usar.
   + Elija **Usar consulta SQL personalizada** para usar su propia instrucción SQL. Para obtener más información sobre el uso de SQL personalizado en Quick Sight, consulte[Uso de SQL para personalizar los datos](adding-a-SQL-query.md).

1. Elija **Editar/obtener vista previa**.

1. (Opcional) En la página de **preparación de datos** que se abrirá, puede agregar personalizaciones a los datos con campos calculados, filtros y uniones.

1. Cuando haya terminado de hacer los cambios, elija **Guardar** para guardar y cerrar el conjunto de datos.

# Creación de un conjunto de datos con un origen de datos de Hojas de cálculo de Google
<a name="create-a-dataset-google-sheets"></a>

Hojas de cálculo de Google es una aplicación de hojas de cálculo basada en web que permite a los usuarios crear, editar y colaborar en datos en tiempo real. Con su amplio conjunto de funciones y fórmulas, sirve como un poderoso origen de datos para la inteligencia empresarial y el análisis. Los usuarios pueden organizar, analizar y compartir información de manera eficiente, mientras que sus características de colaboración fluidas la convierten en una plataforma ideal para equipos que trabajan en proyectos basados en datos.

## Configuración de administración en Amazon Quick
<a name="google-sheets-admin-config"></a>

Los administradores de Amazon Quick deben realizar una configuración única para habilitar Google Sheets como fuente de datos. Para obtener instrucciones detalladas y consideraciones importantes, consulte [el blog](https://aws.amazon.com//blogs/business-intelligence/transform-your-google-sheets-data-into-powerful-analytics-with-amazon-quicksight/).

## Creación de un conjunto de datos con un origen de datos de Hojas de cálculo de Google
<a name="google-sheets-create-dataset"></a>

Siga este procedimiento para crear un conjunto de datos con un origen de datos de Hojas de cálculo de Google.

**Cómo crear un conjunto de datos con un origen de datos de Hojas de cálculo de Google**

1. En la página de inicio rápido, selecciona **Conjuntos de datos.**

1. En la página **Conjuntos de datos**, elija **Nuevo conjunto de datos**.

1. Elige **Google Sheets.**

1. Ingrese un nombre para el origen de datos y, a continuación, elija **Conectar**.

1. Cuando se le redirija a la página de inicio de sesión de Google, haga lo siguiente:

   1. Ingrese las credenciales de su cuenta de Google y, a continuación, elija **Siguiente**.

   1. Revisa los permisos para autorizar que tu AWS cuenta se conecte con Google Sheets y, a continuación, selecciona **Continuar**.

1. En el menú **Elija su tabla**, busque los datos. El menú muestra todas las carpetas, subcarpetas, hojas y pestañas de la cuenta de Google. Para mostrar las pestañas, seleccione una hoja de la lista que aparece.

1. Seleccione la pestaña con la que desee trabajar.

1. Elija **Editar/obtener vista previa de los datos** para ir a la página de preparación de los datos. Elija **Agregar datos** para incluir cualquier pestaña adicional.

1. Configura la unión y, a continuación, selecciona **Publicar y visualizar** para analizar los datos de Google Sheets con Quick Sight.

**nota**  
Este conector solo es compatible con la funcionalidad de SPICE.
Si tu OAuth token caduca (visible en el informe de errores de ingesta o al crear un nuevo conjunto de datos), vuelve a autorizarlo seleccionando **Editar** en la fuente de datos y actualizándolo.

# Creación de un conjunto de datos con un origen de datos de Apache Impala
<a name="create-a-dataset-impala"></a>

Apache Impala es un motor de consultas SQL de procesamiento masivo en paralelo (MPP) de alto rendimiento diseñado para ejecutarse de forma nativa en Apache Hadoop. Utilice el siguiente procedimiento para establecer una conexión segura entre Quick Sight y Apache Impala.

Todo el tráfico entre Quick Sight y Apache Impala se cifra mediante SSL. Quick Sight admite la autenticación estándar de nombre de usuario y contraseña para las conexiones de Impala.

Para establecer una conexión, tendrás que configurar los ajustes de SSL en tu instancia de Impala, preparar tus credenciales de autenticación, configurar la conexión en Quick Sight con los detalles del servidor de Impala y validar la conexión para garantizar un acceso seguro a los datos.

**Cómo crear un conjunto de datos con un origen de datos de Apache Impala**

1. **En la página de inicio rápido, selecciona Datos.**

1. En la página **de datos**, elija **Crear**.

1. Elija **Origen de datos**.

1. Selecciona **Impala** y, a continuación, **Siguiente**.

1. Escriba un nombre para el origen de datos.

1. Para conexiones públicas:

   1. Ingrese los detalles de la conexión para **Servidor de base de datos**, **Ruta HTTP**, **Puerto**, **Nombre de usuario** y **Contraseña**.

   1. Una vez que la validación se haya completado correctamente, elija **Crear origen de datos**.

1. Para conexiones privadas:

   1. Contacte con su administrador para configurar una conexión de VPC antes de ingresar los detalles de la conexión.

     Usted o su administrador pueden [configurar la conexión de VPC en](vpc-creating-a-connection-in-quicksight.md) Quick. SSL está activado por defecto para garantizar que la transmisión de datos sea segura. Si se producen errores de validación de conexión, compruebe los detalles de la conexión y de la VPC.

     Si los problemas persisten, consulte a su administrador para confirmar que su autoridad de certificación esté incluida en la [lista de certificados aprobados](configure-access.md#ca-certificates) de Quick Sight.

1. En el menú **Elija su tabla**, puede hacer lo siguiente:

   1. Elija un esquema o una tabla específicos y, a continuación, **Seleccionar**.

   1. Elija **Usar consulta SQL personalizada** para escribir su propia consulta SQL.

1. Después de completar la selección, se le redirigirá a la página de preparación de los datos. Realice los ajustes que desee en sus datos y, a continuación, seleccione **Publicar y visualizar** para analizar los datos de Impala en Quick Sight.

**nota**  
Este conector admite lo siguiente:  
Autenticación de nombre de usuario y contraseña
Conexiones públicas y privadas
Detección de tablas y consultas SQL personalizadas
Actualización completa de los datos durante la ingesta
Almacenamiento solo de SPICE

# Creación de un conjunto de datos utilizando un archivo de Microsoft Excel
<a name="create-a-data-set-excel"></a>

Para crear un conjunto de datos a través de un origen de datos de archivo de Microsoft Excel, cargue un archivo .xlsx de una unidad local o de red. Los datos se importan en [SPICE](spice.md).

 Para obtener más información sobre la creación de nuevos conjuntos de datos de Amazon S3 utilizando orígenes de datos de Amazon S3, consulte [Creación de un conjunto de datos utilizando un origen de datos de Amazon S3 existente](create-a-data-set-existing.md#create-a-data-set-existing-s3) o [Creación de un conjunto de datos utilizando archivos de Amazon S3](create-a-data-set-s3.md). 

**Creación de un conjunto de datos basado en un archivo de Excel**

1. Consulte [Cuotas de origen de datos](data-source-limits.md) para asegurarse de que su archivo de destino no supere las cuotas de origen de datos.

1. En la página de inicio rápido, elija **Datos**.

1. En la página de **datos**, elija **Crear** y, a continuación, **Nuevo conjunto de datos**.

1. Elija **Cargar un archivo**.

1. En el cuadro de diálogo **Abrir**, elija un archivo y, a continuación, seleccione **Abrir**.

   Un archivo debe tener 1 GB o menos para poder cargarse en Quick Sight.

1. Si el archivo de Excel contiene varias hojas, elija la hoja que va a importar. Puede cambiarla posteriormente preparando los datos. 

1. 
**nota**  
En las siguientes pantallas, dispone de varias oportunidades para preparar los datos. Cada una de estas le lleva a la pantalla **Prepare Data**. Esta pantalla es la misma donde puede acceder a la importación de datos después de que se haya completado. Permite cambiar la configuración de carga incluso después de finalizar la carga.

    Elija **Select** para confirmar la configuración. O bien, puede elegir **Editar/obtener vista previa de los datos** para preparar los datos de forma inmediata.

   La vista previa de los datos aparece en la siguiente pantalla. No puede realizar cambios directamente en la vista previa de datos. 

1. Si los encabezados de los datos y el contenido no aparecen de forma correcta, elija **Edite la configuración y prepare los datos** para corregir la configuración de carga de archivos. 

   En caso contrario, elija **Siguiente**.

1. En la pantalla **Detalles del origen de datos**, puede elegir **Editar/obtener vista previa de los datos**. Puede especificar un conjunto de datos en la pantalla **Preparar datos**. 

   Si no necesita preparar los datos, puede optar por crear un análisis utilizando los datos tal y como están. Elija **Visualize**. Si se hace esto, al conjunto de datos se le asigna el nombre del archivo de origen, y se abre la pantalla **Análisis**. Para obtener más información acerca de la preparación de los datos y la configuración de carga de Excel, consulte [Preparación de datos en Amazon Quick Sight](preparing-data.md).

**nota**  
Si en algún momento desea realizar cambios en el archivo, como agregar un campo nuevo, debe realizar el cambio en Microsoft Excel y crear un nuevo conjunto de datos con la versión actualizada de Quick Sight. Para obtener más información acerca de las posibles implicaciones de cambiar los conjuntos de datos, consulte [Aspectos que se deben tener en cuenta al editar conjuntos de datos](edit-a-data-set.md#change-a-data-set).

# Creación de un origen de datos con Presto
<a name="create-a-data-source-presto"></a>

Presto (o PrestoDB) es un motor de consultas SQL distribuidas de código abierto, diseñado para realizar consultas de análisis rápidas en datos de cualquier tamaño. Admite orígenes de datos no relacionales y relacionales. Las fuentes de datos no relacionales compatibles incluyen el Sistema de archivos distribuido de Hadoop (HDFS), Amazon S3, Cassandra, MongoDB y. HBase Los orígenes de datos relacionales admitidos son MySQL, PostgreSQL, Amazon Redshift, Microsoft SQL Server y Teradata. 

Para obtener más información acerca de Presto, consulte lo siguiente:
+ [Introducción a Presto, una descripción de Presto](https://aws.amazon.com/big-data/what-is-presto/) en el sitio web. AWS 
+ [Creación de un clúster presto con Amazon Elastic MapReduce (EMR](https://docs.aws.amazon.com/emr/latest/ReleaseGuide/emr-presto.html)) en la guía de versiones de *Amazon EMR.*
+ Para obtener información general sobre Presto, consulte la [documentación de Presto](https://trino.io/docs/current/).

Los resultados de las consultas que ejecuta a través del motor de consultas de Presto se pueden convertir en conjuntos de datos de Quick Sight. Presto procesa las consultas analíticas en las bases de datos backend. A continuación, devuelve los resultados al cliente Quick Sight. Puede consultar sus datos directamente a través de Presto o puede importar los resultados de la consulta en SPICE. 

Antes de utilizar Quick Sight como cliente de Presto para ejecutar consultas, asegúrese de configurar los perfiles de las fuentes de datos. Necesita un perfil de fuente de datos en Quick Sight para cada fuente de datos de Presto a la que desee acceder. Utilice el siguiente procedimiento para crear una conexión a Presto.

**Para crear una nueva conexión a una fuente de datos presto desde Amazon Quick Sight (consola)**

1. En la página de inicio de Amazon Quick Sight, selecciona **Datos** a la izquierda.

1. Seleccione **Crear** y, a continuación, **Nuevo conjunto de datos**. 

1. Elija el icono de **Presto**. 
**nota**  
En la mayoría de los navegadores, puede usar Ctrl-F o Cmd-F para abrir un cuadro de búsqueda y escribir **presto** para localizarlo. 

1. Agregue la configuración del nuevo origen de datos:
   + ****Nombre del origen de datos****: introduzca un nombre descriptivo para su conexión al origen de datos. Este nombre aparece en la sección **Orígenes de datos existentes** en la parte inferior de la pantalla **Conjuntos de datos**. 
   + ****Tipo de conexión****: elija el tipo de conexión que necesita usar para conectarse a Presto. 

     Para conectarse a través de la red pública, elija **Red pública**. 

     Si utiliza una red pública, el servidor Presto debe estar protegido y autenticado mediante el protocolo ligero de acceso a directorios (LDAP). Para obtener información sobre cómo configurar Presto para usar LDAP, consulte [LDAP authentication](https://trino.io/docs/current/security/ldap.html) en la documentación de Presto. 

     Para conectarse a través de una conexión privada virtual, elija el nombre de VPC apropiado en la lista **Conexiones VPC**. 

     Si su servidor Presto permite el acceso no autenticado, AWS requiere que se conecte a él de forma segura mediante una conexión de VPC privada. Para obtener información sobre la configuración de una VPC nueva, consulte [Configuración de conexiones de VPC en Amazon Quick Sight](working-with-aws-vpc.md).
   + ****Servidor de base de datos****: nombre del servidor de base de datos. 
   + ****Puerto****: el puerto que utiliza el servidor para aceptar las conexiones entrantes de Amazon Quick Sight 
   + ****Catálogo****: el nombre del catálogo que desea usar. 
   + ****Se necesita autenticación****: (opcional) esta opción solo aparece si elige un tipo de conexión de VPC. Si el origen de datos de Presto al que se está conectando no requiere autenticación, seleccione **No**. De lo contrario, mantenga la configuración predeterminada (**Sí**). 
   + ****Nombre de usuario****: introduzca un nombre de usuario para conectarse a Presto. Quick Sight aplica el mismo nombre de usuario y contraseña a todas las conexiones que utilizan este perfil de fuente de datos. Si desea supervisar Quick Sight por separado de otras cuentas, cree una cuenta de Presto para cada perfil de fuente de datos de Quick Sight. 

     La cuenta de Presto que utiliza necesita poder acceder a la base de datos y ejecutar instrucciones `SELECT` en al menos una tabla. 
   + ****Contraseña****: la contraseña que se debe usar con el nombre de usuario de Presto. Amazon Quick Sight cifra todas las credenciales que utilice en el perfil de la fuente de datos. Para obtener más información, consulte [Cifrado de datos en Amazon Quick](data-encryption.md). 
   + ****Habilitar SSL****: SSL está activado de forma predeterminada. 

1. Elija **Validar conexión** para probar la configuración.

1. Después de validar la configuración, elija **Crear origen de datos** para completar la conexión.

# Uso de Snowflake con Amazon Quick Sight
<a name="connecting-to-snowflake"></a>

Snowflake es una plataforma de nube de datos de IA que ofrece soluciones de datos que van desde el almacenamiento y la colaboración de datos hasta la ciencia de datos y la IA generativa. Snowflake es un [AWS socio](https://partners.amazonaws.com/partners/001E000000d8qQcIAI/Snowflake) con múltiples AWS acreditaciones, entre las que se incluyen las competencias de AWS ISV en IA generativa, Machine Learning, Data and Analytics y Retail.

Amazon Quick Sight ofrece dos formas de conectarse a Snowflake: con sus credenciales de inicio de sesión de Snowflake o con las credenciales de cliente. OAuth Utilice las siguientes secciones para obtener información sobre cada uno de estos métodos.

**Topics**
+ [Creación de una conexión de fuente de datos de Quick Sight a Snowflake con credenciales de inicio de sesión](#create-connection-to-snowflake)
+ [Crear una conexión de fuente de datos de Quick Sight a Snowflake con credenciales de cliente OAuth](#create-connection-to-snowflake-oauth-credentials)

## Creación de una conexión de fuente de datos de Quick Sight a Snowflake con credenciales de inicio de sesión
<a name="create-connection-to-snowflake"></a>

 Utilice esta sección para aprender a crear una conexión entre Quick Sight y Snowflake con sus credenciales de inicio de sesión de Snowflake. Todo el tráfico entre Quick Sight y Snowflake se habilita mediante SSL.

**Para crear una conexión entre Quick Sight y Snowflake**

1. Abre la consola [rápida](https://quicksight.aws.amazon.com/).

1. En el panel de navegación izquierdo, elija **Datos**, luego elija **Crear** y, por último, elija **Nuevo conjunto de datos**.

1. Elija la tarjeta de origen de datos de **Snowflake**.

1. En la ventana emergente que aparece, ingrese la siguiente información:

   1. En **Nombre del origen de datos**, ingrese un nombre descriptivo para la conexión del origen de datos de Snowflake. Como puede crear muchos conjuntos de datos a partir de una conexión a Snowflake, es mejor que el nombre sea sencillo.

   1. En **Tipo de conexión**, elija el tipo de red que utiliza. Elija **Red pública** si sus datos se comparten públicamente. Elija **VPC** si sus datos se encuentran dentro de una VPC. Para configurar una conexión de VPC en Quick Sight, consulte. [Administrar la conexión de VPC en Amazon Quick](vpc-creating-a-connection-in-quicksight.md)

   1. En **Servidor de bases de datos**, ingrese el nombre de host especificado en los detalles de conexión de Snowflake.

1. En **Nombre de la base de datos y del almacén**, ingrese los respectivos nombres del almacén y la base de datos de Snowflake que desea conectar.

1. En **Nombre de usuario** y **Contraseña**, ingrese sus credenciales de Snowflake.

Una vez que haya creado correctamente una conexión de fuente de datos entre sus cuentas de Quick Sight y Snowflake, puede empezar a [Creación de conjuntos de datos](creating-data-sets.md) contener datos de Snowflake.

## Crear una conexión de fuente de datos de Quick Sight a Snowflake con credenciales de cliente OAuth
<a name="create-connection-to-snowflake-oauth-credentials"></a>

[Puede usar las credenciales de OAuth cliente para conectar su cuenta de Quick Sight con Snowflake a través de Quick Sight. APIs](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html) *OAuth*es un protocolo de autorización estándar que se utiliza a menudo para aplicaciones que tienen requisitos de seguridad avanzados. Cuando se conecta a Snowflake con credenciales de OAuth cliente, puede crear conjuntos de datos que contengan datos de Snowflake con Quick Sight APIs y en la interfaz de usuario de Quick Sight. Para obtener más información sobre cómo configurar OAuth en Snowflake, consulte [Snowflake OAuth overview](https://docs.snowflake.com/en/user-guide/oauth-snowflake-overview).

Quick Sight admite el tipo de subvención. `client credentials` OAuth OAuthlas credenciales del cliente se utilizan para obtener un token de acceso para machine-to-machine la comunicación. Este método es adecuado para situaciones en las que un cliente necesita acceder a los recursos que están alojados en un servidor sin la participación de un usuario.

En el flujo de credenciales de cliente de OAuth 2.0, hay varios mecanismos de autenticación de clientes que se pueden utilizar para autenticar la aplicación cliente con el servidor de autorización. Quick Sight admite las credenciales de cliente basadas en OAuth Snowflake para los dos mecanismos siguientes:
+ **Token (OAuth basado en secretos del cliente)**: el mecanismo de autenticación del cliente basado en secretos se utiliza con las credenciales de cliente para conceder el flujo a fin de autenticarse con el servidor de autorización. Este esquema de autenticación requiere que el `client_id` y el `client_secret` de la aplicación de cliente de OAuth se almacenen en Secrets Manager.
+ **X509 (OAuth basado en JWT de clave privada del cliente)**: la solución basada en claves del certificado X509 proporciona una capa de seguridad adicional al mecanismo de OAuth con certificados de cliente que se utilizan para autenticar en lugar de secretos de cliente. Este método lo suelen utilizar los clientes privados para autenticarse en el servidor de autorización con una fuerte confianza entre los dos servicios.

Quick Sight ha validado OAuth las conexiones con los siguientes proveedores de identidad:
+ OKTA
+ PingFederate

### Almacenamiento de credenciales de OAuth en Secrets Manager
<a name="create-connection-to-snowflake-oauth-store-credentials"></a>

OAuth las credenciales de los clientes están pensadas para casos de machine-to-machine uso y no están diseñadas para ser interactivas. Para crear una conexión de origen de datos entre Quick Sight y Snowflake, cree un nuevo secreto en Secrets Manager que contenga sus credenciales para la aplicación cliente. OAuth El ARN secreto que se crea con el nuevo secreto se puede usar para crear conjuntos de datos que contengan datos de Snowflake en Quick Sight. Para obtener más información sobre el uso de las claves de Secrets Manager en Quick Sight, consulte[Uso de AWS Secrets Manager secretos en lugar de credenciales de bases de datos en Quick](secrets-manager-integration.md).

Las credenciales que debe almacenar en Secrets Manager vienen determinadas por el mecanismo de OAuth que utilice. Los siguientes key/value pares son necesarios para los secretos basados en el X509OAuth:
+ `username`: el nombre de usuario de la cuenta de Snowflake que se utilizará al conectarse a Snowflake
+ `client_id`: el ID de cliente de OAuth
+ `client_private_key`: la clave privada del cliente de OAuth
+ `client_public_key`: la clave pública del certificado del cliente de OAuth y su algoritmo cifrado (por ejemplo, `{"alg": "RS256", "kid", "cert_kid"}`)

Los siguientes key/value pares son necesarios para los secretos basados en fichas: OAuth
+ `username`: el nombre de usuario de la cuenta de Snowflake que se utilizará al conectarse a Snowflake
+ `client_id`: el ID de cliente de OAuth
+ `client_secret`: el secreto del cliente de OAuth

### Crear una OAuth conexión con Snowflake con Quick Sight APIs
<a name="create-connection-to-snowflake-oauth-example"></a>

Una vez que haya creado un secreto en Secrets Manager que contenga sus OAuth credenciales de Snowflake y haya conectado su cuenta Quick a Secrets Manager, podrá establecer una conexión de origen de datos entre Quick Sight y Snowflake con Quick Sight y el SDK. APIs En el siguiente ejemplo, se crea una conexión a una fuente de datos de Snowflake con credenciales de cliente simbólicas. OAuth

```
{
    "AwsAccountId": "AWSACCOUNTID",
    "DataSourceId": "UNIQUEDATASOURCEID",
    "Name": "NAME",
    "Type": "SNOWFLAKE",
    "DataSourceParameters": {
        "SnowflakeParameters": {
            "Host": "HOSTNAME",
            "Database": "DATABASENAME",
            "Warehouse": "WAREHOUSENAME",
            "AuthenticationType": "TOKEN",
            "DatabaseAccessControlRole": "snowflake-db-access-role-name",
            "OAuthParameters": {
              "TokenProviderUrl": "oauth-access-token-endpoint", 
              "OAuthScope": "oauth-scope",
              "IdentityProviderResourceUri" : "resource-uri",
              "IdentityProviderVpcConnectionProperties" : {
                "VpcConnectionArn": "IdP-VPC-connection-ARN" 
             }
        }
    },
    "VpcConnectionProperties": {
        "VpcConnectionArn": "VPC-connection-ARN-for-Snowflake"
    }
    "Credentials": {
        "SecretArn": "oauth-client-secret-ARN"
    }
}
```

Para obtener más información sobre el funcionamiento de la CreateDatasource API, consulte. [CreateDataSource](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html)

Una vez que se haya establecido la conexión entre Quick Sight y Snowflake y se haya creado una fuente de datos con Quick Sight APIs o el SDK, la nueva fuente de datos se mostrará en Quick Sight. Los autores de Quick Sight pueden usar esta fuente de datos para crear conjuntos de datos que contengan datos de Snowflake. Las tablas se muestran en función del rol utilizado en el parámetro `DatabaseAccessControlRole` que se transfiere en una llamada a la API `CreateDataSource`. Si este parámetro no está definido al crear la conexión al origen de datos, se utiliza el rol predeterminado de Snowflake.

Una vez que haya creado correctamente una conexión de fuente de datos entre sus cuentas de Quick Sight y Snowflake, puede empezar a [Creación de conjuntos de datos](creating-data-sets.md) contener datos de Snowflake.

# Uso de Starburst con Amazon Quick Sight
<a name="connecting-to-starburst"></a>

Starburst es un servicio de análisis de lago de datos con todas las características creado sobre un motor de consultas de procesamiento masivo en paralelo (MPP), Trino. Usa esta sección para obtener información sobre cómo conectarte desde Amazon Quick Sight a Starburst. Todo el tráfico entre Quick Sight y Starburst se habilita mediante SSL. Si te estás conectando a Starburst Galaxy, puedes obtener los detalles de conexión necesarios iniciando sesión en tu cuenta de Starburst Galaxy, luego seleccionando Partner **Connect** y luego **Quick** Sight. Debería poder ver información, como el nombre de host y el puerto. Amazon Quick Sight admite la autenticación básica de nombre de usuario y contraseña en Starburst.

Quick Sight ofrece dos formas de conectarse a Starburst: con sus credenciales de inicio de sesión de Starburst o con OAuth las credenciales de cliente. Utilice las siguientes secciones para obtener información sobre cada uno de estos métodos.

**Topics**
+ [Creación de una conexión de fuente de datos de Quick Sight a Starburst con credenciales de inicio de sesión](#create-connection-to-starburst)
+ [Crear una conexión de fuente de datos de Quick Sight a Starburst con credenciales de cliente OAuth](#create-connection-to-starburst-oauth)

## Creación de una conexión de fuente de datos de Quick Sight a Starburst con credenciales de inicio de sesión
<a name="create-connection-to-starburst"></a>

1. Comience por crear un nuevo conjunto de datos. En el panel de navegación izquierdo, selecciona **Datos**, luego selecciona **Crear y, por último**, elige **Nuevo conjunto** de datos.

1. Elija la tarjeta de origen de datos de **Starburst**.

1. Seleccione el tipo de producto Starburst. Elija **Starburst Enterprise** para las instancias de Starburst en las instalaciones. Elija **Starburst Galaxy** para las instancias administradas.

1. En **Nombre del origen de datos**, introduzca un nombre descriptivo para su conexión al origen de datos de Databricks. Como puede crear muchos conjuntos de datos a partir de una conexión a Starburst, es mejor que el nombre sea sencillo.

1. En **Tipo de conexión**, seleccione el tipo de red que utiliza. Elija **Red pública** si sus datos se comparten públicamente. Elija **VPC** si sus datos están dentro de una VPC. Para configurar una conexión de VPC en Amazon Quick Sight, consulte [Configuración de la conexión de VPC en Amazon](https://docs.aws.amazon.com/quicksight/latest/user/vpc-creating-a-connection-in-quicksight.html) Quick Sight. Este tipo de conexión no está disponible para Starburst Galaxy.

1. En **Servidor de bases de datos**, introduzca el nombre de host especificado en los detalles de conexión de Starburst.

1. En **Catálogo**, introduzca el catálogo especificado en los detalles de su conexión a Starburst.

1. En **Puerto**, introduzca el puerto especificado en los detalles de conexión de Starburst. El valor predeterminado para Starburst Galaxy es 443.

1. En **Nombre de usuario** y **Contraseña**, introduzca sus credenciales de conexión de Starburst.

1. Para comprobar que la conexión funciona, elija **Validar conexión**.

1. Para terminar y crear el origen de datos, elija **Crear origen de datos**.

**nota**  
La conectividad entre Amazon Quick Sight y Starburst se validó con la versión 420 de Starburst.

Una vez que haya creado correctamente una conexión de fuente de datos entre sus cuentas de Quick Sight y Starburst, podrá empezar a [Creación de conjuntos de datos](creating-data-sets.md) contener datos de Starburst.

## Crear una conexión de fuente de datos de Quick Sight a Starburst con credenciales de cliente OAuth
<a name="create-connection-to-starburst-oauth"></a>

Puede usar las credenciales de OAuth cliente para conectar su cuenta de Quick Sight con Starburst a través de [Quick](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html) Sight. APIs *OAuth*es un protocolo de autorización estándar que se utiliza a menudo para aplicaciones que tienen requisitos de seguridad avanzados. Cuando te conectas a Starburst con credenciales de OAuth cliente, puedes crear conjuntos de datos que contengan datos de Starburst con Quick Sight APIs y en la interfaz de usuario de Quick Sight. Para obtener más información sobre cómo configurar OAuth en Starburst, consulte [OAuth 2.0 authentication](https://docs.starburst.io/latest/security/oauth2.html).

Quick Sight admite el `client credentials` OAuth tipo de subvención. OAuthlas credenciales del cliente se utilizan para obtener un token de acceso para machine-to-machine la comunicación. Este método es adecuado para situaciones en las que un cliente necesita acceder a los recursos que están alojados en un servidor sin la participación de un usuario.

En el flujo de credenciales de cliente de OAuth 2.0, hay varios mecanismos de autenticación de clientes que se pueden utilizar para autenticar la aplicación cliente con el servidor de autorización. Quick Sight admite las credenciales de cliente basadas en OAuth Starburst para los dos mecanismos siguientes:
+ **Token (OAuth basado en secretos del cliente)**: el mecanismo de autenticación del cliente basado en secretos se utiliza con las credenciales de cliente para conceder el flujo a fin de autenticarse con el servidor de autorización. Este esquema de autenticación requiere que el `client_id` y el `client_secret` de la aplicación de cliente de OAuth se almacenen en Secrets Manager.
+ **X509 (OAuth basado en JWT de clave privada del cliente)**: la solución basada en claves del certificado X509 proporciona una capa de seguridad adicional al mecanismo de OAuth con certificados de cliente que se utilizan para autenticar en lugar de secretos de cliente. Este método lo suelen utilizar los clientes privados para autenticarse en el servidor de autorización con una fuerte confianza entre los dos servicios.

Quick Sight ha validado OAuth las conexiones con los siguientes proveedores de identidad:
+ OKTA
+ PingFederate

### Almacenamiento de credenciales de OAuth en Secrets Manager
<a name="create-connection-to-starburst-oauth-store-credentials"></a>

OAuthlas credenciales de los clientes están pensadas para casos de machine-to-machine uso y no están diseñadas para ser interactivas. Para crear una conexión de fuente de datos entre Quick Sight y Starburst, crea un nuevo secreto en Secrets Manager que contenga tus credenciales para la OAuth aplicación cliente. El ARN secreto que se crea con el nuevo secreto se puede utilizar para crear conjuntos de datos que contengan datos de Starburst en Quick Sight. Para obtener más información sobre el uso de las claves de Secrets Manager en Quick Sight, consulte[Uso de AWS Secrets Manager secretos en lugar de credenciales de bases de datos en Quick](secrets-manager-integration.md).

Las credenciales que debe almacenar en Secrets Manager vienen determinadas por el mecanismo de OAuth que utilice. Los siguientes key/value pares son necesarios para los secretos basados en el X509OAuth:
+ `username`: el nombre de usuario de la cuenta de Starburst que se utilizará al conectarse a Starburst
+ `client_id`: el ID de cliente de OAuth
+ `client_private_key`: la clave privada del cliente de OAuth
+ `client_public_key`: la clave pública del certificado del cliente de OAuth y su algoritmo cifrado (por ejemplo, `{"alg": "RS256", "kid", "cert_kid"}`)

Los siguientes key/value pares son necesarios para los secretos basados en fichas: OAuth
+ `username`: el nombre de usuario de la cuenta de Starburst que se utilizará al conectarse a Starburst
+ `client_id`: el ID de cliente de OAuth
+ `client_secret`: el secreto del cliente de OAuth

### Crear una OAuth conexión Starburst con Quick Sight APIs
<a name="create-connection-to-starburst-oauth-example"></a>

Tras crear un secreto en Secrets Manager que contenga tus OAuth credenciales de Starburst y hayas conectado tu cuenta Quick a Secrets Manager, podrás establecer una conexión de fuente de datos entre Quick Sight y Starburst con Quick Sight APIs y el SDK. En el siguiente ejemplo, se crea una conexión a un origen de datos de Starburst con credenciales de cliente de OAuth basadas en tokens.

```
{
    "AwsAccountId": "AWSACCOUNTID",
    "DataSourceId": "DATASOURCEID",
    "Name": "NAME",
    "Type": "STARBURST",
    "DataSourceParameters": {
        "StarburstParameters": {
            "Host": "STARBURST_HOST_NAME",
            "Port": "STARBURST_PORT",
            "Catalog": "STARBURST_CATALOG",
            "ProductType": "STARBURST_PRODUCT_TYPE",     
            "AuthenticationType": "TOKEN",
            "DatabaseAccessControlRole": "starburst-db-access-role-name",
            "OAuthParameters": {
              "TokenProviderUrl": "oauth-access-token-endpoint", 
              "OAuthScope": "oauth-scope",
              "IdentityProviderResourceUri" : "resource-uri",
              "IdentityProviderVpcConnectionProperties" : {
                "VpcConnectionArn": "IdP-VPC-connection-ARN"
            }
        }
    },
    "VpcConnectionProperties": {
        "VpcConnectionArn": "VPC-connection-ARN-for-Starburst"
    },
    "Credentials": {
        "SecretArn": "oauth-client-secret-ARN"
    }
}
```

Para obtener más información sobre el funcionamiento de la CreateDatasource API, consulte. [CreateDataSource](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSource.html)

Una vez que se haya establecido la conexión entre Quick Sight y Starburst y se haya creado una fuente de datos con Quick Sight APIs o el SDK, la nueva fuente de datos se mostrará en Quick Sight. Los autores de Quick Sight pueden usar esta fuente de datos para crear conjuntos de datos que contengan datos de Starburst. Las tablas se muestran en función del rol utilizado en el parámetro `DatabaseAccessControlRole` que se transfiere en una llamada a la API `CreateDataSource`. Si este parámetro no está definido al crear la conexión al origen de datos, se utiliza el rol predeterminado de Starburst.

Una vez que haya creado correctamente una conexión de fuente de datos entre sus cuentas de Quick Sight y Starburst, podrá empezar a [Creación de conjuntos de datos](creating-data-sets.md) contener datos de Starburst.

# Creación de un orígen de datos y un conjunto de datos a partir de orígenes de SaaS
<a name="connecting-to-saas-data-sources"></a>

Para analizar y elaborar informes sobre los datos de las aplicaciones de software como servicio (SaaS), puede utilizar los conectores SaaS para acceder a los datos directamente desde Quick Sight. Los conectores de SaaS simplifican el acceso a orígenes de aplicaciones de terceros con OAuth sin necesidad de exportar los datos a un almacén de datos intermedio.

Puede utilizar una instancia basada en servidor y en la nube de la aplicación SaaS. Para conectarse a una aplicación SaaS que se ejecute en la red corporativa, asegúrese de que Quick Sight pueda acceder al nombre del Sistema de nombres de dominio (DNS) de la aplicación a través de la red. Si Quick Sight no puede acceder a la aplicación SaaS, se genera un error de host desconocido. 

A continuación se muestran ejemplos de algunas formas en las que puede utilizar los datos SaaS:
+ Los equipos de ingeniería que utilizan Jira para realizar un seguimiento de los problemas y errores pueden informar sobre la eficiencia del desarrollador y la evolución de los errores. 
+ Las organizaciones de marketing pueden integrar Quick Sight con Adobe Analytics para crear paneles consolidados que permitan visualizar sus datos de marketing online y web.

Utilice el siguiente procedimiento para crear un origen de datos y un conjunto de datos conectándose a orígenes disponibles a través de software como servicio (SaaS). En este procedimiento, utilizamos una conexión a GitHub como ejemplo. Los demás orígenes de datos de SaaS siguen el mismo proceso, aunque las pantallas, especialmente las pantallas de SaaS, pueden tener un aspecto diferente.

**Creación de un origen de datos y un conjunto de datos mediante la conexión a los orígenes a través de SaaS**

1. En la página de inicio rápido, elija **Datos**.

1. En la página de **datos**, elija **Crear** y, a continuación, elija **Nuevo conjunto de datos**.

1. Elija el icono que representa la fuente de SaaS que quiere usar. Por ejemplo, puede elegir Adobe Analytics o GitHub.

   Para los orígenes que usan OAuth, el conector le lleva al sitio de SaaS para autorizar la conexión para poder crear el origen de datos. 

1. Elija un nombre para el origen de datos y escríbalo. Si existen más indicaciones de pantalla, escriba la información adecuada. A continuación, elija **Crear origen de datos**.

1. Si se le solicita que lo haga, escriba las credenciales en la página de inicio de sesión de SaaS.

1. Cuando se le solicite, autorice la conexión entre la fuente de datos de SaaS y Quick Sight.

   El siguiente ejemplo muestra la autorización para que Quick Sight acceda a la GitHub cuenta de la documentación de Quick Sight.
**nota**  
La documentación de Quick Sight ya está disponible en GitHub. Si desea realizar cambios en esta guía del usuario, puede utilizarla GitHub para editarla directamente.

   (Opcional) Si su cuenta SaaS forma parte de una cuenta de organización, es posible que se le pida que solicite el acceso de la organización como parte de la autorización de Quick Sight. Si desea hacerlo, siga las instrucciones de la pantalla de SaaS y, a continuación, elija autorizar Quick Sight.

1. Una vez que se haya completado la autorización, elija una tabla u objeto al que desea conectarse. A continuación, elija **Seleccionar**.

1. En la pantalla **Terminar de crear el conjunto de datos**, elija una de estas opciones:
   + Para guardar el origen de datos y el conjunto de datos, elija **Editar/obtener vista previa de los datos**. A continuación, elija **Guardar** en la barra de menú superior.
   + Para crear un conjunto de datos y un análisis utilizando los datos tal y como están, elija **Visualizar**. Esta opción guarda de forma automática el origen de datos y el conjunto de datos.

     También puede elegir **Editar/obtener vista previa de los datos** para preparar los datos antes de crear un análisis. En este caso, se abre la pantalla de preparación de datos. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).

Existen las siguientes limitaciones:
+ La fuente de SaaS debe admitir las operaciones de la API REST para que Quick Sight se conecte a ella.
+ Si se está conectando a Jira, la URL debe ser una dirección pública.
+ Si no tiene suficiente capacidad [SPICE](spice.md) suficiente, elija **Editar/obtener vista previa de los datos**. En la pantalla de preparación de los datos, puede eliminar los campos del conjunto de datos para reducir su tamaño o aplicar un filtro que reduzca el número de filas devueltas. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).

# Creación de un conjunto de datos desde Salesforce
<a name="create-a-data-set-salesforce"></a>

Utilice el siguiente procedimiento para crear un conjunto de datos conectándose a Salesforce y seleccionando un informe u objeto para proporcionar datos.

**Creación de un conjunto de datos con Salesforce a partir de un informe u objeto**

1. Consulte [Cuotas de origen de datos](data-source-limits.md) para asegurarse de que su informe u objeto de destino no supera las cuotas del origen de datos.

1. En la página de inicio rápido, elija **Datos**.

1. En la página de **datos**, elija **Crear** y, a continuación, **Nuevo conjunto de datos**.

1. Selecciona el icono de **Salesforce**.

1. Escriba un nombre para el origen de datos y, a continuación, elija **Crear origen de datos**.

1. En la página de inicio de sesión de Salesforce, introduzca sus credenciales de Salesforce.

1. En **Data elements: contain your data**, elija **Select** y, a continuación, elija **REPORT** u **OBJECT**.
**nota**  
Los informes combinados no se admiten como fuentes de datos de Quick Sight.

1. Elija una de las siguientes opciones:
   + Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + De lo contrario, elija un informe o un objeto y, a continuación, elija **Select**.

1. Elija una de las siguientes opciones:
   + Para crear un conjunto de datos y un análisis utilizando los datos tal y como están, elija **Visualizar**.
**nota**  
Si no tiene suficiente capacidad [SPICE](spice.md) suficiente, elija **Editar/obtener vista previa de los datos**. En la preparación de los datos, puede eliminar los campos del conjunto de datos para reducir su tamaño o aplicar un filtro que reduzca el número de filas devueltas. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos para el informe u objeto seleccionado. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).

**nota**  
El conector de Salesforce no se admite en las implementaciones de consolas integradas en las que los usuarios se autentican mediante el aislamiento del espacio de nombres. El flujo de OAuth autenticación requiere acceso directo a la consola Amazon Quick Sight para completar el proceso de inicio de sesión.

# Uso de Trino con Amazon Quick Sight
<a name="connecting-to-trino"></a>

Trino es un motor de consultas de procesamiento masivo en paralelo (MPP) creado para consultar rápidamente lagos de datos con petabytes de datos. Utilice esta sección para obtener información sobre cómo conectarse desde Amazon Quick Sight a Trino. Todo el tráfico entre Amazon Quick Sight y Trino se habilita mediante SSL. Amazon Quick Sight admite la autenticación básica de nombre de usuario y contraseña en Trino.

## Creación de una conexión para un origen de datos de Trino
<a name="create-connection-to-trino"></a>

1. Comience por crear un nuevo conjunto de datos. En el panel de navegación izquierdo, selecciona **Datos**. Elija **Crear** y, a continuación, **Nuevo conjunto de datos**.

1. Elija la tarjeta de origen de datos de **Trino**.

1. En **Nombre del origen de datos**, introduzca un nombre descriptivo para su conexión al origen de datos de Trino. Como puede crear muchos conjuntos de datos a partir de una conexión a Trino, es mejor que el nombre sea sencillo.

1. En **Tipo de conexión**, seleccione el tipo de red que utiliza. Elija **Red pública** si sus datos se comparten públicamente. Elija **VPC** si sus datos están dentro de una VPC. Para configurar una conexión de VPC en Amazon Quick Sight, consulte [Configuración de la conexión de VPC en Amazon](https://docs.aws.amazon.com/quicksight/latest/user/vpc-creating-a-connection-in-quicksight.html) Quick Sight.

1. En **Servidor de bases de datos**, introduzca el nombre de host especificado en los detalles de conexión de Trino.

1. En **Catálogo**, introduzca el catálogo especificado en los detalles de su conexión a Trino.

1. En **Puerto**, introduzca el puerto especificado en los detalles de conexión de Trino.

1. En **Nombre de usuario** y **Contraseña**, introduzca sus credenciales de conexión de Trino.

1. Para comprobar que la conexión funciona, elija **Validar conexión**.

1. Para terminar y crear el origen de datos, elija **Crear origen de datos**.

## Añadir un nuevo conjunto de datos de Amazon Quick Sight para Trino
<a name="create-dataset-using-trino"></a>

Tras completar el [proceso de creación del origen de datos](https://docs.aws.amazon.com/create-connection-to-starburst.html) para Trino, puede crear conjuntos de datos de Trino para usarlos en el análisis. Puede crear nuevos conjuntos de datos a partir de un origen de datos de Trino nuevo o existente. Cuando crea una nueva fuente de datos, Amazon Quick Sight lo lleva inmediatamente a crear un conjunto de datos, que se muestra en el paso 3 que se indica a continuación. Si utiliza un origen de datos existente para crear un conjunto de datos nuevo, comience por el paso 1 que se indica a continuación.

Para crear un conjunto de datos con un origen de datos de Trino, consulte los siguientes pasos.

1. En la página de inicio, elija **Datos**. Selecciona **Crear** y luego **Nuevo conjunto de datos**.

1. Elija la fuente de datos de Trino que creó.

1. Elija **Crear conjunto de datos**.

1. Para especificar la tabla a la que quiera conectarse, elija un esquema. Si no desea elegir un esquema, también puede utilizar su propia instrucción SQL.

1. Para especificar la tabla a la que desea conectarse, primero seleccione el **Esquema** que desee usar. En **Tablas**, elija la tabla que desea utilizar. Si prefiere usar su propia instrucción SQL, seleccione **Usar consulta SQL personalizada**.

1. Elija **Editar/obtener vista previa**.

1. (Opcional) Para agregar más datos, siga los siguientes pasos:

1. Seleccione **Añadir datos** en la parte superior derecha.

1. Para conectarse a datos diferentes, seleccione **Cambiar origen de datos** y elija un conjunto de datos diferente.

1. Siga las instrucciones para terminar de agregar datos.

1. Tras añadir nuevos datos al mismo conjunto de datos, seleccione **Configurar esta unión** (los dos puntos rojos). Configure una unión para cada tabla adicional.

1. Si desea añadir campos calculados, seleccione **Añadir campo calculado**.

1. Desactive la casilla de los campos que desea omitir.

1. Actualice los tipos de datos que desee cambiar.

1. Cuando haya terminado, elija **Guardar** para guardar y cerrar el conjunto de datos.

**nota**  
La conectividad entre Quick Sight y Trino se validó con la versión 410 de Trino.

# Creación de un conjunto de datos utilizando un archivo de texto local
<a name="create-a-data-set-file"></a>

Para crear un conjunto de datos utilizando un origen de datos de archivo de texto local, identifique la ubicación de un archivo y, a continuación, cárguelo. Los datos del archivo se importan automáticamente a [SPICE](spice.md) como parte de la creación de un conjunto de datos. 

**Creación de un conjunto de datos basado en un archivo de texto local**

1. Consulte [Cuotas de origen de datos](data-source-limits.md) para asegurarse de que su archivo de destino no supere las cuotas de origen de datos.

   Los tipos de archivos compatibles incluyen los archivos .csv, .tsv, .json, .clf o .elf.

1. En la página de inicio rápido, elija **Datos**.

1. Elija **Crear** y luego **Nuevo conjunto de datos**.

1. Elija **Cargar un archivo**.

1. En el cuadro de diálogo **Abrir**, examine un archivo, selecciónelo y, a continuación, seleccione **Abrir**.

   Un archivo debe tener 1 GB o menos para poder cargarse en Quick Sight.

1. Para preparar los datos antes de crear el conjunto de datos, elija **Editar/obtener vista previa de los datos**. De lo contrario, seleccione **Visualize** para crear un análisis utilizando los datos tal y como están. 

   Si se decide por la primera opción, puede especificar un nombre de conjunto de datos como parte de la preparación de los datos. Si elige la segunda opción, se crea un conjunto de datos con el mismo nombre que el archivo de origen. Para obtener más información sobre la preparación de datos, consulte [Preparación de datos en Amazon Quick Sight](preparing-data.md).

# Uso de los datos de Amazon Timestream con Amazon Quick Sight
<a name="using-data-from-timestream"></a>

A continuación, encontrará información sobre cómo conectarse a sus datos de Amazon Timestream mediante Amazon Quick Sight. Para obtener una breve descripción general, consulte el [tutorial en vídeo Introducción a Amazon Timestream y QuickSight](https://youtu.be/TzW4HWl-L8s) Amazon en. YouTube 

## Creación de una nueva conexión de fuente de datos de Amazon Quick Sight para una base de datos de Timestream
<a name="create-connection-to-timestream"></a>

A continuación, encontrará información sobre cómo conectarse a Amazon Timestream desde Amazon Quick Sight.

Para poder continuar, es necesario que Amazon Quick Sight esté autorizado para conectarse a Amazon Timestream. Si las conexiones no están habilitadas, aparecerá un mensaje de error al intentar conectarse. Un administrador de Quick Sight puede autorizar las conexiones a los AWS recursos. Para autorizar, abra el menú haciendo clic en el icono de su perfil en la parte superior derecha. Elija **Administrar QuickSight**, **Seguridad y permisos**, **Agregar o eliminar**. A continuación, active la casilla de verificación de Amazon Timestream y, a continuación, seleccione **Actualizar** para confirmar. Para obtener más información, consulte [Configuración del acceso de Amazon Quick Sight a las fuentes AWS de datos](access-to-aws-resources.md).

**Conexión a Amazon Timestream**

1. Comience por crear un nuevo conjunto de datos. Selecciona **Datos** en el panel de navegación de la izquierda. 

1. Elija **Crear** y, a continuación, **Nuevo conjunto de datos**.

1. Elija la tarjeta de origen de datos de Timestream.

1. En **Nombre del origen de datos**, introduzca un nombre descriptivo para su conexión al origen de datos de Timestream, por ejemplo, `US Timestream Data`. Como puede crear muchos conjuntos de datos a partir de una conexión a Timestream, es mejor que el nombre sea sencillo.

1. Seleccione **Validar conexión** para comprobar que puede conectarse correctamente a Timestream.

1. Elija **Crear origen de datos** para continuar.

1. En **Base de datos**, elija **Seleccionar** para ver la lista de opciones disponibles. 

1. Elija la que desee utilizar y, a continuación, seleccione **Seleccionar** para continuar. 

1. Realice una de las siguientes acciones:
   + Para importar sus datos al motor en memoria de Quick Sight (denominadoSPICE), elija **Importar a SPICE para obtener un análisis más rápido**. 
   + Para permitir que Quick Sight ejecute una consulta sobre sus datos cada vez que actualice el conjunto de datos o utilice el análisis o el panel, seleccione **Consultar directamente los datos**. 

   Si desea habilitar la actualización automática en un panel publicado que usa datos de Timestream, el conjunto de datos de Timestream debe usar una consulta directa.

1. Seleccione **Editar/obtener vista** y, a continuación, **Guardar** para guardar el conjunto de datos y cerrarlo.

1. Repita estos pasos para el número de conexiones directas simultáneas a Timestream que desee abrir en un conjunto de datos. Por ejemplo, supongamos que quiere usar cuatro tablas en un conjunto de datos de Quick Sight. Actualmente, los conjuntos de datos de Quick Sight se conectan a una sola tabla a la vez desde una fuente de datos de Timestream. Para usar cuatro tablas en el mismo conjunto de datos, debe agregar cuatro conexiones de fuentes de datos en Quick Sight. 

## Administrar los permisos de los datos de Timestream
<a name="dataset-permissions-for-timestream"></a>

El siguiente procedimiento describe cómo ver, añadir y revocar los permisos para permitir el acceso al mismo origen de datos de Timestream. Las personas que añada deben ser usuarios activos de Quick Sight antes de poder agregarlas. 

**Edición de los permisos de un conjunto de datos**

1. Selecciona **Datos** a la izquierda y, a continuación, desplázate hacia abajo para buscar el conjunto de datos para tu conexión de Timestream. Por ejemplo, `US Timestream Data`.

1. Elija el conjunto de datos de **Timestream** para abrirlo.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Permisos**.

   Aparece una lista de permisos actuales.

1. Para añadir permisos, seleccione **Agregar usuarios y grupos** y, a continuación, siga estos pasos:

   1. Agregue usuarios o grupos para que puedan usar el mismo conjunto de datos.

   1. Cuando termine de añadir a todos los usuarios que quiera, elija los **Permisos** que quiera aplicarles.

1. (Opcional) Para editar los permisos, puede elegir **Espectador** o **Propietario**. 
   + Seleccione **Espectador** para permitir el acceso de lectura.
   + Elija **Propietario** para permitir que el usuario edite, comparta o elimine esta fuente de datos de Quick Sight. 

1. (Opcional) Para revocar los permisos, elija **Revocar acceso**. Después de revocar el acceso de una persona, esta no podrá crear, editar, compartir ni eliminar el conjunto de datos.

1. Cuando haya terminado, elija **Cerrar**.

## Agregar un nuevo conjunto de datos de Quick Sight para Timestream
<a name="create-dataset-using-timestream"></a>

Una vez que tenga una conexión de origen de datos existente para los datos de Timestream, podrá crear conjuntos de datos de Timestream para usarlos en el análisis. 

Actualmente, puede usar una conexión de Timestream solo para una sola tabla de un conjunto de datos. Para agregar datos de varias tablas de Timestream en un único conjunto de datos, cree una conexión de fuente de datos de Quick Sight adicional para cada tabla.

**Creación de un conjunto de datos con Amazon Timestream**

1. Selecciona **Datos** a la izquierda y, a continuación, desplázate hacia abajo para encontrar la tarjeta de origen de datos para tu conexión de Timestream. Si tiene muchos orígenes de datos, puede utilizar la barra de búsqueda situada en la parte superior de la página para buscar el origen de datos cuyo nombre coincida parcialmente.

1. Elija la tarjeta de origen de datos de **Timestream** y, a continuación, elija **Crear conjunto de datos**.

1. En **Base de datos**, elija **Seleccionar** para ver una lista de las bases de datos disponibles y elija la que desee usar.

1. En **Tablas**, elija la tabla que desea utilizar.

1. Elija **Editar/obtener vista previa**.

1. (Opcional) Para agregar más datos, siga los siguientes pasos: 

   1. Seleccione **Añadir datos** en la parte superior derecha.

   1. Para conectarse a datos diferentes, seleccione **Cambiar origen de datos** y elija un conjunto de datos diferente. 

   1. Siga las instrucciones de la interfaz de usuario para terminar de añadir datos. 

   1. Tras añadir nuevos datos al mismo conjunto de datos, seleccione **Configurar esta unión **(los dos puntos rojos). Configure una unión para cada tabla adicional. 

   1. Si desea añadir campos calculados, seleccione **Añadir campo calculado**. 

   1. Para añadir un modelo de SageMaker IA, selecciona **Aumentar** con. SageMaker Esta opción solo está disponible en la edición Amazon Quick Enterprise.

   1. Desactive la casilla de los campos que desea omitir.

   1. Actualice los tipos de datos que desee cambiar.

1. Cuando haya terminado, elija **Guardar** para guardar y cerrar el conjunto de datos. 

## Añadir datos de Timestream a un análisis
<a name="open-analysis-add-dataset-for-timestream"></a>

A continuación, encontrará información sobre cómo añadir un conjunto de datos de Amazon Timestream a un análisis de Quick Sight. Antes de comenzar, asegúrese de que dispone de un conjunto de datos que contiene los datos de Timestream que desea utilizar.

**Adición de datos de Amazon Timestream a un análisis**

1. Seleccione **Análisis** a la izquierda.

1. Realice una de las siguientes acciones:
   + Para crear un análisis nuevo, elija **Nuevo análisis** en la derecha. 
   + Para añadirlo a un análisis existente, abra el análisis que desea editar. 
     + Seleccione el icono del lápiz situado en la parte superior izquierda.
     + Seleccione **Agregar cojunto de datos**.

1. Elija el conjunto de datos de Timestream que desea agregar.

Para obtener más información, consulte [Working with analyses](https://docs.aws.amazon.com/quicksight/latest/user/working-with-analyses.html).

# Cuotas de origen de datos
<a name="data-source-limits"></a>

Las fuentes de datos que utilice con Amazon Quick Sight deben cumplir las siguientes cuotas.

**Topics**
+ [Cuotas de SPICE para los datos importados](#spice-limits)
+ [Cuotas para consultas de SQL directas](#query-limits)

## Cuotas de SPICE para los datos importados
<a name="spice-limits"></a>

Cuando crea un conjunto de datos nuevo en Amazon Quick Sight, [SPICE](spice.md)limita el número de filas que puede añadir a un conjunto de datos. Puede incorporar datos a SPICE desde una consulta o desde un archivo. Cada archivo puede tener hasta 2000 columnas. Cada nombre de columna puede tener hasta 127 caracteres Unicode. Cada campo puede tener hasta 2 047 caracteres Unicode. Si utiliza la nueva experiencia de preparación de datos para crear su conjunto de datos SPICE, cada campo puede tener hasta 65 534 caracteres Unicode. 

Para recuperar un subconjunto de datos de un conjunto más grande, puede anular la selección de columnas o aplicar filtros para reducir el tamaño de los datos. Si va a importar desde Amazon S3, cada manifiesto puede especificar hasta 1000 archivos. 

Las cuotas de SPICE son las siguientes:
+  2.047 caracteres Unicode para cada campo. (65.534 caracteres Unicode con nueva experiencia en la preparación de datos) 
+ 127 caracteres Unicode para cada nombre de columna
+ 2000 columnas por cada archivo
+ 1000 archivos por cada manifiesto
+ En Standard Edition, 25 millones (25 000 000) de filas o 25 GB para cada conjunto de datos
+ Para la edición Enterprise, 2 mil millones (2 000 000 000) filas o 2 TB para cada conjunto de datos

Todas las cuotas se aplican también a los conjuntos de datos de SPICE con seguridad de nivel de fila.

En raras ocasiones, si está incorporando filas grandes a SPICE, es posible que alcance la cuota de gigabytes por conjunto de datos antes de alcanzar la cuota de filas. El tamaño se basa en la capacidad de SPICE que ocupan los datos después de introducirlos en SPICE. 

## Cuotas para consultas de SQL directas
<a name="query-limits"></a>

Si no va a importar datos a SPICE, se aplican diferentes cuotas para el espacio y el tiempo. En operaciones como la conexión, el muestreo de datos para un conjunto de datos y la generación de elementos visuales, es posible que se agoten los tiempos de espera. En algunos casos, se trata de las cuotas de tiempo de espera establecidas por el motor de base de datos de origen. En otros casos, como la visualización, Amazon Quick Sight genera un tiempo de espera después de 2 minutos.

Sin embargo, no todos los controladores de base de datos reaccionan al tiempo de espera de 2 minutos, por ejemplo, Amazon Redshift. En estos casos, la consulta se ejecuta durante todo el tiempo que se tarda en devolver la respuesta, lo que puede dar lugar a consultas de larga ejecución en la base de datos. Cuando esto sucede, puede cancelar la consulta desde el servidor de base de datos para liberar recursos de la base de datos. Siga las instrucciones de su servidor de base de datos acerca de cómo hacerlo. Por ejemplo, para obtener más información sobre cómo cancelar consultas en Amazon Redshift, consulte [Cancelar una consulta en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/cancel_query.html) e [Implementación de Workload Management en Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/dg/cm-c-implementing-workload-management.html) en la *Guía para desarrolladores de bases de datos de Amazon Redshift*.

Cada conjunto de resultados de una consulta directa puede tener hasta 2000 columnas. Cada nombre de columna puede tener hasta 127 caracteres Unicode. Si desea recuperar datos de una tabla mayor, puede utilizar uno de los distintos métodos para reducir el tamaño de los datos. Puede anular la selección de columnas o aplicar filtros. En las consultas SQL también puede utilizar predicados como `WHERE` o `HAVING`. Si los elementos visuales agotan el tiempo de espera durante una consulta directa, puede simplificar la consulta para optimizar el tiempo de ejecución o puede importar los datos a SPICE. 

Las cuotas de las consultas son las siguientes:
+ 127 caracteres Unicode para cada nombre de columna.
+ 2000 columnas para cada conjunto de datos.
+ Cuota de 2 minutos para generar un elemento visual o una muestra de conjunto de datos opcional.
+ Se aplican cuotas de tiempo de espera de origen de datos (varían en función de cada motor de base de datos).

# Tipos de datos y valores admitidos
<a name="supported-data-types-and-values"></a>

Amazon Quick Sight admite actualmente los siguientes tipos de datos primitivos: `Date``Decimal`,`Integer`, y`String`. A continuación se detallan los tipos de datos que se admiten en SPICE: `Date`, `Decimal-fixed`, `Decimal-float`, `Integer` y `String`. Quick Sight acepta valores booleanos promocionándolos como números enteros. También puede derivar tipos de datos geoespaciales. Los tipos de datos geoespaciales utilizan metadatos para interpretar el tipo de datos físicos. La latitud y la longitud son numéricos. Todas las demás categorías geoespaciales son cadenas. 

Asegúrese de que las tablas o los archivos que utilice como origen de datos contengan únicamente campos que se puedan convertir implícitamente en estos tipos de datos. Amazon Quick Sight omite los campos o columnas que no se puedan convertir. Si aparece un error que dice “fields were skipped because they use unsupported data types”, modifique la consulta o tabla para eliminar o reformular los tipos de datos no compatibles.

## Datos de texto y cadenas
<a name="strings"></a>

Los campos o columnas que contienen caracteres se denominan *cadenas*. Un campo con el tipo de datos de `STRING` puede contener inicialmente casi cualquier tipo de datos. Algunos ejemplos son nombres, descripciones, números de teléfono, números de cuenta, datos de JSON, ciudades, códigos postales, fechas y números que se pueden utilizar para realizar cálculos. Estos tipos a veces se denominan datos textuales en un sentido general, pero no en un sentido técnico. Quick Sight no admite objetos binarios ni con caracteres grandes (BLOBs) en las columnas del conjunto de datos. En la documentación de Quick Sight, el término «texto» siempre significa «cadena de datos». 

La primera vez que consulta o importa los datos, Quick Sight intenta interpretar los datos que identifica como de otro tipo, por ejemplo, fechas y números. Se recomienda comprobar que los tipos de datos asignados a los campos o columnas son correctos. 

Para cada campo de cadena de caracteres de los datos importados, Quick Sight utiliza una longitud de campo de 8 bytes más la longitud de los caracteres codificados en UTF-8. Amazon Quick Sight admite la codificación de archivos en UTF-8, pero no en UTF-8 (con BOM).

## Datos de fecha y hora
<a name="dates"></a>

Los campos con un tipo de datos de `Date` también incluyen datos de tiempo y también se conocen como campos `Datetime`. [Quick Sight admite fechas y horas que utilizan los formatos de fecha compatibles.](#supported-date-formats) 

Quick Sight usa la hora UTC para consultar, filtrar y mostrar los datos de fecha. Cuando los datos de fecha no especifican una zona horaria, Quick Sight asume los valores UTC. Cuando los datos de fecha especifican una zona horaria, Quick Sight la convierte para que se muestre en la hora UTC. Por ejemplo, un campo de fecha con un desfase de zona horaria similar **2015-11-01T03:00:00-08:00** se convierte a UTC y se muestra en Amazon Quick Sight como**2015-11-01T15:30:00**. 

Para cada `DATE` campo de los datos importados, Quick Sight utiliza una longitud de campo de 8 bytes. Quick Sight admite la codificación de archivos en UTF-8, pero no en UTF-8 (con BOM).

## Datos numéricos
<a name="numeric"></a>

Los datos numéricos incluyen números enteros y decimales. Los enteros con un tipo de datos de `INT` son números negativos o positivos que no tienen decimales. Quick Sight no distingue entre enteros grandes y pequeños. Los números enteros que superen un valor igual a `9007199254740991` o `2^53 - 1` que no se muestren de forma exacta o correcta en un elemento visual.

Los decimales con el tipo de datos de `Decimal` son números negativos o positivos que contienen al menos un decimal, antes o después del separador decimal. Al elegir el modo de consulta directa, todos los tipos decimales no enteros se marcan como `Decimal` y el motor subyacente controla la precisión del punto de datos en función de los comportamientos admitidos por el origen de datos. Para obtener más información sobre los tipos de orígenes de datos compatibles, consulte [Tipos de datos y valores admitidos](#supported-data-types-and-values).

Al almacenar el conjunto de datosSPICE, puede optar por almacenar los valores decimales como `fixed` tipos `float` decimales. `Decimal-fixed`los tipos de datos utilizan el formato decimal (`18,4`), que permite 18 dígitos en total y hasta 4 dígitos después de la coma decimal. `Decimal-fixed`los tipos de datos son una buena opción para realizar operaciones matemáticas exactas, pero Quick Sight redondea el valor a la diezmilésima posición más cercana cuando se introduce el valor. SPICE

Los tipos de datos `Decimal-float` proporcionan aproximadamente 16 dígitos significativos de precisión a un valor. Los dígitos significativos pueden estar a ambos lados de la coma decimal para admitir números con muchos decimales y números más altos al mismo tiempo. Por ejemplo, el tipo de datos `Decimal-float` admite el número `12345.1234567890` o el número `1234567890.12345`. Si trabaja con números muy pequeños cercanos a `0`, el tipo de datos `Decimal-float` admite hasta 15 dígitos a la derecha de la coma decimal, por ejemplo `0.123451234512345`. El valor máximo que admite este tipo de datos es `1.8 * 10^308` para minimizar la probabilidad de que se produzca un error de desbordamiento en el conjunto de datos.

El tipo de datos `Decimal-float` es inexacto y algunos valores se almacenan como aproximaciones en lugar del valor real. Esto puede provocar pequeñas discrepancias al almacenar y devolver algunos valores específicos. Las siguientes consideraciones se aplican al tipo de datos `Decimal-float`.
+ Si el conjunto de datos que utiliza proviene de un origen de datos de Amazon S3, SPICE asigna el tipo decimal `Decimal-float` a todos los valores decimales numéricos.
+ Si el conjunto de datos que está utilizando proviene de una base de datos, SPICE usa el tipo decimal al que se asigna el valor en la base de datos. Por ejemplo, si al valor se le asigna un valor numérico de punto fijo en la base de datos, el valor será del tipo `Decimal-fixed` en SPICE.

En el caso de los conjuntos de datos SPICE existentes que contienen campos que se pueden convertir al tipo de datos `Decimal-float`, aparecerá una ventana emergente en la página **Editar conjunto de datos**. Para convertir los campos de un conjunto de datos existente al tipo de datos `Decimal-float`, seleccione **ACTUALIZAR LOS CAMPOS**. Si no desea registrarse, elija **NO ACTUALIZAR LOS CAMPOS**. La ventana emergente **Actualizar los campos** aparecerá cada vez que se abra la página **Editar conjunto de datos** hasta que se guarde y publique el conjunto de datos.

## Tipos de datos compatibles de orígenes de datos externos
<a name="supported-data-types"></a>

En la siguiente tabla se enumeran los tipos de datos que se admiten cuando se utilizan las siguientes fuentes de datos con Amazon Quick Sight. 


****  

| Origen o motor de base de datos | Tipos de datos numéricos | Tipos de datos de cadena | Tipos de datos de fecha y hora | Tipos de datos booleanos | 
| --- | --- | --- | --- | --- | 
|   **Amazon Athena, Presto, Starburst, Trino**  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 
|  **Amazon Aurora**, **MariaDB** y **MySQL**  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  | 
|   ** OpenSearch Servicio Amazon**  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 
|  **Oracle**  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html) | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html) | bit | 
|   **PostgreSQL**   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 
|   **Apache Spark**  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 
|   **Snowflake**   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 
|   **Microsoft SQL Server**   |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 

### Formatos de fecha admitidos
<a name="supported-date-formats"></a>

Amazon Quick Sight admite los formatos de fecha y hora descritos en esta sección. Antes de añadir datos a Amazon Quick Sight, comprueba si el formato de fecha es compatible. Si necesita usar un formato no compatible, consulte [Uso de fechas no admitidas o personalizadas](using-unsupported-dates.md).

Los formatos admitidos varían según el tipo de origen de datos, de la siguiente manera:


| Origen de datos | Relojes | Formatos de fecha | 
| --- | --- | --- | 
|  Cargas de archivo Orígenes de Amazon S3 Athena Salesforce  |  Relojes en formato de 24 y 12 horas  |  Los formatos de fecha y hora compatibles se describen en la documentación de la API de Joda.  Para obtener una lista completa de los formatos de fecha de Joda, consulta [Class DateTimeFormat](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html) en el sitio web de Joda. Para los conjuntos de datos almacenados en la memoria (SPICE), Amazon Quick Sight admite fechas en el siguiente rango: `Jan 1, 0001 00:00:00 UTC` hasta`Dec 31, 9999, 23:59:59 UTC`.   | 
|  Orígenes de bases de datos relacionales  |  Solo un reloj en formato de 24 horas  |  Los siguientes formatos de datos y hora: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/supported-data-types-and-values.html)  | 

### Valores de datos no admitidos
<a name="unsupported-data-values"></a>

Si un campo contiene valores que no se ajustan al tipo de datos que Amazon Quick Sight le asigna, se omiten las filas que contienen esos valores. Por ejemplo, tomemos los datos de origen siguientes:

```
Sales ID    Sales Date    Sales Amount
--------------------------------------
001        10/14/2015        12.43
002        5/3/2012          25.00
003        Unknown           18.17
004        3/8/2009          86.02
```

Amazon Quick Sight **Sales Date** lo interpreta como un campo de fecha y elimina la fila que contiene un valor que no es de fecha, por lo que solo se importan las filas siguientes.

```
Sales ID    Sales Date    Sales Amount
--------------------------------------
001        10/14/2015        12.43
002        5/3/2012          25.00
004        3/8/2009          86.02
```

En algunos casos, un campo de base de datos puede contener valores que el controlador JDBC no puede interpretar para el motor de base de datos de origen. En esos casos, los valores no interpretables se reemplazan por null para que las filas se puedan importar. La única aparición conocida de este problema es con los campos date, datetime y timestamp de MySQL, que tienen todos los valores cero, por ejemplo, **0000-00-00 00:00:00**. Por ejemplo, tomemos los datos de origen siguientes:

```
Sales ID    Sales Date                Sales Amount
---------------------------------------------------
001        2004-10-12 09:14:27        12.43
002        2012-04-07 12:59:03        25.00
003        0000-00-00 00:00:00        18.17
004        2015-09-30 01:41:19        86.02
```

En este caso, se importan los siguientes datos.

```
Sales ID    Sales Date                Sales Amount
---------------------------------------------------
001        2004-10-12 09:14:27        12.43
002        2012-04-07 12:59:03        25.00
003        (null)                     18.17
004        2015-09-30 01:41:19        86.02
```

# Trabajar con conjuntos de datos
<a name="working-with-datasets"></a>

Los conjuntos de datos son la base de sus análisis de Quick Sight y sirven como fuentes de datos preparadas y estructuradas que impulsan sus análisis y paneles. Una vez que haya creado los conjuntos de datos a partir de sus fuentes de datos, tendrá que gestionarlos de forma eficaz durante todo su ciclo de vida para garantizar un análisis fiable, seguro y colaborativo.

En esta sección se describe el flujo de trabajo completo de la administración de conjuntos de datos, desde la edición y el control de versiones de los conjuntos de datos hasta su uso compartido con los miembros del equipo y la implementación de controles de seguridad. Aprenderá cómo mantener la integridad de los conjuntos de datos y, al mismo tiempo, respaldar el análisis colaborativo, realizar un seguimiento de los análisis que dependen de sus conjuntos de datos e implementar medidas de seguridad tanto a nivel de fila como de columna para proteger la información confidencial. Ya sea que esté preparando conjuntos de datos para su uso en equipo, solucionando problemas de análisis o implementando políticas de gobierno de datos, estos temas proporcionan los conocimientos esenciales para una gestión eficaz de los conjuntos de datos en Quick Sight.

**Topics**
+ [Creación de conjuntos de datos](creating-data-sets.md)
+ [Edición de conjuntos de datos](edit-a-data-set.md)
+ [Revertir los conjuntos de datos a versiones publicadas anteriores](dataset-versioning.md)
+ [Duplicación de conjuntos de datos](duplicate-a-data-set.md)
+ [Compartir conjuntos de datos](sharing-data-sets.md)
+ [Tableros de control y análisis de seguimiento que utilizan un conjunto de datos](track-analytics-that-use-dataset.md)
+ [Uso de parámetros de conjuntos de datos en Amazon Quick](dataset-parameters.md)
+ [Uso de la seguridad a nivel de fila en Amazon Quick](row-level-security.md)
+ [Uso de la seguridad en el nivel de columna para restringir el acceso a un conjunto de datos](restrict-access-to-a-data-set-using-column-level-security.md)
+ [Ejecutar consultas como función de IAM en Amazon Quick](datasource-run-as-role.md)
+ [Eliminación de conjuntos de datos](delete-a-data-set.md)
+ [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md)

# Creación de conjuntos de datos
<a name="creating-data-sets"></a>

 Puede crear conjuntos de datos a partir de fuentes de datos nuevas o existentes en Amazon Quick. Puede utilizar diversas fuentes de datos de bases de datos para proporcionar datos a Amazon Quick. las instancias de Amazon RDS y los clústeres de Amazon Redshift. También pueden ser instancias de MariaDB, Microsoft SQL Server, MySQL, Oracle y PostgreSQL de su organización, de Amazon EC2 o de entornos similares. 

**Topics**
+ [Creación de conjuntos de datos usando nuevos orígenes de datos](creating-data-sets-new.md)
+ [Creación de un conjunto de datos utilizando un origen de datos existente](create-a-data-set-existing.md)
+ [Crear un conjunto de datos a partir de un conjunto de datos existente en Amazon Quick](create-a-dataset-existing-dataset.md)

# Creación de conjuntos de datos usando nuevos orígenes de datos
<a name="creating-data-sets-new"></a>

Al crear un conjunto de datos basado en un AWS servicio como Amazon RDS, Amazon Redshift o Amazon EC2, es posible que se apliquen cargos por transferencia de datos al consumir datos de esa fuente. Estos cargos también pueden variar en función de si ese AWS recurso se encuentra en la casa Región de AWS que has elegido para tu cuenta de Amazon Quick. Para obtener más información sobre precios, consulte la página de precios del servicio en cuestión.

Al crear un nuevo conjunto de datos de base de datos, puede seleccionar una tabla, unir varias tablas o crear una consulta SQL para recuperar los datos que desee. También puede cambiar si el conjunto de datos utiliza una consulta directa o almacena los datos en [SPICE](spice.md).

**Creación de un nuevo conjunto de datos**

1. Para crear un conjunto de datos, selecciona **Nuevo conjunto de datos** en la página **de datos**. A continuación, podrá crear un conjunto de datos basado en un conjunto de datos o un origen de datos existente o conectarse a un nuevo origen de datos y basar el conjunto de datos en ello.

1. Proporcione la información de conexión al origen de datos:
   + Para archivos de texto o Microsoft Excel locales, puede simplemente identificar la ubicación del archivo y cargarlo.
   + En el caso de Amazon S3, debe proporcionar un manifiesto que identifique los archivos o buckets que desee utilizar y también la configuración de importación de los archivos de destino.
   + En el caso de Amazon Athena, se devuelven todas las bases de datos de Athena de su AWS cuenta. No se requieren credenciales adicionales.
   + Para Salesforce, proporcione credenciales con las que conectarse.
   + Para Amazon Redshift, Amazon RDS, Amazon EC2 u otros orígenes de datos de base de datos, proporcione información sobre el servidor y la base de datos que alojan los datos. Proporcione también credenciales válidas para esa instancia de base de datos.

# Creación de un conjunto de datos a partir de una base de datos
<a name="create-a-database-data-set"></a>

Los siguientes procedimientos le ayudarán a conectar con orígenes de datos de bases de datos y crear conjuntos de datos. Para crear conjuntos de datos a partir de fuentes de AWS datos que su cuenta Amazon Quick descubrió automáticamente, utilice. [Creación de un conjunto de datos desde un clúster de Amazon Redshift o una instancia de Amazon RDS detectados automáticamente](#create-a-data-set-autodiscovered) Para crear conjuntos de datos a partir de cualquier otro origen de datos de base de datos, utilice [Creación de un conjunto de datos utilizando una base de datos no detectada automáticamente](#create-a-data-set-database). 

## Creación de un conjunto de datos desde un clúster de Amazon Redshift o una instancia de Amazon RDS detectados automáticamente
<a name="create-a-data-set-autodiscovered"></a>

Utilice el siguiente procedimiento para crear una conexión con un origen de datos de AWS detectado automáticamente.

**Para crear una conexión a una fuente de datos detectada automáticamente AWS**

1. Consulte [Cuotas de origen de datos](data-source-limits.md) para asegurarse de que su consulta o tabla de destino no supere las cuotas del origen de datos.

1. Confirme que las credenciales de la base de datos que piensa utilizar tienen permisos apropiados como se describe en [Permisos necesarios](required-permissions.md). 

1. Asegúrese de haber configurado el clúster o la instancia para Amazon Quick Access siguiendo las instrucciones que se indican en[Requisitos de configuración de la red y de la base de datos](configure-access.md).

1. En la página de inicio rápido de Amazon, selecciona **Datos**.

1. Selecciona **Crear** y, a continuación, selecciona **Nuevo conjunto de datos**.

1. Elija el icono de detección automática de **RDS** o **Redshift**, según AWS el servicio al que desee conectarse.

1. Escriba la información de conexión del origen de datos, tal y como se indica a continuación:
   + En **Nombre de origen de datos**, escriba un nombre para el origen de datos.
   + En **ID de instancia**, elija el nombre de la instancia o clúster al que desea conectar.
   + **Nombre de base de datos** muestra la base de datos predeterminada del clúster o instancia de **ID de instancia**. Para utilizar una base de datos diferente en ese clúster o instancia, escriba su nombre.
   + Para ello **UserName**, introduzca el nombre de usuario de una cuenta de usuario que tenga permisos para hacer lo siguiente: 
     + Acceder a la base de datos de destino. 
     + Leer las tablas de esa base de datos que desee utilizar (realizar una instrucción `SELECT` en ellas).
   + En **Contraseña**, introduzca la contraseña de la cuenta que ha introducido.

1. Elija **Validate connection** para verificar que la información de conexión es correcta.

1. Si la conexión se valida, elija **Crear origen de datos**. En caso contrario, corrija la información de la conexión y vuelve a validar de nuevo.
**nota**  
Amazon Quick protege automáticamente las conexiones a las instancias de Amazon RDS y a los clústeres de Amazon Redshift mediante Secure Sockets Layer (SSL). No tiene que hacer nada más para habilitarlo.

1. Seleccione una de las siguientes opciones:
   + **SQL personalizada**

     En la siguiente pantalla, puede elegir escribir una consulta con la opción **Usar consulta SQL personalizada**. Al hacer esto se abre una pantalla llamada **Escriba la consulta SQL personalizada**, donde podrá escribir el nombre de la consulta y escribir, a continuación, la SQL. Para obtener los mejores resultados, cree la consulta en un editor de SQL y, a continuación, péguela en esta ventana. Después de asignar el nombre y de escribir la consulta, puede elegir **Editar/obtener vista previa de los datos** o **Confirmar consulta**. Elija **Editar/obtener vista previa de los datos** para ir de forma inmediata a la preparación de datos. Elija **Confirmar consulta** para validar la SQL y asegurarse de que no haya errores.
   + **Elección de tablas**

     Para conectarse a tablas específicas, en **Esquema: contiene conjuntos de tablas**, elija **Seleccionar** y, a continuación, elija un esquema. En algunos casos en los que no hay un único esquema en la base de datos, dicho esquema se elige de forma automática, en cuyo caso la opción de selección de esquema no se muestra.

     Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos. Utilice esta opción si desea unirse a más tablas.

     De lo contrario, después de elegir una tabla, elija **Seleccionar**.

1. Elija una de las siguientes opciones:
   + Prepare los datos antes de crear un análisis. Para ello, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos para la tabla seleccionada. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Cree un conjunto de datos y análisis mediante los datos de la tabla tal cual y para importar los datos del conjunto de datos a SPICE para mejorar el rendimiento (recomendado). Para ello, verifique el tamaño de la tabla y el indicador SPICE para ver si tiene suficiente capacidad.

     Si tiene suficiente capacidad de SPICE, elija el botón de opción **Importar a SPICE para agilizar el análisis** y, a continuación, cree un análisis eligiendo **Visualizar**.
**nota**  
Si desea utilizar SPICE y no tiene espacio suficiente, elija **Editar/obtener vista previa de los datos**. En la preparación de datos, puede quitar campos del conjunto de datos para reducir su tamaño. También puede aplicar un filtro o escribir una consulta SQL que reduzca el número de filas o columnas devueltas. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Para crear un conjunto de datos y un análisis utilizando datos de una tabla tal y como están, y para realizar consultas en los datos directamente desde la base de datos, elija el botón de opción **Realizar una consulta directamente sobre los datos**. A continuación, cree un análisis seleccionando **Visualizar**.

## Creación de un conjunto de datos utilizando una base de datos no detectada automáticamente
<a name="create-a-data-set-database"></a>

Utilice el siguiente procedimiento para crear una conexión a cualquier base de datos que no sea un clúster de Amazon Redshift o una instancia de Amazon RDS detectados automáticamente. Estas bases de datos incluyen clústeres de Amazon Redshift e instancias de Amazon RDS que se encuentran en una cuenta diferente Región de AWS o que están asociadas a una cuenta diferente. AWS También pueden ser instancias de MariaDB, Microsoft SQL Server, MySQL, Oracle y PostgreSQL que estén en las instalaciones, en Amazon EC2 o en algún otro entorno accesible.

**Creación de una conexión a una base de datos que no sea un clúster de Amazon Redshift o una instancia de RDS detectados automáticamente**

1. Consulte [Cuotas de origen de datos](data-source-limits.md) para asegurarse de que su consulta o tabla de destino no supere las cuotas del origen de datos.

1. Confirme que las credenciales de la base de datos que piensa utilizar tienen permisos apropiados como se describe en [Permisos necesarios](required-permissions.md). 

1. Asegúrese de haber configurado el clúster o la instancia para Amazon Quick Access siguiendo las instrucciones que se indican en[Requisitos de configuración de la red y de la base de datos](configure-access.md).

1. En la página de inicio rápido de Amazon, selecciona **Administrar datos**.

1. Selecciona **Crear** y, a continuación, selecciona **Nuevo conjunto de datos**.

1. Elija el icono de **conexión manual de Redshift** si desea conectarse a un clúster de Amazon Redshift en Región de AWS otro o asociado a una cuenta diferente. AWS O bien, elija el sistema de administración de bases de datos adecuado para conectarse a una instancia de Amazon Aurora, MariaDB, Microsoft SQL Server, MySQL, Oracle o PostgreSQL.

1. Escriba la información de conexión del origen de datos, tal y como se indica a continuación:
   + En **Nombre de origen de datos**, escriba un nombre para el origen de datos.
   + En **Servidor de base de datos**, escriba uno de los siguientes valores:
     + En un clúster de Amazon Redshift o una instancia de Amazon RDS, escriba el punto de conexión del clúster o instancia sin el número de puerto. Por ejemplo, si el valor del punto enlace es `clustername.1234abcd.us-west-2.redshift.amazonaws.com:1234`, escriba `clustername.1234abcd.us-west-2.redshift.amazonaws.com`. Puede obtener el valor del punto final en el campo **Punto final** de la página de detalles del clúster o la instancia de la AWS consola.
     + Si se trata de una instancia de Amazon EC2 de MariaDB, Microsoft SQL Server, MySQL, Oracle o PostgreSQL, escriba la dirección de DNS público. Puede obtener el valor del DNS público en el campo **DNS público** del panel de detalles de la instancia de la consola de Amazon EC2.
     + Para una instancia que no sea de Amazon EC2 de MariaDB, Microsoft SQL Server, MySQL, Oracle o PostgreSQL, escriba el nombre de host o dirección IP pública del servidor de base de datos. Si utiliza la capa de conexión segura (SSL) para una conexión segura (lo que se recomienda), probablemente deberá indicar el nombre de host que corresponda a la información requerida por el certificado SSL. Para ver una lista de certificados aceptados, consulte [Certificados Amazon Quick SSL y CA](configure-access.md#ca-certificates).
   + En **Puerto**, escriba el puerto que el clúster o la instancia utiliza para las conexiones.
   + En **Nombre de base de datos**, escriba el nombre de la base de datos que desee utilizar.
   + Para ello **UserName**, introduzca el nombre de usuario de una cuenta de usuario que tenga permisos para hacer lo siguiente: 
     + Acceder a la base de datos de destino. 
     + Leer las tablas de esa base de datos que desee utilizar (realizar una instrucción `SELECT` en ellas).
   + En **Contraseña**, escriba la contraseña asociada a la cuenta que ha introducido.

1. (Opcional) Si se conecta a un elemento que no sea un clúster de Amazon Redshift y *no* quiere una conexión protegida, asegúrese de que no marca **Habilitar SSL**. *Recomendamos encarecidamente dejarla marcada*, ya que una conexión no protegida puede estar expuesta a intrusiones. 

   Para obtener más información acerca de cómo la instancia de destino utiliza SSL para proteger las conexiones, consulte la documentación del sistema de administración de base de datos de destino. Amazon Quick no acepta certificados SSL autofirmados como válidos. Para ver una lista de certificados aceptados, consulte [Certificados Amazon Quick SSL y CA](configure-access.md#ca-certificates).

   Amazon Quick protege automáticamente las conexiones a los clústeres de Amazon Redshift mediante SSL. No tiene que hacer nada más para habilitarlo.

   Algunas bases de datos, como Presto y Apache Spark, deben cumplir requisitos adicionales para que Amazon Quick pueda conectarse. Para obtener más información, consulte [Creación de un origen de datos con Presto](create-a-data-source-presto.md) o [Creación de un origen de datos con Apache Spark](create-a-data-source-spark.md).

1. (Opcional) Elija **Validar conexión** para verificar que la información de conexión es correcta.

1. Si la conexión se valida, elija **Crear origen de datos**. En caso contrario, corrija la información de la conexión y vuelve a validar de nuevo.

1. Seleccione una de las siguientes opciones:
   + **SQL personalizada**

     En la siguiente pantalla, puede elegir escribir una consulta con la opción **Usar consulta SQL personalizada**. Al hacer esto se abre una pantalla llamada **Escriba la consulta SQL personalizada**, donde podrá escribir el nombre de la consulta y escribir, a continuación, la SQL. Para obtener los mejores resultados, cree la consulta en un editor de SQL y, a continuación, péguela en esta ventana. Después de asignar el nombre y de escribir la consulta, puede elegir **Editar/obtener vista previa de los datos** o **Confirmar consulta**. Elija **Editar/obtener vista previa de los datos** para ir de forma inmediata a la preparación de datos. Elija **Confirmar consulta** para validar la SQL y asegurarse de que no haya errores.
   + **Elección de tablas**

     Para conectarse a tablas específicas, en **Esquema: contiene conjuntos de tablas**, elija **Seleccionar** y, a continuación, elija un esquema. En algunos casos en los que no hay un único esquema en la base de datos, dicho esquema se elige de forma automática, en cuyo caso la opción de selección de esquema no se muestra.

     Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos. Utilice esta opción si desea unirse a más tablas.

     De lo contrario, después de elegir una tabla, elija **Seleccionar**.

1. Elija una de las siguientes opciones:
   + Prepare los datos antes de crear un análisis. Para ello, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos para la tabla seleccionada. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Cree un conjunto de datos y un análisis mediante los datos de la tabla tal cual e importe los datos del conjunto de datos en SPICE para mejorar el rendimiento (recomendado). Para ello, verifique el tamaño de la tabla y el indicador SPICE para ver si tiene suficiente espacio.

     Si tiene suficiente capacidad de SPICE, elija el botón de opción **Importar a SPICE para agilizar el análisis** y, a continuación, cree un análisis eligiendo **Visualizar**.
**nota**  
Si desea utilizar SPICE y no tiene espacio suficiente, elija **Editar/obtener vista previa de los datos**. En la preparación de datos, puede quitar campos del conjunto de datos para reducir su tamaño. También puede aplicar un filtro o escribir una consulta SQL que reduzca el número de filas o columnas devueltas. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Cree un conjunto de datos y un análisis mediante los datos de tabla tal cual y realice consultas en los datos directamente desde la base de datos. Para hacerlo, elija **Realizar una consulta directamente sobre los datos**. A continuación, cree un análisis seleccionando **Visualizar**.

# Creación de un conjunto de datos utilizando un origen de datos existente
<a name="create-a-data-set-existing"></a>

Tras realizar una conexión inicial a un Salesforce, un almacén de AWS datos u otra fuente de datos de base de datos, Amazon Quick guarda la información de conexión. Agrega el origen de datos a la sección **DESDE ORÍGENES DE DATOS EXISTENTES** de la página **Crear un conjunto de datos**. Puede utilizar estos orígenes de datos existentes para crear nuevos conjuntos de datos sin tener que volver a especificar la información de conexión.

## Creación de un conjunto de datos utilizando un origen de datos de Amazon S3 existente
<a name="create-a-data-set-existing-s3"></a>

Utilice el siguiente procedimiento para crear un conjunto de datos utilizando un origen de datos de Amazon S3 existente.

**Creación de un conjunto de datos utilizando un origen de datos de S3 existente**

1. En la página de inicio rápido de Amazon, selecciona **Datos**.

1. Selecciona **Crear** y, a continuación, selecciona **Nuevo conjunto de datos**.

1. Elija la fuente de datos de Amazon S3 que desee utilizar.

1. Para preparar los datos antes de crear el conjunto de datos, elija **Editar/obtener vista previa de los datos**. Para crear un análisis mediante los datos tal cual, elija **Visualizar**.

## Creación de un conjunto de datos utilizando un origen de datos de Amazon Athena existente
<a name="create-a-data-set-existing-athena"></a>

Para crear un conjunto de datos utilizando un origen de datos de Amazon Athena existente, utilice el siguiente procedimiento.

**Creación de un conjunto de datos a partir de un perfil de conexión de Athena existente**

1. En la página de inicio rápido de Amazon, selecciona **Datos**.

1. Selecciona **Crear** y, a continuación, selecciona **Nuevo conjunto de datos**.

   Elija el icono del perfil de conexión de la fuente de datos existente que desee utilizar. Los perfiles de conexión se etiquetan con el icono del origen de datos y el nombre proporcionados por la persona que creó la conexión.

1. Elija **Crear conjunto de datos**.

   Amazon Quick crea un perfil de conexión para esta fuente de datos basándose únicamente en el grupo de trabajo de Athena. La base de datos y la tabla no se guardan. 

1. En la pantalla **Elija su tabla**, haga una de estas acciones:
   + Para escribir una consulta SQL, seleccione **Usar consulta SQL personalizada**.
   + Para elegir una base de datos y una tabla, primero seleccione la base de datos en la lista **Bases de datos**. A continuación, elija una tabla de la lista que aparece para la base de datos.

## Crear un conjunto de datos utilizando un origen de datos de Salesforce existente
<a name="create-a-data-set-existing-salesforce"></a>

Utilice el siguiente procedimiento para crear un conjunto de datos utilizando un origen de datos de Salesforce existente.

**Creación de un conjunto de datos utilizando un origen de datos de Salesforce existente**

1. En la página de inicio rápido de Amazon, selecciona **Datos**.

1. Selecciona **Crear** y, a continuación, selecciona **Nuevo conjunto de datos**.

1. Elija la fuente de datos de Salesforce que desee utilizar.

1. Elija **Crear conjunto de datos**.

1. Seleccione una de las siguientes opciones:
   + **SQL personalizada**

     En la siguiente pantalla, puede elegir escribir una consulta con la opción **Usar consulta SQL personalizada**. Al hacer esto se abre una pantalla llamada **Escriba la consulta SQL personalizada**, donde podrá escribir el nombre de la consulta y escribir, a continuación, la SQL. Para obtener los mejores resultados, cree la consulta en un editor de SQL y, a continuación, péguela en esta ventana. Después de asignar el nombre y de escribir la consulta, puede elegir **Editar/obtener vista previa de los datos** o **Confirmar consulta**. Elija **Editar/obtener vista previa de los datos** para ir de forma inmediata a la preparación de datos. Elija **Confirmar consulta** para validar la SQL y asegurarse de que no haya errores.
   + **Elección de tablas**

     Para conectarse a tablas específicas, en **Elementos de datos: contiene los datos**, elija **Seleccionar** y, a continuación, seleccione **INFORME** u **OBJETO**. 

     Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos. Utilice esta opción si desea unirse a más tablas.

     De lo contrario, después de elegir una tabla, elija **Seleccionar**.

1. En la siguiente pantalla, elija una de las opciones siguientes:
   + Para crear un conjunto de datos y un análisis utilizando los datos tal y como están, elija **Visualizar**.
**nota**  
Si no tiene suficiente capacidad [SPICE](spice.md) suficiente, elija **Editar/obtener vista previa de los datos**. En la preparación de los datos, puede eliminar los campos del conjunto de datos para reducir su tamaño o aplicar un filtro que reduzca el número de filas devueltas. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos para el informe u objeto seleccionado. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).

## Creación de un conjunto de datos utilizando un origen de datos de base de datos existente
<a name="create-a-data-set-existing-database"></a>

Utilice el siguiente procedimiento para crear un conjunto de datos utilizando un origen de datos de base de datos existente.

**Creación de un conjunto de datos utilizando un origen de datos de base de datos existente**

1. En la página de inicio rápido de Amazon, selecciona **Datos**.

1. Selecciona **Crear** y, a continuación, selecciona **Nuevo conjunto de datos**.

1. Elija la fuente de datos de la base de datos que desee utilizar y, a continuación, elija **Crear conjunto de datos**.

1. Seleccione una de las siguientes opciones:
   + **SQL personalizada**

     En la siguiente pantalla, puede elegir escribir una consulta con la opción **Usar consulta SQL personalizada**. Al hacer esto se abre una pantalla llamada **Escriba la consulta SQL personalizada**, donde podrá escribir el nombre de la consulta y escribir, a continuación, la SQL. Para obtener los mejores resultados, cree la consulta en un editor de SQL y, a continuación, péguela en esta ventana. Después de asignar el nombre y de escribir la consulta, puede elegir **Editar/obtener vista previa de los datos** o **Confirmar consulta**. Elija **Editar/obtener vista previa de los datos** para ir de forma inmediata a la preparación de datos. Elija **Confirmar consulta** para validar la SQL y asegurarse de que no haya errores.
   + **Elección de tablas**

     Para conectarse a tablas específicas, en **Esquema: contiene conjuntos de tablas**, elija **Seleccionar** y, a continuación, elija un esquema. En algunos casos en los que no hay un único esquema en la base de datos, dicho esquema se elige de forma automática, en cuyo caso la opción de selección de esquema no se muestra.

     Para preparar los datos antes de crear un análisis, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos. Utilice esta opción si desea unirse a más tablas.

     De lo contrario, después de elegir una tabla, elija **Seleccionar**.

1. Elija una de las siguientes opciones:
   + Prepare los datos antes de crear un análisis. Para ello, elija **Editar/obtener vista previa de los datos** para abrir la preparación de datos para la tabla seleccionada. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Cree un conjunto de datos y un análisis mediante los datos de la tabla tal cual e importe los datos del conjunto de datos en [SPICE](spice.md) para mejorar el rendimiento (recomendado). Para ello, verifique el indicador SPICE para ver si tiene suficiente espacio.

     Si tiene suficiente capacidad de SPICE, elija el botón de opción **Importar a SPICE para agilizar el análisis** y, a continuación, cree un análisis eligiendo **Visualizar**.
**nota**  
Si desea utilizar SPICE y no tiene espacio suficiente, elija **Editar/obtener vista previa de los datos**. En la preparación de datos, puede quitar campos del conjunto de datos para reducir su tamaño. También puede aplicar un filtro o escribir una consulta SQL que reduzca el número de filas o columnas devueltas. Para obtener más información sobre la preparación de datos, consulte [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md).
   + Cree un conjunto de datos y un análisis mediante los datos de tabla tal cual y realice consultas en los datos directamente desde la base de datos. Para hacerlo, elija **Realizar una consulta directamente sobre los datos**. A continuación, cree un análisis seleccionando **Visualizar**.

# Crear un conjunto de datos a partir de un conjunto de datos existente en Amazon Quick
<a name="create-a-dataset-existing-dataset"></a>

Después de crear un conjunto de datos en Amazon Quick, puede crear conjuntos de datos adicionales utilizándolos como fuente. Al hacerlo, se conserva cualquier preparación de datos que contenga el conjunto de datos principal, como las uniones o los campos calculados. Puede añadir una preparación adicional a los datos de los nuevos conjuntos de datos secundarios, como unir nuevos datos y filtrarlos. También puede configurar su propia programación de actualización de datos para el conjunto de datos secundario y realizar un seguimiento de los paneles y análisis que lo utilizan.

Los conjuntos de datos secundarios que se crean con un conjunto de datos con reglas de RLS activas como origen heredan las reglas de RLS del conjunto de datos principal. Los usuarios que crean un conjunto de datos secundario a partir de un conjunto de datos principal más grande solo pueden ver los datos a los que tienen acceso en el conjunto de datos principal. A continuación, puede añadir más reglas de RLS al nuevo conjunto de datos secundario, además de las reglas de RLS heredadas, para administrar mejor quién puede acceder a los datos que se encuentran en el nuevo conjunto de datos. Solo puede crear conjuntos de datos secundarios a partir de conjuntos de datos con reglas de RLS activas en Direct Query.

La creación de conjuntos de datos a partir de conjuntos de datos rápidos existentes tiene las siguientes ventajas:
+ **Administración central de los conjuntos de datos**: los ingenieros de datos pueden escalar fácilmente según las necesidades de varios equipos de su organización. Para ello, pueden desarrollar y mantener algunos conjuntos de datos de uso general que describan los principales modelos de datos de la organización.
+ **Reducción de la administración de las fuentes de datos**: los analistas de negocios (BAs) suelen dedicar mucho tiempo y esfuerzo a solicitar acceso a las bases de datos, gestionar las credenciales de las bases de datos, encontrar las tablas adecuadas y gestionar los programas de actualización rápida de datos. Crear nuevos conjuntos de datos a partir de conjuntos de datos existentes significa que BAs no es necesario empezar desde cero con datos sin procesar de las bases de datos. Pueden empezar con datos seleccionados.
+ **Métricas clave predefinidas**: al crear conjuntos de datos a partir de conjuntos de datos existentes, los ingenieros de datos pueden definir y mantener de forma centralizada las definiciones de datos críticos en las numerosas organizaciones de su empresa. Algunos ejemplos podrían ser el crecimiento de las ventas y la tasa de retorno marginal neto. Con esta característica, los ingenieros de datos también pueden distribuir los cambios en esas definiciones. Este enfoque significa que sus analistas empresariales pueden empezar a visualizar los datos correctos de forma más rápida y fiable.
+ **Flexibilidad para personalizar los datos**: al crear conjuntos de datos a partir de conjuntos de datos existentes, los analistas empresariales tienen más flexibilidad para personalizar los conjuntos de datos según sus propias necesidades empresariales. No tienen que preocuparse por interrumpir los datos de otros equipos.

Por ejemplo, supongamos que forma parte de un equipo central de comercio electrónico formado por cinco ingenieros de datos. Usted y su equipo tendrán acceso a los datos de ventas, pedidos, cancelaciones y devoluciones en una base de datos. Ha creado un conjunto de datos rápido uniendo otras 18 tablas de dimensiones mediante un esquema. Una métrica clave que ha creado su equipo es el campo calculado de ventas de productos pedidos (OPS). Su definición es la siguiente: OPS = cantidad de producto x precio.

Su equipo trabaja con más de 100 analistas empresariales repartidos en 10 equipos diferentes en ocho países. Estos son el equipo de Cupones, el equipo de Marketing de salida, el equipo de Plataformas móviles y el equipo de Recomendaciones. Todos estos equipos utilizan la métrica OPS como base para analizar su propia línea de negocio.

En lugar de crear y mantener manualmente cientos de conjuntos de datos desconectados, su equipo reutiliza los conjuntos de datos para crear varios niveles de conjuntos de datos para los equipos de toda la organización. Esto centraliza la administración de datos y permite a cada equipo personalizar los datos según sus propias necesidades. Al mismo tiempo, se sincronizan las actualizaciones de los datos, así como las actualizaciones de las definiciones de las métricas, y se mantiene la seguridad en el nivel de fila y columna. Por ejemplo, los equipos individuales de su organización pueden usar los conjuntos de datos centralizados. A continuación, pueden combinarlos con los datos específicos de su equipo para crear nuevos conjuntos de datos y elaborar análisis a partir de ellos.

Además de utilizar la métrica clave OPS, otros equipos de su organización pueden reutilizar los metadatos de las columnas de los conjuntos de datos centralizados que creó. Por ejemplo, el equipo de Ingeniería de datos puede definir los metadatos, como el *nombre*, la *descripción*, el *tipo de datos* y las *carpetas*, en un conjunto de datos centralizado. Todos los equipos subsiguientes podrán utilizarlos.

**nota**  
Amazon Quick admite la creación de hasta dos niveles adicionales de conjuntos de datos a partir de un único conjunto de datos.  
Por ejemplo, a partir de un conjunto de datos principal, puede crear un conjunto de datos secundario y, a continuación, un conjunto de datos secundario del secundario para un total de tres niveles de conjunto de datos.

## Crear un conjunto de datos a partir de un conjunto de datos existente
<a name="create-a-dataset-existing-dataset-how-to"></a>

Utilice el siguiente procedimiento para crear un conjunto de datos desde un conjunto de datos existente.

**Creación de un conjunto de datos a partir de un conjunto de datos existente**

1. En la página de inicio rápido, elija **Datos** en el panel de la izquierda.

1. Elija **Crear** y, a continuación, elija el conjunto de datos que desee usar para crear un conjunto de datos nuevo.

1. En la página que se abre para ese conjunto de datos, seleccione el menú desplegable de **Uso en el análisis** y, a continuación, seleccione **Uso en el conjunto de datos**.

   La página de preparación de datos se abre y carga previamente todo el conjunto de datos principal, incluidos los campos calculados, las uniones y la configuración de seguridad.

1. En la página de preparación de datos que se abre, en el **Modo de consulta**, en la parte inferior izquierda, elija cómo desea que el conjunto de datos incorpore los cambios y actualizaciones del conjunto de datos principal original. Puede elegir las opciones siguientes: 
   + **Consulta directa**: este es el modo de consulta predeterminado. Si elige esta opción, los datos de este conjunto de datos se actualizan automáticamente al abrir un conjunto de datos, un análisis o un panel asociado. Sin embargo, se aplican las siguientes limitaciones:
     + Si el conjunto de datos principal permite realizar consultas directas, puede usar el modo de consulta directa en el conjunto de datos secundario.
     + Si tiene varios conjuntos de datos principales en una combinación, puede elegir el modo de consulta directa para el conjunto de datos secundario solo si todos los conjuntos de datos principales provienen del mismo origen de datos subyacente. Por ejemplo, la misma conexión de Amazon Redshift.
     + La consulta directa es compatible con un único conjunto de datos principal de SPICE. No es compatible con varios conjuntos de datos principales de SPICE en una unión.
   + **SPICE**: Si elige esta opción, puede configurar una programación para que su nuevo conjunto de datos se sincronice con el conjunto de datos principal. Para obtener más información sobre cómo crear programaciones de actualización para conjuntos de datos de SPICE, consulte [Actualización de datos en SPICE](refreshing-imported-data.md).

1. (Opcional) Prepare los datos para el análisis. Para obtener más información sobre cómo preparar datos, consulte [Preparación de datos en Amazon Quick Sight](preparing-data.md).

1. (Opcional) Configure la seguridad en el nivel de fila o columna (RLS/CLS) para restringir el acceso al conjunto de datos. Para obtener más información sobre la configuración de RLS, consulte [Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datosUso de reglas basadas en usuarios](restrict-access-to-a-data-set-using-row-level-security.md). Para obtener más información sobre la configuración de CLS, consulte [Uso de la seguridad en el nivel de columna para restringir el acceso a un conjunto de datos](restrict-access-to-a-data-set-using-column-level-security.md).
**nota**  
Puedes configurarlo solo RLS/CLS en conjuntos de datos secundarios. RLS/CLS no se admite en los conjuntos de datos principales.

1. Cuando haya terminado, elija **Guardar y publicar** para guardar los cambios y publicar el nuevo conjunto de datos secundario. O elija **Publicar y visualizar** para publicar el nuevo conjunto de datos secundario y empezar a visualizar sus datos. 

# Impedir que otros usuarios creen nuevos conjuntos de datos a partir de su conjunto de datos
<a name="restrict-create-dataset"></a>

Al crear un conjunto de datos en Amazon Quick, puede impedir que otros lo utilicen como fuente para otros conjuntos de datos. Puede especificar si otras personas pueden usarlo para crear algún conjunto de datos. También puede especificar el tipo de conjuntos de datos que otros usuarios pueden o no pueden crear a partir de su conjunto de datos, como conjuntos de datos de consulta directa o conjuntos de datos de SPICE.

Use el siguiente procedimiento para obtener información sobre cómo impedir que otras personas creen nuevos conjuntos de datos a partir de su conjunto de datos.

**Restricción de otros usuarios para que no creen nuevos conjuntos de datos a partir de su conjunto de datos**

1. En la página de inicio rápido, selecciona **Datos** en el panel de la izquierda.

1. Elija **Crear** y, a continuación, elija el conjunto de datos desde el que desea restringir la creación de nuevos conjuntos de datos.

1. En la página que se abre para ese conjunto de datos, seleccione **Editar conjunto de datos**.

1. En la página de preparación de datos que se abre, seleccione **Administrar** en la esquina superior derecha y, a continuación, seleccione **Propiedades**.

1. En el panel **Propiedades del conjunto de datos** que se abre, elija una de las siguientes opciones:
   + Para impedir que cualquier persona cree cualquier tipo de conjunto de datos nuevo a partir de este conjunto de datos, desactive **Permitir la creación de nuevos conjuntos de datos a partir de este conjunto de datos**.

     El conmutador es azul cuando se permite crear nuevos conjuntos de datos. Está gris cuando no se permite crear nuevos conjuntos de datos.
   + Para impedir que otros usuarios creen conjuntos de datos de consulta directa, desactive **Permitir consulta directa**.
   + Para impedir que otras personas creen copias de SPICE de su conjunto de datos, desactive **Permitir copias de SPICE**.

     Para obtener más información sobre los conjuntos de datos de SPICE, consulte [Importación de datos en SPICE](spice.md).

1. Cierre el panel.

# Edición de conjuntos de datos
<a name="edit-a-data-set"></a>

Puede editar un conjunto de datos existente para realizar la preparación de los datos. Para obtener más información sobre la funcionalidad de preparación de datos de Quick Sight, consulte[Preparación de datos en Amazon Quick Sight](preparing-data.md).

Puede abrir un conjunto de datos para editarlos desde la página **Conjuntos de datos** o desde la página de análisis. Editar un conjunto de datos desde una de estas ubicaciones modifica el conjunto de datos para todos los análisis que lo utilizan.

## Aspectos que se deben tener en cuenta al editar conjuntos de datos
<a name="change-a-data-set"></a>

Hay dos situaciones en las que los cambios en un conjunto de datos podrían provocar problemas. Una es si se edita deliberadamente el conjunto de datos. La otra es el hecho de que el origen de datos haya cambiado tanto que afecte al análisis basado en él. 

**importante**  
Los análisis que están en uso de producción deben protegerse para que sigan funcionando correctamente. 

Recomendamos lo siguiente cuando se ocupe de los cambios de datos:
+ Documente los orígenes de datos y los conjuntos de datos, así como los elementos visuales que se basan en ellos. La documentación debe incluir capturas de pantalla, los campos utilizados, la ubicación en cuadros de campos, filtros, clasificaciones, cálculos, colores, formato, etc. Registre todo lo que necesite para recrear el elemento visual. También puede realizar un seguimiento de los recursos de Quick Sight que utilizan un conjunto de datos en las opciones de administración del conjunto de datos. Para obtener más información, consulte [Tableros de control y análisis de seguimiento que utilizan un conjunto de datos](track-analytics-that-use-dataset.md).
+ Cuando edite un conjunto de datos, no intente hacer cambios que puedan hacer que los elementos visuales existentes dejen de funcionar. Por ejemplo, no elimine columnas que se estén utilizando en un elemento visual. Si tiene que eliminar una columna, cree una columna calculada en su lugar. La columna de sustitución debe tener el mismo nombre y tipo de datos que el original. 
+ Si el origen de datos o el conjunto de datos cambian en la base de datos de origen, adapte su elemento visual para posibilitar el cambio, tal y como se ha descrito anteriormente. O puede tratar de adaptar la base de datos de origen. Por ejemplo, podría crear una vista de la tabla de origen (documento). Así, si la tabla cambia, puede ajustar la vista para incluir o excluir columnas (atributos), cambiar los tipos de datos, completar valores nulos, etc. O, en otro caso, si el conjunto de datos se basa en una consulta SQL lenta, podría crear una tabla para almacenar los resultados de la consulta. 

  Si no puede adaptar suficientemente el origen de los datos, vuelva a crear los elementos visuales basándose en su documentación de análisis.
+ Si ya no tiene acceso a un origen de datos, los análisis basados en dicho origen estarán vacíos. Los elementos visuales que creó seguirán existiendo, pero no se podrán mostrar hasta que tengan datos que mostrar. Esto puede ocurrir si el administrador modifica los permisos.
+ Si elimina el conjunto de datos en el que se basa en un elemento visual, es posible que tenga que volver a crearlo a partir de su documentación. Puede editar el elemento visual y seleccionar un nuevo conjunto de datos para utilizarlo con él. Si tiene que utilizar de forma coherente un nuevo archivo para sustituir a uno más antiguo, almacene sus datos en una ubicación que esté disponible siempre. Por ejemplo, puede almacenar su archivo.csv en Amazon S3 y crear un conjunto de datos de S3 para usarlo para sus elementos visuales. Para obtener más información sobre cómo acceder a los archivos almacenados en S3, consulte [Creación de un conjunto de datos utilizando archivos de Amazon S3](create-a-data-set-s3.md). 

  También puede importar los datos en una tabla y basar su objeto visual en una consulta. De esta forma, las estructuras de datos no cambian, aunque cambien los datos contenidos en ellas.
+ Para centralizar la administración de datos, considere la posibilidad de crear conjuntos de datos generales y multifunción que otros puedan usar para crear sus propios conjuntos de datos. Para obtener más información, consulte [Crear un conjunto de datos a partir de un conjunto de datos existente en Amazon Quick](create-a-dataset-existing-dataset.md).

## Edición de un conjunto de datos desde la página Conjuntos de datos
<a name="edit-a-data-set-data"></a>

1. En la página de inicio rápido, elija **Datos** a la izquierda.

1. En la página de **datos** que se abre, elige el conjunto de datos que deseas editar y, a continuación, selecciona **Editar conjunto de datos** en la esquina superior derecha.

   Se abre la página de preparación de datos. Para obtener más información sobre los tipos de ediciones que puede hacer en los conjuntos de datos, consulte [Preparación de datos en Amazon Quick Sight](preparing-data.md).

## Edición de un conjunto de datos en un análisis
<a name="edit-a-data-set-analysis"></a>

Utilice el siguiente procedimiento para editar un conjunto de datos desde la página de análisis.

**Edición de un conjunto de datos desde la página de análisis**

1. En su análisis, haga clic en el icono de lápiz de la parte superior del panel **Lista de campos**.

1. En la página **Conjuntos de datos en este análisis** que se abre, elija los tres puntos a la derecha del conjunto de datos que desee editar y, a continuación, elija **Editar**.

   El conjunto de datos se abre en la página de preparación de datos. Para obtener más información sobre los tipos de modificaciones que puede hacer en los conjuntos de datos, consulte [Preparación de datos en Amazon Quick Sight](preparing-data.md).

# Revertir los conjuntos de datos a versiones publicadas anteriores
<a name="dataset-versioning"></a>

Al guardar y publicar los cambios en un conjunto de datos en Amazon Quick Sight, se crea una nueva versión del conjunto de datos. En cualquier momento, puede ver una lista de todas las versiones publicadas anteriormente de ese conjunto de datos. También puede previsualizar una versión específica de ese historial o incluso revertir el conjunto de datos a una versión anterior, si es necesario.

Las limitaciones siguientes son aplicables al control de versiones del conjunto de datos:
+ Solo las 1000 versiones más recientes de un conjunto de datos se muestran en el historial de publicación y están disponibles para el control de versiones.
+ Cuando supere las 1000 versiones publicadas, las versiones más antiguas se eliminan automáticamente del historial de publicaciones y el conjunto de datos ya no se puede revertir a ellas.

Utilice el siguiente procedimiento para revertir un conjunto de datos a una versión publicada anterior.

**Reversión de un conjunto de datos a una versión publicada anterior**

1. En la página de inicio rápido, elija **Datos**.

1. En la página de **datos**, elige un conjunto de datos y, a continuación, selecciona **Editar conjunto de datos** en la esquina superior derecha.

   Para obtener más información acerca de la edición de conjuntos de datos, consulte [Edición de conjuntos de datos](edit-a-data-set.md).

1. En la página de preparación del conjunto de datos que se abre, elija el icono **Administrar** en la barra de herramientas azul situada en la parte superior derecha y, a continuación, seleccione **Historial de publicación**.

   A la derecha aparece una lista de las versiones anteriores publicadas.

1. En el panel **Historial de publicación**, busque la versión que desee y elija **Revertir**.

   Para obtener una vista previa de la versión antes de revertirla, seleccione **Vista previa**.

   El conjunto de datos se revierte y aparece un mensaje de confirmación. El panel **Historial de publicación** también se actualiza para mostrar la versión activa del conjunto de datos.

## Solución de problemas de la reversión de versiones
<a name="dataset-versioning-troubleshooting"></a>

A veces, el conjunto de datos no se puede revertir a una versión específica por uno de los siguientes motivos:
+ El conjunto de datos usa uno o más orígenes de datos que se eliminaron.

  Si se produce este error, no puede revertir el conjunto de datos a una versión anterior.
+ Si se revierte, un campo calculado no sería válido.

  Si se produce este error, puede editar o eliminar el campo calculado y, a continuación, guardar el conjunto de datos. De esta forma, se crea una versión nueva del conjunto de datos.
+ Faltan una o más columnas en el origen de datos.

  Si se produce este error, Quick Sight muestra el esquema más reciente de la fuente de datos en la vista previa para conciliar las diferencias entre las versiones. Todos los cambios en el campo calculado, el nombre de campo, el tipo de campo y el filtro que se muestran en la vista previa del esquema corresponden a la versión a la que desea volver. Puede guardar este esquema conciliado como una nueva versión del conjunto de datos. O bien, puede volver a la versión activa (más reciente) seleccionando **Vista previa** en la versión superior (más reciente) del historial de publicación.

# Duplicación de conjuntos de datos
<a name="duplicate-a-data-set"></a>

Puede duplicar un conjunto de datos existente para guardar una copia de este con un nuevo nombre. El nuevo conjunto de datos es una copia totalmente independiente. 

La opción **Duplicar conjunto de datos** está disponible si se cumplen las dos condiciones siguientes: usted es el propietario del conjunto de datos y tiene permiso para el origen de datos.

**Duplicación de un conjunto de datos**

1. En la página de inicio rápido, selecciona **Datos** a la izquierda.

1. Elige el conjunto de datos que deseas duplicar.

1. En la página de detalles del conjunto de datos que se abre, selecciona el menú desplegable **Editar conjunto** de datos y, a continuación, selecciona **Duplicar**.

1. En la página del conjunto de datos duplicados que se abre, asígnele un nombre al conjunto de datos duplicado y, a continuación, elija **Duplicar**.

   Se abrirá la página de detalles del conjunto de datos duplicado. Desde esta página, puede editar el conjunto de datos, configurar una programación de actualización y mucho más.

# Compartir conjuntos de datos
<a name="sharing-data-sets"></a>

Puede dar acceso a un conjunto de datos a otros usuarios y grupos de Quick Sight si lo comparte con ellos. A continuación, pueden crear análisis a partir de ellos. Si los convierte en copropietarios, también pueden actualizar, editar, eliminar o volver a compartir el conjunto de datos. 

## Compartir un conjunto de datos
<a name="share-a-data-set"></a>

Si tiene permisos de propietario sobre un conjunto de datos, utilice el siguiente procedimiento para compartirlo.

**Uso compartido de un conjunto de datos**

1. En la página de inicio rápido, seleccione **Datos** a la izquierda.

1. En la página de **datos**, elige el conjunto de datos que quieres compartir.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Permisos** y, a continuación, seleccione **Agregar usuarios y grupos**.

1. Escriba el usuario o grupo con el que desee compartir este conjunto de datos y seleccione **Agregar**. Solo puedes invitar a usuarios que pertenezcan a la misma cuenta de Quick.

   Repita este paso hasta que haya escrito la información de todas las personas con las que quiere compartir el conjunto de datos.

1. En la columna **Permiso**, elija un rol para cada usuario o grupo para concederle permiso en el conjunto de datos.

   Elija **Espectador** para permitir que el usuario cree análisis a partir del conjunto de datos. Elija **Propietario** para permitir que el usuario haga eso y también pueda actualizar, editar, eliminar y volver a compartir el conjunto de datos.

   Los usuarios reciben correos electrónicos con un enlace al conjunto de datos. Los grupos no reciben correos electrónicos de invitación.

# Ver y editar los permisos de usuarios con los que se comparte un conjunto de datos
<a name="view-users-data-set"></a>

Si tiene permisos de propietario sobre un conjunto de datos, puede utilizar el siguiente procedimiento para ver, editar o cambiar el acceso de usuario a él. 

**Visualización, edición o cambio del acceso de los usuarios a un conjunto de datos si tiene permisos de propietario para ello**

1. En la página de inicio rápido, selecciona **Datos** a la izquierda.

1. En la página de **datos**, elige el conjunto de datos que quieres compartir.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Permisos**.

   Aparece una lista de todos los usuarios y grupos con acceso al conjunto de datos.

1. (Opcional) Para cambiar los roles de permisos de un usuario o grupo, seleccione el menú desplegable de la columna **Permisos** del usuario o grupo. A continuación, elija **Espectador** o **Propietario**.

# Revocación del acceso a un conjunto de datos
<a name="revoke-access-to-a-data-set"></a>

Si tiene permisos de propietario sobre un conjunto de datos, puede utilizar el siguiente procedimiento para revocar el acceso de los usuarios a un conjunto de datos.

**Revocación del acceso de los usuarios a un conjunto de datos si tiene permisos de propietario para ello**

1. En la página de inicio rápido, selecciona **Datos** a la izquierda.

1. En la página de **datos**, elige el conjunto de datos que quieres compartir.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Permisos**.

   Aparece una lista de todos los usuarios y grupos con acceso al conjunto de datos.

1. En la columna **Acciones** del usuario o grupo, elija **Revocar acceso**.

# Tableros de control y análisis de seguimiento que utilizan un conjunto de datos
<a name="track-analytics-that-use-dataset"></a>

Al crear un conjunto de datos en Quick Sight, puede realizar un seguimiento de los paneles y análisis que utilizan ese conjunto de datos. Este enfoque resulta útil cuando quiere ver qué recursos se verán afectados al realizar cambios en un conjunto de datos o si desea eliminar un conjunto de datos. 

Utilice el siguiente procedimiento para ver qué paneles y análisis utilizan un conjunto de datos.

**Seguimiento de los recursos que utilizan un conjunto de datos**

1. En la página de inicio rápido, elija **Datos** en el panel de la izquierda.

1. En la página **de datos**, elige el conjunto de datos del que deseas realizar un seguimiento de los recursos.

1. En la página que se abre para ese conjunto de datos, seleccione **Editar conjunto de datos**.

1. En la página de preparación de datos que se abre, seleccione **Administrar** en la parte superior derecha y, a continuación, seleccione **Uso**.

1. Los paneles y los análisis que utilizan el conjunto de datos aparecen en el panel que se abre.

# Uso de parámetros de conjuntos de datos en Amazon Quick
<a name="dataset-parameters"></a>

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
<a name="dataset-parameters-limitations"></a>

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
<a name="dataset-parameters-SQL"></a>

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
<a name="dataset-parameters-insert-parameter"></a>

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
<a name="dataset-parameters-calculated-fields"></a>

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
<a name="dataset-parameters-dataset-filters"></a>

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
<a name="dataset-parameters-analysis"></a>

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
<a name="dataset-parameters-map-to-analysis"></a>

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
<a name="dataset-parameters-analysis-filter-control"></a>

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
<a name="dataset-parameters-advanced-options"></a>

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
<a name="dataset-parameters-dropdown"></a>

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”
<a name="dataset-parameters-controls-select-all"></a>

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
<a name="dataset-parameters-controls-multi-select-all"></a>

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.

# Uso de la seguridad a nivel de fila en Amazon Quick
<a name="row-level-security"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

En la edición empresarial de Amazon Quick, puede restringir el acceso a un conjunto de datos configurando la seguridad a nivel de fila (RLS) en él. Puede hacerlo antes o después de haber compartido el conjunto de datos. Cuando comparte un conjunto de datos con RLS con los propietarios del conjunto de datos, ellos pueden seguir viendo todos los datos. Sin embargo, cuando lo comparte con los lectores, solo pueden ver los datos restringidos por las reglas del conjunto de datos de permiso.

Además, al incrustar paneles de Amazon Quick en su aplicación para los usuarios no registrados de Quick, puede utilizar la seguridad de nivel de fila (RLS) para los datos con etiquetas. filter/restrict Una etiqueta es una cadena especificada por el usuario que identifica una sesión en su aplicación. Puede usar etiquetas para implementar controles de RLS para sus conjuntos de datos. Al configurar las restricciones basadas en el RLS en los conjuntos de datos, Quick filtra los datos en función de las etiquetas de sesión vinculadas a la identidad o sesión del usuario.

Puede restringir el acceso a un conjunto de datos mediante reglas basadas en nombres de usuario o grupos, reglas basadas en etiquetas o ambas.

Elija reglas basadas en el usuario si desea proteger los datos de los usuarios o grupos aprovisionados (registrados) en Quick. Para ello, seleccione un conjunto de datos de permisos que contenga reglas establecidas por columnas para cada usuario o grupo que acceda a los datos. Solo los usuarios o grupos identificados en las reglas tienen acceso a los datos.

Elija reglas basadas en etiquetas solo si utiliza paneles integrados y desea proteger los datos de los usuarios no aprovisionados (usuarios no registrados) en Quick. Para ello, defina etiquetas en las columnas para proteger los datos. Los valores de las etiquetas deben pasarse al incrustar los paneles.

**Topics**
+ [Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datos](restrict-access-to-a-data-set-using-row-level-security.md)
+ [Uso de seguridad a nivel de fila con reglas basadas en etiquetas para restringir el acceso a un conjunto de datos al incrustar paneles para usuarios anónimos](quicksight-dev-rls-tags.md)

# Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datos
<a name="restrict-access-to-a-data-set-using-row-level-security"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

En la edición empresarial de Amazon Quick, puede restringir el acceso a un conjunto de datos configurando la seguridad a nivel de fila (RLS) en él. Puede hacerlo antes o después de haber compartido el conjunto de datos. Cuando comparte un conjunto de datos con RLS con los propietarios del conjunto de datos, ellos pueden seguir viendo todos los datos. Sin embargo, cuando lo comparte con los lectores, solo pueden ver los datos restringidos por las reglas del conjunto de datos de permiso. Puede controlar aún más su acceso añadiendo seguridad de nivel de fila.

**nota**  
Al aplicar los conjuntos de datos de SPICE a la seguridad de nivel de fila, cada campo del conjunto de datos puede contener hasta 2047 caracteres Unicode. Los campos que contienen más que esta cuota se truncan durante la incorporación de datos. Para obtener más información sobre las cuotas de datos de SPICE, consulte [Cuotas de SPICE para los datos importados](data-source-limits.md#spice-limits).

Para ello, debe crear una consulta o un archivo con una columna para la identificación del usuario o del grupo. Puede utilizar `UserName` y o`GroupName`, alternativamente, `UserARN` y`GroupARN`. También puede considerarlo como si fuera la *adición de una regla* para ese usuario o grupo. A continuación, puede añadir una columna a la consulta o al archivo para cada campo al que desee conceder o restringir el acceso. Para cada nombre de usuario o grupo que añada, debe añadir los valores de cada campo. Puede utilizar NULL (sin valor), lo que significa “todos los valores”. Para ver ejemplos de reglas de conjunto de datos, consulte [Creación de reglas de conjunto de datos para seguridad de nivel de fila](#create-data-set-rules-for-row-level-security).

Para aplicar las reglas del conjunto de datos, añada al conjunto de datos las reglas como un conjunto de datos de permisos. Tenga en cuenta los siguientes puntos:
+ El conjunto de datos de permisos no pueden contener valores duplicados. Los valores duplicados no se tienen en cuenta cuando se evalúa el modo de aplicar las reglas.
+ Cada usuario o grupo especificado solo podrá ver las filas que *coincidan* con los valores de los campos de las reglas del conjunto de datos. 
+ Si añade una regla para un usuario o grupo y deja el resto de las columnas sin valor (NULL), le concederá acceso a todos los datos. 
+ Si no añade una regla para un usuario o grupo, ese usuario o grupo no podrá ver ningún dato. 
+ El conjunto completo de registros de reglas que se aplican por usuario no debe superar los 999. Esta limitación se aplica al número total de reglas asignadas directamente a un nombre de usuario más las reglas asignadas al usuario a través de nombres de grupos. 
+ Si un campo incluye una coma (), Amazon Quick trata cada palabra separada de otra por una coma como un valor individual del filtro. Por ejemplo, en `('AWS', 'INC')`, `AWS,INC` se considera como dos cadenas: `AWS` y `INC`. Para filtrar con `AWS,INC`, escriba la cadena entre comillas dobles en el conjunto de datos de permisos. 

  Si el conjunto de datos restringido es un conjunto de datos de SPICE, el número de valores de filtro aplicados por usuario no puede superar los 192 000 por cada campo restringido. Esto se aplica al número total de reglas asignadas directamente a un nombre de usuario, más los valores de filtro asignados al usuario a través de nombres de grupos.

  Si el conjunto de datos restringido es un conjunto de datos de consulta directa, la cantidad de valores de filtro aplicados por usuario varía según el origen de datos.

  Si se supera el límite del valor del filtro, es posible que se produzca un error en la representación del elemento visual. Le recomendamos añadir una columna adicional al conjunto de datos restringido para dividir las filas en grupos en función de la columna restringida original, de forma que se pueda acortar la lista de filtros.

Amazon Quick trata los espacios como valores literales. Si tiene un espacio en un campo que está restringiendo, la regla del conjunto de datos se aplica a estas filas. Amazon Quick trata NULLs tanto los espacios en blanco como los espacios en blanco (cadenas vacías «») como «sin valor». Un valor NULL es un valor de campo vacío. 

En función del origen de datos del que provenga el conjunto de datos, puede configurar una consulta directa para el acceso a una tabla de permisos. No es necesario delimitar con comillas los términos que contengan espacios. Si utiliza una consulta directa, puede cambiar fácilmente la consulta en el origen de datos original. 

Puede cargar reglas de conjunto de datos desde un archivo de texto o una hoja de cálculo. Si utiliza un archivo de valores separados por comas (CSV), no incluya espacios en la línea correspondiente. Es necesario delimitar con comillas los términos que contengan espacios. Si utiliza reglas de conjunto de datos basadas en archivos, aplique los cambios sobrescribiendo las reglas existentes en la configuración de permisos del conjunto de datos.

Los conjuntos de datos restringidos se marcan con la palabra **RESTRINGIDOS** en la pantalla de **datos**.

Los conjuntos de datos secundarios que se crean a partir de un conjunto de datos principal que tiene las reglas de RLS activas conservan las mismas reglas de RLS que tiene el conjunto de datos principal. Puede añadir más reglas de RLS al conjunto de datos secundario, pero no puede eliminar las reglas de RLS que el conjunto de datos hereda del conjunto de datos principal. 

Los conjuntos de datos secundarios que se crean a partir de un conjunto de datos principal que tiene las reglas de RLS activas solo se pueden crear con Direct Query. SPICE no admite los conjuntos de datos secundarios que heredan las reglas de RLS del conjunto de datos principal.

La seguridad a nivel de fila solo funciona con campos que contienen datos de texto (string, char, varchar, etc.). Actualmente no funciona en campos de fecha o numéricos. La detección de anomalías no se admite para conjuntos de datos que utilizan la seguridad a nivel de fila (RLS).

## Creación de reglas de conjunto de datos para seguridad de nivel de fila
<a name="create-data-set-rules-for-row-level-security"></a>

Utilice el siguiente procedimiento para crear un archivo de permisos o una consulta que usar como reglas de conjunto de datos.

**Creación de un archivo de permisos o una consulta para usarlos como reglas de conjunto de datos**

1. Cree un archivo o una consulta que contenga las reglas del conjunto de datos (permisos) para la seguridad de nivel de fila (RLS). 

   No importa el orden en que aparezcan los campos. No obstante, en todos los campos se distingue entre mayúsculas y minúsculas. Asegúrese de que coiciden con los nombres y valores del campo. 

   La estructura debería tener un aspecto similar a una de las siguientes. Asegúrese de que tiene al menos un campo que identifique a los usuarios o los grupos. Puede incluir ambos, pero solo es obligatorio uno y solo se utiliza uno a la vez. El campo que utilice para usuarios o grupos puede tener cualquier nombre que elija.
**nota**  
Si está especificando grupos, utilice únicamente grupos de Amazon Quick o grupos de Microsoft AD. 

   En el siguiente ejemplo se muestra una tabla con grupos.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/restrict-access-to-a-data-set-using-row-level-security.html)

   En el siguiente ejemplo, se muestra una tabla con nombres de usuario.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/restrict-access-to-a-data-set-using-row-level-security.html)

   En el siguiente ejemplo, se muestra una tabla con los nombres de los recursos de Amazon para usuarios y grupos (ARNs).    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/restrict-access-to-a-data-set-using-row-level-security.html)

   O bien, si utiliza un archivo .csv, este deberá tener una estructura similar a una de las siguientes.

   ```
   UserName,SalesRegion,Segment
   AlejandroRosalez,EMEA,"Enterprise,SMB,Startup"
   MarthaRivera,US,Enterprise
   NikhilJayashankars,US,SMB
   PauloSantos,US,Startup
   SaanviSarkar,APAC,"SMB,Startup"
   sales-tps@example.com,"",""
   ZhangWei,APAC-Sales,"Enterprise,Startup"
   ```

   ```
   GroupName,SalesRegion,Segment
   EMEA-Sales,EMEA,"Enterprise,SMB,Startup"
   US-Sales,US,Enterprise
   US-Sales,US,SMB
   US-Sales,US,Startup
   APAC-Sales,APAC,"SMB,Startup"
   Corporate-Reporting,"",""
   APAC-Sales,APAC,"Enterprise,Startup"
   ```

   ```
   UserARN,GroupARN,SalesRegion
   arn:aws:quicksight:us-east-1:123456789012:user/Bob,arn:aws:quicksight:us-east-1:123456789012:group/group-1,APAC
   arn:aws:quicksight:us-east-1:123456789012:user/Sam,arn:aws:quicksight:us-east-1:123456789012:group/group-2,US
   ```

   A continuación se muestra un ejemplo de SQL.

   ```
   /* for users*/
   	select User as UserName, SalesRegion, Segment
   	from tps-permissions;
   
   	/* for groups*/
   	select Group as GroupName, SalesRegion, Segment
   	from tps-permissions;
   ```

1. Cree un conjunto de datos para las reglas del conjunto de datos. Para asegurarse de que puede encontrarlo fácilmente, asígnele un nombre relevante, por ejemplo, **Permissions-Sales-Pipeline**.

## Marcado de conjuntos de datos de reglas para seguridad de filas
<a name="rules-dataset-flagging-for-row-level-security"></a>

Siga este procedimiento para marcar adecuadamente un conjunto de datos como conjunto de datos de reglas.

Conjunto de datos de reglas es un indicador que distingue los conjuntos de datos de permisos utilizados para la seguridad de filas de los conjuntos de datos normales. Si un conjunto de datos de permisos se aplicó a un conjunto de datos normal antes del 31 de marzo de 2025, tendrá una marca de conjunto de datos de reglas en la página de inicio **Conjunto de datos**. 

Si un conjunto de datos de permisos no se aplicó a un conjunto de datos normal antes del 31 de marzo de 2025, se clasificará como conjunto de datos normal. Para usarlo como un conjunto de datos de reglas, duplique el conjunto de datos de permisos y márquelo como un conjunto de datos de reglas en la consola al crear el conjunto de datos. Seleccione EDITAR CONJUNTO DE DATOS y, en las opciones, elija DUPLICAR COMO CONJUNTO DE DATOS DE REGLAS. 

Para duplicarlo correctamente como un conjunto de datos de reglas, asegúrese de que el conjunto de datos original tenga: 1. Columnas de metadatos de usuario o metadatos de grupo obligatorias. 2. Solo columnas de tipo cadena.

Para crear un nuevo conjunto de datos de reglas en la consola, seleccione NUEVO CONJUNTO DE DATOS DE REGLAS en el menú desplegable NUEVO CONJUNTO DE DATOS. Al crear un conjunto de datos de reglas mediante programación, añada el siguiente parámetro [UseAs:](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateDataSet.html#API_CreateDataSet_RequestSyntax) RLS\$1RULES. Se trata de un parámetro opcional que solo se utiliza para crear un conjunto de datos de reglas. Una vez que se ha creado un conjunto de datos, ya sea mediante la consola o mediante programación, y se ha marcado como conjunto de datos de reglas o conjunto de datos normal, no se puede cambiar.

Una vez que los conjuntos de datos estén marcados como conjuntos de datos de reglas, Amazon Quick les aplicará reglas estrictas de ingesta de SPICE. Para garantizar la integridad de los datos, se producirá un error en la ingesta de SPICE a los conjuntos de datos de reglas si hay filas o celdas no válidas que superen los límites de longitud. Debe solucionar los problemas de ingesta para poder reiniciar una ingesta correcta. Las reglas de ingesta estrictas solo se aplican a los conjuntos de datos de reglas. Los conjuntos de datos normales no tendrán errores en la ingesta de conjuntos de datos si se omiten filas o se truncan cadenas. 

## Aplicación de la seguridad de filas
<a name="apply-row-level-security"></a>

Utilice el procedimiento siguiente para aplicar la seguridad a nivel de fila (RLS) mediante un archivo o consulta como conjunto de datos que contiene las reglas de los permisos. 

**Aplicación de la seguridad a nivel de fila mediante un archivo o una consulta**

1. Confirme que ha añadido las reglas como un conjunto de datos nuevo. Si las ha añadido, pero no las ve en la lista de conjuntos de datos, actualice la pantalla.

1. En la página de **datos, elija el conjunto de datos**

1. En la página de detalles del conjunto de datos que se abre, en **Seguridad a nivel de fila**, seleccione **Configurar**.

1. **En la página **Configurar la seguridad a nivel de fila** que se abre, seleccione Reglas basadas en usuarios**.

1. En la lista de conjuntos de datos que aparece, elija el conjunto de datos de permisos. 

   Si el conjunto de datos de permisos no aparece en esta pantalla, vuelva a los conjuntos de datos y actualice la página.

1. En **Política de permisos**, seleccione **Conceder acceso al conjunto de datos**. Cada conjunto de datos tiene solo un conjunto de datos de permisos activo. Si intenta agregar un segundo conjunto de datos de permisos, sobrescribirá el existente.
**importante**  
Al trabajar con seguridad de nivel de fila hay determinadas restricciones para los valores NULL y de cadena vacía:  
Si el conjunto de datos tiene valores NULL o cadenas vacías (“”) en los campos restringidos, estas filas se omiten cuando se aplican las restricciones. 
Dentro del conjunto de datos de permisos, los valores NULL y las cadenas vacías se tratan igual. Para obtener más información, consulte la siguiente tabla.
Para evitar que se exponga accidentalmente información confidencial, Amazon Quick omite las reglas de RLS vacías que permiten el acceso a todo el mundo. Una *regla de RLS vacía* se produce cuando todas las columnas de una fila no tienen ningún valor. El RLS rápido trata los valores NULL, las cadenas vacías («») o las cadenas vacías separadas por comas (por ejemplo, «,,») como si no tuvieran ningún valor.  
Tras omitir las reglas vacías, se seguirán aplicando otras reglas de RLS que no estén vacías.
Si un conjunto de datos de permisos solo tiene reglas vacías y se omitieron todas, nadie tendrá acceso a los datos restringidos por este conjunto de datos de permisos.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/restrict-access-to-a-data-set-using-row-level-security.html)

   Cualquier persona con la que haya compartido el panel puede ver los datos en él, a menos que el conjunto de datos esté restringido por reglas de conjunto de datos. 

1. Para guardar los cambios, elija **Aplicar conjunto de datos**. Luego, en la página **¿Guardar reglas del conjunto de datos?**, seleccione **Aplicar y activar**. Los cambios en los permisos se aplican inmediatamente a los usuarios existentes. 

1. (Opcional) Para eliminar permisos, quite primero del conjunto de datos las reglas del conjunto de datos. 

   Asegúrese de que se eliminan las reglas del conjunto de datos. A continuación, elija el conjunto de datos de permisos y seleccione **Eliminar conjunto de datos**.

   Para sobrescribir permisos, elija un nuevo conjunto de datos de permisos y aplíquelo. Puede volver a utilizar el mismo nombre del conjunto de datos. Sin embargo, asegúrese de aplicar los nuevos permisos en la pantalla **Permisos** para activarlos. Las consultas SQL se actualizan de forma dinámica, por lo que se pueden gestionar fuera de Amazon Quick. En el caso de las consultas, los permisos se actualizan cuando la caché de consultas directas se actualiza automáticamente.

Si elimina un conjunto de datos de permisos basado en un archivo antes de eliminarlo del conjunto de datos de destino, los usuarios restringidos no pueden acceder al conjunto de datos. Mientras el conjunto de datos se encuentra en este estado, sigue marcado como **RESTRINGIDO**. Sin embargo, cuando consulte **Permisos** para el conjunto de datos, podrá ver que no tiene ninguna regla de conjunto de datos seleccionada. 

Para solucionar este problema, especifique nuevas reglas de conjunto de datos. Crear un conjunto de datos con el mismo nombre no es suficiente para solucionar este problema. Debe elegir el conjunto de datos de permisos nuevo en la pantalla **Permisos**. Esta restricción no se aplica a consultas SQL directas.

# Uso de seguridad a nivel de fila con reglas basadas en etiquetas para restringir el acceso a un conjunto de datos al incrustar paneles para usuarios anónimos
<a name="quicksight-dev-rls-tags"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores de Amazon Quick y desarrolladores de Amazon Quick  | 

Al incrustar paneles de Amazon Quick en su aplicación para los usuarios que no están aprovisionados (registrados) en Quick, puede utilizar la seguridad de nivel de fila (RLS) para los datos con etiquetas. filter/restrict Una etiqueta es una cadena especificada por el usuario que identifica una sesión en su aplicación. Puede usar etiquetas para implementar controles de RLS para sus conjuntos de datos. Al configurar las restricciones basadas en el RLS en los conjuntos de datos, Quick filtra los datos en función de las etiquetas de sesión vinculadas a la identidad o sesión del usuario.

Por ejemplo, supongamos que usted es una empresa de logística que tiene una aplicación orientada al cliente para varios minoristas. Miles de usuarios de estos minoristas acceden a su aplicación para ver las métricas relacionadas con la forma en que se envían sus pedidos desde su almacén. 

No desea administrar miles de usuarios en Quick, por lo que utiliza la incrustación anónima para incrustar en su aplicación los paneles seleccionados que puedan ver los usuarios autenticados y autorizados. Sin embargo, debe asegurarse de que los minoristas solo vean los datos que son para su empresa y no para otros. Puede usar la RLS con etiquetas para asegurarse de que sus clientes solo vean los datos que son relevantes para ellos.

Para ello, complete los siguientes pasos:

1. Agregue etiquetas de RLS a un conjunto de datos.

1. Asigne valores a esas etiquetas en tiempo de ejecución mediante la operación de la API de `GenerateEmbedUrlForAnonymousUser`.

   Para obtener más información sobre cómo incrustar paneles para usuarios anónimos mediante la operación de la API de `GenerateEmbedUrlForAnonymousUser`, consulte [Incorporación de paneles de Amazon Quick Sight para usuarios anónimos (no registrados)](embedded-analytics-dashboards-for-everyone.md).

Antes de que pueda usar la RLS con etiquetas, tenga en cuenta los siguientes puntos:
+ Actualmente, el uso de la RLS con etiquetas solo se admite para la incrustación anónima, específicamente para los paneles integrados que utilizan la operación de la API de `GenerateEmbedUrlForAnonymousUser`.
+ No se admite el uso de la RLS con etiquetas en los paneles integrados que utilizan la operación de la API de `GenerateEmbedURLForRegisteredUser` o la antigua operación de la API de `GetDashboardEmbedUrl`.
+ Las etiquetas RLS no son compatibles con AWS Identity and Access Management (IAM) ni con el tipo de identidad Quick.
+ Al aplicar los conjuntos de datos de SPICE a la seguridad de nivel de fila, cada campo del conjunto de datos puede contener hasta 2047 caracteres Unicode. Los campos que contienen más que esta cuota se truncan durante la incorporación de datos. Para obtener más información sobre las cuotas de datos de SPICE, consulte [Cuotas de SPICE para los datos importados](data-source-limits.md#spice-limits).

## Paso 1: adición de etiquetas de RLS a un conjunto de datos
<a name="quicksight-dev-rls-tags-add"></a>

Puede añadir reglas basadas en etiquetas a un conjunto de datos en Amazon Quick. Como alternativa, puede llamar a la operación de la API `CreateDataSet` o `UpdateDataSet` y añadir reglas basadas en etiquetas de esa forma. Para obtener más información, consulte [Adición de etiquetas de RLS a un conjunto de datos mediante la API](#quicksight-dev-rls-tags-add-api).

Utilice el siguiente procedimiento para añadir etiquetas RLS a un conjunto de datos en Quick.

**Adición de etiquetas de RLS a un conjunto de datos**

1. En la página de inicio rápido, elija **Datos** a la izquierda.

1. Elige el conjunto de datos al que quieres añadir el RLS.

1. En la página de detalles del conjunto de datos que se abre, en **Seguridad a nivel de fila**, seleccione **Configurar**.

1. En la página **Configurar seguridad a nivel de fila** que se abre, seleccione **Reglas basadas en etiquetas**.

1. En **Columna**, elija una columna a la que quiera añadir reglas de etiquetas.

   Por ejemplo, en el caso de la empresa de logística, se utiliza la columna `retailer_id`.

   Solo se muestran las columnas con un tipo de datos de cadena.

1. En **Etiqueta**, introduzca una clave de etiqueta. Puede introducir el nombre de etiqueta que desee.

   Por ejemplo, en el caso de la empresa de logística, se utiliza la clave de etiqueta `tag_retailer_id`. De este modo, se establece una seguridad de nivel de fila en función del distribuidor que accede a la aplicación.

1. (Opcional) En **Delimitador**, elija un delimitador de la lista o introduzca el suyo.

   Puede usar delimitadores para separar las cadenas de texto al asignar más de un valor a una etiqueta. El valor de un delimitador puede tener 10 caracteres como máximo.

1. (Opcional) En **Coincidir con todo**, seleccione **\$1** o introduzca su propio carácter o caracteres.

   Esta opción puede ser cualquier carácter que desee utilizar cuando quiera filtrar por todos los valores de esa columna del conjunto de datos. En lugar de enumerar los valores uno por uno, puede usar el carácter. Si se especifica este valor, puede tener al menos un carácter o 256 caracteres como máximo.

1. Elija **Añadir**.

   La regla de etiquetas se agrega al conjunto de datos y aparece en la parte inferior, pero aún no se ha aplicado. Para añadir otra regla de etiqueta al conjunto de datos, repita los pasos 5 a 9. Para editar una regla de etiquetas, elija el icono del lápiz que sigue a la regla. Para eliminar una regla de etiquetas, seleccione el icono de eliminación que sigue a la regla. Puede agregar hasta 50 etiquetas a un conjunto de datos.

1. Cuando esté listo para aplicar las reglas de etiquetas al conjunto de datos, elija **Aplicar reglas**.

1. En la página **¿Activar la seguridad basada en etiquetas?** que se abre, seleccione **Aplicar y activar**.

   Las reglas basadas en etiquetas ahora están activas. En la página **Configurar la seguridad a nivel de fila**, aparece un botón para activar y desactivar las reglas de etiquetas para el conjunto de datos.

   Para desactivar todas las reglas basadas en etiquetas para el conjunto de datos, desactive la opción **Reglas basadas en etiquetas** y, a continuación, escriba “confirmar” en el cuadro de texto que aparece.

   En la página de **datos**, aparece un icono de candado en la fila del conjunto de datos para indicar que las reglas de etiquetas están habilitadas.

   Ahora puede usar las reglas de etiquetas para establecer los valores de las etiquetas en tiempo de ejecución, tal como se describe en [Paso 2: asignación de valores a las etiquetas de RLS en tiempo de ejecución](#quicksight-dev-rls-tags-assign-values). Las reglas solo afectan a los lectores rápidos cuando están activas.
**importante**  
Una vez asignadas y habilitadas las etiquetas en el conjunto de datos, asegúrese de conceder a los autores rápidos permisos para ver todos los datos del conjunto de datos al crear un panel.   
Para dar permiso a los autores rápidos para ver los datos del conjunto de datos, crea un archivo o consulta de permisos para usarlos como reglas del conjunto de datos. Para obtener más información, consulte [Creación de reglas de conjunto de datos para seguridad de nivel de fila](restrict-access-to-a-data-set-using-row-level-security.md#create-data-set-rules-for-row-level-security).

Después de crear una regla basada en etiquetas, aparece una nueva tabla **Administrar reglas** que muestra cómo se relacionan entre sí las reglas basadas en etiquetas. Para realizar cambios en las reglas que aparecen en la tabla **Administrar reglas**, elija el icono del lápiz que sigue a la regla. A continuación, añada o elimine etiquetas y seleccione **Actualizar**. Para aplicar la regla actualizada al conjunto de datos, seleccione **Aplicar**.

### (Opcional) Adición de la condición OR a las etiquetas de RLS
<a name="quicksight-dev-rls-tags-or"></a>

También puede añadir la condición OR a las reglas basadas en etiquetas para personalizar aún más la forma en que se presentan los datos a los usuarios de su cuenta Quick. Al utilizar la condición OR con las reglas basadas en etiquetas, las imágenes de Quick aparecen si al menos una etiqueta definida en la regla es válida.

**Adición de la condición OR a las reglas basadas en etiquetas**

1. En la tabla **Administrar reglas**, elija **Agregar condición OR**.

1. En la lista desplegable **Seleccionar etiqueta** que aparece, elija la etiqueta para la que quiere crear una condición OR. Puede agregar hasta 50 condiciones OR a la tabla **Administrar reglas**. Puede añadir varias etiquetas a una sola columna de un conjunto de datos, pero la regla debe incluir al menos una etiqueta de columna.

1. Seleccione **Actualizar** para añadir la condición a la regla y, a continuación, seleccione **Aplicar** para aplicar la regla actualizada al conjunto de datos.

### Adición de etiquetas de RLS a un conjunto de datos mediante la API
<a name="quicksight-dev-rls-tags-add-api"></a>

Como alternativa, puede configurar y habilitar la seguridad de nivel de fila basada en etiquetas en su conjunto de datos llamando a la operación de la API `CreateDataSet` o `UpdateDataSet`. Utilice los siguientes ejemplos para aprender cómo hacerlo.

**importante**  
Al configurar las etiquetas de sesión en la llamada a la API,  
Trate las etiquetas de sesión como credenciales de seguridad. No exponga las etiquetas de sesión a los usuarios finales ni al código del lado del cliente.
Implemente controles del lado del servidor. Asegúrese de que las etiquetas de sesión las establezcan exclusivamente sus servicios de backend de confianza, no mediante parámetros que los usuarios finales puedan modificar.
Proteja las etiquetas de sesión de la enumeración. Asegúrese de que los usuarios de un inquilino no puedan descubrir o adivinar los valores de SessionTag que pertenecen a otros inquilinos.
Revise su arquitectura. Si los clientes o socios intermedios pueden llamar directamente a la API, evalúe si esas partes pueden especificar valores de SessionTag para los inquilinos a los que no deberían acceder.

------
#### [ CreateDataSet ]

El siguiente es un ejemplo de creación de un conjunto de datos que usa RLS con etiquetas. Asume el escenario de la empresa de logística descrito anteriormente. Las etiquetas se definen en el elemento `row-level-permission-tag-configuration`. Las etiquetas se definen en las columnas para las que desea proteger los datos. Para obtener más información sobre este elemento opcional, consulta [RowLevelPermissionTagConfiguration](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RowLevelPermissionTagConfiguration.html)la *Amazon Quick API Reference*.

```
create-data-set
		--aws-account-id <value>
		--data-set-id <value>
		--name <value>
		--physical-table-map <value>
		[--logical-table-map <value>]
		--import-mode <value>
		[--column-groups <value>]
		[--field-folders <value>]
		[--permissions <value>]
		[--row-level-permission-data-set <value>]
		[--column-level-permission-rules <value>]
		[--tags <value>]
		[--cli-input-json <value>]
		[--generate-cli-skeleton <value>]
		[--row-level-permission-tag-configuration 
	'{
		"Status": "ENABLED",
		"TagRules": 
			[
				{
					"TagKey": "tag_retailer_id",
					"ColumnName": "retailer_id",
					"TagMultiValueDelimiter": ",",
					"MatchAllValue": "*"
				},
				{
					"TagKey": "tag_role",
					"ColumnName": "role"
				}
			],
		"TagRuleConfigurations":
			[
				tag_retailer_id
			],
			[
				tag_role
			]
	}'
]
```

Las etiquetas de este ejemplo se definen en la parte `TagRules` del elemento. En este ejemplo, se definen dos etiquetas basadas en dos columnas:
+ La clave de etiqueta `tag_retailer_id` está definida para la columna `retailer_id`. En este caso, para la empresa de logística, se establece la seguridad a nivel de fila en función del distribuidor que accede a la aplicación.
+ La clave de etiqueta `tag_role` está definida para la columna `role`. En este caso, para la empresa de logística, esto establece una capa adicional de seguridad a nivel de fila basada en la función del usuario que accede a la aplicación desde un distribuidor específico. Un ejemplo es `store_supervisor` o `manager`.

Para cada etiqueta, puede definir `TagMultiValueDelimiter` y `MatchAllValue`. Son opcionales.
+ `TagMultiValueDelimiter`: esta opción puede ser cualquier cadena que desee utilizar para delimitar los valores cuando los pase en tiempo de ejecución. El valor puede tener hasta 10 caracteres como máximo. En este caso, se utiliza una coma como valor delimitador.
+ `MatchAllValue`: esta opción puede ser cualquier carácter que desee utilizar cuando desee filtrar por todos los valores de esa columna del conjunto de datos. En lugar de enumerar los valores uno por uno, puede usar el carácter. Si se especifica, este valor puede tener al menos un carácter o 256 caracteres como máximo. En este caso, se utiliza un asterisco como valor de coincidencia con todos.

Al configurar las etiquetas para las columnas del conjunto de datos, actívelas o desactívelas mediante la propiedad `Status` obligatoria. Para habilitar las reglas de etiquetas, use el valor `ENABLED` de esta propiedad. Al activar las reglas de etiquetas, puede usarlas para establecer los valores de las etiquetas en tiempo de ejecución, tal como se describe en [Paso 2: asignación de valores a las etiquetas de RLS en tiempo de ejecución](#quicksight-dev-rls-tags-assign-values).

A continuación se muestra un ejemplo de definición de respuesta.

```
{
			"Status": 201,
			"Arn": "arn:aws:quicksight:us-west-2:11112222333:dataset/RLS-Dataset",
			"DataSetId": "RLS-Dataset",
			"RequestId": "aa4f3c00-b937-4175-859a-543f250f8bb2"
		}
```

------
#### [ UpdateDataSet ]

**UpdateDataSet**

Puede usar la operación de la API de `UpdateDataSet` para añadir o actualizar las etiquetas de RLS de un conjunto de datos existente.

A continuación, se muestra un ejemplo de actualización de un conjunto de datos con etiquetas de RLS. Asume el escenario de la empresa de logística descrito anteriormente.

```
update-data-set
		--aws-account-id <value>
		--data-set-id <value>
		--name <value>
		--physical-table-map <value>
		[--logical-table-map <value>]
		--import-mode <value>
		[--column-groups <value>
		[--field-folders <value>]
		[--row-level-permission-data-set <value>]
		[--column-level-permission-rules <value>]
		[--cli-input-json <value>]
		[--generate-cli-skeleton <value>]
				[--row-level-permission-tag-configuration 
	'{
		"Status": "ENABLED",
		"TagRules": 
			[
				{
					"TagKey": "tag_retailer_id",
					"ColumnName": "retailer_id",
					"TagMultiValueDelimiter": ",",
					"MatchAllValue": "*"
				},
				{
					"TagKey": "tag_role",
					"ColumnName": "role"
				}
			],
		"TagRuleConfigurations":
			[
				tag_retailer_id
			],
			[
				tag_role
			]
	}'
]
```

A continuación se muestra un ejemplo de definición de respuesta.

```
{
			"Status": 201,
			"Arn": "arn:aws:quicksight:us-west-2:11112222333:dataset/RLS-Dataset",
			"DataSetId": "RLS-Dataset",
			"RequestId": "aa4f3c00-b937-4175-859a-543f250f8bb2"
		}
```

------

**importante**  
Una vez asignadas y habilitadas las etiquetas en el conjunto de datos, asegúrese de conceder a los autores rápidos permisos para ver todos los datos del conjunto de datos al crear un panel.   
Para dar permiso a los autores rápidos para ver los datos del conjunto de datos, crea un archivo o consulta de permisos para usarlos como reglas del conjunto de datos. Para obtener más información, consulte [Creación de reglas de conjunto de datos para seguridad de nivel de fila](restrict-access-to-a-data-set-using-row-level-security.md#create-data-set-rules-for-row-level-security).

Para obtener más información sobre el `RowLevelPermissionTagConfiguration` elemento, consulte [RowLevelPermissionTagConfiguration](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RowLevelPermissionTagConfiguration.html)la *Amazon Quick API Reference*.

## Paso 2: asignación de valores a las etiquetas de RLS en tiempo de ejecución
<a name="quicksight-dev-rls-tags-assign-values"></a>

Puede usar etiquetas para RLS solo para incrustaciones anónimas. Puede establecer valores para las etiquetas mediante la operación de la API de `GenerateEmbedUrlForAnonymousUser`.

**importante**  
Al configurar las etiquetas de sesión en la llamada a la API,  
Trate las etiquetas de sesión como credenciales de seguridad. No exponga las etiquetas de sesión a los usuarios finales ni al código del lado del cliente.
Implemente controles del lado del servidor. Asegúrese de que las etiquetas de sesión las establezcan exclusivamente sus servicios de backend de confianza, no mediante parámetros que los usuarios finales puedan modificar.
Proteja las etiquetas de sesión de la enumeración. Asegúrese de que los usuarios de un inquilino no puedan descubrir o adivinar los valores de SessionTag que pertenecen a otros inquilinos.
Revise su arquitectura. Si los clientes o socios intermedios pueden llamar directamente a la API, evalúe si esas partes pueden especificar valores de SessionTag para los inquilinos a los que no deberían acceder.

El siguiente ejemplo muestra cómo asignar valores a las etiquetas de RLS que se definieron en el conjunto de datos en el paso anterior.

```
POST /accounts/AwsAccountId/embed-url/anonymous-user
	HTTP/1.1
	Content-type: application/json
	{
		“AwsAccountId”: “string”,
		“SessionLifetimeInMinutes”: integer,
		“Namespace”: “string”, // The namespace to which the anonymous end user virtually belongs
		“SessionTags”:  // Optional: Can be used for row-level security
			[
				{
					“Key”: “tag_retailer_id”,
					“Value”: “West,Central,South”
				}
				{
					“Key”: “tag_role”,
					“Value”: “shift_manager”
				}
			],
		“AuthorizedResourceArns”:
			[
				“string”
			],
		“ExperienceConfiguration”:
			{
				“Dashboard”:
					{
						“InitialDashboardId”: “string”
						// This is the initial dashboard ID the customer wants the user to land on. This ID goes in the output URL.
					}
			}
	}
```

A continuación se muestra un ejemplo de definición de respuesta.

```
HTTP/1.1 Status
	Content-type: application/json

	{
	"EmbedUrl": "string",
	"RequestId": "string"
	}
```

La compatibilidad con RLS sin registrar usuarios en Quick solo se admite en el funcionamiento de la API. `GenerateEmbedUrlForAnonymousUser` En esta operación, en `SessionTags`, puede definir los valores de las etiquetas asociadas a las columnas del conjunto de datos.

En este caso, se definen las siguientes asignaciones:
+ Los valores `West`, `Central` y `South` se asignan a la etiqueta `tag_retailer_id` en tiempo de ejecución. Se usa una coma para el delimitador, que se definió en `TagMultipleValueDelimiter` en el conjunto de datos. Para usar los valores de llamada en la columna, puede establecer el valor en *\$1*, que se definió como `MatchAllValue` al crear la etiqueta.
+ El valor `shift_manager` se asigna a la etiqueta `tag_role`.

El usuario que utilice la URL generada solo podrá ver las filas que tengan el valor `shift_manager` en la columna `role`. Ese usuario solo puede ver el valor `West`, `Central` o `South` en la columna `retailer_id`.

Para obtener más información sobre la incrustación de paneles para usuarios anónimos mediante la operación de `GenerateEmbedUrlForAnonymousUser` API[Incorporación de paneles de Amazon Quick Sight para usuarios anónimos (no registrados)](embedded-analytics-dashboards-for-everyone.md), consulte o [GenerateEmbedUrlForAnonymousUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html)consulte la *Amazon Quick* API Reference.

# Uso de la seguridad en el nivel de columna para restringir el acceso a un conjunto de datos
<a name="restrict-access-to-a-data-set-using-column-level-security"></a>

En la edición empresarial de Quick, puede restringir el acceso a un conjunto de datos configurando la seguridad a nivel de columna (CLS) en él. Un conjunto de datos o análisis con el CLS activado tiene el símbolo ![\[The lock icon for CLS.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/cls-restricted-icon.png) restringido junto a él. De forma predeterminada, todos los usuarios y grupos no tienen acceso a los datos. Al usar CLS, puede administrar el acceso a columnas específicas de su conjunto de datos.

Si utiliza un análisis o un panel que contiene conjuntos de datos con restricciones de CLS a los que no tiene acceso, no podrá crear, ver ni editar elementos visuales que usen los campos restringidos. En la mayoría de los tipos de elementos visuales, si un elemento visual tiene columnas restringidas a las que no tiene acceso, no podrá verlo en su análisis o panel de control.

Las tablas y las tablas dinámicas se comportan de forma diferente. Si una tabla o tabla dinámica utiliza columnas restringidas en los cuadros de campo **Filas** o **Columnas** y usted no tiene acceso a estas columnas restringidas, no podrá ver el elemento visual en un análisis o en un panel de control. Si una tabla o tabla dinámica tiene columnas restringidas en el cuadro de campo **Valores**, podrá ver la tabla en un análisis o un panel de control con solo los valores a los que tiene acceso. Los valores de las columnas restringidas se muestran como No autorizado.

Para habilitar la seguridad en el nivel de columna en un análisis o panel, necesita acceso de administrador.

**Creación de un nuevo análisis con CLS**

1. **En la página de inicio rápido, seleccione la pestaña Análisis.**

1. En la parte superior derecha, elija **Nuevo análisis**.

1. Elija un conjunto de datos y elija **Seguridad en el nivel de columna**.

1. Seleccione las columnas que desee restringir y, a continuación, elija **Siguiente**. De forma predeterminada, todos los grupos y usuarios tienen acceso a todas las columnas.

1. Elija quién puede acceder a cada columna y, a continuación, seleccione **Aplicar** para guardar los cambios.

**Uso de un análisis existente para CLS**

1. En la página de inicio rápido, seleccione la pestaña **Datos**.

1. En la página de datos, abra el conjunto de datos

1. En la página de detalles del conjunto de datos que se abre, en **Seguridad en el nivel de columna**, seleccione **Configurar**.

1. Seleccione las columnas que desee restringir y, a continuación, elija **Siguiente**. De forma predeterminada, todos los grupos y usuarios tienen acceso a todas las columnas.

1. Elija quién puede acceder a cada columna y, a continuación, seleccione **Aplicar** para guardar los cambios.

**Creación de un panel con CLS**

1. En el panel de navegación rápida, selecciona la pestaña **Análisis**.

1. Elija el análisis para el que desea crear un panel.

1. En la parte superior derecha, elija **Publicar**.

1. Seleccione una de las siguientes opciones:
   + Para crear un nuevo panel, elija **Publicar nuevo panel como** y, a continuación, escriba un nombre para el nuevo panel.
   + Elija **Reemplazar un panel existente** y, a continuación, el panel que quiere reemplazar de la lista.

   Además, puede elegir **Opciones de publicación avanzadas**. Para obtener más información, consulte [Publicación de paneles](creating-a-dashboard.md).

1. Elija **Publicar panel**.

1. (opcional) Realice una de las operaciones siguientes:
   + Para publicar un panel sin necesidad compartirlo, elija **x** en la parte superior derecha de la pantalla **Compartir panel con los usuarios** cuando aparezca. Podrá compartir el panel más adelante seleccionando **Compartir** en la barra de aplicaciones.
   + Para compartir el panel, siga el procedimiento indicado en [Compartir los paneles de Amazon Quick Sight](sharing-a-dashboard.md).

# Ejecutar consultas como función de IAM en Amazon Quick
<a name="datasource-run-as-role"></a>

Ahora puede mejorar la seguridad de los datos mediante políticas de acceso detalladas en lugar de permisos más amplios para los orígenes de datos conectados a Amazon Athena, Amazon Redshift o Amazon S3. Comience por crear un rol de AWS Identity and Access Management (IAM) con permisos que se activarán cuando una persona o una API inicie una consulta. A continuación, un administrador de Quick o un desarrollador asigna el rol de IAM a una fuente de datos de Athena o Amazon S3. Una vez establecido el rol, cualquier persona o API que ejecute la consulta dispondrá de los permisos exactos necesarios para ejecutarla. 

Estos son algunos aspectos que debe tener en cuenta antes de comprometerse a implementar roles Ejecutar como para mejorar la seguridad de los datos: 
+ Explique cómo la seguridad adicional funciona a su favor.
+ Hable con su administrador de Quick para saber si añadir funciones a las fuentes de datos le ayuda a cumplir mejor sus objetivos o requisitos de seguridad. 
+ Pregúntese si su equipo puede documentar y mantener este tipo de seguridad, teniendo en cuenta la cantidad de orígenes de datos y personas y aplicaciones involucradas. Si no es así, ¿quién se encargará de esa parte del trabajo?
+ En una organización estructurada, ubique a las partes interesadas en equipos paralelos de Operaciones, Desarrollo y Soporte de TI. Solicite su experiencia, consejos y disposición para que respalden su plan.
+ Antes de lanzar su proyecto, considere la posibilidad de realizar una prueba de concepto en la que participen las personas que necesitan acceder a los datos.

Las siguientes reglas se aplican al uso de roles Ejecutar como con Athena, Amazon Redshift y Amazon S3:
+ Cada fuente de datos solo puede tener asociada una RoleArn. Los consumidores del origen de datos, que suelen acceder a conjuntos de datos y elementos visuales, pueden generar muchos tipos diferentes de consultas. El rol establece límites entre las consultas que funcionan y las que no.
+ El ARN debe corresponder a un rol de IAM al Cuenta de AWS igual que la instancia rápida que lo usa.
+ El rol de IAM debe tener una relación de confianza que permita a Quick asumir el rol.
+ La identidad que llama a Quick APIs debe tener permiso para pasar el rol antes de que pueda actualizar la `RoleArn` propiedad. Solo necesita pasar el rol al crear o actualizar el ARN del rol. Los permisos no se vuelven a evaluar más adelante. Del mismo modo, el permiso no es necesario cuando se omite el ARN del rol.
+ Si se omite el ARN del rol, el origen de datos de Athena o Amazon S3 utiliza el rol de toda la cuenta y las políticas de reducción del alcance.
+ Cuando el ARN del rol está presente, se ignora el rol de toda la cuenta y cualquier política de reducción del alcance. En el caso de los orígenes de datos de Athena, no se ignoran los permisos de Lake Formation.
+ En el caso de los orígenes de datos de Amazon S3, se debe poder acceder tanto al archivo de manifiesto como a los datos especificados en el archivo de manifiesto mediante el rol de IAM.
+ La cadena ARN debe coincidir con una función de IAM existente en el Región de AWS lugar donde se encuentran Cuenta de AWS y se consultan los datos. 

Cuando Quick se conecta a otro servicio AWS, utiliza una función de IAM. De forma predeterminada, Quick crea esta versión menos detallada del rol para cada servicio que utiliza, y los Cuenta de AWS administradores administran el rol. Al agregar un ARN de rol de IAM con una política de permisos personalizada, se anula el rol más amplio de los orígenes de datos que necesitan protección adicional. Para obtener más información acerca de las políticas, consulte [Creación de políticas administradas por el cliente](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_managed-policies.html) en la Guía del usuario de IAM.

## Ejecución de consultas con orígenes de datos de Athena
<a name="datasource-run-as-role-athena"></a>

Utilice la API para adjuntar el ARN al origen de datos de Athena. Para ello, añada el rol ARN a la [RoleArn](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RoleArn.html)propiedad de. [AthenaParameters](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_AthenaParameters.html) Para verificarlo, puede ver el ARN del rol en el cuadro de diálogo **Editar origen de datos de Athena**. Sin embargo, el campo **Rol ARN** es un campo de solo lectura.

Para empezar, necesita un rol de IAM personalizado, como demostramos en el siguiente ejemplo.

Tenga en cuenta que el siguiente ejemplo de código es solo para fines de aprendizaje. Utilice este ejemplo únicamente en un entorno temporal de desarrollo y pruebas, y no en un entorno de producción. La política de este ejemplo no protege ningún recurso específico, que debe estar en una política desplegable. Además, incluso para el desarrollo, debe agregar la información de su propia cuenta de AWS .

Los siguientes comandos crean un nuevo rol simple y adjuntan algunas políticas que otorgan permisos a Quick.

```
aws iam create-role \
        --role-name TestAthenaRoleForQuickSight \
        --description "Test Athena Role For QuickSight" \
        --assume-role-policy-document '{
            "Version": "2012-10-17"		 	 	 ,
            "Statement": [
                {
                    "Effect": "Allow",
                    "Principal": {
                        "Service": "quicksight.amazonaws.com"
                    },
                    "Action": "sts:AssumeRole"
                }
            ]
        }'
```

Una vez que haya identificado o creado un rol de IAM para usarlo con cada fuente de datos, adjunte las políticas mediante el attach-role-policy.

```
aws iam attach-role-policy \
        --role-name TestAthenaRoleForQuickSight \
        --policy-arn arn:aws:iam::222222222222:policy/service-role/AWSQuickSightS3Policy1

    aws iam attach-role-policy \
        --role-name TestAthenaRoleForQuickSight \
        --policy-arn arn:aws:iam::aws:policy/service-role/AWSQuicksightAthenaAccess1

    aws iam attach-role-policy \
        --role-name TestAthenaRoleForQuickSight \
        --policy-arn arn:aws:iam::aws:policy/AmazonS3Access1
```



Después de verificar sus permisos, puede usar la función en las fuentes de datos rápidas creando una nueva función o actualizando una función existente. Cuando utilice estos comandos, actualice el Cuenta de AWS ID Región de AWS para que coincida con el suyo. 

Recuerde que estos fragmentos de código de ejemplo no son para entornos de producción. AWS recomienda encarecidamente que identifique y utilice un conjunto de políticas de privilegios mínimos para sus casos de producción.

```
aws quicksight create-data-source
        --aws-account-id 222222222222 \
        --region us-east-1 \
        --data-source-id "athena-with-custom-role" \
        --cli-input-json '{
            "Name": "Athena with a custom Role",
            "Type": "ATHENA",
            "data sourceParameters": {
                "AthenaParameters": {
                    "RoleArn": "arn:aws:iam::222222222222:role/TestAthenaRoleForQuickSight"
                }
            }
        }'
```

## Ejecución de consultas con orígenes de datos de Amazon Redshift
<a name="datasource-run-as-role-redshift"></a>

Conecte los datos de Amazon Redshift con el rol Ejecutar como para mejorar la seguridad de los datos con políticas de acceso detalladas. Puede crear un rol Ejecutar como para los orígenes de datos de Amazon Redshift que utilizan una red pública o una conexión de VPC. Especifique el tipo de conexión que desee utilizar en el cuadro de diálogo **Editar origen de datos de Amazon Redshift**. Los orígenes de datos de Amazon Redshift sin servidor no admiten el rol de ejecución como usuario.

Para empezar, necesita un rol de IAM personalizado, como demostramos en el siguiente ejemplo. Los siguientes comandos crean un ejemplo de nuevo rol y adjuntan políticas que otorgan permisos a Quick.

```
aws iam create-role \
--role-name TestRedshiftRoleForQuickSight \
--description "Test Redshift Role For QuickSight" \
--assume-role-policy-document '{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "quicksight.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}'
```

Después de identificar o crear un rol de IAM para usarlo con cada origen de datos, adjunte las políticas a una política `attach-role-policy`. Si el permiso `redshift:GetClusterCredentialsWithIAM` está asociado al rol que desea usar, los valores para `DatabaseUser` y `DatabaseGroups` son opcionales.

```
aws iam attach-role-policy \
--role-name TestRedshiftRoleForQuickSight \
--policy-arn arn:aws:iam:111122223333:policy/service-role/AWSQuickSightRedshiftPolicy
    
        
aws iam create-policy --policy-name RedshiftGetClusterCredentialsPolicy1 \
--policy-document file://redshift-get-cluster-credentials-policy.json 


aws iam attach-role-policy \
--role-name TestRedshiftRoleForQuickSight \
--policy-arn arn:aws:iam:111122223333:policy/RedshiftGetClusterCredentialsPolicy1
// redshift-get-cluster-credentials-policy.json
{
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [
        {
            "Sid": "RedshiftGetClusterCredentialsPolicy",
            "Effect": "Allow",
            "Action": [
                "redshift:GetClusterCredentials"
            ],
            "Resource": [
                "*"
            ]
        }
    ]
}
```

El ejemplo anterior crea un origen de datos que usa los parámetros de IAM `RoleARN`, `DatabaseUser` y `DatabaseGroups`. Si desea establecer la conexión únicamente a través del parámetro `RoleARN` de IAM, adjunte el permiso `redshift:GetClusterCredentialsWithIAM` a su rol, tal y como se muestra en el ejemplo siguiente.

```
aws iam attach-role-policy \ 
--role-name TestRedshiftRoleForQuickSight \ 
--policy-arn arn:aws:iam:111122223333:policy/RedshiftGetClusterCredentialsPolicy1 // redshift-get-cluster-credentials-policy.json {
    "Version": "2012-10-17"		 	 	 ,
    "Statement": [ 
        {
            "Sid": "RedshiftGetClusterCredentialsPolicy", 
            "Effect": "Allow", 
            "Action": [ "redshift:GetClusterCredentialsWithIAM" ],
            "Resource": [ "*" ]
        }
    ]
}"
```

Después de verificar sus permisos, puede usar el rol en las fuentes de datos de Quick creando un rol nuevo o actualizando uno existente. Cuando utilices estos comandos, actualiza el ID de AWS cuenta y la AWS región para que coincidan con los tuyos.

```
aws quicksight create-data-source \
--region us-west-2 \
--endpoint https://quicksight.us-west-2.quicksight.aws.com/ \
--cli-input-json file://redshift-data-source-iam.json \
redshift-data-source-iam.json is shown as below
{
    "AwsAccountId": "AWSACCOUNTID",
    "DataSourceId": "DATSOURCEID",
    "Name": "Test redshift demo iam",
    "Type": "REDSHIFT",
    "DataSourceParameters": {
        "RedshiftParameters": {
            "Database": "integ",
            "Host": "redshiftdemocluster.us-west-2.redshift.amazonaws.com",
            "Port": 8192,
            "ClusterId": "redshiftdemocluster",
            "IAMParameters": {
                "RoleArn": "arn:aws:iam::222222222222:role/TestRedshiftRoleForQuickSight",
                "DatabaseUser": "user",
                "DatabaseGroups": ["admin_group", "guest_group", "guest_group_1"]
            }
        }
    },
    "Permissions": [
      {
        "Principal": "arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/demoname",
        "Actions": [
          "quicksight:DescribeDataSource",
          "quicksight:DescribeDataSourcePermissions",
          "quicksight:PassDataSource",
          "quicksight:UpdateDataSource",
          "quicksight:DeleteDataSource",
          "quicksight:UpdateDataSourcePermissions"
        ]
      }
    ]
}
```

Si el origen de datos utiliza el tipo de conexión de VPC, utilice la siguiente configuración de VPC.

```
{
    "AwsAccountId": "AWSACCOUNTID",
    "DataSourceId": "DATSOURCEID",
    "Name": "Test redshift demo iam vpc",
    "Type": "REDSHIFT",
    "DataSourceParameters": {
        "RedshiftParameters": {
            "Database": "mydb",
            "Host": "vpcdemo.us-west-2.redshift.amazonaws.com",
            "Port": 8192,
            "ClusterId": "vpcdemo",
            "IAMParameters": {
                "RoleArn": "arn:aws:iam::222222222222:role/TestRedshiftRoleForQuickSight",
                "DatabaseUser": "user",
                "AutoCreateDatabaseUser": true
            }
        }
    },
    "VpcConnectionProperties": { 
      "VpcConnectionArn": "arn:aws:quicksight:us-west-2:222222222222:vpcConnection/VPC Name"
    },
    "Permissions": [
      {
        "Principal": "arn:aws:quicksight:us-east-1:222222222222:user/default/demoname",
        "Actions": [
          "quicksight:DescribeDataSource",
          "quicksight:DescribeDataSourcePermissions",
          "quicksight:PassDataSource",
          "quicksight:UpdateDataSource",
          "quicksight:DeleteDataSource",
          "quicksight:UpdateDataSourcePermissions"
        ]
      }
    ]
}
```

Si el origen de datos usa el permiso `redshift:GetClusterCredentialsWithIAM` y no usa los parámetros `DatabaseUser` o `DatabaseGroups`, conceda al rol acceso a algunas o a todas las tablas del esquema. Para comprobar si un rol tiene permisos `SELECT` para una tabla específica, especifique el siguiente comando en el editor de consultas de Amazon Redshift.

```
SELECT
u.usename,
t.schemaname||'.'||t.tablename,
has_table_privilege(u.usename,t.tablename,'select') AS user_has_select_permission
FROM
pg_user u
CROSS JOIN
pg_tables t
WHERE
u.usename = 'IAMR:RoleName'
AND t.tablename = tableName
```

Para obtener más información sobre la acción `SELECT` del editor de consultas de Amazon Redshift, consulte [SELECT](https://docs.aws.amazon.com/redshift/latest/dg/r_SELECT_synopsis.html).

Para conceder permisos `SELECT` al rol, especifique el siguiente comando en el editor de consultas de Amazon Redshift.

```
GRANT SELECT ON { [ TABLE ] table_name [, ...] | ALL TABLES IN SCHEMA 
schema_name [, ...] } TO "IAMR:Rolename";
```

Para obtener más información sobre la acción `GRANT` del editor de consultas de Amazon Redshift, consulte [GRANT](https://docs.aws.amazon.com/redshift/latest/dg/r_GRANT.html).

## Ejecución de consultas con orígenes de datos de Amazon S3
<a name="datasource-run-as-role-s3"></a>

Las fuentes de datos de Amazon S3 contienen un archivo de manifiesto que Quick utiliza para buscar y analizar los datos. Puede cargar un archivo de manifiesto JSON a través de la consola Quick o puede proporcionar una URL que apunte a un archivo JSON de un bucket de S3. Si decide proporcionar una URL, Quick debe tener permiso para acceder al archivo en Amazon S3. Utilice la consola de administración rápida para controlar el acceso al archivo de manifiesto y a los datos a los que hace referencia.

Con **RoleArn**esta propiedad, puedes conceder acceso al archivo de manifiesto y a los datos a los que hace referencia mediante una función de IAM personalizada que anula la función de toda la cuenta. Utilice la API para adjuntar el ARN al archivo de manifiesto del origen de datos de Amazon S3. [Para ello, incluya el rol ARN en la [RoleArn](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RoleArn.html)propiedad de S3Parameters.](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_S3Parameters.html) Para verificarlo, puede ver el ARN del rol en el cuadro de diálogo **Editar origen de datos de S3**. Sin embargo, el **ARN del rol** es un campo de solo lectura, tal y como se muestra en la captura de pantalla a continuación.

Para empezar, cree un archivo de manifiesto de Amazon S3. A continuación, puede subirlo a Amazon Quick cuando cree un nuevo conjunto de datos de Amazon S3 o colocar el archivo en el bucket de Amazon S3 que contiene sus archivos de datos. Consulte el siguiente ejemplo para ver el aspecto que tendría un archivo de manifiesto:

```
{
    "fileLocations": [
        {
            "URIPrefixes": [
                "s3://quicksightUser-run-as-role/data/"
            ]
        }
    ],
    "globalUploadSettings": {
        "format": "CSV",
        "delimiter": ",",
        "textqualifier": "'",
        "containsHeader": "true"
    }
}
```

Para obtener instrucciones acerca de cómo crear un manifiesto, consulte [Formatos compatibles con los archivos de manifiesto de Amazon S3](supported-manifest-file-format.md).

Una vez que haya creado un archivo de manifiesto y lo haya añadido a su bucket de Amazon S3 o lo haya subido a Quick, cree o actualice un rol existente en IAM que conceda `s3:GetObject` acceso. El siguiente ejemplo ilustra cómo actualizar un rol de IAM existente con la AWS API:

```
aws iam put-role-policy \
    --role-name QuickSightAccessToS3RunAsRoleBucket \
    --policy-name GrantS3RunAsRoleAccess \
    --policy-document '{
        "Version": "2012-10-17"		 	 	 ,
        "Statement": [
            {
                "Effect": "Allow",
                "Action": "s3:ListBucket",
                "Resource": "arn:aws:s3:::s3-bucket-name"
            },
            {
                "Effect": "Allow",
                "Action": "s3:GetObject",
                "Resource": "arn:aws:s3:::s3-bucket-name/manifest.json"
            },
            {
                "Effect": "Allow",
                "Action": "s3:GetObject",
                "Resource": "arn:aws:s3:::s3-bucket-name/*"
            }
        ]
    }'
```

Una vez que su política le conceda el acceso `s3:GetObject`, puede empezar a crear orígenes de datos que apliquen la actualización de `put-role-policy` al archivo de manifiesto del origen de datos de Amazon S3.

```
aws quicksight create-data-source --aws-account-id 111222333444 --region us-west-2 --endpoint https://quicksight.us-west-2.quicksight.aws.com/ \
    --data-source-id "s3-run-as-role-demo-source" \
    --cli-input-json '{
        "Name": "S3 with a custom Role",
        "Type": "S3",
        "DataSourceParameters": {
            "S3Parameters": {
                "RoleArn": "arn:aws:iam::111222333444:role/QuickSightAccessRunAsRoleBucket",
                "ManifestFileLocation": {
                    "Bucket": "s3-bucket-name", 
                    "Key": "manifest.json"
                }
            }
        }
    }'
```

Después de verificar sus permisos, puede usar el rol en las fuentes de datos rápidas, ya sea creando un rol nuevo o actualizando uno existente. Cuando utilice estos comandos, asegúrese de actualizar el Cuenta de AWS ID Región de AWS para que coincida con el suyo. 

# Eliminación de conjuntos de datos
<a name="delete-a-data-set"></a>

**importante**  
Actualmente, la eliminación de un conjunto de datos es irreversible y puede provocar una pérdida irreversible de trabajo. Las eliminaciones no se eliminan en cascada para eliminar objetos dependientes. En su lugar, los objetos dependientes dejan de funcionar, incluso si sustituye el conjunto de datos eliminado por un conjunto de datos idéntico. 

Antes de eliminar un conjunto de datos, le recomendamos encarecidamente que primero apunte cada análisis dependiente o panel a un nuevo conjunto de datos. 

Actualmente, cuando se elimina un conjunto de datos mientras siguen existiendo elementos visuales dependientes, los análisis y los paneles que contienen dichos elementos visuales no tienen forma de asimilar nuevos metadatos. Permanecen visibles, pero no pueden funcionar. No se pueden reparar añadiendo un conjunto de datos idéntico. 

Esto se debe a que los conjuntos de datos incluyen metadatos que son fundamentales para los análisis y los paneles que dependen de ese conjunto de datos. Estos metadatos se generan de forma exclusiva para cada conjunto de datos. Si bien el motor Quick Sight puede leer los metadatos, las personas no los pueden leer (por ejemplo, no contienen nombres de campo). Por lo tanto, una réplica exacta del conjunto de datos tiene diferentes metadatos. Los metadatos de cada conjunto de datos son únicos, incluso para varios conjuntos de datos que comparten el mismo nombre y los mismos campos.

**Eliminación de un conjunto de datos**

1. Asegúrese de que el conjunto de datos no lo utilice ningún análisis o panel que alguien quiera seguir utilizando.

   En la página de **datos**, elija el conjunto de datos que ya no necesite. A continuación, elija **Eliminar conjunto de datos** en la parte superior derecha. 

1. En caso de que reciba una advertencia si este conjunto de datos está en uso, realice un seguimiento de todos los análisis y paneles dependientes y apunte a un conjunto de datos diferente. Si esto no es posible, pruebe una o varias de estas prácticas recomendadas en lugar de eliminarlas:
   + Cambie el nombre del conjunto de datos para que quede claramente obsoleto.
   + Filtre los datos para que el conjunto de datos no tenga filas.
   + Elimine el acceso de los demás usuarios al conjunto de datos.

   Le recomendamos que utilice cualquier medio posible para informar a los propietarios de objetos dependientes de que este conjunto de datos se está quedando obsoleto. Además, asegúrese de que proporciona tiempo suficiente para que tomen medidas.

1. Una vez que esté seguro de que no hay objetos dependientes que dejen de funcionar después de que se elimine el conjunto de datos, elija el conjunto de datos y, a continuación, **Eliminar conjunto de datos**. Confirme la opción elegida o seleccione **Cancelar**.

**importante**  
Actualmente, la eliminación de un conjunto de datos es irreversible y puede provocar una pérdida irreversible de trabajo. Las eliminaciones no se eliminan en cascada para eliminar objetos dependientes. En su lugar, los objetos dependientes dejan de funcionar, incluso si sustituye el conjunto de datos eliminado por un conjunto de datos idéntico. 

# Añadir un conjunto de datos a un análisis
<a name="adding-a-data-set-to-an-analysis"></a>

Una vez que haya creado un análisis, puede añadir más conjuntos de datos al análisis. A continuación, puede utilizarlos para crear más elementos visuales. 

Desde el análisis, puede abrir cualquier conjunto de datos para editarlo, por ejemplo, para añadir o eliminar campos o realizar otra preparación de los datos. También puede eliminar o sustituir conjuntos de datos. 

El conjunto de datos seleccionado actualmente se muestra en la parte superior del panel **Datos**. Este es el conjunto de datos que utilizará el elemento visual seleccionado. Cada elemento visual solo puede utilizar un conjunto de datos. Si se selecciona otro elemento visual, el conjunto de datos seleccionado será el que utiliza este elemento visual.

Para cambiar manualmente el conjunto de datos seleccionado, elija la lista del conjuntos de datos que aparece en la parte superior del panel **Datos** y seleccione otro conjunto de datos. Esto anula la selección del elemento visual seleccionado actualmente si no utiliza este conjunto de datos. A continuación, elija un elemento visual que utilice el conjunto de datos seleccionado. O bien, elija **Agregar** en el panel **Elementos visuales** para crear un nuevo elemento visual con el conjunto de datos seleccionado.

Si elige **Sugerido** en la barra de herramientas para ver los elementos visuales recomendados, aparecerán elementos visuales basados en el conjunto de datos seleccionado.

En el panel **Filtro** solo se muestran los filtros correspondientes al conjunto de datos seleccionado y solo es posible crear filtros en el conjunto de datos seleccionado. 

**Topics**
+ [Sustitución de conjuntos de datos](replacing-data-sets.md)
+ [Eliminación de un conjunto de datos de un análisis](delete-a-data-set-from-an-analysis.md)

Utilice el siguiente procedimiento para añadir un conjunto de datos a un análisis o editar un conjunto de datos utilizado por un análisis.

**Adición de un conjunto de datos a un análisis**

1. En la página de análisis, vaya al panel **Datos** y expanda el menú desplegable **Conjunto de datos**.

1. Elija **Agregar un nuevo conjunto de datos** para agregar un conjunto de datos. O bien, elija **Administrar conjuntos de datos** para editar un conjunto de datos. Para obtener más información acerca de la edición de un conjunto de datos, consulte [Edición de conjuntos de datos](edit-a-data-set.md). 

1. Aparece una lista de conjuntos de datos. Elija un conjunto de datos y, a continuación, elija **Seleccionar**. Para cancelar, elija **Cancelar**.

# Sustitución de conjuntos de datos
<a name="replacing-data-sets"></a>

En un análisis, puede añadir, editar, sustituir o eliminar conjuntos de datos. Utilice esta sección para obtener información sobre cómo sustituir un conjunto de datos. 

Cuando se sustituye un conjunto de datos, el conjunto de datos nuevo debe tener columnas similares para que el elemento visual se comporte de acuerdo con la forma en que fue diseñado. Al sustituir el conjunto de datos, también se borra el historial de deshacer y rehacer para el análisis. Esto significa que no se pueden utilizar los botones de deshacer y rehacer de la barra de aplicaciones para desplazarse por los cambios. Por lo tanto, cuando decida sustituir el conjunto de datos, el diseño del análisis debe encontrarse en una fase estable, no en medio de una fase de edición.

**Reemplazo de un conjunto de datos**

1. En la página de análisis, vaya al panel **Datos** y expanda el menú desplegable **Conjunto de datos**.

1. Elija **Administrar conjuntos de datos**.

1. Elija los puntos suspensivos (...) junto al conjunto de datos que desee reemplazar y, a continuación, elija **Reemplazar**.

1. En la página **Seleccionar conjunto de datos de sustitución**, elija un conjunto de datos de la lista y, a continuación, elija **Seleccionar**.
**nota**  
Al sustituir un conjunto de datos, se borra el historial de deshacer y rehacer para este análisis. 

El conjunto de datos se sustituye por el nuevo. La lista de campos y los elementos visuales se actualizan con el conjunto de datos nuevo. 

En este punto, puede optar por añadir un conjunto de datos nuevo, editarlo o sustituirlo por otro. Elija **Cerrar** para salir. 

## Si el conjunto de datos nuevo no coincide
<a name="replacing-data-sets-2"></a>

En algunos casos, el conjunto de datos de sustitución seleccionado no contiene todos los campos y jerarquías utilizados por los elementos visuales, filtros, parámetros y campos calculados del análisis. Si es así, recibirá una advertencia de Quick Sight que mostrará una lista de columnas que no coinciden o faltan. 

Si esto ocurre, puede actualizar la asignación de campos entre los dos conjuntos de datos. 

**Actualización de la asignación de campos**

1. En la página **Hay incongruencias en el conjunto de datos de sustitución**, seleccione **Actualizar el mapeo de campos**.

1. En la página **Actualizar el mapeo de campos**, seleccione el menú desplegable de los campos que desea sustituir y elija un campo de la lista al que asignarlo.

   Si el campo falta en el nuevo conjunto de datos, seleccione **Ignorar este campo**.

1. Seleccione **Confirmar** para confirmar las actualizaciones.

1. Seleccione **Cerrar** para cerrar la página y volver al análisis.

El conjunto de datos se sustituye por el nuevo. La lista de campos y los elementos visuales se actualizan con el conjunto de datos nuevo.

Todos los elementos visuales que utilizaban un campo que ahora falta en el nuevo conjunto de datos se actualizan y quedan en blanco. Puede añadir campos al elemento visual o eliminarlo de su análisis.

Si cambia de opinión después de sustituir el conjunto de datos, todavía puede recuperarlo. Supongamos que sustituye el conjunto de datos y, a continuación, descubre que es demasiado difícil modificar el análisis para que coincida con el conjunto de datos nuevo. Puede deshacer los cambios que haya realizado en el análisis. A continuación, puede sustituir el nuevo conjunto de datos por el original o por un conjunto de datos que coincida mejor con los requisitos del análisis. 

# Eliminación de un conjunto de datos de un análisis
<a name="delete-a-data-set-from-an-analysis"></a>

Utilice el siguiente procedimiento para eliminar un conjunto de datos de un análisis.

**Eliminación de un conjunto de datos de un análisis**

1. En la página de análisis, vaya al panel **Datos** y expanda el menú desplegable **Conjunto de datos**.

1. Elija **Administrar conjuntos de datos**.

1. Elija los puntos suspensivos (...) junto al conjunto de datos que desee reemplazar y, a continuación, elija **Quitar**. No puede eliminar un conjunto de datos si es el único que existe en el análisis.

1. Seleccione **Cerrar** para cerrar el cuadro de diálogo.

# Uso de fuentes de datos en Amazon Quick Sight
<a name="working-with-data-sources"></a>

Utilice un origen de datos para acceder a un almacén de datos externo. Los orígenes de datos de Amazon S3 guardan la información del archivo de manifiesto. Por el contrario, Salesforce y los orígenes de datos de base de datos guardan información de la conexión como las credenciales. En esos casos, puede crear fácilmente varios conjuntos de datos desde el almacén de datos sin tener que volver a introducir información. La información de conexión no se guarda para archivos de texto o Microsoft Excel. 

**Topics**
+ [Creación de un origen de datos](create-a-data-source.md)
+ [Edición de un origen de datos](edit-a-data-source.md)
+ [Eliminación de un origen de datos](delete-a-data-source.md)

# Creación de un origen de datos
<a name="create-a-data-source"></a>


|  | 
| --- |
|    Público objetivo: autores de Amazon Quick  | 

Como autor de análisis en Amazon Quick, no necesita saber nada sobre la infraestructura que utiliza para conectarse a sus datos. Solo se configura un nuevo origen de datos una vez. 

Una vez configurada una fuente de datos, puede acceder a ella desde su mosaico en la consola Quick. Puede usarlo para crear uno o más conjuntos de datos. Después de configurar un conjunto de datos, también puede acceder al conjunto de datos desde su icono. Al abstraer los detalles técnicos, Amazon Quick Sight simplifica las conexiones de datos. 

**nota**  
No es necesario que almacene la configuración de conexión de los archivos que piensa cargar manualmente. Para obtener más información acerca de las cargas de archivos, consulte [Creación de conjuntos de datos](creating-data-sets.md).

Antes de empezar a añadir un nuevo perfil de conexión a la fuente de datos a Amazon Quick, recopile primero la información que necesita para conectarse a la fuente de datos. En algunos casos, es posible que tenga previsto copiar y pegar la configuración de un archivo. Si es así, asegúrese de que el archivo no contenga caracteres de formato (puntos que indican los diferentes elementos de la lista o números) ni caracteres de espacio en blanco (espacios, tabuladores). También asegúrese de que el archivo no contenga caracteres “gremlin” que no sean de texto, como caracteres no ASCII, null (ASCII 0) y de control. 

La siguiente lista incluye la información para recopilar la configuración más utilizada:
+ El origen de datos al que se va a conectar.

  Asegúrese de saber a qué origen debe conectarse para generar informes. Este origen es posible que sea diferente del origen que almacena, procesa o proporciona acceso a los datos. 

  Por ejemplo, digamos que es un nuevo analista en una gran empresa. Desea analizar los datos del sistema de pedidos, que sabe que utiliza Oracle. Sin embargo, no puede consultar directamente los datos de procesamiento de transacciones en línea (OLTP). Un subconjunto de datos se extrae y se almacena en un bucket de Amazon S3, pero tampoco tiene acceso a eso. Sus nuevos compañeros de trabajo explican que utilizan AWS Glue rastreadores para leer los archivos y acceder AWS Lake Formation a ellos. Al investigar más, descubrirá que necesita usar una consulta de Amazon Athena como fuente de datos en Amazon Quick Sight. La clave aquí es que no siempre es obvio qué tipo de origen de datos elegir.
+ Un nombre descriptivo para el nuevo icono de origen de datos.

  Cada nueva conexión de origen de datos necesita un nombre único y descriptivo. Este nombre aparece en la lista de fuentes de datos existentes de Amazon Quick Sight, que se encuentra en la parte inferior de la pantalla **Crear un conjunto de datos**. Utilice un nombre que facilite la distinción de sus orígenes de datos de otros orígenes de datos similares. El nuevo perfil de fuente de datos de Amazon Quick Sight muestra tanto el logotipo del software de base de datos como el nombre personalizado que le asigne.
+ El nombre del servidor o instancia al que se va a conectar.

  Otro identificador o un nombre único identifica el conector del servidor del origen de datos de la red. Los descriptores varían en función de a cuál se conecte, pero normalmente es alguno de los siguientes: 
  + Hostname
  + Dirección IP
  + ID del clúster
  + ID de instancia
  + Connector
  + URL basada en el sitio
+ El nombre de la colección de datos que desea utilizar.

  El descriptor varía en función del origen de datos, pero suele ser uno de los siguientes: 
  + Base de datos
  + Warehouse
  + Bucket de S3
  + Catálogo
  + Esquema

  En algunos casos, es posible que deba incluir un archivo de manifiesto o una consulta. 
+ El nombre de usuario que desea que utilice Amazon Quick Sight.

  Cada vez que Amazon Quick Sight se conecta mediante este perfil de fuente de datos (mosaico), utiliza el nombre de usuario de la configuración de conexión. En algunos casos, este es posible que sea su inicio de sesión personal. Pero si va a compartir esto con otras personas, pregunte al administrador del sistema sobre la creación de credenciales para usarlas en las conexiones de Amazon Quick Sight. 
+ Qué tipo de conexión usar. Puede elegir una red pública o una conexión de VPC. Si tiene más de una conexión de VPC disponible, decida cuál usar para llegar a su origen de datos.
+ Algunos orígenes de datos requieren configuraciones adicionales, como la capa de conexión segura (SSL) o los tokens de la API.

Después de guardar la configuración de conexión como un perfil de origen de datos, puede crear un conjunto de datos seleccionando su icono. Las conexiones se almacenan como perfiles de conexión de fuentes de datos en Amazon Quick Sight. 

Para ver sus perfiles de conexión existentes, abra la página de inicio rápido, elija **Datos**, elija **Crear** y, a continuación, elija **Nuevo conjunto de datos**.

Para obtener una lista de las conexiones de orígenes de datos admitidas y ejemplos, consulte [Conéctese a sus datos con integraciones y conjuntos de datos](connecting-to-data-examples.md).

Después de crear una fuente de datos en Quick Sight, puede [crear un conjunto de datos](https://docs.aws.amazon.com/quicksuite/latest/userguide/creating-data-sets) en Quick Sight que contenga datos de la fuente de datos conectada. También puede [actualizar la información de conexión del origen de datos](https://docs.aws.amazon.com/quicksuite/latest/userguide/edit-a-data-source) en cualquier momento.

# Edición de un origen de datos
<a name="edit-a-data-source"></a>

Puede editar un origen de datos de base de datos existente para actualizar la información de conexión, como el nombre del servidor o las credenciales de usuario. También puede editar un origen de datos de Amazon Athena existente para actualizar el nombre del origen de datos. No puede editar orígenes de datos de Amazon S3 o Salesforce.

## Edición de un origen de datos de base de datos
<a name="edit-a-database-data-source"></a>

Utilice el siguiente procedimiento para editar un origen de datos de base de datos.

1. En la página de inicio rápido, seleccione **Datos** a la izquierda. Elija **Crear** y, a continuación, elija **Nuevo conjunto de datos**.

1. Elija una fuente de datos de base de datos.

1. Elija **Edit Data Source**.

1. Modifique la información del origen de datos:
   + Si está editando un origen de datos de base de datos descubierto automáticamente, puede modificar cualquiera de los siguientes ajustes:
     + En **Nombre de origen de datos**, escriba un nombre para el origen de datos.
     + En **ID de instancia**, elija el nombre de la instancia o clúster al que desea conectarse en la lista proporcionada.
     + **Nombre de base de datos** muestra la base de datos predeterminada del clúster o instancia de **ID de instancia**. Si desea utilizar una base de datos diferente en ese clúster o instancia, escriba su nombre.
     + Para **UserName**, introduzca el nombre de usuario de una cuenta de usuario que tenga permisos para hacer lo siguiente: 
       + Acceder a la base de datos de destino. 
       + Leer las tablas de esa base de datos que desee utilizar (realizar una instrucción `SELECT` en ellas).
     + En **Contraseña**, introduzca la contraseña de la cuenta que ha introducido.
   + Si está editando un origen de datos de base de datos externo, puede modificar cualquiera de los siguientes ajustes:
     + En **Nombre de origen de datos**, escriba un nombre para el origen de datos.
     + En **Servidor de base de datos**, escriba uno de los siguientes valores:
       + Para un clúster de Amazon Redshift, escriba el punto de conexión del clúster sin el número de puerto. Por ejemplo, si el valor del punto enlace es `clustername.1234abcd.us-west-2.redshift.amazonaws.com:1234`, escriba `clustername.1234abcd.us-west-2.redshift.amazonaws.com`. Puede obtener el valor del punto de conexión del campo **Punto de conexión** en la página de detalles del clúster en la consola de Amazon Redshift.
       + Para una instancia de Amazon EC2 de PostgreSQL, MySQL o SQL Server, escriba la dirección DNS pública. Puede obtener el valor del DNS público en el campo **Public DNS** del panel de detalles de la instancia de la consola de EC2.
       + Para una instancia que no sea de Amazon EC2 de PostgreSQL, MySQL o SQL Server, escriba el nombre de host o dirección IP pública del servidor de base de datos.
     + En **Puerto**, escriba el puerto que el clúster o la instancia utiliza para las conexiones.
     + En **Nombre de base de datos**, escriba el nombre de la base de datos que desee utilizar.
     + Para **UserName**, introduzca el nombre de usuario de una cuenta de usuario que tenga permisos para hacer lo siguiente: 
       + Acceder a la base de datos de destino. 
       + Leer las tablas de esa base de datos que desee utilizar (realizar una instrucción `SELECT` en ellas).
     + En **Contraseña**, introduzca la contraseña de la cuenta que ha introducido.

1. Elija **Validate connection**.

1. Si la conexión se valida, elija **Actualizar origen de datos**. En caso contrario, corrija la información de la conexión y vuelve a validar de nuevo.

1. Si desea crear un nuevo conjunto de datos utilizando el origen de datos actualizado, continúe con las instrucciones de [Creación de un conjunto de datos a partir de una base de datos](create-a-database-data-set.md). En caso contrario, cierre el cuadro de diálogo **Elija su tabla**.

## Edición de un origen de datos de Athena
<a name="revoking-access-to-shared-data-sources"></a>

Utilice el siguiente procedimiento para editar un origen de datos de Athena.

1. En la página de inicio rápido, seleccione **Datos** a la izquierda. Elija **Crear** y, a continuación, elija **Nuevo conjunto de datos**.

1. Elija una fuente de datos de Athena.

1. Elija **Edit Data Source**.

1. En **Nombre de origen de datos**, escriba un nuevo nombre.

1. Aparecerá la pantalla **Administrar uso compartido de origen de datos**. En la pestaña **Usuarios**, localice el usuario que desea eliminar. 

1. Si desea crear un nuevo conjunto de datos utilizando el origen de datos actualizado, continúe con las instrucciones de [Creación de un conjunto de datos utilizando datos de Amazon Athena](create-a-data-set-athena.md). En caso contrario, cierre el cuadro de diálogo **Elija su tabla**.

# Eliminación de un origen de datos
<a name="delete-a-data-source"></a>

Puede eliminar un origen de datos en caso de que ya no sea necesario. La eliminación de un origen de datos de base de datos basado en una consulta hace que los conjuntos de datos asociados sean inservibles. La eliminación de un origen de datos correspondiente a una base de datos de Amazon S3, Salesforce o SPICE no afectará a su capacidad para utilizar los conjuntos de datos asociados. Esto se debe a que los datos se almacenan en [SPICE](spice.md). Sin embargo, ya no podrá actualizar dichos conjuntos de datos.

**Eliminación de un origen de datos**

1. Elija el origen de datos que desea eliminar.

1. Elija **Eliminar**.

# Actualización de datos en Amazon Quick Sight
<a name="refreshing-data"></a>

Al actualizar los datos, Amazon Quick Sight gestiona los conjuntos de datos de forma diferente según las propiedades de conexión y la ubicación de almacenamiento de los datos.

Si Quick Sight se conecta al banco de datos mediante una consulta directa, los datos se actualizan automáticamente al abrir un conjunto de datos, un análisis o un panel asociado. Los controles del filtro se actualizan automáticamente cada 24 horas.

Para actualizar SPICE los conjuntos de datos, Quick Sight debe autenticarse de forma independiente mediante las credenciales almacenadas para conectarse a los datos. Quick Sight no puede actualizar los datos cargados manualmente, ni siquiera desde los buckets de S3, aunque estén almacenados en ellos, SPICE porque Quick Sight no almacena sus metadatos de conexión y ubicación. Si desea actualizar automáticamente los datos almacenados en un bucket de S3, cree un conjunto de datos con la tarjeta de origen de datos de **S3**.

En el caso de los archivos que ha cargado manualmente a SPICE, para actualizarlos manualmente, vuelva a importar el archivo. Si desea reutilizar el nombre del conjunto de datos original para el nuevo archivo, primero cambie el nombre del conjunto de datos original o elimínelo. A continuación, asigne el nombre que prefiera al nuevo conjunto de datos. Además, compruebe que los nombres de los campos tengan el mismo nombre y tipo de datos. Abra el análisis y sustituya el conjunto de datos original por el nuevo conjunto de datos. Para obtener más información, consulte [Sustitución de conjuntos de datos](replacing-data-sets.md).

Puede actualizar los conjuntos de datos de [SPICE](spice.md) en cualquier momento. Al actualizar, se importan de nuevo los datos en SPICE, por lo que los datos incluyen los cambios desde la última importación.

En el caso de Amazon Quick Sight Standard Edition, puede realizar una actualización completa de sus SPICE datos en cualquier momento. Para Amazon Quick Sight Enterprise Edition, puede realizar una actualización completa o incremental (solo fuentes de datos basadas en SQL) en cualquier momento.

**nota**  
Si su conjunto de datos usa CustomSQL, es posible que la actualización incremental no le beneficie. Si la consulta SQL es compleja, es posible que la base de datos no pueda optimizar el filtro con la ventana retrospectiva. Esto puede provocar que la consulta que extrae los datos tarde más que una actualización completa. Le recomendamos que intente reducir el tiempo de ejecución de la consulta refactorizando el SQL personalizado. Tenga en cuenta que los resultados pueden variar según el tipo de optimización que realice.

Puede actualizar los datos de SPICE mediante uno de los siguientes métodos: 
+ Puede utilizar las opciones de la página **Conjuntos de datos**. 
+ Puede actualizar un conjunto de datos mientras lo edita.
+ Puede programar actualizaciones en los ajustes del conjunto de datos.
+ Puede utilizar la operación de la [CreateIngestion](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateIngestion.html)API para actualizar los datos.

Al crear o editar un conjunto de datos de SPICE, puede habilitar las notificaciones por correo electrónico sobre el estado de carga de los datos. Esta opción notifica a los propietarios del conjunto de datos si los datos no se cargan o actualizan. Para activar las notificaciones, seleccione la opción **Propietarios de correo electrónico cuando se produce un error en una actualización**, que aparece en la pantalla **Terminar de crear el conjunto de datos**. Esta opción no está disponible para los conjuntos de datos que cree mediante **Cargar un archivo** en la página de conjuntos de datos. 

En los temas siguientes, puede encontrar una explicación de los diferentes enfoques para actualizar y trabajar con datos de SPICE.

**Topics**
+ [Importación de datos en SPICE](spice.md)
+ [Actualización de datos en SPICE](refreshing-imported-data.md)
+ [Uso de datos de SPICE en un análisis](spice-in-an-analysis.md)
+ [Visualización del historial de ingesta de SPICE](view-history-of-spice-ingestion.md)
+ [Solución de errores de filas omitidas](troubleshooting-skipped-rows.md)
+ [Códigos de error de ingesta de SPICE](errors-spice-ingestion.md)
+ [Actualización de los archivos de un conjunto de datos](updating-file-dataset.md)

# Importación de datos en SPICE
<a name="spice"></a>

Cuando importa datos a un conjunto de datos en lugar de utilizar una consulta SQL directa, se convierten en *SPICEdatos* debido a la forma en que se almacenan. *SPICE (Super-fast, Parallel, In-memory Calculation Engine)*es el robusto motor en memoria que utiliza Amazon Quick Sight. Está diseñado para realizar cálculos avanzados y ofrecer datos de forma rápida. En Enterprise Edition, los datos almacenados en SPICE se cifran en reposo.

Al crear o editar un conjunto de datos, puede elegir entre utilizar una consulta de SPICE o una consulta directa, a menos que el conjunto de datos contenga archivos cargados. La importación (también denominada *ingesta*) de sus datos a SPICE puede ahorrar tiempo y dinero:
+ Sus consultas analíticas se procesan más rápido.
+ No tiene que esperar a que se procese una consulta directa. 
+ Los datos almacenados en SPICE se pueden reutilizar varias veces sin incurrir en costos adicionales. Si utiliza un origen de datos que cobra por consulta, se le cobrará por consultar los datos cuando cree el conjunto de datos por primera vez y, más adelante, cuando lo actualice. 

SPICEla capacidad se asigna por separado para cada uno Región de AWS. La SPICE capacidad predeterminada se asigna automáticamente a su hogar Región de AWS. En cada AWS cuenta, todas las personas que utilizan Quick Sight comparten la SPICE capacidad en una sola cuenta Región de AWS. Las demás no Regiones de AWS tienen SPICE capacidad a menos que decidas comprar alguna. Los administradores de Quick Sight pueden ver cuánta [SPICE](#spice)capacidad tiene en cada una de ellas Región de AWS y cuánta de ella está en uso actualmente. Un administrador de Quick Sight puede adquirir más SPICE capacidad o liberar la SPICE capacidad no utilizada según sea necesario. Para obtener más información, consulte [Configurar SPICE la capacidad de memoria](managing-spice-capacity.md).

**Topics**
+ [Estimación del tamaño de los conjuntos de datos de SPICE](#spice-capacity-formula)

## Estimación del tamaño de los conjuntos de datos de SPICE
<a name="spice-capacity-formula"></a>

El tamaño de un conjunto de datos en SPICE relación con la SPICE capacidad de su cuenta Quick se denomina *tamaño lógico*. El tamaño lógico de un conjunto de datos no es el mismo que el tamaño de la tabla o el archivo de origen del conjunto de datos. El cálculo de tamaño lógico de un conjunto de datos se produce después de haber definido todas las transformaciones de tipos de datos y las columnas calculadas durante la preparación de datos. Estos campos se materializan en SPICE de forma que se mejora el desempeño de las consultas. Los cambios que realice en un análisis no afectan al tamaño lógico de los datos en SPICE. Solo los cambios que se guardan en el conjunto de datos se aplican a la capacidad de SPICE.

El tamaño lógico de un conjunto de datos de SPICE depende de los tipos de datos de los campos del conjunto de datos y del número de filas del conjunto de datos. Los tres tipos de datos de SPICE son decimales, fechas y cadenas. Puede transformar el tipo de datos de un campo durante la fase de preparación de los datos para adaptarlo a sus necesidades de visualización de datos. Por ejemplo, el archivo que desea importar puede contener todas las cadenas (texto). Pero para que se usen de forma significativa en un análisis, prepare los datos cambiando los tipos de datos a su formato adecuado. Los campos que contienen precios se pueden cambiar de cadenas a decimales, y los campos que contienen fechas se pueden cambiar de cadenas a fechas. También puede crear campos calculados y excluir de la tabla de origen los campos que no necesite. Cuando haya terminado de preparar el conjunto de datos y se hayan completado todas las transformaciones, podrá estimar el tamaño lógico del esquema final.

**nota**  
Los tipos de datos geoespaciales utilizan metadatos para interpretar el tipo de datos físicos. La latitud y la longitud son numéricos. Todas las demás categorías geoespaciales son cadenas.

En la siguiente fórmula, los decimales y las fechas se calculan como 8 bytes por celda con 4 bytes adicionales como auxiliares. Las cadenas se calculan en función de la longitud del texto con la codificación UTF-8 más 24 bytes con la codificación auxiliar. Los tipos de datos de cadena requieren más espacio debido a la indexación adicional que necesita SPICE para proporcionar un alto rendimiento de consulta.

```
Logical dataset size in bytes =
(Number of Numeric cells *  (12 bytes per cell))
+ (Number of Date cells    *  (12 bytes per cell))
+ SUM ((24 bytes + UTF-8 encoded length) per Text cell)
```

La fórmula anterior solo debe usarse para estimar el tamaño de un único conjunto de datos de SPICE. El uso SPICE de la capacidad es el tamaño total de todos los conjuntos de datos de una cuenta en una región específica. Quick Sight no recomienda que utilice esta fórmula para estimar la SPICE capacidad total que utiliza su cuenta de Quick Sight.

# Actualización de datos en SPICE
<a name="refreshing-imported-data"></a>

## Actualización de un conjunto de datos
<a name="refresh-spice-data"></a>

Utilice el siguiente procedimiento para actualizar un [SPICE](spice.md)conjunto de datos basado en una fuente de datos de Amazon S3 o de una base de datos en la pestaña **Datos**. Si hay un cambio de esquema en una base de datos, Quick Sight no podrá detectarlo automáticamente, lo que provocará un error de ingestión. Edite y guarde el conjunto de datos para actualizar el esquema y evitar errores de ingestión.

**Para actualizar SPICE los datos desde la pestaña Datos**

1. Seleccione **Datos** en el menú de navegación de la izquierda. En la pestaña **Conjuntos de datos**, elige el conjunto de datos para abrirlo. 

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Actualizar** y, a continuación, seleccione **Actualizar ahora**.

1. Mantenga el tipo de actualización como **Actualización completa**.

1. Si desea actualizar un conjunto de datos de Amazon S3, elija una de las opciones siguientes en **Manifiesto de S3**:
   + Para usar el mismo archivo de manifiesto que proporcionaste por última vez a Amazon Quick Sight, selecciona **Manifiesto existente**. Si ha cambiado el archivo de manifiesto en la ubicación del archivo o la URL facilitada la última vez, los datos devueltos reflejan dichos cambios. 
   + Para especificar un nuevo archivo de manifiesto cargándolo desde la red local, elija **Cargar manifiesto** y, a continuación, elija **Cargar archivo de manifiesto**. En **Abrir**, elija un archivo y, a continuación, seleccione **Abrir**.
   + Para especificar un nuevo archivo de manifiesto proporcionando una URL, escriba la URL del manifiesto en **Introducir URL del manifiesto**. Puede buscar la URL del archivo de manifiesto en la consola de Amazon S3 abriendo el menú contextual (clic con el botón derecho) del archivo de manifiesto, eligiendo **Propiedades** y consultando el cuadro **Enlace**.

1. Elija **Actualizar**.

1. Si desea actualizar un conjunto de datos de Amazon S3, elija **Aceptar** y, a continuación, **Aceptar** de nuevo.

   Si desea actualizar un conjunto de datos de base de datos, elija **Aceptar**.

## Actualizar un conjunto de datos de forma incremental
<a name="refresh-spice-data-incremental"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

En el caso de los orígenes de datos basados en SQL, como Amazon Redshift, Amazon Athena, PostgreSQL o Snowflake, puede actualizar los datos de forma incremental en un periodo de tiempo retrospectivo. 

Una *actualización incremental* consulta únicamente los datos definidos por el conjunto de datos dentro de una ventana retrospectiva específica. Transfiere todas las inserciones, eliminaciones y modificaciones al conjunto de datos, dentro del periodo de tiempo de esa ventana, desde su origen al conjunto de datos. Los datos que se encuentran actualmente en SPICE que están dentro de esa ventana se eliminan y se sustituyen por las actualizaciones.

Con las actualizaciones incrementales, se consultan y transfieren menos datos por cada actualización. Por ejemplo, supongamos que tiene un conjunto de datos con 180 000 registros que contiene datos del 1 de enero al 30 de junio. El 1 de julio, usted realiza una actualización incremental de los datos con una ventana retrospectiva de siete días. Quick Sight consulta la base de datos y solicita todos los datos desde el 24 de junio (hace 7 días), es decir, 7.000 registros. A continuación, Quick Sight elimina los datos actualmente disponibles SPICE desde el 24 de junio y años posteriores y anexa los datos consultados recientemente. Al día siguiente (2 de julio), Quick Sight hace lo mismo, pero consulta a partir del 25 de junio (de nuevo, 7.000 registros) y, a continuación, los elimina del conjunto de datos existente de la misma fecha. En lugar de tener que ingerir 180 000 registros todos los días, solo tiene que incorporar los datos de 7000 registros.

Utilice el siguiente procedimiento para actualizar de forma incremental un [SPICE](spice.md)conjunto de datos en función de una fuente de datos SQL desde la pestaña **Conjuntos** de datos.

**Actualización incremental de un conjunto de datos de SPICE basado en SQL**

1. Elija **Datos** en el menú de navegación de la izquierda. En la pestaña **Conjuntos de datos**, elige el conjunto de datos para abrirlo.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Actualizar** y, a continuación, seleccione **Actualizar ahora**.

1. En **Tipo de actualización**, elija **Actualización incremental**.

1. Si esta es su primera actualización incremental en el conjunto de datos, elija **Configurar**.

1. En la página **Configurar actualización incremental**, haga lo siguiente:

   1. En **Columna de fecha**, elija una columna de fecha en la que desee basar la ventana retrospectiva.

   1. En **Tamaño de ventana**, introduzca un número para el **tamaño** y, a continuación, elija el periodo de tiempo en el que desee revisar los cambios.

      Puede elegir actualizar los cambios en los datos que se produjeron en un número específico de horas, días o semanas a partir de ahora. Por ejemplo, puede optar por actualizar los cambios en los datos que se hayan producido en un plazo de dos semanas a partir de la fecha actual.

1. Elija **Enviar**.

## Actualización de un conjunto de datos durante la preparación de datos
<a name="refresh-spice-data-prep"></a>

Utilice el procedimiento siguiente para actualizar un conjunto de datos de [SPICE](spice.md) basado en un origen de datos de Amazon S3 o de base de datos durante la preparación de los datos.

**Actualización de los datos de SPICE durante la preparación de datos**

1. Selecciona **Datos** en el menú de navegación de la izquierda. En la pestaña **Conjuntos de datos**, elija el conjunto de datos y, a continuación, elija **Editar conjunto de datos**.

1. En la pantalla del conjunto de datos, seleccione **Actualizar ahora**.

1. Mantenga el tipo de actualización establecido en **Actualización completa**. 

1. (Opcional) Si desea actualizar un conjunto de datos de Amazon S3, elija una de las opciones siguientes en **Manifiesto de S3**:
   + Para usar el mismo archivo de manifiesto que proporcionó por última vez a Amazon Quick Sight, elija **Manifiesto existente**. Si ha cambiado el archivo de manifiesto en la ubicación del archivo o la URL facilitada la última vez, los datos devueltos reflejan dichos cambios.
   + Para especificar un nuevo archivo de manifiesto cargándolo desde la red local, elija **Cargar manifiesto** y, a continuación, elija **Cargar archivo de manifiesto**. En **Abrir**, elija un archivo y, a continuación, seleccione **Abrir**.
   + Para especificar un nuevo archivo de manifiesto proporcionando una URL, escriba la URL del manifiesto en **Introducir URL del manifiesto**. Puede buscar la URL del archivo de manifiesto en la consola de Amazon S3 abriendo el menú contextual (clic con el botón derecho) del archivo de manifiesto, eligiendo **Propiedades** y consultando el cuadro **Enlace**.

1. Elija **Actualizar**.

1. Si desea actualizar un conjunto de datos de Amazon S3, elija **Aceptar** y, a continuación, **Aceptar** de nuevo.

   Si desea actualizar un conjunto de datos de base de datos, elija **Aceptar**.

## Actualización de un conjunto de datos en una programación
<a name="schedule-data-refresh"></a>

Utilice el siguiente procedimiento para programar la actualización de los datos. Si el conjunto de datos se basa en una consulta directa y no se ha almacenado en [SPICE](spice.md), puede actualizar los datos abriendo el conjunto de datos. También puede actualizar los datos actualizando la página en un análisis o panel.

**Actualización de los datos de [SPICE](spice.md) siguiendo una programación**

1. Selecciona **Datos** en el menú de navegación de la izquierda. En la pestaña **Conjuntos de datos**, elige el conjunto de datos para abrirlo.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Actualizar** y, a continuación, seleccione **Agregar nueva programación**.

1. En la pantalla **Crear una programación de actualización**, elija la configuración de su programación:

   1. En **Zona horaria**, elija la zona horaria que se aplica a la actualización de datos.

   1. En **Hora de inicio**, elija una fecha en la que comenzar la actualización. Utilice el formato HH:MM y de 24 horas; por ejemplo, 13:30.

   1. En **Frecuencia**, elija una de las siguientes opciones:
      + Para las ediciones Standard o Enterprise, puede elegir **Diariamente**, **Semanalmente** o **Mensualmente**. 
        + **Diariamente**: se repite todos los días.
        + **Semanalmente**: se repite el mismo día de cada semana.
        + **Mensualmente**: se repite el mismo día de cada mes. Para actualizar los datos el 29, 30 o 31 del mes, elija **Último día del mes** en la lista. 
      + Solo en el caso de la edición Enterprise, puede elegir **Por hora**. Este ajuste actualiza el conjunto de datos cada hora, comenzando a la hora que elija. Por lo tanto, si selecciona la 1:05 como hora de inicio, los datos se actualizarán a cada hora y cinco minutos.

        Si decide utilizar una actualización por hora, no podrá utilizar también programas de actualización adicionales. Para crear una programación por hora, elimine cualquier otra programación existente para ese conjunto de datos. Además, elimine cualquier programación horaria existente antes de crear una programación diaria, semanal o mensual. 

1. Seleccione **Save**. 

Las ingestas programadas de los conjuntos de datos se realizan en un plazo de 10 minutos a partir de la fecha y hora programadas.

Con la consola rápida, puede crear cinco planificaciones para cada conjunto de datos. Una vez que se creen cinco, se inhabilita el botón **Crear**.

## Actualización incremental de un conjunto de datos según una programación
<a name="schedule-data-refresh-incremental"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

Para los orígenes de datos basados en SQL, como Amazon Redshift, Athena, PostgreSQL o Snowflake, puede programar actualizaciones incrementales. Utilice el siguiente procedimiento para actualizar de forma incremental un [SPICE](spice.md)conjunto de datos en función de una fuente de datos SQL en la pestaña Conjuntos de **datos.**

**Para establecer una programación de actualización incremental para un conjunto de datos de SPICE basado en SQL.**

1. Elija **Datos** en el menú de navegación de la izquierda. En la pestaña **Conjuntos de datos**, elige el conjunto de datos para abrirlo.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Actualizar** y, a continuación, seleccione **Agregar nueva programación**.

1. En la página **Crear una programación**, en **Tipo de actualización**, seleccione **Actualización incremental**.

1. Si esta es su primera actualización incremental para este conjunto de datos, elija **Configurar** y, a continuación, haga lo siguiente:

   1. En **Columna de fecha**, elija una columna de fecha en la que desee basar la ventana retrospectiva.

   1. En **Tamaño de ventana**, introduzca un número para el **tamaño** y, a continuación, elija el periodo de tiempo en el que desee revisar los cambios.

      Puede elegir actualizar los cambios en los datos que se produjeron en un número específico de horas, días o semanas a partir de ahora. Por ejemplo, puede optar por actualizar los cambios en los datos que se hayan producido en un plazo de dos semanas a partir de la fecha actual.

   1. Elija **Enviar**.

1. En **Zona horaria**, elija la zona horaria que se aplica a la actualización de datos.

1. **Repeticiones**: permite elegir una de las siguientes opciones:
   + Puede elegir **Cada 15 minutos**, **Cada 30 minutos**, **Cada hora**, **Diariamente**, **Semanalmente** o **Mensualmente**.
     + **Cada 15 minutos**: se repite cada 15 minutos, empezando a la hora que elija. Por lo tanto, si selecciona la 1:05 como hora de inicio, los datos se actualizarán a la 1:20, luego nuevamente a la 1:35, y así sucesivamente. 
     + **Cada 30 minutos**: se repite cada 30 minutos, empezando a la hora que elija. Por lo tanto, si selecciona la 1:05 como hora de inicio, los datos se actualizarán a la 1:35, luego nuevamente a las 2:05, y así sucesivamente. 
     + **Cada hora**: se repite cada hora, empezando a la hora que elija. Por lo tanto, si selecciona la 1:05 como hora de inicio, los datos se actualizarán a cada hora y cinco minutos.
     + **Diariamente**: se repite todos los días.
     + **Semanalmente**: se repite el mismo día de cada semana.
     + **Mensualmente**: se repite el mismo día de cada mes. Para actualizar los datos el 29, 30 o 31 del mes, elija **Último día del mes** en la lista. 
   + Si decide usar una actualización cada 15 minutos, 30 minutos, o cada hora, no podrá utilizar también programaciones de actualización adicionales. Para crear una programación de actualización cada 15 minutos, 30 minutos o cada hora, elimine cualquier otro programación existente para ese conjunto de datos. Además, elimine cualquier programación por minuto u horaria existente antes de crear una programación diaria, semanal o mensual. 

1. En **Inicio**, elija una fecha en la que comenzar la actualización.

1. En **A la(s)**, especifique la hora en que debería iniciarse la actualización. Utilice el formato HH:MM y de 24 horas; por ejemplo, 13:30.

Las ingestas programadas de los conjuntos de datos se realizan en un plazo de 10 minutos a partir de la fecha y hora programadas.

En algunos casos, es posible que algo vaya mal con el conjunto de datos de actualización incremental y que quiera revertirlo. O puede que ya no desee actualizar el conjunto de datos de forma incremental. Si es así, puede eliminar la actualización programada. 

Para ello, elija el conjunto de datos en la página **Conjuntos de datos**, elija **Programar una actualización** y, a continuación, elija el icono x situado a la derecha de la actualización programada. Al eliminar una configuración de actualización incremental, se inicia una actualización completa. Como parte de esta actualización completa, se eliminan todas las configuraciones preparadas para las actualizaciones incrementales.

# Uso de datos de SPICE en un análisis
<a name="spice-in-an-analysis"></a>

Cuando se utilizan datos almacenados para crear un análisis, aparece un indicador de importación de datos junto a la lista de conjuntos de datos situada en la parte superior del panel **Lista de campos**. Cuando abre el análisis por primera vez y el conjunto de datos se está importando, aparece un icono giratorio.

Después de llevar a cabo la importación de SPICE, el indicador muestra el porcentaje de filas que se han importado correctamente. También aparece un mensaje en la parte superior del panel de visualización para indicar los recuentos de las filas importadas y omitidas.

Si se han omitido filas, puede elegir **View summary** en este mensaje para ver detalles sobre por qué las filas no se han importado. Para editar el conjunto de datos y resolver los problemas que han llevado a que se omitiesen filas, seleccione **Editar conjunto de datos**. Para obtener más información acerca de las causas comunes que dan lugar a la omisión de filas, consulte [Solución de errores de filas omitidas](troubleshooting-skipped-rows.md).

Si se produce un error de importación, el indicador de importación de datos se muestra como un icono de exclamación y aparece el mensaje **Error al importar**.

# Visualización del historial de ingesta de SPICE
<a name="view-history-of-spice-ingestion"></a>

Puede ver el historial de ingesta de los conjuntos de datos de SPICE para averiguar, por ejemplo, cuándo comenzó la última ingesta y cuál es su estado. 

La página del historial de ingesta de SPICE incluye la siguiente información:
+ Fecha y hora de inicio de la incorporación de datos (UTC)
+ Estado de la incorporación de datos
+ Tiempo necesario para la incorporación de datos
+ La cantidad de filas agregadas en el conjunto de datos.
+ La cantidad de filas incorporadas durante una actualización.
+ Filas omitidas y filas incorporadas (importadas) correctamente
+ El tipo de trabajo para la actualización: programado, actualización completa, etc.

Utilice el siguiente procedimiento para ver el historial de ingesta de SPICE de un conjunto de datos.

**Visualización del historial de ingesta de SPICE de un conjunto de datos**

1. En la página de inicio, selecciona **Datos a la izquierda**.

1. En la pestaña **Conjuntos** de datos, elige el conjunto de datos que deseas examinar.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Actualizar**.

   El historial de ingesta de SPICE se muestra en la parte inferior.

1. (Opcional) Seleccione un período para filtrar las entradas desde la última hora hasta los últimos 90 días.

1. (Opcional) Seleccione un estado de trabajo específico para filtrar las entradas, por ejemplo, en los estados **En ejecución** o **Completado**. De lo contrario, puede ver todas las entradas seleccionando **Todas**. 

# Solución de errores de filas omitidas
<a name="troubleshooting-skipped-rows"></a>

Al importar datos, Amazon Quick Sight previsualiza una parte de los datos. Si no puede interpretar una fila por algún motivo, Quick Sight la omite. En algunos casos, la importación fallará. Cuando esto ocurre, Quick Sight devuelve un mensaje de error que explica el error.

Afortunadamente, hay un número limitado de cosas que pueden salir mal. Algunos problemas se pueden evitar si se tienen en cuenta ejemplos como los siguientes:
+ Asegúrese de que no haya incoherencias entre el tipo de datos de campo y los datos de campo, por ejemplo, datos de cadena ocasionales en un campo con un tipo de datos numéricos. Estos son algunos ejemplos que pueden resultar difíciles de detectar al escanear el contenido de una tabla: 
  + `''`: usar una cadena vacía para indicar un valor que falta
  + `'NULL'`: usar la palabra “nulo” para indicar un valor que falta
  + `$1000`: incluir un signo de dólar en el valor de una divisa lo convierte en una cadena
  + `'O'Brien'`: usar la puntuación para marcar una cadena que a su vez contiene la misma puntuación. 

  Sin embargo, este tipo de error no siempre es tan fácil de encontrar, especialmente si tiene muchos datos o si los escribe a mano. Por ejemplo, algunas aplicaciones de ventas o de servicio al cliente implican introducir información proporcionada verbalmente por los clientes. Es posible que la persona que escribió originalmente los datos los haya colocado en el campo incorrecto. Es posible que añada, u olvide añadir, un carácter o un dígito. Por ejemplo, podría introducir la fecha “0/10/12020” o introducir el género de una persona en un campo destinado a la edad.
+ Asegúrese de que el archivo importado se procesa correctamente con o sin encabezado. Si hay una fila de encabezado, asegúrese de elegir la opción de subida **Contiene encabezado**.
+ Asegúrese de que los datos no superen uno o más de los [Cuotas de origen de datos](data-source-limits.md).
+ Asegúrese de que los datos sean compatibles con los [Tipos de datos y valores admitidos](supported-data-types-and-values.md). 
+ Asegúrese de que los campos calculados contienen datos que funcionan con el cálculo, en lugar de ser incompatibles con la función del campo calculado o excluidos por ella. Por ejemplo, si tiene un campo calculado en su conjunto de datos que utiliza[parseDate](parseDate-function.md), Quick Sight omite las filas en las que ese campo no contiene una fecha válida.

Quick Sight proporciona una lista detallada de los errores que se producen cuando el SPICE motor intenta ingerir datos. Cuando un conjunto de datos guardado informa de filas omitidas, puede ver los errores para tomar medidas y solucionar los problemas.

**Visualización de los errores de las filas que se omitieron durante la ingesta de SPICE (importación de datos)**

1. Seleccione **Datos** a la izquierda. En la pestaña **Conjuntos** de datos, elija el conjunto de datos problemático para abrirlo.

1. En la página de detalles del conjunto de datos que se abre, seleccione la pestaña **Actualizar**.

   El historial de ingesta de SPICE se muestra en la parte inferior.

1. Para la ingesta con el error, seleccione **Ver resumen de errores**. Este enlace se encuentra en la columna **Estado**. 

1. Examine el **registro de importación de archivos** que se abre. Muestra las siguientes secciones:
   + **Resumen**: proporciona una puntuación porcentual del número de filas que se omitieron del número total de filas en la importación. Por ejemplo, si se omiten 864 filas de un total de 1728, la puntuación es del 50,00 %.
   + **Filas omitidas**: proporciona el recuento de filas, el nombre del campo y el mensaje de error de cada conjunto de filas omitidas similares.
   + **Solución de problemas**: proporciona un enlace para descargar un archivo que contiene información de error.

1. En **Solución de problemas**, seleccione **Descargar el archivo de filas de error**. 

   El archivo de errores tiene una fila para cada error. El archivo se denomina `error-report_123_fe8.csv`, y `123_fe8` se reemplaza por una cadena de identificación única. El archivo contiene las siguientes columnas:
   + **ERROR\$1TYPE**: el tipo o el código de error del error que se produjo al importar esta fila. Puede buscar este error en la sección [Códigos de error de ingesta de SPICE](errors-spice-ingestion.md) que sigue a este procedimiento.
   + **COLUMN\$1NAME**: el nombre de la columna en sus datos que provocó el error. 
   + Todas las columnas de la fila importada: las columnas restantes duplican toda la fila de datos. Si una fila tiene más de un error, puede aparecer varias veces en este archivo.

1. Seleccione **Editar conjunto de datos** para realizar cambios en su conjunto de datos. Puede filtrar los datos, omitir campos, cambiar los tipos de datos, ajustar los campos calculados existentes y añadir campos calculados que validen los datos.

1. Una vez que haya realizado los cambios indicados por los códigos de error, vuelva a importar los datos. Si aparecen más errores de ingesta de SPICE en el registro, repita este procedimiento para corregir todos los errores restantes.

**sugerencia**  
Si no puede resolver los problemas con los datos en un periodo de tiempo razonable mediante el editor de conjuntos de datos, consulte a los administradores o desarrolladores propietarios de los datos. A largo plazo, resulta más rentable limpiar los datos más cerca de su origen, en lugar de añadir un procesamiento de excepciones mientras se preparan los datos para su análisis. Al corregirlo en el origen, se evita una situación en la que varias personas corrijan los errores de diferentes maneras, lo que se traduce en resultados de informes diferentes más adelante.

**Práctica de la solución de problemas de filas omitidas**

1. Descargue [samples/csv-files-for-troubleshooting-skipped-rows.zip](samples/csv-files-for-troubleshooting-skipped-rows.zip).

1. Extraiga los archivos a una carpeta que pueda usar para cargar el archivo.csv de muestra en Quick Sight. 

   El archivo zip contiene los dos siguientes archivos de texto:
   + `sample dataset - data ingestion error.csv`: un ejemplo de archivo .csv que contiene problemas que provocan la omisión de filas. Puede intentar importar el archivo usted mismo para ver cómo funciona el proceso de error. 
   + `sample data ingestion error file`— Un archivo de error de muestra generado durante la SPICE ingesta al importar el archivo.csv de muestra a Quick Sight.

1. Siga estos pasos para importar los datos:

   1. **Seleccione **Datos**, pestaña **Conjuntos de datos,** **Nuevo**, Conjunto de datos.**

   1. Elija **Cargar un archivo**.

   1. Busque y elija el archivo denominado `sample dataset - data ingestion error.csv`.

   1. Seleccione **Cargar un archivo**, **Edite la configuración y prepare los datos**.

   1. Seleccione **Guardar** para salir.

1. Elija su conjunto de datos para ver su información y, a continuación, seleccione **Ver resumen de errores**. Examine los errores y los datos para ayudarle a resolver los problemas.

# Códigos de error de ingesta de SPICE
<a name="errors-spice-ingestion"></a>

La siguiente lista de códigos de error y descripciones puede ayudarle a comprender y solucionar problemas con la ingesta de datos en SPICE.

## Códigos de error para las filas omitidas
<a name="errors-skipped-rows-during-import"></a>

La siguiente lista de códigos de error y descripciones puede ayudarle a comprender y solucionar problemas con las filas omitidas. 

****ARITHMETIC\$1EXCEPTION****: se produjo una excepción aritmética al procesar un valor.

****ENCODING\$1EXCEPTION****: se produjo una excepción desconocida al convertir y codificar datos en SPICE.

****OPENSEARCH\$1CURSOR\$1NOT\$1ENABLED — El OpenSearch dominio no tiene los cursores SQL habilitados**** (). `"opendistro.sql.cursor.enabled" : "true"` Para obtener más información, consulte [Autorización de conexiones a Amazon Service OpenSearch](opensearch.md).

****INCORRECT\$1FIELD\$1COUNT****: una o más filas tienen demasiados campos. Asegúrese de que el número de campos de cada fila coincida con el número de campos definido en el esquema.

****INCORRECT\$1SAGEMAKER\$1OUTPUT\$1FIELD\$1COUNT****: la salida de la IA tiene un número inesperado de campos. SageMaker 

****INDEX\$1OUT\$1OF\$1BOUNDS****: el sistema solicitó un índice que no es válido para la matriz o lista que se está procesando.

****MALFORMED\$1DATE****: el valor de un campo no se puede transformar en una fecha válida. Por ejemplo, si intenta convertir un campo que contiene un valor como `"sale date"` o `"month-1"`, la acción genera un error de fecha con formato incorrecto. Para corregir este error, elimine los valores que no sean de fecha del origen de datos. Compruebe que no está importando un archivo con un encabezado de columna mezclado con los datos. Si la cadena contiene una fecha u hora que no se convierte, consulte [Uso de fechas no admitidas o personalizadas](using-unsupported-dates.md).

****MISSING\$1SAGEMAKER\$1OUTPUT\$1FIELD: SageMaker un**** campo de la salida de la IA está vacío inesperadamente.

****NUMBER\$1BITWIDTH\$1TOO\$1LARGE****: un valor numérico supera la longitud admitida en SPICE. Por ejemplo, el valor numérico tiene más de 19 dígitos, que es la longitud de un tipo de datos de `bigint`. Para una secuencia numérica larga que no sea un valor matemático, utilice un tipo de datos de `string`.

****NUMBER\$1PARSE\$1FAILURE****: un valor de un campo numérico no es un número. Por ejemplo, un campo con un tipo de datos de `int` contiene una cadena o un valor flotante.

****SAGEMAKER\$1OUTPUT\$1COLUMN\$1TYPE\$1MISMATCH: el tipo de datos definido en el esquema de la IA no coincide con el tipo de datos recibido de la IA****. SageMaker SageMaker 

****STRING\$1TRUNCATION****: una cadena se trunca por SPICE. Las cadenas se truncan cuando la longitud de la cadena supera la cuota de SPICE. Para obtener más información acerca de SPICE, consulte [Importación de datos en SPICE](spice.md). Para obtener más información sobre las cuotas, consulte [Service Quotas](https://docs.aws.amazon.com/servicequotas/latest/userguide/intro.html). 

****UNDEFINED****: se produjo un error desconocido al incorporar datos.

****UNSUPPORTED\$1DATE\$1VALUE****: un campo de fecha contiene una fecha que tiene un formato compatible, pero que no se encuentra en el intervalo de fechas admitido, por ejemplo, “31/12/1399” o “01/01/10000”. Para obtener más información, consulte [Uso de fechas no admitidas o personalizadas](using-unsupported-dates.md). 

## Códigos de error durante la importación de datos
<a name="errors-during-import"></a>

Para los trabajos de importación y actualización de datos que fallan, Quick Sight proporciona un código de error que indica la causa del error. La siguiente lista de códigos de error y descripciones puede ayudarle a comprender y solucionar problemas con la ingesta de datos en SPICE.

****ACCOUNT\$1CAPACITY\$1LIMIT\$1EXCEEDED****: estos datos superan la capacidad actual de SPICE. Adquiera más capacidad de SPICE o limpie los datos existentes de SPICE y, a continuación, vuelva a intentar esa ingesta.

****CONNECTION\$1FAILURE:**** Amazon Quick Sight no puede conectarse a su fuente de datos. Compruebe la configuración de la conexión del origen de datos e inténtelo de nuevo.

****CUSTOMER\$1ERROR****: se ha producido un problema al analizar los datos. Si esto persiste, póngase en contacto con el soporte técnico de Amazon Quick Sight.

****DATA\$1SET\$1DELETED****: el origen de datos o conjunto de datos se eliminó o dejó de estar disponible durante la ingesta.

****DATA\$1SET\$1SIZE\$1LIMIT\$1EXCEEDED****: este conjunto de datos supera el tamaño máximo permitido del conjunto de datos de SPICE. Utilice filtros para reducir el tamaño del conjunto de datos e inténtelo de nuevo. Para obtener información sobre las cuotas de SPICE, consulte [Cuotas de origen de datos](data-source-limits.md).

****DATA\$1SOURCE\$1AUTH\$1FAILED****: error en la autenticación del origen de datos. Compruebe sus credenciales y utilice la opción **Editar origen de datos** para reemplazar las credenciales caducadas.

****DATA\$1SOURCE\$1CONNECTION\$1FAILED****: error de conexión del origen de datos. Compruebe la dirección URL e inténtelo de nuevo. Si este error persiste, póngase en contacto con el administrador del origen de datos para obtener ayuda.

****DATA\$1SOURCE\$1NOT\$1FOUND****: no se ha encontrado el origen de datos. Comprueba tus fuentes de datos de Amazon Quick Sight.

****DATA\$1TOLERANCE\$1EXCEPTION****: hay demasiadas filas no válidas. Amazon Quick Sight ha alcanzado la cuota de filas que puede omitir y seguir ingiriendo. Compruebe sus datos e inténtelo de nuevo.

****FAILURE\$1TO\$1ASSUME\$1ROLE — Amazon Quick Sight no pudo asumir la función**** (IAM) correcta. AWS Identity and Access Management Compruebe las directivas de `Amazon Quick Sight-service-role` en la consola de IAM.

****FAILURE\$1TO\$1PROCESS\$1JSON\$1FILE — Amazon Quick Sight no ha podido analizar un archivo**** de manifiesto como un JSON válido.

****IAM\$1ROLE\$1NOT\$1AVAILABLE****: Amazon Quick Sight no tiene permiso para acceder a la fuente de datos. Para administrar los permisos de Amazon Quick Sight en AWS los recursos, vaya a la página **Seguridad y permisos** de la opción **Administrar Amazon Quick Sight** como administrador.

****INGESTION\$1CANCELED****: el usuario canceló la ingesta.

****INGESTION\$1SUPERSEDED****: esta ingesta se ha reemplazado por otro flujo de trabajo. Esto sucede cuando se crea una nueva ingesta mientras otra está aún en proceso. Evite editar manualmente el conjunto de datos varias veces en un corto periodo, porque cada edición manual crea una nueva ingesta que reemplazará y finalizará la ingesta anterior.

****INTERNAL\$1SERVICE\$1ERROR****: se ha producido un error de servicio interno.

****INVALID\$1DATA\$1SOURCE\$1CONFIG****: aparecieron valores no válidos en la configuración de la conexión. Compruebe los detalles de la conexión e inténtelo de nuevo.

****INVALID\$1DATAPREP\$1SYNTAX****: la expresión del campo calculada contiene una sintaxis no válida. Corrija la sintaxis e inténtelo de nuevo.

****INVALID\$1DATE\$1FORMAT****: apareció un formato de fecha no válido.

****IOT\$1DATA\$1SET\$1FILE\$1EMPTY: no se encontró ningún**** dato de Analytics. AWS IoT Compruebe su cuenta e inténtelo de nuevo.

****IOT\$1FILE\$1NOT\$1FOUND****: no se encontró el archivo de Analytics indicado. AWS IoT Compruebe su cuenta e inténtelo de nuevo.

****OAUTH\$1TOKEN\$1FAILURE****: las credenciales al origen de datos han caducado. Renueve sus credenciales y vuelva a intentar esta incorporación de datos.

****PASSWORD\$1AUTHENTICATION\$1FAILURE****: aparecieron credenciales incorrectas para un origen de datos. Actualice sus credenciales de origen de datos y vuelva a intentar esa incorporación de datos.

****PERMISSION\$1DENIED****: el origen de datos denegó el acceso a los recursos solicitados. Solicita los permisos al administrador de la base de datos o asegúrate de que se ha concedido el permiso adecuado a Amazon Quick Sight antes de volver a intentarlo.

****QUERY\$1TIMEOUT****: se agotó el tiempo de espera de una consulta del origen de datos que esperaba respuesta. Compruebe los registros del origen de datos e inténtelo de nuevo.

****ROW\$1SIZE\$1LIMIT\$1EXCEEDED****: la cuota del tamaño de la fila superó el máximo.

****S3\$1FILE\$1INACCESSIBLE****: no se pudo conectar a un bucket de S3. Asegúrese de conceder a Amazon Quick Sight y a los usuarios los permisos necesarios antes de conectarse al bucket de S3.

****S3\$1MANIFEST\$1ERROR****: no se pudo conectar a los datos de S3. Asegúrese de que el archivo del manifiesto de S3 sea válido. Compruebe también el acceso a los datos de S3. Tanto Amazon Quick Sight como el usuario de Amazon Quick Sight necesitan permisos para conectarse a los datos de S3.

****S3\$1UPLOADED\$1FILE\$1DELETED****: el archivo o archivos de la ingesta se han eliminado (entre ingestas). Compruebe su bucket de S3 e inténtelo de nuevo.

****SOURCE\$1 API\$1LIMIT \$1EXCEEDED\$1FAILURE****: esta ingesta supera la cuota de API para esta fuente de datos. Póngase en contacto con el administrador del origen de datos para obtener ayuda.

****SOURCE\$1RESOURCE\$1LIMIT\$1EXCEEDED****: una consulta SQL supera la cuota de recursos del origen de datos. Entre los ejemplos de recursos involucrados se pueden incluir la cuota de consultas simultáneas, la cuota de conexión y los recursos físicos del servidor. Póngase en contacto con el administrador del origen de datos para obtener ayuda.

****SPICE\$1TABLE\$1NOT\$1FOUND****: una fuente de datos o conjunto de datos de Amazon Quick Sight se eliminó o dejó de estar disponible durante la ingestión. Comprueba tu conjunto de datos en Amazon Quick Sight e inténtalo de nuevo. Para obtener más información, consulte [Solución de errores de filas omitidas](troubleshooting-skipped-rows.md).

****SQL\$1EXCEPTION****: se produjo un error de SQL general. Este error puede deberse a tiempos de espera de consulta, restricciones de recursos, cambios inesperados del lenguaje de definición de datos (DDL) antes o durante una consulta y a otros errores de base de datos. Compruebe la configuración de la base de datos y la consulta e inténtelo de nuevo.

****SQL\$1INVALID\$1PARAMETER\$1VALUE****: apareció un parámetro SQL no válido. Compruebe su SQL e inténtelo de nuevo.

****SQL\$1NUMERIC\$1OVERFLOW**** — Amazon Quick Sight detectó una excepción numérica. out-of-range Compruebe los valores relacionados y las columnas calculadas para ver si hay desbordamientos e inténtelo de nuevo.

****SQL\$1SCHEMA\$1MISMATCH\$1ERROR****: el esquema de la fuente de datos no coincide con el conjunto de datos de Amazon Quick Sight. Actualice la definición del conjunto de datos de Amazon Quick Sight.

****SQL\$1TABLE\$1NOT\$1FOUND**** — Amazon Quick Sight no encuentra la tabla en la fuente de datos. Compruebe la tabla especificada en el conjunto de datos o SQL personalizado e inténtelo de nuevo.

****SSL\$1CERTIFICATE\$1VALIDATION\$1FAILURE****: Amazon Quick Sight no puede validar el certificado Secure Sockets Layer (SSL) en el servidor de bases de datos. Compruebe el estado SSL en ese servidor con el administrador de la base de datos e inténtelo de nuevo.

****UNRESOLVABLE\$1HOST****: Amazon Quick Sight no puede resolver el nombre de host de la fuente de datos. Compruebe el nombre de host del origen de datos e inténtelo de nuevo.

****UNROUTABLE\$1HOST**** — Amazon Quick Sight no puede acceder a la fuente de datos porque está dentro de una red privada. Asegúrese de que su conexión de VPC privada esté configurada correctamente en Enterprise Edition o permita que los rangos de direcciones IP de Amazon Quick Sight permitan la conectividad en la Edición Estándar. 

# Actualización de los archivos de un conjunto de datos
<a name="updating-file-dataset"></a>

Para obtener la versión más reciente de los archivos, puede actualizar los archivos de su conjunto de datos. Puede actualizar estos tipos de archivos:
+ Archivos de texto delimitados por comas (CSV) y por tabulaciones (TSV)
+ Archivos de formato de registro común y ampliado (ELF y CLF)
+ Archivos de datos semiestructurados o sin formato (JSON)
+ Archivos de Microsoft Excel (XLSX)

Antes de actualizar un archivo, asegúrese de que el nuevo archivo tenga los mismos campos en el mismo orden que el archivo original que se encuentra actualmente en el conjunto de datos. Si hay discrepancias en los campos (columnas) entre los dos archivos, se produce un error y es necesario corregirlas antes de intentar volver a actualizarlos. Para ello, edite el nuevo archivo para que coincida con el original. Tenga en cuenta que si desea añadir nuevos campos, puede añadirlos después de los campos originales del archivo. Por ejemplo, en una hoja de cálculo de Microsoft Excel, puede añadir nuevos campos a la derecha de los campos originales.

**Actualización de un archivo en un conjunto de datos**

1. En Quick Sight, selecciona **Datos** a la izquierda.

1. En la pestaña **Conjuntos** de datos, elige el conjunto de datos que deseas actualizar y, a continuación, selecciona **Editar conjunto** de datos.

1. En la página de preparación de datos que se abre, seleccione la lista desplegable del archivo que desee actualizar y, a continuación, seleccione **Actualizar archivo**.

1. En la página **Actualizar archivo** que se abre, seleccione **Arctualizar archivo** y, a continuación, navegue hasta un archivo.

   Quick Sight escanea el archivo.

1. Si el archivo es un archivo de Microsoft Excel, elija la hoja que desee en la página **Elija su hoja** que se abre y, a continuación, elija **Seleccionar**.

1. Seleccione **Confirmar la actualización del archivo** en la página siguiente. Se muestra una vista previa de algunas de las columnas de la hoja como referencia.

   En la parte superior derecha aparece un mensaje en el que se indica que el archivo se ha actualizado correctamente y la vista previa de la tabla se actualiza para mostrar los nuevos datos del archivo.

# Preparación de datos en Amazon Quick Sight
<a name="preparing-data"></a>

Los conjuntos de datos almacenan cualquier preparación de datos que haya realizado para que pueda volver a utilizarlos en diferentes análisis. La preparación de datos proporciona opciones como, por ejemplo, añadir campos calculados, aplicar filtros y cambiar nombres de campos o tipos de datos. Si está basando el origen de datos en una base de datos SQL, también puede utilizar la preparación de datos para unir tablas. O puede escribir una consulta SQL si desea trabajar con datos de más de una tabla.

Si desea transformar los datos de una fuente de datos antes de utilizarlos en Amazon Quick Sight, puede prepararlos para que se adapten a sus necesidades. A continuación, guarde esa preparación como parte del conjunto de datos. 

Puede preparar un conjunto de datos cuando lo crea o editarlo más adelante. Para obtener más información sobre la creación de un nuevo conjunto de datos y su preparación, consulte [Creación de conjuntos de datos](creating-data-sets.md). Para obtener más información sobre la apertura de un conjunto de datos existente para la preparación de datos, consulte [Edición de conjuntos de datos](edit-a-data-set.md).

Utilice los siguientes temas para obtener más información sobre la preparación de datos.

**Topics**
+ [Experiencia de preparación de datos (nueva)](data-prep-experience-new.md)
+ [Descripción de los datos](describing-data.md)
+ [Selección de la configuración de carga de archivos](choosing-file-upload-settings.md)
+ [Experiencia en preparación de datos (heredada)](data-prep-experience-legacy.md)
+ [Uso de SQL para personalizar los datos](adding-a-SQL-query.md)
+ [Adición de datos geoespaciales](geospatial-data-prep.md)
+ [Uso de fechas no admitidas o personalizadas](using-unsupported-dates.md)
+ [Añadir una clave única a un conjunto de datos de Amazon Quick Sight](set-unique-key.md)
+ [Integración de los modelos de Amazon SageMaker AI con Amazon Quick Sight](sagemaker-integration.md)
+ [Preparación de ejemplos de un conjunto de datos](preparing-data-sets.md)

# Experiencia de preparación de datos (nueva)
<a name="data-prep-experience-new"></a>

La preparación de datos transforma los datos sin procesar en un formato optimizado para el análisis y la visualización. En la inteligencia empresarial, este proceso crucial implica limpiar, estructurar y enriquecer los datos para obtener información empresarial significativa.

La interfaz de preparación de datos de Amazon Quick Sight revoluciona este proceso con una experiencia visual e intuitiva que permite a los usuarios crear conjuntos de datos listos para el análisis sin necesidad de conocimientos de SQL. Gracias a su enfoque moderno y simplificado, los usuarios pueden crear y administrar conjuntos de datos de inteligencia empresarial de manera eficiente. La interfaz visual presenta una visión clara y secuencial de las transformaciones de los datos, lo que permite a los autores realizar un seguimiento preciso de los cambios desde el estado inicial hasta el resultado final.

La plataforma hace hincapié en la colaboración y la reutilización, lo que permite a los equipos compartir y reutilizar los flujos de trabajo en toda la organización. Este diseño colaborativo promueve la coherencia en las prácticas de transformación de datos y, al mismo tiempo, elimina el trabajo redundante y, en última instancia, fomenta la estandarización de los procesos en todos los equipos y mejora la eficiencia general.

**Topics**
+ [Componentes de la experiencia de preparación de datos](data-prep-components.md)
+ [Pasos de preparación de datos](data-prep-steps.md)
+ [Capacidades de flujo de trabajo avanzadas](advanced-workflow-capabilities.md)
+ [Funciones exclusivas de Spice](spice-only-features.md)
+ [Cambiar entre experiencias de preparación de datos](switching-between-data-prep-experiences.md)
+ [Funciones no compatibles con la nueva experiencia de preparación de datos](unsupported-features.md)
+ [Límites de preparación de datos](data-preparation-limits.md)
+ [Cambios en el comportamiento de ingestión](ingestion-behavior-changes.md)
+ [Preguntas frecuentes](new-data-prep-faqs.md)

# Componentes de la experiencia de preparación de datos
<a name="data-prep-components"></a>

La experiencia de preparación de datos de Amazon Quick Sight incluye los siguientes componentes principales.

## Flujo de trabajo
<a name="workflow-component"></a>

Un flujo de trabajo en la experiencia de preparación de datos de Quick Sight representa una serie secuencial de pasos de transformación de datos que guían el conjunto de datos desde su estado original hasta un formato listo para el análisis. Estos flujos de trabajo están diseñados para ser reutilizables, lo que permite a los analistas aprovechar y aprovechar el trabajo existente y, al mismo tiempo, mantener estándares de transformación de datos consistentes en toda la organización.

Si bien los flujos de trabajo pueden adaptarse a múltiples rutas a través de distintas entradas o mediante divergencias (se detalla en las secciones siguientes), en última instancia, deben converger en una única tabla de resultados. Esta estructura unificada garantiza la coherencia de los datos y optimiza las capacidades de análisis.

## Transformación
<a name="transformation-component"></a>

Una transformación es una operación de manipulación de datos específica que cambia la estructura, el formato o el contenido de los datos. La experiencia de preparación de datos de Quick Sight ofrece varios tipos de transformación, como unir, filtrar, agregar, pivotar, despivotar, anexar y columnas calculadas. Cada tipo de transformación tiene un propósito distinto al remodelar los datos para cumplir con los requisitos analíticos. Estas transformaciones se implementan como pasos individuales dentro de su flujo de trabajo.

## Paso
<a name="step-component"></a>

Un paso es un conjunto de transformaciones homogéneas del mismo tipo que se aplican en el flujo de trabajo. Cada paso contiene una o más operaciones relacionadas de la misma categoría de transformación. Por ejemplo, un paso de cambio de nombre puede incluir operaciones de cambio de nombre de varias columnas y un paso de filtrado puede contener varias condiciones de filtrado, todas gestionadas como una sola unidad en el flujo de trabajo.

La mayoría de los pasos pueden incluir varias operaciones, con dos excepciones notables: los pasos de unir y anexar están limitados a dos tablas de entrada por paso. Para unir o anexar más de dos tablas, puede crear pasos adicionales de unión o incorporación secuencialmente.

Los pasos se muestran en orden, y cada paso se basa en los resultados de los pasos anteriores, lo que le permite realizar un seguimiento de la transformación progresiva de los datos. Para cambiar el nombre de un paso o eliminarlo, selecciónelo y elija el menú de tres puntos.

## Connector
<a name="connector-component"></a>

El conector enlaza dos pasos con una flecha que indica la dirección del flujo de trabajo. Puede eliminar un conector seleccionándolo y pulsando la tecla de borrado. Para añadir un paso entre dos pasos existentes, basta con eliminar el conector, añadir el nuevo paso y volver a conectar los escalones arrastrando el ratón entre ellos.

## Panel de configuración
<a name="configure-pane-component"></a>

El **panel de configuración** es el área interactiva en la que se definen los parámetros y la configuración de un paso seleccionado. Al seleccionar un paso del flujo de trabajo, este panel muestra las opciones relevantes para ese tipo de transformación específico. Por ejemplo, al configurar un paso de unión, puede seleccionar el tipo de unión, las columnas coincidentes y otros ajustes específicos de la unión. La point-and-click interfaz del **panel de configuración** elimina la necesidad de conocimientos de SQL.

## Panel de vista previa
<a name="preview-pane-component"></a>

El **panel de vista previa** muestra una muestra de los datos en tiempo real tal y como aparecen después de aplicar el paso de transformación actual. Esta información visual inmediata le ayuda a comprobar que cada transformación produce los resultados esperados antes de continuar con el siguiente paso. El **panel de vista previa** se actualiza dinámicamente a medida que se modifican las configuraciones de los pasos, lo que permite refinar iterativamente las transformaciones de datos con confianza.

Estos componentes funcionan en conjunto para crear una experiencia de preparación de datos visual e intuitiva que permite a los usuarios empresariales acceder a las transformaciones de datos complejas sin necesidad de conocimientos técnicos.

# Pasos de preparación de datos
<a name="data-prep-steps"></a>

La experiencia de preparación de datos de Amazon Quick Sight ofrece once tipos de pasos eficaces que le permiten transformar sus datos de forma sistemática. Cada paso tiene un propósito específico en el flujo de trabajo de preparación de datos.

Los pasos se pueden configurar a través de una interfaz intuitiva en el panel **de configuración**, con comentarios inmediatos visibles en el panel de **vista previa**. Los pasos se pueden combinar de forma secuencial para crear transformaciones de datos sofisticadas sin necesidad de conocimientos de SQL.

Cada paso puede recibir datos de una tabla física o del resultado de un paso anterior. La mayoría de los pasos aceptan una sola entrada, con la excepción de los pasos Añadir y Unir, que requieren exactamente dos entradas.

## Input
<a name="input-step"></a>

El paso de entrada inicia el flujo de trabajo de preparación de datos en Quick Sight, ya que le permite seleccionar e importar datos de varias fuentes para transformarlos en los pasos siguientes.

**Opciones de entrada**
+ **Añadir conjunto de datos**

  Aproveche los conjuntos de datos de Quick Sight existentes como fuentes de entrada y aproveche los datos que su equipo ya ha preparado y optimizado.
+ **Agregue una fuente de datos**

  Conéctese directamente a bases de datos como Amazon Redshift, Athena, RDS u otras fuentes compatibles seleccionando objetos de base de datos específicos y proporcionando parámetros de conexión.
+ **Añadir carga de archivos**

  Importa datos directamente desde archivos locales en formatos como CSV, TSV, Excel o JSON.

**Configuración**

El paso de entrada no requiere configuración. El panel de **vista previa** muestra los datos importados junto con la información de origen, incluidos los detalles de la conexión, el nombre de la tabla y los metadatos de las columnas.

**Notas de uso**
+ Pueden existir varios pasos de entrada en un mismo flujo de trabajo.
+ Puede añadir pasos de entrada en cualquier punto de su flujo de trabajo.

## Agregue columnas calculadas
<a name="add-calculated-columns-step"></a>

El paso Añadir columnas calculadas le permite crear columnas nuevas mediante expresiones de nivel de fila que realizan cálculos en las columnas existentes. Puede crear columnas nuevas mediante funciones y operadores escalares (a nivel de fila) y aplicar cálculos a nivel de fila que hagan referencia a las columnas existentes.

**Configuración**

**Para configurar el paso Agregar columnas calculadas, en el panel de configuración:**

1. Asigne un nombre a la nueva columna calculada.

1. [Cree expresiones con el editor de cálculos, que admite funciones y operadores a nivel de fila (como [ifelse](ifelse-function.md) y round).](round-function.md)

1. Guarde el cálculo.

1. Obtenga una vista previa de los resultados de la expresión.

1. Añada más columnas calculadas según sea necesario.

**Notas de uso**
+ En este paso solo se admiten cálculos escalares (a nivel de fila).
+ En SPICE, las columnas calculadas se materializan y funcionan como columnas estándar en los pasos siguientes.

## Cambie el tipo de datos
<a name="change-data-type-step"></a>

Quick Sight simplifica la administración de los tipos de datos al admitir cuatro tipos de datos abstractos: `date``decimal`,`integer`, y`string`. Estos tipos abstractos eliminan la complejidad al asignar automáticamente varios tipos de datos de origen a sus equivalentes de Quick Sight. Por ejemplo,, `tinyint` `smallint``integer`, y `bigint` están todos mapeados a`integer`, mientras que `date``datetime`, y `timestamp` están mapeados a. `date`

Esta abstracción significa que solo necesita entender los cuatro tipos de datos de Quick Sight, ya que Quick Sight gestiona automáticamente todas las conversiones y cálculos de los tipos de datos subyacentes al interactuar con diferentes fuentes de datos.

**Configuración**

Para configurar el paso Cambiar el tipo de datos, en el panel **de configuración**:

1. Seleccione la columna que desee convertir.

1. Elija el tipo de datos de destino (`string``integer`,`decimal`, o`date`).

1. Para las conversiones de fecha, especifique la configuración del formato y obtenga una vista previa de los resultados en función de los formatos de entrada. Consulte los [formatos de fecha compatibles](supported-data-types-and-values.md) en Quick Sight.

1. Agregue columnas adicionales para convertirlas según sea necesario.

**Notas de uso**
+ Convierta los tipos de datos de varias columnas en un solo paso para aumentar la eficiencia.
+ Al utilizar SPICE, todos los cambios en los tipos de datos se materializan en los datos importados.

## Cambie el nombre de las columnas
<a name="rename-columns-step"></a>

El paso Cambiar el nombre de las columnas le permite modificar los nombres de las columnas para que sean más descriptivos, fáciles de usar y coherentes con las convenciones de nomenclatura de su organización.

**Configuración**

Para configurar el paso Cambiar el nombre de las columnas, en el panel de **configuración**:

1. Seleccione una columna para asignarle un nombre.

1. Introduzca un nombre nuevo para la columna seleccionada.

1. Añada más columnas para cambiarles el nombre según sea necesario.

**Notas de uso**
+ Todos los nombres de las columnas deben ser únicos en el conjunto de datos.

## Selecciona Columnas
<a name="select-columns-step"></a>

El paso Seleccionar columnas le permite optimizar su conjunto de datos al incluir, excluir y reordenar las columnas. Esto ayuda a optimizar la estructura de datos al eliminar las columnas innecesarias y organizar las restantes en una secuencia lógica para su análisis.

**Configuración**

Para configurar el paso Seleccionar columnas, en el panel **de configuración**:

1. Elija columnas específicas para incluirlas en la salida.

1. Seleccione las columnas en el orden que prefiera para establecer la secuencia.

1. Use **Seleccionar todo** para incluir las columnas restantes en su orden original.

1. Excluya las columnas no deseadas dejándolas sin seleccionar.

**Características principales**
+ Las columnas de salida aparecen en el orden de selección.
+ La **opción Seleccionar todo** conserva la secuencia de columnas original.

**Notas de uso**
+ Las columnas no seleccionadas se eliminan de los pasos siguientes.
+ Optimice el tamaño del conjunto de datos eliminando las columnas innecesarias.

## Anexar
<a name="append-step"></a>

El paso Añadir combina verticalmente dos tablas, de forma similar a una operación UNION ALL de SQL. Quick Sight hace coincidir automáticamente las columnas por nombre y no por secuencia, lo que permite una consolidación de datos eficiente incluso cuando las tablas tienen diferentes órdenes de columnas o números de columnas variables.

**Configuración**

Para configurar el paso Añadir, en el panel de **configuración**:

1. Seleccione dos tablas de entrada para anexarlas.

1. Revise la secuencia de columnas de salida.

1. Examine qué columnas están presentes en ambas tablas o en las tablas individuales.

**Características principales**
+ Hace coincidir las columnas por nombre en lugar de por secuencia.
+ Conserva todas las filas de ambas tablas, incluidos los duplicados.
+ Admite tablas con diferentes números de columnas.
+ Sigue la secuencia de columnas de la Tabla 1 para las columnas coincidentes y, a continuación, agrega columnas únicas de la Tabla 2.
+ Muestra indicadores de origen claros para todas las columnas

**Notas de uso**
+ Utilice primero el paso de cambio de nombre cuando añada columnas con nombres diferentes.
+ Cada paso de adición combina exactamente dos tablas; utilice los pasos de adición adicionales para obtener más tablas.

## Join
<a name="join-step"></a>

El paso Unir combina horizontalmente los datos de dos tablas en función de los valores coincidentes de las columnas especificadas. Quick Sight admite los tipos de unión exterior izquierda, exterior derecha, exterior completa e interior, lo que proporciona opciones flexibles para sus necesidades analíticas. Este paso incluye la resolución inteligente de conflictos de columnas que gestiona automáticamente los nombres de columna duplicados. Si bien las uniones automáticas no están disponibles como un tipo de unión específico, se pueden obtener resultados similares si se utiliza la divergencia del flujo de trabajo.

**Configuración**

Para configurar el paso de unión, en el panel de **configuración**:

1. Seleccione dos tablas de entrada para unirlas.

1. Elija el tipo de unión (exterior izquierda, exterior derecha, exterior completa o interior).

1. Especifique las claves de unión de cada tabla.

1. Revise los conflictos de nombres de columnas que se resuelven automáticamente.

**Características principales**
+ Admite varios tipos de uniones para diferentes necesidades analíticas.
+ Resuelve automáticamente los nombres de columnas duplicados.
+ Acepta columnas calculadas como claves de unión.

**Notas de uso**
+ Las claves de unión deben tener tipos de datos compatibles; utilice el paso Cambiar tipo de datos si es necesario.
+ Cada paso de unión combina exactamente dos tablas; utilice pasos de unión adicionales para obtener más tablas.
+ Cree un paso de cambio de nombre después de la unión para personalizar los encabezados de las columnas que se resuelven automáticamente.

## Agregado
<a name="aggregate-step"></a>

El paso Agregar permite resumir los datos agrupando columnas y aplicando operaciones de agregación. Esta poderosa transformación condensa los datos detallados en resúmenes significativos basados en las dimensiones especificadas. Quick Sight simplifica las operaciones SQL complejas a través de una interfaz intuitiva, que ofrece funciones de agregación integrales que incluyen operaciones de cadenas avanzadas como y. `ListAgg` `ListAgg distinct`

**Configuración**

Para configurar el paso de agregación, en el panel **de configuración**:

1. Seleccione las columnas por las que desee agruparlas.

1. Elija funciones de agregación para las columnas de medidas.

1. Personalice los nombres de las columnas de salida.

1. Para `ListAgg` y `ListAgg distinct`:

   1. Seleccione la columna que desee agregar.

   1. Elija un separador (coma, guión, punto y coma o línea vertical).

1. Obtenga una vista previa de los datos resumidos.

**Funciones compatibles por tipo de datos**


| Tipo de datos | Funciones compatibles | 
| --- | --- | 
|  Numérico  |  `Average`, `Sum` `Count`, `Count Distinct` `Max`, `Min`  | 
|  Date  |  `Count`, `Count Distinct` `Max`, `Min` `ListAgg`, `ListAgg distinct` (solo por fecha)  | 
|  Cadena  |  `ListAgg`, `ListAgg distinct` `Count`, `Count Distinct` `Max`, `Min`  | 

**Características principales**
+ Aplica diferentes funciones de agregación a las columnas del mismo paso.
+ **Agrupar por** sin funciones de agregación actúa como SQL SELECT DISTINCT.
+ `ListAgg`concatena todos los valores; `ListAgg distinct` incluye solo valores únicos.
+ `ListAgg`las funciones mantienen un orden de clasificación ascendente de forma predeterminada.

**Notas de uso**
+ La agregación reduce significativamente el número de filas en el conjunto de datos.
+ `ListAgg`y `ListAgg distinct` admiten `date` valores, pero no`datetime`.
+ Utilice separadores para personalizar el resultado de la concatenación de cadenas.

## Filtro
<a name="filter-step"></a>

El paso de filtrado le permite restringir el conjunto de datos al incluir solo las filas que cumplen criterios específicos. Puede aplicar varias condiciones de filtrado en un solo paso, y combinarlas mediante la `AND` lógica para ayudar a centrar el análisis en los datos relevantes.

**Configuración**

Para configurar el paso de filtrado, en el panel **de configuración**:

1. Seleccione una columna para filtrar.

1. Elija un operador de comparación.

1. Especifique los valores del filtro en función del tipo de datos de la columna.

1. Agregue condiciones de filtro adicionales en diferentes columnas si es necesario.

**nota**  
Filtrar filtros con «está dentro» o «no está dentro»: introduzca varios valores (uno por línea).
Filtros numéricos y de fecha: introduzca valores únicos (excepto «entre», que requiere dos valores).

**Operadores compatibles por tipo de datos**


| Tipo de datos | Operadores admitidos | 
| --- | --- | 
|  Número entero y decimal  |  Es igual, no es igual Mayor que, menor que Es mayor o igual que, es menor o igual que Está entre  | 
|  Date  |  ¿Después, antes Está entre Es posterior o igual a, Es anterior o igual a  | 
|  Cadena  |  Es igual, no es igual Empieza con, termina con Contiene, no contiene Está dentro, no está dentro  | 

**Notas de uso**
+ Aplique varias condiciones de filtrado en un solo paso.
+ Mezcle condiciones en distintos tipos de datos.
+ Obtenga una vista previa de los resultados filtrados en tiempo real.

## Pivot
<a name="pivot-step"></a>

El paso dinámico transforma los valores de las filas en columnas únicas y convierte los datos de un formato largo a uno ancho para facilitar la comparación y el análisis. Esta transformación requiere especificaciones de filtrado, agregación y agrupación de valores para gestionar las columnas de salida de forma eficaz.

**Configuración**

Para configurar el paso dinámico, utilice lo siguiente en el panel de **configuración**:

1. **Columna dinámica**: seleccione la columna cuyos valores se convertirán en encabezados de columna (por ejemplo, Categoría).

1. **Valor de fila de la columna dinámica**: filtre los valores específicos para incluirlos (por ejemplo, tecnología o material de oficina).

1. **Encabezado de columna de salida**: personalice los nuevos encabezados de columna (de forma predeterminada, los valores de las columnas pivotantes).

1. **Columna de valores**: seleccione la columna que desee agregar (p. ej., Ventas).

1. **Función de agregación**: elija el método de agregación (por ejemplo, suma).

1. **Agrupar por**: especifique las columnas organizativas (por ejemplo, Segmento).

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/pivot.png)


**Operadores compatibles por tipo de datos**


| Tipo de datos | Operadores admitidos | 
| --- | --- | 
|  Número entero y decimal  |  `Average`, `Sum` `Count`, `Count Distinct` `Max`, `Min`  | 
|  Date  |  `Count`, `Count Distinct` `Max`, `Min` `ListAgg`, `ListAgg distinct` (solo valores de fecha)  | 
|  Cadena  |  `ListAgg`, `ListAgg distinct` `Count`, `Count Distinct` `Max`, `Min`  | 

**Notas de uso**
+ Cada columna pivotada contiene valores agregados de la columna de valores.
+ Personalice los encabezados de las columnas para mayor claridad.
+ Previsualice los resultados de la transformación en tiempo real.

## Despivote
<a name="unpivot-step"></a>

El paso Unpivot transforma las columnas en filas y convierte los datos anchos en un formato más largo y estrecho. Esta transformación ayuda a organizar los datos repartidos en varias columnas en un formato más estructurado para facilitar el análisis y la visualización.

**Configuración**

Para configurar el paso Unpivot, en el panel de **configuración**:

1. Seleccione las columnas para separarlas y convertirlas en filas.

1. Defina los valores de las filas de las columnas de salida. El valor predeterminado es el nombre de la columna original. Algunos ejemplos incluyen tecnología, material de oficina y mobiliario.

1. Asigne un nombre a las dos nuevas columnas de resultados.
   + **Encabezado de columna no pivotado**: el nombre de los nombres de columnas anteriores (por ejemplo, Categoría)
   + Valores de **columna no pivotantes: el nombre de los valores** no pivotantes (por ejemplo, Ventas)

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/unpivot.png)


**Características principales**
+ Conserva todas las columnas no pivotantes de la salida.
+ Crea dos columnas nuevas automáticamente: una para los nombres de columnas anteriores y otra para sus valores correspondientes.
+ Transforma los datos anchos en formato largo.

**Notas de uso**
+ Todas las columnas no pivotantes deben tener tipos de datos compatibles.
+ El número de filas suele aumentar después de no pivotar.
+ Obtenga una vista previa de los cambios en tiempo real antes de aplicarlos.

# Capacidades de flujo de trabajo avanzadas
<a name="advanced-workflow-capabilities"></a>

La experiencia de preparación de datos de Amazon Quick Sight ofrece funciones sofisticadas que mejoran su capacidad de crear transformaciones de datos complejas y reutilizables. En esta sección se describen dos potentes capacidades que amplían el potencial de su flujo de trabajo.

La divergencia le permite crear múltiples rutas de transformación a partir de un solo paso, lo que permite flujos de procesamiento paralelos que se pueden recombinar más adelante. Esta capacidad es particularmente valiosa para escenarios complejos, como uniones automáticas y transformaciones paralelas.

Los conjuntos de datos compuestos le permiten crear estructuras de datos jerárquicas mediante el uso de conjuntos de datos existentes como componentes básicos. Esta función promueve la colaboración entre los equipos y garantiza una lógica empresarial coherente mediante transformaciones reutilizables y estratificadas.

Estas capacidades funcionan en conjunto para proporcionar diseños de flujo de trabajo flexibles, una mejor colaboración en equipo y transformaciones de datos reutilizables. Garantizan un linaje de datos claro y permiten soluciones de preparación de datos escalables, lo que permite a su organización gestionar escenarios de datos cada vez más complejos con eficiencia y claridad.

## Divergencia
<a name="divergence"></a>

Divergence le permite crear múltiples rutas de transformación paralelas a partir de un solo paso de su flujo de trabajo. Estas rutas se pueden transformar de forma independiente y luego recombinarse, lo que permite escenarios de preparación de datos complejos, como las uniones automáticas.

**Crear rutas divergentes**

Para iniciar una divergencia, en tu flujo de trabajo:

1. Seleccione el paso en el que desee crear la divergencia.

1. Selecciona el icono **\$1** que aparece.

1. Configura la nueva rama que aparece.

1. Aplique las transformaciones que desee a cada ruta.

1. Utilice los pasos Unir o Añadir para recombinar las rutas en una única salida.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/divergence.png)


**Características principales**
+ Crea hasta cinco rutas divergentes a partir de un solo paso.
+ Aplica diferentes transformaciones a cada ruta.
+ Recombina las rutas mediante los pasos Unir o Incorporar.
+ Previsualiza los cambios en cada ruta de forma independiente.

**Prácticas recomendadas**
+ Utilice la divergencia para implementar uniones automáticas.
+ Cree copias de datos para transformaciones paralelas.
+ Planifique su estrategia de recombinación (incorpore o añada).
+ Mantenga una nomenclatura clara de las rutas para una mejor visibilidad del flujo de trabajo.

## Conjuntos de datos compuestos
<a name="composite-datasets"></a>

Los conjuntos de datos compuestos le permiten aprovechar los conjuntos de datos existentes y crear estructuras jerárquicas de transformación de datos que se pueden compartir y reutilizar en toda la organización. Quick Sight admite hasta 10 niveles de conjuntos de datos compuestos en los modos SPICE y Direct Query.

**Crear un conjunto de datos compuesto**

Para crear un conjunto de datos compuesto, en tu flujo de trabajo:

1. Seleccione el paso de entrada al crear un conjunto de datos nuevo.

1. Elija **Dataset** como fuente en **Agregar datos**.

1. Seleccione un conjunto de datos existente sobre el que construir.

1. Aplique transformaciones adicionales según sea necesario.

1. Guárdelo como un conjunto de datos nuevo.

**Características principales**
+ Crea estructuras jerárquicas de transformación de datos.
+ Admite hasta 10 niveles de anidación de conjuntos de datos.
+ Compatible con SPICE y Direct Query.
+ Mantiene un linaje de datos claro.
+ Permite transformaciones específicas del equipo.

Esta función mejora la colaboración entre los diferentes equipos. Por ejemplo:


| Rol | Action | Output | 
| --- | --- | --- | 
|  Analista global  |  Crea un conjunto de datos con lógica empresarial global  |  Conjunto de datos A  | 
|  Analista de las Américas  |  Utiliza el conjunto de datos A, agrega lógica regional  |  Conjunto de datos B  | 
|  Analista de Estados Unidos y Occidente  |  Utiliza el conjunto de datos B y añade lógica local  |  Conjunto de datos C  | 

Este enfoque jerárquico promueve una lógica empresarial coherente en toda la organización al asignar una propiedad clara a las capas de transformación. Crea un linaje de datos rastreable y, al mismo tiempo, admite hasta 10 niveles de anidación de conjuntos de datos, lo que permite una gestión de la transformación de datos controlada y sistemática.

**Prácticas recomendadas**
+ Establezca una propiedad clara para cada capa de transformación.
+ Documente las relaciones y dependencias de los conjuntos de datos.
+ Planifique la profundidad jerárquica en función de las necesidades empresariales.
+ Mantenga convenciones de nomenclatura coherentes.
+ Revise y actualice cuidadosamente los conjuntos de datos originales.

# Funciones exclusivas de Spice
<a name="spice-only-features"></a>

El SPICE (motor de cálculo superrápido, paralelo y en memoria) de Amazon Quick Sight permite ciertas funciones de preparación de datos que requieren un uso intensivo de la computación. Estas transformaciones se materializan en SPICE para lograr un rendimiento óptimo, en lugar de ejecutarse en el momento de la consulta.

**Funciones exclusivas de SPICE**


| Steps | Otras capacidades | 
| --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/spice-only-features.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/spice-only-features.html)  | 

**Funciones disponibles tanto en SPICE como DirectQuery**


| Steps | Otras capacidades | 
| --- | --- | 
|  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/spice-only-features.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/spice-only-features.html)  | 

**Prácticas recomendadas**
+ Utilice SPICE para los flujos de trabajo que requieren funciones exclusivas de SPICE.
+ Elija SPICE para optimizar el rendimiento para transformaciones complejas y conjuntos de datos de gran tamaño.
+ Tenga en cuenta DirectQuery las necesidades de datos en tiempo real cuando no se requieran funciones exclusivas de SPICE.

# Cambiar entre experiencias de preparación de datos
<a name="switching-between-data-prep-experiences"></a>

La experiencia de preparación de datos heredada se refiere a la interfaz de preparación de datos anterior de Amazon Quick Sight que existía antes de octubre de 2025. La nueva experiencia de preparación de datos es la interfaz visual mejorada que muestra las secuencias de step-by-step transformación. Los conjuntos de datos antiguos son los que se crearon antes de la nueva experiencia de preparación de datos, mientras que los conjuntos de datos nuevos son los que se crearon después de octubre de 2025.

Al crear un conjunto de datos nuevo, Quick Sight lo dirige automáticamente a la nueva experiencia de preparación de datos. Esta interfaz visual ofrece capacidades mejoradas y una usabilidad mejorada para las tareas de transformación de datos.

## Opción de exclusión
<a name="opt-out"></a>

Antes de guardar y publicar un conjunto de datos, tiene la opción de volver a la experiencia antigua de preparación de datos, si lo prefiere. Esta flexibilidad permite a los equipos realizar la transición a su propio ritmo y, al mismo tiempo, familiarizarse con la nueva interfaz.

**importante**  
Si se guarda y publica un conjunto de datos en la nueva experiencia, no habrá opción de volver a la experiencia anterior. Esto se debe a un diseño, ya que la nueva experiencia incluye nuevas funciones importantes que no son compatibles con la experiencia anterior. Por lo tanto, no se admite la conversión directa de conjuntos de datos de una experiencia a otra. Deberá crear un nuevo conjunto de datos para cambiar a la experiencia anterior.

## flujo de trabajo de transición
<a name="transition-workflow"></a>

Una vez que se guarda un conjunto de datos en la experiencia nueva o heredada, las transformaciones no se pueden convertir directamente de una experiencia a otra. Sin embargo, si existe una versión de conjunto de datos publicada, puede usar el control de versiones para ir a la versión anterior, que podría estar en la experiencia anterior.

Los conjuntos de datos antiguos seguirán siendo accesibles para su visualización y edición exclusivamente a través de la interfaz antigua. Esto mantiene la compatibilidad con los flujos de trabajo previamente establecidos.

Antes de completar la transición, tómese un tiempo para familiarizarse con la nueva experiencia de preparación de datos. Cuando trabaje con conjuntos de datos heredados, considere la posibilidad de crear una nueva versión utilizando la nueva experiencia para futuras modificaciones. Utilice el control de versiones para mantener el acceso a las versiones antiguas de los conjuntos de datos si es necesario. Documente cualquier cambio en el flujo de trabajo al pasar de una experiencia antigua a una nueva para garantizar la alineación del equipo.

# Funciones no compatibles con la nueva experiencia de preparación de datos
<a name="unsupported-features"></a>

Si bien la nueva experiencia de preparación de datos ofrece capacidades mejoradas, algunas funciones de la experiencia anterior aún no son compatibles. En esta sección se describen estas funciones y se proporcionan instrucciones para gestionar los flujos de trabajo afectados.

Cuando se utilizan fuentes de datos no compatibles, Amazon Quick Sight adopta automáticamente la experiencia anterior de forma predeterminada. Para ver otras funciones no compatibles, selecciona **Cambiar a una experiencia antigua** en la esquina superior derecha de la página de preparación de datos. Los conjuntos de datos de reglas creados en la experiencia antigua siguen siendo compatibles con los conjuntos de datos de experiencias antiguas y nuevas.

## Fuentes de datos no compatibles
<a name="unsupported-data-sources"></a>

Las siguientes fuentes de datos solo están disponibles actualmente en la experiencia anterior.


| Origen de datos | Details | 
| --- | --- | 
|  Salesforce  |  El valor predeterminado es automáticamente la experiencia heredada  | 
|  Hojas de cálculo de Google  |  Pasa automáticamente a la experiencia heredada  | 
|  S3 Analytics  |  **Se admiten las fuentes de datos de S3**  | 

## Otras funciones no compatibles
<a name="other-unsupported-features"></a>

Las siguientes funciones solo están disponibles actualmente en la experiencia antigua.


| Categoría de funciones | Características no admitidas | 
| --- | --- | 
|  Administración de conjuntos de datos  |  [Actualización incremental](refreshing-imported-data.md#refresh-spice-data-incremental), [parámetros del conjunto](dataset-parameters.md) de datos, [carpetas de columnas](organizing-fields-folder.md), [descripciones de columnas](describing-data.md)  | 
|  Data Types  |  [Geoespacial](geospatial-data-prep.md)[, [formatos ELF/CLF](supported-data-sources.md#file-data-sources), archivos/ zip en S3 GZip ](supported-data-sources.md#file-data-sources)  | 
|  Opciones de configuración  |  [«Empezar desde una fila» en la configuración de carga de archivos, formato](choosing-file-upload-settings.md) de fecha JODA  | 
|  Selección de conjuntos de datos principales a partir de una experiencia antigua  |  Los conjuntos de datos para padres e hijos deben existir en el mismo entorno de experiencia. No puede usar un conjunto de datos de experiencias heredado como principal para un conjunto de datos de experiencias nuevo.  | 

## Desarrollo futuro
<a name="future-development"></a>

Amazon Quick Sight planea implementar estas funciones en la nueva experiencia de preparación de datos en el futuro. Este enfoque garantiza que el lanzamiento inicial de la nueva experiencia de preparación de datos dé prioridad a:

**Capacidades mejoradas**
+ Flujos de trabajo de transformación visual
+ Mejora de la transparencia de los procesos
+ Técnicas de preparación avanzadas mediante Divergence
+ Nuevas y potentes funciones como Append, Aggregate y Pivot

**Adopción flexible**

Los usuarios pueden elegir entre experiencias antes de publicar los conjuntos de datos, lo que garantiza flujos de trabajo ininterrumpidos mientras los equipos realizan la transición a su propio ritmo. Este enfoque permite el acceso inmediato a las nuevas capacidades y, al mismo tiempo, permite cumplir con los requisitos especializados gracias a la experiencia anterior.

# Límites de preparación de datos
<a name="data-preparation-limits"></a>

La experiencia de preparación de datos de Amazon Quick Sight está diseñada para gestionar conjuntos de datos a escala empresarial y, al mismo tiempo, mantener un rendimiento óptimo. Los siguientes límites garantizan una funcionalidad fiable.

## Límites de tamaño de los conjuntos de datos (SPICE)
<a name="dataset-size-limits"></a>
+ **Tamaño de salida**: hasta 2 TB o 2000 millones de filas
+ **Tamaño total de entrada**: las fuentes de entrada combinadas no pueden superar los 2 TB
+ **Tamaño de las tablas secundarias**: el tamaño combinado está limitado a 20 GB

**nota**  
Las tablas principales son las que tienen un tamaño máximo en un flujo de trabajo; todas las demás son secundarias.

## Límites de la estructura del flujo
<a name="workflow-structure-limits"></a>
+ **Número máximo de pasos**: hasta 256 pasos de transformación por flujo de trabajo
+ **Tablas de origen**: 32 pasos de importación como máximo por flujo de trabajo
+ **Columnas de salida**: hasta 2048 columnas en cualquier paso del flujo de trabajo y tabla de salida final con 2000 columnas
+ Rutas **divergentes: máximo 5 rutas** desde un solo paso (solo SPICE, no aplicable a este tipo de rutas) DirectQuery
+ El **conjunto de datos como fuente**: hasta 10 niveles para SPICE y DirectQuery

Estos límites están diseñados para equilibrar la flexibilidad con el rendimiento, lo que permite transformaciones de datos complejas y, al mismo tiempo, garantiza capacidades de análisis óptimas.

# Cambios en el comportamiento de ingestión
<a name="ingestion-behavior-changes"></a>

La nueva experiencia de preparación de datos introduce un cambio importante en la forma en que se gestionan los problemas de calidad de los datos durante la ingestión de SPICE. Este cambio afecta significativamente a la integridad y transparencia de los datos de sus conjuntos de datos.

En la experiencia anterior, cuando se detectaban incoherencias en los tipos de datos (como formatos de fecha incorrectos o [problemas similares](errors-spice-ingestion.md)), durante la ingestión se omite toda la fila que contiene las celdas problemáticas. Este enfoque da como resultado un menor número de filas en el conjunto de datos final, lo que podría ocultar los problemas de calidad de los datos.

La nueva experiencia adopta un enfoque más detallado de las inconsistencias de los datos. Cuando se encuentran celdas problemáticas, solo los valores incoherentes se convierten en valores nulos y se conserva toda la fila. Esta conservación garantiza que los datos relacionados de otras columnas permanezcan accesibles para su análisis.

**Impacto en la calidad del conjunto de datos**

Los conjuntos de datos creados en la nueva experiencia suelen contener más filas que sus homólogos antiguos cuando los datos de origen contienen inconsistencias. Este enfoque mejorado ofrece varios beneficios:
+ Mejora de la integridad de los datos al conservar todas las filas
+ Mayor transparencia a la hora de identificar los problemas de calidad de los datos
+ Mejor visibilidad de los valores problemáticos para su corrección
+ Preservación de los datos relacionados en columnas no afectadas

Este cambio permite a los analistas identificar y abordar los problemas de calidad de los datos de manera más eficaz, en lugar de omitir silenciosamente las filas problemáticas del conjunto de datos.

# Preguntas frecuentes
<a name="new-data-prep-faqs"></a>

## 1. ¿Cuándo deben los usuarios cambiar de la experiencia nueva a la antigua?
<a name="faq-1"></a>

Los usuarios deben volver a la experiencia anterior al trabajar con conjuntos de datos que contienen funciones que actualmente [no son compatibles](unsupported-features.md). Quick Sight está trabajando activamente para incorporar estas funciones a la nueva experiencia de las próximas versiones.

## 2. ¿Por qué los conjuntos de datos aparecen atenuados al intentar añadirlos a la nueva experiencia? ¿Se pueden combinar los conjuntos de datos entre experiencias heredadas y nuevas?
<a name="faq-2"></a>

Actualmente, los conjuntos de datos de padres e hijos deben existir en el mismo entorno de experiencia. No puedes combinar conjuntos de datos de experiencias antiguas y nuevas porque la nueva experiencia incluye funciones adicionales que no estaban disponibles en las antiguas, como las funcionalidades de Append, las capacidades de Pivot y Divergence.

**Uso de conjuntos de datos principales de la experiencia anterior**

Para usar los conjuntos de datos principales de la experiencia anterior, puede volver a ese entorno. Solo tiene que ir a la página de preparación de datos y **elegir Volver a la experiencia antigua** en la esquina superior derecha. Una vez allí, puede crear los conjuntos de datos de sus hijos según sea necesario.

**Desarrollo futuro**

Tenemos previsto implementar una funcionalidad que permita a los usuarios actualizar los conjuntos de datos heredados a la nueva experiencia. Esta ruta mejorada permitirá el uso de conjuntos de datos primarios heredados dentro de la nueva experiencia.

## 3. ¿Por qué Quick Sight lanza la nueva experiencia de preparación de datos antes de lograr la paridad total de funciones con la experiencia anterior?
<a name="faq-3"></a>

La nueva experiencia de preparación de datos se desarrolló a través de una amplia colaboración con los clientes para abordar los desafíos analíticos del mundo real. El lanzamiento inicial prioriza:

**Capacidades mejoradas**
+ Flujos de trabajo de transformación visual
+ Mejora de la transparencia de los procesos
+ Técnicas de preparación avanzadas mediante Divergence
+ Nuevas y potentes funciones como Append, Aggregate y Pivot

**Adopción flexible**

Los usuarios pueden elegir entre experiencias antes de publicar los conjuntos de datos, lo que garantiza flujos de trabajo ininterrumpidos mientras los equipos realizan la transición a su propio ritmo. Este enfoque permite el acceso inmediato a las nuevas capacidades y, al mismo tiempo, permite cumplir con los requisitos especializados gracias a la experiencia anterior.

## 4. ¿Se añadirán a la nueva las funciones que actualmente solo están disponibles en la experiencia antigua?
<a name="faq-4"></a>

Sí. Quick Sight está trabajando activamente para incorporar las funciones heredadas a la nueva experiencia.

## 5. ¿Cómo afectan los cambios en la API a los scripts de creación de conjuntos de datos existentes?
<a name="faq-5"></a>

Quick Sight mantiene la compatibilidad con versiones anteriores e introduce nuevas capacidades:
+ Secuencias de comandos existentes: las secuencias de comandos de las API antiguas seguirán funcionando y crearán conjuntos de datos siguiendo la experiencia anterior
+ Denominación de las API: los nombres de las API actuales permanecen inalterados
+ Nueva funcionalidad: los formatos de API adicionales admiten las capacidades mejoradas de la nueva experiencia
+ Documentación: Las especificaciones completas de la API para la nueva experiencia están disponibles en nuestra referencia de API

## 6. ¿Se pueden convertir los conjuntos de datos entre experiencias después de su publicación?
<a name="faq-6"></a>
+ Ruta de migración futura: Quick Sight agregará una función en el futuro para migrar fácilmente los conjuntos de datos heredados a la nueva experiencia.
+ Proceso unidireccional: no se admite la conversión de conjuntos de datos de la nueva experiencia al formato heredado debido a la dependencia de funciones avanzadas

# Descripción de los datos
<a name="describing-data"></a>

Con Amazon Quick Sight, puede añadir información o *metadatos* sobre las columnas (campos) de sus conjuntos de datos. Al agregar metadatos, hace que el conjunto de datos se explique por sí mismo y sea más fácil de reutilizar. Esto puede ayudar a los conservadores de datos y a sus clientes a saber de dónde provienen los datos y qué significan. Es una forma de comunicarse con las personas que usan su conjunto de datos o lo combinan con otros conjuntos de datos para crear paneles. Los metadatos son especialmente importantes para la información que se comparte entre las organizaciones.

Después de agregar metadatos a un conjunto de datos, las descripciones de los campos están disponibles para cualquier persona que utilice el conjunto de datos. La descripción de una columna aparece cuando alguien que está navegando activamente por la lista de **campos** hace una pausa en el nombre de un campo. Las descripciones de las columnas son visibles para las personas que editan un conjunto de datos o un análisis, pero no para las personas que visualizan un panel. Las descripciones no tienen formato. Puede introducir saltos de línea y marcas de formato, que el editor conserva. Sin embargo, la descripción emergente que se muestra solo puede mostrar palabras, números y símbolos, pero no el formato.

**Edición de la descripción de una columna o un campo**

1. En la página de inicio de Quick, seleccione **Datos** a la izquierda.

1. En la pestaña **Datos**, elige el conjunto de datos en el que quieres trabajar.

1. En la página de detalles del conjunto de datos que se abre, seleccione **Editar conjunto de datos** en la esquina superior derecha.

1. En la página del conjunto de datos que se abre, elija una columna en la vista previa de la tabla situada en la parte inferior o en la lista de campos situada a la izquierda.

1. Para añadir o cambiar la descripción, lleve a cabo una de las siguientes acciones:
   + En la parte inferior de la pantalla, abra la configuración del campo desde el icono del lápiz situado junto al nombre del campo.
   + En la lista de campos, abra la configuración del campo en el menú situado junto al nombre del campo. A continuación, seleccione **Editar nombre y descripción** en el menú contextual. 

1. Añada o cambie la descripción del campo. 

   Para eliminar una descripción existente, elimine todo el texto del cuadro “Descripción”.

1. (Opcional) En **Nombre**, si desea cambiar el nombre del campo, puede introducir uno nuevo aquí. 

1. Elija **Aplicar** para guardar los cambios. Pulse “Cancelar” para salir. 

# Selección de la configuración de carga de archivos
<a name="choosing-file-upload-settings"></a>

Si utiliza un origen de datos de archivo, confirme la configuración de carga y corríjala si es necesario.

**importante**  
Si es necesario cambiar la configuración de carga, haga estos cambios antes de aplicar otros al conjunto de datos. Al cambiar la configuración de carga, Amazon Quick Sight vuelve a importar el archivo. Este proceso sobrescribe todos los cambios realizados hasta el momento.

## Cambio de la configuración de carga de un archivo de texto
<a name="change-text-file-upload-settings"></a>

Los ajustes de carga del archivo de texto incluyen el indicador del encabezado del archivo, el formato del archivo, el delimitador de texto, el calificador de texto y la fila de inicio. Si está trabajando con un origen de datos de Amazon S3, la configuración de carga que seleccione se aplica a todos los archivos que decida utilizar en este conjunto de datos.

Utilice el siguiente procedimiento para cambiar los ajustes de carga del archivo de texto.

1. En la página de preparación de datos, abra el panel **Configuración de carga** eligiendo el icono de expandir.

1. En **Fromato de archivo**, elija el tipo de formato de archivo.

1. Si eligió el formato **custom separated (CUSTOM)**, especifique el carácter de separación en **Delimiter**. 

1. Si el archivo no contiene una fila de encabezado, anule la selección de la casilla de verificación **Los archivos contienen encabezados**.

1. Si desea empezar a partir de una fila que no sea la primera, especifique el número de fila en **Empezar desde la fila**. Si se selecciona la casilla de verificación **Los archivos contienen encabezados**, la nueva fila de partida se trata como fila de encabezado. Si no se selecciona la casilla de verificación **Los archivos contienen encabezados**, la nueva fila de partida se trata como la primera fila de datos.

1. En **Calificador de texto**, seleccione el calificador de texto, ya sea comillas simples (') o dobles (").

## Cambio de la configuración de carga de un archivo de Microsoft Excel
<a name="change-excel-file-upload-settings"></a>

Los ajustes de carga del archivo de Microsoft Excel incluyen el indicador de encabezado de rango y el selector de toda la hoja de cálculo.

Utilice el siguiente procedimiento para cambiar los ajustes de carga del archivo de Microsoft Excel.

1. En la página de preparación de datos, abra el panel **Configuración de carga** eligiendo el icono de expandir.

1. Deje **Cargar toda la hoja** seleccionada.

1. Si el archivo no contiene una fila de encabezado, anule la selección de la casilla de verificación **El intervalo contiene encabezados**.

# Experiencia en preparación de datos (heredada)
<a name="data-prep-experience-legacy"></a>

**Topics**
+ [Añadir cálculos](working-with-calculated-fields.md)
+ [Unir datos](joining-data.md)
+ [Preparación de campos de datos para su análisis en Amazon Quick Sight](preparing-data-fields.md)
+ [Filtrado de datos en Amazon Quick Sight](adding-a-filter.md)
+ [Vista previa de las tablas de un conjunto de datos](previewing-tables-in-a-dataset.md)

# Añadir cálculos
<a name="working-with-calculated-fields"></a>

Cree campos calculados para transformar los datos mediante una o más de las siguientes opciones: 
+ [Operadores](arithmetic-and-comparison-operators.md)
+ [Funciones](functions.md)
+ Campos que contienen datos
+ Otros campos calculados

Puede añadir campos calculados a un conjunto de datos durante la preparación de datos o desde la página de análisis. Si se añade un campo calculado a un conjunto de datos al prepararse los datos, este estará disponible para todos los análisis que utilicen ese conjunto de datos. Cuando añade un campo calculado a un conjunto de datos de un análisis, solo estará disponible en dicho análisis. Para obtener más información acerca de cómo agregar campos calculados, consulte los siguientes temas.

**Topics**
+ [Adición de campos calculados](adding-a-calculated-field-analysis.md)
+ [Orden de evaluación en Amazon Quick Sight](order-of-evaluation-quicksight.md)
+ [Uso de cálculos con reconocimiento de niveles en Quick Sight](level-aware-calculations.md)
+ [Función de campo calculada y referencia de operador para Amazon Quick](calculated-field-reference.md)

# Adición de campos calculados
<a name="adding-a-calculated-field-analysis"></a>

Cree campos calculados para transformar los datos mediante una o más de las siguientes opciones: 
+ [Operadores](arithmetic-and-comparison-operators.md)
+ [Funciones](functions.md)
+ Funciones de agregación (solo puede añadirlas a un análisis)
+ Campos que contienen datos
+ Otros campos calculados

Puede añadir campos calculados a un conjunto de datos durante la preparación de datos o desde la página de análisis. Si se añade un campo calculado a un conjunto de datos al prepararse los datos, este estará disponible para todos los análisis que utilicen ese conjunto de datos. Cuando añade un campo calculado a un conjunto de datos de un análisis, solo estará disponible en dicho análisis. 

Los análisis admiten operaciones de una sola fila y operaciones de agregación. Las operaciones de una sola fila son las que ofrecen un resultado (potencialmente) diferente para cada fila. Las operaciones de agregación ofrecen siempre los mismos resultados para todos los conjuntos de filas. Por ejemplo, si se utiliza una función de cadena sencilla sin condiciones, cambian todas las filas. Si se utiliza una función de agregación, se aplica a todas las filas de un grupo. Si se pide el importe total de ventas de Estados Unidos, este mismo importe se aplica a todo el conjunto. Si se piden datos sobre un determinado estado, el importe total de ventas cambia para reflejar la nueva agrupación, aunque sigue ofreciendo un solo resultado para todo el conjunto.

Si se crea el campo de agregación calculado en el análisis, es posible desglosar los datos. El valor de este campo de agregación se vuelve a calcular de manera adecuada para cada nivel. Este tipo de agregación no es posible durante la preparación del conjunto de datos.

Por ejemplo, supongamos que desea averiguar el porcentaje de beneficios de cada país, región y estado. Puede añadir un campo calculado al análisis, `(sum(salesAmount - cost)) / sum(salesAmount)`. A continuación, este campo se calcula para cada país, región y estado cuando el analista analiza los distintos niveles geográficos.

**Topics**
+ [Adición de campos calculados a un análisis](#using-the-calculated-field-editor-analysis)
+ [Adición de campos calculados a un conjunto de datos](#using-the-calculated-field-editor)
+ [Gestión de valores decimales en campos calculados](#handling-decimal-fields)

## Adición de campos calculados a un análisis
<a name="using-the-calculated-field-editor-analysis"></a>

Cuando agrega un conjunto de datos a un análisis, todos los campos calculados que existen en el conjunto de datos se agregan al análisis. Puede agregar campos calculados adicionales en el nivel de análisis para crear campos calculados que solo estén disponibles en dicho análisis.

**Adición de un campo calculado a un análisis**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el análisis que desee cambiar.

1. En el panel **Datos**, elija **Agregar** en la parte superior izquierda y, a continuación, elija **\$1 CAMPO CALCULADO**.

   1. En el editor de cálculos que se abre, haga lo siguiente:

   1. Introduzca un nombre para el campo calculado.

   1. Introduzca una fórmula con los campos de su conjunto de datos, funciones y operadores.

1. Cuando termine, elija **Guardar**.

Para obtener más información sobre cómo crear fórmulas con las funciones disponibles en Quick Sight, consulte[Función de campo calculada y referencia de operador para Amazon QuickFunciones y operadores](calculated-field-reference.md).

## Adición de campos calculados a un conjunto de datos
<a name="using-the-calculated-field-editor"></a>

Los autores de Amazon Quick Sight pueden generar campos calculados durante la fase de preparación de datos de la creación de un conjunto de datos. Al crear un campo calculado para un conjunto de datos, el campo se convierte en una nueva columna del conjunto de datos. Todos los análisis que usan el conjunto de datos heredan los campos calculados del conjunto de datos.

Si el campo calculado funciona a nivel de fila y el conjunto de datos está almacenadoSPICE, Quick Sight calcula y materializa el resultado en. SPICE Si el campo calculado se basa en una función de agregación, Quick Sight conserva la fórmula y realiza el cálculo cuando se genera el análisis. Este tipo de campo calculado se denomina campo calculado no materializado.

**Adición o edición de un campo calculado para un conjunto de datos**

1. Abra el conjunto de datos con el que desea trabajar. Para obtener más información, consulte [Edición de conjuntos de datos](edit-a-data-set.md).

1. En la página Preparación de datos, haga una de las siguientes acciones:
   + Para crear un campo nuevo, seleccione **Añadir campo calculado** a la izquierda.
   + Para editar un campo calculado existente, selecciónelo en **Campos calculados** de la izquierda y, a continuación, seleccione **Editar** en el menú contextual (con el botón derecho).

1. En el editor de cálculos, introduzca un nombre descriptivo para **Añadir título** para asignar un nombre al nuevo campo calculado. Este nombre aparece en la lista de campos del conjunto de datos, por lo que debe tener un aspecto similar al de los demás campos. En este ejemplo, asignaremos al campo el nombre de `Total Sales This Year`.

1. (Opcional) Agregue un comentario, por ejemplo, para explicar lo que hace la expresión, poniendo el texto entre barras y asteriscos.

   ```
   /* Calculates sales per year for this year*/
   ```

1. Identifique las métricas, las funciones y otros elementos que se van a utilizar. Para este ejemplo, necesitamos identificar lo siguiente:
   + La métrica que se debe utilizar
   + Funciones: `ifelse` y `datediff`

   Queremos crear una instrucción como: “Si la venta se realizó durante este año, muestra las ventas totales y, de lo contrario, muestra 0”.

   Para añadir la función `ifelse`, abra la lista **Funciones**. Seleccione **Todas** para cerrar la lista de todas las funciones. Ahora debería ver los grupos de funciones: **Agregado**, **Condicional**, **Fecha**, etc. 

   Elija **Condicional** y, a continuación, haga doble clic en `ifelse` para añadirla al espacio de trabajo. 

   ```
   ifelse()
   ```

1. Coloque el cursor dentro del paréntesis en el espacio de trabajo y añada tres líneas en blanco.

   ```
   ifelse(
                                               
                                               
                                               
   )
   ```

1. Con el cursor en la primera línea en blanco, busque la función `dateDiff`. Aparece en la lista **Funciones** en **Fechas**. También puede encontrarla al escribir **date** en **Buscar funciones**. La función `dateDiff` devuelve todas las funciones que tienen *`date`* como parte de su nombre. No devuelve todas las funciones enumeradas en **Fechas**; por ejemplo, la función `now` no aparece en los resultados de la búsqueda.

   Haga doble clic en `dateDiff` para añadirla a la primera línea en blanco de la instrucción `ifelse`. 

   ```
   ifelse(
   dateDiff()                                            
                                               
                                               
   )
   ```

   Añada los parámetros que utiliza `dateDiff`. Coloque el cursor dentro de los paréntesis `dateDiff` para empezar a añadir `date1`, `date2` y`period`:

   1. Para `date1`: el primer parámetro es el campo que contiene la fecha. Búsquelo en **Campos** y agréguelo al espacio de trabajo haciendo doble clic en él o introduciendo su nombre. 

   1. Para `date2`, añada una coma y, a continuación, seleccione `truncDate()` en **Funciones**. Dentro del paréntesis, añada el punto y la fecha, de la siguiente manera: **truncDate( "YYYY", now() )**

   1. Para `period`: añada una coma después de `date2` e introduzca **YYYY**. Este es el periodo del año. Para ver una lista de todos los periodos admitidos, busque `dateDiff` en la lista **Funciones** y abra la documentación al seleccionar **Más información**. Si ya está consultando la documentación, como lo hace ahora, consulte [dateDiff](dateDiff-function.md).

   Añada algunos espacios para facilitar la lectura, si lo desea. Su expresión debe ser similar a la siguiente.

   ```
   ifelse(
      dateDiff( {Date}, truncDate( "YYYY", now() ) ,"YYYY" )                                       
                                               
                                               
   )
   ```

1. Especifique el valor devuelto. Para nuestro ejemplo, el primer parámetro en `ifelse` debe devolver un valor de `TRUE` o `FALSE`. Como queremos el año actual y lo estamos comparando con este año, especificamos que la instrucción `dateDiff` debe devolver `0`. La parte `if` de `ifelse` se considera válida para las filas en las que no hay diferencia entre el año de la venta y el año actual.

   ```
      dateDiff( {Date}, truncDate( "YYYY", now() ) ,"YYYY" ) = 0 
   ```

   Para crear un campo `TotalSales` para el año pasado, puede cambiar `0` a `1`.

   Otra forma de hacer lo mismo es utilizar `addDateTime` en lugar de `truncDate`. Luego, para cada año anterior, se cambia el primer parámetro de `addDateTime` para que represente cada año. Para ello, utilice `-1` para el año pasado, `-2` para el año anterior y así sucesivamente. Si usa `addDateTime`, deje la función `dateDiff` `= 0` para cada año.

   ```
      dateDiff( {Discharge Date}, addDateTime(-1, "YYYY", now() ) ,"YYYY" ) = 0 /* Last year */
   ```

1. Mueva el cursor a la primera línea en blanco, justo debajo de `dateDiff`. Añada una coma. 

   Para la parte `then` de la instrucción `ifelse`, debemos elegir la medida (métrica) que contiene el importe de las ventas, `TotalSales`.

   Para elegir un campo, abra la lista **Campos** y haga doble clic en un campo para añadirlo a la pantalla. O puede ingresar el nombre. Añada corchetes `{ }` alrededor de los nombres que contengan espacios. Es probable que la métrica tenga un nombre diferente. Puede saber qué campo es una métrica por el signo numérico que aparece delante de él (**\$1**).

   Ahora, su expresión debe ser similar a la siguiente.

   ```
   ifelse(
      dateDiff( {Date}, truncDate( "YYYY", now() ) ,"YYYY" ) = 0
      ,{TotalSales}                            
                                              
   )
   ```

1. Añada una cláusula `else`. La función `ifelse` no requiere una, pero queremos añadirla. Para elaborar informes, normalmente no se recomienda tener ningún valor nulo, ya que a veces se omiten las filas con valores nulos. 

   Establecemos la parte else de la expresión ifelse en `0`. El resultado es que este campo es `0` para las filas que contienen las ventas de años anteriores.

   Para ello, en la línea en blanco, agregue una coma y luego un `0`. Si agregó el comentario al principio, la expresión `ifelse` final debería tener el siguiente aspecto.

   ```
   /* Calculates sales per year for this year*/
   ifelse(
      dateDiff( {Date}, truncDate( "YYYY", now() ) ,"YYYY" ) = 0
      ,{TotalSales}                            
      ,0                                         
   )
   ```

1. Seleccione **Guardar** en la esquina superior derecha para guardar su trabajo. 

   Si hay errores en la expresión, el editor mostrará un mensaje de error en la parte inferior. Compruebe si la expresión tiene una línea roja ondulada y, a continuación, coloque el cursor sobre esa línea para ver cuál es el mensaje de error. Los errores más comunes son la falta de puntuación, la falta de parámetros, las faltas de ortografía y los tipos de datos no válidos.

   Para evitar hacer cambios, seleccione **Cancelar**.

**Adición de un valor de parámetro a un campo calculado**

1. Puede hacer referencia a parámetros en los campos calculados. Al añadir el parámetro a la expresión, se añade el valor actual de ese parámetro.

1. Para añadir un parámetro, abra la lista **Parámetros** y seleccione el parámetro cuyo valor desee incluir. 

1. (Opcional) Para añadir manualmente un parámetro a la expresión, escriba el nombre del parámetro. A continuación, introdúzcalo entre corchetes `{}` y póngale el prefijo `$`. Por ejemplo, `${parameterName}`.

Puede cambiar el tipo de datos de cualquier campo del conjunto de datos, incluidos los tipos de campos calculados. Solo puede elegir tipos de datos que coincidan con los datos del campo.

**Cambio del tipo de datos de un campo calculado**
+ En **Campos calculados** (a la izquierda), elija el campo que desee cambiar y, a continuación, elija **Cambiar tipo de datos** en el menú contextual (con el botón derecho).

A diferencia de los demás campos del conjunto de datos, los campos calculados no se pueden deshabilitar. En su lugar, elimínelos. 

**Eliminación de un campo calculado**
+ En **Campos calculados** (a la izquierda), elija el campo que desee cambiar y, a continuación, elija **Borrar** en el menú contextual (con el botón derecho).

## Gestión de valores decimales en campos calculados
<a name="handling-decimal-fields"></a>

Cuando el conjunto de datos usa el modo de consulta directa, el cálculo del tipo de datos decimal viene determinado por el comportamiento del motor de origen del que proviene el conjunto de datos. En algunos casos particulares, Quick Sight aplica controles especiales para determinar el tipo de datos del cálculo de salida.

Cuando el conjunto de datos usa el modo de consulta SPICE y se materializa un campo calculado, el tipo de datos del resultado depende de los operadores de función específicos y del tipo de datos de la entrada. Las tablas siguientes muestran el comportamiento esperado de algunos campos calculados de forma numérica.

**Operadores unarios**

En la siguiente tabla se muestra el tipo de datos que se genera en función del operador que use y del tipo de datos del valor que especifique. Por ejemplo, si especifica un número entero en un cálculo `abs`, el tipo de datos del valor de salida es un entero.


****  
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/adding-a-calculated-field-analysis.html)

**Operadores binarios**

En las tablas siguientes se muestra el tipo de datos que se genera en función de los tipos de datos de los dos valores que especifique. Por ejemplo, en el caso de un operador aritmético, si proporciona dos tipos de datos enteros, el resultado del cálculo se mostrará como entero.

Para los operadores básicos (\$1, -, \$1):


|  | **Entero** | **Fijo decimal** | **Flotante decimal** | 
| --- | --- | --- | --- | 
|  **Entero**  |  Entero  |  Fijo decimal  |  Flotante decimal  | 
|  **Fijo decimal**  |  Fijo decimal  |  Fijo decimal  |  Flotante decimal  | 
|  **Flotante decimal**  |  Flotante decimal  |  Flotante decimal  |  Flotante decimal  | 

Para operadores de división (/):


|  | **Entero** | **Fijo decimal** | **Flotante decimal** | 
| --- | --- | --- | --- | 
|  **Entero**  |  Flotante decimal  |  Flotante decimal  |  Flotante decimal  | 
|  **Fijo decimal**  |  Flotante decimal  |  Fijo decimal  |  Flotante decimal  | 
|  **Flotante decimal**  |  Flotante decimal  |  Flotante decimal  |  Flotante decimal  | 

Para operadores exponenciales y modales (^, %):


|  | **Entero** | **Fijo decimal** | **Flotante decimal** | 
| --- | --- | --- | --- | 
|  **Entero**  |  Flotante decimal  |  Flotante decimal  |  Flotante decimal  | 
|  **Fijo decimal**  |  Flotante decimal  |  Flotante decimal  |  Flotante decimal  | 
|  **Flotante decimal**  |  Flotante decimal  |  Flotante decimal  |  Flotante decimal  | 

# Orden de evaluación en Amazon Quick Sight
<a name="order-of-evaluation-quicksight"></a>

Al abrir o actualizar un análisis, antes de mostrarlo, Amazon Quick Sight evalúa todo lo que está configurado en el análisis en una secuencia específica. Amazon Quick Sight traduce la configuración en una consulta que puede ejecutar un motor de base de datos. La consulta devuelve los datos de forma similar si se conecta a una base de datos, a una fuente de software como servicio (SaaS) o al motor de análisis Amazon Quick Sight ([SPICE](spice.md)). 

Si comprende el orden en el que se evalúa la configuración, conocerá la secuencia que dicta cuándo se aplica un filtro o cálculo específicos a los datos.

En la siguiente ilustración se muestra el orden de evaluación. La columna de la izquierda muestra el orden de evaluación cuando no hay ninguna ventana de cálculo con reconocimiento de nivel (LAC-W) ni ninguna función de agregación (LAC-A). La segunda columna muestra el orden de evaluación de los análisis que contienen campos calculados para computar las expresiones LAC-W en el nivel de prefiltro (`PRE_FILTER`). La tercera columna muestra el orden de evaluación de los análisis que contienen campos calculados para computar las expresiones LAC-W en el nivel de preagregado (`PRE_AGG`). La última columna muestra el orden de evaluación de los análisis que contienen campos calculados para computar las expresiones LAC-A. Según la ilustración, hay una explicación más detallada del orden de evaluación. Para obtener más información sobre los cálculos con reconocimiento de nivel, consulte [Uso de cálculos con reconocimiento de niveles en Quick Sight](level-aware-calculations.md).

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/order-of-evaluation2.png)


La siguiente lista muestra la secuencia en la que Amazon Quick Sight aplica la configuración en el análisis. Todo lo que esté configurado en el conjunto de datos ocurre al margen del análisis, por ejemplo, cálculos en el nivel de conjunto de datos, filtros y ajustes de seguridad. Todos ellos se aplican a los datos subyacentes. La siguiente lista solo cubre lo que ocurre dentro del análisis. 

1. **Nivel de prefiltro LAC-W**: evalúa los datos en la cardinalidad de la tabla original antes de filtrar el análisis

   1. **Cálculos sencillos**: cálculos a nivel escalar sin agregaciones ni cálculos de ventana. Por ejemplo, `date_metric/60, parseDate(date, 'yyyy/MM/dd'), ifelse(metric > 0, metric, 0), split(string_column, '|' 0)`.

   1. **Función LAC-W PRE\$1FILTER**: si alguna expresión PRE\$1FILTER de LAC-W está implicada en la imagen, Amazon Quick Sight calcula primero la función de ventana en el nivel de la tabla original, antes que cualquier filtro. Si la expresión PRE\$1FILTER de LAC-W se utiliza en los filtros, se aplica en este punto. Por ejemplo, `maxOver(Population, [State, County], PRE_FILTER) > 1000`.

1. **LAC-W PRE\$1AGG**: evalúa los datos en la cardinalidad de la tabla original antes de las agregaciones

   1. **Filtros añadidos durante el análisis**: en este punto se aplican los filtros creados para los campos no agregados de los elementos visuales, que son similares a las cláusulas WHERE. Por ejemplo, `year > 2020`.

   1. **Función PRE\$1AGG de LAC-W: si hay alguna expresión PRE\$1AGG** de LAC-W implicada en la imagen, Amazon Quick Sight calcula la función de ventana antes de aplicar ninguna agregación. Si la expresión de PRE\$1AGG de LAC\$1W se utiliza en los filtros, se aplica en este punto. Por ejemplo, `maxOver(Population, [State, County], PRE_AGG) > 1000`.

   1. **Filtros N superiores e inferiores: filtros que se configuran según las dimensiones para mostrar N artículos.** top/bottom 

1. **Nivel LAC-A**: evalúe las agregaciones a un nivel personalizado, antes que las agregaciones visuales

   1. **Agregaciones de nivel personalizado**: si alguna expresión de LAC-A está involucrada en el elemento visual, se calcula en este punto. Basándose en la tabla que aparece después de los filtros mencionados anteriormente, Amazon QuickSight calcula la agregación, agrupada por las dimensiones que se especifican en los campos calculados. Por ejemplo, `max(Sales, [Region])`.

1. **Nivel de elemento visual**: evalúa las agregaciones a nivel de elemento visual y los cálculos de las tablas posteriores a la agregación, y el resto de las configuraciones se aplican a los elementos visuales

   1. **Agregaciones de nivel de elemento visual**: siempre se deben aplicar agregaciones de elementos visuales, excepto en el caso de las tablas tabulares (donde la dimensión está vacía). Con esta configuración, se calculan las agregaciones basadas en los campos de los cuadros de campo, agrupados por las dimensiones que se incluyen en los elementos visuales. Si algún filtro se basa en las agregaciones, se aplica en este punto, de forma similar a las cláusulas HAVING. Por ejemplo, `min(distance) > 100`.

   1. **Cálculos de tablas**: si en el elemento visual se hace referencia a algún cálculo de tabla posterior a la agregación (debería tomar una expresión agregada como operando), se calcula en este punto. Amazon Quick Sight realiza cálculos de ventanas después de agregaciones visuales. Del mismo modo, se aplican filtros basados en dichos cálculos.

   1. **Otros cálculos de categorías**: este tipo de cálculo solo existe en los line/bar/pie/donut gráficos. Para obtener más información, consulte [Límites de visualización](working-with-visual-types.md#display-limits).

   1. **Totales y subtotales**: los totales y los subtotales se calculan en gráficos de anillos (solo totales), tablas (solo totales) y tablas dinámicas, si se solicitan.

# Uso de cálculos con reconocimiento de niveles en Quick Sight
<a name="level-aware-calculations"></a>


|  | 
| --- |
|    Se aplica a: Enterprise Edition y Standard Edition  | 

Con los *cálculos con reconocimiento de nivel* (LAC), puede especificar el nivel de detalle con el que desea calcular las funciones de ventana o las funciones de agregación. Hay dos tipos de funciones LAC: funciones de cálculo con reconocimiento de nivel de agregación (funciones LAC-A) y funciones de cálculo con reconocimiento de nivel de ventana (LAC-W).

**Topics**
+ [Funciones LAC-A](#level-aware-calculations-aggregate)
+ [Funciones LAC-W](#level-aware-calculations-window)

## Funciones de cálculo con reconocimiento de nivel de agregación (LAC-A)
<a name="level-aware-calculations-aggregate"></a>

Con las funciones LAC-A, puede especificar en qué nivel agrupar el cálculo. Al agregar un argumento a una función de agregación existente, por ejemplo`sum() , max() , count()`, puede definir cualquier nivel de agrupación que desee para la agregación. El nivel agregado puede ser cualquier dimensión independiente de las dimensiones agregadas al elemento visual. Por ejemplo:

```
sum(measure,[group_field_A])
```

Para usar las funciones LAC-A, escríbalas directamente en el editor de cálculos añadiendo los niveles de agregación deseados como segundo argumento entre corchetes. A continuación se presenta un ejemplo de una función de agregación y una función de LAC-A, a modo de comparación.
+ Función de agregación: `sum({sales})`
+ Función LAC-A: `sum({sales}, [{Country},{Product}])`

Los resultados de LAC-A se calculan con el nivel especificado entre corchetes `[ ]` y se pueden utilizar como operando de una función de agregación. El nivel de agrupamiento de la función de agregación es el nivel visual, y los campos de **Agrupar por** se agregan al campo de la función visual. 

Además de crear una clave de grupo LAC estática entre corchetes `[ ]`, puede adaptarla dinámicamente a los campos dea grupación de elementos visuales, poniendo un parámetro `$visualDimensions` entre corchetes. Se trata de un parámetro proporcionado por el sistema, a diferencia de los parámetros definidos por el usuario. El parámetro `[$visualDimensions]` representa los campos agregados al cuadro de campo **Agrupar por** en el elemento visual actual. En los siguientes ejemplos, se muestra cómo añadir dinámicamente claves de grupo o eliminarlas de las dimensiones de elementos visuales
+ LAC-A con clave de grupo agregada dinámicamente: `sum({sales}, [${visualDimensions},{Country},{Products}])`

  Calcula, antes de calcular la agregación del nivel visual, la suma de las ventas, agrupando según `country`, `products` y cualquier otro campo en el cuadro de campo llamado **Agrupar por**. 
+ LAC-A con clave de grupo eliminada dinámicamente: `sum({sales}, [${visualDimensions},!{Country},!{Products}])` 

  Calcula, antes de calcular la agregación del nivel visual, la suma de las ventas, agrupando según los campos en el cuadro de campo llamado **Agrupar por** del elemento visual, a excepción de `country` y `product`. 

Puede especificar una clave de grupo añadida o eliminada en una expresión de LAC, pero no ambas.

Las funciones LAC-A son compatibles en las funciones de agregación siguientes:
+ [avg](avg-function.md)
+ [count](count-function.md)
+ [distinct\$1count](distinct_count-function.md)
+ [max](max-function.md)
+ [median](median-function.md)
+ [min](min-function.md)
+ [percentile](percentile-function.md)
+ [percentileCont](percentileCont-function.md)
+ [percentileDisc (percentil)](percentileDisc-function.md)
+ [stdev](stdev-function.md)
+ [stdevp](stdevp-function.md)
+ [sum](sum-function.md)
+ [var](var-function.md)
+ [varp](varp-function.md)

### Ejemplos de LAC-A
<a name="level-aware-calculations-aggregate-examples"></a>

Puede hacer lo siguiente con las funciones LAC-A:
+ Ejecute cálculos que sean independientes de los niveles del elemento visual. Por ejemplo, si tiene el siguiente cálculo, las cifras de ventas se agregan solo a nivel de país, pero no en otras dimensiones (región o producto) del elemento visual.

  ```
  sum({Sales},[{Country}])
  ```
+ Realice cálculos para las dimensiones que no aparecen en el elemento visual. Por ejemplo, si tiene la siguiente función, puede calcular el promedio de ventas totales por país por región.

  ```
  sum({Sales},[{Country}])
  ```

  Aunque el campo no está incluido en el elemento visual, la función LAC-A primero agrega las ventas a nivel de país y, a continuación, el cálculo a nivel de elemento visual genera el número promedio de cada región. Si la función LAC-A no se utiliza para especificar el nivel, el promedio de ventas se calcula en el grado de detalle más bajo (el nivel base del conjunto de datos) de cada región (que se muestra en la columna de ventas).
+ Utilice LAC-A en combinación con otras funciones de agregación y funciones LAC-W. Hay dos formas de anidar funciones LAC-A con otras funciones.
  + Puede escribir una sintaxis anidada al crear un cálculo. Por ejemplo, la función LAC-A puede combinarse con una función LAC-W para calcular las ventas totales por país del precio promedio de cada producto:

    ```
    sum(avgOver({Sales},[{Product}],PRE_AGG),[{Country}])
    ```
  + Al añadir una función de LAC-A a un elemento visual, el cálculo puede combinarse aún más con las funciones de agregación de nivel visual que haya seleccionado en los campos. Para obtener más información acerca de cómo cambiar la agregación de campos en el elemento visual, consulte [Cambio o adición de la agregación a un campo mediante un cuadro de campo](changing-field-aggregation.md#change-field-aggregation-field-wells).

### Limitaciones de LAC-A
<a name="level-aware-calculations-aggregate-limitations"></a>

Las limitaciones siguientes se aplican a las funciones LAC-A:
+ Las funciones LAC-A son compatibles con todas las funciones de agregación aditivas y no aditivas, como `sum()`, `count()` y `percentile()`. Las funciones LAC-A no son compatibles con las funciones de agregación condicional que terminan en «si», como `sumif()` y`countif()`, ni con las funciones de agregación de períodos que comienzan con periodToDate «», como y. `periodToDateSum()` `periodToDateMax()`
+ Actualmente, las funciones LAC-A en tablas y tablas dinámicas no admiten los totales en el nivel de fila y columna. Al agregar totales en el nivel de fila o columna al gráfico, el número total se mostrará en blanco. Las demás dimensiones que no son de LAC no se ven afectadas.
+ Actualmente, las funciones LAC-A anidadas no se admiten. Se admite una capacidad limitada de las funciones LAC-A anidadas con las funciones de agregación normales y las funciones LAC-W.

  Por ejemplo, las siguientes funciones son válidas:
  + `Aggregation(LAC-A())`. Por ejemplo: `max(sum({sales}, [{country}]))`
  + `LAC-A(LAC-W())`. Por ejemplo: `sum(sumOver({Sales},[{Product}],PRE_AGG), [{Country}])`

  Las siguientes funciones no son válidas:
  + `LAC-A(Aggregation())`. Por ejemplo: `sum(max({sales}), [{country}])`
  + `LAC-A(LAC-A())`. Por ejemplo: `sum(max({sales}, [{country}]),[category])`
  + `LAC-W(LAC-A())`. Por ejemplo: `sumOver(sum({Sales},[{Product}]),[{Country}],PRE_AGG)`

## Funciones de cálculo con reconocimiento de nivel de ventana (LAC-W)
<a name="level-aware-calculations-window"></a>

Con las funciones LAC-W, puede especificar la ventana o la partición para calcular el cálculo. Las funciones LAC-W son un grupo de funciones de ventana, como `sumover()`, `(maxover)` y `denseRank`, que se pueden ejecutar a nivel de prefiltro o preagregado. Por ejemplo: `sumOver(measure,[partition_field_A],pre_agg)`.

Las funciones LAC-W solían denominarse agregaciones con reconocimiento de nivel (LAA).

Las funciones LAC-W ayudan a responder a los siguientes tipos de preguntas:
+ ¿Cuántos de mis clientes han realizado solo un pedido de compra? ¿O 10? ¿O 50? Queremos que el elemento visual utilice el recuento como dimensión en lugar de una métrica en el elemento visual.
+ ¿Cuáles son las ventas totales por segmento de mercado para los clientes cuyo gasto de vida útil sea superior a 100 000 USD? El elemento visual solo debe mostrar el segmento de mercado y las ventas totales de cada uno de ellos.
+ ¿Cuál es la contribución de cada sector a los beneficios de toda la empresa (porcentaje del total)? Queremos poder filtrar el elemento visual para mostrar algunos de los sectores y cómo contribuyen a las ventas totales de las industrias mostradas. Sin embargo, también queremos ver el porcentaje de ventas totales de cada sector para toda la empresa (incluidas las industrias que se filtran). 
+ ¿Cuáles son las ventas totales de cada categoría en comparación con la media del sector? La media del sector debe incluir todas las categorías, incluso después de filtrarlas.
+ ¿Cómo se agrupan mis clientes en intervalos de gasto acumulado? Queremos utilizar la agrupación como dimensión en lugar de como métrica. 

Para preguntas más complejas, puede introducir un cálculo o un filtro antes de que Quick Sight llegue a un punto específico de la evaluación de la configuración. Para influir directamente en los resultados, añada una palabra clave de nivel de cálculo a un cálculo de tabla. Para obtener más información sobre cómo Quick Sight evalúa las consultas, consulte. [Orden de evaluación en Amazon Quick Sight](order-of-evaluation-quicksight.md)

Las funciones LAC-W admiten los siguientes niveles de cálculo:
+ **`PRE_FILTER`**— Antes de aplicar los filtros del análisis, Quick Sight evalúa los cálculos del prefiltro. A continuación, aplica los filtros que están configurados en estos cálculos de prefiltro.
+ **`PRE_AGG`**— Antes de calcular las agregaciones a nivel de pantalla, Quick Sight realiza cálculos preagregados. A continuación, aplica los filtros que están configurados en estos cálculos de preagregación. Este trabajo se realiza antes de aplicar filtros *N* superiores e inferiores.

Puede utilizar la palabra clave `PRE_AGG` o `PRE_FILTER` como parámetro en las siguientes funciones de cálculo de tabla. Al especificar un nivel de cálculo, se utiliza una medida no agregada en la función. Por ejemplo, puede utilizar `countOver({ORDER ID}, [{Customer ID}], PRE_AGG)`. Al utilizar `PRE_AGG`, especifica que `countOver` se ejecuta en el nivel de preagregación. 
+ [avgOver](avgOver-function.md)
+ [countOver](countOver-function.md)
+ [denseRank](denseRank-function.md)
+ [distinctCountOver](distinctCountOver-function.md)
+ [minOver](minOver-function.md)
+ [maxOver](maxOver-function.md)
+ [percentileRank](percentileRank-function.md)
+ [rank](rank-function.md)
+ [stdevOver](stdevOver-function.md)
+ [stdevpOver](stdevpOver-function.md)
+ [sumOver](sumOver-function.md)
+ [varOver](varOver-function.md)
+ [varpOver](varpOver-function.md)

De forma predeterminada, el primer parámetro para cada función debe ser una medida agregada. Si utiliza `PRE_FILTER` o `PRE_AGG`, utilice una medida no agregada para el primer parámetro. 

En el caso de las funciones LAC-W, la agregación de elementos visuales se establece de forma predeterminada en `MIN` para eliminar los duplicados. Para cambiar la agregación, abra el menú contextual del campo (haga clic con el botón derecho) y, a continuación, elija una agregación diferente.

Para ver ejemplos de cuándo y cómo utilizar las funciones LAC-W en escenarios de la vida real, consulte la siguiente publicación en el blog sobre AWS big data: [Cree información avanzada con Level Aware Aggregations en Amazon](https://aws.amazon.com/jp/blogs/big-data/create-advanced-insights-using-level-aware-aggregations-in-amazon-quicksight/). QuickSight 

# Función de campo calculada y referencia de operador para Amazon Quick
<a name="calculated-field-reference"></a>

Puede añadir campos calculados a un conjunto de datos durante la preparación de datos o desde la página de análisis. Si se añade un campo calculado a un conjunto de datos al prepararse los datos, este estará disponible para todos los análisis que utilicen ese conjunto de datos. Cuando añade un campo calculado a un conjunto de datos de un análisis, solo estará disponible en dicho análisis. 

Puede crear campos calculados para transformar sus datos mediante las siguientes funciones y operadores.

**Topics**
+ [Operadores](arithmetic-and-comparison-operators.md)
+ [Funciones por categoría](functions-by-category.md)
+ [Funciones](functions.md)
+ [Funciones de agregación](calculated-field-aggregations.md)
+ [Funciones de los cálculos de tabla](table-calculation-functions.md)

# Operadores
<a name="arithmetic-and-comparison-operators"></a>

Puede utilizar los siguientes operadores en campos calculados. Quick utiliza el orden de operaciones estándar: paréntesis, exponentes, multiplicación, división, suma y resta (PEMDAS). En las comparaciones Igual (=) y Distinto de (<>) se distingue entre mayúsculas y minúsculas. 
+ Suma (\$1)
+ Resta (−)
+ Multiplicación (\$1)
+ División (/)
+ Módulo (%): consulte también `mod()` en la siguiente lista.
+ Potencia (^): consulte también `exp()` en la siguiente lista.
+ Igual (=)
+ Distinto de (<>)
+ Mayor que (>)
+ Mayor o igual que (>=)
+ Menor que (<)
+ Menor o igual que (<=)
+ AND
+ OR
+ NOT

Amazon Quick admite la aplicación de las siguientes funciones matemáticas a una expresión.
+ `[https://docs.aws.amazon.com/quicksight/latest/user/mod-function.html](https://docs.aws.amazon.com/quicksight/latest/user/mod-function.html)(number, divisor)`: encuentra el resto después de dividir un número por un divisor.
+ `[https://docs.aws.amazon.com/quicksight/latest/user/log-function.html](https://docs.aws.amazon.com/quicksight/latest/user/log-function.html)(expression) `: devuelve el logaritmo en base 10 de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/ln-function.html](https://docs.aws.amazon.com/quicksight/latest/user/ln-function.html)(expression) `: devuelve el logaritmo natural de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/abs-function.html](https://docs.aws.amazon.com/quicksight/latest/user/abs-function.html)(expression) `: devuelve el valor absoluto de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/sqrt-function.html](https://docs.aws.amazon.com/quicksight/latest/user/sqrt-function.html)(expression) `: devuelve la raíz cuadrada de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/exp-function.html](https://docs.aws.amazon.com/quicksight/latest/user/exp-function.html)(expression) `: devuelve la base de logaritmo natural *e* elevada a la potencia de una expresión dada. 

Para que los cálculos prolongados sean más fáciles de leer, puede utilizar paréntesis para clarificar las agrupaciones y las precedencias. En la instrucción siguiente no son necesarios paréntesis. Se procesa en primer lugar la instrucción de multiplicación y, a continuación, al resultado se le suma cinco, lo que devuelve un valor de 26. Sin embargo, los paréntesis la hacen más fácil de leer y mantener.

```
5 + (7 * 3)
```

Como los paréntesis son los primeros en el orden de aplicación de las operaciones, permiten cambiar el orden en que se aplican los demás operadores. Por ejemplo, en la instrucción siguiente, primero se procesa la instrucción de adición y luego el resultado se multiplica por tres, lo cual devuelve un valor de 36.

```
(5 + 7) * 3
```

## Ejemplo: operadores aritméticos
<a name="operator-example-multiple-operators"></a>

El siguiente ejemplo utiliza varios operadores aritméticos para determinar un total de ventas después del descuento.

```
(Quantity * Amount) - Discount
```

## Ejemplo: (/) División
<a name="operator-example-division-operators"></a>

En el siguiente ejemplo, se utiliza la división para dividir 3 entre 2. Se devuelve un valor de 1,5. Amazon Quick utiliza divisiones de punto flotante.

```
3/2
```

## Ejemplo: (=) igual
<a name="operator-example-equal"></a>

Con = se efectúa una comparación de valores que distinguen entre mayúsculas y minúsculas. Las filas para las que la comparación es verdadera se incluyen en el conjunto de resultados. 

En el ejemplo siguiente se incluyen en los resultados las filas en las que el campo `Region` es **South**. Si `Region` es **south**, las filas se excluyen.

```
Region = 'South'
```

En el ejemplo siguiente la comparación da como resultado Falso. 

```
Region = 'south'
```

El ejemplo siguiente muestra una comparación que convierte `Region` a mayúsculas (**SOUTH**) y la compara con **SOUTH**. Así se obtiene las filas en las que la región es **south**, **South** o **SOUTH**.

```
toUpper(Region) = 'SOUTH'
```

## Ejemplo: (<>)
<a name="operator-example-not-equal"></a>

El símbolo distinto de <> significa *menor que o mayor que*. 

Por lo tanto, si decimos x **x<>1** 1, queremos decir que *si x es menor que 1 x O BIEN si x es mayor que 1*. Tanto < como > se evalúan conjuntamente. En otras palabras, *si x es cualquier valor excepto 1*. O bien, *x no es igual a 1*. 

**nota**  
Use <>, no \$1=.

En el siguiente ejemplo se compara `Status Code` con un valor numérico. Así se obtienen las filas en las que `Status Code` no es igual a **1**.

```
statusCode <> 1
```

En el siguiente ejemplo se comparan varios valores de `statusCode`. En este caso, los registros activos tienen `activeFlag = 1`. Este ejemplo devuelve las filas que cumplen una de las siguientes condiciones:
+ Para los registros activos, se muestran las filas en las que el estado no es 1 ni 2
+ Para los registros inactivos, se muestran las filas en las que el estado es 99 o -1

```
( activeFlag = 1 AND (statusCode <> 1 AND statusCode <> 2) )
OR
( activeFlag = 0 AND (statusCode= 99 OR statusCode= -1) )
```

## Ejemplo: (^)
<a name="operator-example-power"></a>

El símbolo de potencia `^` significa *a la potencia de*. Puede utilizar el operador de potencia con cualquier campo numérico, con cualquier exponente válido. 

El siguiente ejemplo es una expresión simple de 2 a la potencia de 4 o (2 \$1 2 \$1 2 \$1 2). Esto devuelve un valor de 16.

```
2^4
```

En el siguiente ejemplo se calcula la raíz cuadrada del campo de ingresos.

```
revenue^0.5
```

## Ejemplo: AND, OR y NOT
<a name="operator-example-and-or-not"></a>

En el siguiente ejemplo se utilizan AND, OR y NOT para comparar varias expresiones. Para ello, utiliza operadores condicionales para etiquetar con una promoción especial a los principales clientes que NO se encuentran en Washington u Oregón y que han realizado más de 10 pedidos. Si no se devuelven valores, se obtiene el valor “n/a”.

```
ifelse(( (NOT (State = 'WA' OR State = 'OR')) AND Orders > 10), 'Special Promotion XYZ', 'n/a')
```

## Ejemplo: Creación de listas de comparación con “in” o “not in”
<a name="operator-example-in-or-not-in"></a>

Este ejemplo utiliza operadores para crear una comparación que obtiene los valores que se encuentran o no se encuentran en una lista especificada.

En el siguiente ejemplo se compara `promoCode` con una lista de valores especificada. Este ejemplo devuelve las filas en las que `promoCode` se encuentra en la lista **(1, 2, 3)**.

```
promoCode    = 1
OR promoCode = 2
OR promoCode = 3
```

En el siguiente ejemplo se compara `promoCode` con una lista de valores especificada. Este ejemplo devuelve las filas en las que `promoCode` NO se encuentra en la lista **(1, 2, 3)**.

```
NOT(promoCode = 1
OR promoCode  = 2
OR promoCode  = 3
)
```

Otra manera de expresarlo es proporcionar una lista donde `promoCode` no sea igual a ninguno de sus elementos.

```
promoCode     <> 1
AND promoCode <> 2
AND promoCode <> 3
```

## Ejemplo: Creación de una comparación “between”
<a name="operator-example-between"></a>

En este ejemplo se utilizan operadores de comparación para mostrar los valores existentes entre dos valores.

En el ejemplo siguiente se examina `OrderDate` y se devuelven las filas en las que `OrderDate` se encuentra entre el primer y el último día de 2016. En este caso, queremos incluir los días primero y último, así que usamos “o igual a” en los operadores de comparación. 

```
OrderDate >= "1/1/2016" AND OrderDate <= "12/31/2016"
```

# Funciones por categoría
<a name="functions-by-category"></a>

En esta sección encontrarás una lista de las funciones disponibles en Amazon Quick, ordenadas por categoría.

**Topics**
+ [Funciones de agregación](#aggregate-functions)
+ [Funciones condicionales](#conditional-functions)
+ [Funciones de datos](#date-functions)
+ [Funciones numéricas](#numeric-functions)
+ [Funciones matemáticas](#mathematical-functions)
+ [Funciones de cadena](#string-functions)
+ [Cálculos de tabla](#table-calculations)

## Funciones de agregación
<a name="aggregate-functions"></a>

Entre las funciones de agregación de los campos calculados de Amazon Quick se incluyen las siguientes. Solo están disponibles durante el análisis y la visualización. Cada una de estas funciones devuelve los valores agrupados por la dimensión o dimensiones elegidas. Para cada agregación, también existe una agregación condicional. Realizan el mismo tipo de agregación, en función de una condición. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/avg-function.html](https://docs.aws.amazon.com/quicksight/latest/user/avg-function.html) calcula la media del conjunto de números en la medida especificada y agrupa según la dimensión o las dimensiones seleccionadas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html) calcula el promedio en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/count-function.html](https://docs.aws.amazon.com/quicksight/latest/user/count-function.html) calcula el número de valores en una dimensión o medida y los agrupa según la dimensión o las dimensiones seleccionadas. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html) calcula el recuento en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/distinct_count-function.html](https://docs.aws.amazon.com/quicksight/latest/user/distinct_count-function.html) calcula el número de valores distintos en una dimensión o medida y los agrupa según la dimensión o las dimensiones seleccionadas. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html) calcula el valor distinto en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/max-function.html](https://docs.aws.amazon.com/quicksight/latest/user/max-function.html) devuelve el valor máximo de la medida especificada y lo agrupa según la dimensión o las dimensiones seleccionadas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html) calcula el valor máximo en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/median-function.html](https://docs.aws.amazon.com/quicksight/latest/user/median-function.html) devuelve el valor de la mediana de la medida especificada y lo agrupa según la dimensión o las dimensiones seleccionadas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html) calcula la mediana en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/min-function.html](https://docs.aws.amazon.com/quicksight/latest/user/min-function.html) devuelve el valor mínimo de la medida especificada y lo agrupa según la dimensión o las dimensiones seleccionadas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html) calcula el valor mínimo en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentile-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentile-function.html) (alias de `percentileDisc`) calcula el percentil *n* de la medida especificada y lo agrupa según la dimensión o las dimensiones seleccionadas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileCont-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileCont-function.html) calcula el percentil *n* basándose en una distribución continua de los números de la medida especificada, agrupados por la dimensión o dimensiones elegidas. 
+ [percentileDisc(percentil)](https://docs.aws.amazon.com/quicksight/latest/user/percentileDisc-function.html) calcula el percentil *n* en función de los números reales de la medida especificada, agrupados por la dimensión o dimensiones elegidas. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateAvg-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateAvg-function.html) calcula el promedio del conjunto de números en la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateCount-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateCount-function.html) calcula el número de valores de una dimensión o medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, incluidos los duplicados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMax-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMax-function.html) devuelve el valor máximo de la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMedian-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMedian-function.html) devuelve el valor de la mediana de la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMin-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMin-function.html) devuelve el valor mínimo de la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDatePercentile-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDatePercentile-function.html) calcula el percentil según los números reales de una medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDatePercentileCont-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDatePercentileCont-function.html) calcula el percentil según la distribución continua de los números de la medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateStDev-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateStDev-function.html) calcula la desviación estándar del conjunto de números en la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo en función de una muestra.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateStDevP-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateStDevP-function.html) calcula la desviación estándar de la población del conjunto de números en la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo en función de una muestra.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateSum-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateSum-function.html) suma el conjunto de números en la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateVar-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateVar-function.html) calcula la varianza de muestras del conjunto de números en la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateVarP-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateVarP-function.html) calcula la varianza de la población del conjunto de números en la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/stdev-function.html](https://docs.aws.amazon.com/quicksight/latest/user/stdev-function.html)) calcula la desviación estándar del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una muestra.
+ [https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html) calcula la desviación estándar de la muestra en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/stdevp-function.html](https://docs.aws.amazon.com/quicksight/latest/user/stdevp-function.html) calcula la desviación estándar del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una población sesgada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html) calcula la desviación de la población en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/var-function.html](https://docs.aws.amazon.com/quicksight/latest/user/var-function.html)) calcula la varianza del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una muestra.
+ [https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) calcula la varianza de la muestra en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/varp-function.html](https://docs.aws.amazon.com/quicksight/latest/user/varp-function.html)) calcula la varianza del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una población sesgada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html) calcula la varianza de la población en función de una instrucción condicional.
+ [https://docs.aws.amazon.com/quicksight/latest/user/sum-function.html](https://docs.aws.amazon.com/quicksight/latest/user/sum-function.html)) suma el conjunto de números en la medida especificada y los agrupa según la dimensión o las dimensiones seleccionadas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html)) calcula la suma en función de una instrucción condicional.

## Funciones condicionales
<a name="conditional-functions"></a>

Entre las funciones condicionales de los campos calculados de Amazon Quick se incluyen las siguientes:
+ [https://docs.aws.amazon.com/quicksight/latest/user/coalesce-function.html](https://docs.aws.amazon.com/quicksight/latest/user/coalesce-function.html) devuelve el valor del primer argumento que no sea nulo.
+ [https://docs.aws.amazon.com/quicksight/latest/user/ifelse-function.html](https://docs.aws.amazon.com/quicksight/latest/user/ifelse-function.html) evalúa un conjunto de pares de expresiones *if*, *then*; y devuelve el valor del argumento *then* durante el primer argumento *if* que se evalúa como verdadero.
+ [https://docs.aws.amazon.com/quicksight/latest/user/in-function.html](https://docs.aws.amazon.com/quicksight/latest/user/in-function.html) evalúa una expresión para ver si se encuentra en una lista de valores determinada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/isNotNull-function.html](https://docs.aws.amazon.com/quicksight/latest/user/isNotNull-function.html) evalúa una expresión para ver si no es nula.
+ [https://docs.aws.amazon.com/quicksight/latest/user/isNull-function.html](https://docs.aws.amazon.com/quicksight/latest/user/isNull-function.html) evalúa una expresión para ver si es nula. Si la expresión es nula, `isNull` devuelve “true”, de lo contrario devuelve “false”.
+ [https://docs.aws.amazon.com/quicksight/latest/user/notIn-function.html](https://docs.aws.amazon.com/quicksight/latest/user/notIn-function.html) evalúa una expresión para ver si no se encuentra en una lista de valores determinada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/nullIf-function.html](https://docs.aws.amazon.com/quicksight/latest/user/nullIf-function.html) compara dos expresiones. Si son iguales, la función devuelve “null”. Si no son iguales, la función devuelve la primera expresión.
+ [https://docs.aws.amazon.com/quicksight/latest/user/switch-function.html](https://docs.aws.amazon.com/quicksight/latest/user/switch-function.html) devuelve una expresión que coincide con la primera etiqueta igual a la expresión condicional.

## Funciones de datos
<a name="date-functions"></a>

Entre las funciones de fecha para los campos calculados en Amazon Quick se incluyen las siguientes:
+ [https://docs.aws.amazon.com/quicksight/latest/user/addDateTime-function.html](https://docs.aws.amazon.com/quicksight/latest/user/addDateTime-function.html) suma o resta una unidad de tiempo para la fecha u hora.
+ [https://docs.aws.amazon.com/quicksight/latest/user/addWorkDays-function.html](https://docs.aws.amazon.com/quicksight/latest/user/addWorkDays-function.html) suma o resta el número dado de días laborables a la fecha u hora indicada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/dateDiff-function.html](https://docs.aws.amazon.com/quicksight/latest/user/dateDiff-function.html) devuelve la diferencia en días entre dos campos de fecha. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/epochDate-function.html](https://docs.aws.amazon.com/quicksight/latest/user/epochDate-function.html) convierte una fecha de inicio en una fecha estándar. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/extract-function.html](https://docs.aws.amazon.com/quicksight/latest/user/extract-function.html) devuelve una parte especificada de un valor de fecha. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/formatDate-function.html](https://docs.aws.amazon.com/quicksight/latest/user/formatDate-function.html) da formato a una fecha utilizando el patrón que especifique. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/isWorkDay-function.html](https://docs.aws.amazon.com/quicksight/latest/user/isWorkDay-function.html) devuelve TRUE si un valor de fecha y hora determinado es un día laborable o hábil.
+ [https://docs.aws.amazon.com/quicksight/latest/user/netWorkDays-function.html](https://docs.aws.amazon.com/quicksight/latest/user/netWorkDays-function.html) devuelve el número de días laborables entre los dos valores de fecha proporcionados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/now-function.html](https://docs.aws.amazon.com/quicksight/latest/user/now-function.html) devuelve la fecha y hora actuales, ya sea mediante la configuración de una base de datos, o UTC para un archivo y Salesforce. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/truncDate-function.html](https://docs.aws.amazon.com/quicksight/latest/user/truncDate-function.html) devuelve un valor de fecha que representa una parte especificada de una fecha. 

## Funciones numéricas
<a name="numeric-functions"></a>

Entre las funciones numéricas de los campos calculados de Amazon Quick se incluyen las siguientes:
+ [https://docs.aws.amazon.com/quicksight/latest/user/ceil-function.html](https://docs.aws.amazon.com/quicksight/latest/user/ceil-function.html) redondea un valor decimal al siguiente número entero más alto. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/decimalToInt-function.html](https://docs.aws.amazon.com/quicksight/latest/user/decimalToInt-function.html) convierte un valor decimal en un entero. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/floor-function.html](https://docs.aws.amazon.com/quicksight/latest/user/floor-function.html) disminuye un valor decimal al siguiente número entero más bajo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/intToDecimal-function.html](https://docs.aws.amazon.com/quicksight/latest/user/intToDecimal-function.html) convierte un valor entero en uno decimal. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/round-function.html](https://docs.aws.amazon.com/quicksight/latest/user/round-function.html) redondea un valor decimal al número entero más cercano, o al decimal más cercano si se especifica una escala. 

## Funciones matemáticas
<a name="mathematical-functions"></a>

Entre las funciones matemáticas de los campos calculados de Amazon Quick se incluyen las siguientes: 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/mod-function.html](https://docs.aws.amazon.com/quicksight/latest/user/mod-function.html)(number, divisor)`: encuentra el resto después de dividir un número por un divisor.
+ `[https://docs.aws.amazon.com/quicksight/latest/user/log-function.html](https://docs.aws.amazon.com/quicksight/latest/user/log-function.html)(expression) `: devuelve el logaritmo en base 10 de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/ln-function.html](https://docs.aws.amazon.com/quicksight/latest/user/ln-function.html)(expression) `: devuelve el logaritmo natural de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/abs-function.html](https://docs.aws.amazon.com/quicksight/latest/user/abs-function.html)(expression) `: devuelve el valor absoluto de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/sqrt-function.html](https://docs.aws.amazon.com/quicksight/latest/user/sqrt-function.html)(expression) `: devuelve la raíz cuadrada de una expresión dada. 
+ `[https://docs.aws.amazon.com/quicksight/latest/user/exp-function.html](https://docs.aws.amazon.com/quicksight/latest/user/exp-function.html)(expression) `: devuelve la base de logaritmo natural *e* elevada a la potencia de una expresión dada. 

## Funciones de cadena
<a name="string-functions"></a>

Entre las funciones de cadena (texto) para los campos calculados de Amazon Quick se incluyen las siguientes:
+ [https://docs.aws.amazon.com/quicksight/latest/user/concat-function.html](https://docs.aws.amazon.com/quicksight/latest/user/concat-function.html) concatena dos o más cadenas. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/contains-function.html](https://docs.aws.amazon.com/quicksight/latest/user/contains-function.html) comprueba si una expresión contiene una subcadena. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/endsWith-function.html](https://docs.aws.amazon.com/quicksight/latest/user/endsWith-function.html) comprueba si la expresión finaliza con la subcadena especificada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/left-function.html](https://docs.aws.amazon.com/quicksight/latest/user/left-function.html) devuelve el número especificado de caracteres más a la izquierda de una cadena. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/locate-function.html](https://docs.aws.amazon.com/quicksight/latest/user/locate-function.html) encuentra una subcadena dentro de otra cadena y devuelve el número de caracteres antes de la subcadena. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/ltrim-function.html](https://docs.aws.amazon.com/quicksight/latest/user/ltrim-function.html) elimina los espacios en blanco situados antes de una cadena. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/parseDate-function.html](https://docs.aws.amazon.com/quicksight/latest/user/parseDate-function.html) analiza una cadena para determinar si contiene un valor de fecha y devuelve la fecha en caso de encontrarlo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/parseDecimal-function.html](https://docs.aws.amazon.com/quicksight/latest/user/parseDecimal-function.html) analiza una cadena para determinar si contiene un valor decimal. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/parseInt-function.html](https://docs.aws.amazon.com/quicksight/latest/user/parseInt-function.html) analiza una cadena para determinar si contiene un valor entero.
+ [https://docs.aws.amazon.com/quicksight/latest/user/parseJson-function.html](https://docs.aws.amazon.com/quicksight/latest/user/parseJson-function.html) analiza los valores a partir de JSON nativo o de un objeto JSON en un campo de texto.
+ [https://docs.aws.amazon.com/quicksight/latest/user/replace-function.html](https://docs.aws.amazon.com/quicksight/latest/user/replace-function.html) sustituye parte de una cadena por una nueva cadena. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/right-function.html](https://docs.aws.amazon.com/quicksight/latest/user/right-function.html) devuelve el número especificado de caracteres más a la derecha de una cadena.
+ [https://docs.aws.amazon.com/quicksight/latest/user/rtrim-function.html](https://docs.aws.amazon.com/quicksight/latest/user/rtrim-function.html) elimina los espacios en blanco situados después de una cadena.
+ [https://docs.aws.amazon.com/quicksight/latest/user/split-function.html](https://docs.aws.amazon.com/quicksight/latest/user/split-function.html) divide una cadena en una matriz de subcadenas basándose en el delimitador que se elija, y devuelve el elemento que especifica la posición. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/startsWith-function.html](https://docs.aws.amazon.com/quicksight/latest/user/startsWith-function.html) comprueba si la expresión comienza por la subcadena especificada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/strlen-function.html](https://docs.aws.amazon.com/quicksight/latest/user/strlen-function.html) devuelve el número de caracteres de una cadena.
+ [https://docs.aws.amazon.com/quicksight/latest/user/substring-function.html](https://docs.aws.amazon.com/quicksight/latest/user/substring-function.html) devuelve el número especificado de caracteres en una cadena, empezando en la ubicación especificada. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/toLower-function.html](https://docs.aws.amazon.com/quicksight/latest/user/toLower-function.html) da formato a una cadena en minúsculas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/toString-function.html](https://docs.aws.amazon.com/quicksight/latest/user/toString-function.html) da formato a la expresión de entrada como una cadena.
+ [https://docs.aws.amazon.com/quicksight/latest/user/toUpper-function.html](https://docs.aws.amazon.com/quicksight/latest/user/toUpper-function.html) da formato a una cadena en mayúsculas.
+ [https://docs.aws.amazon.com/quicksight/latest/user/trim-function.html](https://docs.aws.amazon.com/quicksight/latest/user/trim-function.html) elimina los espacios en blanco situados antes y después de una cadena.

## Cálculos de tabla
<a name="table-calculations"></a>

Los cálculos de tabla forman un grupo de funciones que proporcionan contexto en un análisis. Son compatibles con análisis de agregados enriquecidos. Mediante el uso de estos cálculos, puede abordar supuestos empresariales comunes como el cálculo del porcentaje del total, la ejecución de suma, la diferencia, la referencia común y la clasificación. 

Cuando analiza datos en un elemento visual específico, puede aplicar los cálculos de tabla al conjunto actual de datos para descubrir cómo las dimensiones influyen en las medidas o cómo se influyen entre sí. Los datos visualizados son su conjunto de resultados basado en su conjunto de datos actual, con todos los filtros, selecciones de campos y personalizaciones aplicados. Para ver exactamente qué es este conjunto de resultados, puede exportar su elemento visual a un archivo. Una función de cálculo de tabla realiza operaciones en los datos para revelar las relaciones entre los campos. 

**Funciones basadas en búsqueda**
+ [https://docs.aws.amazon.com/quicksight/latest/user/difference-function.html](https://docs.aws.amazon.com/quicksight/latest/user/difference-function.html) calcula la diferencia entre una medida basada en un conjunto de particiones y órdenes, y una medida basada en otra. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/lag-function.html](https://docs.aws.amazon.com/quicksight/latest/user/lag-function.html) calcula el valor de retardo (anterior) para una medida. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/lead-function.html](https://docs.aws.amazon.com/quicksight/latest/user/lead-function.html) calcula el valor guía (siguiente) para una medida. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentDifference-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentDifference-function.html) calcula la diferencia de porcentaje entre el valor actual y un valor de comparación.

**A través de funciones**
+ [https://docs.aws.amazon.com/quicksight/latest/user/avgOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/avgOver-function.html) calcula el promedio de una medida a través de una o más dimensiones.
+ [https://docs.aws.amazon.com/quicksight/latest/user/countOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/countOver-function.html) calcula el recuento de un campo a través de una o más dimensiones.
+ [https://docs.aws.amazon.com/quicksight/latest/user/distinctCountOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/distinctCountOver-function.html) calcula el recuento distinto del operando particionado por los atributos especificados en un nivel específico. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/maxOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/maxOver-function.html) calcula el máximo de una medida a través de una o más dimensiones. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/minOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/minOver-function.html) el mínimo de una medida a través de una o más dimensiones. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileOver-function.html) (alias de `percentileDiscOver`) calcula el percentil *n* de una medida particionada por una lista de dimensiones. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileContOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileContOver-function.html) calcula el percentil *n* de una medida particionada por una lista de dimensiones en función de una distribución continua.
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileDiscOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileDiscOver-function.html) calcula el percentil *n* de una medida particionada por una lista de dimensiones en función de los números reales. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentOfTotal-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentOfTotal-function.html) calcula el porcentaje en que una medida contribuye al total. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodOverPeriodDifference-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodOverPeriodDifference-function.html) calcula la diferencia de una medida en dos períodos de tiempo diferentes, según lo especificado por el grado de detalle y el desplazamiento del período.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodOverPeriodLastValue-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodOverPeriodLastValue-function.html) calcula el último valor (anterior) de una medida del período de tiempo anterior, según lo especificado en el grado de detalle y el desplazamiento del período.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodOverPeriodPercentDifference-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodOverPeriodPercentDifference-function.html) calcula la diferencia porcentual de una medida en dos períodos de tiempo diferentes, según lo especificado por el grado de detalle y el desplazamiento del período.
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateAvgOverTime-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateAvgOverTime-function.html) calcula el promedio de una medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateCountOverTime-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateCountOverTime-function.html) calcula el recuento de una dimensión o medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMaxOverTime-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMaxOverTime-function.html) calcula el valor máximo de una medida o fecha para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMinOverTime-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateMinOverTime-function.html) calcula el valor mínimo de una medida o fecha para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/periodToDateSumOverTime-function.html](https://docs.aws.amazon.com/quicksight/latest/user/periodToDateSumOverTime-function.html) calcula la suma de una medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/sumOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/sumOver-function.html) calcula la suma de una medida a través de una o más dimensiones. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/stdevOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/stdevOver-function.html) calcula la desviación estándar de la medida especificada y la divide por el atributo o los atributos seleccionados, en función de una muestra.
+ [https://docs.aws.amazon.com/quicksight/latest/user/stdevpOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/stdevpOver-function.html) calcula la desviación estándar de la medida especificada y la divide por el atributo o los atributos seleccionados, en función de una población sesgada.
+ [https://docs.aws.amazon.com/quicksight/latest/user/varOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/varOver-function.html) calcula la varianza de la medida especificada, y la divide por el atributo o los atributos seleccionados, en función de una muestra. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/varpOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/varpOver-function.html) calcula la varianza de la medida especificada, y la divide por el atributo o los atributos seleccionados, en función de una población sesgada. 

**Funciones de clasificación**
+ [https://docs.aws.amazon.com/quicksight/latest/user/rank-function.html](https://docs.aws.amazon.com/quicksight/latest/user/rank-function.html) calcula la clasificación de una medida o una dimensión.
+ [https://docs.aws.amazon.com/quicksight/latest/user/denseRank-function.html](https://docs.aws.amazon.com/quicksight/latest/user/denseRank-function.html) calcula la clasificación de una medida o una dimensión, ignorando los duplicados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileRank-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileRank-function.html) calcula la clasificación de una medida o una dimensión en función del percentil.

**Funciones de ejecución**
+ [https://docs.aws.amazon.com/quicksight/latest/user/runningAvg-function.html](https://docs.aws.amazon.com/quicksight/latest/user/runningAvg-function.html) calcula un promedio acumulado de una medida.
+ [https://docs.aws.amazon.com/quicksight/latest/user/runningCount-function.html](https://docs.aws.amazon.com/quicksight/latest/user/runningCount-function.html) calcula un recuento acumulado de una medida.
+ [https://docs.aws.amazon.com/quicksight/latest/user/runningMax-function.html](https://docs.aws.amazon.com/quicksight/latest/user/runningMax-function.html) calcula un máximo acumulado de una medida.
+ [https://docs.aws.amazon.com/quicksight/latest/user/runningMin-function.html](https://docs.aws.amazon.com/quicksight/latest/user/runningMin-function.html) calcula un mínimo acumulado de una medida.
+ [https://docs.aws.amazon.com/quicksight/latest/user/runningSum-function.html](https://docs.aws.amazon.com/quicksight/latest/user/runningSum-function.html) calcula una ejecución de suma de una medida. 

**Funciones de ventana**
+ [https://docs.aws.amazon.com/quicksight/latest/user/firstValue-function.html](https://docs.aws.amazon.com/quicksight/latest/user/firstValue-function.html) calcula el primer valor de la medida o dimensión agregada dividida y ordenada según los atributos especificados. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/lastValue-function.html](https://docs.aws.amazon.com/quicksight/latest/user/lastValue-function.html) calcula el último valor de la medida o dimensión agregada dividida y ordenada según los atributos especificados. 
+ [https://docs.aws.amazon.com/quicksight/latest/user/windowAvg-function.html](https://docs.aws.amazon.com/quicksight/latest/user/windowAvg-function.html) calcula el promedio de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/windowCount-function.html](https://docs.aws.amazon.com/quicksight/latest/user/windowCount-function.html) calcula el recuento de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/windowMax-function.html](https://docs.aws.amazon.com/quicksight/latest/user/windowMax-function.html) calcula el máximo de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/windowMin-function.html](https://docs.aws.amazon.com/quicksight/latest/user/windowMin-function.html) calcula el mínimo de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados.
+ [https://docs.aws.amazon.com/quicksight/latest/user/windowSum-function.html](https://docs.aws.amazon.com/quicksight/latest/user/windowSum-function.html) calcula la suma de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados.

# Funciones
<a name="functions"></a>

En esta sección encontrarás una lista de las funciones disponibles en Amazon Quick. Para ver una lista de funciones ordenadas por categoría, con breves definiciones, consulte [Funciones por categoría](https://docs.aws.amazon.com/quicksight/latest/user/functions-by-category.html).

**Topics**
+ [addDateTime](addDateTime-function.md)
+ [addWorkDays](addWorkDays-function.md)
+ [Abs](abs-function.md)
+ [Ceil](ceil-function.md)
+ [Coalesce](coalesce-function.md)
+ [Concat](concat-function.md)
+ [contains](contains-function.md)
+ [decimalToInt](decimalToInt-function.md)
+ [dateDiff](dateDiff-function.md)
+ [endsWith](endsWith-function.md)
+ [epochDate](epochDate-function.md)
+ [Exp](exp-function.md)
+ [Extract](extract-function.md)
+ [Floor](floor-function.md)
+ [formatDate](formatDate-function.md)
+ [Ifelse](ifelse-function.md)
+ [in](in-function.md)
+ [intToDecimal](intToDecimal-function.md)
+ [isNotNull](isNotNull-function.md)
+ [isNull](isNull-function.md)
+ [isWorkDay](isWorkDay-function.md)
+ [Left](left-function.md)
+ [Locate](locate-function.md)
+ [Log](log-function.md)
+ [Ln](ln-function.md)
+ [Ltrim](ltrim-function.md)
+ [Mod](mod-function.md)
+ [netWorkDays](netWorkDays-function.md)
+ [Now](now-function.md)
+ [notIn](notIn-function.md)
+ [nullIf](nullIf-function.md)
+ [parseDate](parseDate-function.md)
+ [parseDecimal](parseDecimal-function.md)
+ [parseInt](parseInt-function.md)
+ [parseJson](parseJson-function.md)
+ [Replace](replace-function.md)
+ [Right](right-function.md)
+ [Round](round-function.md)
+ [Rtrim](rtrim-function.md)
+ [Split](split-function.md)
+ [Sqrt](sqrt-function.md)
+ [startsWith](startsWith-function.md)
+ [Strlen](strlen-function.md)
+ [Substring](substring-function.md)
+ [switch](switch-function.md)
+ [toLower](toLower-function.md)
+ [toString](toString-function.md)
+ [toUpper](toUpper-function.md)
+ [trim](trim-function.md)
+ [truncDate](truncDate-function.md)

# addDateTime
<a name="addDateTime-function"></a>

`addDateTime` suma o resta una unidad de tiempo a partir de valor de fecha y hora. Por ejemplo, `addDateTime(2,'YYYY',parseDate('02-JUL-2018', 'dd-MMM-yyyy') )` devuelve `02-JUL-2020`. Puede utilizar esta función para realizar cálculos de fecha en los datos de fecha y hora. 

## Sintaxis
<a name="addDateTime-function-syntax"></a>

```
addDateTime(amount, period, datetime)
```

## Argumentos
<a name="addDateTime-function-arguments"></a>

 *amount*   
Un valor entero positivo o negativo que representa la cantidad de tiempo que desea sumar o restar en el campo de fecha y hora proporcionado. 

 *periodo*   
Un valor positivo o negativo que representa la cantidad de tiempo que desea sumar o restar del campo de fecha y hora proporcionado. Los periodos válidos son los siguientes:   
+ YYYY: devuelve la parte del año de la fecha. 
+ Q: devuelve el trimestre al que pertenece la fecha (1 a 4). 
+ MM: devuelve la parte del mes de la fecha. 
+ DD: devuelve la parte del día de la fecha. 
+ WK: devuelve la parte de la semana de la fecha. La semana comienza el domingo en Amazon Quick. 
+ HH: devuelve la parte de la hora de la fecha. 
+ MI: devuelve la parte de minutos de la fecha. 
+ SS: devuelve la parte de segundos de la fecha.
+ MS: devuelve la parte de milisegundos de la fecha.

 *datetime*   
La fecha u hora en la que desea realizar cálculos de fecha. 

## Tipo de devolución
<a name="addDateTime-function-return-type"></a>

Fecha y hora

## Ejemplo
<a name="addDateTime-function-example"></a>

Supongamos que tiene un campo llamado `purchase_date` que tiene los siguientes valores.

```
2018 May 13 13:24
2017 Jan 31 23:06
2016 Dec 28 06:45
```

Con los siguientes cálculos, `addDateTime` modifica los valores tal y como se muestra a continuación.

```
addDateTime(-2, 'YYYY', purchaseDate)

2016 May 13 13:24
2015 Jan 31 23:06
2014 Dec 28 06:45


addDateTime(4, 'DD', purchaseDate)

2018 May 17 13:24
2017 Feb 4 23:06
2017 Jan 1 06:45


addDateTime(20, 'MI', purchaseDate)

2018 May 13 13:44
2017 Jan 31 23:26
2016 Dec 28 07:05
```

# addWorkDays
<a name="addWorkDays-function"></a>

`addWorkDays` suma o resta un número designado de días laborables a un valor de fecha determinado. La función devuelve la fecha de un día laborable, es decir, un día laborable designado anterior o posterior a un valor de fecha de entrada determinado. 

## Sintaxis
<a name="addWorkDays-function-syntax"></a>

```
addWorkDays(initDate, numWorkDays)
```

## Argumentos
<a name="addWorkDays-function-arguments"></a>

*initDate*  
Una fecha válida que no sea NULL y que actúe como fecha de inicio del cálculo.   
+ **Campo de conjunto de datos**: cualquier campo `date` del conjunto de datos al que vaya a agregar esta función.
+ **Función de fecha**: cualquier salida de fecha de otra función `date`, por ejemplo, `parseDate`, `epochDate`, `addDateTime`, etc.  
**Example**  

  ```
  addWorkDays(epochDate(1659484800), numWorkDays)
  ```
+ **Campos calculados**: cualquier campo calculado rápidamente que devuelva un `date` valor.  
**Example**  

  ```
  calcFieldStartDate = addDateTime(10, “DD”, startDate)
  addWorkDays(calcFieldStartDate, numWorkDays)
  ```
+ **Parámetros**: cualquier `datetime` parámetro rápido.  
**Example**  

  ```
  addWorkDays($paramStartDate, numWorkDays)
  ```
+ Cualquier combinación de los valores de los argumentos indicados anteriormente.

 *numWorkDays*   
Una número entero que no sea NULL y que actúe como fecha de finalización del cálculo.   
+ **Literal**: número entero que se escribe directamente en el editor de expresiones.  
**Example**  

  ```
  ```
+ **Campo de conjunto de datos**: cualquier campo de fecha del conjunto de datos.   
**Example**  

  ```
  ```
+ **Función escalar o cálculo**: cualquier función rápida escalar que devuelva una salida entera de otra, por ejemplo `decimalToInt``abs`, y así sucesivamente.  
**Example**  

  ```
  addWorkDays(initDate, decimalToInt(sqrt (abs(numWorkDays)) ) )
  ```
+ **Campo calculado: cualquier campo** calculado rápidamente que devuelva un `date` valor.  
**Example**  

  ```
  someOtherIntegerCalcField = (num_days * 2) + 12
  addWorkDays(initDate, someOtherIntegerCalcField)
  ```
+ **Parámetro**: cualquier `datetime` parámetro rápido.  
**Example**  

  ```
  addWorkDays(initDate, $param_numWorkDays)
  ```
+ Cualquier combinación de los valores de los argumentos indicados anteriormente.

## Tipo de devolución
<a name="addWorkDays-function-return-type"></a>

Entero 

## Valores de salida
<a name="addWorkDays-function-output-type"></a>

Los valores de salida esperados incluyen los siguientes:
+ Número entero positivo (cuando start\$1date < end\$1date)
+ Número entero negativo (cuando start\$1date > end\$1date)
+ NULL cuando uno o ambos argumentos obtienen un valor nulo de `dataset field`.

## Errores de entrada
<a name="addWorkDays-function-errors"></a>

Los valores de argumento no permitidos provocan errores, como se muestra en los siguientes ejemplos.
+ No se permite utilizar un valor NULL literal como argumento en la expresión.  
**Example**  

  ```
  addWorkDays(NULL, numWorkDays) 
  ```  
**Example**  

  ```
  Error
  At least one of the arguments in this function does not have correct type. 
  Correct the expression and choose Create again.
  ```
+ No se permite utilizar una cadena literal como argumento, ni cualquier otro tipo de datos que no sea una fecha, en la expresión. En el ejemplo siguiente, la cadena **"2022-08-10"** tiene el aspecto de una fecha, pero en realidad es una cadena. Para usarla, tendría que usar una función que se convierta en un tipo de datos de fecha.  
**Example**  

  ```
  addWorkDays("2022-08-10", 10)
  ```  
**Example**  

  ```
  Error
  Expression addWorkDays("2022-08-10", numWorkDays) for function addWorkDays has 
  incorrect argument type addWorkDays(String, Number). 
  Function syntax expects Date, Integer.
  ```

## Ejemplo
<a name="addWorkDays-function-example"></a>

Un entero positivo como argumento `numWorkDays` producirá una fecha en el futuro de la fecha de entrada. Un entero negativo como argumento `numWorkDays` producirá una fecha resultante anterior a la fecha de entrada. Un valor cero para el argumento `numWorkDays` produce el mismo valor que la fecha de entrada, independientemente de que caiga en un día laborable o en un fin de semana.

La función `addWorkDays` funciona con el siguiente grado de detalle: `DAY`. La precisión no se puede preservar con un grado de detalle inferior o superior al nivel `DAY`.

```
addWorkDays(startDate, endDate)
```

Supongamos que hay un campo denominado `employmentStartDate` con los siguientes valores: 

```
2022-08-10 2022-08-06 2022-08-07 
```

Usando el campo anterior y los siguientes cálculos, `addWorkDays` devuelve los valores modificados como se muestra a continuación:

```
addWorkDays(employmentStartDate, 7)

2022-08-19 
2022-08-16 
2022-08-16 

addWorkDays(employmentStartDate, -5)

2022-08-02 
2022-08-01 
2022-08-03 

addWorkDays(employmentStartDate, 0)

2022-08-10 
2022-08-06 
2022-08-07
```

En el siguiente ejemplo se calcula la bonificación prorrateada total que se pagará a cada empleado durante 2 años en función del número de días que cada empleado haya trabajado realmente.

```
last_day_of_work = addWorkDays(employment_start_date, 730)
total_days_worked = netWorkDays(employment_start_date, last_day_of_work)
total_bonus = total_days_worked * bonus_per_day
```

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/addWorkDays-function-example.png)


# Abs
<a name="abs-function"></a>

`abs` devuelve el valor absoluto de una expresión dada. 

## Sintaxis
<a name="abs-function-syntax"></a>

```
abs(expression)
```

## Argumentos
<a name="abs-function-arguments"></a>

 *expresión*   
La expresión debe ser numérica. Puede ser un nombre de campo, un valor literal u otra función. 

# Ceil
<a name="ceil-function"></a>

`ceil` redondea un valor decimal al siguiente número entero más alto. Por ejemplo, `ceil(29.02)` devuelve `30`.

## Sintaxis
<a name="ceil-function-syntax"></a>

```
ceil(decimal)
```

## Argumentos
<a name="ceil-function-arguments"></a>

 *decimal*   
Un campo que utiliza el tipo de datos decimal, un valor literal como **17.62** o una llamada a otra función que genera un decimal.

## Tipo de devolución
<a name="ceil-function-return-type"></a>

Entero

## Ejemplo
<a name="ceil-function-example"></a>

En el siguiente ejemplo se redondea un campo decimal al siguiente número entero más alto.

```
ceil(salesAmount)
```

Los siguientes son los valores de los campos.

```
20.13
892.03
57.54
```

Para estos valores de campo, se devuelven los siguientes valores.

```
21
893
58
```

# Coalesce
<a name="coalesce-function"></a>

`coalesce` devuelve el valor del primer argumento que no sea nulo. Cuando se encuentra un valor no nulo, los argumentos restantes de la lista no se evalúan. Si todos los argumentos son null el resultado es null. Las cadenas de longitud 0 son valores válidos y no se consideran equivalentes a null.

## Sintaxis
<a name="coalesce-function-syntax"></a>

```
coalesce(expression1, expression2 [, expression3, ...])
```

## Argumentos
<a name="coalesce-function-arguments"></a>

`coalesce` toma dos o más expresiones como argumentos. Todas las expresiones deben tener el mismo tipo de datos o podrán emitirse implícitamente para el mismo tipo de datos.

 *expresión*   
La expresión puede ser numérica, una fecha o una cadena. Puede ser un nombre de campo, un valor literal u otra función. 

## Tipo de devolución
<a name="coalesce-function-return-type"></a>

`coalesce` devuelve un valor del mismo tipo de datos que los argumentos de entrada.

## Ejemplo
<a name="coalesce-function-example"></a>

En el siguiente ejemplo, se recupera una dirección de facturación del cliente si la hay o su dirección postal si no hay dirección de facturación, o se devuelve “No se ha indicado ninguna dirección” si ninguna de las dos direcciones está disponible.

```
coalesce(billingAddress, streetAddress, 'No address listed')
```

# Concat
<a name="concat-function"></a>

`concat` concatena dos o más cadenas.

## Sintaxis
<a name="concat-function-syntax"></a>

```
concat(expression1, expression2 [, expression3 ...])
```

## Argumentos
<a name="concat-function-arguments"></a>

`concat` toma dos o más expresiones de cadena como argumentos. 

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="concat-function-return-type"></a>

Cadena

## Ejemplos
<a name="concat-function-example"></a>

El siguiente ejemplo concatena tres campos de cadena y añade los espacios apropiados.

```
concat(salutation, ' ', firstName, ' ', lastName)
```

Los siguientes son los valores de los campos.

```
salutation     firstName          lastName
-------------------------------------------------------
Ms.            Li                  Juan
Dr.            Ana Carolina        Silva
Mr.            Nikhil              Jayashankar
```

Para estos valores de campo, se devuelven los siguientes valores.

```
Ms. Li Juan
Dr. Ana Carolina Silva
Mr. Nikhil Jayashankar
```

En el siguiente ejemplo, se concatenan dos literales de cadena.

```
concat('Hello', 'world')
```

Se devuelve el siguiente valor.

```
Helloworld
```

# contains
<a name="contains-function"></a>

`contains` evalúa si la subcadena que especifique existe dentro de una expresión. Si la expresión contiene la subcadena, la función contains devuelve true y, en caso contrario, devuelve false.

## Sintaxis
<a name="contains-function-syntax"></a>

```
contains(expression, substring, string-comparison-mode)
```

## Argumentos
<a name="contains-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *subcadena*   
El conjunto de caracteres que se comparan con la *expresión*. La subcadena puede aparecer una o más veces en la *expresión*.

 *string-comparison-mode*   
(Opcional) Especifica el modo de comparación de cadenas que se va a utilizar:  
+ `CASE_SENSITIVE`: las comparaciones de cadenas distinguen entre mayúsculas y minúsculas. 
+ `CASE_INSENSITIVE`: las comparaciones de cadenas no distinguen entre mayúsculas y minúsculas.
Este valor se establece de forma predeterminada en `CASE_SENSITIVE` cuando está en blanco.

## Tipo de devolución
<a name="contains-function-return-type"></a>

Booleano

## Ejemplos
<a name="contains-function-example"></a>

### Ejemplo de distinción entre mayúsculas y minúsculas predeterminado
<a name="contains-function-example-default-case-sensitive"></a>

En el siguiente ejemplo, que distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` contiene **New**.

```
contains(state_nm, "New")
```

Los siguientes son los valores de los campos.

```
New York
new york
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
false
```

### Ejemplo que no distingue entre mayúsculas y minúsculas
<a name="contains-function-example-case-insensitive"></a>

En el siguiente ejemplo, que no distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` contiene **new**.

```
contains(state_nm, "new", CASE_INSENSITIVE)
```

Los siguientes son los valores de los campos.

```
New York
new york
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
true
```

### Ejemplo con instrucciones condicionales
<a name="contains-function-example-conditional-statements"></a>

La función contains se puede utilizar como instrucción condicional en las siguientes funciones If: [avgIf](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html), [minIf](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html), [distinct\$1countIf](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html), [countIf](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html), [maxIf](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html), [medianIf](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html), [stdevIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html), [stdevpIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html), [sumIf](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html), [varIf](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) y [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). 

El siguiente ejemplo solo suma `Sales` si `state_nm` contiene **New**.

```
sumIf(Sales,contains(state_nm, "New"))
```

### NO contiene un ejemplo
<a name="contains-function-example-does-not-contain"></a>

El operador condicional `NOT` se puede usar para evaluar si la expresión no contiene la subcadena especificada. 

```
NOT(contains(state_nm, "New"))
```

### Ejemplo de uso de valores numéricos
<a name="contains-function-example-numeric-values"></a>

Los valores numéricos se pueden utilizar en los argumentos de la expresión o de la subcadena mediante la aplicación de la función `toString`.

```
contains(state_nm, toString(5) )
```

# decimalToInt
<a name="decimalToInt-function"></a>

`decimalToInt` convierte un valor decimal en el tipo de datos entero eliminando el punto decimal y cualquier número situado a continuación. `decimalToInt` no redondea al alza. Por ejemplo, `decimalToInt(29.99)` devuelve `29`.

## Sintaxis
<a name="decimalToInt-function-syntax"></a>

```
decimalToInt(decimal)
```

## Argumentos
<a name="decimalToInt-function-arguments"></a>

 *decimal*   
Un campo que utiliza el tipo de datos decimal, un valor literal como **17.62** o una llamada a otra función que genera un decimal.

## Tipo de devolución
<a name="decimalToInt-function-return-type"></a>

Entero

## Ejemplo
<a name="decimalToInt-function-example"></a>

El siguiente ejemplo convierte un campo decimal en un entero.

```
decimalToInt(salesAmount)
```

Los siguientes son los valores de los campos.

```
 20.13
892.03
 57.54
```

Para estos valores de campo, se devuelven los siguientes valores.

```
 20
892
 57
```

# dateDiff
<a name="dateDiff-function"></a>

`dateDiff` devuelve la diferencia en días entre dos campos de fecha. Si incluye un valor para el periodo, `dateDiff` devuelve la diferencia en el intervalo del periodo, en lugar de en días.

## Sintaxis
<a name="dateDiff-function-syntax"></a>

```
dateDiff(date1, date2,[period])
```

## Argumentos
<a name="dateDiff-function-arguments"></a>

`dateDiff` toma dos fechas como argumentos. La especificación de un periodo es opcional.

 *fecha 1*   
La primera fecha de la comparación. Un campo de fecha o una llamada a otra función que genera una fecha. 

 *fecha 2*   
La segunda fecha de la comparación. Un campo de fecha o una llamada a otra función que genera una fecha. 

 *periodo*   
El periodo de diferencia que desea obtener, entre comillas. Los periodos válidos son los siguientes:  
+ YYYY: devuelve la parte del año de la fecha.
+ Q: devuelve la fecha del primer día del trimestre al que pertenece la fecha. 
+ MM: devuelve la parte del mes de la fecha.
+ DD: devuelve la parte del día de la fecha.
+ WK: devuelve la parte de la semana de la fecha. La semana comienza el domingo en Amazon Quick.
+ HH: devuelve la parte de la hora de la fecha.
+ MI: devuelve la parte de minutos de la fecha.
+ SS: devuelve la parte de segundos de la fecha.
+ MS: devuelve la parte de milisegundos de la fecha.

## Tipo de devolución
<a name="dateDiff-function-return-type"></a>

Entero

## Ejemplo
<a name="dateDiff-function-example"></a>

El siguiente ejemplo devuelve la diferencia entre dos fechas.

```
dateDiff(orderDate, shipDate, "MM")
```

Los siguientes son los valores de los campos.

```
orderDate          shipdate
=============================
01/01/18            03/05/18
09/13/17            10/20/17
```

Para estos valores de campo, se devuelven los siguientes valores.

```
2
1
```

# endsWith
<a name="endsWith-function"></a>

`endsWith` evalúa si la expresión finaliza con la subcadena que especifique. Si la expresión finaliza con la subcadena, `endsWith` devuelve true y, en caso contrario, devuelve false.

## Sintaxis
<a name="endsWith-function-syntax"></a>

```
endsWith(expression, substring, string-comparison-mode)
```

## Argumentos
<a name="endsWith-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *subcadena*   
El conjunto de caracteres que se comparan con la *expresión*. La subcadena puede aparecer una o más veces en la *expresión*.

 *string-comparison-mode*   
(Opcional) Especifica el modo de comparación de cadenas que se va a utilizar:  
+ `CASE_SENSITIVE`: las comparaciones de cadenas distinguen entre mayúsculas y minúsculas. 
+ `CASE_INSENSITIVE`: las comparaciones de cadenas no distinguen entre mayúsculas y minúsculas.
Este valor se establece de forma predeterminada en `CASE_SENSITIVE` cuando está en blanco.

## Tipo de devolución
<a name="endsWith-function-return-type"></a>

Booleano

## Ejemplos
<a name="endsWith-function-example"></a>

### Ejemplo de distinción entre mayúsculas y minúsculas predeterminado
<a name="endsWith-function-example-default-case-sensitive"></a>

En el siguiente ejemplo, que distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` endsWith **"York"**.

```
endsWith(state_nm, "York")
```

Los siguientes son los valores de los campos.

```
New York
new york
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
false
```

### Ejemplo que no distingue entre mayúsculas y minúsculas
<a name="endsWith-function-example-case-insensitive"></a>

En el siguiente ejemplo, que no distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` endsWith **"york"**.

```
endsWith(state_nm, "york", CASE_INSENSITIVE)
```

Los siguientes son los valores de los campos.

```
New York
new york
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
true
```

### Ejemplo con instrucciones condicionales
<a name="endsWith-function-example-conditional-statements"></a>

La función `endsWith` se puede utilizar como instrucción condicional en las siguientes funciones If: [avgIf](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html), [minIf](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html), [distinct\$1countIf](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html), [countIf](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html), [maxIf](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html), [medianIf](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html), [stdevIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html), [stdevpIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html), [sumIf](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html), [varIf](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) y [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). 

El siguiente ejemplo solo suma `Sales` si `state_nm` finaliza con **"York"**.

```
sumIf(Sales,endsWith(state_nm, "York"))
```

### NO contiene un ejemplo
<a name="endsWith-function-example-does-not-start-with"></a>

El operador condicional `NOT` se puede usar para evaluar si la expresión no comienza por la subcadena especificada. 

```
NOT(endsWith(state_nm, "York"))
```

### Ejemplo de uso de valores numéricos
<a name="endsWith-function-example-numeric-values"></a>

Los valores numéricos se pueden utilizar en los argumentos de la expresión o de la subcadena mediante la aplicación de la función `toString`.

```
endsWith(state_nm, toString(5) )
```

# epochDate
<a name="epochDate-function"></a>

`epochDate`[convierte una fecha de época en una fecha estándar con el formato aaaa-mm-dd **T** kk:mm:ss.sss **Z**, utilizando la sintaxis de patrones de formato especificada en Class en la documentación del proyecto Joda. DateTimeFormat](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html) Un ejemplo es `2015-10-15T19:11:51.003Z`. 

`epochDate`se admite para su uso con análisis basados en conjuntos de datos almacenados en Quick (). SPICE

## Sintaxis
<a name="epochDate-function-syntax"></a>

```
epochDate(epochdate)
```

## Argumentos
<a name="epochDate-function-arguments"></a>

 *epochdate*   
La fecha de inicio, que es una representación en un número entero de una fecha como el número de segundos desde 00:00:00 UTC el 1 de enero de 1970.   
*epochdate* debe ser un número entero. Puede ser el nombre de un campo que utiliza el tipo de datos entero, un valor entero literal o una llamada a otra función que genera un entero. Si el valor entero es superior a 10 dígitos, los dígitos después de la décima posición se descartan.

## Tipo de devolución
<a name="epochDate-function-return-type"></a>

Date

## Ejemplo
<a name="epochDate-function-example"></a>

El ejemplo siguiente convierte una fecha de inicio en una fecha estándar.

```
epochDate(3100768000)
```

Se devuelve el siguiente valor.

```
2068-04-04T12:26:40.000Z
```

# Exp
<a name="exp-function"></a>

`exp` devuelve la base de logaritmo natural e elevada a la potencia de una expresión dada. 

## Sintaxis
<a name="exp-function-syntax"></a>

```
exp(expression)
```

## Argumentos
<a name="exp-function-arguments"></a>

 *expresión*   
La expresión debe ser numérica. Puede ser un nombre de campo, un valor literal u otra función. 

# Extract
<a name="extract-function"></a>

`extract` devuelve una parte especificada de un valor de fecha. Si solicita una parte relacionada con la hora de una fecha que no contiene información de tiempo, se devuelve 0.

## Sintaxis
<a name="extract-function-syntax"></a>

```
extract(period, date)
```

## Argumentos
<a name="extract-function-arguments"></a>

 *periodo*   
El periodo que desee que se extraiga del valor de fecha. Los periodos válidos son los siguientes:  
+ YYYY: devuelve la parte del año de la fecha.
+ Q: devuelve el trimestre al que pertenece la fecha (1 a 4). 
+ MM: devuelve la parte del mes de la fecha.
+ DD: devuelve la parte del día de la fecha.
+ WD: devuelve el día de la semana como un número entero, en el que el domingo es el 1.
+ HH: devuelve la parte de la hora de la fecha.
+ MI: devuelve la parte de minutos de la fecha.
+ SS: devuelve la parte de segundos de la fecha.
+ MS: devuelve la parte de milisegundos de la fecha.
**nota**  
Las bases de datos de Presto anteriores a la versión 0.216 no admiten la extracción de milisegundos.

 *date*   
Un campo de fecha o una llamada a otra función que genera una fecha.

## Tipo de devolución
<a name="extract-function-return-type"></a>

Entero

## Ejemplo
<a name="extract-function-example"></a>

El siguiente ejemplo extrae el día de un valor de fecha.

```
extract('DD', orderDate)
```

Los siguientes son los valores de los campos.

```
orderDate
=========
01/01/14  
09/13/16
```

Para estos valores de campo, se devuelven los siguientes valores.

```
01
13
```

# Floor
<a name="floor-function"></a>

`floor` disminuye un valor decimal al siguiente número entero más bajo. Por ejemplo, `floor(29.08)` devuelve `29`.

## Sintaxis
<a name="floor-function-syntax"></a>

```
floor(decimal)
```

## Argumentos
<a name="floor-function-arguments"></a>

 *decimal*   
Un campo que utiliza el tipo de datos decimal, un valor literal como **17.62** o una llamada a otra función que genera un decimal.

## Tipo de devolución
<a name="floor-function-return-type"></a>

Entero

## Ejemplo
<a name="floor-function-example"></a>

En el siguiente ejemplo se disminuye un campo decimal al siguiente número entero más bajo.

```
floor(salesAmount)
```

Los siguientes son los valores de los campos.

```
20.13
892.03
57.54
```

Para estos valores de campo, se devuelven los siguientes valores.

```
20
892
57
```

# formatDate
<a name="formatDate-function"></a>

`formatDate` da formato a una fecha utilizando el patrón que especifique. Cuando esté preparando datos, puede utilizar `formatDate` para cambiar el formato de la fecha. Para volver a dar formato a una fecha en un análisis, elija la opción de formato en el menú contextual del campo de fecha.

## Sintaxis
<a name="formatDate-function-syntax"></a>

```
formatDate(date, ['format'])
```

## Argumentos
<a name="formatDate-function-arguments"></a>

 *date*   
Un campo de fecha o una llamada a otra función que genera una fecha.

 *format*   
(Opcional) Una cadena que contiene el patrón de formato que se va a aplicar. Este argumento acepta los patrones de formato especificados en los [formatos de fecha admitidos](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html).  
Si no especifica un formato, el valor predeterminado de esta cadena es yyyy-MM-dd**T**kk: mm: ss: SSS.

## Tipo de devolución
<a name="formatDate-function-return-type"></a>

Cadena

## Ejemplo
<a name="formatDate-function-example"></a>

En el ejemplo siguiente se da formato a una fecha UTC.

```
formatDate(orderDate, 'dd-MMM-yyyy')
```

Los siguientes son los valores de los campos.

```
order date      
=========
2012-12-14T00:00:00.000Z  
2013-12-29T00:00:00.000Z
2012-11-15T00:00:00.000Z
```

Para estos valores de campo, se devuelven los siguientes valores.

```
13 Dec 2012
28 Dec 2013
14 Nov 2012
```

## Ejemplo
<a name="formatDate-function-example2"></a>

Si la fecha contiene comillas simples o apóstrofes, por ejemplo, `yyyyMMdd'T'HHmmss`, puede gestionar este formato de fecha mediante uno de los métodos siguientes.
+ Escriba la fecha completa entre comillas, tal como se muestra en el siguiente ejemplo:

  ```
  formatDate({myDateField}, "yyyyMMdd'T'HHmmss")
  ```
+ Para evitar las comillas simples o los apóstrofes, añada una barra invertida (`\`) a su izquierda, como se muestra en el siguiente ejemplo: 

  ```
  formatDate({myDateField}, 'yyyyMMdd\'T\'HHmmss')
  ```

# Ifelse
<a name="ifelse-function"></a>

`ifelse` evalúa un conjunto de pares de expresiones *if*, *then*; y devuelve el valor del argumento *then* durante el primer argumento *if* que se evalúa como verdadero. Si ninguno de los argumentos *if* se evalúa como verdadero, se devuelve el valor del argumento *else*.

## Sintaxis
<a name="ifelse-function-syntax"></a>

```
ifelse(if-expression-1, then-expression-1 [, if-expression-n, then-expression-n ...], else-expression)
```

## Argumentos
<a name="ifelse-function-arguments"></a>

`ifelse` requiere uno o más pares de expresiones *if*, *then* y requiere exactamente una expresión para el argumento *else*. 

 *if-expression*   
La expresión que se evalúa como verdadera o no. Puede ser un nombre de campo como **address1**, un valor literal como **'Unknown'** u otra función como `toString(salesAmount)`. Un ejemplo es `isNotNull(FieldName)`.   
Si utiliza varios operadores AND y OR en el argumento `if`, incluya las instrucciones entre paréntesis para identificar el orden de procesamiento. Por ejemplo, el siguiente argumento `if` devuelve registros con un mes de 1, 2 o 5 y un año de 2000.  

```
ifelse((month = 5 OR month < 3) AND year = 2000, 'yes', 'no')
```
El siguiente argumento `if` utiliza los mismos operadores, pero devuelve registros con un mes de 5 y cualquier año, o con un mes de 1 o 2 y un año de 2000.  

```
ifelse(month = 5 OR (month < 3 AND year = 2000), 'yes', 'no')
```

 *then-expression*   
La expresión que se va a devolver si su argumento *if* se evalúa como verdadero. Puede ser un nombre de campo como **address1**, un valor literal como **'Unknown'** o una llamada a otra función. La expresión debe tener el mismo tipo de datos que los otros argumentos `then` y el argumento `else`. 

 *else-expression*   
La expresión que se va a devolver si ninguno de los argumentos *if* se evalúan como verdaderos. Puede ser un nombre de campo como **address1**, un valor literal como **'Unknown'** u otra función como `toString(salesAmount)`. La expresión debe tener el mismo tipo de datos que todos los argumentos `then`. 

## Tipo de devolución
<a name="ifelse-function-return-type"></a>

`ifelse` devuelve un valor del mismo tipo de datos que los valores de *then-expression*. Todos los datos que devolvieron las expresiones *then* y *else* deben ser del mismo tipo de datos o estar convertidos al mismo tipo de datos. 

## Ejemplos
<a name="ifelse-function-example"></a>

En el siguiente ejemplo se genera una columna de alias para el campo `country`.

```
ifelse(country = "United States", "US", country = "China", "CN", country = "India", "IN", "Others") 
```

Para estos casos de uso, se evalúa cada valor de un campo comparándolo con una lista de literales y se devuelve el resultado correspondiente al primer valor coincidente. Se recomienda cambiar de función para simplificar el trabajo. El ejemplo anterior se puede reescribir en la siguiente instrucción mediante: [https://docs.aws.amazon.com/quicksight/latest/user/switch-function.html](https://docs.aws.amazon.com/quicksight/latest/user/switch-function.html)

```
switch(country,"United States","US","China","CN","India","IN","Others")
```

En el siguiente ejemplo se clasifican las ventas por cliente en niveles legibles para las personas.

```
ifelse(salesPerCustomer < 1000, “VERY_LOW”, salesPerCustomer < 10000, “LOW”, salesPerCustomer < 100000, “MEDIUM”, “HIGH”)
```

En el ejemplo siguiente se utiliza AND, OR y NOT para comparar varias expresiones utilizando operadores condicionales e identificar los principales clientes que NO se encuentren en Washington ni en Oregón para una promoción especial, siempre que hayan realizado más de 10 pedidos. Si no se devuelven valores, se obtiene el valor `'n/a'`.

```
ifelse(( (NOT (State = 'WA' OR State =  'OR')) AND Orders > 10),  'Special Promotion XYZ',  'n/a')
```

Los ejemplos siguientes utilizan únicamente OR para generar una nueva columna que contenga el nombre del continente correspondiente a cada `country`.

```
ifelse(country = "United States" OR country = "Canada", "North America", country = "China" OR country = "India" OR country = "Japan", "Asia", "Others")
```

El ejemplo anterior se puede simplificar como se muestra en el siguiente ejemplo. En el siguiente ejemplo se utiliza `ifelse` y [https://docs.aws.amazon.com/quicksight/latest/user/in-function.html](https://docs.aws.amazon.com/quicksight/latest/user/in-function.html) para crear un valor en una columna nueva para cualquier fila en la que el valor probado esté en una lista literal. También se puede usar `ifelse` con [https://docs.aws.amazon.com/quicksight/latest/user/notIn-function.html](https://docs.aws.amazon.com/quicksight/latest/user/notIn-function.html).

```
ifelse(in(country,["United States", "Canada"]), "North America", in(country,["China","Japan","India"]),"Asia","Others")
```

Los autores pueden guardar una lista literal en un parámetro con varios valores y utilizarla en las funciones [https://docs.aws.amazon.com/quicksight/latest/user/in-function.html](https://docs.aws.amazon.com/quicksight/latest/user/in-function.html) o [https://docs.aws.amazon.com/quicksight/latest/user/notIn-function.html](https://docs.aws.amazon.com/quicksight/latest/user/notIn-function.html). El ejemplo siguiente es equivalente al ejemplo anterior, con la salvedad de que las listas literales se almacenan en dos parámetros con varios valores. 

```
ifelse(in(country,${NorthAmericaCountryParam}), "North America", in(country,${AsiaCountryParam}),"Asia", "Others") 
```

En el siguiente ejemplo se asigna un grupo a un registro de ventas basándose en el total de ventas. La estructura de cada frase `if-then` imita el comportamiento de *between*, una palabra clave que actualmente no funciona en las expresiones de campo calculadas. Por ejemplo, el resultado de la comparación `salesTotal >= 0 AND salesTotal < 500` devuelve los mismos valores que la comparación `salesTotal between 0 and 499` de SQL.

```
ifelse(salesTotal >= 0 AND salesTotal < 500, 'Group 1', salesTotal >= 500 AND salesTotal < 1000, 'Group 2', 'Group 3')
```

En el siguiente ejemplo se comprueba un valor NULL y se utiliza `coalesce` para devolver el primer valor que no sea NULL. En lugar de tener que recordar el significado de un valor NULL en un campo de fecha, puede utilizar una descripción legible. Si la fecha de desconexión es NULL, el ejemplo devuelve la fecha de suspensión, a menos que ambas sean NULL. A continuación, `coalesce(DiscoDate, SuspendDate, '12/31/2491')` devuelve `'12/31/2491'`. El valor devuelto debe coincidir con los demás tipos de datos. Esta fecha puede parecer un valor inusual, pero una fecha del siglo XXV simula razonablemente el “fin de los tiempos”, que se define como la fecha más alta de un data mart. 

```
ifelse (  (coalesce(DiscoDate, SuspendDate, '12/31/2491') = '12/31/2491'),  'Active subscriber', 'Inactive subscriber')
```

A continuación se muestra un ejemplo más complejo en un formato más legible, solo para demostrar que no es necesario comprimir todo el código en una línea larga. En este ejemplo se proporcionan varias comparaciones del valor del resultado de una encuesta. Maneja los posibles valores NULL para este campo y clasifica dos rangos aceptables. También etiqueta un rango que necesita más pruebas y otro que no es válido (fuera del rango). Para todos los valores restantes, aplica la condición `else` y etiqueta la fila como si fuera necesaria una nueva prueba tres años después de la fecha indicada en esa fila. 

```
ifelse
( 
    isNull({SurveyResult}), 'Untested',  
    {SurveyResult}=1, 'Range 1', 
    {SurveyResult}=2, 'Range 2', 
    {SurveyResult}=3, 'Need more testing',
    {SurveyResult}=99, 'Out of Range',
    concat  
    (
        'Retest by ', 
        toString    
        (
           addDateTime(3, "YYYY", {Date}) 
        )
    )
)
```

En el siguiente ejemplo se asigna un nombre de región creado “manualmente” a un grupo de estados. También se utiliza el espaciado y los comentarios, entre `/* */`, para facilitar el mantenimiento del código. 

```
ifelse 
(    /* NE REGION*/
     locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) > 0,
    'Northeast',

     /* SE REGION*/
     locate('Georgia, Alabama, South Carolina, Louisiana',{State}) > 0,
    'Southeast',

    'Other Region'
)
```

La lógica del etiquetado de la región se desglosa de la siguiente manera:

1. Enumeramos los estados que queremos para cada región y escribimos cada lista entre comillas para hacer que cada lista sea una cadena, de la siguiente manera: 
   + `'New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire'`
   + `'Georgia, Alabama, South Carolina, Louisiana'`
   + Puede agregar más conjuntos o usar países, ciudades, provincias o What3Words si lo desea. 

1. Para preguntar si el valor de `State` (para cada fila) se encuentra en la lista, usamos la función `locate` para devolver un valor distinto de cero si el estado se encuentra en la lista, como se indica a continuación.

   ```
   locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) 
   
   and
   
   locate('Georgia, Alabama, South Carolina, Louisiana',{State})
   ```

1. La función `locate` devuelve un número en lugar de un valor `TRUE` o `FALSE`, pero `ifelse` requiere el valor booleano `TRUE`/`FALSE`. Para evitar esto, podemos comparar el resultado de `locate` con un número. Si el estado está en la lista, el valor devuelto es mayor que cero.

   1. Pregunte si el estado está presente.

      ```
      locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) > 0
      ```

   1. Si está presente en la región, etiquétela como la región específica, en este caso, una región del noreste.

      ```
      /*The if expression:*/     locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) > 0,
      /*The then expression:*/   'Northeast',
      ```

1. Como tenemos estados que no están en una lista y `ifelse` requiere una expresión `else` única, utilizamos una etiqueta `'Other Region'` para los estados sobrantes. 

   ```
   /*The if expression:*/     locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) > 0,
   /*The then expression:*/   'Northeast',
   /*The else expression:*/   'Other Region'
   ```

1. Incluimos todo eso en la función `ifelse( )` para obtener la versión final. En el siguiente ejemplo se omiten los estados de la región sudeste que estaban en el original. Puede volver a agregarlos en lugar de la etiqueta *`<insert more regions here>`*. 

   Si desea agregar más regiones, puede crear más copias de esas dos líneas y modificar la lista de estados para adaptarla a sus necesidades. Puede cambiar el nombre de la región por el que más le convenga y cambiar el nombre del campo `State` por el que necesite. 

   ```
   ifelse 
   (
   /*The if expression:*/     locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) > 0,
   /*The then expression:*/   'Northeast',
   
   /*<insert more regions here>*/
   
   /*The else expression:*/   'Other Region'
   )
   ```
**nota**  
Existen otras formas de realizar la comparación inicial de la expresión if. Por ejemplo, supongamos que plantea la pregunta “¿Qué estados no faltan en esta lista?” en lugar de “¿Qué estados están en la lista?” Si lo hace, podría expresarlo de otra manera. Puede comparar la instrucción locate con cero para buscar los valores que faltan en la lista y, a continuación, utilizar el operador NOT para clasificarlos como “no ausentes”, como se indica a continuación.  

   ```
   /*The if expression:*/      NOT (locate('New York, New Jersey, Connecticut, Vermont, Maine, Rhode Island, New Hampshire',{State}) = 0),
   ```
Ambas versiones son correctas. La versión que elija debería tener más sentido para usted y su equipo, de forma que pueda mantenerla fácilmente. Si todas las opciones parecen iguales, elija la más sencilla.

# in
<a name="in-function"></a>

`in` evalúa si existe una expresión en una lista literal. Si la lista contiene la expresión, devuelve true y, en caso contrario, devuelve false. `in` distingue entre mayúsculas y minúsculas para las entradas de tipo cadena.

`in` acepta dos tipos de listas literales: una es una lista que se introduce manualmente y la otra es un [parámetro con varios valores.](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html)

## Sintaxis
<a name="in-function-syntax"></a>

Uso de una lista introducida manualmente:

```
in(expression, [literal-1, ...])  
```

Uso de un parámetro con varios valores:

```
in(expression, $multivalue_parameter)
```

## Argumentos
<a name="in-function-arguments"></a>

 *expresión*   
La expresión que se va a comparar con los elementos de la lista literal. Puede ser un nombre de campo, como `address`, un valor literal, como “**Unknown**”, un parámetro de un solo valor o una llamada a otra función escalar, siempre que esta función no sea una función de agregado o un cálculo de tabla.

 *lista literal*   
(Obligatorio) Puede ser una lista introducida manualmente o un parámetro con varios valores. Este argumento acepta hasta 5000 elementos. Sin embargo, en una consulta directa a un origen de datos de terceros, por ejemplo, Oracle o Teradata, la restricción puede ser menor.  
+ ***lista introducida manualmente***: uno o más valores literales de una lista para compararlos con la expresión. La lista se debe escribir entre corchetes. Todos los literales que se van a comparar deben tener el mismo tipo de datos que la expresión. 
+ ***parámetro con varios valores***: un parámetro con varios valores predefinido que se pasa como una lista literal. El parámetro con varios valores debe tener el mismo tipo de datos que la expresión. 


## Tipo de devolución
<a name="in-function-return-type"></a>

Valor booleano TRUE o FALSE

## Ejemplo con una lista estática
<a name="in-function-example-static-list"></a>

En el siguiente ejemplo se evalúa el campo `origin_state_name` en busca de valores en una lista de cadenas. Al comparar una entrada de tipo cadena, `in` solo admite la comparación que distingue entre mayúsculas y minúsculas.

```
in(origin_state_name,["Georgia", "Ohio", "Texas"])
```

Los siguientes son los valores de los campos.

```
"Washington"
        "ohio"
        "Texas"
```

Para estos valores de campo, se devuelven los siguientes valores.

```
false
        false
        true
```

El tercer valor devuelto es true porque solo “Texas” es uno de los valores incluidos.

En el siguiente ejemplo se evalúa el campo `fl_date` en busca de valores en una lista de cadenas. Para que coincida con el tipo, `toString` se utiliza para convertir el tipo de fecha en un tipo de cadena.

```
in(toString(fl_date),["2015-05-14","2015-05-15","2015-05-16"])
```

![\[Imagen de los resultados del ejemplo de la función, que se muestra en forma de tabla.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/in-function-example-manual-list.png)


Los valores literales y NULL se admiten en el argumento de expresión para compararlos con los literales de la lista. Los dos ejemplos siguientes generarán una nueva columna de valores TRUE. 

```
in("Washington",["Washington","Ohio"])
```

```
in(NULL,[NULL,"Ohio"])
```

## Ejemplo con parámetro con varios valores
<a name="in-function-example-mutivalue-parameter"></a>

Supongamos que un autor crea un [parámetro con varios valores](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html) que contiene una lista de todos los nombres de los estados. Luego, el autor agrega un control para que el lector pueda seleccionar valores de la lista.

A continuación, el lector selecciona tres valores (“Georgia”, “Ohio” y “Texas”) del control de la lista desplegable del parámetro. En este caso, la siguiente expresión equivale al primer ejemplo, en el que esos tres nombres de estados se pasan como lista literal para compararlos con el campo `original_state_name`. 

```
in (origin_state_name, ${stateName MultivalueParameter})
```

## Ejemplo con `ifelse`
<a name="in-function-example-with-ifelse"></a>

`in` se puede anidar en otras funciones como un valor booleano. Un ejemplo es que los autores pueden evaluar cualquier expresión de una lista y devolver el valor que desean mediante `in` y `ifelse`. En el siguiente ejemplo se evalúa si el `dest_state_name` de un vuelo se encuentra en una lista determinada de estados de EE. UU. y se devuelven diferentes categorías de estados en función de la comparación.

```
ifelse(in(dest_state_name,["Washington", "Oregon","California"]), "WestCoastUSState", "Other US State")
```

![\[Imagen de los resultados del ejemplo de la función, que se muestra en forma de tabla.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/in-function-with-ifelse.png)


# intToDecimal
<a name="intToDecimal-function"></a>

`intToDecimal` convierte un valor entero en el tipo de datos decimal.

## Sintaxis
<a name="intToDecimal-function-syntax"></a>

```
intToDecimal(integer)
```

## Argumentos
<a name="intToDecimal-function-arguments"></a>

 *int*   
Un campo que utiliza el tipo de datos entero, un valor literal como **14** o una llamada a otra función que genera un entero.

## Tipo de devolución
<a name="intToDecimal-function-return-type"></a>

Decimal (fijo) en la experiencia tradicional de preparación de datos.

Decimal (flotante) en la nueva experiencia de preparación de datos.

## Ejemplo
<a name="intToDecimal-function-example"></a>

El siguiente ejemplo convierte un campo entero en un decimal.

```
intToDecimal(price)
```

Los siguientes son los valores de los campos.

```
20
892
57
```

Para estos valores de campo, se devuelven los siguientes valores.

```
20.0
892.0
58.0
```

Puede aplicar formato dentro de un análisis, por ejemplo, para formatear `price` como divisa. 

# isNotNull
<a name="isNotNull-function"></a>

`isNotNull` evalúa una expresión para ver si no es nula. Si la expresión no es nula, `isNotNull` devuelve “true”; de lo contrario devuelve “false”.

## Sintaxis
<a name="isNotNull-function-syntax"></a>

```
isNotNull(expression)
```

## Argumentos
<a name="isNotNull-function-arguments"></a>

 *expresión*   
La expresión se evalúa como nula o no. Puede ser un nombre de campo como **address1**, o una llamada a otra función que genere una cadena. 

## Tipo de devolución
<a name="isNotNull-function-return-type"></a>

Booleano

## Ejemplo
<a name="isNotNull-function-example"></a>

El siguiente ejemplo evalúa el campo sales\$1amount en busca de valores nulos.

```
isNotNull(salesAmount)
```

Los siguientes son los valores de los campos.

```
20.13
(null)
57.54
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
false
true
```

# isNull
<a name="isNull-function"></a>

`isNull` evalúa una expresión para ver si es nula. Si la expresión es nula, `isNull` devuelve “true”, de lo contrario devuelve “false”.

## Sintaxis
<a name="isNull-function-syntax"></a>

```
isNull(expression)
```

## Argumentos
<a name="isNull-function-arguments"></a>

 *expresión*   
La expresión se evalúa como nula o no. Puede ser un nombre de campo como **address1**, o una llamada a otra función que genere una cadena. 

## Tipo de devolución
<a name="isNull-function-return-type"></a>

Booleano

## Ejemplo
<a name="isNull-function-example"></a>

El siguiente ejemplo evalúa el campo sales\$1amount en busca de valores nulos.

```
isNull(salesAmount)
```

Los siguientes son los valores de los campos.

```
20.13
(null)
57.54
```

Para estos valores de campo, se devuelven los siguientes valores.

```
false
true
false
```

En el siguiente ejemplo se comprueba si hay un valor NULL en una instrucción `ifelse` y, en su lugar, se devuelve un valor legible por humanos.

```
ifelse( isNull({ActiveFlag}) , 'Inactive',  'Active') 
```

# isWorkDay
<a name="isWorkDay-function"></a>

`isWorkDay` evalúa un valor de fecha y hora determinado para determinar si el valor es un día laborable o no.

`isWorkDay` asume una semana laboral estándar de 5 días que comienza el lunes y termina el viernes. Se supone que los sábados y domingos son fines de semana. La función siempre calcula su resultado con el grado de detalle `DAY` y no incluye la fecha de entrada dada.

## Sintaxis
<a name="isWorkDay-function-syntax"></a>

```
isWorkDay(inputDate)
```

## Argumentos
<a name="isWorkDay-function-arguments"></a>

 *inputDate*   
El valor de fecha y hora que desea evaluar. Los valores válidos son los siguientes:  
+ Campos de conjunto de datos: cualquier campo `date` del conjunto de datos al que vaya a agregar esta función.
+ Función de fecha: cualquier salida de fecha de otra función `date`, por ejemplo, `parseDate`.
+ Campos calculados: cualquier campo calculado rápidamente que devuelva un `date` valor.
+ Parámetros: cualquier `DateTime` parámetro rápido.

## Tipo de devolución
<a name="isWorkDay-function-return-type"></a>

Entero (`0` o `1`)

## Ejemplo
<a name="isWorkDay-function-example"></a>

En el siguiente ejemplo se determina si el campo `application_date` es un día laborable o no.

Supongamos que hay un campo denominado `application_date` con los siguientes valores:

```
2022-08-10 
2022-08-06 
2022-08-07
```

Al usar estos campos y agregar los siguientes cálculos, `isWorkDay` devuelve los siguientes valores:

```
isWorkDay({application_date})     
                                                     
1
0
0
```

En el siguiente ejemplo se filtra a los empleados cuyo empleo termina un día laborable y se determina si su empleo comenzó un día laborable o un fin de semana mediante el formato condicional:

```
is_start_date_work_day = isWorkDay(employment_start_date)
is_end_date_work_day = isWorkDay(employment_end_date)
```

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/isWorkDay-example.png)


# Left
<a name="left-function"></a>

`left` devuelve los caracteres más a la izquierda de una cadena, incluidos los espacios. Deberá especificar el número de caracteres que quiere que se devuelvan. 

## Sintaxis
<a name="left-function-syntax"></a>

```
left(expression, limit)
```

## Argumentos
<a name="left-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *limit*   
El número de caracteres que se van a devolver de la *expresión*, a partir del primer carácter de la cadena.

## Tipo de devolución
<a name="left-function-return-type"></a>

Cadena

## Ejemplo
<a name="left-function-example"></a>

En el siguiente ejemplo, se devuelven los 3 primeros caracteres de una cadena.

```
left('Seattle Store #14', 3)
```

Se devuelve el siguiente valor.

```
Sea
```

# Locate
<a name="locate-function"></a>

`locate` localiza la subcadena que especifique en otra cadena y devuelve el número de caracteres hasta el primer carácter de la subcadena. La función devuelve 0 si no encuentra la subcadena. La función se basa en 1.

## Sintaxis
<a name="locate-function-syntax"></a>

```
locate(expression, substring, start)
```

## Argumentos
<a name="locate-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *subcadena*   
El conjunto de caracteres de *expression* que desee localizar. La subcadena puede aparecer una o más veces en *expression*.

 *start*   
(Opcional) Si la *subcadena* se produce más de una vez, utilice *start* para identificar en qué parte de la cadena debe empezar a buscar la subcadena la función. Por ejemplo, suponga que desea encontrar el segundo ejemplo de una subcadena y cree que normalmente aparece después de los primeros 10 caracteres. Puede especificar como valor de *inicio* 10. Debe empezar en 1.

## Tipo de devolución
<a name="locate-function-return-type"></a>

Entero

## Ejemplos
<a name="locate-function-example"></a>

El siguiente ejemplo devuelve información sobre dónde tiene lugar la primera aparición de la subcadena “and” en una cadena.

```
locate('1 and 2 and 3 and 4', 'and')
```

Se devuelve el siguiente valor.

```
3
```

El siguiente ejemplo devuelve información sobre dónde tiene lugar la primera aparición de la subcadena “and” en una cadena después del cuarto carácter.

```
locate('1 and 2 and 3 and 4', 'and', 4)
```

Se devuelve el siguiente valor.

```
9
```

# Log
<a name="log-function"></a>

`log` devuelve el logaritmo en base 10 de una expresión dada.

## Sintaxis
<a name="log-function-syntax"></a>

```
log(expression)
```

## Argumentos
<a name="log-function-arguments"></a>

 *expresión*   
La expresión debe ser numérica. Puede ser un nombre de campo, un valor literal u otra función. 

# Ln
<a name="ln-function"></a>

`ln` devuelve el logaritmo natural de una expresión dada. 

## Sintaxis
<a name="ln-function-syntax"></a>

```
ln(expression)
```

## Argumentos
<a name="ln-function-arguments"></a>

 *expresión*   
La expresión debe ser numérica. Puede ser un nombre de campo, un valor literal u otra función. 

# Ltrim
<a name="ltrim-function"></a>

`ltrim` elimina los espacios en blanco situados antes de una cadena.

## Sintaxis
<a name="ltrim-function-syntax"></a>

```
ltrim(expression)
```

## Argumentos
<a name="ltrim-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="ltrim-function-return-type"></a>

Cadena

## Ejemplo
<a name="ltrim-function-example"></a>

El siguiente ejemplo elimina los espacios precedentes de una cadena.

```
ltrim('   Seattle Store #14')
```

Se devuelve el siguiente valor.

```
Seattle Store #14
```

# Mod
<a name="mod-function"></a>

Utilice la función `mod` para averiguar el resto después de dividir el número por el divisor. Puede utilizar la función `mod` o el operador de módulo (%) indistintamente.

## Sintaxis
<a name="mod-function-syntax"></a>

```
mod(number, divisor)
```

```
number%divisor
```

## Argumentos
<a name="mod-function-arguments"></a>

 *número*   
El número es el entero positivo que desea dividir para averiguar el resto. 

 *divisor*   
El divisor es el entero positivo por el que se divide. Si el divisor es cero, esta función devuelve un error al dividir por 0.

## Ejemplo
<a name="mod-function-example"></a>

Los siguientes ejemplos devuelven un módulo de 17 al dividir por 6. El primer ejemplo utiliza el operador % y el segundo la función mod.

```
17%6
```

```
mod( 17, 6 )
```

Se devuelve el siguiente valor.

```
5
```

# netWorkDays
<a name="netWorkDays-function"></a>

`netWorkDays`devuelve el número de días laborables entre los dos campos de fecha proporcionados o incluso los valores de fecha personalizados generados mediante otras funciones de fecha rápida, como `parseDate` o `epochDate` como un entero. 

`netWorkDays` asume una semana laboral estándar de 5 días que comienza el lunes y termina el viernes. Se supone que los sábados y domingos son fines de semana. El cálculo incluye los valores `startDate` y `endDate`. La función funciona y muestra los resultados del grado de detalle de DAY. 

## Sintaxis
<a name="netWorkDays-function-syntax"></a>

```
netWorkDays(startDate, endDate)
```

## Argumentos
<a name="netWorkDays-function-arguments"></a>

 *startDate*   
Una fecha válida que no sea NULL y que actúe como fecha de inicio del cálculo.   
+ Campos de conjunto de datos: cualquier campo `date` del conjunto de datos al que vaya a agregar esta función.
+ Función de fecha: cualquier salida de fecha de otra función `date`, por ejemplo, `parseDate`.
+ Campos calculados: cualquier campo calculado rápidamente que devuelva un `date` valor.
+ Parámetros: cualquier `DateTime` parámetro rápido.
+ Cualquier combinación de los valores de los argumentos indicados anteriormente.

 *endDate*   
Una fecha válida que no sea NULL y que actúe como fecha de finalización del cálculo.   
+ Campos de conjunto de datos: cualquier campo `date` del conjunto de datos al que vaya a agregar esta función.
+ Función de fecha: cualquier salida de fecha de otra función `date`, por ejemplo, `parseDate`.
+ Campos calculados: cualquier campo calculado rápidamente que devuelva un `date` valor.
+ Parámetros: cualquier `DateTime` parámetro rápido.
+ Cualquier combinación de los valores de los argumentos indicados anteriormente.

## Tipo de devolución
<a name="netWorkDays-function-return-type"></a>

Entero 

## Valores de salida
<a name="netWorkDays-function-output-type"></a>

Los valores de salida esperados incluyen los siguientes:
+ Número entero positivo (cuando start\$1date < end\$1date)
+ Número entero negativo (cuando start\$1date > end\$1date)
+ NULL cuando uno o ambos argumentos obtienen un valor nulo de `dataset field`.

## Ejemplo
<a name="netWorkDays-function-example"></a>

En el siguiente ejemplo se devuelve la cantidad de días laborables entre dos fechas.

Supongamos que hay un campo denominado `application_date` con los siguientes valores:

```
netWorkDays({startDate}, {endDate})
```

Los siguientes son los valores de los campos.

```
startDate	endDate	netWorkDays
        9/4/2022	9/11/2022	5
        9/9/2022	9/2/2022	-6
        9/10/2022	9/11/2022	0
        9/12/2022	9/12/2022	1
```

En el siguiente ejemplo se calcula el número de días trabajados por cada empleado y el salario empleado por día para cada empleado:

```
days_worked = netWorkDays({employment_start_date}, {employment_end_date})
        salary_per_day = {salary}/{days_worked}
```

En el siguiente ejemplo se filtra a los empleados cuyo empleo termina un día laborable y se determina si su empleo comenzó un día laborable o un fin de semana mediante el formato condicional:

```
is_start_date_work_day = netWorkDays(employment_start_date)
        is_end_date_work_day = netWorkDays(employment_end_date)
```

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/netWorkDays-function-example.png)


# Now
<a name="now-function"></a>

Para conjuntos de datos de base de datos que consultan directamente la base de datos, `now` devuelve la fecha y hora actuales utilizando la configuración y el formato que especifica el servidor de base de datos. Para conjuntos de datos de SPICE y Salesforce, `now` devuelve la fecha y la hora UTC con el formato `yyyy-MM-ddTkk:mm:ss:SSSZ` (por ejemplo, 2015-10-15T19:11:51:003 Z). 

## Sintaxis
<a name="now-function-syntax"></a>

```
now()
```

## Tipo de devolución
<a name="now-function-return-type"></a>

Date

# notIn
<a name="notIn-function"></a>

`notIn` evalúa si existe una expresión en una lista literal. Si la lista no contiene la expresión, `notIn` devuelve true y, en caso contrario, devuelve false. `notIn` distingue entre mayúsculas y minúsculas para las entradas de tipo cadena.

`notIn` acepta dos tipos de listas literales: una es una lista que se introduce manualmente y la otra es un [parámetro con varios valores.](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html)

## Sintaxis
<a name="notIn-function-syntax"></a>

Uso de una lista introducida manualmente:

```
notIn(expression, [literal-1, ...])  
```

Uso de un parámetro con varios valores:

```
notIn(expression, $multivalue_parameter)
```

## Argumentos
<a name="notIn-function-arguments"></a>

 *expresión*   
La expresión que se va a comparar con los elementos de la lista literal. Puede ser un nombre de campo, como `address`, un valor literal, como “**Unknown**”, un parámetro de un solo valor o una llamada a otra función escalar, siempre que esta función no sea una función de agregado o un cálculo de tabla.

 *lista literal*   
(Obligatorio) Puede ser una lista introducida manualmente o un parámetro con varios valores. Este argumento acepta hasta 5000 elementos. Sin embargo, en una consulta directa a un origen de datos de terceros, por ejemplo, Oracle o Teradata, la restricción puede ser menor.  
+ ***lista introducida manualmente***: uno o más valores literales de una lista para compararlos con la expresión. La lista se debe escribir entre corchetes. Todos los literales que se van a comparar deben tener el mismo tipo de datos que la expresión. 
+ ***parámetro con varios valores***: un parámetro con varios valores predefinido que se pasa como una lista literal. El parámetro con varios valores debe tener el mismo tipo de datos que la expresión. 


## Tipo de devolución
<a name="notIn-function-return-type"></a>

Valor booleano TRUE o FALSE

## Ejemplo con una lista introducida manualmente
<a name="notIn-function-example-manual-list"></a>

En el siguiente ejemplo se evalúa el campo `origin_state_name` en busca de valores en una lista de cadenas. Al comparar una entrada de tipo cadena, `notIn` solo admite la comparación que distingue entre mayúsculas y minúsculas.

```
notIn(origin_state_name,["Georgia", "Ohio", "Texas"])
```

Los siguientes son los valores de los campos.

```
"Washington"
        "ohio"
        "Texas"
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
        true
        false
```

El tercer valor devuelto es false porque solo “Texas” es uno de los valores excluidos.

En el siguiente ejemplo se evalúa el campo `fl_date` en busca de valores en una lista de cadenas. Para que coincida con el tipo, `toString` se utiliza para convertir el tipo de fecha en un tipo de cadena.

```
notIn(toString(fl_date),["2015-05-14","2015-05-15","2015-05-16"])
```

![\[Imagen de los resultados del ejemplo de la función, que se muestra en forma de tabla.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/notin-function-example-manual-list.png)


Los valores literales y NULL se admiten en el argumento de expresión para compararlos con los literales de la lista. Los dos ejemplos siguientes generarán una nueva columna de valores FALSE. 

```
notIn("Washington",["Washington","Ohio"])
```

```
notIn(NULL,[NULL,"Ohio"])
```

## Ejemplo con parámetro con varios valores
<a name="notIn-function-example-mutivalue-parameter"></a>

Supongamos que un autor crea un [parámetro con varios valores](https://docs.aws.amazon.com/quicksight/latest/user/parameters-in-quicksight.html) que contiene una lista de todos los nombres de los estados. Luego, el autor agrega un control para que el lector pueda seleccionar valores de la lista.

A continuación, el lector selecciona tres valores (“Georgia”, “Ohio” y “Texas”) del control de la lista desplegable del parámetro. En este caso, la siguiente expresión equivale al primer ejemplo, en el que esos tres nombres de estados se pasan como lista literal para compararlos con el campo `original_state_name`. 

```
notIn (origin_state_name, ${stateName MultivalueParameter})
```

## Ejemplo con `ifelse`
<a name="notIn-function-example-with-ifelse"></a>

`notIn` se puede anidar en otras funciones como un valor booleano. Un ejemplo es que los autores pueden evaluar cualquier expresión de una lista y devolver el valor que desean mediante `notIn` y `ifelse`. En el siguiente ejemplo se evalúa si el `dest_state_name` de un vuelo se encuentra en una lista determinada de estados de EE. UU. y se devuelven diferentes categorías de estados en función de la comparación.

```
ifelse(notIn(dest_state_name,["Washington", "Oregon","California"]), "notWestCoastUSState", "WestCoastUSState")
```

![\[Imagen de los resultados del ejemplo de la función, que se muestra en forma de tabla.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/notin-function-with-ifelse.png)


# nullIf
<a name="nullIf-function"></a>

`nullIf` compara dos expresiones. Si son iguales, la función devuelve “null”. Si no son iguales, la función devuelve la primera expresión.

## Sintaxis
<a name="nullIf-function-syntax"></a>

```
nullIf(expression1, expression2)
```

## Argumentos
<a name="nullIf-function-arguments"></a>

`nullIf` toma dos expresiones como argumentos. 

 *expresión*   
La expresión puede ser numérica, una fecha o una cadena. Puede ser un nombre de campo, un valor literal u otra función. 

## Tipo de devolución
<a name="nullIf-function-return-type"></a>

Cadena

## Ejemplo
<a name="nullIf-function-example"></a>

El siguiente ejemplo devuelve valores nulos si se desconoce el motivo del retraso de un envío.

```
nullIf(delayReason, 'unknown')
```

Los siguientes son los valores de los campos.

```
delayReason
============
unknown         
back ordered 
weather delay
```

Para estos valores de campo, se devuelven los siguientes valores.

```
(null)
back ordered 
weather delay
```

# parseDate
<a name="parseDate-function"></a>

`parseDate`analiza una cadena para determinar si contiene un valor de fecha y devuelve una fecha estándar en ese formato `yyyy-MM-ddTkk:mm:ss.SSSZ` (utilizando la sintaxis de patrones de formato especificada en [Class DateTimeFormat](http://www.joda.org/joda-time/apidocs/org/joda/time/format/DateTimeFormat.html) en la documentación del proyecto Joda), por ejemplo 2015-10-15T 19:11:51.003 Z. Esta función devuelve todas las filas que contienen una fecha con un formato válido y omite las que no lo tienen, incluidas las filas que contienen valores nulos.

Quick admite fechas en el intervalo comprendido entre el 1 de enero de 1900 a las 00:00:00 UTC y el 31 de diciembre de 2037 a las 23:59:59 UTC. [Para obtener más información, consulta Formatos de fecha compatibles.](https://docs.aws.amazon.com/quicksight/latest/user/supported-date-formats.html)

## Sintaxis
<a name="parseDate-function-syntax"></a>

```
parseDate(expression, ['format'])
```

## Argumentos
<a name="parseDate-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'1/1/2016'** o una llamada a otra función que genera una cadena.

 *format*   
(Opcional) Una cadena que contiene el patrón de formato con el que *date\$1string* debe coincidir. Por ejemplo, si utiliza un campo con datos como**01/03/2016**, debe especificar el formato 'MM/dd/yyyy'. Si no especifica un formato, el valor predeterminado es `yyyy-MM-dd`. Se omitirán las filas cuyos datos no se ajustan al *formato*.   
Se admiten distintos formatos de fecha en función del tipo de conjunto de datos utilizado. Utilice la siguiente tabla para ver detalles de formatos de fecha admitidos.    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/parseDate-function.html)

## Tipo de devolución
<a name="parseDate-function-return-type"></a>

Date

## Ejemplo
<a name="parseDate-function-example"></a>

En el siguiente ejemplo, se evalúa `prodDate` para determinar si contiene valores de fecha.

```
parseDate(prodDate, 'MM/dd/yyyy')
```

Los siguientes son los valores de los campos.

```
prodDate
--------
01-01-1999
12/31/2006
1/18/1982 
7/4/2010
```

Para estos valores de campo, se devuelven las siguientes filas.

```
12-31-2006T00:00:00.000Z
01-18-1982T00:00:00.000Z
07-04-2010T00:00:00.000Z
```

# parseDecimal
<a name="parseDecimal-function"></a>

`parseDecimal` analiza una cadena para determinar si contiene un valor decimal. Esta función devuelve todas las filas que contienen un valor decimal, entero o nulo y omite las que no lo tienen. Si la fila contiene un valor entero, se devuelve como un decimal con hasta cuatro cifras decimales. Por ejemplo, un valor “2” se devuelve como “2.0”.

## Sintaxis
<a name="parseDecimal-function-syntax"></a>

```
parseDecimal(expression)
```

## Argumentos
<a name="parseDecimal-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'9.62'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="parseDecimal-function-return-type"></a>

Decimal (fijo) en la experiencia tradicional de preparación de datos.

Decimal (flotante) en la nueva experiencia de preparación de datos.

## Ejemplo
<a name="parseDecimal-function-example"></a>

En el siguiente ejemplo, se evalúa `fee` para determinar si contiene valores decimales.

```
parseDecimal(fee)
```

Los siguientes son los valores de los campos.

```
fee
--------
2
2a
12.13
3b
3.9
(null)
198.353398
```

Para estos valores de campo, se devuelven las siguientes filas.

```
2.0
12.13
3.9
(null)
198.3533
```

# parseInt
<a name="parseInt-function"></a>

`parseInt` analiza una cadena para determinar si contiene un valor entero. Esta función devuelve todas las filas que contienen un valor decimal, entero o nulo y omite las que no lo tienen. Si la fila contiene un valor decimal, se devuelve como el entero más cercano, redondeado a la baja. Por ejemplo, un valor “2.99” se devuelve como “2”.

## Sintaxis
<a name="parseInt-function-syntax"></a>

```
parseInt(expression)
```

## Argumentos
<a name="parseInt-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'3'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="parseInt-function-return-type"></a>

Entero

## Ejemplo
<a name="parseInt-function-example"></a>

En el siguiente ejemplo, se evalúa `feeType` para determinar si contiene valores enteros.

```
parseInt(feeType)
```

Los siguientes son los valores de los campos.

```
feeType
--------
2
2.1
2a
3
3b
(null)
5
```

Para estos valores de campo, se devuelven las siguientes filas.

```
2
2
3
(null)
5
```

# parseJson
<a name="parseJson-function"></a>

Con `parseJson` puede extraer valores de un objeto JSON. 

Si el conjunto de datos está almacenado en QuickSPICE, puede usarlo `parseJson` cuando prepare un conjunto de datos, pero no en los campos calculados durante el análisis.

En caso de una consulta directa, puede utilizar `parseJson` tanto durante la preparación de los datos como en el análisis. La función `parseJson` se aplica a cadenas o a los tipos de datos nativos JSON, dependiendo del dialecto, como se muestra en la siguiente tabla.


| Dialect | Tipo | 
| --- | --- | 
| PostgreSQL | JSON | 
| Amazon Redshift | Cadena | 
| Microsoft SQL Server | Cadena | 
| MySQL | JSON | 
| Teradata | JSON | 
| Oracle | Cadena | 
| Presto | Cadena | 
| Snowflake | Objeto de tipo de datos semiestructurado y matriz | 
| Hive | Cadena | 

## Sintaxis
<a name="parseJson-function-syntax"></a>

```
parseJson(fieldName, path)
```

## Argumentos
<a name="parseJson-function-arguments"></a>

 *fieldName*   
El campo que contiene el objeto JSON que desea analizar.

 *path*   
La ruta del elemento de datos que desea analizar a partir del objeto JSON. Solo se permiten letras, números y espacios en blanco en el argumento de ruta. La sintaxis de ruta válida incluye:  
+ *\$1*: objeto raíz
+ *.*: operador secundario
+ *[ ]*: operador de subíndice para matriz

## Tipo de devolución
<a name="parseJson-function-return-type"></a>

Cadena

## Ejemplo
<a name="parseJson-function-example-query"></a>

En el siguiente ejemplo se evalúa el JSON entrante para obtener el valor de la cantidad de elementos. Si se usa durante la preparación de los datos, es posible crear una tabla a partir del código JSON.

```
parseJson({jsonField}, “$.items.qty”)
```

El código JSON es el siguiente:

```
{
    "customer": "John Doe",
    "items": {
        "product": "Beer",
        "qty": 6
    },
    "list1": [
        "val1",
        "val2"
    ],
    "list2": [
        {
            "list21key1": "list1value1"
        }
    ]
}
```

Con este ejemplo se obtiene el valor siguiente:

```
6
```

## Ejemplo
<a name="parseJson-function-example"></a>

En el siguiente ejemplo se evalúa `JSONObject1` para extraer el primer par clave-valor (KVP) con la etiqueta `"State"` y asignar el valor al campo calculado que está creando.

```
parseJson(JSONObject1, “$.state”)
```

Los siguientes son los valores de los campos.

```
JSONObject1
-----------
{"State":"New York","Product":"Produce","Date Sold":"1/16/2018","Sales Amount":"$3423.39"}
{"State":"North Carolina","Product":"Bakery Products","Date Sold":"2/1/2018","Sales Amount":"$3226.42"}
{"State":"Utah","Product":"Water","Date Sold":"4/24/2018","Sales Amount":"$7001.52"}
```

Para estos valores de campo, se devuelven las siguientes filas.

```
New York
North Carolina
Utah
```

# Replace
<a name="replace-function"></a>

`replace` sustituye parte de una cadena con otra cadena que especifique. 

## Sintaxis
<a name="replace-function-syntax"></a>

```
replace(expression, substring, replacement)
```

## Argumentos
<a name="replace-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *subcadena*   
El conjunto de caracteres en *expression* que desee reemplazar. La subcadena puede aparecer una o más veces en *expression*.

 *replacement*   
La cadena que desea que se sustituya para una *subcadena*.

## Tipo de devolución
<a name="replace-function-return-type"></a>

Cadena

## Ejemplo
<a name="replace-function-example"></a>

El siguiente ejemplo sustituye la subcadena “and” por “or”.

```
replace('1 and 2 and 3', 'and', 'or')
```

Se devuelve la siguiente cadena.

```
1 or 2 or 3
```

# Right
<a name="right-function"></a>

`right` devuelve los caracteres más a la derecha de una cadena, incluidos los espacios. Deberá especificar el número de caracteres que quiere que se devuelvan.

## Sintaxis
<a name="right-function-syntax"></a>

```
right(expression, limit)
```

## Argumentos
<a name="right-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *limit*   
El número de caracteres que se va a devolver de la *expresión*, a partir del último carácter de la cadena.

## Tipo de devolución
<a name="right-function-return-type"></a>

Cadena

## Ejemplo
<a name="right-function-example"></a>

En el siguiente ejemplo, se devuelven los cinco últimos caracteres de una cadena.

```
right('Seattle Store#14', 12)
```

Se devuelve el siguiente valor.

```
tle Store#14
```

# Round
<a name="round-function"></a>

`round` redondea un valor decimal al número entero más cercano si no se especifica la escala, o al decimal más cercano si se especifica escala.

## Sintaxis
<a name="round-function-syntax"></a>

```
round(decimal, scale)
```

## Argumentos
<a name="round-function-arguments"></a>

 *decimal*   
Un campo que utiliza el tipo de datos decimal, un valor literal como **17.62** o una llamada a otra función que genera un decimal.

 *scale*   
El número de decimales que se va a utilizar para los valores de devolución.

## Tipo de devolución
<a name="round-function-return-type"></a>


| Operando | Escriba el texto de la experiencia antigua de preparación de datos | Escriba el tipo en la nueva experiencia de preparación de datos | 
| --- | --- | --- | 
|  INT  |  DECIMAL (FIJO)  |  DECIMAL (FIJO)  | 
|  DECIMAL (FIJO)  |  DECIMAL (FIJO)  |  DECIMAL (FIJO)  | 
|  DECIMAL (FLOTANTE)  |  DECIMAL (FIJO)  |  DECIMAL (FLOTANTE)  | 

## Ejemplo
<a name="round-function-example"></a>

En el siguiente ejemplo se redondea un campo decimal al segundo decimal más cercano.

```
round(salesAmount, 2)
```

Los siguientes son los valores de los campos.

```
20.1307
892.0388
57.5447
```

Para estos valores de campo, se devuelven los siguientes valores.

```
20.13
892.04
58.54
```

# Rtrim
<a name="rtrim-function"></a>

`rtrim` elimina los espacios en blanco situados después de una cadena. 

## Sintaxis
<a name="rtrim-function-syntax"></a>

```
rtrim(expression)
```

## Argumentos
<a name="rtrim-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="rtrim-function-return-type"></a>

Cadena

## Ejemplo
<a name="rtrim-function-example"></a>

El siguiente ejemplo elimina los espacios que siguen a una cadena.

```
rtrim('Seattle Store #14   ')
```

Para estos valores de campo, se devuelven los siguientes valores.

```
Seattle Store #14
```

# Split
<a name="split-function"></a>

`split` divide una cadena en una matriz de subcadenas basándose en el delimitador que se elija, y devuelve el elemento que especifica la posición.

Solo se puede añadir `split` a un campo calculado durante la preparación de datos, no a un análisis. Esta función no se admite en las consultas directas a Microsoft SQL Server.

## Sintaxis
<a name="split-function-syntax"></a>

```
split(expression, delimiter , position)
```

## Argumentos
<a name="split-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street;1402 35th Ave;1818 Elm Ct;11 Janes Lane'** o una llamada a otra función que genera una cadena.

 *delimiter*   
El carácter que delimita el punto en el que la cadena se divide en subcadenas. Por ejemplo, `split('one|two|three', '|', 2)` se convierte en lo siguiente.  

```
one
two
three
```
Si elige `position = 2`, `split` devuelve `'two'`.

 *position*   
(Obligatorio) La posición del elemento que se devuelve de la matriz. La posición del primer elemento de la matriz es 1.

## Tipo de devolución
<a name="split-function-return-type"></a>

Matriz de cadenas

## Ejemplo
<a name="split-function-example"></a>

En el siguiente ejemplo se divide una cadena en una matriz utilizando el punto y coma (;) como delimitador, y se devuelve el tercer elemento de la matriz.

```
split('123 Test St;1402 35th Ave;1818 Elm Ct;11 Janes Lane', ';', 3)
```

Se devuelve el siguiente elemento.

```
1818 Elm Ct
```

Esta función omitirá los elementos que contienen valores nulos o cadenas vacías. 

# Sqrt
<a name="sqrt-function"></a>

`sqrt` devuelve la raíz cuadrada de una expresión dada. 

## Sintaxis
<a name="sqrt-function-syntax"></a>

```
sqrt(expression)
```

## Argumentos
<a name="sqrt-function-arguments"></a>

 *expresión*   
La expresión debe ser numérica. Puede ser un nombre de campo, un valor literal u otra función. 

# startsWith
<a name="startsWith-function"></a>

`startsWith` evalúa si la expresión comienza por la subcadena que especifique. Si la expresión comienza por la subcadena, `startsWith` devuelve true y, en caso contrario, devuelve false.

## Sintaxis
<a name="startsWith-function-syntax"></a>

```
startsWith(expression, substring, string-comparison-mode)
```

## Argumentos
<a name="startsWith-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

 *subcadena*   
El conjunto de caracteres que se comparan con la *expresión*. La subcadena puede aparecer una o más veces en la *expresión*.

 *string-comparison-mode*   
(Opcional) Especifica el modo de comparación de cadenas que se va a utilizar:  
+ `CASE_SENSITIVE`: las comparaciones de cadenas distinguen entre mayúsculas y minúsculas. 
+ `CASE_INSENSITIVE`: las comparaciones de cadenas no distinguen entre mayúsculas y minúsculas.
Este valor se establece de forma predeterminada en `CASE_SENSITIVE` cuando está en blanco.

## Tipo de devolución
<a name="startsWith-function-return-type"></a>

Booleano

## Ejemplos
<a name="startsWith-function-example"></a>

### Ejemplo de distinción entre mayúsculas y minúsculas predeterminado
<a name="startsWith-function-example-default-case-sensitive"></a>

En el siguiente ejemplo, que distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` startsWith **New**.

```
startsWith(state_nm, "New")
```

Los siguientes son los valores de los campos.

```
New York
new york
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
false
```

### Ejemplo que no distingue entre mayúsculas y minúsculas
<a name="startsWith-function-example-case-insensitive"></a>

En el siguiente ejemplo, que no distingue entre mayúsculas y minúsculas, se evalúa si `state_nm` startsWith **new**.

```
startsWith(state_nm, "new", CASE_INSENSITIVE)
```

Los siguientes son los valores de los campos.

```
New York
new york
```

Para estos valores de campo, se devuelven los siguientes valores.

```
true
true
```

### Ejemplo con instrucciones condicionales
<a name="startsWith-function-example-conditional-statements"></a>

La función `startsWith` se puede utilizar como instrucción condicional en las siguientes funciones If: [avgIf](https://docs.aws.amazon.com/quicksight/latest/user/avgIf-function.html), [minIf](https://docs.aws.amazon.com/quicksight/latest/user/minIf-function.html), [distinct\$1countIf](https://docs.aws.amazon.com/quicksight/latest/user/distinct_countIf-function.html), [countIf](https://docs.aws.amazon.com/quicksight/latest/user/countIf-function.html), [maxIf](https://docs.aws.amazon.com/quicksight/latest/user/maxIf-function.html), [medianIf](https://docs.aws.amazon.com/quicksight/latest/user/medianIf-function.html), [stdevIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevIf-function.html), [stdevpIf](https://docs.aws.amazon.com/quicksight/latest/user/stdevpIf-function.html), [sumIf](https://docs.aws.amazon.com/quicksight/latest/user/sumIf-function.html), [varIf](https://docs.aws.amazon.com/quicksight/latest/user/varIf-function.html) y [varpIf](https://docs.aws.amazon.com/quicksight/latest/user/varpIf-function.html). 

El siguiente ejemplo solo suma `Sales` si state\$1nm comienza por **New**.

```
sumIf(Sales,startsWith(state_nm, "New"))
```

### NO contiene un ejemplo
<a name="startsWith-function-example-does-not-start-with"></a>

El operador condicional `NOT` se puede usar para evaluar si la expresión no comienza por la subcadena especificada. 

```
NOT(startsWith(state_nm, "New"))
```

### Ejemplo de uso de valores numéricos
<a name="startsWith-function-example-numeric-values"></a>

Los valores numéricos se pueden utilizar en los argumentos de la expresión o de la subcadena mediante la aplicación de la función `toString`.

```
startsWith(state_nm, toString(5) )
```

# Strlen
<a name="strlen-function"></a>

`strlen` devuelve el número de caracteres de una cadena, incluidos los espacios.

## Sintaxis
<a name="strlen-function-syntax"></a>

```
strlen(expression)
```

## Argumentos
<a name="strlen-function-arguments"></a>

 *expresión*   
Una expresión puede ser el nombre de un campo que utiliza el tipo de datos de cadena como **address1**, un valor literal como **'Unknown'** u otra función como `substring(field_name,0,5)`.

## Tipo de devolución
<a name="strlen-function-return-type"></a>

Entero

## Ejemplo
<a name="strlen-function-example"></a>

El siguiente ejemplo devuelve la longitud de la cadena especificada.

```
strlen('1421 Main Street')
```

Se devuelve el siguiente valor.

```
16
```

# Substring
<a name="substring-function"></a>

`substring` devuelve los caracteres en una cadena, a partir de la ubicación especificada en el argumento *start* y continuando por el número de caracteres especificado en los argumentos *length*. 

## Sintaxis
<a name="substring-function-syntax"></a>

```
substring(expression, start, length)
```

## Argumentos
<a name="substring-function-arguments"></a>

 *expresión*   
Una expresión puede ser el nombre de un campo que utiliza el tipo de datos de cadena como **address1**, un valor literal como **'Unknown'** u otra función como `substring(field_name,1,5)`.

 *start*   
La ubicación de caracteres desde donde empezar. *start* es inclusivo, por lo que el carácter de la posición inicial es el primer carácter del valor devuelto. El valor mínimo para *start* es 1. 

 *longitud*   
El número de caracteres adicionales que incluir después de *start*. *length* incluye *start*, por lo que el último carácter devuelto es (*length* - 1) tras el carácter inicial.

## Tipo de devolución
<a name="substring-function-return-type"></a>

Cadena

## Ejemplo
<a name="substring-function-example"></a>

El siguiente ejemplo devuelve desde el carácter 13.º al 19.º de una cadena. El principio de la cadena es el índice 1, por lo que se empieza a contar desde el primer carácter.

```
substring('Fantasy and Science Fiction',13,7)
```

Se devuelve el siguiente valor.

```
Science
```

# switch
<a name="switch-function"></a>

`switch` compara *condition-expression* con las etiquetas literales, dentro de un conjunto de combinaciones de etiquetas literales y *return-expression*. A continuación, devuelve la expresión *return-expression* correspondiente a la primera etiqueta literal que es igual a la expresión *condition-expression*. Si ninguna etiqueta es igual a la expresión *condition-expression*, `switch` devuelve la expresión *default-expression*. Todas las expresiones *return-expression* y *default-expression* deben tener el mismo tipo de datos.

## Sintaxis
<a name="switch-function-syntax"></a>

```
switch(condition-expression, label-1, return-expression-1 [, label-n, return-expression-n ...], 
        default-expression)
```

## Argumentos
<a name="switch-function-arguments"></a>

`switch` requiere uno o más pares de expresiones *if*, *then* y requiere exactamente una expresión para el argumento *else*. 

 *condition-expression*   
La expresión que se va a comparar con los literales de etiqueta. Puede ser un nombre de campo, como `address`, un valor literal, como `Unknown`, u otra función escalar, como `toString(salesAmount)`. 

 *etiqueta*   
El literal que se va a comparar con el argumento de *condition-expression*. Todos los literales deben tener el mismo tipo de datos que el argumento *condition-expression*. `switch` acepta hasta 5000 etiquetas. 

 *return-expression*   
La expresión que se devolverá si el valor de su etiqueta es igual al valor de la expresión *condition-expression*. Puede ser un nombre de campo, como `address`, un valor literal, como `Unknown`, u otra función escalar, como `toString(salesAmount)`. Todos los argumentos de *return-expression* deben tener el mismo tipo de datos que *default-expression*.

 *default-expression*   
La expresión que se devolverá si ningún valor de ningún argumento de la etiqueta es igual al valor de *condition-expression*. Puede ser un nombre de campo, como `address`, un valor literal, como `Unknown`, u otra función escalar, como `toString(salesAmount)`. *default-expression* debe tener el mismo tipo de datos que todos los argumentos de *return-expression*.

## Tipo de devolución
<a name="switch-function-return-type"></a>

`switch` devuelve un valor del mismo tipo de datos que los valores de *return-expression*. Todos los datos que devolvieron las expresiones *return-expression* y *default-expression* deben ser del mismo tipo de datos o estar convertidos al mismo tipo de datos. 

## Ejemplos generales
<a name="switch-function-example"></a>

El siguiente ejemplo devuelve el Región de AWS código del nombre de la región de entrada. 

```
switch(region_name, 
               "US East (N. Virginia)", "us-east-1", 
               "Europe (Ireland)", "eu-west-1", 
               "US West (N. California)", "us-west-1", 
               "other regions")
```

Los siguientes son los valores de los campos.

```
"US East (N. Virginia)"
        "US West (N. California)"
        "Asia Pacific (Tokyo)"
```

Para estos valores de campo, se devuelven los siguientes valores.

```
"us-east-1"
        "us-west-1"
        "other regions"
```

## Uso del cambio para reemplazar `ifelse`
<a name="switch-instead-of-ifelse"></a>

El siguiente caso de uso `ifelse` es equivalente al ejemplo anterior. En el caso de `ifelse`, para evaluar si los valores de un campo son iguales a valores literales diferentes, es una mejor opción usar `switch` en su lugar.

```
ifelse(region_name = "US East (N. Virginia)", "us-east-1", 
               region_name = "Europe (Ireland)", "eu-west-1", 
               region_name = "US West (N. California)", "us-west-1", 
               "other regions")
```

## Expresión como valor devuelto
<a name="switch-expression-as-return-value"></a>

En el siguiente ejemplo se utilizan expresiones en *return-expressions*:

```
switch({origin_city_name}, 
               "Albany, NY", {arr_delay} + 20, 
               "Alexandria, LA", {arr_delay} - 10,
               "New York, NY", {arr_delay} * 2, 
               {arr_delay})
```

En el ejemplo anterior se cambia el tiempo de retraso previsto para cada vuelo desde una ciudad concreta.

![\[Imagen de los resultados del ejemplo de la función, que se muestra en forma de tabla.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/switch-function-example.png)


# toLower
<a name="toLower-function"></a>

`toLower` da formato a una cadena en minúsculas. `toLower` omite las filas que contienen valores nulos.

## Sintaxis
<a name="toLower-function-syntax"></a>

```
toLower(expression)
```

## Argumentos
<a name="toLower-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="toLower-function-return-type"></a>

Cadena

## Ejemplo
<a name="toLower-function-example"></a>

El siguiente ejemplo convierte un valor de cadena en minúsculas.

```
toLower('Seattle Store #14')
```

Se devuelve el siguiente valor.

```
seattle store #14
```

# toString
<a name="toString-function"></a>

`toString` da formato a la expresión de entrada como una cadena. `toString` omite las filas que contienen valores nulos.

## Sintaxis
<a name="toString-function-syntax"></a>

```
toString(expression)
```

## Argumentos
<a name="toString-function-arguments"></a>

 *expresión*   
 Una expresión puede ser un campo de cualquier tipo de datos, un valor literal como **14.62**, o una llamada a otra función que devuelve cualquier tipo de datos.

## Tipo de devolución
<a name="toString-function-return-type"></a>

Cadena

## Ejemplo
<a name="toString-function-example"></a>

En el siguiente ejemplo, se devuelven como cadenas los valores de `payDate` (que utiliza el tipo de datos `date`).

```
toString(payDate)
```

Los siguientes son los valores de los campos.

```
payDate
--------
1992-11-14T00:00:00.000Z
2012-10-12T00:00:00.000Z
1973-04-08T00:00:00.000Z
```

Para estos valores de campo, se devuelven las siguientes filas.

```
1992-11-14T00:00:00.000Z
2012-10-12T00:00:00.000Z
1973-04-08T00:00:00.000Z
```

# toUpper
<a name="toUpper-function"></a>

`toUpper` da formato a una cadena en mayúsculas. `toUpper` omite las filas que contienen valores nulos.

## Sintaxis
<a name="toUpper-function-syntax"></a>

```
toUpper(expression)
```

## Argumentos
<a name="toUpper-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="toUpper-function-return-type"></a>

Cadena

## Ejemplo
<a name="toUpper-function-example"></a>

El siguiente ejemplo convierte un valor de cadena en mayúsculas.

```
toUpper('Seattle Store #14')
```

Se devuelve el siguiente valor.

```
SEATTLE STORE #14
```

# trim
<a name="trim-function"></a>

`trim` elimina los espacios en blanco situados antes y después de una cadena. 

## Sintaxis
<a name="trim-function-syntax"></a>

```
trim(expression)
```

## Argumentos
<a name="trim-function-arguments"></a>

 *expresión*   
La expresión debe ser una cadena. Puede ser el nombre de un campo que utiliza el tipo de datos de cadena, un valor literal como **'12 Main Street'** o una llamada a otra función que genera una cadena.

## Tipo de devolución
<a name="trim-function-return-type"></a>

Cadena

## Ejemplo
<a name="trim-function-example"></a>

El siguiente ejemplo elimina los espacios que siguen a una cadena.

```
trim('   Seattle Store #14   ')
```

Para estos valores de campo, se devuelven los siguientes valores.

```
Seattle Store #14
```

# truncDate
<a name="truncDate-function"></a>

`truncDate` devuelve un valor de fecha que representa una parte especificada de una fecha. Por ejemplo, solicitar la parte del año del valor 2012-09-02T00:00:00.000Z devuelve 2012-01-01T00:00:00.000Z. Especificar un período relacionado con la hora para una fecha que no contenga información de hora devuelve el valor de fecha inicial sin modificarse.

## Sintaxis
<a name="truncDate-function-syntax"></a>

```
truncDate('period', date)
```

## Argumentos
<a name="truncDate-function-arguments"></a>

 *periodo*   
El periodo de la fecha que desee que se devuelva. Los periodos válidos son los siguientes:  
+ YYYY: devuelve la parte del año de la fecha.
+ Q: devuelve la fecha del primer día del trimestre al que pertenece la fecha. 
+ MM: devuelve la parte del mes de la fecha.
+ DD: devuelve la parte del día de la fecha.
+ WK: devuelve la parte de la semana de la fecha. La semana comienza el domingo en Amazon Quick.
+ HH: devuelve la parte de la hora de la fecha.
+ MI: devuelve la parte de minutos de la fecha.
+ SS: devuelve la parte de segundos de la fecha.
+ MS: devuelve la parte de milisegundos de la fecha.

 *date*   
Un campo de fecha o una llamada a otra función que genera una fecha.

## Tipo de devolución
<a name="truncDate-function-return-type"></a>

Date

## Ejemplo
<a name="truncDate-function-example"></a>

En el siguiente ejemplo, se devuelve una fecha que representa el mes de la fecha del pedido.

```
truncDate('MM', orderDate)
```

Los siguientes son los valores de los campos.

```
orderDate      
=========
2012-12-14T00:00:00.000Z  
2013-12-29T00:00:00.000Z
2012-11-15T00:00:00.000Z
```

Para estos valores de campo, se devuelven los siguientes valores.

```
2012-12-01T00:00:00.000Z
2013-12-01T00:00:00.000Z
2012-11-01T00:00:00.000Z
```

# Funciones de agregación
<a name="calculated-field-aggregations"></a>

Las funciones de agregación solo están disponibles durante el análisis y la visualización. Cada una de estas funciones devuelve los valores agrupados por la dimensión o dimensiones elegidas. Para cada agregación, también existe una agregación condicional. Realizan el mismo tipo de agregación, en función de una condición.

Cuando una fórmula de campo calculado contiene una agregación, esta será una agregación personalizada. Para garantizar que tus datos se muestren con precisión, Amazon Quick aplica las siguientes reglas:
+ Las agregaciones personalizadas no pueden contener funciones de agregación anidadas. Por ejemplo, esta fórmula no funciona: `sum(avg(x)/avg(y))`. Sin embargo, sí se pueden anidar funciones que no sean de agregación dentro o fuera de funciones de agregación. Por ejemplo, `ceil(avg(x))` funcionará, y también `avg(ceil(x))`.
+ Las agregaciones personalizadas no pueden contener campos de agregación y no agregación (en ninguna combinación). Por ejemplo, esta fórmula no funciona: `Sum(sales)+quantity`.
+ Los grupos de filtros no pueden contener campos de agregación y no agregación.
+ Las agregaciones personalizadas no se pueden convertir en una dimensión. Tampoco se pueden incluir en el cuadro de campo como una dimensión.
+ En una tabla dinámica, las agregaciones personalizadas no se pueden añadir a los cálculos de la tabla.
+ Los gráficos de dispersión con agregaciones personalizadas necesitan al menos una dimensión en la sección **Grupo/color** de los cuadros de campo.

Para obtener más información sobre las funciones y los operadores compatibles, consulte la [referencia de operadores y funciones de campo calculadas para Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/calculated-field-reference.html). 

Entre las funciones agregadas para los campos calculados de Quick se incluyen las siguientes.

**Topics**
+ [avg](avg-function.md)
+ [avgIf](avgIf-function.md)
+ [count](count-function.md)
+ [countIf](countIf-function.md)
+ [distinct\$1count](distinct_count-function.md)
+ [distinct\$1countIf](distinct_countIf-function.md)
+ [max](max-function.md)
+ [maxIf](maxIf-function.md)
+ [median](median-function.md)
+ [medianIf](medianIf-function.md)
+ [min](min-function.md)
+ [minIf](minIf-function.md)
+ [percentile](percentile-function.md)
+ [percentileCont](percentileCont-function.md)
+ [percentileDisc (percentil)](percentileDisc-function.md)
+ [periodToDateAvg](periodToDateAvg-function.md)
+ [periodToDateCount](periodToDateCount-function.md)
+ [periodToDateMax](periodToDateMax-function.md)
+ [periodToDateMedian](periodToDateMedian-function.md)
+ [periodToDateMin](periodToDateMin-function.md)
+ [periodToDatePercentile](periodToDatePercentile-function.md)
+ [periodToDatePercentileCont](periodToDatePercentileCont-function.md)
+ [periodToDateStDev](periodToDateStDev-function.md)
+ [periodToDateStDevP](periodToDateStDevP-function.md)
+ [periodToDateSum](periodToDateSum-function.md)
+ [periodToDateVar](periodToDateVar-function.md)
+ [periodToDateVarP](periodToDateVarP-function.md)
+ [stdev](stdev-function.md)
+ [stdevp](stdevp-function.md)
+ [stdevIf](stdevIf-function.md)
+ [stdevpIf](stdevpIf-function.md)
+ [sum](sum-function.md)
+ [sumIf](sumIf-function.md)
+ [var](var-function.md)
+ [varIf](varIf-function.md)
+ [varp](varp-function.md)
+ [varpIf](varpIf-function.md)

# avg
<a name="avg-function"></a>

La función `avg` calcula la media del conjunto de números en la medida especificada, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `avg(salesAmount)` devuelve la media de dicha medida agrupada por la dimensión seleccionada (opcional).

## Sintaxis
<a name="avg-function-syntax"></a>

```
avg(decimal, [group-by level])
```

## Argumentos
<a name="avg-function-arguments"></a>

 *decimal*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="avg-function-example"></a>

En el siguiente ejemplo, se calcula el promedio de ventas.

```
avg({Sales})
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula el promedio de ventas a nivel de país, pero no en otras dimensiones (región o producto) del elemento visual.

```
avg({Sales}, [{Country}])
```

![\[Las cifras de ventas promedio se agregan solo a nivel de país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/avg-function-example.png)


# avgIf
<a name="avgIf-function"></a>

En función de una instrucción condicional, la función `avgIf` calcula la media del conjunto de números en la medida especificada, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `avgIf(ProdRev,CalendarDay >= ${BasePeriodStartDate} AND CalendarDay <= ${BasePeriodEndDate} AND SourcingType <> 'Indirect')` devuelve el promedio de dicha medida agrupada por la dimensión seleccionada (opcional), si la condición se evalúa como verdadera.

## Sintaxis
<a name="avgIf-function-syntax"></a>

```
avgIf(dimension or measure, condition) 
```

## Argumentos
<a name="avgIf-function-arguments"></a>

 *decimal*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# count
<a name="count-function"></a>

La función `count` calcula el número de valores en una dimensión o medida, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `count(product type)` devuelve el número total de tipos de productos agrupados por la dimensión seleccionada (opcional), incluidos los duplicados. La función `count(sales)` devuelve el número total de ventas realizadas, agrupadas por la dimensión seleccionada (opcional), por ejemplo, un vendedor.

## Sintaxis
<a name="count-function-syntax"></a>

```
count(dimension or measure, [group-by level])
```

## Argumentos
<a name="count-function-arguments"></a>

 *dimensión o medida*   
El argumento debe ser una medida o una dimensión. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="count-function-example"></a>

En el siguiente ejemplo, se calcula el recuento de ventas según una dimensión específica del elemento visual. En este ejemplo, se muestra el recuento de ventas por mes.

```
count({Sales})
```

![\[El recuento de ventas por mes.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/count-function-example.png)


También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula el recuento de ventas a nivel de país, pero no en otras dimensiones (región o producto) del elemento visual.

```
count({Sales}, [{Country}])
```

![\[El recuento de ventas se agrega solo a nivel de país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/count-function-example2.png)


# countIf
<a name="countIf-function"></a>

En función de una instrucción condicional, `countIf` calcula el número de valores distintos en una dimensión o medida, y los agrupa según la dimensión o las dimensiones seleccionadas.

## Sintaxis
<a name="countIf-function-syntax"></a>

```
countIf(dimension or measure, condition)
```

## Argumentos
<a name="countIf-function-arguments"></a>

 *dimensión o medida*   
El argumento debe ser una medida o una dimensión. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

## Tipo de devolución
<a name="countIf-function-return-type"></a>

Entero

## Ejemplo
<a name="countIf-function-example"></a>

La siguiente función devuelve un recuento de las transacciones de venta (`Revenue`) que cumplen las condiciones, incluidos los duplicados. 

```
countIf (
    Revenue,
    # Conditions
        CalendarDay >= ${BasePeriodStartDate} AND 
        CalendarDay <= ${BasePeriodEndDate} AND 
        SourcingType <> 'Indirect'
)
```

# distinct\$1count
<a name="distinct_count-function"></a>

La función `distinct_count` calcula el número de valores distintos en una dimensión o medida, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `distinct_count(product type)` devuelve el número total de tipos de productos únicos agrupados por la dimensión seleccionada (opcional), sin duplicados. La función `distinct_count(ship date)` devuelve el número total de fechas en que se enviaron los productos, agrupadas por la dimensión seleccionada (opcional), por ejemplo, una región.

## Sintaxis
<a name="distinct_count-function-syntax"></a>

```
distinct_count(dimension or measure, [group-by level])
```

## Argumentos
<a name="distinct_count-function-arguments"></a>

 *dimensión o medida*   
El argumento debe ser una medida o una dimensión. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplo
<a name="distinct_count-function-examples"></a>

En el siguiente ejemplo, se calcula el número total de fechas en las que se pidieron los productos agrupados por la dimensión (opcional) elegida en el elemento visual (por ejemplo, la región).

```
distinct_count({Order Date})
```

![\[El número total de fechas en las que se pidieron los productos en cada región.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/distinct_count-function-example.png)


También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula el promedio de ventas a nivel de país, pero no en otras dimensiones (región) del elemento visual.

```
distinct_count({Order Date}, [Country])
```

![\[El número total de fechas en las que se pidieron los productos en cada país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/distinct_count-function-example2.png)


# distinct\$1countIf
<a name="distinct_countIf-function"></a>

En función de una instrucción condicional, `distinct_countIf` calcula el número de valores distintos en una dimensión o medida, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `distinct_countIf(product type)` devuelve el número total de tipos de productos únicos agrupados por la dimensión seleccionada (opcional), sin duplicados. La función `distinct_countIf(ProdRev,CalendarDay >= ${BasePeriodStartDate} AND CalendarDay <= ${BasePeriodEndDate} AND SourcingType <> 'Indirect')` devuelve el número total de fechas cuando los productos se enviaron agrupadas por la dimensión seleccionada (opcional), por ejemplo, la región, si la condición se evalúa como verdadera.

## Sintaxis
<a name="distinct_countIf-function-syntax"></a>

```
distinct_countIf(dimension or measure, condition)
```

## Argumentos
<a name="distinct_countIf-function-arguments"></a>

 *dimensión o medida*   
El argumento debe ser una medida o una dimensión. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# max
<a name="max-function"></a>

La función `max` devuelve el valor máximo de la medida o fecha especificada, agrupado según la dimensión o las dimensiones seleccionadas. Por ejemplo, `max(sales goal)` devuelve los objetivos de ventas máximas, agrupados por la dimensión seleccionada (opcional).

## Sintaxis
<a name="max-function-syntax"></a>

```
max(measure, [group-by level])
```

## Argumentos
<a name="max-function-arguments"></a>

 *measure*   
El argumento debe ser una medida o una fecha. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.  
Las fechas máximas solo funcionan en el cuadro de campo **Valor** de las tablas y las tablas dinámicas. 

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="max-function-example"></a>

En el siguiente ejemplo, se devuelve el valor máximo de ventas por región. Se compara con los valores de venta total, mínimo y medio.

```
max({Sales})
```

![\[El valor máximo de venta de cada región.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/min-max-median-function-example.png)


También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calculan las ventas máximas a nivel de país, pero no en otras dimensiones (región) del elemento visual.

```
max({Sales}, [Country])
```

![\[El valor máximo de venta en cada país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/max-function-example2.png)


# maxIf
<a name="maxIf-function"></a>

En función de una instrucción condicional, la función `maxIf` devuelve el valor máximo de la medida especificada, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `maxIf(ProdRev,CalendarDay >= ${BasePeriodStartDate} AND CalendarDay <= ${BasePeriodEndDate} AND SourcingType <> 'Indirect')` devuelve los objetivos de ventas máximos agrupados por la dimensión seleccionada (opcional), si la condición se evalúa como verdadera.

## Sintaxis
<a name="maxIf-function-syntax"></a>

```
maxIf(measure, condition)
```

## Argumentos
<a name="maxIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# median
<a name="median-function"></a>

La agregación `median` devuelve el valor de la mediana de la medida especificada y lo agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `median(revenue)` devuelve la mediana de los ingresos agrupados por la dimensión seleccionada (opcional). 

## Sintaxis
<a name="median-function-syntax"></a>

```
median(measure, [group-by level])
```

## Argumentos
<a name="median-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregación (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="median-function-example"></a>

En el siguiente ejemplo, se devuelve el valor medio de ventas de cada región. Se compara con los valores de venta total, máximo y mínimo.

```
median({Sales})
```

![\[El valor medio de venta de cada región.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/min-max-median-function-example.png)


También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calculan las ventas medias a nivel de país, pero no en otras dimensiones (región) del elemento visual.

```
median({Sales}, [Country])
```

![\[El valor medio de venta en cada país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/median-function-example2.png)


# medianIf
<a name="medianIf-function"></a>

En función de una instrucción condicional, la agregación `medianIf` devuelve el valor de la mediana de la medida especificada y lo agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `medianIf(Revenue,SaleDate >= ${BasePeriodStartDate} AND SaleDate <= ${BasePeriodEndDate})` devuelve los ingresos medianos agrupados por la dimensión seleccionada (opcional), si la condición se evalúa como verdadera. 

## Sintaxis
<a name="medianIf-function-syntax"></a>

```
medianIf(measure, condition)
```

## Argumentos
<a name="medianIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# min
<a name="min-function"></a>

La función `min` devuelve el valor mínimo de la medida o fecha especificada, agrupado según la dimensión o las dimensiones seleccionadas. Por ejemplo, `min(return rate)` devuelve el tipo de rendimiento mínimo, agrupado por la dimensión seleccionada (opcional).

## Sintaxis
<a name="min-function-syntax"></a>

```
min(measure, [group-by level])
```

## Argumentos
<a name="min-function-arguments"></a>

 *measure*   
El argumento debe ser una medida o una fecha. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.  
Las fechas mínimas solo funcionan en el cuadro de campo **Valor** de las tablas y las tablas dinámicas. 

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="min-function-example"></a>

En el siguiente ejemplo, se devuelve el valor máximo de ventas por región. Se compara con los valores de venta total, máximo y medio.

```
min({Sales})
```

![\[El valor mínimo de venta de cada región.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/min-max-median-function-example.png)


También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calculan las ventas mínimas a nivel de país, pero no en otras dimensiones (región) del elemento visual.

```
min({Sales}, [Country])
```

![\[El valor mínimo de venta en cada país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/min-function-example2.png)


# minIf
<a name="minIf-function"></a>

En función de una instrucción condicional, la función `minIf` devuelve el valor mínimo de la medida especificada, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `minIf(ProdRev,CalendarDay >= ${BasePeriodStartDate} AND CalendarDay <= ${BasePeriodEndDate} AND SourcingType <> 'Indirect')` devuelve la tasa mínima de devoluciones agrupada por la dimensión seleccionada (opcional), si la condición se evalúa como verdadera.

## Sintaxis
<a name="minIf-function-syntax"></a>

```
minIf(measure, condition)
```

## Argumentos
<a name="minIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# percentile
<a name="percentile-function"></a>

La función `percentile` calcula el percentil de los valores de la medida, agrupados por la dimensión que se encuentra en el cuadro de campo. Hay dos tipos de cálculo de percentiles disponibles en Quick:
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileCont-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileCont-function.html) utiliza la interpolación lineal para determinar el resultado.
+ [percentileDisc(percentil)](https://docs.aws.amazon.com/quicksight/latest/user/percentileDisc-function.html) utiliza valores reales para determinar el resultado. 

La función `percentile` es un alias de `percentileDisc`.

# percentileCont
<a name="percentileCont-function"></a>

La función `percentileCont` calcula el percentil en función de una distribución continua de los números de la medida. Utiliza la agrupación y la ordenación que se aplican en los cuadros de campo. Responde a preguntas como: ¿Qué valores son representativos de este percentil? Para devolver un valor de percentil exacto que podría no estar presente en su conjunto de datos, utilice `percentileCont`. Para devolver el valor de percentil más cercano esté presente en su conjunto de datos, utilice `percentileDisc` en su lugar.

## Sintaxis
<a name="percentileCont-function-syntax"></a>

```
percentileCont(expression, percentile, [group-by level])
```

## Argumentos
<a name="percentileCont-function-arguments"></a>

 *measure*   
Especifica un valor numérico que se utilizará para calcular el percentil. El argumento debe ser una medida o una métrica. Los valores nulos se ignoran en el cálculo. 

 *percentil*   
El valor del percentil puede ser cualquier constante numérica del 0 al 100. Un valor de percentil de 50 calcula el valor mediano de la medida. 

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Devuelve
<a name="percentileCont-function-return-type"></a>

El resultado de la función es un número. 

## Notas de uso
<a name="percentileCont-usage-notes"></a>

La función `percentileCont` calcula un resultado en función de una distribución continua de los valores de una medida especificada. El resultado se calcula mediante una interpolación lineal entre los valores después de ordenarlos en función de los ajustes del elemento visual. Es diferente de `percentileDisc`, que simplemente devuelve un valor del conjunto de valores que se agregan. El resultado de `percentileCont` puede o no existir en los valores de la medida especificada.

## Ejemplos de percentileCont
<a name="percentileCont-examples"></a>

Los siguientes ejemplos ayudan a explicar cómo funciona percentileCont.

**Example Comparación de la mediana, `percentileCont` y `percentileDisc`**  
En el siguiente ejemplo, se muestra la mediana de una dimensión (categoría) mediante las funciones `median`, `percentileCont` y `percentileDisc`. La mediana es lo mismo que el valor percentileCont. `percentileCont` interpola un valor, que puede estar o no en el conjunto de datos. Sin embargo, dado que `percentileDisc` siempre muestra un valor que existe en el conjunto de datos, es posible que los dos resultados no coincidan. La última columna de este ejemplo muestra la diferencia entre los dos valores. El código de cada campo calculado es el siguiente:  
+ `50%Cont = percentileCont( example , 50 )`
+ `median = median( example )`
+ `50%Disc = percentileDisc( example , 50 )`
+ `Cont-Disc = percentileCont( example , 50 ) − percentileDisc( example , 50 )`
+ `example = left( category, 1 )` (Para simplificar el ejemplo, utilizamos esta expresión para acortar los nombres de las categorías hasta la primera letra).

```
  example     median       50%Cont      50%Disc      Cont-Disc
 -------- ----------- ------------ -------------- ------------ 
 A          22.48          22.48          22.24          0.24
 B          20.96          20.96          20.95          0.01
 C          24.92          24.92          24.92          0
 D          24.935         24.935         24.92          0.015
 E          14.48          14.48          13.99          0.49
```

**Example El 100 es el valor de percentil máximo**  
En el siguiente ejemplo, se muestra un conjunto de valores de `percentileCont` para el campo `example`. Los campos calculados `n%Cont` se definen como `percentileCont( {example} ,n)`. Los valores interpolados de cada columna representan los números que se incluyen en ese bucket de percentiles. En algunos casos, los valores de datos reales coinciden con los valores interpolados. Por ejemplo, la columna `100%Cont` muestra el mismo valor para todas las filas porque 6783,02 es el número más alto.  

```
 example      50%Cont     75%Cont      99%Cont    100%Cont  
 --------- ----------- ----------- ------------ ----------- 

 A             20.97       84.307      699.99      6783.02  
 B             20.99       88.84       880.98      6783.02  
 C             20.99       90.48       842.925     6783.02  
 D             21.38       85.99       808.49      6783.02
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula el percentil 30 según una distribución continua de los números a nivel de país, pero no en otras dimensiones (región) del elemento visual.

```
percentileCont({Sales}, 30, [Country])
```

![\[El percentil de ventas en cada país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentileCont-function-example-lac.png)


# percentileDisc (percentil)
<a name="percentileDisc-function"></a>

La función `percentileDisc` calcula el percentil en función de los números reales de `measure`. Utiliza la agrupación y la ordenación que se aplican en los cuadros de campo. La función `percentile` es un alias de `percentileDisc`.

Utilice esta función para responder a la siguiente pregunta: ¿Qué puntos de datos reales están presentes en este percentil? Para devolver el valor del percentil más cercano que esté presente en su conjunto de datos, utilice `percentileDisc`. Para devolver un valor de percentil exacto que podría no estar presente en su conjunto de datos, utilice `percentileCont` en su lugar. 

## Sintaxis
<a name="percentileDisc-function-syntax"></a>

```
percentileDisc(expression, percentile, [group-by level])
```

## Argumentos
<a name="percentileDisc-function-arguments"></a>

 *measure*   
Especifica un valor numérico que se utilizará para calcular el percentil. El argumento debe ser una medida o una métrica. Los valores nulos se ignoran en el cálculo. 

 *percentil*   
El valor del percentil puede ser cualquier constante numérica del 0 al 100. Un valor de percentil de 50 calcula el valor mediano de la medida. 

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Devuelve
<a name="percentileDisc-function-return-type"></a>

El resultado de la función es un número. 

## Notas de uso
<a name="percentileDisc-usage-notes"></a>

`percentileDisc` es una función de distribución inversa que asume un modelo de distribución discreta. Toma un valor percentil y una especificación de ordenación, y devuelve un elemento del conjunto dado. 

Para un valor de percentil determinado `P`, `percentileDisc` utiliza los valores ordenados del elemento visual y devuelve el valor con el valor de distribución acumulado más pequeño que sea mayor o igual a `P`. 

## Ejemplos de percentileDisc
<a name="percentileDisc-examples"></a>

Los siguientes ejemplos ayudan a explicar cómo funciona percentileDisc.

**Example Comparación de la mediana, `percentileDisc` y `percentileCont`**  
En el siguiente ejemplo, se muestra la mediana de una dimensión (categoría) mediante las funciones `percentileCont`, `percentileDisc` y `median`. La mediana es lo mismo que el valor percentileCont. `percentileCont` interpola un valor, que puede estar o no en el conjunto de datos. Sin embargo, dado que `percentileDisc` siempre muestra el valor más cercano que existe en el conjunto de datos, es posible que los dos resultados no coincidan. La última columna de este ejemplo muestra la diferencia entre los dos valores. El código de cada campo calculado es el siguiente:  
+ `50%Cont = percentileCont( example , 50 )`
+ `median = median( example )`
+ `50%Disc = percentileDisc( example , 50 )`
+ `Cont-Disc = percentileCont( example , 50 ) − percentileDisc( example , 50 )`
+ `example = left( category, 1 )` (Para simplificar el ejemplo, utilizamos esta expresión para acortar los nombres de las categorías hasta la primera letra).

```
 example     median       50%Cont      50%Disc      Cont-Disc
 -------- ----------- ------------ -------------- ------------ 
 A          22.48          22.48          22.24          0.24
 B          20.96          20.96          20.95          0.01
 C          24.92          24.92          24.92          0
 D          24.935         24.935         24.92          0.015
 E          14.48          14.48          13.99          0.49
```

**Example El 100 es el valor de percentil máximo**  
En el siguiente ejemplo, se muestra un conjunto de valores de `percentileDisc` para el campo `example`. Los campos calculados `n%Disc` se definen como `percentileDisc( {example} ,n)`. Los valores de cada columna son números reales que provienen del conjunto de datos.   

```
 example     50%Disc      75%Disc        99%Disc      100%Disc
 -------- ----------- ------------ -------------- ------------ 
 A            20.97        73.98         699.99       6783.02
 B            42.19        88.84         820.08       6783.02
 C            30.52        90.48         733.44       6783.02
 D            41.38        85.99         901.29       6783.0
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula el percentil 30 según una distribución continua de los números a nivel de país, pero no en otras dimensiones (región) del elemento visual.

```
percentile({Sales}, 30, [Country])
```

![\[El percentil de ventas en cada país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentile-function-example-lac.png)


# periodToDateAvg
<a name="periodToDateAvg-function"></a>

La función `periodToDateAvg` calcula el promedio del conjunto de números de la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo.

## Sintaxis
<a name="periodToDateAvg-function-syntax"></a>

```
periodToDateAvg(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateAvg-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateAvg-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateAvg(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDAvgResults.png)


# periodToDateCount
<a name="periodToDateCount-function"></a>

La función `periodToDateCount` calcula el número de valores de una dimensión o medida, incluidos los duplicados, para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo.

## Sintaxis
<a name="periodToDateCount-function-syntax"></a>

```
periodToDateCount(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateCount-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateCount-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateCount(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDCountResults.png)


# periodToDateMax
<a name="periodToDateMax-function"></a>

La función `periodToDateMax` devuelve el valor máximo de la medida especificada para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese momento.

## Sintaxis
<a name="periodToDateMax-function-syntax"></a>

```
periodToDateMax(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateMax-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateMax-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateMax(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDMaxResults.png)


# periodToDateMedian
<a name="periodToDateMedian-function"></a>

La función `periodToDateMedian` devuelve el valor medio de la medida especificada para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo.

## Sintaxis
<a name="periodToDateMedian-function-syntax"></a>

```
periodToDateMedian(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateMedian-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateMedian-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateMedian(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDMedianResults.png)


# periodToDateMin
<a name="periodToDateMin-function"></a>

La función `periodToDateMin` devuelve el valor mínimo de la medida o fecha especificada para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo.

## Sintaxis
<a name="periodToDateMin-function-syntax"></a>

```
periodToDateMin(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateMin-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateMin-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateMin(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDMinResults.png)


# periodToDatePercentile
<a name="periodToDatePercentile-function"></a>

La función `periodToDatePercentile` calcula el percentil según los números reales de una medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo. Utiliza la agrupación y la ordenación que se aplican en los cuadros de campo.

Para devolver el valor del percentil más cercano que esté presente en su conjunto de datos, utilice `periodToDatePercentile`. Para devolver un valor de percentil exacto que podría no estar presente en su conjunto de datos, utilice `periodToDatePercentileCont` en su lugar.

## Sintaxis
<a name="periodToDatePercentile-function-syntax"></a>

```
periodToDatePercentile(
	measure, 
	percentile, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDatePercentile-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *percentil*   
El valor del percentil puede ser cualquier constante numérica del 0 al 100. Un percentil de 50 calcula el valor mediano de la medida.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDatePercentile-function-example"></a>

En el siguiente ejemplo week-to-date, se calcula el percentil 90 del importe de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDatePercentile(fare_amount, 90, pickupDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen del resultado del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDPercentileResults.png)


# periodToDatePercentileCont
<a name="periodToDatePercentileCont-function"></a>

La función `periodToDatePercentileCont` calcula el percentil según la distribución continua de los números de la medida para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo. Utiliza la agrupación y la ordenación que se aplican en los cuadros de campo.

Para devolver un valor de percentil exacto que podría no estar presente en su conjunto de datos, utilice `periodToDatePercentileCont`. Para devolver el valor de percentil más cercano esté presente en su conjunto de datos, utilice `periodToDatePercentile` en su lugar.

## Sintaxis
<a name="periodToDatePercentileCont-function-syntax"></a>

```
periodToDatePercentileCont(
	measure, 
	percentile, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDatePercentileCont-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *percentil*   
El valor del percentil puede ser cualquier constante numérica del 0 al 100. Un percentil de 50 calcula el valor mediano de la medida.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDatePercentileCont-function-example"></a>

En el siguiente ejemplo week-to-date, se calcula el percentil 90 del importe de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDatePercentileCont(fare_amount, 90, pickupDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen del resultado del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDContPercentileResults.png)


# periodToDateStDev
<a name="periodToDateStDev-function"></a>

La función `periodToDateStDev` calcula la desviación estándar del conjunto de números de la medida especificada para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta una muestra y ese periodo.

## Sintaxis
<a name="periodToDateStDev-function-syntax"></a>

```
periodToDateStDev(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateStDev-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateStDev-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateStDev(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDStDevResults.png)


# periodToDateStDevP
<a name="periodToDateStDevP-function"></a>

La función `periodToDateStDevP` calcula la desviación estándar poblacional del conjunto de números de la medida especificada, para un grado de detalle temporal determinada (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta una muestra en ese periodo.

## Sintaxis
<a name="periodToDateStDevP-function-syntax"></a>

```
periodToDateStDevP(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateStDevP-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateStDevP-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateStDevP(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDStDevPResults.png)


# periodToDateSum
<a name="periodToDateSum-function"></a>

La función `periodToDateSum` agrega la medida especificada para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo.

## Sintaxis
<a name="periodToDateSum-function-syntax"></a>

```
periodToDateSum(
	measure, 
	dateTime, 
	period, 
	endDate)
```

## Argumentos
<a name="periodToDateSum-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateSum-function-example"></a>

En la siguiente función, se calcula la suma semanal del importe de la tarifa por pago para la semana del 30 de junio de 2021. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateSum(fare_amount, pickUpDateTime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del ejemplo con ilustraciones.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDSumResults.png)


# periodToDateVar
<a name="periodToDateVar-function"></a>

La función `periodToDateVar` calcula la varianza de muestras del conjunto de números de la medida especificada, para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo de ese periodo.

## Sintaxis
<a name="periodToDateVar-function-syntax"></a>

```
periodToDateVar(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateVar-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateVar-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateVar(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDVarResults.png)


# periodToDateVarP
<a name="periodToDateVarP-function"></a>

La función `periodToDateVarP` calcula la varianza de población del conjunto de números de la medida especificada, para un grado de detalle temporal determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo, teniendo en cuenta ese periodo.

## Sintaxis
<a name="periodToDateVarP-function-syntax"></a>

```
periodToDateVarP(
	measure, 
	dateTime, 
	period, 
	endDate (optional))
```

## Argumentos
<a name="periodToDateVarP-function-arguments"></a>

 *measure*   
El argumento debe ser un campo. Los valores nulos se omiten en los resultados. Los valores literales no funcionan.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodToDate las agregaciones.

 *periodo*   
El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.

 *endDate*   
(Opcional) La dimensión de fecha en la que va a finalizar el cálculo de las periodToDate agregaciones. El valor predeterminado es `now()` si se omite.

## Ejemplo
<a name="periodToDateVarP-function-example"></a>

En el siguiente ejemplo, se calcula el importe week-to-date mínimo de la tarifa por tipo de pago para la semana del 30 de junio al 21 de junio. Para simplificar el ejemplo, filtramos solo un pago. El 30 de junio de 2021 es miércoles. Quick comienza la semana los domingos. En nuestro ejemplo, es el 27 de junio de 2021.

```
periodToDateVarP(fare_amount, pickUpDatetime, WEEK, parseDate("06-30-2021", "MM-dd-yyyy"))
```

![\[Esta es una imagen de los resultados del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDVarPResults.png)


# stdev
<a name="stdev-function"></a>

La función `stdev` calcula la desviación estándar del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una muestra.

## Sintaxis
<a name="stdev-function-syntax"></a>

```
stdev(measure, [group-by level])
```

## Argumentos
<a name="stdev-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="stdev-function-example"></a>

En el siguiente ejemplo, se devuelve la desviación estándar de las puntuaciones de las pruebas de una clase. Para hacerlo, se usa una muestra de las puntuaciones de las pruebas registradas.

```
stdev({Score})
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula la desviación estándar de las puntuaciones de las pruebas a nivel de asunto, pero no en otras dimensiones (clase) del elemento visual.

```
stdev({Score}, [Subject])
```

# stdevp
<a name="stdevp-function"></a>

La función `stdevp` calcula la desviación estándar de población del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas.

## Sintaxis
<a name="stdevp-function-syntax"></a>

```
stdevp(measure, [group-by level])
```

## Argumentos
<a name="stdevp-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="stdev-function-example"></a>

En el siguiente ejemplo, se devuelve la desviación estándar de las puntuaciones de las pruebas de una clase. Para hacerlo, se usan todas las puntuaciones registradas.

```
stdevp({Score})
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula la desviación estándar de las puntuaciones de las pruebas a nivel de asunto, pero no en otras dimensiones (clase) del elemento visual, utilizando todas las puntuaciones registradas.

```
stdevp({Score}, [Subject])
```

# stdevIf
<a name="stdevIf-function"></a>

En función de una instrucción condicional, la `stdevIf` función calcula la desviación estándar del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una muestra. 

## Sintaxis
<a name="stdevIf-function-syntax"></a>

```
stdevIf(measure, conditions)
```

## Argumentos
<a name="stdevIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# stdevpIf
<a name="stdevpIf-function"></a>

En función de una instrucción condicional, la función `stdevpIf` calcula la desviación estándar del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una población sesgada.

## Sintaxis
<a name="stdevpIf-function-syntax"></a>

```
stdevpIf(measure, conditions)
```

## Argumentos
<a name="stdevpIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# sum
<a name="sum-function"></a>

La función `sum` añade el conjunto de números en la medida especificada, y lo agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `sum(profit amount)` devuelve el importe total de beneficios, agrupados por la dimensión seleccionada (opcional).

## Sintaxis
<a name="sum-function-syntax"></a>

```
sum(measure, [group-by level])
```

## Argumentos
<a name="sum-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="sum-function-example"></a>

En el siguiente ejemplo, se devuelve la suma de las ventas.

```
sum({Sales})
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se calcula la suma de las ventas a nivel de país, pero no en otras dimensiones (región y producto) del elemento visual.

```
sum(Sales, [Country])
```

![\[La suma de las ventas por país.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sum-function-example.png)


# sumIf
<a name="sumIf-function"></a>

En función de una instrucción condicional, la función `sumIf` añade el conjunto de números en la medida especificada, y los agrupa según la dimensión o las dimensiones seleccionadas. Por ejemplo, `sumIf(ProdRev,CalendarDay >= ${BasePeriodStartDate} AND CalendarDay <= ${BasePeriodEndDate} AND SourcingType <> 'Indirect')` devuelve el importe total de beneficios agrupado por la dimensión seleccionada (opcional), si la condición se evalúa como verdadera.

## Sintaxis
<a name="sumIf-function-syntax"></a>

```
sumIf(measure, conditions)
```

## Argumentos
<a name="sumIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

## Ejemplos
<a name="sumIf-function-example"></a>

En el siguiente ejemplo, se utiliza un campo calculado con `sumIf` para mostrar el importe de las ventas si `Segment` es igual a `SMB`.

```
sumIf(Sales, Segment=’SMB’)
```

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sumIfCalc.png)


En el siguiente ejemplo, se utiliza un campo calculado con `sumIf` para mostrar el importe de las ventas si `Segment` es igual a `SMB` y `Order Date` es más tarde que el año 2022.

```
sumIf(Sales, Segment=’SMB’ AND {Order Date} >=’2022-01-01’)
```

# var
<a name="var-function"></a>

La función `var` calcula la varianza de muestra del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas.

## Sintaxis
<a name="var-function-syntax"></a>

```
var(measure, [group-by level])
```

## Argumentos
<a name="var-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="var-function-example"></a>

En el siguiente ejemplo, se devuelve la varianza de una muestra en las puntuaciones de pruebas.

```
var({Scores})
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se devuelve la varianza de una muestra de las puntuaciones de las pruebas a nivel de asunto, pero no en otras dimensiones (clase) del elemento visual.

```
var({Scores}, [Subject]
```

# varIf
<a name="varIf-function"></a>

En función de una instrucción condicional, la `varIf` función calcula la varianza del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una muestra.

## Sintaxis
<a name="varIf-function-syntax"></a>

```
varIf(measure, conditions)
```

## Argumentos
<a name="varIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# varp
<a name="varp-function"></a>

La función `varp` calcula la varianza de población del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas.

## Sintaxis
<a name="varp-function-syntax"></a>

```
varp(measure, [group-by level])
```

## Argumentos
<a name="varp-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *Nivel de agrupación*   
(Opcional) Especifica el nivel por el que se va a agrupar la agregación. El nivel agregado puede ser cualquier dimensión o dimensiones independientes de las dimensiones agregadas al elemento visual.  
El argumento debe ser un campo de dimensión. El grupo por nivel se debe escribir entre corchetes: `[ ]`. Para obtener más información, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)).

## Ejemplos
<a name="varp-function-example"></a>

En el siguiente ejemplo, se devuelve la varianza de una población en los resultados de pruebas.

```
varp({Scores})
```

También puede especificar en qué nivel agrupar el cálculo mediante una o más dimensiones de la vista o del conjunto de datos. Esto se denomina función LAC-A. Para obtener más información sobre las funciones LAC-A, consulte Funciones de [cálculo con reconocimiento de niveles: agregadas (LAC-A](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations-aggregate.html)). En el siguiente ejemplo, se devuelve la varianza de población de las puntuaciones de las pruebas a nivel de asunto, pero no en otras dimensiones (clase) del elemento visual.

```
varp({Scores}, [Subject]
```

# varpIf
<a name="varpIf-function"></a>

En función de una instrucción condicional, la `varpIf` función calcula la varianza del conjunto de números en la medida especificada y la agrupa según la dimensión o las dimensiones seleccionadas, en función de una población sesgada.

## Sintaxis
<a name="varpIf-function-syntax"></a>

```
varpIf(measure, conditions)
```

## Argumentos
<a name="varpIf-function-arguments"></a>

 *measure*   
El argumento debe ser una medida. Los valores nulos se omiten en los resultados. Los valores literales no funcionan. El argumento debe ser un campo.

 *condition*   
Una o varias condiciones en una única instrucción.

# Funciones de los cálculos de tabla
<a name="table-calculation-functions"></a>

Cuando analiza datos en un elemento visual específico, puede aplicar los cálculos de tabla al conjunto actual de datos para descubrir cómo las dimensiones influyen en las medidas o cómo se influyen entre sí. Los *datos visualizados* son su conjunto de resultados basado en su conjunto de datos actual, con todos los filtros, selecciones de campos y personalizaciones aplicados. Para ver exactamente qué es este conjunto de resultados, puede exportar su elemento visual a un archivo. Una *función de cálculo de tabla* realiza operaciones en los datos para revelar las relaciones entre los campos. 

En esta sección, encontrará una lista de las funciones disponibles en los cálculos de tablas que puede realizar con los datos visualizados en Amazon Quick. 

Para ver una lista de funciones ordenadas por categoría, con breves definiciones, consulte [Funciones por categoría](https://docs.aws.amazon.com/quicksight/latest/user/functions-by-category.html). 

**Topics**
+ [difference](difference-function.md)
+ [distinctCountOver](distinctCountOver-function.md)
+ [lag](lag-function.md)
+ [lead](lead-function.md)
+ [percentDifference](percentDifference-function.md)
+ [avgOver](avgOver-function.md)
+ [countOver](countOver-function.md)
+ [maxOver](maxOver-function.md)
+ [minOver](minOver-function.md)
+ [percentileOver](percentileOver-function.md)
+ [percentileContOver](percentileContOver-function.md)
+ [percentileDiscOver](percentileDiscOver-function.md)
+ [percentOfTotal](percentOfTotal-function.md)
+ [periodOverPeriodDifference](periodOverPeriodDifference-function.md)
+ [periodOverPeriodLastValue](periodOverPeriodLastValue-function.md)
+ [periodOverPeriodPercentDifference](periodOverPeriodPercentDifference-function.md)
+ [periodToDateAvgOverTime](periodToDateAvgOverTime-function.md)
+ [periodToDateCountOverTime](periodToDateCountOverTime-function.md)
+ [periodToDateMaxOverTime](periodToDateMaxOverTime-function.md)
+ [periodToDateMinOverTime](periodToDateMinOverTime-function.md)
+ [periodToDateSumOverTime](periodToDateSumOverTime-function.md)
+ [stdevOver](stdevOver-function.md)
+ [stdevpOver](stdevpOver-function.md)
+ [varOver](varOver-function.md)
+ [varpOver](varpOver-function.md)
+ [sumOver](sumOver-function.md)
+ [denseRank](denseRank-function.md)
+ [rank](rank-function.md)
+ [percentileRank](percentileRank-function.md)
+ [runningAvg](runningAvg-function.md)
+ [runningCount](runningCount-function.md)
+ [runningMax](runningMax-function.md)
+ [runningMin](runningMin-function.md)
+ [runningSum](runningSum-function.md)
+ [firstValue](firstValue-function.md)
+ [lastValue](lastValue-function.md)
+ [windowAvg](windowAvg-function.md)
+ [windowCount](windowCount-function.md)
+ [windowMax](windowMax-function.md)
+ [windowMin](windowMin-function.md)
+ [windowSum](windowSum-function.md)

# difference
<a name="difference-function"></a>

La función `difference` calcula la diferencia entre una medida basada en un conjunto de particiones y órdenes, y una medida basada en otra. 

La función `difference` puede utilizarse con análisis basados en conjuntos de datos de SPICE y consulta directa.

## Sintaxis
<a name="difference-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
difference
	(
	     measure 
	     ,[ sortorder_field ASC_or_DESC, ... ]
	     ,lookup_index,
	     ,[ partition field, ... ] 
	)
```

## Argumentos
<a name="difference-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver la diferencia. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *lookup index*   
El índice de búsqueda puede ser positivo o negativo, lo que indica una fila siguiente en la ordenación (positiva) o una fila anterior en la ordenación (negativa). El índice de búsqueda puede ser de 1 a 2 147 483 647. Para los motores MySQL, MariaDB y la edición de Aurora con compatibilidad con MySQL, el índice de búsqueda se limita a tan solo 1.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="difference-function-example"></a>

En el siguiente ejemplo, se calcula la diferencia entre `sum({Billed Amount})`, ordenados por `Customer Region` ascendente, en comparación con la siguiente fila y particionado por `Service Line`.

```
difference(
     sum( {Billed Amount} ), 
     [{Customer Region} ASC],
     1,
     [{Service Line}]
)
```

En el siguiente ejemplo, se calcula la diferencia entre `Billed Amount`, en comparación con la siguiente línea y particionado por (`[{Customer Region}]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
difference(
     sum( {Billed Amount} ), 
     [{Customer Region} ASC],
     1
)
```

Los resaltos en rojo muestran cómo cada cantidad se suma (a\$1b = c) para mostrar la diferencia entre las cantidades a y c. 

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/differenceCalc.png)


# distinctCountOver
<a name="distinctCountOver-function"></a>

La función `distinctCountOver` calcula el recuento distinto del operando particionado por los atributos especificados en un nivel específico. Los niveles admitidos son `PRE_FILTER` y `PRE_AGG`. El operando debe estar desagregado.

## Sintaxis
<a name="distinctCountOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
distinctCountOver
(
  measure or dimension field 
  ,[ partition_field, ... ]  
  ,calculation level 
)
```

## Argumentos
<a name="distinctCountOver-function-arguments"></a>

 *measure or dimension field*   
La medida o dimensión para la que desea realizar el cálculo, por ejemplo, `{Sales Amt}`. Los valores válidos son `PRE_FILTER` y `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. `POST_AGG_FILTER` no es un nivel válido para esta operación y generará un mensaje de error. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="distinctCountOver-function-example"></a>

En el siguiente ejemplo se obtiene el recuento de `Sales` particionado sobre `City` y `State` en el nivel `PRE_AGG`.

```
distinctCountOver
(
  Sales, 
  [City, State], PRE_AGG
)
```

# lag
<a name="lag-function"></a>

La función `lag` calcula el valor de retardo (anterior) para una medida en función de las particiones y ordenaciones especificadas.

`lag` puede utilizarse con análisis basados en conjuntos de datos de SPICE y consulta directa.

## Sintaxis
<a name="lag-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
lag
(
lag
(
 measure
 ,[ sortorder_field ASC_or_DESC, ... ] 
 ,lookup_index
 ,[ partition_field, ... ] 
)] 
)
```

## Argumentos
<a name="lag-function-arguments"></a>

*measure*   
La medida para la que desea obtener el retardo. Esto puede incluir un agregado, por ejemplo, `sum({Sales Amt})`.

*campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*lookup index*   
El índice de búsqueda puede ser positivo o negativo, lo que indica una fila siguiente en la ordenación (positiva) o una fila anterior en la ordenación (negativa). El índice de búsqueda puede ser de 1 a 2 147 483 647. Para los motores MySQL, MariaDB y la edición de Amazon Aurora con compatibilidad con MySQL, el índice de búsqueda se limita a tan solo 1.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="lag-function-example"></a>

En el siguiente ejemplo, se calcula el anterior `sum(sales)`, particionado por el estado de origen, en orden ascendente `cancellation_code`.

```
lag
(
     sum(Sales), 
     [cancellation_code ASC], 
     1, 
     [origin_state_nm]
)
```

En el siguiente ejemplo se usa un campo calculado con `lag` para mostrar la cantidad de ventas para la fila anterior junto a la cantidad de la fila actual, ordenados por `Order Date`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
lag(
     sum({Sales}),
     [{Order Date} ASC],
     1
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/lagCalc.png)


En el siguiente ejemplo se usa un campo calculado con `lag` para mostrar la cantidad de ventas para la fila anterior junto a la cantidad de la fila actual, ordenados por `Order Date` particionado por `Segment`.

```
lag
	(
		sum(Sales),
		[Order Date ASC],
		1, [Segment]
	)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/lagCalc2.png)


# lead
<a name="lead-function"></a>

La función `lead` calcula el valor guía (siguiente) para una medida en función de las particiones y ordenaciones especificadas.

## Sintaxis
<a name="lead-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
lead
(
     measure
     ,[ sortorder_field ASC_or_DESC, ... ]  
     ,lookup_index,
     ,[ partition_field, ... ]
)
```

## Argumentos
<a name="lead-function-arguments"></a>

*measure*   
La medida para la que desea obtener la guía. Esto puede incluir un agregado, por ejemplo, `sum({Sales Amt})`.

*campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*lookup index*   
El índice de búsqueda puede ser positivo o negativo, lo que indica una fila siguiente en la ordenación (positiva) o una fila anterior en la ordenación (negativa). El índice de búsqueda puede ser de 1 a 2 147 483 647. Para los motores MySQL, MariaDB y la edición de Amazon Aurora con compatibilidad con MySQL, el índice de búsqueda se limita a tan solo 1.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="lead-function-example"></a>

En el siguiente ejemplo, se calcula el siguiente `sum(sales)`, particionado por el estado de origen, en orden ascendente `cancellation_code`.

```
lead
(
     sum(sales), 
     [cancellation_code ASC], 
     1, 
     [origin_state_nm]
)
```

En el siguiente ejemplo se usa un campo calculado con lead para mostrar la cantidad para la siguiente fila junto a la cantidad de la fila actual, ordenados por `Customer Segment`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
lead(
     sum({Billed Amount}),
     [{Customer Segment} ASC],
     1
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/leadCalc.png)


# percentDifference
<a name="percentDifference-function"></a>

La función `percentDifference` calcula la diferencia de porcentaje entre el valor actual y un valor de comparación, en función de particiones, ordenaciones e índice de búsqueda. 

## Sintaxis
<a name="percentDifference-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
percentDifference
(
  measure 
  ,[ sortorder_field ASC_or_DESC, ... ]  
  ,lookup index
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="percentDifference-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver la diferencia del porcentaje. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *lookup index*   
El índice de búsqueda puede ser positivo o negativo, lo que indica una fila siguiente en la ordenación (positiva) o una fila anterior en la ordenación (negativa). El índice de búsqueda puede ser de 1 a 2 147 483 647. Para los motores MySQL, MariaDB y la edición de Aurora con compatibilidad con MySQL, el índice de búsqueda se limita a tan solo 1.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="percentDifference-function-example"></a>

En el siguiente ejemplo, se calcula el porcentaje de diferencia entre `sum(Sales)` del `State` actual y el anterior, ordenados por `Sales`.

```
percentDifference
(
  sum(amount), 
  [sum(amount) ASC],
  -1, 
  [State]
)
```

En el siguiente ejemplo, se calcula el porcentaje que un valor de `Billed Amount` representa con respecto a otro valor de `Billed Amount`, ordenados por (`[{Customer Region} ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
percentDifference
(
  sum( {Billed Amount} ), 
  [{Customer Region} ASC],
  1
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Las letras en rojo muestran que el `Billed Amount` total de `Customer Region` **APAC** es el 24 % menos de la cantidad de la región **EMEA**.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentDifference.png)


# avgOver
<a name="avgOver-function"></a>

La función `avgOver` calcula el promedio de una medida particionada por una lista de dimensiones. 

## Sintaxis
<a name="avgOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
avgOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

En el siguiente ejemplo, se muestra el promedio de `Billed Amount` para `Customer Region`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
avgOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Con la incorporación de `Service Line`, la cantidad total que se factura por cada uno se muestra y el promedio de estos tres valores se muestra en el campo calculado.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/avgOver.png)


## Argumentos
<a name="avgOver-function-arguments"></a>

 *measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="avgOver-function-example"></a>

En el siguiente ejemplo, se obtiene el promedio de `sum(Sales)` particionado por `City` y `State`. 

```
avgOver
(
     sum(Sales), 
     [City, State]
)
```

# countOver
<a name="countOver-function"></a>

La función `countOver` calcula el recuento de una dimensión o medida particionadas por una lista de dimensiones. 

## Sintaxis
<a name="countOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
countOver
(
  measure or dimension field 
  ,[ partition_field, ... ]  
  ,calculation level 
)
```

## Argumentos
<a name="countOver-function-arguments"></a>

 *measure or dimension field*   
La medida o dimensión para la que desea realizar el cálculo, por ejemplo, `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="countOver-function-example"></a>

En el siguiente ejemplo se obtiene el recuento de `Sales` particionado sobre `City` y `State`. 

```
countOver
(
  Sales, 
  [City, State]
)
```

En el siguiente ejemplo se obtiene el recuento de `{County}` particionado sobre `City` y `State`. 

```
countOver
(
  {County}, 
  [City, State]
)
```

En el siguiente ejemplo, se muestra el recuento de `Billed Amount` para `Customer Region`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
countOver
(
  sum({Billed Amount}),
  [{Customer Region}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Dado que no hay otros campos implicados, el recuento es uno para cada región.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/countOver1.png)


Si añade campos adicionales, el recuento cambia. En la siguiente captura de pantalla, añadimos `Customer Segment` y `Service Line`. Cada uno de estos campos contiene tres valores únicos. Con 3 segmentos, 3 líneas de servicio y 3 regiones, el campo calculado muestra 9.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/countOver2.png)


Si añade los dos campos adicionales a los campos de la partición en el campo calculado, `countOver( sum({Billed Amount}), [{Customer Region}, {Customer Segment}, {Service Line}]`, el recuento vuelve a ser 1 para cada fila.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/countOver.png)


# maxOver
<a name="maxOver-function"></a>

La función `maxOver` calcula el máximo de una medida o fecha particionadas por una lista de dimensiones. 

## Sintaxis
<a name="maxOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
maxOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="maxOver-function-arguments"></a>

 *measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="maxOver-function-example"></a>

En el siguiente ejemplo, se calcula el máximo de `sum(Sales)` particionado por `City` y `State`.

```
maxOver
(
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo se muestra el máximo de `Billed Amount` sobre `Customer Region`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
maxOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Con la incorporación de `Service Line`, la cantidad total que se factura por cada uno se muestra y el máximo de estos tres valores se muestra en el campo calculado.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/maxOver.png)


# minOver
<a name="minOver-function"></a>

La función `minOver` calcula el mínimo de una medida o fecha particionadas por una lista de dimensiones. 

## Sintaxis
<a name="minOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
minOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="minOver-function-arguments"></a>

*measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="minOver-function-example"></a>

En el siguiente ejemplo, se calcula el mínimo de `sum(Sales)` particionado por `City` y `State`.

```
minOver
(     
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo se muestra el mínimo de `Billed Amount` sobre `Customer Region`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
minOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Con la incorporación de `Service Line`, la cantidad total que se factura por cada uno se muestra y el mínimo de estos tres valores se muestra en el campo calculado.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/minOver.png)


# percentileOver
<a name="percentileOver-function"></a>

La función `percentileOver` calcula el percentil *n* de una medida particionada por una lista de dimensiones. Hay dos tipos de `percentileOver` cálculo disponibles en Quick:
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileContOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileContOver-function.html) utiliza la interpolación lineal para determinar el resultado.
+ [https://docs.aws.amazon.com/quicksight/latest/user/percentileDiscOver-function.html](https://docs.aws.amazon.com/quicksight/latest/user/percentileDiscOver-function.html) utiliza valores reales para determinar el resultado. 

La función `percentileOver` es un alias de `percentileDiscOver`.

# percentileContOver
<a name="percentileContOver-function"></a>

La función `percentileContOver` calcula el percentil en función de los números reales de `measure`. Utiliza la agrupación y la ordenación que se aplican en los cuadros de campo. El resultado se particiona según la dimensión especificada en el nivel de cálculo especificado. 

Utilice esta función para responder a la siguiente pregunta: ¿Qué puntos de datos reales están presentes en este percentil? Para devolver el valor del percentil más cercano que esté presente en su conjunto de datos, utilice `percentileDiscOver`. Para devolver un valor de percentil exacto que podría no estar presente en su conjunto de datos, utilice `percentileContOver` en su lugar. 

## Sintaxis
<a name="percentileContOver-function-syntax"></a>

```
percentileContOver (
    measure
  , percentile-n
  , [partition-by, …]
  , calculation-level
)
```

## Argumentos
<a name="percentileContOver-function-arguments"></a>

 *measure*   
Especifica un valor numérico que se utilizará para calcular el percentil. El argumento debe ser una medida o una métrica. Los valores nulos se ignoran en el cálculo. 

 *percentil-n*   
El valor del percentil puede ser cualquier constante numérica del 0 al 100. Un valor de percentil de 50 calcula el valor mediano de la medida. 

 *partition-by*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas. Cada campo en la lista está entre \$1 \$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation-level*   
 Especifica dónde hacer el cálculo en relación con el orden de evaluación. Se admiten tres niveles de cálculo:  
+ PRE\$1FILTER
+ PRE\$1AGG
+ POST\$1AGG\$1FILTER (predeterminado): para usar este nivel de cálculo, especifique una agregación en `measure`, por ejemplo, `sum(measure)`.
PRE\$1FILTER y PRE\$1AGG se aplican antes de que se produzca la agregación en una visualización. Para estos dos niveles de cálculo, no puede especificar una agregación en `measure` en la expresión de campo calculada. Para obtener más información sobre los niveles de cálculo y cuándo se aplican, consulte [Orden de evaluación en Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/order-of-evaluation-quicksight.html) y [Uso de cálculos con reconocimiento de niveles en](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html) Quick.

## Devuelve
<a name="percentileContOver-function-return-type"></a>

El resultado de la función es un número. 

## Ejemplo de percentileContOver
<a name="percentileContOver-examples"></a>

El siguiente ejemplo ayuda a explicar cómo percentileContOver funciona.

**Example Comparación de los niveles de cálculo de la mediana**  
En el siguiente ejemplo, se muestra la mediana de una dimensión (categoría) al usar niveles de cálculo diferentes con la función `percentileContOver`. El percentil es 50. El conjunto de datos se filtra por un campo de región. El código de cada campo calculado es el siguiente:  
+ `example = left( category, 1 )` (Un ejemplo simplificado.)
+ `pre_agg = percentileContOver ( {Revenue} , 50 , [ example ] , PRE_AGG)`
+ `pre_filter = percentileContOver ( {Revenue} , 50 , [ example ] , PRE_FILTER) `
+ `post_agg_filter = percentileContOver ( sum ( {Revenue} ) , 50 , [ example ], POST_AGG_FILTER )`

```
example   pre_filter     pre_agg      post_agg_filter
------------------------------------------------------
0            106,728     119,667            4,117,579
1            102,898      95,946            2,307,547
2             97,807      93,963              554,570  
3            101,043     112,585            2,709,057
4             96,533      99,214            3,598,358
5            106,293      97,296            1,875,648
6             97,118      69,159            1,320,672
7            100,201      90,557              969,807
```

# percentileDiscOver
<a name="percentileDiscOver-function"></a>

La función `percentileDiscOver` calcula el percentil en función de los números reales de `measure`. Utiliza la agrupación y la ordenación que se aplican en los cuadros de campo. El resultado se particiona según la dimensión especificada en el nivel de cálculo especificado. La función `percentileOver` es un alias de `percentileDiscOver`.

Utilice esta función para responder a la siguiente pregunta: ¿Qué puntos de datos reales están presentes en este percentil? Para devolver el valor del percentil más cercano que esté presente en su conjunto de datos, utilice `percentileDiscOver`. Para devolver un valor de percentil exacto que podría no estar presente en su conjunto de datos, utilice `percentileContOver` en su lugar. 

## Sintaxis
<a name="percentileDiscOver-function-syntax"></a>

```
percentileDiscOver (
     measure
   , percentile-n
   , [partition-by, …]
   , calculation-level
)
```

## Argumentos
<a name="percentileDiscOver-function-arguments"></a>

 *measure*   
Especifica un valor numérico que se utilizará para calcular el percentil. El argumento debe ser una medida o una métrica. Los valores nulos se ignoran en el cálculo. 

 *percentil-n*   
El valor del percentil puede ser cualquier constante numérica del 0 al 100. Un valor de percentil de 50 calcula el valor mediano de la medida. 

 *partition-by*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas. Cada campo en la lista está entre \$1 \$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation-level*   
 Especifica dónde hacer el cálculo en relación con el orden de evaluación. Se admiten tres niveles de cálculo:  
+ PRE\$1FILTER
+ PRE\$1AGG
+ POST\$1AGG\$1FILTER (predeterminado): para usar este nivel de cálculo, debe especificar una agregación en `measure`, por ejemplo, `sum(measure)`.
PRE\$1FILTER y PRE\$1AGG se aplican antes de que se produzca la agregación en una visualización. Para estos dos niveles de cálculo, no puede especificar una agregación en `measure` en la expresión de campo calculada. Para obtener más información sobre los niveles de cálculo y cuándo se aplican, consulte [Orden de evaluación en Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/order-of-evaluation-quicksight.html) y [Uso de cálculos con reconocimiento de niveles en](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html) Quick.

## Devuelve
<a name="percentileDiscOver-function-return-type"></a>

El resultado de la función es un número. 

## Ejemplo de percentileDiscOver
<a name="percentileDiscOver-examples"></a>

El siguiente ejemplo ayuda a explicar cómo percentileDiscOver funciona.

**Example Comparación de los niveles de cálculo de la mediana**  
En el siguiente ejemplo, se muestra la mediana de una dimensión (categoría) al usar niveles de cálculo diferentes con la función `percentileDiscOver`. El percentil es 50. El conjunto de datos se filtra por un campo de región. El código de cada campo calculado es el siguiente:  
+ `example = left( category, 1 )` (Un ejemplo simplificado.)
+ `pre_agg = percentileDiscOver ( {Revenue} , 50 , [ example ] , PRE_AGG)`
+ `pre_filter = percentileDiscOver ( {Revenue} , 50 , [ example ] , PRE_FILTER) `
+ `post_agg_filter = percentileDiscOver ( sum ( {Revenue} ) , 50 , [ example ], POST_AGG_FILTER )`

```
example   pre_filter     pre_agg      post_agg_filter
------------------------------------------------------
0            106,728     119,667            4,117,579
1            102,898      95,946            2,307,547
2             97,629      92,046              554,570  
3            100,867     112,585            2,709,057
4             96,416      96,649            3,598,358
5            106,293      97,296            1,875,648
6             97,118      64,395            1,320,672
7             99,915      90,557              969,807
```

**Example La mediana**  
En el siguiente ejemplo, se calcula la mediana (percentil 50) de `Sales` particionada por `City` y `State`.   

```
percentileDiscOver
(
  Sales, 
  50,
  [City, State]
)
```
En el siguiente ejemplo, se calcula el percentil 98 de `sum({Billed Amount})` particionado por `Customer Region`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.  

```
percentileDiscOver
(
  sum({Billed Amount}), 
  98,
  [{Customer Region}]
)
```
En la siguiente captura de pantalla se muestra el aspecto de estos dos ejemplos en un gráfico.   

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentilOver-50-98.png)


# percentOfTotal
<a name="percentOfTotal-function"></a>

La función `percentOfTotal` calcula el porcentaje en que una medida contribuye al total, en función de las dimensiones especificadas. 

## Sintaxis
<a name="percentOfTotal-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
percentOfTotal
(
     measure 
     ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="percentOfTotal-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver el porcentaje del total. Actualmente, no se admite la agregación de `distinct count` para `percentOfTotal`.

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="percentOfTotal-function-example"></a>

En el siguiente ejemplo se crea un cálculo del porcentaje de `Sales` total al que ha contribuido cada `State`.

```
percentOfTotal
(
     sum(Sales), 
     [State]
)
```

En el siguiente ejemplo, se calcula el porcentaje de un `Billed Amount` específico en comparación con el `Billed Amount` total, particionado por (`[{Service Line} ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
percentOfTotal
(
     sum( {Billed Amount} ), 
     [{Service Line}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Los resaltos en rojo muestran que el campo de partición con el valor “`Billing`” tiene tres entradas, una para cada región. La cantidad total de factura para esta línea de servicio se divide en tres porcentajes, que dan un total del 100 %. Los porcentajes se redondean puede que no siempre sumen exactamente el 100 %.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentOfTotal.png)


# periodOverPeriodDifference
<a name="periodOverPeriodDifference-function"></a>

La función `periodOverPeriodDifference` calcula la diferencia de una medida en dos periodos de tiempo diferentes, según lo especificado por el grado de detalle y el desviación del periodo. A diferencia del cálculo de diferencias, esta función utiliza una desviación basada en la fecha en lugar de una desviación de tamaño fijo. Esto garantiza que solo se comparen las fechas correctas, incluso si faltan puntos de datos en el conjunto de datos.

## Sintaxis
<a name="periodOverPeriodDifference-function-syntax"></a>

```
periodOverPeriodDifference(
	measure, 
	date, 
	period, 
	offset)
```

## Argumentos
<a name="periodOverPeriodDifference-function-arguments"></a>

 *measure*   
Una medida agregada en la que desee realizar el periodOverPeriod cálculo.

 *dateTime*   
La dimensión de fecha sobre la que estamos calculando Period-Over-Period los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado es el grado de detalle de la dimensión de fecha del elemento visual.

 *desplazamiento*   
(Opcional) La desviación puede ser un entero positivo o negativo que represente el periodo de tiempo anterior (especificado por periodo) con el que desea hacer la comparación. Por ejemplo, un periodo de un trimestre con una desviación de 1 significa que se hará una comparación con el trimestre anterior.  
El valor predeterminado es 1.

## Ejemplo
<a name="periodOverPeriodDifference-function-example"></a>

En el siguiente ejemplo, se utiliza un campo calculado con `PeriodOverPeriod` para mostrar la diferencia en el importe de las ventas respecto a ayer

```
periodOverPeriodDifference(sum(Sales), {Order Date})
```

![\[Esta es una imagen del resultado del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/MonthOverMonthDifference.png)


En el siguiente ejemplo, se utiliza un campo calculado con `PeriodOverPeriod` para mostrar la diferencia en el importe de las ventas respecto a los 2 meses anteriores. En el siguiente ejemplo se comparan las ventas de `Mar2020` con `Jan2020`.

```
periodOverPeriodDifference(sum(Sales),{Order Date}, MONTH, 1)
```

![\[Esta es una imagen del resultado del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/MonthOverMonthDifference2.png)


# periodOverPeriodLastValue
<a name="periodOverPeriodLastValue-function"></a>

La función `periodOverPeriodLastValue` calcula el último valor (anterior) de una medida del periodo de tiempo anterior, según lo especificado en el grado de detalle y la desviación del periodo. Esta función utiliza una desviación basada en la fecha en lugar de una desviación de tamaño fijo. Esto garantiza que solo se comparen las fechas correctas, incluso si faltan puntos de datos en el conjunto de datos.

## Sintaxis
<a name="periodOverPeriodLastValue-function-syntax"></a>

```
periodOverPeriodLastValue(
	measure, 
	date, 
	period, 
	offset)
```

## Argumentos
<a name="periodOverPeriodLastValue-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver la diferencia.

 *date*   
La dimensión de fecha en la que está calculando periodOverPeriod los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado de este argumento es el grado de detalle de la agregación del elemento visual

 *desplazamiento*   
(Opcional) La desviación puede ser un entero positivo o negativo que represente el periodo de tiempo anterior (especificado por periodo) con el que desea hacer la comparación. Por ejemplo, un periodo de un trimestre con una desviación de 1 significa que se hará una comparación con el trimestre anterior.  
El valor predeterminado de este argumento es 1.

## Ejemplo
<a name="periodOverPeriodLastValue-function-example"></a>

En el siguiente ejemplo, se calcula el valor de las ventas mes a mes con el grado de detalle de la dimensión del elemento visual y la desviación predeterminada de 1.

```
periodOverPeriodLastValue(sum(Sales), {Order Date})
```

En el siguiente ejemplo, se calcula el valor de las ventas mes a mes con un grado de detalle fijo de `MONTH` y un desviación fija de 1.

```
periodOverPeriodLastValue(sum(Sales), {Order Date},MONTH, 1)
```

![\[Esta es una imagen del resultado del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/MonthOverMonthLastValue.png)


# periodOverPeriodPercentDifference
<a name="periodOverPeriodPercentDifference-function"></a>

La función `periodOverPeriodPercentDifference` calcula la diferencia porcentual de una medida en dos periodos de tiempo diferentes, según lo especificado por el grado de detalle y la desviación del periodo. A diferencia de percentDifference, esta función utiliza una desviación basada en la fecha en lugar de una desviación de tamaño fijo. Esto garantiza que solo se comparen las fechas correctas, incluso si faltan puntos de datos en el conjunto de datos.

## Sintaxis
<a name="periodOverPeriodPercentDifference-function-syntax"></a>

```
periodOverPeriodPercentDifference(
	measure, 
	date, 
	period, 
	offset)
```

## Argumentos
<a name="periodOverPeriodPercentDifference-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver la diferencia.

 *date*   
La dimensión de fecha en la que está calculando periodOverPeriod los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado de este argumento es el grado de detalle de la agregación del elemento visual

 *desplazamiento*   
(Opcional) La desviación puede ser un entero positivo o negativo que represente el periodo de tiempo anterior (especificado por periodo) con el que desea hacer la comparación. Por ejemplo, un periodo de un trimestre con una desviación de 1 significa que se hará una comparación con el trimestre anterior.  
El valor predeterminado de este argumento es 1.

## Ejemplo
<a name="periodOverPeriodPercentDifference-function-example"></a>

En el siguiente ejemplo, se calcula la diferencia porcentual de las ventas mes a mes con el grado de detalle de la dimensión del elemento visual y la desviación predeterminada de 1.

```
periodOverPeriodPercentDifference(sum(Sales),{Order Date})
```

En el siguiente ejemplo, se calcula la diferencia porcentual de las ventas mes a mes con un grado de detalle fijo de `MONTH` y una desviación fija de 1.

```
periodOverPeriodPercentDifference(sum(Sales), {Order Date}, MONTH, 1)
```

![\[Esta es una imagen del resultado del cálculo del ejemplo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/MonthOverMonthPercentDifference.png)


# periodToDateAvgOverTime
<a name="periodToDateAvgOverTime-function"></a>

La función `periodToDateAvgOverTime` calcula el promedio de una medida para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.

## Sintaxis
<a name="periodToDateAvgOverTime-function-syntax"></a>

```
periodToDateAvgOverTime(
	measure, 
	dateTime,
	period)
```

## Argumentos
<a name="periodToDateAvgOverTime-function-arguments"></a>

 *measure*   
Una medida agregada en la que desee hacer el cálculo.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodOverTime los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado es el grado de detalle de la dimensión de fecha del elemento visual.

## Ejemplo
<a name="periodToDateAvgOverTime-function-example"></a>

La siguiente función calcula el importe medio de la tarifa mes tras mes.

```
periodToDateAvgOverTime(sum({fare_amount}), pickupDatetime, MONTH)
```

![\[Esta es una imagen de los resultados del cálculo de ejemplo con ilustraciones.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDAvgOverTimeResults.png)


# periodToDateCountOverTime
<a name="periodToDateCountOverTime-function"></a>

La función `periodToDateCountOverTime` calcula el recuento de una dimensión o medida para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.

## Sintaxis
<a name="periodToDateCountOverTime-function-syntax"></a>

```
periodToDateCountOverTime(
	measure, 
	dateTime, 
	period)
```

## Argumentos
<a name="periodToDateCountOverTime-function-arguments"></a>

 *measure*   
Una medida agregada en la que desee hacer el cálculo.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodOverTime los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado es el grado de detalle de la dimensión de fecha del elemento visual.

## Ejemplo
<a name="periodToDateCountOverTime-function-example"></a>

En el siguiente ejemplo, se calcula el recuento de proveedores mes tras mes.

```
periodToDateCountOverTime(count(vendorid), pickupDatetime, MONTH)
```

![\[Esta es una imagen de los resultados del cálculo de ejemplo con ilustraciones.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDCountOverTimeResults.png)


# periodToDateMaxOverTime
<a name="periodToDateMaxOverTime-function"></a>

La función `periodToDateMaxOverTime` calcula el máximo de una medida para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.

## Sintaxis
<a name="periodToDateMaxOverTime-function-syntax"></a>

```
periodToDateMaxOverTime(
	measure, 
	dateTime, 
	period)
```

## Argumentos
<a name="periodToDateMaxOverTime-function-arguments"></a>

 *measure*   
Una medida agregada en la que desee hacer el cálculo.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodOverTime los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado es el grado de detalle de la dimensión de fecha del elemento visual.

## Ejemplo
<a name="periodToDateMaxOverTime-function-example"></a>

En el siguiente ejemplo, se calcula el importe máximo de la tarifa mes tras mes.

```
periodToDatemaxOverTime(max({fare_amount}), pickupDatetime, MONTH)
```

![\[Esta es una imagen de los resultados del cálculo de ejemplo con ilustraciones.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDMaxOverTimeResults.png)


# periodToDateMinOverTime
<a name="periodToDateMinOverTime-function"></a>

La función `periodToDateMinOverTime` calcula el mínimo de una medida para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.

## Sintaxis
<a name="periodToDateMinOverTime-function-syntax"></a>

```
periodToDateMinOverTime(
	measure, 
	dateTime, 
	period)
```

## Argumentos
<a name="periodToDateMinOverTime-function-arguments"></a>

 *measure*   
Una medida agregada en la que desee hacer el cálculo.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodOverTime los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado es el grado de detalle de la dimensión de fecha del elemento visual.

## Ejemplo
<a name="periodToDateMinOverTime-function-example"></a>

En el siguiente ejemplo, se calcula el importe mínimo de la tarifa mes tras mes.

```
periodToDateMinOverTime(min({fare_amount}), pickupDatetime, MONTH)
```

![\[Esta es una imagen de los resultados del cálculo de ejemplo con ilustraciones.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDMinOverTimeResults.png)


# periodToDateSumOverTime
<a name="periodToDateSumOverTime-function"></a>

La función `periodToDateSumOverTime` calcula la suma de una medida para un grado de detalle de tiempo determinado (por ejemplo, un trimestre) hasta un momento concreto en el tiempo.

## Sintaxis
<a name="periodToDateSumOverTime-function-syntax"></a>

```
periodToDateSumOverTime(
	measure, 
	dateTime, 
	period)
```

## Argumentos
<a name="periodToDateSumOverTime-function-arguments"></a>

 *measure*   
Una medida agregada en la que desee hacer el cálculo.

 *dateTime*   
La dimensión de fecha en la que está calculando PeriodOverTime los cálculos.

 *periodo*   
(Opcional) El periodo de tiempo durante el que se hace el cálculo. Si se usa el grado de detalle de `YEAR`, significa que se usará el cálculo `YearToDate`; si se usa el grado de detalle de `Quarter`, significa que se usará el cálculo `QuarterToDate`, etc. Los grados de detalle válidos son `YEAR`, `QUARTER`, `MONTH`, `WEEK`, `DAY`, `HOUR`, `MINUTE` y `SECONDS`.  
El valor predeterminado es el grado de detalle de la dimensión de fecha del elemento visual.

## Ejemplo
<a name="periodToDateSumOverTime-function-example"></a>

La siguiente función devuelve el importe total de la tarifa mes tras mes.

```
periodToDateSumOverTime(sum({fare_amount}), pickupDatetime, MONTH)
```

![\[Esta es una imagen de los resultados del cálculo de ejemplo con ilustraciones.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/PTDSumOverTime-example-results.png)


# stdevOver
<a name="stdevOver-function"></a>

La función `stdevOver` calcula la desviación estándar de la medida especificada y la divide por el atributo o los atributos seleccionados, en función de una muestra. 

## Sintaxis
<a name="stdevOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
stdevOver
(
      measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="stdevOver-function-arguments"></a>

*measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (predeterminado) los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="stdevOver-function-example"></a>

En el siguiente ejemplo, se calcula la desviación estándar de `sum(Sales)`, dividida por `City` y `State`, en función de una muestra.

```
stdevOver
(
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo, se calcula la desviación estándar de `Billed Amount` en `Customer Region`, en función de una muestra. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
stdevOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

# stdevpOver
<a name="stdevpOver-function"></a>

La función `stdevpOver` calcula la desviación estándar de la medida especificada y la divide por el atributo o los atributos seleccionados, en función de una población sesgada.

## Sintaxis
<a name="stdevpOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
stdevpOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="stdevpOver-function-arguments"></a>

*measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (predeterminado) los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="stdevpOver-function-example"></a>

En el siguiente ejemplo, se calcula la desviación estándar de `sum(Sales)`, dividida por `City` y `State`, en función de una población sesgada.

```
stdevpOver
(
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo, se calcula la desviación estándar de `Billed Amount` en `Customer Region`, en función de una población sesgada. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
stdevpOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

# varOver
<a name="varOver-function"></a>

La función `varOver` calcula la varianza de la medida especificada, y la divide por el atributo o los atributos seleccionados, en función de una muestra. 

## Sintaxis
<a name="varOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
varOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="varOver-function-arguments"></a>

*measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="varOver-function-example"></a>

En el siguiente ejemplo, se calcula la varianza de `sum(Sales)`, dividida por `City` y `State`, en función de una muestra.

```
varOver
(
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo, se calcula la varianza de `Billed Amount` en `Customer Region`, en función de una muestra. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
varOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

# varpOver
<a name="varpOver-function"></a>

La función `varpOver` calcula la varianza de la medida especificada, y la divide por el atributo o los atributos seleccionados, en función de una población sesgada. 

## Sintaxis
<a name="varpOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
varpOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="varpOver-function-arguments"></a>

*measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="varpOver-function-example"></a>

En el siguiente ejemplo, se calcula la varianza de `sum(Sales)`, dividida por `City` y `State`, en función de una población sesgada.

```
varpOver
(
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo, se calcula la varianza de `Billed Amount` en `Customer Region`, en función de una población sesgada. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
varpOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

# sumOver
<a name="sumOver-function"></a>

 La función `sumOver` calcula la suma de una medida particionada por una lista de dimensiones. 

## Sintaxis
<a name="sumOver-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
sumOver
(
     measure 
     ,[ partition_field, ... ] 
     ,calculation level 
)
```

## Argumentos
<a name="sumOver-function-arguments"></a>

*measure*   
La medida para la que desea realizar el cálculo, como `sum({Sales Amt})`. Utilice una agregación si el nivel de cálculo está establecido en `NULL` o `POST_AGG_FILTER`. No utilice una agregación si el nivel de cálculo está establecido en `PRE_FILTER` o `PRE_AGG`.

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (predeterminado) los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="sumOver-function-example"></a>

En el siguiente ejemplo, se calcula la suma de `sum(Sales)` particionada por `City` y `State`.

```
sumOver
(
     sum(Sales), 
     [City, State]
)
```

En el siguiente ejemplo, se suma `Billed Amount` sobre `Customer Region`. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
sumOver
(
     sum({Billed Amount}),
     [{Customer Region}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Con la incorporación de `Customer Segment`, la cantidad total que se factura por cada uno se suman para `Customer Region` y se muestra en el campo calculado.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sumOver.png)


# denseRank
<a name="denseRank-function"></a>

La función `denseRank` calcula la clasificación de una medida o una dimensión en comparación con las particiones especificadas. Cuenta cada elemento solo una vez, ignorando duplicados, y asigna una clasificación “sin orificios” de forma que los valores duplicados comparten la misma clasificación. 

## Sintaxis
<a name="denseRank-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
denseRank
(
  [ sort_order_field ASC_or_DESC, ... ] 
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="denseRank-function-arguments"></a>

 *campo de orden de clasificación*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="denseRank-function-example"></a>

En el siguiente ejemplo, se clasifica `max(Sales)` densamente en orden descendente por `State` y `City`. A todas las ciudades con el mismo valor de `max(Sales)` se les asigna la misma clasificación y la siguiente ciudad se clasifica consecutivamente después de ellas. Por ejemplo, si tres ciudades comparten la misma clasificación, la cuarta ciudad se clasifica como segunda. 

```
denseRank
(
  [max(Sales) DESC], 
  [State, City]
)
```

En el siguiente ejemplo, se clasifica `max(Sales)` densamente en orden descendente por `State`. A todos los estados con el mismo valor de `max(Sales)` se les asigna la misma clasificación y el siguiente se clasifica consecutivamente después de ellos. Por ejemplo, si tres estados comparten la misma clasificación, el cuarto estado se clasifica como segundo. 

```
denseRank
(
  [max(Sales) DESC], 
  [State]
)
```

# rank
<a name="rank-function"></a>

La función `rank` calcula la clasificación de una medida o una dimensión en comparación con las particiones especificadas. Cuenta cada elemento, incluso los duplicados, una vez y asigna una clasificación “con orificios” para compensar los valores duplicados. 

## Sintaxis
<a name="rank-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
rank
(
  [ sort_order_field ASC_or_DESC, ... ]
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="rank-function-arguments"></a>

 *campo de orden de clasificación*   
Una o más medidas y dimensiones agregadas por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="rank-function-example"></a>

En el siguiente ejemplo, se clasifica `max(Sales)` en función de un orden descendente por `State` y `City`, con `State` igual a **WA**. A todas las ciudades con el mismo valor de `max(Sales)` se les asigna la misma clasificación, pero la siguiente clasificación incluye el recuento de todas las clasificaciones anteriores. Por ejemplo, si tres ciudades comparten la misma clasificación, la cuarta ciudad se clasifica como cuarta. 

```
rank
(
  [max(Sales) DESC], 
  [State, City]
)
```

En el siguiente ejemplo, se clasifica `max(Sales)` en orden ascendente por `State`. A todos los estados con el mismo valor de `max(Sales)` se les asigna la misma clasificación, pero la siguiente clasificación incluye el recuento de todas las clasificaciones anteriores. Por ejemplo, si tres estados comparten la misma clasificación, el cuarto estado se clasifica como cuarto. 

```
rank
(
  [max(Sales) ASC], 
  [State]
)
```

En el siguiente ejemplo, se clasifica `Customer Region` por `Billed Amount` total. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
rank(
  [sum({Billed Amount}) DESC]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla, junto con el valor de `Billed Amount` total, para que pueda ver la clasificación de cada región.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rankCalc.png)


# percentileRank
<a name="percentileRank-function"></a>

La función `percentileRank` calcula la clasificación de percentil de una medida o una dimensión en comparación con las particiones especificadas. El valor de rango percentil (*x*) indica que el elemento actual está por encima del*x*% de los valores de la partición especificada. El valor de clasificación de percentil está comprendido entre 0 (incluido) y 100 (no incluido). 

## Sintaxis
<a name="percentileRank-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
percentileRank
(
      [ sort_order_field ASC_or_DESC, ... ] 
     ,[ {partition_field}, ... ]
)
```

## Argumentos
<a name="percentileRank-function-arguments"></a>

 *campo de orden de clasificación*   
Una o más medidas y dimensiones agregadas por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *calculation level*  
(Opcional) Especifica el nivel de cálculo que se va a utilizar:  
+ **`PRE_FILTER`**: Los cálculos del prefiltro se calculan antes que los filtros del conjunto de datos.
+ **`PRE_AGG`**: Los cálculos preagregados se calculan antes de aplicar las agregaciones y los filtros *N* superiores e inferiores a los elementos visuales.
+ **`POST_AGG_FILTER`**: (Predeterminado) Los cálculos de las tablas se calculan cuando se muestran los elementos visuales. 
Este valor se establece de forma predeterminada en `POST_AGG_FILTER` cuando está en blanco. Para obtener más información, consulte [Uso de cálculos con reconocimiento de niveles en Quick](https://docs.aws.amazon.com/quicksight/latest/user/level-aware-calculations.html).

## Ejemplo
<a name="percentileRank-function-example"></a>

En el siguiente ejemplo, se realiza una clasificación de percentil para `max(Sales)` en orden descendente por `State`. 

```
percentileRank
(
     [max(Sales) DESC], 
     [State]
)
```

En el siguiente ejemplo se realiza una clasificación de percentil para `Customer Region` por `Billed Amount` total. Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
percentileRank(
     [sum({Billed Amount}) DESC],
     [{Customer Region}]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla, junto con el valor de `Billed Amount` total, para que pueda ver la comparación entre las distintas regiones.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentileRank.png)


# runningAvg
<a name="runningAvg-function"></a>

La función `runningAvg` calcula un promedio acumulado de una medida en función de las dimensiones y ordenaciones especificadas. 

## Sintaxis
<a name="runningAvg-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones. 

```
runningAvg
(
  measure 
  ,[ sortorder_field ASC_or_DESC, ... ]  
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="runningAvg-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver el promedio acumulado. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="runningAvg-function-example"></a>

En el siguiente ejemplo, se calcula un promedio acumulado de `sum(Sales)` ordenado por `Sales`, particionado por `City` y `State`.

```
runningAvg
(
  sum(Sales), 
  [Sales ASC], 
  [City, State]
)
```

En el siguiente ejemplo, se calcula un promedio acumulado de `Billed Amount`, ordenado por mes (`[truncDate("MM",Date) ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
runningAvg
(
  sum({Billed Amount}),
  [truncDate("MM",Date) ASC]
)
```

# runningCount
<a name="runningCount-function"></a>

La función `runningCount` calcula un recuento acumulado de una medida o dimensión en función de las dimensiones y ordenaciones especificadas. 

## Sintaxis
<a name="runningCount-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones. 

```
runningCount
(
  measure_or_dimension 
  ,[ sortorder_field ASC_or_DESC, ... ]  
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="runningCount-function-arguments"></a>

 *medida o dimensión*   
Una medida o dimensión agregada de la que desee ver el recuento acumulado. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="runningCount-function-example"></a>

En el siguiente ejemplo, se calcula un recuento acumulado de `sum(Sales)` ordenado por `Sales`, particionado por `City` y `State`.

```
runningCount
(
  sum(Sales), 
  [Sales ASC], 
  [City, State]
)
```

En el siguiente ejemplo, se calcula un recuento acumulado de `Billed Amount`, ordenado por mes (`[truncDate("MM",Date) ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
runningCount
(
  sum({Billed Amount}),
  [truncDate("MM",Date) ASC]
)
```

# runningMax
<a name="runningMax-function"></a>

La función `runningMax` calcula un máximo acumulado de una medida en función de las dimensiones y ordenaciones especificadas. 

## Sintaxis
<a name="runningMax-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones. 

```
runningMax
(
  measure 
  ,[ sortorder_field ASC_or_DESC, ... ]  
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="runningMax-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver el máximo acumulado. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="runningMax-function-example"></a>

En el siguiente ejemplo, se calcula un máximo acumulado de `sum(Sales)` ordenado por `Sales` y particionado por `City` y `State`.

```
runningMax
(
  sum(Sales), 
  [Sales ASC], 
  [City, State]
)
```

En el siguiente ejemplo, se calcula un máximo acumulado de `Billed Amount`, ordenado por mes (`[truncDate("MM",Date) ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
runningMax
(
  sum({Billed Amount}),
  [truncDate("MM",Date) ASC]
)
```

# runningMin
<a name="runningMin-function"></a>

La función `runningMin` calcula un mínimo acumulado de una medida en función de las dimensiones y ordenaciones especificadas. 

## Sintaxis
<a name="runningMin-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones. 

```
runningMin
(
  measure 
  ,[ sortorder_field ASC_or_DESC, ... ]  
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="runningMin-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver el mínimo acumulado. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="runningMin-function-example"></a>

En el siguiente ejemplo, se calcula un mínimo acumulado de `sum(Sales)` ordenado por `Sales` y particionado por `City` y `State`.

```
runningMin
(
  sum(Sales), 
  [Sales ASC], 
  [City, State]
)
```

En el siguiente ejemplo, se calcula un mínimo acumulado de `Billed Amount`, ordenado por mes (`[truncDate("MM",Date) ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
runningMin
(
  sum({Billed Amount}),
  [truncDate("MM",Date) ASC]
)
```

# runningSum
<a name="runningSum-function"></a>

La función `runningSum` calcula una suma acumulada de una medida en función de las dimensiones y ordenaciones especificadas. 

## Sintaxis
<a name="runningSum-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones. 

```
runningSum
(
  measure 
  ,[ sortorder_field ASC_or_DESC, ... ]  
  ,[ partition_field, ... ] 
)
```

## Argumentos
<a name="runningSum-function-arguments"></a>

 *measure*   
Una medida agregada de la que desee ver la ejecución de suma. 

 *campo de orden de clasificación*   
Una o más medidas y dimensiones por las que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

 *partition field*  
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="runningSum-function-example"></a>

En el siguiente ejemplo, se calcula una suma de ejecución de `sum(Sales)` ordenada por `Sales` y particionada por `City` y `State`.

```
runningSum
(
  sum(Sales), 
  [Sales ASC], 
  [City, State]
)
```

En el siguiente ejemplo, se calcula una suma de ejecución de `Billed Amount`, ordenada por mes (`[truncDate("MM",Date) ASC]`). Los campos en el cálculo de tabla se encuentran en los cuadros de campo del elemento visual.

```
runningSum
(
  sum({Billed Amount}),
  [truncDate("MM",Date) ASC]
)
```

Los resultados del ejemplo se muestran en la siguiente captura de pantalla. Las etiquetas rojas muestran cómo se suma cada cantidad (`a + b = c`) a la cantidad siguiente, lo que se traduce en un nuevo total. 

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/runningSum.png)


# firstValue
<a name="firstValue-function"></a>

La función `firstValue` calcula el primer valor de la medida o dimensión agregada dividida y ordenada según los atributos especificados.

## Sintaxis
<a name="firstValue-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
firstValue
	(
	     aggregated measure or dimension, 
	     [ sort_attribute ASC_or_DESC, ... ],
	     [ partition_by_attribute, ... ] 
	)
```

## Argumentos
<a name="firstValue-function-arguments"></a>

*medida o dimensión agregada*   
Una medida o dimensión agregada de la que desee ver el primer valor.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*partición por atributo*  
(Opcional) Una o más medidas o dimensiones por las que desea realizar particiones, separadas por comas.  
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes). 

## Ejemplo
<a name="firstValue-function-example"></a>

En el siguiente ejemplo se calcula el primer `Destination Airport`, ordenado por `Flight Date`, dividido en `Flight Date` ascendente y `Origin Airport`.

```
firstValue(
    {Destination Airport}
    [{Flight Date} ASC],
    [
        {Origin Airport},
        {Flight Date}
    ]
)
```

# lastValue
<a name="lastValue-function"></a>

La función `lastValue` calcula el último valor de la medida o dimensión agregada dividida y ordenada según los atributos especificados.

## Sintaxis
<a name="lastValue-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
lastValue
	(
	     aggregated measure or dimension,
	     [ sort_attribute ASC_or_DESC, ... ],
	     [ partition_by_attribute, ... ] 
	)
```

## Argumentos
<a name="lastValue-function-arguments"></a>

*medida o dimensión agregada*   
Una medida o dimensión agregada de la que desee ver el último valor.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (`ASC`) o descendente (`DESC`).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*partición por atributo*  
(Opcional) Una o más medidas o dimensiones por las que desea realizar particiones, separadas por comas.  
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes). 

## Ejemplo
<a name="lastValue-function-example"></a>

En el siguiente ejemplo se calcula el último valor de `Destination Airport`. Este cálculo se ordena por el valor `Flight Date` y se divide entre el valor `Flight Date` ordenado en orden ascendente y el valor `Origin Airport`.

```
lastValue(
    [{Destination Airport}],
    [{Flight Date} ASC],
    [
        {Origin Airport},
    	truncDate('DAY', {Flight Date})
    ]
)
```

# windowAvg
<a name="windowAvg-function"></a>

La función `windowAvg` calcula el promedio de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados. Normalmente, las funciones de ventana personalizadas se utilizan en una serie temporal, donde el elemento visual muestra una métrica y un campo de fecha. Por ejemplo, puede utilizar `windowAvg` para calcular un promedio móvil, que a menudo se utiliza para suavizar el ruido en un gráfico de líneas.

Las funciones de ventana no son compatibles con las versiones de MySQL anteriores a la 8 y con las versiones de MariaDB anteriores a la 10.2.

## Sintaxis
<a name="windowAvg-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
windowAvg
	(
	     measure 
            , [sort_order_field ASC/DESC, ...]
            , start_index
            , end_index
	     ,[ partition_field, ... ] 
	)
```

## Argumentos
<a name="windowAvg-function-arguments"></a>

*measure*   
La métrica agregada para la que desea obtener el promedio, por ejemplo, `sum({Revenue})`.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1 \$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*índice de comienzo*   
El índice de comienzo es un número entero positivo, que indica *n* filas por encima de la fila actual. El índice de comienzo cuenta los puntos de datos disponibles por encima de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

*índice final*   
El índice final es un número entero positivo, que indica *n* filas por debajo de la fila actual. El índice final cuenta los puntos de datos disponibles por debajo de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="windowAvg-function-example"></a>

En el siguiente ejemplo, se calcula el promedio móvil de `sum(Revenue)` particionado por `SaleDate`. El cálculo incluye tres filas por encima y dos por debajo de la fila actual.

```
windowAvg
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     3,
            2
	)
```

Los resultados de este ejemplo de promedio móvil se muestran en la siguiente captura de pantalla. El campo sum(Revenue) se añade al gráfico para mostrar la diferencia entre los ingresos y el promedio móvil de los ingresos.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/windowAvg.png)


# windowCount
<a name="windowCount-function"></a>

La función `windowCount` calcula el recuento de la medida o dimensión agregada en una ventana personalizada que está dividida y ordenada por atributos especificados. Normalmente, las funciones de ventana personalizadas se utilizan en una serie temporal, donde el elemento visual muestra una métrica y un campo de fecha.

Las funciones de ventana no son compatibles con las versiones de MySQL anteriores a la 8 y con las versiones de MariaDB anteriores a la 10.2.

## Sintaxis
<a name="windowCount-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
windowCount
	(
	     measure_or_dimension 
            , [sort_order_field ASC/DESC, ...]
            , start_index
            , end_index
	     ,[ partition_field, ... ] 
	)
```

## Argumentos
<a name="windowCount-function-arguments"></a>

*medida o dimensión*   
La métrica agregada para la que desea obtener el promedio, por ejemplo, `sum({Revenue})`.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*índice de comienzo*   
El índice de comienzo es un número entero positivo, que indica *n* filas por encima de la fila actual. El índice de comienzo cuenta los puntos de datos disponibles por encima de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

*índice final*   
El índice final es un número entero positivo, que indica *n* filas por debajo de la fila actual. El índice final cuenta los puntos de datos disponibles por debajo de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="windowCount-function-example"></a>

En el siguiente ejemplo, se calcula el recuento móvil de `sum(Revenue)` particionado por `SaleDate`. El cálculo incluye tres filas por encima y dos por debajo de la fila actual.

```
windowCount
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     3,
               2
	)
```

# windowMax
<a name="windowMax-function"></a>

La función `windowMax` calcula el máximo de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados. Normalmente, las funciones de ventana personalizadas se utilizan en una serie temporal, donde el elemento visual muestra una métrica y un campo de fecha. Puede utilizar `windowMax` como ayuda para identificar el máximo de la métrica durante un periodo de tiempo.

Las funciones de ventana no son compatibles con las versiones de MySQL anteriores a la 8 y con las versiones de MariaDB anteriores a la 10.2.

## Sintaxis
<a name="windowMax-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
windowMax
	(
	     measure 
            , [sort_order_field ASC/DESC, ...]
            , start_index
            , end_index
	     ,[ partition_field, ... ] 
	)
```

## Argumentos
<a name="windowMax-function-arguments"></a>

*measure*   
La métrica agregada para la que desea obtener el promedio, por ejemplo, `sum({Revenue})`.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*índice de comienzo*   
El índice de comienzo es un número entero positivo, que indica *n* filas por encima de la fila actual. El índice de comienzo cuenta los puntos de datos disponibles por encima de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

*índice final*   
El índice final es un número entero positivo, que indica *n* filas por debajo de la fila actual. El índice final cuenta los puntos de datos disponibles por debajo de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="windowMax-function-example"></a>

En el siguiente ejemplo se calcula el máximo de los últimos 12 meses de `sum(Revenue)`, particionado por `SaleDate`. El cálculo incluye 12 filas por encima y 0 por debajo de la fila actual.

```
windowMax
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     12,
               0
	)
```

Los resultados de este ejemplo de los últimos 12 meses se muestran en la siguiente captura de pantalla. El campo sum(Revenue) se añade al gráfico para mostrar la diferencia entre los ingresos y los ingresos máximos de los últimos 12 meses.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/windowMax.png)


# windowMin
<a name="windowMin-function"></a>

La función `windowMin` calcula el mínimo de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados. Normalmente, las funciones de ventana personalizadas se utilizan en una serie temporal, donde el elemento visual muestra una métrica y un campo de fecha. Puede utilizar `windowMin` como ayuda para identificar el mínimo de la métrica durante un periodo de tiempo.

Las funciones de ventana no son compatibles con las versiones de MySQL anteriores a la 8 y con las versiones de MariaDB anteriores a la 10.2.

## Sintaxis
<a name="windowMin-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
windowMin
	(
	     measure 
            , [sort_order_field ASC/DESC, ...]
            , start_index
            , end_index
	     ,[ partition_field, ... ] 
	)
```

## Argumentos
<a name="windowMin-function-arguments"></a>

*measure*   
La métrica agregada para la que desea obtener el promedio, por ejemplo, `sum({Revenue})`.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*índice de comienzo*   
El índice de comienzo es un número entero positivo, que indica *n* filas por encima de la fila actual. El índice de comienzo cuenta los puntos de datos disponibles por encima de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

*índice final*   
El índice final es un número entero positivo, que indica *n* filas por debajo de la fila actual. El índice final cuenta los puntos de datos disponibles por debajo de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="windowMin-function-example"></a>

En el siguiente ejemplo se calcula el mínimo de los últimos 12 meses de `sum(Revenue)`, particionado por `SaleDate`. El cálculo incluye 12 filas por encima y 0 por debajo de la fila actual.

```
windowMin
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     12,
               0
	)
```

Los resultados de este ejemplo de los últimos 12 meses se muestran en la siguiente captura de pantalla. El campo sum(Revenue) se añade al gráfico para mostrar la diferencia entre los ingresos y los ingresos mínimos de los últimos 12 meses.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/windowMin.png)


# windowSum
<a name="windowSum-function"></a>

La función `windowSum` calcula la suma de la medida agregada en una ventana personalizada que está dividida y ordenada por atributos especificados. Normalmente, las funciones de ventana personalizadas se utilizan en una serie temporal, donde el elemento visual muestra una métrica y un campo de fecha. 

Las funciones de ventana no son compatibles con las versiones de MySQL anteriores a la 8 y con las versiones de MariaDB anteriores a la 10.2.

## Sintaxis
<a name="windowSum-function-syntax"></a>

Los corchetes son obligatorios. Para ver qué argumentos son opcionales, consulte las siguientes descripciones.

```
windowSum
	(
	     measure 
            , [sort_order_field ASC/DESC, ...]
            , start_index
            , end_index
	     ,[ partition_field, ... ] 
	)
```

## Argumentos
<a name="windowSum-function-arguments"></a>

*measure*   
La métrica agregada para la que desea obtener la suma, por ejemplo, `sum({Revenue})`.   
Para los motores MySQL, MariaDB y Amazon Aurora con compatibilidad con MySQL, el índice de búsqueda se limita a tan solo 1. Las funciones de ventana no son compatibles con las versiones de MySQL anteriores a la 8 y con las versiones de MariaDB anteriores a la 10.2.

*atributo de orden*   
Una o más campos agregados, ya sea medidas, dimensiones o ambos, por los que desea ordenar los datos, separadas por comas. Puede especificar un orden de clasificación ascendente (**ASC**) o descendente (**DESC**).   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

*índice de comienzo*   
El índice de comienzo es un número entero positivo, que indica *n* filas por encima de la fila actual. El índice de comienzo cuenta los puntos de datos disponibles por encima de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

*índice final*   
El índice final es un número entero positivo, que indica *n* filas por debajo de la fila actual. El índice final cuenta los puntos de datos disponibles por debajo de la fila actual, en lugar de contar los periodos de tiempo reales. Si los datos están dispersos (por ejemplo, si faltan meses o años), ajuste los índices en consecuencia. 

 *partition field*   
(Opcional) Una o más dimensiones por las que desea realizar particiones, separadas por comas.   
Cada campo en la lista está entre \$1\$1 (llaves), si se trata de más de una palabra. Toda la lista se encuentra entre [ ] (corchetes).

## Ejemplo
<a name="windowSum-function-example"></a>

En el siguiente ejemplo, se calcula la suma acumulada de `sum(Revenue)`, ordenada por `SaleDate`. El cálculo incluye dos filas por encima y una por delante de la fila actual.

```
windowSum
	(
	     sum(Revenue), 
	     [SaleDate ASC],
	     2,
            1
	)
```

En el ejemplo siguiente se muestra una suma de 12 meses finales. 

```
windowSum(sum(Revenue),[SaleDate ASC],12,0)
```

Los resultados de este ejemplo de suma de doce meses finales se muestran en la siguiente captura de pantalla. El campo `sum(Revenue)` se añade al gráfico para mostrar la diferencia entre los ingresos y la suma de 12 meses finales de los ingresos.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/windowSum.png)


# Unir datos
<a name="joining-data"></a>

Puede usar la interfaz de unión de Amazon Quick Sight para unir objetos de una o más fuentes de datos. Al utilizar Amazon Quick Sight para unir los datos, puede combinar datos dispares sin duplicar los datos de distintas fuentes. 

## Tipos de conjuntos de datos unidos
<a name="join-dataset-types"></a>

Se realiza una unión entre dos *tablas lógicas* de Quick Sight, donde cada tabla lógica contiene información sobre cómo obtener datos. Al editar un conjunto de datos en Quick Sight, el diagrama de unión de la mitad superior de la página muestra cada tabla lógica como un bloque rectangular.

Hay dos tipos diferentes de conjuntos de datos unidos en Quick Sight: de la misma fuente y de fuentes cruzadas. Un conjunto de datos se considera del mismo origen cuando no tiene ninguna unión o cuando se cumplen todas las condiciones siguientes:
+ Si alguna de las tablas lógicas hace referencia a una fuente de datos de Quick Sight:
  + Todas las tablas lógicas de este conjunto de datos deben hacer referencia a la misma fuente de datos de Quick Sight. Esto no se aplica si dos fuentes de datos de Quick Sight distintas hacen referencia a la misma base de datos subyacente. Debe ser exactamente la misma fuente de datos de Quick Sight. Para obtener más información sobre el uso de un único origen de datos, consulte [Creación de un conjunto de datos utilizando un origen de datos existente](create-a-data-set-existing.md).
+ Si alguna de las tablas lógicas hace referencia a un conjunto de datos de Quick Sight que es un conjunto de datos principal:
  + El conjunto de datos principal debe utilizar una consulta directa.
  + El conjunto de datos principal debe hacer referencia a la misma fuente de datos de Quick Sight.

Si no se cumplen las condiciones anteriores, el conjunto de datos se considera una unión entre orígenes. 

## Información sobre la unión de conjuntos de datos
<a name="join-faqs"></a>

Tanto las uniones de un conjunto de datos del mismo origen como las de orígenes cruzados tienen las siguientes limitaciones.

### ¿Cuál es la cantidad máxima de tablas que puede contener un conjunto de datos unido?
<a name="w2aac35c13c25b9b9b5"></a>

Todos los conjuntos de datos unidos pueden contener hasta 32 tablas.

### ¿Qué tamaño pueden tener los datos unidos?
<a name="w2aac35c13c25b9b9b7"></a>

El tamaño máximo permitido de una unión viene determinado por el modo de consulta y el motor de consulta que se utilice. La siguiente lista proporciona información sobre los diferentes límites de tamaño de las tablas que se van a unir. El límite de tamaño se aplica a todas las tablas secundarias combinadas. No hay límites de tamaño de unión para la tabla principal.
+ **Tablas de la misma fuente**: cuando las tablas se originan a partir de una única fuente de datos de consulta, Quick Sight no impone restricciones al tamaño de la unión. Esto no anula las limitaciones de tamaño de las uniones que pueda tener el motor de consultas de origen.
+ **Conjuntos de datos de orígenes distintos**: este tipo de unión contiene tablas de diferentes orígenes de datos que no están almacenadas en SPICE. Para estos tipos de uniones, Quick Sight identifica automáticamente la tabla más grande del conjunto de datos. El tamaño combinado de todas las demás tablas secundarias debe ser inferior a 1 GB.
+ **Conjuntos de datos almacenados en SPICE**: este tipo de unión contiene tablas que están incorporadas en SPICE. El tamaño combinado de todas las tablas secundarias de esta unión no puede superar los 20 GB.

Para obtener más información sobre los cálculos de tamaño de conjuntos de datos de SPICE, consulte [Estimación del tamaño de los conjuntos de datos de SPICE](spice.md#spice-capacity-formula).

### ¿Puede un conjunto de datos unido utilizar la consulta directa?
<a name="w2aac35c13c25b9b9b9"></a>

Los conjuntos de datos del mismo origen admiten la consulta directa, siempre que no haya otras restricciones en cuanto al uso de la consulta directa. Por ejemplo, los orígenes de datos de S3 no admiten la consulta directa, por lo que un conjunto de datos de S3 del mismo origen debe utilizar SPICE igualmente.

Los conjuntos de datos de orígenes cruzados deben usar SPICE.

### ¿Se pueden usar los campos calculados en una combinación?
<a name="w2aac35c13c25b9b9c11"></a>

Todos los conjuntos de datos unidos pueden usar campos calculados, pero los campos calculados no se pueden usar en ninguna cláusula auxiliar.

### ¿Se pueden usar los datos geográficos en una unión?
<a name="w2aac35c13c25b9b9c13"></a>

Los conjuntos de datos del mismo origen admiten tipos de datos geográficos, pero los campos geográficos no se pueden usar en ninguna cláusula auxiliar.

Los conjuntos de datos de orígenes cruzados no admiten datos geográficos de ninguna forma.

Para ver algunos ejemplos de cómo unir tablas entre fuentes de datos, consulte la publicación [Cómo unir varias fuentes de datos en Amazon Quick Sight](https://aws.amazon.com/blogs/big-data/joining-across-data-sources-on-amazon-quicksight/) en el blog sobre AWS macrodatos. 

## Creación de una unión
<a name="create-a-join"></a>

Utilice el siguiente procedimiento para unir tablas para utilizarlas en un conjunto de datos. Antes de comenzar, importe o conecte a sus datos. Puede crear una unión entre cualquiera de las fuentes de datos compatibles con Amazon Quick Sight, excepto los datos de Internet de las cosas (IoT). Por ejemplo, puede añadir archivos de valores separados por comas (.csv), tablas, visualizaciones, consultas SQL u objetos JSON en un bucket de Amazon S3.

**Adición de una o más uniones**

1. Abra el conjunto de datos con el que desea trabajar.

1. (Opcional) Antes de empezar, decida si desea deshabilitar la vista previa generada automáticamente a partir de una muestra de sus datos. Para desactivarla, seleccione **Vista previa automática** en la parte superior derecha. Está activada de forma predeterminada.

1. Si aún no ha elegido un modo de consulta, elija **Modo de consulta**. 

   Elija **SPICE** para almacenar su conjunto de datos en [SPICE](spice.md), o elija **Consulta directa** para obtener datos en tiempo real en todo momento. Si el conjunto de datos contiene uno o más archivos cargados manualmente, el conjunto de datos se almacena automáticamente en SPICE.

   Si lo desea **SPICE**, los datos se incorporan a Quick Sight. Los elementos visuales que utilizan el conjunto de datos ejecutan consultas en SPICE, en lugar de en la base de datos.

   Si elige **Consulta directa**, los datos no se incorporan a SPICE. Los elementos visuales que utilizan el conjunto de datos ejecutan consultas en la base de datos en lugar de en SPICE. 

   Si elige el **Modo de consulta**, asegúrese de establecer claves únicas en la combinación, si corresponde, para mejorar el rendimiento al cargar elementos visuales.

1. En la página de preparación de datos, seleccione **Añadir datos**. 

1. En la página **Añadir datos** que se abre, elija una de las siguientes opciones y siga estos pasos: 
   + Agregue datos de un conjunto de datos:

     1. elija **Conjunto de datos**.

     1. Seleccione un conjunto de datos de la lista.

     1. Elija **Seleccionar**.
   + Agregue datos de un origen de datos:

     1. Elija **Origen de datos**.

     1. Seleccione un origen de datos de la lista.

     1. Elija **Seleccionar**.

     1. Seleccione una tabla de la lista.

     1. Elija **Seleccionar**.
   + Para crear uniones automáticas, añada una tabla varias veces. Aparece un contador después del nombre. Un ejemplo es **Producto**, **Producto (2)** y **Producto (3)**. Los nombres de campos en las secciones **Campos** o **Filtros** incluyen el mismo contador para que pueda saber de qué instancia de la tabla proviene un campo. 
   + Agregue un archivo nuevo seleccionando **Cargar un archivo** y, a continuación, elija el archivo que desee unir.

1. (Opcional) Seleccione **Usar consulta SQL personalizada** para abrir el editor de consultas y escribir una consulta para un origen de datos de SQL.

1. (Opcional) Tras añadir datos, interactúe con cada tabla seleccionando su icono de menú. Para reorganizar las tablas, arrástrelas y suéltelas. 

   Aparece un icono con puntos rojos para indicar que necesita configurar esta unión. Aparecen dos puntos rojos para las uniones que aún no están configuradas. Para crear uniones, elija el icono de configuración de la primera unión. 

1. (Opcional) Para cambiar una unión existente, vuelva a abrir **Configuración de Join** seleccionando el icono de unión entre dos tablas. 

   Se abre el panel **Configuración de Join**. En la interfaz de unión, especifique el tipo de unión y los campos que se van a utilizar para unir las tablas. 

1. En la parte inferior de la pantalla, puede ver opciones para establecer un campo de una tabla igual a un campo de otra tabla. 

   1. En la sección **Cláusulas de Join**, elija la columna de unión para cada tabla. 

     (Opcional) Si las tablas que ha seleccionado se unen en varias columnas, seleccione **Agregar una nueva cláusula de unión**. Al hacerlo añade otra fila a las cláusulas de unión, para poder especificar el siguiente conjunto de columnas que unir. Repita este proceso hasta que haya identificado todas las columnas de unión de los dos objetos de datos.

1. En el panel **Configuración de Join**, elija el tipo de unión que desee aplicar. Si los campos de unión son una clave única para una o ambas tablas, active la configuración de clave única. Las claves únicas solo se aplican a las consultas directas, no a los datos de SPICE. 

   Para obtener más información sobre las uniones, consulte [Tipos de combinación](#join-types).

1. Elija **Aplicar** para confirmar su elecciones. 

   Para cancelar sin realizar cambios, seleccione **Cancelar**.

1. El icono de unión del espacio de trabajo cambia para mostrar la nueva relación.

1. (Opcional) En la sección **Campos**, puede usar el menú de cada campo para realizar una o varias de las siguientes acciones:
   + **Agregar una jerarquía** a un campo geoespacial. 
   + **Incluir** o **excluir** el campo.
   + **Editar el nombre y la descripción** del campo.
   + **Cambiar el tipo de datos**.
   + **Añadir un cálculo** (un campo calculado).
   + **Restringir el acceso solo a mí**, para que solo usted pueda verlo. Esto puede resultar útil cuando se agregan campos a un conjunto de datos que ya está en uso.

1. (Opcional) En la sección **Filtros**, puede añadir o editar filtros. Para obtener más información, consulte [Filtrado de datos en Amazon Quick Sight](adding-a-filter.md).

## Tipos de combinación
<a name="join-types"></a>

Amazon Quick Sight admite los siguientes tipos de uniones:
+ Uniones internas
+ Uniones externas izquierda y derecha
+ Uniones externas completas

Examinemos en mayor profundidad qué hacen con sus datos estos tipos de uniones. Para nuestros datos de ejemplo, estamos usando las siguientes tablas denominadas `widget` y `safety rating`. 

```
SELECT * FROM safety-rating

rating_id	safety_rating
1		    A+
2		    A
3		    A-
4		    B+
5		    B

SELECT * FROM WIDGET

widget_id	   widget	safety_rating_id
1		    WidgetA		3
2		    WidgetB		1
3		    WidgetC		1
4		    WidgetD		2
5		    WidgetE
6		    WidgetF		5
7		    WidgetG
```

### Uniones internas
<a name="join-inner"></a>

Utilice una combinación interna cuando desee ver solo los datos en los que haya coincidencias entre dos tablas. Por ejemplo, suponga que realiza una unión interior en las tablas **safety-rating** y **widget**.

En el conjunto de resultados siguiente, se eliminan los widgets sin calificaciones de seguridad y se eliminan las calificaciones de seguridad que no están asociadas con ningún widget. Solo se incluyen las filas que coinciden perfectamente.

```
SELECT * FROM safety-rating
INNER JOIN widget
ON safety_rating.rating_id = widget.safety_rating_id

rating_id    safety_rating    widget_id    widget        safety_rating_id
3	        A-                1        WidgetA        3
1	        A+                2        WidgetB        1
1	        A+                3        WidgetC        1
2	        A                 4        WidgetD        2
5	        B                 6        WidgetF        5
```

### Uniones externas izquierda y derecha
<a name="join-left-or-right"></a>

Se denominan también uniones externas izquierda o derecha. Utilice una combinación externa izquierda o derecha cuando desee ver todos los datos de una tabla y solo las filas coincidentes de la otra tabla. 

En una interfaz gráfica, puede ver qué tabla está a la derecha o la izquierda. En una instrucción SQL, la primera tabla se considera que está a la izquierda. Por lo tanto, elegir una unión exterior izquierda en lugar de una unión exterior derecha sólo depende de cómo se hayan dispuesto las tablas en la herramienta de consulta.

Por ejemplo, supongamos que realiza una unión exterior izquierda en `safety-rating` (la tabla de la izquierda) y `widgets` (la tabla de la derecha). En este caso, se devuelven todas las filas de `safety-rating` y solo se devuelven las filas de `widget` coincidentes. Puede ver espacios en blanco en el conjunto de resultados donde no hay datos coincidentes.

```
SELECT * FROM safety-rating
LEFT OUTER JOIN widget
ON safety_rating.rating_id = widget.safety_rating_id

rating_id    safety_rating    widget_id   widget          safety_rating_id
1	        A+                2        WidgetB   	1
1	        A+                3        WidgetC   	1
2	        A                 4        WidgetD   	2
3	        A-                1        WidgetA   	3
4	        B+
5	        B                 6        WidgetF   	5
```

Si, por el contrario, utilizas una combinación exterior derecha, llama a las tablas en el mismo orden, `safety-rating` es decir, a la izquierda y `widgets` a la derecha. En este caso, se devuelven solo las filas de `safety-rating` coincidentes y todas las filas de `widget`. Puede ver espacios en blanco en el conjunto de resultados donde no hay datos coincidentes.

```
SELECT * FROM safety-rating
RIGHT OUTER JOIN widget
ON safety_rating.rating_id = widget.safety_rating_id

rating_id    safety_rating    widget_id   widget          safety_rating_id
3	        A-                1	WidgetA   	 3
1	        A+                2	WidgetB   	 1
1	        A+                3	WidgetC   	 1
2	        A                 4	WidgetD   	 2
                                  5       WidgetE
5	        B                 6	WidgetF   	 5
                                  7       WidgetG
```

### Uniones externas completas
<a name="join-full-outer"></a>

En ocasiones se denominan solo uniones exteriores, pero este término puede hacer referencia a unión exterior izquierda, unión exterior derecha o unión exterior completa. Para definir el significado, utilizamos el nombre completo: unión exterior completa. 

Usa una combinación externa completa para ver los datos que coinciden, además de los datos de ambas tablas que no coinciden. Este tipo de unión incluye todas las filas de ambas tablas. Por ejemplo, si realiza una unión exterior completa en las tablas `safety-rating` y `widget`, se devuelven todas las filas. Las filas están alineadas donde coinciden y todos los datos adicionales se incluyen en filas distintas. Puede ver espacios en blanco en el conjunto de resultados donde no hay datos coincidentes.

```
SELECT * FROM safety-rating
FULL OUTER JOIN widget
ON safety_rating.rating_id = widget.safety_rating_id

rating_id    safety_rating    widget_id   widget         safety_rating_id
1	        A+                2	WidgetB   	1
1	        A+                3	WidgetC   	1
2	        A                 4	WidgetD   	2
3	        A-                1	WidgetA   	3
4	        B+
5	        B                 6	WidgetF   	5
                                  5	WidgetE
                                  7	WidgetG
```

# Preparación de campos de datos para su análisis en Amazon Quick Sight
<a name="preparing-data-fields"></a>

Antes de empezar a analizar y visualizar los datos, puede preparar los campos (columnas) del conjunto de datos para su análisis. Puede editar los nombres y las descripciones de los campos, cambiar el tipo de datos de los campos, configurar jerarquías detalladas para los campos y mucho más.

Use los siguientes temas para preparar los campos de su conjunto de datos.

**Topics**
+ [Edición de nombres y descripciones de los campos](changing-a-field-name.md)
+ [Configuración de campos como dimensiones o medidas](setting-dimension-or-measure.md)
+ [Cambio del tipo de datos de un campo](changing-a-field-data-type.md)
+ [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md)
+ [Selección de campos](selecting-fields.md)
+ [Organizar campos en carpetas en Amazon QuickSight](organizing-fields-folder.md)
+ [Asignación y unión de campos](mapping-and-joining-fields.md)

# Edición de nombres y descripciones de los campos
<a name="changing-a-field-name"></a>

Puede cambiar cualquier nombre y descripción del campo que proporciona el origen de datos. Si cambia el nombre de un campo utilizado en un campo calculado, asegúrese de cambiarlo también en la función de campo calculado. De no hacerlo, la función dará error.

**Cambio del nombre o la descripción de un campo**

1. En el panel **Campos** de la página de preparación de datos, elija el icono de tres puntos del campo que desee cambiar. A continuación, seleccione **Editar nombre y descripción**.

1. Introduzca el nombre o la descripción nuevos que desea cambiar y seleccione **Aplicar**.

También puede cambiar el nombre y la descripción de un campo en la página de preparación de datos. Para ello, seleccione el encabezado de columna del campo que desea cambiar en la tabla **Conjunto de datos** en la mitad inferior de esa página. A continuación, realice allí los cambios que desee.

# Configuración de campos como dimensiones o medidas
<a name="setting-dimension-or-measure"></a>

En el panel **Lista de campos**, los campos de dimensión tienen iconos azules y los de medida, verdes. Las *dimensiones* son campos de texto o de fecha que pueden ser elementos, como productos o atributos relacionados con las medidas. Puede utilizar dimensiones para particionar estos elementos o atributos, como la fecha de venta para las cifras de ventas. Las *medidas* son valores numéricos que se utilizan para la medición, la comparación y la agregación. 

En algunos casos, Quick Sight interpreta un campo como una medida que se quiere usar como dimensión (o al revés). En este caso, puede cambiar la configuración de ese campo.

Al cambiar la configuración de dimensión o medida de un campo, se cambia para todos los elementos visuales del análisis que utilizan ese conjunto de datos. Sin embargo, no lo cambia en el propio conjunto de datos.

## Cambio de la configuración de dimensión o medida de un campo
<a name="change-dimension-or-measure"></a>

Utilice el siguiente procedimiento para cambiar la configuración de dimensión o medida de un campo

**Cambio de la configuración de dimensión o medida de un campo**

1. En el panel **Lista de campos**, coloque el cursor sobre el campo que desea cambiar.

1. Elija el icono selector que aparece a la derecha del nombre del campo y, a continuación, elija **Convertir en dimensión** o **Convertir en medida**, según proceda.

# Cambio del tipo de datos de un campo
<a name="changing-a-field-data-type"></a>

Cuando Quick Sight recupera datos, asigna a cada campo un tipo de datos en función de los datos del campo. Los tipos posibles de datos son los siguientes:
+ Fecha: el tipo de datos de fecha se utiliza para los datos de fecha en un formato compatible. Para obtener información sobre los formatos de fecha que admite Quick Sight, consulte. [Cuotas de origen de datos](data-source-limits.md)
+ Decimal: el tipo de datos decimal se utiliza para datos numéricos que requieren uno o más decimales de precisión, por ejemplo, 18,23. El tipo de datos decimal admite valores con hasta cuatro decimales a la derecha del punto decimal. Los valores que tienen una escala superior a esta se truncan al cuarto decimal en dos casos. Una es cuando estos valores se muestran en la preparación o el análisis de los datos, y la otra es cuando se importan a Quick Sight. Por ejemplo, 13.00049 se trunca en 13.0004.
+ Geoespacial: el tipo de datos geoespaciales se utiliza para datos geoespaciales, por ejemplo, la longitud y la latitud, o las ciudades y los países.
+ Entero: el tipo de datos enteros se utiliza para los datos numéricos que contengan únicamente valores enteros, por ejemplo, 39.
+ Cadena: este tipo de datos se utiliza con datos alfanuméricos que no son fechas.

Quick Sight lee una pequeña muestra de filas de la columna para determinar el tipo de datos. El tipo de datos que aparece con mayor frecuencia en la muestra pequeña es el tipo sugerido. En algunos casos, es posible que haya valores en blanco (tratados como cadenas por Quick Sight) en una columna que contenga principalmente números. En estos casos, es posible que el tipo de datos de cadena sea el tipo más frecuente en el conjunto de filas de muestra. Puede modificar manualmente el tipo de datos de la columna para convertirla en un número entero. Utilice los siguientes procedimientos para obtener información sobre cómo hacerlo.

## Cambio del tipo de datos de un campo durante la preparación de los datos
<a name="changing-a-field-data-type-prep"></a>

Durante la preparación de los datos, puede cambiar el tipo de datos de cualquier campo del origen de datos. En el menú **Cambiar tipos de datos**, puede cambiar los campos calculados que no incluyan agregaciones a tipos geoespaciales. Puede realizar otros cambios en el tipo de datos de un campo calculado modificando su expresión directamente. Quick Sight convierte los datos del campo según el tipo de datos que elija. Las filas que contienen datos que no son compatibles con ese tipo de datos se omiten. Por ejemplo, suponga que convierte el siguiente campo de cadena a entero.

```
10020
36803
14267a
98457
78216b
```

Todos los registros que contengan caracteres alfabéticos en este campo se omitirán, como se muestra seguidamente.

```
10020
36803
98457
```

Si tiene un conjunto de datos de base de datos con campos cuyos tipos de datos no son compatibles con Quick Sight, utilice una consulta SQL durante la preparación de los datos. A continuación, use los comandos `CAST` o `CONVERT` (según sea compatible con la base de datos de origen) para cambiar los tipos de datos de campo. Para obtener más información acerca de la adición de una consulta SQL durante la preparación de los datos, consulte [Uso de SQL para personalizar los datos](adding-a-SQL-query.md). Para obtener más información sobre cómo Quick Sight interpreta los distintos tipos de datos de origen, consulte[Tipos de datos compatibles de orígenes de datos externos](supported-data-types-and-values.md#supported-data-types).

Es posible que tenga campos numéricos que actúen como dimensiones en lugar de métricas, por ejemplo, códigos postales y la mayoría de los números de identificación. En esos casos, resulta útil darles un tipo de datos de cadena durante la preparación de los datos. De este modo, Quick Sight comprenderá que no son útiles para realizar cálculos matemáticos y que solo se pueden agregar con la `Count` función. Para obtener más información sobre cómo Quick Sight utiliza las dimensiones y las medidas, consulte[Configuración de campos como dimensiones o medidas](setting-dimension-or-measure.md).

En [SPICE](spice.md), los números convertidos de valor numérico a entero se truncan de forma predeterminada. Si en lugar de truncar los números desea redondearlos, puede crear un campo calculado con la función [`round`](round-function.md). Para ver si los números se redondean o se truncan antes de introducirlos en SPICE, compruebe el motor de base de datos.

**Cambio del tipo de datos de un campo durante la preparación de los datos**

1. En la página de inicio de Quick Sight, selecciona **Datos** a la izquierda. En la pestaña **Datos**, elija el conjunto de datos que desee y, a continuación, elija **Editar conjunto de datos**.

1. En el panel de vista previa de los datos, elija el icono de tipo de datos del campo que desee cambiar.

1. Elija el tipo de datos de destino. Solo aparecen los tipos de datos que no sean los que se utilicen en ese momento.

## Cambio del tipo de datos de un campo en un análisis
<a name="changing-an-analysis-field-data-type"></a>

En el contexto de un análisis, se pueden cambiar los tipos de datos de campos numéricos mediante el panel **Lista de campos**, los cuadros del campo de elementos visuales o los editores visuales. De manera predeterminada, los campos numéricos se muestran como números, pero también se pueden mostrar como divisa o como porcentaje. No se pueden cambiar los tipos de datos de campos de cadena o fecha.

Al cambiar el tipo de datos de un campo en un análisis, se cambia para todos los elementos visuales del análisis que utilizan ese conjunto de datos. Sin embargo, no lo cambia en el propio conjunto de datos.

**nota**  
Si está trabajando en un elemento visual de tabla dinámica, la aplicación de un cálculo de tabla cambia el tipo de datos de los valores de la celda en algunos casos. Este tipo de cambio se produce si el tipo de datos no tiene sentido con el cálculo aplicado.   
Por ejemplo, suponga que aplica la función `Rank` a un campo numérico que ha modificado para utilizar un tipo de datos de divisa. En este caso, los valores de la celda se muestran como números en lugar de divisa. De igual forma, si aplica la función `Percent difference`, los valores de la celda se muestran como porcentajes en lugar de divisas. 

**Cambio del tipo de datos de un campo**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, coloque el cursor sobre el campo numérico que desea cambiar. A continuación, elija el icono selector situado a la derecha del nombre del campo.
   + En cualquier elemento visual que contenga un editor visual asociado al campo numérico que desea cambiar, elija ese editor visual.
   + Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado al campo numérico que desea cambiar.

1. Elija **Mostrar como** y, a continuación, seleccione **Número**, **Divisa** o **Porcentaje**.

# Añadir desgloses a los datos visuales en Quick Sight
<a name="adding-drill-downs"></a>

Todos los tipos de elementos visuales, excepto las tablas dinámicas, ofrecen la posibilidad de crear una jerarquía de campos para un elemento visual. La jerarquía le permite desglosarlos para ver los datos en diferentes niveles de la jerarquía. Por ejemplo, puede asociar los campos de país, estado y ciudad al eje x en un gráfico de barras. A continuación, puede desglosar en sentido descendente o ascendente para ver los datos en cada uno de esos niveles. A medida que se va desglosando de un nivel a otro, el valor del campo por el que se desglosa restringe los datos mostrados. Por ejemplo, si desglosa hasta el estado de California, verá los datos de todas las ciudades de California.

Los cuadros de campo que puede utilizar para crear desgloses varían en función del tipo de elemento visual. Consulte el tema de cada elemento visual para obtener más información sobre su compatibilidad con los desgloses. 

La funcionalidad de desglose se añade automáticamente para las fechas al asociar un campo de fecha con el cuadro de campo de desglose de un elemento visual. En este caso, siempre puede desglosar subiendo o bajando a través de los niveles de grado de detalle de la fecha. La funcionalidad de desglose también se agrega automáticamente para las agrupaciones geoespaciales, una vez que se han definido en el conjunto de datos.

Utilice la siguiente tabla para identificar los cuadros de campo/editores visuales que admiten el desglose para cada tipo de elemento visual.


****  

| Tipo de elemento visual | Cuadro de campo o editor visual | 
| --- | --- | 
| Gráficos de barras (todas horizontales) | Eje Y y Grupo/color | 
| Gráficos de barras (todas verticales) | Eje X y Grupo/color | 
| Gráficos combinados (todos) | Eje X y Grupo/color | 
| Gráficos geoespaciales | Geoespacial y Color | 
| Mapa térmico | Filas y Columnas | 
| KPIs | Grupo de tendencias | 
| Gráficos de líneas (todos) | Eje X y Color | 
| Gráfico circular | Grupo/color | 
| Gráfico de dispersión | Grupo/color | 
| Gráfico de rectángulos | Agrupar por | 

**importante**  
No se admiten desgloses en las tablas ni en las tablas dinámicas.

## Añadir un desglose
<a name="add-drill-downs"></a>

Utilice el siguiente procedimiento para añadir niveles de desglose a un elemento visual.

**Adición de niveles de desglose a un elemento visual**

1. En la página de análisis, elija el elemento visual al que desea añadir desgloses.

1. Arrastre un elemento de campo a un **Cuadro de campo**.

1. Si el conjunto de datos tiene una jerarquía definida, puede arrastrar la jerarquía completa en el cuadro de campo a la vez. Un ejemplo son los datos geoespaciales o de coordenadas. En este caso, no es necesario seguir los pasos restantes.

   Si no dispone de una jerarquía predefinida, puede crear una en su análisis, tal y como se describe en los pasos restantes.

1. Arrastre un campo que desee utilizar en el desglose de jerarquía al cuadro de campo adecuado, en función del tipo de elemento visual. Asegúrese de que la etiqueta del campo arrastrado indique **Añadir capa de desglose**. Coloque el campo arrastrado por encima o por debajo del campo existente en función de dónde desea que se encuentre dentro de la jerarquía que está creando. 

1. Continúe hasta que haya añadido todos los niveles de jerarquía que desea. Para eliminar un campo de la jerarquía, elija el campo y seleccione **Eliminar**.

1. Para desglosar en sentido descendente o ascendente para ver los datos en un nivel diferente de la jerarquía, elija un elemento en el elemento visual (como una línea o una barra) y, a continuación, seleccione **Bajar hasta <nivel inferior>** o **Subir hasta <nivel superior>**. En este ejemplo, desde el nivel `car-make` puede desglosar en sentido descendente `car-model` para ver datos en ese nivel. Si hace un desglose en sentido descendente hasta `car-model` desde la ** **Ford`car-make`, verá solo `car-model`s de esa marca de automóviles.

   Después de desglosar en sentido descendente hasta el nivel `car-model`, puede continuar bajando aún más para consultar los datos de `make-year` o ir en sentido ascendente hasta `car-make`. Si desglosa en sentido descendente hasta `make-year` desde la barra que representa **Ranger**, verá solo años para ese modelo de automóvil.

# Selección de campos
<a name="selecting-fields"></a>

Al preparar los datos, puede seleccionar uno o más campos para realizar una acción en ellos, como excluirlos o agregarlos a una carpeta.

Para seleccionar uno o más campos en el panel de preparación de datos, pulse o haga clic en el campo o en el panel **Campos** de la izquierda. A continuación, puede elegir el menú de campo (los tres puntos) situado a la derecha del nombre del campo y elegir la acción que desee realizar. La acción se realiza en todos los campos seleccionados.

Puede seleccionar o no todos los campos a la vez eligiendo **Todos** o **Ninguno** en la parte superior del panel **Campos**.

Si edita un conjunto de datos y excluye un campo que se utiliza en un elemento visual, dicho elemento visual deja de funcionar. Puede solucionarlo la siguiente vez que abra ese análisis.

## Búsqueda de campos
<a name="searching-for-a-field-data-prep"></a>

Si tiene una lista de campos larga en el panel **Campos**, puede localizar un campo específico escribiendo un término de búsqueda en el cuadro **Buscar campos**. Aparecen todos los campos cuyos nombres contienen el término de búsqueda. 

La búsqueda no distingue entre mayúsculas y minúsculas y no admite el uso de comodines. Elija el icono de cancelar (**X**) que se encuentra a la derecha del campo de búsqueda para volver a visualizar todos los campos.

# Organizar campos en carpetas en Amazon QuickSight
<a name="organizing-fields-folder"></a>

Al preparar los datos en Quick Sight, puede usar carpetas para organizar los campos para varios autores de toda la empresa. Organizar los campos en carpetas y subcarpetas puede facilitar a los autores la búsqueda y la comprensión de los campos del conjunto de datos.

Puede crear carpetas mientras prepara un conjunto de datos o cuando lo edite. Para obtener más información sobre la creación de un nuevo conjunto de datos y su preparación, consulte [Creación de conjuntos de datos](creating-data-sets.md). Para obtener más información sobre la apertura de un conjunto de datos existente para la preparación de datos, consulte [Edición de conjuntos de datos](edit-a-data-set.md).

Mientras realizan un análisis, los autores pueden expandir y contraer las carpetas, buscar campos específicos dentro de las carpetas y ver las descripciones de las carpetas en el menú de carpeta. Las carpetas aparecen en la parte superior del panel **Campos** en orden alfabético.

## Creación de una carpeta
<a name="organizing-fields-folder-create"></a>

Utilice el siguiente procedimiento para crear una carpeta nueva en el panel **Campos**.

**Creación de una carpeta nueva**

1. En la página de preparación de datos, en el panel **Campos**, seleccione el icono de tres puntos y elija **Añadir a** la carpeta. 

   Para seleccionar más de un campo a la vez, pulse la tecla Ctrl mientras selecciona (tecla Cmd en Mac).

1. En la página **Agregar a la carpeta** que aparece, seleccione **Crear una carpeta nueva** e introduzca un nombre para la nueva carpeta.

1. Seleccione **Aplicar**.

La carpeta aparece en la parte superior del panel **Campos** con los campos que haya elegido en su interior. Los campos de las carpetas se organizan en orden alfabético.

## Crear una subcarpeta
<a name="organizing-fields-folder-subfolder"></a>

Para organizar aún más los campos de datos en el panel **Campos**, puede crear subcarpetas dentro de las carpetas principales. 

**Creación de una subcarpeta**

1. En la página de preparación de datos, en el panel **Campos**, seleccione el menú de un campo que ya esté en una carpeta y elija **Mover a la carpeta**.

1. En la página **Mover a la carpeta** que aparece, seleccione **Crear una carpeta nueva** e introduzca un nombre para la nueva carpeta.

1. Seleccione **Aplicar**.

La subcarpeta aparece dentro de la carpeta principal, en la parte superior de la lista de campos. Las subcarpetas se organizan en orden alfabético.

## Añadir campos a una carpeta existente
<a name="organizing-fields-folder-add"></a>

Utilice el siguiente procedimiento para agregar campos a una carpeta existente en el panel **Campos**.

**Adición de uno o más campos a una carpeta**

1. En la página de preparación de datos, en el panel **Campos**, seleccione los campos que desee añadir a una carpeta. 

   Para seleccionar más de un campo a la vez, pulse la tecla Ctrl mientras selecciona (tecla Cmd en Mac).

1. En el menú de campo, seleccione **Agregar a la carpeta**.

1. En la página **Agregar a la carpeta** que aparece, seleccione una carpeta en **Carpeta existente**.

1. Seleccione **Aplicar**.

El campo o los campos se añaden a la carpeta.

## Mover campos entre carpetas
<a name="organizing-fields-folder-move"></a>

Utilice el siguiente procedimiento para mover campos de una carpeta a otra en el panel **Campos**.

**Desplazamiento de campos entre carpetas**

1. En la página de preparación de datos, en el panel **Campos**, seleccione los campos que desee mover a otra carpeta. 

   Para seleccionar más de un campo a la vez, pulse la tecla Ctrl mientras selecciona (tecla Cmd en Mac).

1. En el menú de campo, seleccione **Mover a la carpeta**.

1. En la página **Mover a la carpeta** que aparece, seleccione una carpeta en **Carpeta existente**.

1. Seleccione **Aplicar**.

## Quitar campos de una carpeta
<a name="organizing-fields-folder-remove"></a>

Utilice el siguiente procedimiento para quitar campos de una carpeta en el panel **Campos**. Al quitar un campo de una carpeta, no se elimina el campo.

**Eliminación de campos de una carpeta**

1. En la página de preparación de datos, en el panel **Campos**, seleccione los campos que desee quitar.

1. En el menú de campo, seleccione **Eliminar de la carpeta**.

Los campos que ha seleccionado se quitan de la carpeta y se vuelven a colocar en la lista de campos en orden alfabético.

## Editar el nombre de una carpeta y añadir una descripción de la carpeta
<a name="organizing-fields-folder-edit"></a>

Puede editar el nombre o añadir una descripción de una carpeta para proporcionar contexto sobre los campos de datos que contiene. El nombre de la carpeta aparece en el panel **Campos**. Mientras realizan un análisis, los autores pueden leer la descripción de la carpeta al seleccionar el menú de carpeta en el panel **Campos**.

**Edición del nombre de una carpeta o edición o adición de una descripción a una carpeta**

1. En la página de preparación de datos, en el panel **Campos**, seleccione el menú de la carpeta que desee editar y elija **Editar nombre y descripción**.

1. En la página **Editar carpeta** que aparece, haga lo siguiente:
   + En **Nombre**, introduzca el nombre de la carpeta.
   + En **Descripción**, escriba una descripción de la carpeta.

1. Seleccione **Aplicar**.

## Mover carpetas
<a name="organizing-fields-folder-move-folder"></a>

Puede mover carpetas y subcarpetas a carpetas nuevas o existentes en el panel **Campos**. 

**Desplazamiento de una carpeta**

1. En la página de preparación de datos, en el panel **Campos**, seleccione **Mover carpeta** en el menú de la carpeta.

1. En la página **Mover carpeta** que aparece, haga lo siguiente: 
   + Seleccione **Crear una carpeta nueva** e introduzca un nombre para la carpeta.
   + En **Carpeta existente**, elija una carpeta.

1. Seleccione **Aplicar**.

La carpeta aparece dentro de la carpeta que eligió en el panel **Campos**.

## Eliminar carpetas del panel de campos
<a name="organizing-fields-folder-delete"></a>

Utilice el siguiente procedimiento para eliminar una carpeta del panel **Campos**.

**Eliminación de una carpeta**

1. En la página de preparación de datos, en el panel **Campos**, seleccione **Eliminar carpeta** en el menú de la carpeta.

1. En la página **¿Eliminar carpeta?** que aparece, elija **Eliminar**.

La carpeta se elimina del panel **Campos**. Los campos que ha seleccionado se eliminan de la carpeta y se vuelven a colocar en la lista de campos en orden alfabético. Al eliminar carpetas, no se excluyen los campos de la vista ni se eliminan campos del conjunto de datos.

# Asignación y unión de campos
<a name="mapping-and-joining-fields"></a>

Si utiliza diferentes conjuntos de datos juntos en Quick Sight, puede simplificar el proceso de mapear campos o unir tablas durante la etapa de preparación de los datos. Debería comprobar que los campos tengan el tipo de datos correcto y un nombre de campo adecuado. Sin embargo, si ya sabe qué conjuntos de datos se van a utilizar juntos, puede realizar un par de pasos adicionales para facilitar su trabajo más adelante. 

## Asignación de campos
<a name="mapping-and-joining-fields-automatic"></a>

Quick Sight puede mapear automáticamente campos entre conjuntos de datos en el mismo análisis. Los siguientes consejos pueden ayudar a Quick Sight a mapear automáticamente campos entre conjuntos de datos, por ejemplo, si está creando una acción de filtrado entre conjuntos de datos:
+ Nombres de campo coincidentes: los nombres de los campos deben coincidir exactamente, sin diferencias de mayúsculas o minúsculas, espaciados o signos de puntuación. Puede cambiar el nombre de los campos que describan los mismos datos, de modo que una asignación automática sea precisa.
+ Tipos de datos coincidentes: los campos deben tener el mismo tipo de datos para la asignación automática. Puede cambiar los tipos de datos mientras prepara los datos. Este paso también le da la oportunidad de descubrir si necesita filtrar cualquier dato que no sea el tipo de datos correcto.
+ Con campos calculados: puede utilizar campos calculados para crear un campo coincidente y darle el nombre y el tipo de datos correctos para la asignación automática.

**nota**  
Una vez que exista una asignación automática, puede cambiar el nombre de un campo sin interrumpir la asignación de campos. Sin embargo, si cambia el tipo de datos, la asignación se interrumpe.

Para obtener más información sobre la asignación de campos para acciones de filtro entre conjuntos de datos, consulte [Creación y edición de acciones personalizadas en Amazon Quick Sight](custom-actions.md).

## Unión de campos
<a name="mapping-and-joining-fields-manual"></a>

Puede crear uniones entre datos desde diferentes orígenes de datos, incluidos archivos o bases de datos. Los siguientes consejos pueden ayudarle a unir datos de diferentes archivos u orígenes de datos:
+ Nombres de campo similares: es más sencillo unir campos cuando se puede ver lo que debe coincidir; por ejemplo, **ID del pedido** e **id-pedido** parecen ser los mismos. Sin embargo, si uno es un pedido de trabajo, y el otro es un pedido de compra, es probable que los campos sean datos diferentes. Si es posible, asegúrese de que los archivos y tablas que desee unir tengan nombres de campo que aclaren qué datos contienen. 
+ Tipos de datos coincidentes: los campos deben tener el mismo tipo de datos para poder unirse a ellos. Asegúrese de que los archivos y tablas que desee unir tengan tipos de datos coincidentes en los campos de unión. No se puede utilizar un campo calculado para una unión. Además, no puede unir dos conjuntos de datos existentes. Cree el conjunto de datos unidos mediante el acceso directo directamente a los datos de origen.

Para obtener más información sobre cómo unir datos entre orígenes de datos, consulte [Unir datos](joining-data.md).

# Filtrado de datos en Amazon Quick Sight
<a name="adding-a-filter"></a>

Puede utilizar filtros para restringir los datos de un conjunto de datos o un análisis. Por ejemplo, puede crear un filtro en un campo de región que excluya los datos de una región concreta de un conjunto de datos. También puede agregar un filtro a un análisis, como un filtro en el intervalo de fechas que desee incluir en cualquier elemento visual del análisis.

Al crear un filtro en un conjunto de datos, ese filtro se aplica a todo el conjunto de datos. Todos los análisis y los paneles posteriores que se creen a partir de ese conjunto de datos contienen el filtro. Si alguien crea un conjunto de datos a partir de su conjunto de datos, el filtro también estará en el nuevo conjunto de datos.

Cuando crea un filtro en un análisis, ese filtro solo se aplica a ese análisis y a cualquier panel que publique desde él. Si alguien duplica su análisis, el filtro permanece en el nuevo análisis. En los análisis, puede limitar los filtros a un solo elemento visual, a algunos elementos visuales, a todos los elementos visuales que utilizan este conjunto de datos o a todos los elementos visuales aplicables.

Además, al crear filtros en un análisis, puede añadir un control de filtro al panel de control. Para obtener más información sobre los controles de filtro, consulte [Adición de controles de filtro a las hojas de análisis](filter-controls.md).

Cada filtro que cree se aplicará a un solo campo. Puede aplicar filtros a los campos normales y a los calculados.

Hay varios tipos de filtros que puede agregar a los conjuntos de datos y a los análisis. Para obtener más información sobre los tipos de filtros que puede agregar y algunas de sus opciones, consulte [Tipos de filtros en Amazon Quick](filtering-types.md).

Si crea varios filtros, todos los filtros del nivel superior se aplican juntos mediante la operación AND. Si agrupa los filtros añadiéndolos dentro de un filtro de nivel superior, los filtros del grupo se aplicarán usando la operación OR.

Amazon Quick Sight aplica todos los filtros habilitados al campo. Por ejemplo, suponga que hay un filtro de `state = WA` y otro filtro de `sales >= 500`. El conjunto de datos o el análisis solo contienen registros que cumplan ambos criterios. Si desactiva uno de ellos, solo se aplicará un filtro.

Asegúrese de que los diversos filtros que se aplican al mismo campo no se excluyan mutuamente.

Utilice las siguientes secciones para obtener información sobre cómo ver, agregar, editar y eliminar filtros.

**Topics**
+ [Visualización de los filtros existentes](viewing-filters-data-prep.md)
+ [Adición de filtros](add-a-filter-data-prep.md)
+ [Filtros y controles de hojas cruzadas](cross-sheet-filters.md)
+ [Tipos de filtros en Amazon Quick](filtering-types.md)
+ [Adición de controles de filtro a las hojas de análisis](filter-controls.md)
+ [Edición de filtros](edit-a-filter-data-prep.md)
+ [Habilitación o deshabilitación de filtros](disable-a-filter-data-prep.md)
+ [Eliminación de filtros](delete-a-filter-data-prep.md)

# Visualización de los filtros existentes
<a name="viewing-filters-data-prep"></a>

Al editar un conjunto de datos o abrir un análisis, puede ver los filtros existentes que se hayan creado. Utilice los siguientes procedimientos para obtener información sobre cómo hacerlo.

## Visualización de filtros en conjuntos de datos
<a name="viewing-filters-data-prep-datasets"></a>

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, selecciona **Datos** a la izquierda.

1. En la pestaña **Conjuntos de datos**, elija el conjunto de datos que desee y, a continuación, elija **Editar conjunto** de datos.

1. En la página de preparación de datos que se abre, elija **Filtros** en la parte inferior izquierda para expandir la sección **Filtros**.

   Todos los filtros que se apliquen al conjunto de datos aparecen aquí. Si un solo campo tiene varios filtros, se agrupan. Se muestran por fecha de creación, con el filtro más antiguo en la parte superior.

## Visualización de los filtros en los análisis
<a name="viewing-filters-data-prep-analyses"></a>

Utilice el siguiente procedimiento para ver los filtros de los análisis.

**Visualización de un filtro en un análisis**

1. En la página de inicio rápida, selecciona **Análisis**.

1. En la página **Análisis**, elija el análisis con el que desea trabajar.

1. En el análisis, elija el icono de **filtro** para abrir el panel de **filtros**.

   Todos los filtros aplicados al análisis aparecen aquí.

   La forma en que se define el ámbito de un filtro aparecerá en la parte inferior de cada filtro. Para obtener más información acerca del alcance de los filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

# Adición de filtros
<a name="add-a-filter-data-prep"></a>

Puede agregar filtros a un conjunto de datos o a un análisis. Utilice los siguientes procedimientos para obtener información sobre cómo hacerlo.

## Adición de filtros a conjuntos de datos
<a name="add-a-filter-data-prep-datasets"></a>

Utilice el siguiente procedimiento para agregar filtros a conjuntos de datos.

**Adición de un filtro a un conjunto de datos**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, selecciona **Datos** a la izquierda.

1. En la pestaña **Conjuntos de datos**, elija el conjunto de datos que desee y, a continuación, elija **Editar conjunto** de datos.

1. En la página de preparación de datos que se abre, elija **Agregar filtro** en la parte inferior izquierda y, a continuación, elija el campo que desee filtrar.

   El filtro se agregará al panel **Filtros**.

1. Elija el nuevo filtro en el panel para configurar el filtro. O bien, puede elegir los tres puntos situados a la derecha del nuevo filtro y elegir **Editar**.

   Según el tipo de datos del campo, las opciones para configurar el filtro varían. Para obtener más información sobre los tipos de filtros que puede crear y sus configuraciones, consulte [Tipos de filtros en Amazon Quick](filtering-types.md).

1. Cuando haya terminado, seleccione **Apply**.
**nota**  
La vista previa de datos solo muestra el resultado de los filtros combinados aplicados a las 1000 primeras filas. Si se filtran las 1000 primeras filas, no se mostrará ninguna en la vista previa. Esto ocurre incluso cuando no se filtran las filas después de las primeras 1000.

## Adición de filtros en los análisis
<a name="add-a-filter-data-prep-analyses"></a>

Utilice el siguiente procedimiento para agregar filtros a análisis.

**Adición de un filtro a un análisis**

1. Abre la [consola rápida.](https://quicksight.aws.amazon.com/)

1. En la página de inicio de Quick, selecciona **Análisis**.

1. En la página **Análisis**, elija el análisis con el que desea trabajar.

1. En el análisis, elija el icono de **filtro** para abrir el panel **Filtros** y, a continuación, seleccione **AÑADIR**.

1. Elija el nuevo filtro en el panel para configurarlo. O bien, puede elegir los tres puntos situados a la derecha del nuevo filtro y elegir **Editar**.

1. En el panel **Editar filtro** que se abre, en **Aplicado a**, elija una de las siguientes opciones.
   + **Elemento visual único**: el filtro se aplica solo al elemento seleccionado.
   + **Hoja única**: el filtro se aplica a una sola hoja.
   + **Hoja cruzada**: el filtro se aplica a varias hojas del conjunto de datos.

   Según el tipo de datos del campo, las opciones restantes para configurar el filtro varían. Para obtener más información sobre los tipos de filtros que puede crear y sus configuraciones, consulte [Tipos de filtros en Amazon Quick](filtering-types.md).

# Filtros y controles de hojas cruzadas
<a name="cross-sheet-filters"></a>

Los filtros y controles de hojas cruzadas son filtros que se aplican a todo el análisis, al panel o a varias hojas del análisis y el panel.

## Filtros
<a name="filters"></a>

**Creación de un filtro de hojas cruzadas**

1. Una vez que haya [agregado un filtro](https://docs.aws.amazon.com/quicksight/latest/user/add-a-filter-data-prep.html#add-a-filter-data-prep-analyses), actualice el ámbito del filtro a una hoja cruzada. De forma predeterminada, esto se aplica a todas las hojas del análisis.

1. Si se activa la casilla de verificación **Aplicar conjuntos de datos cruzados**, el filtro se aplicará a todos los elementos visuales de hasta 100 conjuntos de datos diferentes que se apliquen a todas las hojas incluidas en el ámbito del filtro.

1. Si desea personalizar las hojas a las que se aplica, elija el icono de hojas cruzadas. A continuación, podrá ver las hojas a las que está aplicado el filtro actualmente o activar la selección personalizada de hojas.

1. Al activar la **selección personalizada de hojas**, puede seleccionar las hojas a las que desea aplicar el filtro.

1. Siga los pasos que se indican en [Edición de filtros en los análisis](https://docs.aws.amazon.com/quicksight/latest/user/edit-a-filter-data-prep.html#edit-a-filter-data-prep-analyses). Los cambios se aplicarán a todos los filtros de todas las hojas que haya seleccionado. Esto incluye las hojas recién agregadas si el ámbito del filtro abarca a todo el análisis.

**Eliminación de un filtro de hojas cruzadas**

**Eliminando**

Si no ha creado ningún control a partir de estos filtros, consulte [Eliminación de filtros en los análisis](https://docs.aws.amazon.com/quicksight/latest/user/delete-a-filter-data-prep.html#delete-a-filter-data-prep-analyses).

Si ha creado controles, entonces:

****

1. Siga las instrucciones que aparecen en [Eliminación de filtros en los análisis](https://docs.aws.amazon.com/quicksight/latest/user/delete-a-filter-data-prep.html#delete-a-filter-data-prep-analyses).

1. Si selecciona **Eliminar filtros y controles**, los controles se eliminarán de todas las páginas. Esto puede afectar al diseño del análisis. Si lo prefiere, puede eliminar estos controles de forma individual. 

**Reducción del ámbito**

Si desea eliminar un filtro de hojas cruzadas, también puede hacerlo cambiando el ámbito del filtro:

****

1. Siga las instrucciones de [Edición de filtros en los análisis](https://docs.aws.amazon.com/quicksight/latest/user/edit-a-filter-data-prep.html#edit-a-filter-data-prep-analyses) para acceder al filtro. 

1. Una de las modificaciones que puede realizar es cambiar el ámbito. Puede cambiar a **Hoja única** o **Elemento visual único**. También puede eliminar una hoja de la selección de hojas cruzadas.

   O bien, la selección de hojas personalizada:  
![\[Esta es una imagen de Eliminar filtro en Quick Sight.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/cross-sheet-7.png)

1. Si hay controles, verá un modal que le avisará de que va a eliminar de forma masiva los controles de cualquiera de las hojas en las que ya no se aplique el filtro, lo que puede afectar al diseño. También puede eliminar los controles de forma individual. Para obtener más información, consulte [Eliminación de un control de hojas cruzadas](#cross-sheet-removing-control).

1. Si agrega controles a la **Parte superior de todas las hojas del filtro**, se agregarán nuevas hojas de forma predeterminada con este nuevo control si el ámbito del filtro abarca a todo el análisis.

## Controles
<a name="cross-sheet-controls"></a>

### Creación de un control de hojas cruzadas
<a name="cross-sheet-controls-creating-control"></a>

**Nuevo control de filtro**

1. Cree un filtro de hojas cruzadas. Para obtener más información, consulte [Filtros](#filters).

1. En el menú de tres puntos, podrá ver la opción **Agregar control**. Al pasar el ratón sobre ella, verás tres opciones:
   + **Parte superior de todas las hojas del filtro**
   + **Parte superior de esta hoja**
   + **Dentro de esta hoja**

   Si quieres añadir varias hojas dentro de las propias hojas, puedes hacerlo. sheet-by-sheet O bien, puede agregar a la parte superior y, a continuación, usar la opción de cada control **Mover a la hoja**. Para obtener más información, consulte [Edición de un control de hojas cruzadas](#cross-sheet-controls-editing-control).

**Ampliación del ámbito de un control existente**

1. Navegue hasta el filtro existente en el análisis

1. En **Se aplica a**, cambie el ámbito de aplicación de las hojas a **Hoja cruzada**.

1. Si ya se ha creado un control a partir del filtro, verá un modal que, si marca la casilla, agregará controles de forma masiva a la parte superior de todas las hojas del ámbito del filtro. Esto no afectará a la posición del control ya creado si está en la hoja.

### Edición de un control de hojas cruzadas
<a name="cross-sheet-controls-editing-control"></a>

1. Vaya al control de hojas cruzadas y seleccione el menú de tres puntos si el control está anclado en la parte superior, o bien el icono del lápiz de edición si el control está en la hoja. Se le mostrarán las siguientes opciones:
   + **Ir al filtro** (dirige al filtro de hojas cruzadas para su edición o revisión)
   + **Mover a la hoja** (permite mover el control al panel de análisis)
   + **Restablecer** 
   + **Actualizar** 
   + **Editar** 
   + **Remove** 

1. Elija **Edit (Edición de)**. Aparecerá el panel **Control de formato** en la parte derecha del análisis.

1. A continuación, podrá editar el control. La sección superior **Configuración de hojas cruzadas** se aplicará a todos los controles, mientras que los ajustes ajenos a esta sección no se aplicarán a todos los controles y solo al control específico que esté editando. Por ejemplo, **Valor relevante** no es un ajuste de control de hojas cruzadas. 

1. También puede ver las hojas en las que se encuentra este control, así como la ubicación (parte superior u hoja) en la que se encuentra el control para cada hoja. Puede hacerlo seleccionando **Hojas (8)**.

### Eliminación de un control de hojas cruzadas
<a name="cross-sheet-removing-control"></a>

Puede eliminar los controles en dos lugares. En primer lugar, desde el control:

1. Vaya al control de hojas cruzadas y seleccione el menú de tres puntos si el control está anclado en la parte superior, o bien el icono del lápiz de edición si el control está en la hoja. Se le mostrarán las siguientes opciones:
   + **Ir al filtro** (dirige al filtro de hojas cruzadas para su edición o revisión)
   + **Mover a la hoja** (permite mover el control al panel de análisis)
   + **Restablecer** 
   + **Actualizar** 
   + **Editar** 
   + **Remove** 

1. Elija **Eliminar**.

En segundo lugar, puede eliminar los controles desde el filtro:

1. Elija el menú de tres puntos del filtro de hojas cruzadas a partir del cual se crean los controles de hojas cruzadas. Verá que, en lugar de la opción **Agregar control**, ahora encontrará la opción **Administrar control**.

1. Pase el cursor sobre **Administrar control**. Se le mostrarán las siguientes opciones:
   + **Moverse dentro de esta hoja** 
   + **Parte superior de esta hoja**

   Estas opciones solo se aplican al control de la hoja, en función de dónde se encuentre el control actual. Si no tiene controles en todas las hojas incluidas en el ámbito del filtro, se mostrará la opción **Agregar a la parte superior de todas las hojas del filtro**. Esto no moverá los controles de la hoja a la parte superior de la hoja si ya los ha agregado a la hoja en el análisis. También podrá usar la opción **Eliminar de esta hoja** o **Eliminar de todas las hojas**.

# Tipos de filtros en Amazon Quick
<a name="filtering-types"></a>

Puede crear varios tipos diferentes de filtros en Quick. El tipo de filtro que cree depende principalmente del tipo de datos del campo que desee filtrar.

En los conjuntos de datos, puede crear los tipos de filtros siguientes:
+ Filtros de texto
+ Filtros numéricos
+ Filtros de fecha

En los análisis, puede crear los mismos tipos de filtros que en los conjuntos de datos. También puede crear lo siguiente:
+ Agrupe los filtros con and/or operadores
+ Filtros en cascada
+ Filtros anidados

Utilice las siguientes secciones para obtener más información sobre cada tipo de filtro que puede crear y algunas de sus opciones.

**Topics**
+ [Adición de filtros de texto](add-a-text-filter-data-prep.md)
+ [Incorporación de filtros anidados](add-a-nested-filter-data-prep.md)
+ [Adición de filtros numéricos](add-a-numeric-filter-data-prep.md)
+ [Adición de filtros de fecha](add-a-date-filter2.md)
+ [Adición de condiciones de filtro (filtros de grupo) con los operadores AND y OR](add-a-compound-filter.md)
+ [Creación de filtros en cascada](use-a-cascading-filter.md)

# Adición de filtros de texto
<a name="add-a-text-filter-data-prep"></a>

Al agregar un filtro mediante un campo de texto, puede crear los siguientes tipos de filtros de texto:
+ **Lista de filtros** (solo análisis): esta opción crea un filtro que puede usar para seleccionar uno o más valores de campo para incluirlos o excluirlos de todos los valores disponibles en el campo. Para obtener más información acerca de cómo crear este tipo de filtro de texto, consulte [Filtrado de los valores de los campos de texto mediante una lista (solo análisis)](#text-filter-list).
+ **Lista de filtros personalizados**: con esta opción, puede introducir uno o más valores de campo para usar como filtro y elegir si desea incluir o excluir los registros que contengan dichos valores. Los valores que introduzca deben coincidir exactamente con los valores del campo real para que el filtro se aplique a un registro determinado. Para obtener más información acerca de cómo crear este tipo de filtro de texto, consulte [Filtrado de los valores de los campos de texto mediante una lista personalizada](#add-text-custom-filter-list-data-prep).
+ **Filtro personalizado**: con esta opción, se introduce un único valor con el que el valor del campo debe coincidir de alguna manera. Puede especificar que el valor del campo debe ser igual, no igual, que comience por, finalice con, contenga o no contenga el valor que especifique. Si elige una comparación de igualdad, el valor especificado y el valor de campo real deben coincidir exactamente para que el filtro se aplique a un registro determinado. Para obtener más información acerca de cómo crear este tipo de filtro de texto, consulte [Filtrado de un único valor de campo de texto](#add-text-filter-custom-list-data-prep).
+ **Filtro superior e inferior** (solo análisis): puede usar esta opción para mostrar los primeros o últimos *n* valores de un campo clasificados por los valores de otro campo. Por ejemplo, podría mostrar los primeros cinco representantes por ingresos de ventas. También puede utilizar un parámetro para permitir a los usuarios del panel que elijan de forma dinámica el número de valores que se muestran en la clasificación. Para obtener más información acerca de la creación de filtros superiores e inferiores, consulte [Filtrado de un campo de texto por un valor superior o inferior (solo análisis)](#add-text-filter-top-and-bottom).

## Filtrado de los valores de los campos de texto mediante una lista (solo análisis)
<a name="text-filter-list"></a>

En los análisis, puede filtrar un campo de texto seleccionando valores para incluirlos o excluirlos de una lista de todos los valores del campo.

**Filtrado de un campo de texto incluyendo y excluyendo valores**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, elija **Lista de filtros**.

1. En **Condición de filtro**, elija **Incluir** o **Excluir**.

1. Elija los valores de campo por los que desea filtrar. Para ello, active la casilla de verificación situada delante de cada valor.

   Si hay demasiados valores entre los que elegir, introduzca un término de búsqueda en el cuadro situado encima de la lista de verificación y pulse **Buscar**. En los términos de búsqueda no se distingue entre mayúsculas y minúsculas, y no se admiten comodines. Se devuelven todos los valores de campo cuyos nombres contienen el término de búsqueda. Por ejemplo, si busca L se devuelve al, AL, la y LA.

   Los valores se muestran en orden alfabético en el control, a menos que haya más de 1000 valores distintos. A continuación, el control muestra un cuadro de búsqueda en su lugar. Cada vez que busca el valor que desea utilizar, se inicia una nueva consulta. Si los resultados contienen más de 1000 valores, puede desplazarse por los valores con paginación.

1. Cuando haya terminado, seleccione **Apply**.

## Filtrado de los valores de los campos de texto mediante una lista personalizada
<a name="add-text-custom-filter-list-data-prep"></a>

Puede especificar uno o más valores de campo para usar como filtro y elegir si desea incluir o excluir los registros que contengan dichos valores. El valor especificado y el valor de campo real deben coincidir exactamente para que el filtro se aplique a un registro determinado.

**Filtrado de los valores de los campos de texto mediante una lista personalizada**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, elija **Lista de filtros personalizados**.

1. En **Condición de filtro**, elija **Incluir** o **Excluir**.

1. En **Lista**, ingrese un valor en el cuadro de texto. El valor debe coincidir exactamente con un valor de campo existente.

1. (Opcional) Para agregar valores adicionales, ingréselos en el cuadro de texto, uno por línea.

1. En **Opciones de valores null**, elija **Excluir valores null**, **Incluir valores null** o **Solo valores null**.

1. Cuando haya terminado, seleccione **Apply**.

## Filtrado de un único valor de campo de texto
<a name="add-text-filter-custom-list-data-prep"></a>

Con el tipo de filtro **Filtro personalizado**, se especifica un valor único con el que debe coincidir o no el valor de campo, o bien debe coincidir parcialmente. Si elige una comparación de igualdad, el valor especificado y el valor de campo real deben coincidir exactamente para que el filtro se aplique a un registro determinado.

**Filtrado de un campo de texto mediante un único valor**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, elija **Filtro personalizado**.

1. En **Condición del filtro**, elija una de las opciones siguientes:
   + **Es igual a**: al elegir esta opción, los valores incluidos o excluidos en el campo deben coincidir exactamente con el valor que haya introducido.
   + **No es igual a**: al elegir esta opción, los valores incluidos o excluidos en el campo deben coincidir exactamente con el valor que haya introducido.
   + **Comienza por**: al elegir esta opción, los valores incluidos o excluidos en el campo deben coincidir exactamente con el valor que haya introducido.
   + **Finaliza con**: al elegir esta opción, los valores incluidos o excluidos en el campo deben coincidir exactamente con el valor que haya introducido.
   + **Contiene**: al elegir esta opción, los valores incluidos o excluidos en el campo deben coincidir exactamente con el valor que haya introducido.
   + **No contiene**: al elegir esta opción, los valores incluidos o excluidos en el campo deben coincidir exactamente con el valor que haya introducido.
**nota**  
Los tipos de comparación distinguen entre mayúsculas y minúsculas.

1. Realice una de las siguientes acciones:
   + En **Valor**, introduzca un valor literal.
   + Seleccione **Usar parámetros** para usar un parámetro existente y después elija el parámetro en la lista.

     Para que los parámetros aparezcan en esta lista, primero debe crear sus parámetros. Normalmente, crea un parámetro, le añade un control y después le añade un filtro. Para obtener más información, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

     Los valores se muestran en orden alfabético en el control, a menos que haya más de 1000 valores distintos. A continuación, el control muestra un cuadro de búsqueda en su lugar. Cada vez que busca el valor que desea utilizar, se inicia una nueva consulta. Si los resultados contienen más de 1000 valores, puede desplazarse por los valores con paginación.

1. En **Opciones de valores null**, elija **Excluir valores null**, **Incluir valores null** o **Solo valores null**.

1. Cuando haya terminado, seleccione **Apply**.

## Filtrado de un campo de texto por un valor superior o inferior (solo análisis)
<a name="add-text-filter-top-and-bottom"></a>

Puede usar un filtro de tipo **Filtro superior e inferior** para mostrar los primeros o últimos *n* valores de un campo clasificados por los valores de otro campo. Por ejemplo, podría mostrar los primeros cinco representantes por ingresos de ventas. También puede utilizar un parámetro para permitir a los usuarios del panel que elijan de forma dinámica el número de valores que se muestran en la clasificación.

**Creación de un filtro de texto superior e inferior**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, elija **Filtro superior e inferior**.

1. Elija **Superior** o **Inferior**.

1. En el entero **Mostrar superior** (o en el entero **Mostrar inferior**), realice una de las siguientes operaciones:
   + Escriba el número de elementos que se deben mostrar.
   + Para utilizar un parámetro como número de elementos superiores o inferiores que mostrar, seleccione **Usar parámetros**. A continuación, elija un parámetro entero existente. 

     Por ejemplo, supongamos que desea mostrar los tres representantes principales de forma predeterminada. Sin embargo, desea que el visor del panel pueda elegir si desea mostrar de 1 a 10 representantes principales. En este caso, realice las operaciones siguientes:
     + Cree un parámetro entero con un valor predeterminado. 
     + Para vincular el número de elementos mostrados a un control de parámetro, cree un control para el parámetro entero. A continuación, conviértalo en un control deslizante con tamaño de incremento 1, valor mínimo 1 y valor máximo 10. 
     + Para que el control funcione, vincúlelo a un filtro mediante la creación de un filtro superior e inferior en `Salesperson` por `Weighted Revenue`, habilite el **uso de parámetros** y elija el parámetro entero. 

1. En **Por**, elija el campo en el que se basa la clasificación. Si desea mostrar los cinco mejores representantes por ingresos de ventas, elija el campo de ingresos. También puede definir la agregación que desee realizar con en el campo.

1. (Opcional) Seleccione **Desempate** y, a continuación, seleccione otro campo para agregar una o más agregaciones como desempates. Esto resulta útil, en el caso de este ejemplo, cuando los cinco representantes con más ingresos devuelven más de cinco resultados. Esta situación podría darse si varios representantes tienen la misma cantidad de ingresos. 

   Para quitar un desempate, use el icono de eliminación.

1. Cuando haya terminado, seleccione **Apply**.

# Incorporación de filtros anidados
<a name="add-a-nested-filter-data-prep"></a>

Los filtros anidados son filtros avanzados que se pueden añadir a un análisis rápido. Los filtros anidados filtran campos mediante subconjuntos de datos definidos por otro campo del mismo conjunto de datos. Esto permite a los autores mostrar datos contextuales adicionales sin necesidad de filtrar los datos si el punto de datos no cumple una condición inicial.

Los filtros anidados funcionan de forma similar a una subconsulta correlacionada en SQL o a un análisis de cesta de mercado. Por ejemplo, supongamos que desea realizar un análisis de la cesta de mercado en función de los datos de ventas. Puede usar filtros anidados para encontrar la cantidad de ventas por producto de los clientes que hayan comprado o no un producto específico. También puede usar filtros anidados para identificar grupos de clientes que no compraron un producto seleccionado o que solo compraron una lista específica de productos.

Los filtros anidados solo se pueden agregar a nivel de análisis. No puede agregar filtros anidados conjuntos de datos.

Utilice el procedimiento siguiente para añadir un filtro anidado a un análisis rápido.

1. Abra la [consola Quick.](https://quicksight.aws.amazon.com/)

1. Elija **Análisis** y, a continuación, elija el análisis al que desee agregar un filtro anidado.

1. Cree un filtro nuevo en el campo de texto en el que quiera aplicar el filtro. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros en los análisis](add-a-filter-data-prep.md#add-a-filter-data-prep-analyses).

1. Tras crear el nuevo filtro, búsquelo en el panel **Filtros**. Seleccione los puntos suspensivos (tres puntos) situados junto al nuevo filtro y, a continuación, elija **Editar filtro**. Como alternativa, elija la entidad de filtro en el panel **Filtros** para abrir el panel **Editar filtro**.

1. Se abrirá el panel **Editar filtro**. Abra el menú desplegable **Tipo de filtro**, navegue hasta la sección **Filtro avanzado** y, a continuación, elija **Filtro anidado**.

1. En **Condición de calificación**, elija **Incluir** o **Excluir**. La *Condición de calificación* permite ejecutar una consulta no incluida en el conjunto sobre los datos del análisis. En el ejemplo de ventas anterior, la condición válida determina si el filtro devuelve una lista de clientes que sí compraron el producto específico o una lista de clientes que no compraron el producto.

1. En **Campo anidado**, elija el campo que desee filtrar. El campo anidado no puede ser el mismo que el campo principal seleccionado en el paso 3. Los campos de categoría son el único tipo de campo compatible con el filtro interno.

1. En **Tipo de filtro anidado**, elija el tipo de filtro que desee. El tipo de filtro que elija determina los pasos de configuración finales del filtro anidado. Los tipos de filtros disponibles y la información sobre su configuración se encuentran en la siguiente lista.
   + [Lista de filtros](https://docs.aws.amazon.com/quicksuite/latest/userguide/text-filter-list)
   + [Lista de filtros personalizados](https://docs.aws.amazon.com/quicksuite/latest/userguide/add-text-custom-filter-list-data-prep)
   + [Filtro personalizado](https://docs.aws.amazon.com/quicksuite/latest/userguide/add-text-filter-custom-list-data-prep)

# Adición de filtros numéricos
<a name="add-a-numeric-filter-data-prep"></a>

Los campos con tipos de datos enteros o decimales se consideran campos numéricos. Puede crear filtros en campos numéricos especificando un tipo de comparación, por ejemplo, **Mayor que** o **Entre**, y un valor o valores de comparación según corresponda al tipo de comparación. Los valores de comparación deben ser enteros positivos y no incluir comas.

Puede utilizar los siguientes tipos de comparación en los filtros numéricos:
+ Igual a
+ No igual a
+ Mayor que
+ Mayor o igual que
+ Menor que
+ Menor o igual que
+ Entre

**nota**  
Para aplicar un filtro superior e inferior a datos numéricos (solo análisis), cambie primero el campo de medición a dimensión. De este modo los datos se convierten en texto. A continuación puede usar un filtro de texto. Para obtener más información, consulte [Adición de filtros de texto](add-a-text-filter-data-prep.md).

En los análisis, para conjuntos de datos basados en las consultas de base de datos, también puede aplicar opcionalmente una función de agregación al valor o valores de la comparación, por ejemplo, **Suma** o **Promedio**. 

Puede utilizar las siguientes funciones de agregación en los filtros numéricos:
+ Media
+ Recuento
+ Recuento distinto
+ Máximo
+ Mediana
+ Mínimo
+ Percentil
+ Desviación estándar
+ Desviación estándar: población
+ Sum
+ Varianza
+ Varianza: población

## Creación de filtros numéricos
<a name="create-a-numeric-filter-data-prep"></a>

Utilice el siguiente procedimiento para crear un filtro de campo numérico.

**Creación de un filtro de campos numéricos**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. (Opcional) En **Agregación**, elija una agregación. De forma predeterminada, no se aplica ninguna agregación. Esta opción solo está disponible cuando se crean filtros numéricos en un análisis.

1. En **Condición de filtro**, elija un tipo de comparación.

1. Realice una de las siguientes acciones:
   + Si ha elegido un tipo de comparación distinto de **Entre**, especifique un valor de comparación.

     Si ha elegido el tipo de comparación **Entre**, escriba el comienzo del intervalo de valores en **Valor mínimo** y el final del intervalo de valores en **Valor máximo**.
   + (Solo análisis) Para usar un parámetro existente, habilite **Usar parámetros** y después elija el parámetro en la lista.

     Para que los parámetros aparezcan en esta lista, primero debe crear sus parámetros. Normalmente, crea un parámetro, le añade un control y después le añade un filtro. Para obtener más información, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md). Los valores se muestran en orden alfabético en el control, a menos que haya más de 1000 valores distintos. A continuación, el control muestra un cuadro de búsqueda en su lugar. Cada vez que busca el valor que desea utilizar, se inicia una nueva consulta. Si los resultados contienen más de 1000 valores, puede desplazarse por los valores con paginación. 

1. (Solo análisis) En **Opciones de valores null**, elija **Excluir valores null**, **Incluir valores null** o **Solo valores null**.

1. Cuando haya terminado, seleccione **Apply**.

# Adición de filtros de fecha
<a name="add-a-date-filter2"></a>

Puede crear filtros en campos de fecha seleccionando las condiciones del filtro y los valores de fecha que desea utilizar. Existen tres tipos de filtros para fechas:
+ **Intervalo**: una serie de fechas basadas en un intervalo de tiempo y en un tipo de comparación. Puede filtrar los registros en función de si el valor del campo de fecha está antes o después de una fecha especificada, o dentro de un intervalo de fechas. Introduce los valores de fecha en el formatoMM/DD/YYYY. Puede utilizar los tipos de comparación siguientes:
  + **Entre**: entre una fecha de inicio y una fecha de finalización
  + **Después de**: después de una fecha especificada
  + **Antes de**: antes de una fecha especificada
  + **Igual a**: en una fecha especificada

  Para cada tipo de comparación, también puede elegir una fecha variable en relación con un período o un valor de conjunto de datos.
+ **Relativa** (solo análisis): una serie de elementos de fecha y hora basados en la fecha actual. Puede filtrar los registros del filtro en función de la fecha actual y la unidad de medida seleccionada (UOM). Las unidades de filtro de fecha incluyen años, trimestres, meses, semanas, días, horas y minutos. Puede excluir el período actual y añadir compatibilidad con filtros Próximo N similares a Último N con una capacidad adicional para permitir la fecha de delimitación. Puede utilizar los tipos de comparación siguientes:
  + **Anterior**: la unidad de medida anterior, por ejemplo, el año pasado.
  + **Esta**: esta unidad de medida, que incluye todas las fechas y horas que caen dentro de la unidad de medida seleccionada, incluso si va a ocurrir en el futuro.
  + **Hasta la fecha *o* hasta ahora**: la unidad de medida hasta la fecha o la unidad de medida hasta ahora. Las frases mostradas se adaptan a las unidades de medida que elija. Sin embargo, en todos los casos esta opción filtra los datos que no están entre el comienzo de una unidad de medida actual y el momento actual.
  + **Último *n***: el último número especificado de la unidad de medida concreta, que incluye todas las unidades de medida y las últimas *n * −1 unidades de medida. Por ejemplo, supongamos que hoy es 10 de mayo de 2017. Decide utilizar *years* como su unidad de medida y define Last *n *years a 3. Los datos filtrados incluyen todos los datos de 2017, además de todos los de 2016 y todos los de 2015. Si tiene cualquier dato para fechas futuras del año actual (2017 en este ejemplo), estos registros se incluyen en el conjunto de datos.
+ **Superior e inferior** (solo análisis): número de entradas de fecha clasificadas por otro campo. Puede mostrar los *n* elementos superiores o inferiores para el tipo unidad de medida de fecha u hora que elija, en función de los valores de otro campo. Por ejemplo, puede mostrar los 5 días con mayores ventas por ingresos.

Las comparaciones se aplican hasta la fecha especificada inclusive. Por ejemplo, si aplica el filtro `Before 1/1/16`, los registros devueltos incluyen todas las filas con los valores de fecha hasta 1/1/16 23:59:59. Si no desea incluir la fecha especificada, puede borrar la opción **Incluir esta fecha**. Si desea omitir un intervalo de tiempo, puede utilizar la opción **Excluir los últimos N periodos)** para especificar el número y el tipo de periodos de tiempo (minutos, días, etc.) que se van a dejar fuera.

También puede elegir si desea excluir o incluir valores null o mostrar exclusivamente las filas con valores null en este campo. Si pasa un parámetro de fecha nulo (uno sin un valor predeterminado), no filtra los datos hasta que proporcione un valor.

**nota**  
Si una columna o atributo no tiene información de zona horaria, el motor de consultas del cliente establece la interpretación predeterminada de los datos de fecha y hora. Por ejemplo, supongamos que una columna contiene una marca de tiempo, en lugar de una marca de tiempo con zona horaria, y usted está en una zona horaria diferente a la del origen de los datos. En este caso, el motor puede representar la marca de tiempo de forma distinta a la que cabría esperar. Tanto Amazon Quick [SPICE](spice.md)como ambos utilizan la hora universal coordinada (UTC). 

En las siguientes secciones puede aprender a crear filtros de fecha en conjuntos de datos y análisis.

## Creación de filtros de fecha en conjuntos de datos
<a name="create-date-filter-dataset"></a>

Utilice el siguiente procedimiento para crear un filtro de intervalo para un campo de fecha en un conjunto de datos.

**Creación de un filtro de intervalo para un campo de fecha en un conjunto de datos**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Condición**, elija un tipo de comparación: **Entre**, **Después de** o **Antes de**.

   Para usar **Entre** como comparación, elija **Fecha de inicio** y **Fecha de finalización** y elija las fechas en los controles del selector de fechas que aparecen.

   Puede elegir si desea incluir la fecha de inicio o la fecha de finalización, o ambas, en el intervalo. Para ello, seleccione **Incluir fecha de inicio** o **Incluir fecha de finalización**.

   Para usar las comparaciones **Antes de** o **Después de**, escriba una fecha o elija el campo de fecha para abrir el control de selección de fechas y elegir una fecha en su lugar. Tiene la opción de incluir esta fecha (la que eligió), para excluir los últimos N periodos de tiempo y especificar cómo gestionar los valores null. 

1. En **Grado de detalle del periodo de tiempo**, elija **Día**, **Hora**, **Minuto** o **Segundo**.

1. Cuando haya terminado, seleccione **Apply**.

## Creación de filtros de fecha en los análisis
<a name="create-date-filter-analyses"></a>

Puede crear filtros de fecha en los análisis como se describe a continuación.

### Creación de filtros de intervalo de fechas en los análisis
<a name="create-a-date-filter2"></a>

Utilice el siguiente procedimiento para crear un filtro de intervalo para un campo de fecha en un análisis.

**Creación de un filtro de intervalo para un campo de fecha en un análisis**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, elija **Intervalo de fecha y hora**.

1. En **Condición**, elija un tipo de comparación: **Entre**, **Después de**, **Antes de** o **Igual a**.

   Para usar **Entre** como comparación, elija **Fecha de inicio** y **Fecha de finalización** y elija las fechas en los controles del selector de fechas que aparecen.

   Puede elegir incluir una o ambas fechas de inicio y finalización en el intervalo seleccionando **Incluir fecha de inicio** o **Incluir fecha de finalización**.

   Para usar una comparación **Antes de**, **Después de** o **Igual a**, escriba una fecha o elija el campo de fecha para abrir el control de selección de fechas y elegir una fecha en su lugar. Tiene la opción de incluir esta fecha (la que eligió), para excluir los últimos N periodos de tiempo y especificar cómo gestionar los valores null. 

   Para **establecer una fecha variable** para la comparación, seleccione **Establecer una fecha continua**.

   En el panel **Establecer una fecha variable** que se abre, elija **Fecha relativa** y, a continuación, seleccione si desea establecer la fecha en **Hoy**, **Ayer** o puede especificar la **Condición del filtro** (inicio o final de), el **Intervalo** (este, anterior o siguiente) y el **Período** (año, trimestre, mes, semana o día).

1. En **Grado de detalle del periodo de tiempo**, elija **Día**, **Hora**, **Minuto** o **Segundo**.

1. (Opcional) Si va a filtrar utilizando un parámetro existente en lugar de fechas específicas, seleccione **Usar parámetros** y, a continuación, elija el parámetro o parámetros de la lista. Para usar las comparaciones **Antes de**, **Después de** o **Igual a**, elija un parámetro de fecha. Puede incluir esta fecha en el intervalo.

   Para utilizar **Entre**, escriba los parámetros de fecha de inicio y fecha de finalización por separado. Puede incluir en el intervalo la fecha de inicio, la fecha de finalización o ambos. 

   Para usar los parámetros de un filtro, créelos primero. Normalmente, crea un parámetro, le añade un control y después le añade un filtro. Para obtener más información, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

1. En **Opciones de valores null**, elija **Excluir valores null**, **Incluir valores null** o **Solo valores null**.

1. Cuando haya terminado, seleccione **Apply**.

### Creación de filtros de fecha relativa en los análisis
<a name="create-a-date-filter-relative"></a>

Utilice el siguiente procedimiento para crear un filtro relativo para un campo de fecha en un análisis.

**Creación de un filtro relativo para un campo de fecha en un análisis**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, seleccione **Fechas relativas**.

1. En **Grado de detalle del periodo de tiempo**, elija el grado de detalle del periodo de tiempo por el que desee filtrar (días, horas, minutos).

1. En **Período**, elija una unidad de tiempo (años, trimestres, meses, semanas, días).

1. En **Intervalo**, elija cómo desea que el filtro se relacione con el período de tiempo. Por ejemplo, si decide informar sobre meses, las opciones son el mes anterior, el mes actual, el mes hasta la fecha, los últimos N meses y los próximos N meses.

   Si selecciona Los últimos N o Los siguientes N años, trimestres, meses, semanas o días, introduzca un número en **Número de**. Por ejemplo, los últimos 3 años, los siguientes 5 trimestres, los últimos 5 días.

1. En **Opciones de valores null**, elija **Excluir valores null**, **Incluir valores null** o **Solo valores null**.

1. En **Establecer fechas relativas a**, elija una de las siguientes opciones:
   + **Hora de fecha actual**: si selecciona esta opción, puede establecerla en **Excluir último**, y, a continuación, especificar el número y el tipo de períodos.
   + **Fecha y hora de un parámetro**: si selecciona esta opción, puede seleccionar el parámetro de fecha y hora existente.

1. (Opcional) Si va a filtrar utilizando un parámetro existente en lugar de fechas específicas, active **Use parameters (Usar parámetros)** y, a continuación, elija el parámetro o parámetros de la lista. 

   Para usar los parámetros de un filtro, créelos primero. Normalmente, crea un parámetro, le añade un control y después le añade un filtro. Para obtener más información, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

1. Cuando haya terminado, seleccione **Apply**.

### Creación de filtros de fecha superior e inferior en los análisis
<a name="create-a-date-filter-top-bottom"></a>

Utilice el siguiente procedimiento para crear un filtro superior e inferior para un campo de fecha en un análisis.

**Creación de un filtro superior e inferior para un campo de fecha en un análisis**

1. Cree un filtro nuevo mediante un campo de texto. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En **Tipo de filtro**, elija **Superior e inferior**.

1. Seleccione **Superior** o **Inferior**.

1. En **Mostrar**, introduzca el número de elementos superiores o inferiores que desee mostrar y elija una unidad de tiempo (años, trimestres, meses, semanas, días, horas, minutos). 

1. En **Por**, elija el campo en el que se basa la clasificación.

1. (Opcional) Puede agregar otro campo para deshacer empates si el campo **Por** tiene valores duplicados. Elija **Desempate** y, a continuación, elija otro campo. Para quitar un desempate, use el icono de eliminación.

1. (Opcional) Si va a filtrar utilizando un parámetro existente en lugar de fechas específicas, seleccione **Usar parámetros** y, a continuación, elija el parámetro o parámetros de la lista.

   Para utilizar un parámetro para **Superior e inferior**, elija un parámetro entero para especificar el número de elementos superiores o inferiores que se deben mostrar. 

   Para usar los parámetros de un filtro, créelos primero. Normalmente, crea un parámetro, le añade un control y después le añade un filtro. Para obtener más información, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

1. Cuando haya terminado, seleccione **Apply**.

# Adición de condiciones de filtro (filtros de grupo) con los operadores AND y OR
<a name="add-a-compound-filter"></a>

En los análisis, cuando se añaden varios filtros a un elemento visual, Quick utiliza el operador AND para combinarlos. También puede agregar condiciones de filtro a un solo filtro con el operador OR. Esto se denomina filtro compuesto o grupo de filtros.

Para agregar varios filtros mediante el operador OR, cree un grupo de filtros. La agrupación de filtros está disponible para todos los tipos de filtros en los análisis. 

Cuando filtra varias medidas (campos verdes marcados con \$1), puede aplicar las condiciones del filtro a un valor agregado de ese campo. Los filtros de un grupo pueden contener campos agregados o no agregados, pero no ambos. 

**Creación de un grupo de filtros**

1. Cree un filtro nuevo en un análisis. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija el nuevo filtro para ampliarlo.

1. En el filtro expandido, elija **Agregar condición de filtro** en la parte inferior y, a continuación, elija un campo por el que filtrar. 

1.  Elija las condiciones por las que desea filtrar. 

   El tipo de datos del campo que ha seleccionado determina las opciones disponibles aquí. Por ejemplo, si elige un campo numérico, puede especificar la agregación, la condición del filtro y los valores. Si elige un campo de texto, puede elegir el tipo de filtro, la condición del filtro y los valores. Y si elige un campo de fecha, puede especificar el tipo de filtro, la condición y el grado de detalle del periodo de tiempo. Para obtener más información sobre estas opciones, consulte [Tipos de filtros en Amazon Quick](filtering-types.md).

1.  (Opcional) Puede agregar condiciones de filtro adicionales al grupo de filtros seleccionando nuevamente **Agregar condición de filtro** en la parte inferior.

1.  (Opcional) Para eliminar un filtro del grupo de filtros, elija el icono de papelera junto al nombre del campo. 

1. Cuando haya terminado, seleccione **Apply**.

   Los filtros aparecen como un grupo en el panel **Filtros**.

# Creación de filtros en cascada
<a name="use-a-cascading-filter"></a>

En cualquier acción en cascada, como un filtro, se trata de que las opciones de los niveles superiores de una jerarquía afectan a los niveles inferiores de esta. El término *cascada* alude al modo en que fluye una cascada de un nivel a otro. 

Para configurar filtros en cascada, se necesita un punto desencadenador en el que se active el filtro, así como puntos de destino a los que se aplique el filtro. En Quick, los puntos de activación y objetivo se incluyen en las imágenes.

Para crear un filtro en cascada, debe configurar una acción, no un filtro. Este enfoque se debe a la necesidad de definir cómo se activará el filtro en cascada, qué campos están involucrados y qué elementos visuales se filtrarán cuando alguien lo active. Para obtener más información, incluidas step-by-step las instrucciones, consulte[Uso de acciones personalizadas para filtrar y navegar](quicksight-actions.md).

Hay otras dos maneras de activar un filtro para varios elementos visuales:
+ **Para un filtro que se activa desde un widget de un panel**: el widget se denomina *control de hoja*, que es un menú personalizado que puede agregar a la parte superior del análisis o del panel. El control de hoja más común es una lista desplegable que, al abrirla, muestra una lista de opciones entre las que elegir. Para agregar uno de estos elementos al análisis, cree un parámetro, agréguele un control y, a continuación, agregue un filtro que utilice el parámetro. Para obtener más información, consulte [Configuración de parámetros en Amazon Quick](parameters-set-up.md), [Uso de un control con un parámetro en Amazon Quick](parameters-controls.md) y [Adición de controles de filtro a las hojas de análisis](filter-controls.md).
+ **Para un filtro que siempre se aplica a varios elementos visuales**: se trata de un filtro normal, salvo que su ámbito se establezca de modo que se aplique a varios elementos visuales (o a todos ellos). En realidad, este tipo no es un filtro en cascada, porque no hay un punto desencadenador. Siempre filtra todos los elementos visuales que está configurado para filtrar. Para agregar este tipo de filtro al análisis, cree o edite un filtro y, a continuación, elija su ámbito: **Elemento visual único**, **Hoja única** u **Hojas cruzadas**. Tenga en cuenta la opción **Aplicar conjuntos de datos cruzados**. Si esta casilla está activada, el filtro se aplicará a todos los elementos visuales de diferentes conjuntos de datos que se apliquen a todas las hojas del ámbito del filtro. Para obtener más información, consulte [Filtros](cross-sheet-filters.md#filters). 

# Adición de controles de filtro a las hojas de análisis
<a name="filter-controls"></a>

Al diseñar un análisis, puede agregar un filtro a la hoja de análisis cerca de los elementos visuales que desee filtrar. Aparece en la hoja como un control que los espectadores del panel pueden usar al publicar el análisis como un panel. El control utiliza la configuración del tema de análisis para que parezca que forma parte de la hoja.

Los controles de filtro comparten algunos ajustes con sus filtros. Se aplican a uno, a algunos o a todos los objetos de la misma hoja.

Utilice las siguientes secciones para agregar y personalizar los controles de filtro a un análisis. Para obtener información sobre cómo agregar controles de hojas cruzadas, consulte [Controles](cross-sheet-filters.md#cross-sheet-controls).

**Topics**
+ [Adición de controles de filtro](#filter-controls-add)
+ [Anclaje de los controles de filtro en la parte superior de una hoja](#filter-controls-pin)
+ [Personalización de los controles de filtro](#filter-controls-customize)
+ [Controles de filtros en cascada](#cascading-controls)

## Adición de controles de filtro
<a name="filter-controls-add"></a>

Utilice el siguiente procedimiento para agregar un control de filtro.

**Adición de un control de filtro**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis con el que desee trabajar.

1. En el análisis, elija **Filtrar**.

1. Si aún no dispone de algunos filtros, cree uno. Para obtener más información acerca de la creación de filtros, consulte [Adición de filtros](add-a-filter-data-prep.md).

1. En el panel **Filtros**, elija los tres puntos situados a la derecha del filtro al que desee agregar un control y elija **Agregar a la hoja**.

   El control de filtro se agrega a la hoja, normalmente en la parte inferior. Puede cambiarle el tamaño o arrastrarlo a distintas posiciones de la hoja. También puede personalizar su aspecto y la forma en que los espectadores del panel pueden interactuar con él. Para obtener más información acerca de la personalización de los controles de filtro, consulte las siguientes secciones.

## Anclaje de los controles de filtro en la parte superior de una hoja
<a name="filter-controls-pin"></a>

Utilice el siguiente procedimiento para anclar los controles de filtro a la parte superior de una hoja.

**Anclaje de un control a la parte superior de una hoja**

1. En el control de filtro que desee mover, elija los tres puntos situados junto al icono del lápiz y elija **Anclar en la parte superior**.

   El filtro está anclado en la parte superior de la hoja y está contraído. Puede hacer clic en él para expandirlo.

1. (Opcional) Para desanclar el control, expándalo y coloque el cursor sobre él en la parte superior de la hoja hasta que aparezcan tres puntos. Elija los tres puntos y, a continuación, elija **Mover a la hoja**.

## Personalización de los controles de filtro
<a name="filter-controls-customize"></a>

Según el tipo de datos del campo y el tipo de filtro, los controles de filtro tienen diferentes configuraciones disponibles. Puede personalizar la forma en que aparecen en la hoja y la forma en que los espectadores del panel pueden interactuar con ellos. 

**Personalización de un control de filtro**

1. Elija el control de filtro en la hoja.

1. En el control de filtro, seleccione el icono de lápiz.

   Si el control del filtro está anclado en la parte superior de la hoja, expándalo y coloque el cursor sobre él hasta que aparezcan los tres puntos. Elija los tres puntos y, a continuación, elija **Editar**.

1. En el panel **Control de formato** que se abre, haga lo siguiente:

   1. En **Nombre para mostrar**, escriba un nombre para el control de filtro.

   1. (Opcional) Para ocultar el nombre para mostrar del control de filtro, desactive la casilla **Mostrar título**.

   1. En **Tamaño de fuente del título**, elija el tamaño de fuente del título que desee usar. Las opciones van desde extrapequeñas hasta extragrandes. El valor predeterminado es medio.

Los pasos restantes dependen del tipo de campo al que hace referencia el control. Para ver las opciones por tipo de filtro, consulte las siguientes secciones.

### Filtros de fecha
<a name="filter-controls-customize-date"></a>

Si el control de filtro proviene de un filtro de fecha, utilice el siguiente procedimiento para personalizar el resto de las opciones.

**Personalización de más opciones de un filtro de fecha**

1. En el panel **Control de formato**, en **Estilo**, elija una de las siguientes opciones:
   + **Selector de fechas: intervalo**: muestra un conjunto de dos campos para definir un intervalo de tiempo. Puede introducir una fecha o una hora, o puede elegir una fecha en el control del calendario. También puede personalizar la forma en que desea que aparezcan las fechas en el control introduciendo un token de fecha en **Formato de fecha**. Para obtener más información, consulte [Personalización de los formatos de fecha en Quick](format-visual-date-controls.md).
   + **Selector de fechas: relativa**: muestra ajustes como el período de tiempo, su relación con la fecha y la hora actuales y la opción de excluir períodos de tiempo. También puede personalizar la forma en que desea que aparezcan las fechas en el control introduciendo un token de fecha en **Formato de fecha**. Para obtener más información, consulte [Personalización de los formatos de fecha en Quick](format-visual-date-controls.md).
   + **Campo de texto**: muestra un cuadro en el que puede introducir la fecha *N* superior o inferior.

     El texto auxiliar se incluye en el control del campo de texto de forma predeterminada, pero puede eliminarlo desactivando la opción **Mostrar texto auxiliar en el control**.

   De forma predeterminada, las imágenes rápidas se vuelven a cargar cada vez que se realiza un cambio en un control. En los controles Calendario y Selector de fecha relativa, los autores pueden agregar el botón **Aplicar** a un control que retrasará la recarga del elemento visual hasta que el usuario seleccione **Aplicar**. Esto permite a los usuarios realizar varios cambios a la vez sin consultas adicionales. Este ajuste se puede configurar con la casilla de verificación **Mostrar un botón Aplicar** en la sección **Opciones de control** del panel **Control de formato**.

1. Cuando haya terminado, seleccione **Apply**.

### Filtros de texto
<a name="filter-controls-customize-text"></a>

Si el control de filtro proviene de un filtro de texto (por ejemplo, dimensiones, categorías o etiquetas), utilice el siguiente procedimiento para personalizar el resto de las opciones.

**Personalización de más opciones de un filtro de texto**

1. En el panel **Control de formato**, en **Estilo**, elija una de las siguientes opciones:
   + **Menú desplegable**: muestra una lista desplegable con botones que puede utilizar para seleccionar un único valor.

     Al seleccionar esta opción, puede elegir las siguientes opciones en **Valores**:
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.

     También puede optar por **ocultar la opción Seleccionar todo de los valores del control**. Esto elimina la opción de seleccionar o borrar la selección de todos los valores del control de filtro.
   + **Menú desplegable: selección múltiple**: muestra una lista desplegable con cuadros que puede usar para seleccionar varios valores. 

     Al seleccionar esta opción, puede elegir las siguientes opciones en **Valores**:
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.

     De forma predeterminada, las imágenes rápidas se vuelven a cargar cada vez que se realiza un cambio en un control. En los controles desplegables Selección múltiple, los autores pueden agregar el botón **Aplicar** a un control que retrasará la recarga del elemento visual hasta que el usuario seleccione **Aplicar**. Esto permite a los usuarios realizar varios cambios a la vez sin consultas adicionales. Este ajuste se puede configurar con la casilla de verificación **Mostrar un botón Aplicar** en la sección **Opciones de control** del panel **Control de formato**.
   + **Lista**: muestra una lista con botones que puede utilizar para seleccionar un único valor.

     Al seleccionar esta opción, puede elegir las siguientes opciones en **Valores**:
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.

     Puede elegir entre las siguientes opciones:
     + **Ocultar la barra de búsqueda cuando el control está en la hoja**: oculta la barra de búsqueda en el control de filtro para que los usuarios no puedan buscar valores específicos.
     + **Ocultar la opción Seleccionar todo de los valores del control**: elimina la opción de seleccionar o borrar la selección de todos los valores del control de filtro.
   + **Lista: selección múltiple**: muestra una lista con cuadros que puede usar para seleccionar varios valores. 

     Al seleccionar esta opción, puede elegir las siguientes opciones en **Valores**:
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.

     Puede elegir entre las siguientes opciones:
     + **Ocultar la barra de búsqueda cuando el control está en la hoja**: oculta la barra de búsqueda en el control de filtro para que los usuarios no puedan buscar valores específicos.
     + **Ocultar la opción Seleccionar todo de los valores del control**: elimina la opción de seleccionar o borrar la selección de todos los valores del control de filtro.
   + **Campo de texto**: muestra un cuadro de texto en el que puede introducir una sola entrada. Los campos de texto admiten hasta 79 950 caracteres.

     Si selecciona esta opción, puede elegir las siguientes opciones:
     + **Mostrar texto auxiliar en el control**: elimina el texto auxiliar de los campos de texto.
   + **Campo de texto: multilínea**: muestra un cuadro de texto en el que puede introducir varias entradas. Los campos de texto de varias líneas admiten hasta 79 950 caracteres en todas las entradas.

     Si selecciona esta opción, puede elegir las siguientes opciones:
     + En **Separar los valores por**, elija cómo quiere separar los valores que introduzca en el control de filtro. Puede separar los valores mediante un salto de línea, una coma, una barra vertical (\$1) o un punto y coma.
     + **Mostrar texto auxiliar en el control**: elimina el texto auxiliar de los campos de texto.

1. Cuando haya terminado, seleccione **Apply**.

### Filtros numéricos
<a name="filter-controls-customize-numeric"></a>

Si el control de filtro proviene de un filtro numérico, utilice el siguiente procedimiento para personalizar el resto de las opciones.

**Personalización de más opciones de un filtro numérico**

1. En el panel **Control de formato**, en **Estilo**, elija una de las siguientes opciones:
   + **Menú desplegable**: muestra una lista en la que puede seleccionar un único valor.

     Al seleccionar esta opción, puede elegir las siguientes opciones en **Valores**:
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.

     También puede optar por **ocultar la opción Seleccionar todo de los valores del control**. Esto elimina la opción de seleccionar o borrar la selección de todos los valores del control de filtro.
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.
     + **Ocultar la opción Seleccionar todo de los valores del control**: elimina la opción de seleccionar o borrar la selección de todos los valores del control de filtro.
   + **Lista**: muestra una lista con botones que permiten seleccionar un único valor. 

     Al seleccionar esta opción, puede elegir las siguientes opciones en **Valores**:
     + **Filtro**: muestra todos los valores disponibles en el filtro.
     + **Valores específicos**: permite introducir los valores que se van a mostrar, una entrada por línea.

     Puede elegir entre las siguientes opciones:
     + **Ocultar la barra de búsqueda cuando el control está en la hoja**: oculta la barra de búsqueda en el control de filtro para que los usuarios no puedan buscar valores específicos.
     + **Ocultar la opción Seleccionar todo de los valores del control**: elimina la opción de seleccionar o borrar la selección de todos los valores del control de filtro.
   + **Control deslizante**: muestra una barra horizontal con un conmutador que se puede deslizar para cambiar el valor. Si tiene un filtro con intervalo para valores entre un mínimo y un máximo, el control deslizante proporciona un conmutador para cada número. En el caso de los controles deslizantes, puede especificar las opciones siguientes:
     + **Valor mínimo**: muestra el valor más pequeño a la izquierda del control deslizante.
     + **Valor máximo**: muestra el valor más grande a la derecha del control deslizante.
     + **Tamaño de paso**: permite establecer el número de incrementos en los que se divide la barra.
   + **Cuadro de texto**: muestra un cuadro en el que puede introducir el valor. Si selecciona esta opción, puede elegir las siguientes opciones:
     + **Mostrar texto auxiliar en el control**: elimina el texto auxiliar de los campos de texto.

1. Cuando haya terminado, seleccione **Apply**.

## Controles de filtros en cascada
<a name="cascading-controls"></a>

Puede limitar los valores que se muestran en el control de modo que solo aparezcan los que sean válidos en función de lo seleccionado en otros controles. Esto se denomina control en cascada.

**Al crear controles en cascada, se aplican las siguientes limitaciones:**

1. Los controles en cascada deben estar vinculados a columnas del mismo conjunto de datos.

1. El control secundario debe ser un control desplegable o de lista.

1. En el caso de los controles de parámetros, el control secundario debe estar vinculado a una columna del conjunto de datos.

1. En el caso de los controles de filtro, el control secundario debe estar vinculado a un filtro (en lugar de mostrar solo valores específicos).

1. El control principal debe ser uno de los siguientes:

   1. Un control de parámetros de cadena, entero o numérico.

   1. Un control de filtro de cadena (excluidos los filtros superior e inferior).

   1. Un control de filtro numérico no agregado.

   1. Un control de filtro de fecha (excluidos los filtros superior e inferior).

**Creación de un control en cascada**

1. Elija **Mostrar solo valores relevantes**. Tenga en cuenta que es posible que esta opción no esté disponible para todos los tipos de controles de filtro.

1. En el panel **Mostrar solo los valores relevantes** que se abre, elija uno o más controles de la lista disponible.

1. Elija un campo con el que hacer coincidir el valor.

1. Elija **Actualizar**.

# Edición de filtros
<a name="edit-a-filter-data-prep"></a>

Puede editar los filtros en cualquier momento en un análisis o conjunto de datos.

No puede cambiar el campo al que se aplica un filtro. Para aplicar un filtro a un campo diferente, cree un nuevo filtro en su lugar.

Utilice los siguientes procedimientos para obtener información sobre cómo editar filtros.

## Edición de filtros en conjuntos de datos
<a name="edit-a-filter-data-prep-datasets"></a>

Utilice el siguiente procedimiento para editar filtros en conjuntos de datos.

**Edición de un filtro en un conjunto de datos**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, selecciona **Datos** a la izquierda.

1. En la pestaña **Conjuntos de datos**, elige el conjunto de datos que desees y, a continuación, selecciona **Editar conjunto** de datos.

1. En la página de preparación de datos que se abre, elija **Filtros** en la parte inferior izquierda.

1. Elija el filtro que desea editar.

1. Cuando termine de editar, elija **Aplicar**.

## Edición de filtros en los análisis
<a name="edit-a-filter-data-prep-analyses"></a>

Utilice el siguiente procedimiento para editar filtros en análisis.

**Edición de un filtro en un análisis**

1. Abre la [consola rápida.](https://quicksight.aws.amazon.com/)

1. En la página de inicio de Quick, selecciona **Análisis** a la izquierda.

1. En la página **Análisis**, elija el análisis con el que desea trabajar.

1. En el análisis, elija el icono de **filtro** que se muestra para abrir el panel **Filtros**.

1. Elija el filtro que desea editar.

1. Cuando termine de editar, elija **Aplicar**.

# Habilitación o deshabilitación de filtros
<a name="disable-a-filter-data-prep"></a>

Puede utilizar el menú de filtros para habilitar o deshabilitar un filtro en un conjunto de datos o un análisis. Al crear un filtro, se habilita de forma predeterminada. Al deshabilitar un filtro, se elimina el filtro del campo, pero no se elimina del conjunto de datos o del análisis. Los filtros deshabilitados aparecen atenuados en el panel de filtros. Si desea volver a aplicar el filtro al campo, solo tiene que habilitarlo.

Utilice los siguientes procedimientos para obtener información sobre cómo habilitar o deshabilitar filtros.

## Deshabilitación de filtros en los conjuntos de datos
<a name="disable-a-filter-data-prep-datasets"></a>

Utilice el siguiente procedimiento para deshabilitar filtros en conjuntos de datos.

**Deshabilitación de un filtro en un conjunto de datos**

1. En la página de inicio de Quick, selecciona **Datos** a la izquierda.

1. En la pestaña **Conjuntos de datos**, elige el conjunto de datos que desees y, a continuación, selecciona **Editar conjunto** de datos.

1. En la página de preparación de datos que se abre, elija **Filtros** en la parte inferior izquierda.

1. En el panel **Filtros** de la izquierda, elija los tres puntos situados a la derecha del filtro que desee deshabilitar y elija **Deshabilitar**. Para habilitar un filtro que estaba deshabilitado, seleccione **Habilitar**.

## Deshabilitación de filtros en los análisis
<a name="disable-a-filter-data-prep-analyses"></a>

Utilice el siguiente procedimiento para deshabilitar filtros en análisis.

**Deshabilitación de un filtro en un análisis**

1. Abre la [consola rápida.](https://quicksight.aws.amazon.com/)

1. En la página de inicio de Quick, selecciona **Análisis**.

1. En la página **Análisis**, elija el análisis con el que desea trabajar.

1. En el análisis, elija el icono de **filtro** para abrir el panel de **filtros**.

1. En el panel **Filtros** que se abre, elija los tres puntos situados a la derecha del filtro que desee deshabilitar y elija **Deshabilitar**. Para habilitar un filtro que estaba deshabilitado, seleccione **Habilitar**.

# Eliminación de filtros
<a name="delete-a-filter-data-prep"></a>

Puede eliminar los filtros en cualquier momento en un análisis o conjunto de datos. Utilice los siguientes procedimientos para obtener información sobre cómo hacerlo.

## Eliminación de filtros en conjuntos de datos
<a name="delete-a-filter-data-prep-datasets"></a>

Utilice el siguiente procedimiento para eliminar filtros en conjuntos de datos.

**Eliminación de un filtro en un conjunto de datos**

1. Abra la [consola rápida](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, selecciona **Datos**.

1. En la pestaña **Conjuntos de datos**, elija el conjunto de datos que desee y, a continuación, elija **Editar conjunto** de datos.

1. En la página de preparación de datos que se abre, elija **Filtros** en la parte inferior izquierda.

1. Seleccione el filtro que desea eliminar y, a continuación, haga clic en **Eliminar filtro**.

## Eliminación de filtros en los análisis
<a name="delete-a-filter-data-prep-analyses"></a>

Utilice el siguiente procedimiento para eliminar filtros en análisis.

**Eliminación de un filtro en un análisis**

1. Abre la [consola rápida.](https://quicksight.aws.amazon.com/)

1. En la página de inicio de Quick, selecciona **Análisis**.

1. En la página **Análisis**, elija el análisis con el que desea trabajar.

1. En el análisis, elija el icono de **filtro** para abrir el panel de **filtros**.

1. Seleccione el filtro que desea eliminar y, a continuación, haga clic en **Eliminar filtro**.

# Vista previa de las tablas de un conjunto de datos
<a name="previewing-tables-in-a-dataset"></a>

Puede previsualizar cada tabla de datos individual de un conjunto de datos. Al elegir una tabla de datos para obtener una vista previa, aparece una vista previa de la tabla de solo lectura en una nueva pestaña de la sección de vista previa de datos. Puede tener varias pestañas de vista previa de la tabla abiertas a la vez.

Solo puede previsualizar las tablas a las que tiene acceso en un conjunto de datos. Si una tabla no aparece en la mitad superior del espacio de preparación de datos, no podrá obtener una vista previa de la tabla.

La pestaña **Conjunto de datos** contiene todas las transformaciones, como las columnas o los filtros nuevos. Las pestañas de vista previa de la tabla no muestran ninguna de las transformaciones.

**Obtención de la vista previa de una tabla de datos**

1. En la página de inicio de Quick, selecciona **Datos** a la izquierda.

1. En la pestaña **Datos**, elige el conjunto de datos que desees y elige **Editar conjunto de datos**.

1. Elija la tabla de datos de la que desea obtener una vista previa, seleccione la flecha hacia abajo para abrir el menú y seleccione **Mostrar vista previa de tabla**.

# Uso de SQL para personalizar los datos
<a name="adding-a-SQL-query"></a>

Al crear un conjunto de datos o preparar los datos para utilizarlos en un análisis, puede personalizar los datos en el editor de consultas. 

El editor de consultas se compone de varios componentes, como se muestra a continuación:
+ ****Modo de consulta****: en la parte superior izquierda, puede elegir entre los modos de consulta directa o consulta de SPICE:
  + **Consulta directa**: para ejecutar la instrucción SELECT directamente en la base de datos
  + **SPICE**: para ejecutar la instrucción SELECT con datos previamente almacenados en la memoria
+ ****Campos****: utilice esta sección para deshabilitar los campos que desee eliminar del conjunto de datos final. Puede añadir campos calculados en esta sección y aumentar sus datos con IA SageMaker 
+ ****Archivo de consultas****: utilice esta sección para buscar la versión anterior de sus consultas SQL.
+ ****Filtros****: utilice esta sección para añadir, editar o eliminar filtros.
+ ****Explorador de esquemas****: esta sección solo aparece mientras edita SQL. Puede utilizarlo para explorar esquemas, tablas, campos y tipos de datos.
+ ****Editor de SQL****: utilícelo para editar su SQL. El editor de SQL, ofrece resaltado de sintaxis, autocompletar básico, sangría automática y numeración de líneas. Puede especificar una consulta SQL solo para conjuntos de datos que provienen de orígenes de datos compatibles con SQL. Su SQL debe cumplir los requisitos de la base de datos de destino con respecto a la sintaxis, el uso de mayúsculas, la terminación de comandos, etc. Si lo prefiere, puede pegar SQL desde otro editor. 
+ ****Espacio de trabajo de datos****: cuando el editor de SQL está cerrado, el espacio de trabajo de datos se muestra en la parte superior derecha con un fondo de cuadrícula. Aquí puede ver una representación gráfica de los objetos de datos, incluidas consultas, tablas, archivos y uniones creadas en el editor de uniones.

  Para ver detalles de cada tabla, utilice el menú de opciones de origen de datos y elija **Detalles de tabla** o **Editar consulta SQL**. Se muestran detalles para el nombre y el alias de la tabla, el esquema, el nombre del origen de datos y el tipo de origen de datos. Para la configuración de carga de un archivo, elija **Configurar ajustes de carga** en el menú de opciones de origen de datos para ver o cambiar los siguientes ajustes:
  + Formato: el formato de archivo, CSV, CUSTOM, CLF, etc.
  + Fila inicial: la fila por la que empezar
  + Calificador de texto: comillas dobles o comillas simples
  + Encabezado: indica si el archivo incluye una fila de encabezado
+ ****Vista previa de filas****: aparece una vista previa de las filas muestreadas en la parte inferior derecha cuando el editor de configuración de uniones no está en uso.
+ **Editor de **configuración de uniones****: el editor de uniones se abre cuando hay más de un objeto de datos en el espacio de trabajo de datos. Para editar una unión, seleccione el icono de unión entre dos tablas (o archivos). Elija un tipo de unión y los campos que desea unir utilizando el panel de configuración de unión en la parte inferior de la pantalla. A continuación, elija **Aplicar** para crear la unión. Debe completar todas las uniones antes de poder guardar el trabajo.

Para agregar más consultas, tablas o archivos, utilice la opción **Añadir datos** sobre el espacio de trabajo. 

## Creación de una consulta SQL básica
<a name="add-a-SQL-query"></a>

Utilice el procedimiento siguiente para conectarse a un origen de datos mediante una consulta SQL personalizada.

**Creación de una consulta SQL básica**

1. Cree un nuevo origen de datos y valide la conexión.

1. Rellene las opciones necesarias para la conexión, sin embargo, no necesita seleccionar un esquema ni una tabla.

1. Elija **Usar SQL personalizado**. 

1. (Opcional) Puede escribir la consulta en el editor de SQL o continuar con el siguiente paso para usar la versión de pantalla completa. Para escribirla ahora, cree un nombre para la consulta. A continuación, escriba o pegue una consulta SQL en el editor. El editor de SQL ofrece resaltado de sintaxis, autocompletar básico, sangría automática y numeración de líneas.

   (Opcional) Seleccione **Confirmar consulta** para validarla y ver los ajustes de consulta directa, SPICE memoria e SageMaker IA.

1. Elija **Editar/Vista previa de datos**. Aparece el editor de consultas completo con el editor de SQL mostrado. La consulta se procesa y se muestra un ejemplo de los resultados de la consulta en el panel de vista previa de datos. Puede realizar cambios en el SQL y confirmarlos eligiendo **Aplicar**. Cuando haya terminado con el SQL, elija **Cerrar** para continuar. 

1.  En la parte superior, escriba un nombre para el conjunto de datos. A continuación, elija **Guardar y visualizar**. 

### Modificación de consultas existentes
<a name="modifying-existing-queries"></a>

**Actualización de una consulta SQL**

1. Abra el conjunto de datos con el que desea trabajar.

1. En el espacio de trabajo con la cuadrícula, busque el objeto en forma de caja que representa la consulta existente. 

1. Abra el menú de opciones en el objeto de consulta y elija **Editar la consulta SQL**. Si esta opción no aparece en la lista, el objeto de consulta no se basa en SQL.

   Para consultar versiones anteriores de consultas, abra el **Archivo de consultas** de la izquierda.

# Adición de datos geoespaciales
<a name="geospatial-data-prep"></a>

Puede marcar campos geográficos en sus datos para que Amazon Quick Sight pueda mostrarlos en un mapa. Amazon Quick Sight puede trazar coordenadas de latitud y longitud. También reconoce componentes geográficos, como, por ejemplo, el país, el estado o región, el condado o distrito, la ciudad y el código postal. También puede crear jerarquías geográficas que pueden romper la ambigüedad de entidades similares, por ejemplo, el mismo nombre de ciudad en dos estados.

**nota**  
Actualmente, algunos países no admiten los gráficos geoespaciales de Amazon Quick Sight, por ejemplo Regiones de AWS, en China. Estamos trabajando para agregar compatibilidad con más regiones.

Utilice los siguientes procedimientos para añadir tipos de datos y jerarquías geoespaciales a un conjunto de datos.

**Adición de tipos de datos y jerarquías geoespaciales a un conjunto de datos**

1. En la página de preparación de datos, etiquete los componentes geográficos con el tipo de datos correcto. 

   Puede hacer esto de varias formas. Una es elegir el campo en **Campos** y utilizar el icono de puntos suspensivos (**...**) para abrir el menú contextual. 

   A continuación, elija el tipo de datos geoespaciales correcto. 

   También puede cambiar el tipo de datos en el área de trabajo por los datos de muestra. Para hacerlo, elija el tipo de datos en el campo de datos. A continuación, elija el tipo de datos que desea asignar.

1. Compruebe que todos los campos geoespaciales necesarios para el mapeo están etiquetados como tipos de datos geoespaciales. Puede comprobarlo mirando el icono de marcador de lugar. Este icono aparecerá bajo los nombres de campo en la parte superior de la página, así como en el panel **Campos** de la izquierda.

   Compruebe también el nombre del tipo de datos, por ejemplo, latitud o país. 

1. (Opcional) Puede configurar una jerarquía o agrupación para los componentes geográficos (estado, ciudad) o para las coordenadas de latitud y longitud. Por tanto, debe añadir coordenadas de latitud y longitud en los cuadros de campo geoespacial.

   Para crear una jerarquía o agrupación, primero elija uno de estos campos en el panel **Campos**. Cada campo solo puede pertenecer a una jerarquía. No importa cuál elija en primer lugar o el orden en que añada los campos. 

   Elija el icono de puntos suspensivos (**…**) junto al nombre del campo. Después seleccione **Añadir a una jerarquía**.

1. En la pantalla **Añadir campo a jerarquía**, elija algo de lo siguiente:
   + Elija **Crear una nueva jerarquía geoespacial** para crear una nueva agrupación.
   + Elija **Añadir a jerarquía geoespacial existente** para añadir un campo a una agrupación que ya existe. Las jerarquías existentes que se muestran incluyen solo aquellos tipos geoespaciales coincidentes. 

   Elija **Agregar** para confirmar la elección.

1. En la pantalla **Crear jerarquía**, asigne un nombre a la jerarquía. 

   Si va a crear una agrupación de latitud y longitud, aparece la pantalla **Crear jerarquía**. Dependiendo de si ha elegido latitud y longitud en los pasos anteriores, se muestra la latitud o la longitud en esta pantalla. Asegúrese de que el campo de latitud aparece bajo **Campo que se va a usar para latitud**. Asegúrese también de que el campo de longitud aparece bajo **Campo que se va a usar para longitud**.

   En el caso de los componentes geográficos, la pantalla **Crear jerarquía** tiene dos opciones:
   + Elija **This hierarchy is for a single country** si los datos solo contiene un país. Elija el país específico en la lista. Los datos no tienen por qué contener todos los niveles de la jerarquía. Puede añadir los campos a la jerarquía en cualquier orden. 
   + Elija **This hierarchy is for multiple countries** si los datos contienen más de un país. Elija el campo que contiene los nombres de los países.

   Para cada tipo de jerarquía, seleccione **Actualizar** para continuar.

1. Continúe añadiendo todos los campos que necesite a la jerarquía. 

   Las agrupaciones geoespaciales aparecen en el panel **Campos**.

# Cambio de una agrupación geoespacial
<a name="geospatial-change-hierarchy"></a>

Puede cambiar una jerarquía geoespacial o agrupación existente dentro de un conjunto de datos.

Utilice el siguiente procedimiento para modificar o anular una jerarquía geoespacial.

**Edición o disolución de una jerarquía geoespacial**

1. Abra el conjunto de datos. En el panel **Campos**, elija el nombre de la jerarquía.

1. Elija el icono de puntos suspensivos (**...**) y después una de estas opciones.

   Elija **Desmantelar jerarquía** para eliminar la jerarquía del conjunto de datos. No podrá deshacer esta operación. Sin embargo, puede volver a crear la jerarquía o la agrupación empezando de nuevo en el paso 1. La disolución de la jerarquía no elimina ningún campo del conjunto de datos.

   Seleccione **Edit hierarchy** para realizar cambios en la jerarquía. Esto reabre las pantallas de creación para que pueda optar por diferentes opciones para reconstruir la jerarquía. 

# Solución de problemas geoespaciales
<a name="geospatial-troubleshooting"></a>

Utilice esta sección para descubrir los requisitos de Amazon Quick Sight para procesar correctamente los datos geoespaciales. Si Amazon Quick Sight no reconoce sus datos geoespaciales como geoespaciales, utilice esta sección como ayuda para solucionar el problema. Asegúrese de que los datos cumplen las directrices mostradas en la lista, para que funcionen en los elementos visuales geoespaciales.

**nota**  
Actualmente, algunos países no admiten los gráficos geoespaciales de Amazon Quick Sight, por ejemplo Regiones de AWS, en China. Estamos trabajando para agregar compatibilidad con más regiones.  
Si su ubicación geográfica sigue todas las pautas que se indican aquí y sigue generando errores, póngase en contacto con el equipo de Amazon Quick Sight desde la consola de Amazon Quick Sight. 

**Topics**
+ [Problemas de geocodificación](#geocoding)
+ [Problemas con la latitud y la longitud](#latitude-and-longitude)
+ [Áreas administrativas y códigos postales compatibles por país](#supported-admin-areas-postal-codes)

## Problemas de geocodificación
<a name="geocoding"></a>

Amazon Quick Sight geocodifica los nombres de los lugares en coordenadas de latitud y longitud. Utiliza estas coordenadas para mostrar los nombres de los lugares en el mapa. Amazon Quick Sight omite los lugares que no pueda geocodificar.

Para que este proceso funcione correctamente, los datos deben incluir el país como mínimo. Además, no puede haber nombres de lugares duplicados dentro de una denominación de lugar principal. 

Hay algunos problemas que impiden que aparezcan los nombres en un gráfico de mapa. Estos problemas incluyen ubicaciones no admitidas, ambiguas o no válidas, tal como se describe a continuación.

**Topics**
+ [Problemas con áreas no compatibles](#geospatial-unsupported-areas)
+ [Problemas con las ubicaciones ambiguas](#geospatial-ambiguous-locations)
+ [Problemas con datos geoespaciales no válidos](#geospatial-invalid-data)
+ [Problemas con el país predeterminado en la geocodificación](#geospatial-default-country)

### Problemas con áreas no compatibles
<a name="geospatial-unsupported-areas"></a>

Para asignar ubicaciones no compatibles, incluya las coordenadas de latitud y longitud en sus datos. Utilice estas coordenadas en el cuadro de campo geoespacial para que las ubicaciones se muestren en un gráfico de mapa. 

### Problemas con las ubicaciones ambiguas
<a name="geospatial-ambiguous-locations"></a>

Los datos geoespaciales no puede contener ubicaciones ambiguas. Por ejemplo, suponga que los datos contienen una ciudad denominada **Springfield**, pero el siguiente nivel en la jerarquía es el país. Dado que varios estados tienen una ciudad denominado **Springfield**, no es posible ubicar geográficamente la ubicación en un punto concreto de un mapa. 

Para evitar este problema, agregue datos geográficos suficientes para indicar qué ubicación debe mostrarse en un gráfico de mapa. Por ejemplo, puede añadir un nivel de estado en los datos y en la jerarquía. También puede agregar la latitud y la longitud.

### Problemas con datos geoespaciales no válidos
<a name="geospatial-invalid-data"></a>

Los datos geoespaciales no válidos se producen cuando la denominación de un lugar (una ciudad, por ejemplo) aparece en un nivel principal incorrecto (por ejemplo, un estado). Este problema puede deberse a un sencillo error ortográfico o a un error de entrada de datos. 

**nota**  
Amazon Quick Sight no admite regiones (por ejemplo, costa oeste o sur) como datos geoespaciales. Sin embargo, puede utilizar una región como filtro en un elemento visual.

### Problemas con el país predeterminado en la geocodificación
<a name="geospatial-default-country"></a>

Asegúrese de que está utilizando el país predeterminado correcto. 

El valor predeterminado para cada jerarquía se basa en el país o el campo de país que elija al crear la jerarquía. 

Para cambiar este valor predeterminado, puede volver a la pantalla **Crear jerarquía**. a continuación, modifique o cree una jerarquía y elija otro país. 

Si no crea una jerarquía, el país predeterminado se basa en su Región de AWS. Para obtener más información, consulte la tabla siguiente.


| Region | País predeterminado | 
| --- | --- | 
| Región Oeste de EE. UU (Oregon)  Región Este de EE. UU. (Ohio) Región Este de EE. UU (Norte de Virginia) | EE. UU. | 
| Asia-Pacífico (Singapur) | Singapur | 
| Asia-Pacífico (Sídney) | Australia | 
| Región Europa (Irlanda) | Irlanda | 

## Problemas con la latitud y la longitud
<a name="latitude-and-longitude"></a>

Amazon Quick Sight utiliza las coordenadas de latitud y longitud en segundo plano para buscar nombres de lugares en un mapa. Sin embargo, también puede utilizar las coordenadas para crear un mapa sin utilizar nombres de lugares. Este enfoque también funciona con los nombres de lugares no admitidos. 

Los valores de latitud y longitud deben ser numéricos. Por ejemplo, el punto del mapa indicado por **28.5383355 -81.3792365** es compatible con Amazon Quick Sight. Pero **28° 32' 18.0096'' N 81° 22' 45.2424'' W** no lo es. 

**Topics**
+ [Intervalos válidos para las coordenadas de latitud y longitud](#valid-ranges-for-coordinates)
+ [Uso de coordenadas con formato de grados, minutos y segundos (DMS)](#using-coordinates-in-dms-format)

### Intervalos válidos para las coordenadas de latitud y longitud
<a name="valid-ranges-for-coordinates"></a>

Amazon Quick Sight admite coordenadas de latitud y longitud dentro de rangos específicos. 




| Coordenada | Intervalo válido | 
| --- | --- | 
| Latitud | Entre -90 y 90 | 
| Longitud | Entre -180 y 180 | 

Amazon Quick Sight omite los datos que estén fuera de estos rangos. Out-of-rangelos puntos no se pueden mapear en un gráfico de mapa. 

### Uso de coordenadas con formato de grados, minutos y segundos (DMS)
<a name="using-coordinates-in-dms-format"></a>

Puede utilizar un campo calculado con una fórmula para crear el código de latitud y longitud a partir de cadenas de caracteres. Utilice esta sección para buscar diferentes formas de crear campos calculados en Amazon Quick Sight para analizar la latitud y longitud del GPS en latitud y longitud numéricas. 

En el siguiente ejemplo se pasa la latitud y la longitud a formato numérico a partir de campos independientes. Por ejemplo, supongamos que analiza **51° 30' 26.4636'' N 0° 7' 39.9288'' W** utilizando el espacio como delimitador. En este caso, puede utilizar algo como el ejemplo siguiente para convertir los campos resultantes en valores de latitud y longitud numéricos. 

En este ejemplo, los segundos van seguidos de dos comillas simples. Si los datos contienen comillas dobles, puede utilizar `strlen(LatSec)-1)` en lugar de `strlen(LatSec)-2)`.

```
/*Latitude*/
        ifelse(
        LatDir = "N",
        parseInt(split(LatDeg, "°", 1)) +
            (parseDecimal(split(LatMin, "'", 1) ) /60) +
            (parseDecimal((substring(LatSec, 1, strlen(LatSec)-2) ) ) /3600),
        (parseInt(split(LatDeg, "°", 1)) +
            (parseDecimal(split(LatMin, "'", 1) ) /60) +
            (parseDecimal((substring(LatSec, 1, strlen(LatSec)-2) ) ) /3600)) * -1
        )

/*Longitude*/
        ifelse(
        LongDir = "E",
        parseInt(split(LongDeg, "°", 1)) +
            (parseDecimal(split(LongMin, "'", 1) ) /60) +
            (parseDecimal((substring(LongSec, 1, strlen(LongSec)-2) ) ) /3600),
        (parseInt(split(LongDeg, "°", 1)) +
            (parseDecimal(split(LongMin, "'", 1) ) /60) +
            (parseDecimal((substring(LongSec, 1, strlen(LongSec)-2) ) ) /3600)) * -1
        )
```



Si los datos no incluyen los símbolos de grado, minuto y segundo, la fórmula tendrá un aspecto similar al siguiente.

```
/*Latitude*/
    ifelse(
        LatDir = "N",
        (LatDeg + (LatMin / 60) + (LatSec / 3600)),
        (LatDeg + (LatMin / 60) + (LatSec / 3600)) * -1
    )

/*Longitude*/
    ifelse(
        LongDir = "E",
        (LongDeg + (LongMin / 60) + (LongSec / 3600)),
        (LongDeg + (LongMin / 60) + (LongSec / 3600)) * -1
    )
```



En el siguiente ejemplo se convierte **53°21'N 06°15'W** en formato numérico. Sin embargo, al carecer de los segundos, esta ubicación no se representa con la misma precisión.

```
/*Latitude*/
ifelse(
    right(Latitude, 1) = "N",
    (parseInt(split(Latitude, '°', 1)) +
        parseDecimal(substring(Latitude, (locate(Latitude, '°',3)+1),  2) ) / 60) ,
    (parseInt(split(Latitude, '°', 1)) +
        parseDecimal(substring(Latitude, (locate(Latitude, '°',3)+1),  2) ) / 60) * -1
)

/*Longitude*/
ifelse(
    right(Longitude, 1) = "E",
    (parseInt(split(Longitude, '°', 1)) +
        parseDecimal(substring(Longitude, (locate(Longitude, '°',3)+1),  2) ) / 60) ,
    (parseInt(split(Longitude, '°', 1)) +
        parseDecimal(substring(Longitude, (locate(Longitude, '°',3)+1),  2) ) / 60) * -1
)
```



Los formatos de latitud y longitud de GPS pueden variar, de manera que puede personalizar las fórmulas para adaptarlas a sus datos. Para obtener más información, consulte los siguientes temas:
+ [Grados, minutos y segundos a grados decimales](https://www.latlong.net/degrees-minutes-seconds-to-decimal-degrees) en LatLong .net
+ [Convertir Degrees/Minutes/Seconds a decimales usando SQL](https://stackoverflow.com/questions/12186110/converts-degrees-minutes-seconds-to-decimals-using-sql) en Stack Overflow
+ [Geographic Coordinate Conversion](https://en.wikipedia.org/wiki/Geographic_coordinate_conversion) en Wikipedia

## Áreas administrativas y códigos postales compatibles por país
<a name="supported-admin-areas-postal-codes"></a>

A continuación se muestra una lista de las áreas administrativas compatibles por país.


**Áreas administrativas compatibles**  

| Country name (Nombre del país) | Código de país | País | Estado | County | Ciudad | 
| --- | --- | --- | --- | --- | --- | 
|  Aruba  |  ABW  |  País  |  Regions  |  Zonas  |    | 
|  Afganistán  |  AFG  |  País  |  Wilayat  |  Wuleswali  |  Localidades/áreas urbanas  | 
|  Angola  |  AGO  |  País  |  Provinces/províncias  |  Municipios  |  Localidades/áreas urbanas  | 
|  Anguila  |  AIA  |  País  |  Distritos  |    |    | 
|  Albania  |  ALB  |  País  |  Qarqe/qark  |  Comunas/bashki  |  Nuevas áreas si/Localities/Urban  | 
|  Andorra  |  AND  |  País  |  Distritos/parròquies  |  Localidades/áreas urbanas  |    | 
|  Emiratos Árabes Unidos  |  ARE  |  País  |  Emiratos  |  Municipios  |  Cities/Localities/UrbanÁreas  | 
|  Argentina  |  ARG  |  País  |  Provincias/provincias  |  Departamentos/departamentos  |  Comunas/barrios  | 
|  Armenia  |  ARM  |  País  |  Provincias/marzpet  |    |  Localidades/áreas urbanas  | 
|  Samoa Americana  |  SAM  |  País  |  Distritos  |  Condados  |  Pueblos  | 
|  Antártida  |  ATA  |  País  |    |    |    | 
|  Territorios Australes Franceses  |  ATF  |  País  |  Distritos  |    |    | 
|  Antigua y Barbuda  |  ATG  |  País  |  Distritos  |    |  Localidades/áreas urbanas  | 
|  Australia  |  AUS  |  País  |  Estados  |  Áreas de gobierno local  |  Barrios periféricos/centros urbanos  | 
|  Austria  |  AUT  |  País  |  Estados/Bundesländer  |  Distritos/Bezirke  |  Municipalities/Gemeinden/Urban Areas/Stadtteil  | 
|  Azerbaiyán  |  AZE  |  País  |  Regiones/Iqtisadi Rayonlar  |  Distritos/Rayonlar  |  Localidades/áreas urbanas  | 
|  Burundi  |  BDI  |  País  |  Provincias  |  Comunas  |  Localidades/áreas urbanas  | 
|  Bélgica  |  BEL  |  País  |  Regiones/Gewest  |  Provincias/Provincie  |  Districts/Arrondissements/Municipalities/Communes  | 
|  Benín  |  BEN  |  País  |  Departamentos  |  Comunas  |  Localidades/áreas urbanas  | 
|  Bonaire, San Eustasio y Saba  |  BES  |  País  |  Municipios  |    |  Localidades/áreas urbanas  | 
|  Burkina Faso  |  BFA  |  País  |  Regions  |  Provincias  |  Communes/Localities/UrbanÁreas  | 
|  Bangladesh  |  BGD  |  País  |  Divisiones/Bibhag  |  Distritos/Zila  |  Subdistricts/Upzila/Localities/UrbanÁreas  | 
|  Bulgaria  |  BGR  |  País  |  Oblasts  |  Obshtina  |  Localidades/áreas urbanas  | 
|  Bahréin  |  BHR  |  País  |  Gobernaciones  |  Circunscripciones  |  Localidades  | 
|  Bahamas  |  BHS  |  País  |  Grupos de islas  |  Distritos  |  Pueblos  | 
|  Bosnia y Herzegovina  |  BIH  |  País  |  Federación/Republika  |  Cantón  |  Áreas de Opš tina/Localities/Urban  | 
|  San Bartolomé  |  BLM  |  País  |    |    |  Localidades/áreas urbanas  | 
|  Bielorrusia  |  BLR  |  País  |  Voblasts  |  Rayon  |  Selsoviet/Localities/UrbanÁreas  | 
|  Belice  |  BLZ  |  País  |  Distritos  |  Circunscripciones  |  Localidades/áreas urbanas  | 
|  Bermudas  |  BMU  |  País  |  Distritos  |    |  Localidades/áreas urbanas  | 
|  Bolivia  |  BOL  |  País  |  Provincias/provincias  |  Departamentos/departamentos  |  Municipalities/Municipios/Localities/UrbanÁreas  | 
|  Brasil  |  BRA  |  País  |  Provinces/States/Unidades  |  Municipios/municipios  |  Localidades/áreas urbanas  | 
|  Barbados  |  BRB  |  País  |  Distritos  |    |  Localidades/áreas urbanas  | 
|  Brunéi  |  BRN  |  País  |  Distritos/Dawaïr  |  Subdistritos/Mukim  |  Villages/Kampung/Localities/UrbanÁreas  | 
|  Bután  |  BTN  |  País  |  Distritos/Dzongkhag  |    |  Localidades/áreas urbanas  | 
|  Isla Bouvet  |  BVT  |  País  |    |    |    | 
|  Botsuana  |  BWA  |  País  |  Distritos  |  Subdistritos  |  Localidades/áreas urbanas  | 
|  República Centroafricana  |  CAF  |  País  |  Regions  |  Prefecturas  |  Subprefecturas/comunas  | 
|  Canadá  |  CAN  |  País  |  Provincias/territorios  |  Divisiones censales  |  Subdivisions/Localities/UrbanÁreas censales  | 
|  Suiza  |  CHE  |  País  |  Cantons/Kanton/Cantone/Chantun  |  District/Bezirk/Distretto/Circul  |  «Commune/Gemeinde/Comune/Cumün/Localities/UrbanÁreas»  | 
|  Chile  |  CHL  |  País  |  Regiones/regiones  |  Provincia/Provincias  |  Communes/Comunas/Localities/UrbanÁreas  | 
|  China, República Popular  |  CHN  |  País  |  Provincias  |  Prefecturas  |  Ciudades/condados  | 
|  Costa de Marfil  |  CIV  |  País  |  Distritos  |  Regions  |  Departamentos/subprefecturas  | 
|  Camerún  |  CMR  |  País  |  Provincias/regiones  |  Departamentos  |  Arrondissements/ciudades  | 
|  Congo, República Democrática del  |  COD  |  País  |  Provincias  |  Distritos  |  Localidades/áreas urbanas  | 
|  Congo, República del  |  COG  |  País  |  Departamentos  |    |  Comunas/arrondissements  | 
|  Islas Cook  |  COK  |  País  |  Consejos Insulares  |    |    | 
|  Colombia  |  COL  |  País  |  Departamentos  |  Municipios  |  Localidades/áreas urbanas  | 
|  Comoras  |  COM  |  País  |  Islas autónomas/Îles Autonomes  |    |  Ciudades/pueblos  | 
|  Isla Clipperton  |  CPT  |  País  |    |    |    | 
|  Cabo Verde  |  CPV  |  País  |  Ilhas  |  Concelhos  |  Localidades/áreas urbanas  | 
|  Costa Rica  |  CRI  |  País  |  Provincias  |  Cantones  |  Distritos/Localities/UrbanÁreas  | 
|  Cuba  |  CUB  |  País  |  Provincias  |  Municipios  |  Localidades/áreas urbanas  | 
|  Curaçao  |  CUW  |  País  |    |    |  Localidades/áreas urbanas  | 
|  Islas Caimán  |  CYM  |  País  |  Distritos  |    |    | 
|  Chipre  |  CYP  |  País  |  Distritos/Eparchies  |  Municipios/Dimos  |  Localities/Urban Areas/Sinikia  | 
|  República Checa  |  CZE  |  País  |  Regiones/Kraj  |  Municipios/Orp  |  Obec/Mesto  | 
|  Alemania  |  DEU  |  País  |  Bundesland/estados  |  Kreis/distritos  |  Gemeinde/Municipalities/Stadtteil/Localities/UrbanÁreas  | 
|  Yibuti  |  DJI  |  País  |  Regions  |    |  Localidades/áreas urbanas  | 
|  Dominica  |  DMA  |  País  |  Distritos  |    |  Localidades/áreas urbanas  | 
|  Dinamarca  |  DNK  |  País  |  Regions  |  Provincias  |  Municipalities/Localities/UrbanÁreas  | 
|  República Dominicana  |  DOM  |  País  |  Regiones/regiones  |  Provincias/provincias  |  Municipalities/Municipios/Localities/UrbanÁreas  | 
|  Argelia  |  DZA  |  País  |  Provincias/Wilayas  |  Distritos  |  Municipalities/Baladiyas/Localities/UrbanÁreas  | 
|  Ecuador  |  ECU  |  País  |  Provincias  |  Cantones  |  Parishes/Localities/UrbanÁreas  | 
|  Egipto  |  EGY  |  País  |  Gobernaciones/Muhafazat  |  Divisiones municipales/Markaz  |  Towns/Cities/SubDivisiones municipales  | 
|  Eritrea  |  ERI  |  País  |  Regiones/Zoba  |  Distritos/Subzobas  |  Localidades/áreas urbanas  | 
|  España  |  ESP  |  País  |  Autonomas Communities/Comunidados autónomos  |  Provincias  |  Municipios/Localities/UrbanÁreas  | 
|  Estonia  |  EST  |  País  |  Maakond  |  Omavalitsus/Linn/Vald  |  Áreas Kü la/Localities/Urban  | 
|  Etiopía  |  ETH  |  País  |  Regiones/Kililoch  |  Zonas/Zonouch  |  Localidades/áreas urbanas  | 
|  Finlandia  |  FIN  |  País  |  Regiones/Maakunta  |  Subregiones/Seutukunta  |  Municipalities/Kunta/Localities/UrbanÁreas  | 
|  Fiyi  |  FJI  |  País  |  Divisiones  |  Provincias  |  Distritos/pueblos  | 
|  Islas Malvinas  |  FLK  |  País  |    |    |    | 
|  Francia  |  FRA  |  País  |  Regions  |  Départements  |  Arrondissements/cantones  | 
|  Islas Faroe  |  FRO  |  País  |  Regiones/Syslur  |  Municipios/Kommunur  |  Localidades/áreas urbanas  | 
|  Estados Federados de Micronesia  |  FSM  |  País  |  Estados  |    |    | 
|  Gabón  |  GAB  |  País  |  Provincias  |  Departamentos  |  Localidades/áreas urbanas  | 
|  Reino Unido  |  GBR  |  País  |  Naciones  |  Condados  |  Districts/Localities/UrbanÁreas  | 
|  Georgia  |  GEO  |  País  |  Regiones/Mkhare  |  Municipios/Munitsipaliteti  |  Localidades/áreas urbanas  | 
|  Ghana  |  GHA  |  País  |  Regions  |  Distritos  |  Localidades/áreas urbanas  | 
|  Gibraltar  |  GIB  |  País  |    |    |  Localidades/áreas urbanas  | 
|  Guinea  |  GIN  |  País  |  Regions  |  Prefecturas  |  Prefectures/Localities/UrbanSubáreas  | 
|  Guadalupe  |  GLP  |  País  |  Distritos  |  Comunas  |  Localidades/áreas urbanas  | 
|  Gambia  |  GMB  |  País  |  Regions  |  Distritos  |  Localidades/áreas urbanas  | 
|  Guinea-Bissau  |  GNB  |  País  |  Regions  |  Sectores  |  Localidades/áreas urbanas  | 
|  Guinea Ecuatorial  |  GNQ  |  País  |  Regions  |  Provincias  |  Distritos/Localities/UrbanÁreas  | 
|  Grecia  |  GRC  |  País  |  Regiones/Periphenies  |  Unidades regionales/Peri Enotities  |  Municipalities/Domoi/Localities/UrbanÁreas  | 
|  Granada  |  GRD  |  País  |  Estados  |  Distritos/dependencias  |  Localidades/áreas urbanas  | 
|  Groenlandia  |  GRL  |  País  |  Municipios/Kommunia  |    |    | 
|  Guatemala  |  GTM  |  País  |  Departamentos/departamentos  |  Municipios/municipios  |  Localidades/áreas urbanas  | 
|  Guayana Francesa  |  GUF  |  País  |  Distritos  |  Comunas  |  Localidades/áreas urbanas  | 
|  Guam  |    |  País = EE. UU.  |  Estados  |  Distritos  |    | 
|  Guyana  |  GUY  |  País  |  Regions  |  Juntas vecinales  |  Localidades/áreas urbanas  | 
|  Hong Kong  |  HKG  |  País  |  Distritos  |  Subdistritos  |  Localidades/áreas urbanas  | 
|  Heard e McDonald Islands  |  HMD  |  País  |    |    |    | 
|  Honduras  |  HND  |  País  |  Departamentos/departamentos  |  Municipios/municipios  |  Localidades/áreas urbanas  | 
|  Croacia  |  HRV  |  País  |  Condados  |  Municipios  |  Localidades/áreas urbanas  | 
|  Haití  |  HTI  |  País  |  Departamentos/Départements  |  Distritos/arrondissements  |  Communes/Localities/UrbanÁreas  | 
|  Hungría  |  HUN  |  País  |  Regiok  |  Megyék  |  Járások/Városok  | 
|  Indonesia  |  IDN  |  País  |  Provincias/Provinsi  |  Regencia/Kabupaten  |  Districts/Kecamatan/Localities/UrbanÁreas  | 
|  India  |  IND  |  País  |  Estados/territorios  |  Distritos  |  Subdistricts/Towns/Localities/UrbanÁreas  | 
|  Territorio Británico del Océano Índico  |  IOT  |  País  |    |    |    | 
|  Irlanda  |  IRL  |  País  |  Regions  |  Condados  |  Divisions/Localities/UrbanÁreas electorales  | 
|  Irán  |  IRN  |  País  |  Provincias/Ostanha  |  Condados/Shahrestan  |  Localidades/Dehestân  | 
|  Irak  |  IRQ  |  País  |  Gobernaciones/Muhafazat  |  Districts/Qadaa/Kaza  |  Áreas urbanas/localidades  | 
|  Iceland  |  ISL  |  País  |  Regiones/Landsvaedi  |  Municipios/Sveitarfelog  |  Localidades/áreas urbanas  | 
|  Israel  |  ISR  |  País  |  Distritos  |  Ciudades/consejos locales  |  Localidades/áreas urbanas  | 
|  Italia  |  ITA  |  País  |  Regiones  |  Provincias  |  Communes/Localities/UrbanÁreas  | 
|  Jamaica  |  JAM  |  País  |  Condados  |  Distritos  |  Constituencies/Localities/UrbanÁreas  | 
|  Jordania  |  JOR  |  País  |  Gobernaciones  |  Distritos  |  Subdistritos/ciudades  | 
|  Japón  |  JPN  |  País  |  Prefecturas  |    |  Cities/Districts/Municipalities  | 
|  Kazajistán  |  KAZ  |  País  |  Regiones/Oblystar  |  Distritos/Audandar  |  Towns/Kent/Localities/UrbanÁreas  | 
|  Kenia  |  KEN  |  País  |  Condados  |  Circunscripciones  |  Localities/Urban Areas/Suburbs  | 
|  Kirguistán  |  KGZ  |  País  |  Regiones/Oblasttar  |  Distritos/Raiones  |  Localidades/áreas urbanas  | 
|  Camboya  |  KHM  |  País  |  Provincias/Khaet  |  Distritos/Srŏk  |  Communes/Khum/Localities/UrbanÁreas  | 
|  Kiribati  |  KIR  |  País  |  Distritos  |  Consejos insulares  |    | 
|  San Cristóbal y Nieves  |  KNA  |  País  |  Distritos  |  Estados  |  Localidades/áreas urbanas  | 
|  Corea del Sur  |  KOR  |  País  |  Provincias/Do  |  Districts/Si/Gun  |  Localidades/áreas urbanas  | 
|  Kuwait  |  KWT  |  País  |  Gobernaciones/Muhafazah  |  Áreas/Mintaqah  |  Ciudades/comunidades  | 
|  Laos  |  LAO  |  País  |  Provincias/Khoueng  |  Distritos/Muang  |  Localidades/áreas urbanas  | 
|  Líbano  |  LBN  |  País  |  Gobernaciones/Muhafazat  |  Distritos/Qadaa  |  Municipalities/Localities/UrbanÁreas  | 
|  Liberia  |  LBR  |  País  |  Condados  |  Distritos  |  Clans/Localities/UrbanÁreas  | 
|  Libia  |  LBY  |  País  |  Distritos/Shabiya  |    |  Cities/Localities/UrbanÁreas  | 
|  Santa Lucía  |  LCA  |  País  |  Distritos/barrios  |    |  Localidades/áreas urbanas  | 
|  Liechtenstein  |  LIE  |  País  |  Distritos/Bezirk  |  Municipios/Gemeinden  |  Localidades/áreas urbanas  | 
|  Sri Lanka  |  LKA  |  País  |  Provincias  |  Distritos  |  Áreas divisionales Secretariats/Localities/Urban  | 
|  Lesoto  |  LSO  |  País  |  Distritos  |  Circunscripciones  |  Consejos comunales/localidades  | 
|  Lituania  |  LTU  |  País  |  Apskritis  |  Savivaldybé  |  Seniūnija  | 
|  Luxemburgo  |  LUX  |  País  |  Cantons/Kantounen/Kantone  |  Communes/Gemengen/Gemeinden  |  Localities/Ortschaft/Uertschaft/Cities  | 
|  Letonia  |  LVA  |  País  |  Regions  |  Municipios/Novadi  |  Áreas de Pils tas/Pagasti/Localities/Urban  | 
|  Macao  |  MAC  |  País  |  Distritos  |  Distritos  |    | 
|  San Martín (Francia)  |  MAF  |  País  |    |    |  Localidades/áreas urbanas  | 
|  Marruecos  |  MAR  |  País  |  Regions  |  Provincias/prefecturas  |  Communes/Localities/UrbanÁreas  | 
|  Mónaco  |  MCO  |  País  |  Comunas  |  Barrios/barrios  |    | 
|  Moldavia  |  MDA  |  País  |  Raion  |  Comuna  |  Localidades/áreas urbanas  | 
|  Madagascar  |  MDG  |  País  |  Regiones/Faritra  |  Distritos  |  Communes/Localities/UrbanÁreas  | 
|  Maldivas  |  MDV  |  País  |  Atolones/ciudades  |  Islas  |    | 
|  México  |  MEX  |  País  |  Estados  |  Municipios/delegaciones  |  Colonias/Localities/UrbanÁreas  | 
|  Islas Marshall  |  MHL  |  País  |  Municipios  |    |    | 
|  Macedonia  |  MKD  |  País  |  Regiones estadísticas  |  Opstina  |  Localidades/áreas urbanas  | 
|  Mali  |  MLI  |  País  |  Regions  |  Comunas  |  Localidades/áreas urbanas  | 
|  Malta  |  MLT  |  País  |  Distritos  |   Councils/Kunsilli Lokali local  |  Localidades/áreas urbanas  | 
|  Myanmar  |  MMR  |  País  |  States/Regions/UnionTerritorios  |  Distritos  |  Townships/Localities/UrbanÁreas  | 
|  Montenegro  |  MNE  |  País  |  Opštine/municipios  |    |  Localidades/áreas urbanas  | 
|  Mongolia  |  MNG  |  País  |  Regions  |  Provincias/Aimags  |  Districts/Sums/Localities/UrbanÁreas  | 
|  Islas Marianas del Norte  |  MNP  |  País  |  Municipios  |    |    | 
|  Mozambique  |  MOZ  |  País  |  Provincias  |  Distritos/distritos  |  Localidades/áreas urbanas  | 
|  Mauritania  |  MRT  |  País  |  Regions  |  Départements  |  Localidades/áreas urbanas  | 
|  Montserrat  |  MSR  |  País  |  Distritos  |  Regions  |  Localidades/áreas urbanas  | 
|  Martinica  |  MTQ  |  País  |  Distritos  |  Comunas  |  Localidades/áreas urbanas  | 
|  Mauricio  |  MUS  |  País  |  Islas  |  Distritos  |  Wards/Localities/UrbanÁreas  | 
|  Malawi  |  MWI  |  País  |  Regions  |  Distritos  |  Localidades/áreas urbanas  | 
|  Malasia  |  MYS  |  País  |  Estados/Negeri  |  Districts/Daïra/Daerah  |  Subdistricts/Mukim/Localities/Urban Area/BahagianKecil  | 
|  Mayotte  |  MYT  |  País  |  Comunas  |    |  Pueblos  | 
|  Namibia  |  NAM  |  País  |  Provincias  |  Circunscripciones  |  Barrios periféricos/localidades  | 
|  Nueva Caledonia  |  NCL  |  País  |  Provincias  |  Comunas  |    | 
|  Níger  |  NER  |  País  |  Regions  |  Departamentos  |  Localidades/áreas urbanas  | 
|  Nigeria  |  NGA  |  País  |  Estados  |  Áreas de gobierno local  |  Pueblos/ciudades  | 
|  Nicaragua  |  NIC  |  País  |  Departamentos/departamentos  |  Municipios/municipios  |  Localidades/áreas urbanas  | 
|  Niue  |  NIU  |  País  |  Pueblos  |    |  Pueblos  | 
|  Países Bajos  |  NLD  |  País  |  Condados/Fylker  |  Distritos/Okonomisk  |  Municipios, Kommuner, localidades o áreas urbanas  | 
|  Noruega  |  NOR  |  País  |  Condados/Fylker  |  Distritos/Okonomisk  |  Municipios, Kommuner, localidades o áreas urbanas  | 
|  Nepal  |  NPL  |  País  |  Provincias/Pradeshaharu  |  Distritos/Jilla  |  Municipalities/Localities/UrbanÁreas  | 
|  Nauru  |  NRU  |  País  |  Distritos  |    |    | 
|  Nueva Zelanda  |  NZL  |  País  |  Regions  |  Autoridades territoriales  |  Areas/Localities/UrbanÁreas estadísticas  | 
|  Omán  |  OMN  |  País  |  Gobernaciones/Muhafazah  |  Provincias/Wilayat  |  Cities/Urban Areas/Communities  | 
|  Pakistán  |  PAK  |  País  |  Provincias  |  Distritos  |  Localidades/Tehsils  | 
|  Panamá  |  PAN  |  País  |  Provincias/provincias  |  Distritos/distrito  |  Corregimientos/Localities/UrbanÁreas  | 
|  Islas Pitcairn  |  PCN  |  País  |  Islas  |    |    | 
|  Perú  |  PER  |  País  |  Regions  |  Distritos  |  Distritos/Localities/UrbanÁreas  | 
|  Filipinas  |  PHP  |  País  |  Regiones/Rehiyon  |  Provincias/Lalawigan  |  Municipalities/Munisipiyos/Cities/Lungsod  | 
|  Palaos  |  PLW  |  País  |  Estados  |    |    | 
|  Papúa Nueva Guinea  |  PNG  |  País  |  Regions  |  Provincias  |  Districts/Localities/UrbanÁreas  | 
|  Polonia  |  POL  |  País  |  Provincias/Voivodados  |  Condados/Powiats  |  Communes/Gminas/Towns/Dzielnicas  | 
|  Corea del Norte  |  PRK  |  País  |  Provincias  |    |  Localidades/áreas urbanas  | 
|  Portugal  |  PRT  |  País  |  Distritos/distritos  |  Municipios/concelhos  |  Parish/Freguesias/Localities/UrbanÁreas civiles  | 
|  Paraguay  |  PRY  |  País  |  Departamentos  |  Distritos  |  Localidades/áreas urbanas  | 
|  Palestina  |  PSE  |  País  |  Territorios  |  Gobernaciones/Muhafazat  |  Localidades/áreas urbanas  | 
|  Polinesia Francesa  |  PYF  |  País  |  Subdivisiones/islas  |  Comunas  |    | 
|  Catar  |  QAT  |  País  |  Municipios/Baladiyat  |  Zonas  |  Localidades/áreas urbanas  | 
|  Reunión  |  REU  |  País  |  Distritos  |  Comunas  |  Localidades/áreas urbanas  | 
|  Rumanía  |  ROU  |  País  |  Regiones/Judete  |  Comunas  |  Pueblos/Oraș  | 
|  Rusia  |  RUS  |  País  |  Distrito federal/Federal'nyy Okrug  |  Oblast'  |  Rayon/Raion/Urban Area/Gorod  | 
|  Ruanda  |  RWA  |  País  |  Provincias  |  Distritos  |  Sectors/Secteurs/Localities/UrbanÁreas  | 
|  Arabia Saudí  |  SAU  |  País  |  Regiones/Manatiq  |  Gobernaciones/Muhafazat  |  Municipios/Amanah  | 
|  Sudán  |  SDN  |  País  |  Estados/Wilaya'at  |    |  Localidades/áreas urbanas  | 
|  Senegal  |  SEN  |  País  |  Regions  |  Departamentos  |  Arrondissements/Localities/UrbanÁreas  | 
|  Singapur  |  SGP  |  País  |  Distritos  |  Circunscripciones  |  Distritos electorales  | 
|  Santa Elena  |  SHN  |  País  |  Islas  |  Distritos  |  Localidades/áreas urbanas  | 
|  Islas Salomón  |  SLB  |  País  |  Provincias  |  Circunscripciones  |  Distritos electorales  | 
|  Sierra Leona  |  SLE  |  País  |  Provincias  |  Distritos  |  Chiefdoms/Localities/UrbanÁreas  | 
|  El Salvador  |  SLV  |  País  |  Departamentos/departamentos  |  Municipios/municipios  |  Localidades/áreas urbanas  | 
|  San Marino  |  SMR  |  País  |  Municipios/Castelli  |  Localidades/áreas urbanas  |    | 
|  Somalia  |  SOM  |  País  |  Regiones/Gobolada  |    |  Localidades/áreas urbanas  | 
|  San Pedro y Miquelón  |  SPM  |  País  |  Comunas  |    |    | 
|  Serbia  |  SRB  |  País  |  Autonomna Pokrajina/regions  |  Okrug/distritos  |  Opstina/Municipalities/Localities/UrbanÁreas  | 
|  Sudán del Sur  |  SSD  |  País  |  Estados/Wilayat  |  Condados  |  Localidades/áreas urbanas  | 
|  Santo Tomé y Príncipe  |  STP  |  País  |  Provincias  |  Distritos  |  Localidades/áreas urbanas  | 
|  Surinam  |  SUR  |  País  |  Distritos/Distrikt  |  Centros turísticos  |  Localidades/áreas urbanas  | 
|  Eslovaquia  |  SVK  |  País  |  Regiones/Kraje  |  Distritos/Okresy  |  Municipalities/Obec/MestskEn la costa  | 
|  Eslovenia  |  SVN  |  País  |  Regiones/Regi  |  Upravne Enote  |  Municipalities/Obcine/Localities/UrbanÁreas  | 
|  Suecia  |  SWE  |  País  |  Condados  |  Municipios  |  Localidades/áreas urbanas  | 
|  Suazilandia  |  SWZ  |  País  |  Regions  |  Tinkhundla  |  Towns/Suburbs/Localities  | 
|  San Martín (Países Bajos)  |  SXM  |  País  |  Asentamientos  |    |    | 
|  Seychelles  |  SYC  |  País  |  Distritos  |    |  Localidades/áreas urbanas  | 
|  Siria  |  SYR  |  País  |  Gobernaciones  |  Distritos/Muhafazah  |  Cities/Localities/UrbanÁreas  | 
|  Islas Turcas y Caicos  |  TCA  |  País  |  Distritos  |  Localidades  |    | 
|  Chad  |  TCD  |  País  |  Regions  |  Départements  |  Arrondissements/Localities/UrbanÁreas  | 
|  Togo  |  TGO  |  País  |  Regiones/provincias  |  Prefecturas  |  Localidades/áreas urbanas  | 
|  Tailandia  |  THA  |  País  |  Provincias/Changwat  |  Distritos/Amphoe  |  Subdistricts/Tambon/Localities/UrbanÁreas  | 
|  Tayikistán  |  TJK  |  País  |  Provincias/regiones  |  Districts/Raion/Rayon  |  Localidades/áreas urbanas  | 
|  Tokelau  |  TKL  |  País  |  Atolones  |    |    | 
|  Turkmenistán  |  TKM  |  País  |  Provincias/Welayat  |  Distritos/Etraplar  |  Pueblos  | 
|  Timor Oriental (Timor-Leste)  |  TLS  |  País  |  Municipios  |  Puesto administrativo  |  Localidades/áreas urbanas  | 
|  Tonga  |  TON  |  País  |  Subdivisiones  |    |    | 
|  Trinidad y Tobago  |  TTO  |  País  |  Municipios  |    |  Localidades/áreas urbanas  | 
|  Túnez  |  TUN  |  País  |  Provincias/Wilayahs  |  Delegaciones/Mutamadiyats  |  Municipalities/Shaykhats/Localities/UrbanÁreas  | 
|  Turquía  |  TUR  |  País  |  Provincias/Il  |  Distritos/Ilce  |  Urbano Areas/Belde/Subdistricts/Bucak/Neighborhoods/Mahalle  | 
|  Tuvalu  |  TUV  |  País  |  Islas  |    |    | 
|  Taiwán  |  TWN  |  País  |  Provincias  |  Condados  |  Municipios/barrios locales  | 
|  Tanzania  |  TZA  |  País  |  Provincias/Moka  |  Distritos/Wilaya  |  Localidades/áreas urbanas  | 
|  Uganda  |  UGA  |  País  |  Regions  |  Distritos  |  Counties/Localities/UrbanÁreas  | 
|  Ucrania  |  UKR  |  País  |  Oblast/Mista/AvtonomnaRespublika  |  Raions  |  Áreas de asentamiento Councils/Rural Councils/Localities/Urban  | 
|  Islas Ultramarinas Menores de Estados Unidos  |  UMI  |  País  |  Islas/atolones  |    |    | 
|  Uruguay  |  URY  |  País  |  Departamentos/departamentos  |  Municipios/Municipalities/Secciones  |  Segmentos/Localities/UrbanÁreas  | 
|  Estados Unidos de América  |  USA  |  País  |  Estados/territorios  |  Condados  |  MCD/CCD/Post Localities/Municipalities  | 
|  Uzbekistán  |  UZB  |  País  |  Regiones/Viloyatlar  |  Distritos/Tumanlar  |  Localidades/áreas urbanas  | 
|  Ciudad del Vaticano  |  VAT  |  País  |    |    |  Localidades/áreas urbanas  | 
|  San Vicente y las Granadinas  |  VCT  |  País  |  Distritos  |  Divisiones  |  Localidades/áreas urbanas  | 
|  Venezuela  |  VEN  |  País  |  Estados/estados  |  Municipios/municipios  |  Localities/Urban Areas/Parish/Parroquias  | 
|  Islas Vírgenes Británicas  |  VGB  |  País  |  Distritos  |    |    | 
|  Vietnam  |  VNM  |  País  |  Provincias/ciudades  |  Distritos  |  Wards/Localities/UrbanÁreas  | 
|  Vanuatu  |  VUT  |  País  |  Provincias  |    |    | 
|  Islas Wallis y Futuna  |  WLF  |  País  |  Distritos/Rayaumes  |    |    | 
|  Samoa  |  WSM  |  País  |  Distritos/Itūmālō  |  Pueblos  |  Localidades/áreas urbanas  | 
|  Kosovo  |  XKS  |  País  |  Distritos  |  Municipios  |  Localidades/áreas urbanas  | 
|  Yemen  |  YEM  |  País  |  Gobernaciones/Muhafazat  |  Distritos/Muderiah  |  Localidades/áreas urbanas  | 
|  Sudáfrica  |  ZAF  |  País  |  Provincias  |  Distritos  |  Municipios/distritos electorales  | 
|  Zambia  |  ZMB  |  País  |  Provincias  |  Distritos  |  Barrios periféricos/localidades  | 
|  Zimbabue  |  ZWE  |  País  |  Provincias  |  Distritos/Muderiah  |  Localidades/áreas urbanas  | 

A continuación se muestra una lista de los formatos de códigos postales admitidos por país, que incluye el número de dígitos y un código postal de ejemplo.

**nota**  
Los códigos postales de PO BOX no son formatos de códigos postales compatibles. Tampoco se admiten los códigos postales de los territorios de la Unión que se utilizan en la India.


**Códigos postales compatibles**  

| País | Formato postal | Ejemplo | 
| --- | --- | --- | 
|  Afganistán  |  4 dígitos  |  1001  | 
|  Albania  |  4 dígitos  |  1001  | 
|  Argelia  |  5 dígitos  |  01000  | 
|  Samoa Americana  |  5 dígitos  |  96799  | 
|  Andorra  |  5 dígitos  |  AD100  | 
|  Anguila  |  6 dígitos  |  AI-2640  | 
|  Argentina  |  5 dígitos  |  A4126  | 
|  Armenia  |  2 dígitos  |  00  | 
|  Australia  |  4 dígitos  |  0800  | 
|  Austria  |  4 dígitos  |  1010  | 
|  Azerbaiyán  |  2 dígitos  |  01  | 
|  Brunéi  |  6 dígitos  |  BA1111  | 
|  Bahréin  |  4 dígitos  |  0101  | 
|  Bangladesh  |  2 dígitos  |  10  | 
|  Bielorrusia  |  6 dígitos  |  202115  | 
|  Bélgica  |  4 dígitos  |  1 000  | 
|  Bermudas  |  4 dígitos  |  CR 01  | 
|  Bután  |  2 dígitos  |  11  | 
|  Bosnia y Herzegovina  |  5 dígitos  |  70101  | 
|  Brasil  |  5 dígitos  |  01001  | 
|  Territorio Británico del Océano Índico  |  Alfanumérico: 5 dígitos  |  BBND 1  | 
|  Islas Vírgenes Británicas  |  4 dígitos  |  1110  | 
|  Bulgaria  |  4 dígitos  |  1 000  | 
|  Cabo Verde  |  4 dígitos  |  1101  | 
|  Camboya  |  2 dígitos  |  01  | 
|  Canadá  |  3 dígitos  |  A0A  | 
|  Islas Caimán  |  Alfanumérico: 7 dígitos  |  KY1-1000  | 
|  Chile  |  3 dígitos  |  100  | 
|  China  |  4 dígitos  |  0100  | 
|  Colombia  |  4 dígitos  |  0500  | 
|  Costa Rica  |  5 dígitos  |  10101  | 
|  Croacia  |  5 dígitos  |  10000  | 
|  Cuba  |  1 dígito  |  1  | 
|  Chipre  |  4 dígitos  |  1010  | 
|  Chequia  |  5 dígitos  |  100 00  | 
|  República Democrática del Congo  |  4 dígitos  |  1001  | 
|  Dinamarca  |  4 dígitos  |  1050  | 
|  República Dominicana  |  5 dígitos  |  10101  | 
|  Ecuador  |  6 dígitos  |  010101  | 
|  Egipto  |  2 dígitos  |  11  | 
|  El Salvador  |  4 dígitos  |  1101  | 
|  Estonia  |  5 dígitos  |  10001  | 
|  Islas Malvinas  |  Alfanumérico: 5 dígitos  |  FIQQ 1  | 
|  Islas Faroe  |  3 dígitos  |  100  | 
|  Finlandia  |  5 dígitos  |  00100  | 
|  Francia  |  5 dígitos  |  01000  | 
|  Guayana Francesa  |  5 dígitos  |  97300  | 
|  Polinesia Francesa  |  5 dígitos  |  98701  | 
|  Georgia  |  2 dígitos  |  01  | 
|  Alemania  |  5 dígitos  |  01067  | 
|  Ghana  |  2 dígitos  |  A2  | 
|  Gibraltar  |  Alfanumérico: 5 dígitos  |  GX11 1  | 
|  Grecia  |  5 dígitos  |  104 31  | 
|  Groenlandia  |  4 dígitos  |  3900  | 
|  Guadalupe  |  5 dígitos  |  97100  | 
|  Guam  |  5 dígitos  |  96910  | 
|  Guatemala  |  5 dígitos  |  01001  | 
|  Guernsey  |  Alfanumérico: 4 dígitos, 5 dígitos  |  GY1 1, GY10 1  | 
|  Guinea-Bissau  |  4 dígitos  |  1 000  | 
|  Haití  |  4 dígitos  |  1110  | 
|  Santa Sede  |  5 dígitos  |  00120  | 
|  Honduras  |  2 dígitos  |  11  | 
|  Hungría  |  4 dígitos  |  1007  | 
|  Iceland  |  3 dígitos  |  101  | 
|  India  |  6 dígitos  |  110001  | 
|  Indonesia  |  5 dígitos  |  10110  | 
|  Irán  |  2 dígitos  |  11  | 
|  Irak  |  2 dígitos  |  10  | 
|  Irlanda  |  3 dígitos  |  A41  | 
|  Isla de Man  |  Alfanumérico: 4 dígitos  |  IM1 1  | 
|  Israel  |  5 dígitos  |  10292  | 
|  Italia  |  5 dígitos  |  00010  | 
|  Japón  |  7 dígitos  |  001-0010  | 
|  Jersey  |  Alfanumérico: 4 dígitos  |  JE2 3  | 
|  Jordania  |  5 dígitos  |  11100  | 
|  Kazajistán  |  4 dígitos  |  0100  | 
|  Kenia  |  1 dígito  |  0  | 
|  Kiribati  |  6 dígitos  |  KI0101  | 
|  Kosovo  |  5 dígitos  |  10000  | 
|  Kuwait  |  2 dígitos  |  00  | 
|  Kirguistán  |  4 dígitos  |  7200  | 
|  Laos  |  2 dígitos  |  01  | 
|  Letonia  |  4 dígitos  |  1001  | 
|  Lesoto  |  1 dígito  |  1  | 
|  Liberia  |  2 dígitos  |  10  | 
|  Liechtenstein  |  4 dígitos  |  9485  | 
|  Lituania  |  5 dígitos  |  00100  | 
|  Luxemburgo  |  4 dígitos  |  1110  | 
|  Macedonia  |  4 dígitos  |  1 000  | 
|  Madagascar  |  3 dígitos  |  101  | 
|  Malawi  |  3 dígitos  |  101  | 
|  Malasia  |  5 dígitos  |  01000  | 
|  Maldivas  |  2 dígitos  |  00  | 
|  Malta  |  3 dígitos  |  ATD  | 
|  Islas Marshall  |  3 dígitos  |  969  | 
|  Martinica  |  5 dígitos  |  97200  | 
|  Mauricio  |  3 dígitos  |  111  | 
|  Mayotte  |  5 dígitos  |  97600  | 
|  México  |  5 dígitos  |  01000  | 
|  Micronesia  |  5 dígitos  |  96941  | 
|  Moldavia  |  4 dígitos  |  2001  | 
|  Mónaco  |  5 dígitos  |  98000  | 
|  Mongolia  |  4 dígitos  |  1200  | 
|  Montenegro  |  5 dígitos  |  81000  | 
|  Montserrat  |  4 dígitos  |  1120  | 
|  Marruecos  |  5 dígitos  |  10000  | 
|  Mozambique  |  4 dígitos  |  1 100  | 
|  Myanmar  |  2 dígitos  |  01  | 
|  Namibia  |  3 dígitos  |  100  | 
|  Nepal  |  3 dígitos  |  101  | 
|  Países Bajos  |  4 dígitos  |  1011  | 
|  Nueva Caledonia  |  5 dígitos  |  98800  | 
|  Nueva Zelanda  |  4 dígitos  |  0110  | 
|  Nicaragua  |  3 dígitos  |  110  | 
|  Níger  |  4 dígitos  |  1 000  | 
|  Nigeria  |  4 dígitos  |  1002  | 
|  Niue  |  4 dígitos  |  9974  | 
|  Isla Norfolk  |  4 dígitos  |  2899  | 
|  Islas Marianas del Norte  |  5 dígitos  |  96950  | 
|  Noruega  |  4 dígitos  |  0010  | 
|  Omán  |  1 dígito  |  1  | 
|  Pakistán  |  2 dígitos  |  10  | 
|  Palaos  |  5 dígitos  |  96939  | 
|  Palestina  |  4 dígitos  |  P104  | 
|  Papúa Nueva Guinea  |  3 dígitos  |  111  | 
|  Paraguay  |  6 dígitos  |  001001  | 
|  Perú  |  5 dígitos  |  01000  | 
|  Filipinas  |  4 dígitos  |  1 000  | 
|  Pitcairn  |  Alfanumérico: 5 dígitos  |  PCRN 1  | 
|  Polonia  |  5 dígitos  |  00-002  | 
|  Portugal  |  4 dígitos  |  1 000  | 
|  Puerto Rico  |  5 dígitos  |  00601  | 
|  Rumanía  |  6 dígitos  |  010011  | 
|  Rusia  |  6 dígitos  |  101000  | 
|  Reunión  |  5 dígitos  |  97400  | 
|  San Bartolomé  |  5 dígitos  |  97133  | 
|  Santa Elena, Ascensión y Tristán de Acuña  |  Alfanumérico: 5 dígitos  |  ASCN 1  | 
|  Santa Lucía  |  7 dígitos  |  LC01 101  | 
|  San Martín (Francia)  |  5 dígitos  |  97150  | 
|  San Pedro y Miquelón  |  5 dígitos  |  97500  | 
|  San Vicente y las Granadinas  |  4 dígitos  |  VC01  | 
|  Samoa  |  2 dígitos  |  11  | 
|  San Marino  |  5 dígitos  |  47890  | 
|  Arabia Saudí  |  2 dígitos  |  12  | 
|  Senegal  |  5 dígitos  |  10000  | 
|  Serbia  |  5 dígitos  |  11000  | 
|  Singapur  |  6 dígitos  |  018906  | 
|  Eslovaquia  |  5 dígitos  |  010 01  | 
|  Eslovenia  |  4 dígitos  |  1 000  | 
|  Sudáfrica  |  4 dígitos  |  0001  | 
|  Islas Georgias del Sur y Sandwich del Sur  |  Alfanumérico: 5 dígitos  |  SIQQ 1  | 
|  Corea del Sur  |  5 dígitos  |  01000  | 
|  España  |  5 dígitos  |  01001  | 
|  Sri Lanka  |  2 dígitos  |  00  | 
|  Sudán  |  2 dígitos  |  11  | 
|  Svalbard y Jan Mayen  |  4 dígitos  |  8099  | 
|  Suazilandia  |  1 dígito  |  H  | 
|  Suecia  |  5 dígitos  |  111 15  | 
|  Suiza  |  4 dígitos  |  1 000  | 
|  Taiwán  |  3 dígitos  |  100  | 
|  Tayikistán  |  4 dígitos  |  7340  | 
|  Tanzania, República Unida de  |  3 dígitos  |  111  | 
|  Tailandia  |  5 dígitos  |  10100  | 
|  Timor Oriental  |  4 dígitos  |  TL10  | 
|  Trinidad y Tobago  |  2 dígitos  |  10  | 
|  Túnez  |  4 dígitos  |  1 000  | 
|  Turquía  |  5 dígitos  |  01010  | 
|  Turkmenistán  |  3 dígitos  |  744  | 
|  Islas Turcas y Caicos  |  Alfanumérico: 5 dígitos  |  TKCA 1  | 
|  Islas Vírgenes (EE. UU.)  |  5 dígitos  |  00802  | 
|  Ucrania  |  3 dígitos, 5 dígitos  |  070, 01001  | 
|  Reino Unido  |  Alfanumérico: de 2 a 5 dígitos  |  B1, AL1 AB10, AB10 1  | 
|  Estados Unidos  |  5 dígitos  |  001  | 
|  Uruguay  |  5 dígitos  |  11000  | 
|  Uzbekistán  |  4 dígitos  |  1 000  | 
|  Venezuela  |  4 dígitos  |  0000  | 
|  Vietnam  |  5 dígitos  |  01106  | 
|  Wallis y Futuna  |  5 dígitos  |  98600  | 
|  Zambia  |  5 dígitos  |  10100  | 

# Uso de fechas no admitidas o personalizadas
<a name="using-unsupported-dates"></a>

Amazon Quick Sight admite de forma nativa un número limitado de formatos de fecha. Sin embargo, no puede controlar siempre el formato de los datos proporcionados. Si sus datos contienen una fecha en un formato no compatible, puede indicar a Amazon Quick Sight cómo interpretarla.

Puede hacerlo editando el conjunto de datos y cambiando el formato de la columna de texto o numérico a fecha. Después de realizar este cambio aparecerá una pantalla para que pueda introducir el formato. Por ejemplo, si utiliza una fuente de datos relacional, puede especificar MM-dd-yyyy un campo de texto que contenga «09-19-2017», de modo que se interprete como 2017-09-19T 00:00:00.000 Z. Si utiliza un origen de datos no relacional, puede hacer lo mismo empezando por un campo numérico o un campo de texto.

Amazon Quick Sight solo admite texto actualizado para fuentes relacionales (SQL). 

Para obtener más información acerca de los formatos de fecha admitidos, consulte [Formatos de fecha admitidos](supported-data-types-and-values.md#supported-date-formats).

Utilice este procedimiento para ayudar a Amazon Quick Sight a entender las fechas en distintos formatos.

1. En el caso de un conjunto de datos que contenga formatos de fecha no admitidos, edite los datos como se indica a continuación. Para la columna que contenga sus datos de fecha y hora, cambie el tipo de datos de texto a fecha. Puede hacer esto eligiendo el icono de tipo de datos en color bajo el nombre de la columna en la vista previa de datos.
**nota**  
Las fechas de números enteros que no son horas y fecha de inicio Unix no funcionan tal y como están. Por ejemplo, no se admiten estos formatos como valores enteros: `MMddyy`, `MMddyyyy`, `ddMMyy`, `ddMMyyyy` y `yyMMdd`. La alternativa es cambiarlos primero al formato de texto. Asegúrese de que todas las filas contengan seis dígitos (no cinco). A continuación, cambie el tipo de datos de texto a datetime.  
Para obtener más información sobre fechas y hora de inicio Unix, consulte [epochDate](epochDate-function.md).

   Al cambiar el tipo de datos a fecha, aparece la pantalla **Edit date format**.

1. Escriba su formato de fecha, indicando qué partes son mes, fecha, año u hora. Los formatos distinguen entre mayúsculas y minúsculas. 

1. Elija **Validar** para asegurarse de que Amazon Quick Sight ahora puede interpretar sus datos de fecha y hora con el formato que especificó. Las filas que no se validan se saltan y se omiten del conjunto de datos.

1. Cuando esté satisfecho con los resultados, elija **Actualizar**. De lo contrario, seleccione **Cerrar**.

# Añadir una clave única a un conjunto de datos de Amazon Quick Sight
<a name="set-unique-key"></a>

Los autores de Quick Sight pueden configurar una columna clave única para un conjunto de datos de Quick Sight durante la preparación de los datos. Esta clave única actúa como una clave de clasificación global para el conjunto de datos y optimiza la generación de consultas para las visualizaciones de tablas. Cuando un usuario crea una tabla visual en Quick Sight y añade la columna clave única al campo de valores, los datos se ordenan de izquierda a derecha hasta llegar a la columna clave única. Todas las columnas situadas a la derecha de la columna clave única se omiten en el orden de clasificación. Las tablas que no contienen una clave única se ordenan según el orden en que aparecen las columnas en el conjunto de datos.

Las limitaciones siguientes se aplican a claves únicas:
+ Las claves únicas solo se admiten en tablas no agregadas.
+ Si se usa una columna de conjunto de datos para la seguridad de columna (CLS), la columna no se puede usar también como clave única.

Utilice el siguiente procedimiento para designar una clave única para un conjunto de datos en Amazon Quick Sight.

**Configuración de una clave única**

1. Abra la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Datos**.

1. Lleve a cabo una de las siguientes acciones:

   1. Vaya al conjunto de datos al que desea agregar una clave única, elija los puntos suspensivos (tres puntos) situados junto al conjunto de datos y, a continuación, elija **Editar**.

   1. Seleccione **Nuevo** y, a continuación, **Conjunto de datos**. Elija el conjunto de datos que desea agregar y, a continuación, elija **Editar fuente de datos**. Para obtener más información sobre la creación de nuevos conjuntos de datos en Amazon Quick Sight, consulte[Creación de conjuntos de datos](creating-data-sets.md).

1. Se abre la página de preparación de datos para las opciones del conjunto de datos. Vaya al panel **Campos** y busque el campo que desea establecer como clave única.

1. Elija los puntos suspensivos (…) junto al nombre del campo y, a continuación, elija **Establecer como clave única**.

Tras crear una clave única, aparece un icono de clave junto al campo para indicar que el campo es ahora la clave única del conjunto de datos. Al guardar y publicar el conjunto de datos, la configuración de clave única se aplica al conjunto de datos y a todos los paneles y análisis que se crean con ese conjunto de datos. Para eliminar una clave única de un conjunto de datos, vaya a la página de preparación de datos del conjunto de datos, elija los puntos suspensivos situados junto al campo de clave única y, a continuación, elija **Eliminar como clave única**. Después de eliminar una clave única de un conjunto de datos, puede designar un campo diferente como clave única.

# Integración de los modelos de Amazon SageMaker AI con Amazon Quick Sight
<a name="sagemaker-integration"></a>

**nota**  
No necesita experiencia técnica en aprendizaje automático (ML) para crear análisis y paneles que utilicen las funciones basadas en ML de Amazon Quick Sight. 

Puede aumentar los datos de la edición Amazon Quick Enterprise con los modelos de aprendizaje automático de Amazon SageMaker AI. Puede realizar inferencias a partir de los datos almacenados o SPICE importados desde cualquier fuente de datos compatible con Quick. Para obtener una lista completa de los orígenes de datos compatibles, consulte [Orígenes de datos admitidos](supported-data-sources.md). 

El uso de Quick con modelos de SageMaker IA puede ahorrarle tiempo que, de otro modo, podría dedicar a gestionar el movimiento de datos y a escribir código. Los resultados son útiles tanto para evaluar el modelo cuando está satisfecho con los resultados como para compartirlos con los responsables de la toma de decisiones. Puede comenzar inmediatamente después de que se haya creado el modelo. Al hacerlo, afloran los modelos prediseñados de sus científicos de datos y le permite aplicar la ciencia de datos a sus conjuntos de datos. A continuación, puede compartir estas ideas en sus paneles de predicciones. Con el enfoque Quick sin servidor, el proceso se escala sin problemas, por lo que no tiene que preocuparse por la capacidad de inferencia o consulta.

Amazon Quick admite modelos de SageMaker IA que utilizan algoritmos de regresión y clasificación. Puede aplicar esta característica para obtener predicciones para casi cualquier caso de uso empresarial. Algunos ejemplos incluyen la predicción de la probabilidad de rotación de clientes, el desgaste de los empleados, la puntuación de clientes potenciales y la evaluación de riesgos crediticios. Para utilizar Quick para proporcionar predicciones, los datos del modelo de SageMaker IA tanto para la entrada como para la salida deben estar en formato tabular. En casos de uso de clasificación multiclase o multietiqueta, cada columna de salida debe contener un solo valor. Quick no admite varios valores dentro de una sola columna. 

**Topics**
+ [Cómo funciona la integración de la SageMaker IA](#sagemaker-how-it-works)
+ [Costos generados (sin costos adicionales con la propia integración)](#sagemaker-cost-of-use)
+ [Directrices de uso](#sagemaker-usage-guidelines)
+ [Definición del archivo de esquema](#sagemaker-schema-file)
+ [Añadir un modelo de SageMaker IA a su conjunto de datos de Quick Sight](#sagemaker-using)
+ [Cree modelos predictivos con SageMaker AI Canvas](sagemaker-canvas-integration.md)

## Cómo funciona la integración de la SageMaker IA
<a name="sagemaker-how-it-works"></a>

 En general, el proceso funciona del siguiente modo:

1. Un administrador de Amazon Quick añade permisos para que Quick acceda a la SageMaker IA. Para ello, abre la configuración **de seguridad y permisos** desde la página **Gestionar rápido**. Ve a **Acceso rápido a AWS los servicios** y añade SageMaker IA. 

   Al agregar estos permisos, Quick se agrega a un rol AWS Identity and Access Management (IAM) que proporciona acceso a una lista de todos los modelos de SageMaker IA de su AWS cuenta. También proporciona permisos para ejecutar trabajos de SageMaker IA que tienen nombres con el prefijo. `quicksight-auto-generated-` 

1. Le recomendamos que se conecte a un modelo de SageMaker IA que tenga una canalización de inferencias, ya que realiza automáticamente el preprocesamiento de los datos. Para obtener más información, consulte [Implementación de una canalización de inferencias](https://docs.aws.amazon.com/sagemaker/latest/dg/inference-pipelines.html) en la Guía para desarrolladores de *SageMaker IA*.

1. Después de identificar los datos y el modelo entrenado previamente que desea utilizar juntos, el propietario del modelo crea y proporciona un archivo de esquema. Este archivo JSON es un contrato con SageMaker AI. Proporciona metadatos sobre los campos, los tipos de datos, el orden de las columnas, la salida y la configuración que el modelo espera. El componente de configuración opcional proporciona el tamaño de la instancia y el número de instancias de computación que se van a utilizar para el trabajo. 

   Si es el científico de datos que generó el modelo, cree este archivo de esquema mediante el formato que se documenta a continuación. Si es un consumidor del modelo, obtenga el archivo de esquema del propietario del modelo.

1. En Quick, comienza por crear un nuevo conjunto de datos con los datos sobre los que quiere hacer predicciones. Si vas a subir un archivo, puedes añadir el modelo de SageMaker IA en la pantalla de configuración de carga. De lo contrario, añada el modelo en la página de preparación de datos. 

   Antes de continuar, verifique los mapeos entre el conjunto de datos y el modelo.

1. Una vez importados los datos al conjunto de datos, los campos de salida contienen los datos devueltos por la SageMaker IA. Use estos campos del mismo modo que otros campos, según las directrices descritas en [Directrices de uso](#sagemaker-usage-guidelines). 

   Al ejecutar la integración de la SageMaker IA, Quick envía una solicitud a la SageMaker IA para ejecutar trabajos de transformación por lotes con procesos de inferencia. Quick inicia el aprovisionamiento y el despliegue de las instancias necesarias en su AWS cuenta. Cuando se completa el procesamiento, estas instancias se cierran y finalizan. La capacidad de computación solo genera costos cuando procesa modelos. 

   Para que le resulte más fácil identificarlos, Quick nombra todos sus trabajos de SageMaker IA con el prefijo`quicksight-auto-generated-`. 

1. La salida de la inferencia se almacena en SPICE y se añade al conjunto de datos. Tan pronto como se complete la inferencia, podrá utilizar el conjunto de datos para crear visualizaciones y paneles mediante los datos de predicción.

1. La actualización de datos se inicia cada vez que se guarda el conjunto de datos. Puede iniciar el proceso de actualización de datos manualmente actualizando el conjunto de datos de SPICE o puede programarlo para que se ejecute periódicamente. Durante cada actualización de datos, el sistema activa automáticamente la transformación por lotes de SageMaker IA para actualizar los campos de salida con nuevos datos. 

   Puede utilizar las operaciones de la API de SPICE ingesta de Amazon Quick Sight para controlar el proceso de actualización de datos. Para obtener más información sobre el uso de estas operaciones de API, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/qs-api-overview.html).

## Costos generados (sin costos adicionales con la propia integración)
<a name="sagemaker-cost-of-use"></a>

El uso de esta característica no requiere una tarifa adicional en sí mismo. Sus costos incluyen lo siguiente:
+ El costo de la implementación del modelo mediante SageMaker IA, en el que se incurre solo cuando el modelo está en ejecución. Al guardar un conjunto de datos después de crearlo o editarlo o al actualizar sus datos comienza el proceso de ingesta de datos. Este proceso incluye llamar a SageMaker AI si el conjunto de datos tiene campos inferidos. Los costos se incurren en la misma AWS cuenta en la que está tu suscripción a Quick.
+ Los costes de tu suscripción a Quick son los siguientes:
  + El coste de almacenar los datos en el motor de cálculo integrado en memoria de Quick (SPICE). Si va a añadir nuevos datos a SPICE, es posible que deba comprar suficiente capacidad de SPICE para almacenarlos. 
  + Suscripciones rápidas para los autores o administradores que crean los conjuntos de datos.
  + Pay-per-session cargos para que los espectadores (lectores) accedan a los paneles interactivos. 

## Directrices de uso
<a name="sagemaker-usage-guidelines"></a>

En Amazon Quick, se aplican las siguientes pautas de uso a esta función de la edición Enterprise:
+ El procesamiento del modelo se produce en SPICE. Por lo tanto, solo puede aplicarse a conjuntos de datos que se almacenan en SPICE. El proceso admite actualmente hasta 500 millones de filas por conjunto de datos.
+ Solo los administradores o autores de Quick pueden aumentar los conjuntos de datos con modelos de aprendizaje automático. Los lectores solo pueden ver los resultados cuando forman parte de un panel.
+ Cada conjunto de datos puede trabajar con un solo modelo de machine learning. 
+ Los campos de salida no se pueden utilizar para calcular nuevos campos.
+ Los conjuntos de datos no se pueden filtrar por campos que estén integrados con el modelo. En otras palabras, si su campo de conjunto de datos está asignado actualmente al modelo de ML, no podrá filtrar por ese campo. 

En SageMaker IA, las siguientes pautas de uso se aplican a un modelo previamente entrenado que se utilice con Amazon Quick Sight:
+ Cuando cree el modelo, asócielo con el nombre de recurso de Amazon (ARN) del rol de IAM apropiado. La función de IAM para el modelo de SageMaker IA debe tener acceso al bucket de Amazon S3 que utiliza Amazon Quick Sight. 
+ Asegúrese de que su modelo admite archivos.csv tanto para la entrada como para la salida. Asegúrese de que los datos están en un formato de tabla. 
+ Proporcione un archivo de esquema que contenga metadatos sobre el modelo, incluida la lista de campos de entrada y salida. Actualmente, debe crear este archivo de esquema manualmente.
+ Considere la cantidad de tiempo que lleva completar su inferencia, que depende de una serie de factores. Entre ellos se incluyen la complejidad del modelo, la cantidad de datos y la capacidad de cómputo definida. Completar la inferencia puede tardar de varios minutos a varias horas. Amazon Quick Sight limita todos los trabajos de ingesta e inferencia de datos a un máximo de 10 horas. Para reducir el tiempo que se tarda realizar una inferencia, considere la posibilidad de aumentar el tamaño de la instancia o el número de instancias.
+ Actualmente, solo puede usar transformaciones por lotes para la integración con la SageMaker IA, no datos en tiempo real. No puedes usar un punto final de SageMaker IA.

## Definición del archivo de esquema
<a name="sagemaker-schema-file"></a>

Antes de usar un modelo de SageMaker IA con datos de Quick Sight, cree el archivo de esquema JSON que contenga los metadatos que Amazon Quick Sight necesita para procesar el modelo. El autor o administrador de Amazon Quick carga el archivo de esquema al configurar el conjunto de datos. 

Los campos de esquema se definen de la siguiente manera. Todos los campos son obligatorios a menos que se especifiquen en la siguiente descripción. Los atributos distinguen entre mayúsculas y minúsculas.

 *inputContentType*   
El tipo de contenido que este modelo de SageMaker IA espera para los datos de entrada. El único valor admitido es `"text/csv"`. Quick Sight no incluye ninguno de los nombres de encabezado que se añaden al archivo de entrada.

 *outputContentType*   
El tipo de contenido de la salida que produce el modelo de SageMaker IA que desea utilizar. El único valor admitido es `"text/csv"`. 

 *input*   
Una lista de características que el modelo espera en los datos de entrada. Quick Sight produce los datos de entrada exactamente en el mismo orden. Esta lista contiene los atributos siguientes:  
+  *nombre*: el nombre de la columna. Si es posible, haga que sea igual al nombre de la columna correspondiente del QuickSight conjunto de datos. Este atributo está limitado a 100 caracteres.
+  *tipo*: el tipo de datos de esta columna. Este atributo acepta los valores `"INTEGER"`, `"STRING"` y `"DECIMAL"`. 
+  *Anulable*: (opcional) la nulabilidad del campo. El valor predeterminado es `true`. Si lo `nullable` estableces`false`, Quick Sight descarta las filas que no contienen este valor antes de llamar a SageMaker AI. De este modo, se evita que la SageMaker IA falle al omitir los datos necesarios. 

 *salida*   
Una lista de columnas de salida que produce el modelo de SageMaker IA. Quick Sight espera que estos campos estén exactamente en el mismo orden. Esta lista contiene los atributos siguientes:  
+  *nombre*: este nombre se convierte en el nombre predeterminado de la nueva columna correspondiente que se crea en Quick Sight. Puede anular el nombre especificado aquí en Quick Sight. Este atributo está limitado a 100 caracteres. 
+  *tipo*: el tipo de datos de esta columna. Este atributo acepta los valores `"INTEGER"`, `"STRING"` y `"DECIMAL"`. 

 *instanceTypes*   
Una lista de los tipos de instancias de aprendizaje automático que la SageMaker IA puede aprovisionar para ejecutar el trabajo de transformación. La lista se proporciona al usuario de Amazon Quick para que la elija. Esta lista se limita a los tipos compatibles con SageMaker AI. Para obtener más información sobre los tipos compatibles, consulte [TransformResources](https://docs.aws.amazon.com/sagemaker/latest/dg/API_TransformResources.html)la *Guía para desarrolladores de SageMaker IA.*

 *defaultInstanceType*   
(Opcional) El tipo de instancia que se presenta como opción predeterminada en el asistente de SageMaker IA de Quick Sight. Incluya este tipo de instancia en `instanceTypes`.

 *instanceCount*   
(Opcional) El recuento de instancias define cuántas de las instancias seleccionadas debe aprovisionar la SageMaker IA para ejecutar el trabajo de transformación. Este valor debe ser un número entero positivo.

 *description*   
Este campo proporciona un lugar para que la persona propietaria del modelo de SageMaker IA se comunique con la persona que usa este modelo en Quick Sight. Utilice este campo para ofrecer consejos sobre cómo utilizar este modelo correctamente. Por ejemplo, este campo puede contener información sobre la selección de un tipo de instancia eficaz para elegir de la lista en `instanceTypes`, en función del tamaño del conjunto de datos. Este campo está limitado a 1000 caracteres. 

 *versión*   
La versión del esquema, por ejemplo, “`1.0"`.

En el ejemplo siguiente se muestra la estructura del código JSON en el archivo de esquema. 

```
{
        "inputContentType": "CSV",
        "outputContentType": "CSV",
        "input": [
            {
                "name": "buying",
                "type": "STRING"
            },
            {
                "name": "maint",
                "type": "STRING"
            },
            {
                "name": "doors",
                "type": "INTEGER"
            },
            {
                "name": "persons",
                "type": "INTEGER"
            },
            {
                "name": "lug_boot",
                "type": "STRING"
            },
            {
                "name": "safety",
                "type": "STRING"
            }
        ],
        "output": [
            {
                "name": "Acceptability",
                "type": "STRING"
            }
        ],
        "description": "Use ml.m4.xlarge instance for small datasets, and ml.m4.4xlarge for datasets over 10 GB",
        "version": "1.0",
        "instanceCount": 1,
        "instanceTypes": [
            "ml.m4.xlarge",
            "ml.m4.4xlarge"
        ],
        "defaultInstanceType": "ml.m4.xlarge"
    }
```

La estructura del archivo de esquema está relacionada con el tipo de modelo que se utiliza en los ejemplos proporcionados por SageMaker AI. 

## Añadir un modelo de SageMaker IA a su conjunto de datos de Quick Sight
<a name="sagemaker-using"></a>

Mediante el siguiente procedimiento, puede añadir un modelo de SageMaker IA previamente entrenado a su conjunto de datos, de modo que pueda utilizar los datos predictivos en los análisis y los paneles.

Antes de comenzar, tenga a mano los siguientes elementos:
+ Los datos que desea utilizar para crear el conjunto de datos.
+ El nombre del modelo de SageMaker IA que quieres usar para aumentar el conjunto de datos.
+ El esquema del modelo. Este esquema incluye asignaciones de nombres de campo y tipos de datos. Es útil si también contiene la configuración recomendada, por ejemplo, el tipo y el número de instancias que se utilizarán.

**Para aumentar su conjunto de datos de Amazon Quick Sight con IA SageMaker**

1. Cree un nuevo conjunto de datos desde la página de inicio seleccionando **Conjuntos de datos** y, a continuación, seleccione **Nuevo conjunto de datos**.

   También puede modificar uno existente.

1. Elija **Aumentar con SageMaker en la pantalla** de preparación de datos. 

1. En **Seleccionar su modelo**, elija la siguiente configuración:
   + **Modelo**: elija el modelo de SageMaker IA que se utilizará para inferir campos.
   + **Nombre**: proporcione un nombre descriptivo para el modelo.
   + **Esquema**: cargue el archivo de esquema JSON proporcionado para el modelo.
   + **Configuración avanzada**: QuickSight recomienda los valores predeterminados seleccionados en función del conjunto de datos. Puede utilizar la configuración de tiempo de ejecución específicos para equilibrar la velocidad y el costo de su trabajo. Para ello, introduce los tipos de instancias de SageMaker AI ML para el **tipo de instancia** y el número de instancias para **Count**. 

   Elija **Siguiente** para continuar.

1. En **Revisar entradas**, revise los campos que están mapeados a su conjunto de datos. Quick Sight intenta asignar automáticamente los campos de tu esquema a los campos de tu conjunto de datos. Aquí puede hacer cambios si se debe ajustar el mapeo. 

   Elija **Siguiente** para continuar.

1. En **Revisar resultados**, consulte los campos que se añaden a su conjunto de datos. 

   Elija **Guardar y preparar datos** para confirmar las opciones.

1. Para actualizar los datos, elija el conjunto de datos para ver los detalles. A continuación, elija **Actualizar ahora** para actualizar manualmente los datos o elija **Actualizar programación** para configurar un actualización periódica. Durante cada actualización de datos, el sistema ejecuta automáticamente el trabajo de transformación por lotes de SageMaker IA para actualizar los campos de salida con nuevos datos. 

# Cree modelos predictivos con SageMaker AI Canvas
<a name="sagemaker-canvas-integration"></a>

Los autores de Amazon Quick pueden exportar datos a SageMaker AI Canvas para crear modelos de aprendizaje automático que se puedan enviar a Quick. Los autores pueden usar estos modelos de machine learning para aumentar sus conjuntos de datos con análisis predictivos que pueden usarse para crear análisis y paneles.

**Requisitos previos**
+ Una cuenta Quick que está integrada con el Centro de Identidad de IAM. Si su cuenta Quick no está integrada con el Centro de Identidad de IAM, cree una cuenta Quick nueva y elija **Utilizar una aplicación habilitada para el Centro de Identidad de IAM como proveedor** de identidad.
  + Para obtener más información sobre IAM Identity Center., consulte [Primeros pasos](https://docs.aws.amazon.com/singlesignon/latest/userguide/getting-started.html).
  + Para obtener más información sobre la integración de Quick con el Centro de identidades de IAM, consulte. [Configure su cuenta Amazon Quick con IAM Identity Center](setting-up-sso.md#sec-identity-management-identity-center)
  + Para importar activos de una cuenta Quick existente a una nueva cuenta Quick integrada con el Centro de Identidad de IAM, consulte Operaciones de [paquetes de activos](https://docs.aws.amazon.com/quicksight/latest/developerguide/asset-bundle-ops.html).
+ Un nuevo dominio de SageMaker IA que se integra con el IAM Identity Center. Para obtener más información sobre la incorporación a un dominio de SageMaker IA con el IAM Identity Center, consulte [Incorporar un dominio de SageMaker IA mediante el IAM](https://docs.aws.amazon.com/sagemaker/latest/dg/onboard-sso-users.html) Identity Center.

**Topics**
+ [Cree un modelo predictivo en SageMaker AI Canvas con Amazon Quick Sight](#sagemaker-canvas-integration-create-model)
+ [Cree un conjunto de datos con un modelo de SageMaker AI Canvas](#sagemaker-canvas-integration-create-dataset)
+ [Consideraciones](#sagemaker-canvas-integration-considerations)

## Cree un modelo predictivo en SageMaker AI Canvas con Amazon Quick Sight
<a name="sagemaker-canvas-integration-create-model"></a>

**Para crear un modelo predictivo en SageMaker AI Canvas**

1. Inicie sesión en Amazon Quick y navegue hasta la tabla tabular o tabla dinámica para la que desee crear un modelo predictivo.

1. Abra el menú visual y seleccione **Crear un modelo predictivo**.

1. En la ventana emergente **Cree un modelo predictivo en SageMaker AI Canvas** que aparece, revise la información presentada y, a continuación, seleccione **EXPORTAR DATOS A SAGEMAKER** CANVAS.

1. En el panel **Exportaciones** que aparece, seleccione **IR A SAGEMAKER CANVAS** cuando se complete la exportación para ir a la consola de SageMaker AI Canvas.

1. En SageMaker AI Canvas, crea un modelo predictivo con los datos que has exportado desde Quick Sight. Puede optar por realizar una visita guiada que le ayude a crear el modelo predictivo, o puede saltarse la visita y trabajar a su propio ritmo. Para obtener más información sobre la creación de un modelo predictivo en SageMaker AI Canvas, consulte [Crear un modelo](https://docs.aws.amazon.com/sagemaker/latest/dg/canvas-build-model-how-to.html#canvas-build-model-numeric-categorical).

1. Vuelva a enviar el modelo predictivo a Quick Sight. Para obtener más información sobre cómo enviar un modelo de SageMaker AI Canvas a Amazon Quick Sight, consulta [Enviar tu modelo a Amazon Quick Sight](https://docs.aws.amazon.com/sagemaker/latest/dg/canvas-send-model-to-quicksight.html).

## Cree un conjunto de datos con un modelo de SageMaker AI Canvas
<a name="sagemaker-canvas-integration-create-dataset"></a>

Después de crear un modelo predictivo en SageMaker AI Canvas y devolverlo a Quick Sight, usa el nuevo modelo para crear un nuevo conjunto de datos o aplícalo a un conjunto de datos existente.

**Adición de un campo predictivo a un conjunto de datos**

1. Abre la consola rápida, selecciona **Datos** a la izquierda y selecciona la pestaña **Conjuntos de datos.**

1. Cargue un conjunto de datos nuevo o elija uno existente.

1. Elija **Edit (Edición de)**.

1. En la página de preparación de datos del conjunto de datos, selecciona **AÑADIR** y, a continuación, selecciona **Añadir campo predictivo** para abrir el modal **Aumentar con IA. SageMaker **

1. En **Modelo**, elige el modelo que enviaste a Quick Sight desde SageMaker AI Canvas. El archivo de esquema se rellena automáticamente en el panel **Configuración avanzada**. Revise las entradas y, a continuación, seleccione **Siguiente**.

1. En el panel **Revisar resultados**, introduce un nombre de campo y una descripción para una columna a la que vaya dirigida el modelo que creaste en SageMaker AI Canvas.

1. Cuando haya terminado, seleccione **Preparar datos**.

1. Después de elegir **Preparar datos**, se le redirigirá a la página del conjunto de datos. Para publicar el nuevo conjunto de datos, seleccione **Publicar y visualizar**.

Cuando publicas un nuevo conjunto de datos que utiliza un modelo de SageMaker AI Canvas, los datos se importan a SPICE y se inicia un trabajo de inferencia por lotes en SageMaker AI. Estos procesos pueden tardar hasta 10 minutos en completarse.

## Consideraciones
<a name="sagemaker-canvas-integration-considerations"></a>

Las siguientes limitaciones se aplican a la creación de modelos de SageMaker AI Canvas con datos de Quick Sight.
+ La opción **Crear un modelo predictivo** que se utiliza para enviar datos a SageMaker AI Canvas solo está disponible en imágenes de tablas y tablas dinámicas tabulares. El elemento visual de la tabla o tabla dinámica debe tener entre 2 y 1000 campos y al menos 500 filas.
+ Los conjuntos de datos que contienen tipos de datos enteros o geográficos experimentarán errores de asignación de esquemas al agregar un campo predictivo al conjunto de datos. Para resolver este problema, elimine los tipos de datos enteros o geográficos del conjunto de datos o conviértalos en un nuevo tipo de datos.

# Preparación de ejemplos de un conjunto de datos
<a name="preparing-data-sets"></a>

Puede preparar datos en cualquier conjunto de datos para que resulten más adecuados para su análisis, por ejemplo, cambiando un nombre de campo o añadiendo un campo calculado. Para conjuntos de datos de base de datos, también puede determinar los datos utilizados especificando una consulta SQL o uniendo dos o más tablas. 

Utilice los siguientes temas para aprender a preparar conjuntos de datos.

**Topics**
+ [Preparación de un conjunto de datos basado en datos de archivos](prepare-file-data.md)
+ [Preparación de un conjunto de datos basado en datos de Salesforce](prepare-salesforce-data.md)
+ [Preparación de un conjunto de datos basado en datos de base de datos](prepare-database-data.md)

# Preparación de un conjunto de datos basado en datos de archivos
<a name="prepare-file-data"></a>

Utilice el siguiente procedimiento para preparar un conjunto de datos basado en archivos de texto o de Microsoft Excel de la red local o de Amazon S3.

**Preparación de un conjunto de datos basado en archivos de texto o de Microsoft Excel de la red local o de S3**

1. Abra un conjunto de datos de archivo para la preparación de los datos, seleccionando una de las siguientes opciones:
   + Cree un nuevo conjunto de datos de archivo local y, a continuación, elija **Editar/obtener vista previa de los datos**. Para obtener más información sobre cómo crear un conjunto de datos nuevo a partir de un archivo de texto local, consulte [Crear un conjunto de datos mediante un archivo de texto local](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-file.html). Para obtener más información sobre la creación de un nuevo conjunto de datos a partir de un archivo de Microsoft Excel, consulte [Creación de un conjunto de datos mediante un archivo de Microsoft Excel](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-excel.html).
   + Cree un nuevo conjunto de datos de Amazon S3 y, a continuación, elija **Editar/obtener vista previa de los datos**. Para obtener más información sobre la creación de un nuevo conjunto de datos de Amazon S3 con una nueva fuente de datos de Amazon S3, consulte [Creación de un conjunto de datos con archivos de Amazon S3](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-s3.html). Para obtener más información sobre la creación de un nuevo conjunto de datos de Amazon S3 con una fuente de datos de Amazon S3 existente, consulte [Creación de un conjunto de datos con una fuente de datos de Amazon S3 existente](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-existing-s3.html).
   + Abra un conjunto de datos de Amazon S3, Microsoft Excel o un archivo de texto para editarlo, ya sea desde la página de análisis o desde la página **Sus conjuntos de datos**. Para obtener más información sobre cómo abrir un conjunto de datos existente para la preparación de datos, consulte [Edición de conjuntos de datos.](https://docs.aws.amazon.com/quicksight/latest/user/edit-a-data-set.html)

1. (Opcional) En la página de preparación de datos, escriba un nombre nuevo en el cuadro de nombre del conjunto de datos de la barra de aplicaciones. 

   De forma predeterminada, este nombre es el nombre de archivo para archivos locales. Por ejemplo, el valor predeterminado es **Group 1** para los archivos de Amazon S3.

1. Revise la configuración de carga de archivos y corríjala si es necesario. Para obtener más información sobre la configuración de carga de archivos, consulte [Elegir la configuración de carga de archivos](https://docs.aws.amazon.com/quicksight/latest/user/choosing-file-upload-settings.html).
**importante**  
Si desea cambiar la configuración de carga, hágalo antes de realizar otros cambios en el conjunto de datos. La nueva configuración de carga hace que Amazon Quick Sight vuelva a importar el archivo. Este proceso sobrescribe todos los demás cambios.

1. Prepare los datos realizando una o más de las siguientes acciones:
   + [Selección de campos](https://docs.aws.amazon.com/quicksight/latest/user/selecting-fields.html)
   + [Edición de nombres y descripciones de campos](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-name.html)
   + [Cambiar el tipo de datos de un campo](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-data-type.html)
   + [Añadir campos calculados](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-calculated-field-analysis.html)
   + [Filtrado de datos en Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html)

1. Compruebe el indicador [SPICE](spice.md) para determinar si tiene capacidad suficiente para importar el conjunto de datos. Los conjuntos de datos de archivos se cargan automáticamente en SPICE. La importación ocurre cuando elija **Save & visualize** o **Save**. 

   Si no tiene acceso a suficiente capacidad en SPICE, puede reducir el tamaño del conjunto de datos utilizando una de las siguientes opciones: 
   + Aplique un filtro para limitar el número de filas.
   + Seleccione los campos para eliminarlos del conjunto de datos.
**nota**  
El indicador SPICE no se actualiza con la cantidad de espacio que ahorra eliminando campos o filtrando los datos. Sigue reflejando el uso de SPICE de la última importación.

1. Elija **Save** para guardar el trabajo o **Cancel** para cancelarlo. 

   También podría aparecer la opción **Save & visualize**. Esta opción aparece en función de la pantalla desde la que se empiece. Si no aparece esta opción, puede crear una nueva visualización a partir de la pantalla del conjunto de datos. 

## Preparación de un conjunto de datos basado en un archivo de Microsoft Excel
<a name="prepare-excel-file-data"></a>

Utilice el siguiente procedimiento para preparar un conjunto de datos de Microsoft Excel.

**Preparación de un conjunto de datos de Microsoft Excel**

1. Abra un conjunto de datos de archivo de texto para la preparación de los datos, seleccionando una de las siguientes opciones:
   + Cree un nuevo conjunto de datos de Microsoft Excel y, a continuación, elija **Editar/obtener vista previa de los datos**. Para obtener más información sobre la creación de un nuevo conjunto de datos de Excel, consulte [Creación de un conjunto de datos mediante un archivo de Microsoft Excel](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-excel.html).
   + Abra un conjunto de datos de Excel existente para editarlo. Para ello, vaya a la página de análisis o la página **Sus conjuntos de datos**. Para obtener más información sobre cómo abrir un conjunto de datos existente para la preparación de datos, consulte [Edición de conjuntos de datos.](https://docs.aws.amazon.com/quicksight/latest/user/edit-a-data-set.html)

1. (Opcional) En la página de preparación de datos, escriba un nombre en el cuadro de nombre del conjunto de datos en la barra de aplicaciones. Si no cambia el nombre al conjunto de datos, de forma predeterminada se le asigna el nombre de archivo de Excel.

1. Revise la configuración de carga de archivos y corríjala si es necesario. Para obtener más información sobre la configuración de carga de archivos, consulte [Elegir la configuración de carga de archivos](https://docs.aws.amazon.com/quicksight/latest/user/choosing-file-upload-settings.html). 
**importante**  
Si es necesario cambiar la configuración de carga, haga este cambio antes de aplicar otros al conjunto de datos. Al cambiar la configuración de carga, Amazon Quick Sight vuelve a importar el archivo. Este proceso sobrescribe todos los cambios realizados hasta el momento.

1. (Opcional) Cambie la selección de la hoja de cálculo. 

1. (Opcional) Cambie la selección de rango. Para ello, abra **Configuración de la carga** en el menú del conjunto de datos, debajo del nombre de inicio de sesión en la parte superior derecha.

1. Prepare los datos realizando una o más de las siguientes acciones:
   + [Selección de campos](https://docs.aws.amazon.com/quicksight/latest/user/selecting-fields.html)
   + [Edición de nombres y descripciones de campos](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-name.html)
   + [Cambiar el tipo de datos de un campo](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-data-type.html)
   + [Añadir campos calculados](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-calculated-field-analysis.html)
   + [Filtrar datos en Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html)

1. Compruebe el indicador [SPICE](spice.md) para determinar si tiene espacio suficiente para importar el conjunto de datos. Amazon Quick Sight debe importar los conjuntos de datos de Excel aSPICE. Esta importación ocurre cuando elija **Save & visualize** o **Save**.

   Si no tiene capacidad suficiente en SPICE, puede elegir que el conjunto de datos sea más pequeño utilizando uno de los siguientes métodos:
   + Aplique un filtro para limitar el número de filas.
   + Seleccione los campos para eliminarlos del conjunto de datos.
   + Defina un rango de datos más pequeño para importar.
**nota**  
El indicador SPICE no se actualiza para reflejar los cambios hasta después de su carga. Muestra el uso de SPICE de la última importación.

1. Elija **Save** para guardar el trabajo o **Cancel** para cancelarlo. 

   También podría aparecer la opción **Save & visualize**. Esta opción aparece en función de la pantalla desde la que se empiece. Si no aparece esta opción, puede crear una nueva visualización a partir de la pantalla del conjunto de datos. 

# Preparación de un conjunto de datos basado en datos de Salesforce
<a name="prepare-salesforce-data"></a>

Utilice el siguiente procedimiento para preparar un conjunto de datos de Salesforce.

**Preparación de un conjunto de datos de Salesforce**

1. Abra un conjunto de datos de Salesforce para la preparación de los datos, seleccionando una de las siguientes opciones:
   + Cree un nuevo conjunto de datos de Salesforce y elija **Editar/obtener vista previa de los datos**. Para obtener más información sobre cómo crear un nuevo conjunto de datos de Salesforce con una nueva fuente de datos de Salesforce, consulte [Crear un conjunto de datos desde](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-salesforce.html) Salesforce. Para obtener más información sobre cómo crear un nuevo conjunto de datos de Salesforce con una fuente de datos de Salesforce existente, consulte [Crear un conjunto de datos con una fuente de datos de Salesforce existente](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-existing-salesforce.html).
   + Abra un conjunto de datos de Salesforce existente para editarlo desde la página de análisis o la página **Sus conjuntos de datos**. [Para obtener más información sobre cómo abrir un conjunto de datos existente para la preparación de datos, consulte Edición de conjuntos de datos.](https://docs.aws.amazon.com/quicksight/latest/user/edit-a-data-set.html)

1. (Opcional) En la página de preparación de datos, escriba un nombre en el cuadro de nombre de conjunto de datos en la barra de aplicaciones si desea cambiar el nombre del conjunto de datos. De forma predeterminada, se asigna el nombre del informe o del objeto.

1. (Opcional) Cambie la selección del elemento de datos para ver informes u objetos.

1. (Opcional) Cambie la selección de datos para elegir un informe u objeto diferente.

   Si tiene una larga lista en el panel **Datos**, puede buscar un elemento específico escribiendo un término de búsqueda en el cuadro **Buscar tablas**. Aparecen todos los elementos cuyos nombres contienen el término de búsqueda. La búsqueda no distingue entre mayúsculas y minúsculas y no admite el uso de comodines. Elija el icono de cancelar (**X**) que se encuentra a la derecha del campo de búsqueda para volver a visualizar todos los elementos.

1. Prepare los datos realizando una o más de las siguientes acciones:
   + [Selección de campos](https://docs.aws.amazon.com/quicksight/latest/user/selecting-fields.html)
   + [Edición de nombres y descripciones de campos](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-name.html)
   + [Cambiar el tipo de datos de un campo](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-data-type.html)
   + [Añadir campos calculados](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-calculated-field-analysis.html)
   + [Filtrar datos en Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html)

1. Compruebe el indicador [SPICE](spice.md) para determinar si tiene espacio suficiente para importar el conjunto de datos. La importación de datos en SPICE es obligatoria para los conjuntos de datos de Salesforce. La importación ocurre cuando elija **Save & visualize** o **Save**.

   Si no dispone de suficiente capacidad en SPICE, puede eliminar campos del conjunto de datos o aplicar un filtro para reducir su tamaño. Para obtener más información sobre cómo agregar y eliminar campos de un conjunto de datos, consulte [Selección de campos](https://docs.aws.amazon.com/quicksight/latest/user/selecting-fields.html).
**nota**  
El indicador SPICE no se actualiza para reflejar el posible ahorro de espacio al eliminar campos o filtrar los datos. Sigue reflejando el tamaño del conjunto de datos tal y como se recuperó del origen de datos.

1. Elija **Save** para guardar el trabajo o **Cancel** para cancelarlo. 

   También podría aparecer la opción **Save & visualize**. Esta opción aparece en función de la pantalla desde la que se inicie. Si no aparece esta opción, puede crear una nueva visualización a partir de la pantalla del conjunto de datos. 

# Preparación de un conjunto de datos basado en datos de base de datos
<a name="prepare-database-data"></a>

Utilice el siguiente procedimiento para preparar un conjunto de datos basado en una consulta a una base de datos. Los datos de este conjunto de datos pueden proceder de una fuente de datos de AWS base de datos, como Amazon Athena, Amazon RDS o Amazon Redshift, o de una instancia de base de datos externa. Puede elegir si desea importar una copia de sus datos a [SPICE](spice.md) o consultar los datos directamente.

**Preparación de un conjunto de datos a partir de una consulta a una base de datos**

1. Abra un conjunto de datos de base de datos para la preparación de los datos, seleccionando una de las siguientes opciones:
   + Cree un nuevo conjunto de datos de base de datos y elija **Editar/obtener vista previa de los datos**. Para obtener más información sobre cómo crear un conjunto de datos nuevo con una nueva fuente de datos de base de datos, consulte [Crear un conjunto de datos a partir de una](https://docs.aws.amazon.com/quicksight/latest/user/create-a-database-data-set.html) base de datos. Para obtener más información sobre la creación de un conjunto de datos nuevo con una fuente de datos de base de datos existente, consulte [Crear un conjunto de datos con una fuente de datos de base de datos existente](https://docs.aws.amazon.com/quicksight/latest/user/create-a-data-set-existing-database.html).
   + Abra un conjunto de datos de base de datos existente para editarlo desde la página de análisis o la página **Sus conjuntos de datos**. Para obtener más información sobre cómo abrir un conjunto de datos existente para la preparación de datos, consulte [Edición de conjuntos de datos.](https://docs.aws.amazon.com/quicksight/latest/user/edit-a-data-set.html)

1. (Opcional) En la página de preparación de datos, escriba un nombre en el cuadro de nombre del conjunto de datos en la barra de aplicaciones.

   El valor predeterminado de este nombre es el nombre de la tabla si seleccionó una antes de preparar los datos. De lo contrario, es **Untitled data source**.

1. Decida cómo se seleccionan los datos eligiendo una de las siguientes:
   + Para utilizar una única tabla para proporcionar datos, elija una tabla o cambie la selección de tablas.

     Si tiene una larga lista de tablas en el panel **Tables**, puede localizar una tabla específica escribiendo un término de búsqueda en el cuadro **Search tables**. 

     Aparecen todas las tablas cuyos nombres contienen el término de búsqueda. La búsqueda no distingue entre mayúsculas y minúsculas y no admite el uso de comodines. Elija el icono de cancelar (**X**) que se encuentra a la derecha del campo de búsqueda para volver a visualizar todas las tablas.
   + Para utilizar dos o más tablas unidas para proporcionar datos, elija dos tablas y únalas utilizando el panel de unión. Debe importar los datos a Quick Sight si decide usar tablas unidas. Para obtener más información sobre cómo unir datos mediante la interfaz de Amazon Quick Sight, consulte [Unir datos](https://docs.aws.amazon.com/quicksight/latest/user/joining-data.html).
   + Para utilizar una consulta SQL personalizada para proporcionar datos en un nuevo conjunto de datos, elija la herramienta **Cambiar a consulta SQL personalizada** en el panel **Tablas**. Para obtener más información, consulte [Uso de SQL para personalizar datos](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-SQL-query.html).

     Para cambiar la consulta SQL en un conjunto de datos existente, elija **Editar SQL** en el panel **Campos** para abrir el panel de SQL y editar la consulta.

1. Prepare los datos realizando una o más de las siguientes acciones:
   + [Selección de campos](https://docs.aws.amazon.com/quicksight/latest/user/selecting-fields.html)
   + [Edición de nombres y descripciones de campos](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-name.html)
   + [Cambiar el tipo de datos de un campo](https://docs.aws.amazon.com/quicksight/latest/user/changing-a-field-data-type.html)
   + [Añadir campos calculados](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-calculated-field-analysis.html)
   + [Filtrar datos en Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/adding-a-filter.html)

1. Si no va a unir tablas, elija si desea consultar la base de datos directamente o importar los datos en SPICE seleccionando el botón de opción **Consulta** o **SPICE**. Le recomendamos utilizar SPICE para un mejor desempeño. 

   Si desea utilizar SPICE, compruebe el indicador SPICE para ver si tiene espacio suficiente para importar el conjunto de datos. La importación ocurre cuando elija **Save & visualize** o **Save**.

   Si no dispone de suficiente espacio, puede eliminar campos del conjunto de datos o aplicar un filtro para reducir su tamaño.
**nota**  
El indicador SPICE no se actualiza para reflejar el posible ahorro de espacio al eliminar campos o filtrar los datos. Sigue reflejando el tamaño del conjunto de datos tal y como se recuperó del origen de datos.

1. Elija **Save** para guardar el trabajo o **Cancel** para cancelarlo. 

   También podría aparecer la opción **Save & visualize**. Esta opción aparece en función de la pantalla desde la que se inicie. Si no aparece esta opción, puede crear una nueva visualización a partir de la pantalla del conjunto de datos. 

# Análisis e informes: visualización de datos en Amazon Quick Sight
<a name="working-with-visuals"></a>

A continuación, encontrarás descripciones sobre cómo crear y personalizar los gráficos de Amazon Quick Sight, cómo organizar los gráficos en un panel de control y mucho más.

**Topics**
+ [Trabajar con un análisis en Amazon Quick Sight](working-with-an-analysis.md)
+ [Adición y administración de hojas](working-with-multiple-sheets.md)
+ [Trabajar con hojas interactivas en Amazon Quick Sight](working-with-interactive-sheets.md)
+ [Cómo trabajar con informes de píxeles perfectos en Amazon Quick Sight](working-with-reports.md)
+ [Trabajar con elementos en hojas en los análisis de Amazon Quick Sight](authoring-sheets.md)
+ [Uso de temas en Amazon Quick Sight](themes-in-quicksight.md)
+ [Acceso a Amazon Quick Sight mediante atajos de teclado](quicksight-accessibility.md)

# Trabajar con un análisis en Amazon Quick Sight
<a name="working-with-an-analysis"></a>

En Quick Sight, un análisis es lo mismo que un panel, excepto que solo pueden acceder a él los autores que usted elija. Puede mantenerlo en privado y hacerlo tan sólido y detallado como quiera. Si decide publicarlo, la versión compartida se llama panel de control. 

Utilice las siguientes secciones para aprender a interactuar con un análisis de Quick Sight.

**Topics**
+ [Inicio de un análisis en Quick Sight](creating-an-analysis.md)
+ [Adición de un título y una descripción a un análisis](adding-a-title-and-description.md)
+ [Compartir los análisis de Quick Sight](sharing-analyses.md)
+ [Cambio del nombre de un análisis](renaming-an-analysis.md)
+ [Duplicación de análisis](duplicating-an-analysis.md)
+ [Personalización de los valores de fecha y hora de un análisis](analysis-date-time.md)
+ [El menú de análisis](analysis-menu.md)
+ [Configuración de los ajustes de análisis](analysis-settings.md)
+ [Límites de artículos para los análisis de Amazon Quick Sight en Quick Sight APIs](analysis-item-limits.md)
+ [Guardado de cambios en los análisis](saving-changes-to-an-analysis.md)
+ [Exportación de datos de los análisis de Quick Sight](exporting-data-analysis.md)
+ [Eliminación de un análisis](deleting-an-analysis.md)

# Inicio de un análisis en Quick Sight
<a name="creating-an-analysis"></a>

En Quick Sight, usted analiza y visualiza sus datos en los análisis. Cuando termine, puede publicar su análisis como un panel de control para compartirlo con otras personas de su organización. 

Utilice el siguiente procedimiento para crear un nuevo análisis.

**Creación de un nuevo análisis**

1. En la página de inicio rápido de Amazon, selecciona **Análisis** y, a continuación, selecciona **Nuevo análisis**.

1. Elija el conjunto de datos que desee incluir en su nuevo análisis y, a continuación, seleccione **USAR EN ANÁLISIS** en la parte superior derecha.

1. En la ventana emergente **Nueva hoja** que aparece, elija el tipo de hoja que quiera. Puede elegir entre una **hoja interactiva** y un **informe perfecto en píxeles**. Para crear un informe perfecto, necesitas el complemento Pixel Perfect Reports para tu cuenta. Para obtener más información sobre los informes Pixel Perfect, consulte[Cómo trabajar con informes de píxeles perfectos en Amazon Quick Sight](working-with-reports.md). Para más información acerca de las hojas, consulte [Adición y administración de hojas](working-with-multiple-sheets.md).

1. (Opcional) Si elige **Hoja interactiva**, siga estos pasos:
   + (Opcional): Elija el tipo de diseño que quiere para su hoja interactiva. Puede elegir una de las siguientes opciones:
     + Forma libre
     + En mosaico

     La opción predeterminada es **Forma libre**.

     Para más información sobre los diseños de hojas interactivas, consulte [Tipos de diseño](types-of-layout.md).
   + Elija el tamaño del lienzo para el que quiere optimizar su hoja. Puede elegir una de las siguientes opciones:
     + 1024 px
     + 1280 px
     + 1366 px
     + 1600 px
     + 1920 px

     Para más información sobre el formato de las hojas interactivas, consulte [Trabajar con hojas interactivas en Amazon Quick Sight](working-with-interactive-sheets.md).

1. (Opcional) Si eliges **Pixel Perfect Report**, sigue estos pasos:
   + (Opcional) Elija el tamaño de papel que quiere para su informe paginado. Puede elegir entre las siguientes opciones:
     + Carta EE. UU. (8,5 x 11 pulgadas)
     + Legal EE. UU. (8,5 x 14 pulgadas)
     + A0 (841 x 1189 mm)
     + A1 (594 x 841 mm)
     + A2 (420 x 594 mm)
     + A3 (297 x 420 mm)
     + A4 (210 x 297 mm)
     + A5 (148 x 210 mm)
     + Japón B4 (257 x 364 mm)
     + Japón B5 (182 x 257 mm)

     El tamaño de papel predeterminado es Carta EE. UU. (8,5 x 11 pulgadas)
   + (Opcional) Elija la orientación de la hoja. Puede elegir entre **Vertical** u **Horizontal**. La opción predeterminada es vertical.

     Antes de poder crear informes con píxeles perfectos de Amazon Quick Sight, primero obtén el complemento de informes con píxeles perfectos para tu cuenta de Quick. Para obtener más información sobre cómo obtener el complemento de informes Pixel Perfect, consulte[Obtén el complemento Quick Pixel Perfect Reports](qs-reports-getting-started.md#qs-reports-getting-started-subscribe).

     Para obtener más información sobre cómo dar formato a los informes con píxeles perfectos, consulte[Cómo trabajar con informes de píxeles perfectos en Amazon Quick Sight](working-with-reports.md).

1. Elija **Añadir**.

1. Cree un elemento visual. Para obtener más información acerca de cómo crear un elemento visual, consulte [Añadir imágenes a los análisis de Quick Sight](creating-a-visual.md).

Cuando termine de crear el análisis, puede iterar sobre él para modificar el elemento visual, agregar más elementos visuales, agregar escenas a la historia predeterminada o agregar más historias.

# Adición de un título y una descripción a un análisis
<a name="adding-a-title-and-description"></a>

Además del nombre, puede añadir un título y una descripción a un análisis. Si el título y la descripción son significativos, pueden aportar algo de contexto sobre la información del análisis.

## Adición de un título y una descripción
<a name="add-a-title-and-description"></a>

Utilice el siguiente procedimiento para añadir un título y una descripción a un análisis. Los títulos y las descripciones pueden contener hasta 1024 caracteres. Los títulos y las descripciones no son compatibles con los informes con píxeles perfectos.

**Adición de un título y una descripción a un análisis**

1. En la página del análisis, elija **Hojas** en la barra de aplicaciones y, a continuación, seleccione **Agregar título**.

1. En **Título de hoja**, escriba un título y pulse **Enter**. Para quitar un título, elija **Hojas** en la barra de aplicaciones y, a continuación, seleccione **Eliminar título**. Para quitar el título, también puede seleccionarlo y, a continuación, elegir el icono de eliminación que tiene forma de **x**.

   Para crear un título de hoja dinámica, puede añadir parámetros existentes al título de la hoja. Para obtener más información, consulte [Uso de parámetros en títulos y descripciones en Amazon Quick](parameters-in-titles.md).

1. Seleccione **Hojas** en la barra de aplicaciones y, a continuación, elija **Agregar descripción**.

1. En el espacio descriptivo que aparece en la hoja, ingrese la descripción que desee y pulse **Enter**. Para quitar una descripción, elija **Hojas** en la barra de aplicaciones y, a continuación, elija **Eliminar descripción**. O, para eliminar la descripción, puede seleccionar la descripción y, a continuación, elegir el icono de eliminación en forma de **x**.

# Compartir los análisis de Quick Sight
<a name="sharing-analyses"></a>

Puede compartir un análisis con uno o varios usuarios mediante el envío por correo electrónico de un enlace, lo que facilita la colaboración y la difusión de los resultados. Solo puede compartir un análisis con otros usuarios de su cuenta de Quick.

Después de compartir un análisis, puede revisar qué otros usuarios tienen acceso a él y también revocar el acceso de cualquier usuario.

**Topics**
+ [Uso compartido de un análisis](#share-an-analysis)
+ [Visualización de los usuarios con los que se comparte un análisis](view-users-analysis.md)
+ [Revocación del acceso a un análisis](revoke-access-to-an-analysis.md)

## Uso compartido de un análisis
<a name="share-an-analysis"></a>

Utilice el siguiente procedimiento para compartir un análisis.

**Uso compartido de un análisis**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el análisis que desee cambiar.

1. En la página del análisis, elija **Archivo** en la barra de aplicaciones y, a continuación, elija **Compartir**.

   Solo puede compartir los análisis con los usuarios o grupos que estén en su cuenta Quick.

1. Añada un usuario o un grupo con el que compartirlos. Para ello, en **Escribir un nombre de usuario o dirección de correo electrónico**, introduzca el primer usuario o grupo con el que desee compartir este análisis. A continuación, elija **Compartir**. Repita este paso hasta que haya escrito la información de todas las personas con las que desea compartir el análisis.

   Para editar los permisos de uso compartido de este análisis, elija **Administrar el acceso al análisis**.

   Aparecerá la pantalla **Administrar permisos de análisis**. En esta pantalla, elija **Invitar usuario** para editar los permisos y agregar más usuarios o grupos.

1.  En **Permiso**, elija el rol que asignará a cada usuario o grupo. El rol determina el nivel de permiso que se concede a cada usuario o grupo.

1. Elija **Compartir**.

   Los usuarios con los que haya compartido el análisis reciben un mensaje de correo con un enlace al análisis. Los grupos no reciben correos electrónicos de invitación.

# Visualización de los usuarios con los que se comparte un análisis
<a name="view-users-analysis"></a>

Si ha compartido un análisis, puede utilizar el siguiente procedimiento para ver qué usuarios o grupos pueden obtener acceso a él.

**Visualización de los usuarios o grupos que tienen acceso a un análisis**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Abra el análisis que desee cambiar.

1. En la página del análisis, elija **Archivo** en la barra de aplicaciones y, a continuación, elija **Compartir**.

1. Elija **Administrar permisos de análisis**.

1. Consulte con quién se ha compartido este análisis. Puede realizar una búsqueda para localizar una cuenta específica escribiendo un término de búsqueda. La búsqueda devuelve cualquier usuario, grupo o dirección de correo electrónico que contenga el término de búsqueda. La búsqueda distingue entre mayúsculas y minúsculas, y no admite el uso de comodines. Elimine el término de búsqueda para ver todos los usuarios y grupos.

# Revocación del acceso a un análisis
<a name="revoke-access-to-an-analysis"></a>

Utilice el siguiente procedimiento para revocar el acceso a un análisis.

**Revocación del acceso a un análisis**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Abra el análisis que desee cambiar.

1. En la página del análisis, elija **Archivo** en la barra de aplicaciones y, a continuación, elija **Compartir**.

1. Elija **Administrar permisos de análisis**.

1. Localice al usuario o grupo cuyo acceso desea revocar y, a continuación, elija el icono de papelera situado junto al usuario o grupo. 

1. Elija **Confirmar**.

# Cambio del nombre de un análisis
<a name="renaming-an-analysis"></a>

Utilice el siguiente procedimiento para cambiar el nombre de un análisis.

**Cambio del nombre de un análisis**

1. Abra el análisis cuyo nombre quiere cambiar.

1. En el cuadro **Nombre del análisis** de la barra de aplicaciones, seleccione el nombre actual e introduzca uno nuevo.

# Duplicación de análisis
<a name="duplicating-an-analysis"></a>

Puede duplicar los análisis en Quick Sight. Utilice el siguiente procedimiento para obtener información sobre cómo hacerlo.

**Duplicación de un análisis**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, abra el análisis que desee duplicar.

1. En el análisis, seleccione **Guardar como** en la barra de aplicaciones situada en la parte superior derecha.

1. En la página **Guardar una copia** que se abre, ingrese un nombre para el análisis y luego elija **Guardar**.

   Se abrirá el nuevo análisis. Para encontrar el análisis original, vuelva a la página de inicio rápido y seleccione **Análisis**.

# Personalización de los valores de fecha y hora de un análisis
<a name="analysis-date-time"></a>

En Amazon Quick, los autores pueden establecer zonas horarias personalizadas y días semanales de inicio de un análisis. Al configurar un inicio de semana o una zona horaria personalizados, todos los elementos visuales del análisis que utilizan datos de fecha y hora tendrán un formato que reflejará la zona horaria o el inicio de la semana que utiliza el análisis.

## Establecimiento de zonas horarias personalizadas en un análisis
<a name="analysis-timezone"></a>

Los autores rápidos pueden utilizar *zonas horarias personalizadas* para gestionar los datos en varias regiones geográficas. Al configurar una zona horaria personalizada, todas las dimensiones, medidas, campos calculados y filtros visibles se convertirán a la zona horaria elegida en tiempo de ejecución de la consulta. Los ajustes del horario de verano (DST) se aplican automáticamente para eliminar la necesidad de recurrir a soluciones alternativas que consumen mucho tiempo y que no gestionan con precisión las fechas antiguas.

Las *zonas horarias personalizadas* hacen referencia al uso de abreviaturas de zona horaria de IANA que representan regiones geográficas específicas de todo el mundo. Cada zona horaria se define como una diferencia horaria con respecto a la hora universal coordinada (UTC). Las zonas horarias se distinguen de las diferencias horarias simples porque incorporan el horario de verano.

La zona horaria predeterminada para todos los análisis es `UTC`.

Las siguientes reglas se aplican a las zonas horarias:
+ **Las visualizaciones de fecha y hora con una granularidad inferior a `hour` se convierten a la zona horaria seleccionada.** Por ejemplo, si establece la zona horaria de un análisis en `America/New_York (UTC-04:00)`, el valor de fecha y hora `Dec.1, 2020 12:00am` en `UTC+00:00` se convertirá y mostrará como `Nov.30, 2020 7:00pm`. El horario de verano (DST) se incorpora a la conversión de fecha y hora.
+ **Los literales de fecha y hora que se agregan a los cálculos o que se seleccionan en los filtros respetan la zona horaria seleccionada para el análisis.** Por ejemplo, si introduce manualmente un literal en un campo calculado, por ejemplo`01-01-2022 7:00pm`, o selecciona una hora de filtro fija, Quick Sight aplica la zona horaria elegida al valor literal.
+ **Las medidas que se agregan por encima de la granularidad `hour/minute` se agregan en función de la zona horaria a la que esté configurado el análisis.** Cuando Quick Sight procesa un conjunto de datos, todas las marcas de tiempo se convierten inicialmente al nivel de granularidad más bajo. A continuación, los valores se agregan en función del límite de la zona horaria seleccionada para el análisis. Por ejemplo, una suma de los ingresos por hora a nivel diario con una zona horaria `UTC+00:00` suma todos los ingresos por hora de `12am-11pm` para la zona horaria `UTC`. Al realizar la conversión de `UTC+00:00` a `New_York (UTC-04:00)`, todos los puntos de datos de ingresos se agregan desde `8:00pm-7:00pm(+1day)` en `UTC` para que coincidan con el inicio y el final del día en `New_York (UTC-04:00)`.
+ **La función `now()`, el filtro de fechas móviles y los parámetros se convierten a la zona horaria elegida.** Los filtros de fecha relativa, los filtros de fecha móvil y los parámetros de fecha relativa que utilizan la función `now()` también respetan la zona horaria elegida cuando se aplican al elemento visual. Por ejemplo, si selecciona un filtro relativo como `last week` o un filtro de fecha móvil como `start of the month`, la zona horaria elegida se aplica automáticamente al filtro para mostrar los valores `last week of New_York time zone` y `start of the month of New_York time zone`, respectivamente.

**Establecimiento de la zona horaria personalizada de un análisis**

1. En el análisis que desee cambiar, navegue hasta el menú superior y elija **Editar**.

1. Elija **Configuración de análisis** y, a continuación, elija **Fecha y hora**.

1. Active la opción **Convertir zona horaria** y elija la **Zona horaria** que desee.

1. Seleccione **Aplicar**.

Cuando se asigna una zona horaria a un análisis, aparece un icono en la parte superior del análisis que indica la zona horaria que utiliza el análisis. Este icono también aparece en los paneles que se publiquen a partir del análisis.

**Consideraciones**

A continuación se describen las consideraciones que se aplican a las zonas horarias personalizadas.
+ Para usar zonas horarias personalizadas, todas las columnas de fecha y hora de un conjunto de datos deben estar normalizadas a UTC. Si las columnas de fecha y hora no están normalizadas en el origen de datos, debe convertirlas en el origen de datos para poder usar esta característica.
+ En el caso de análisis que no tienen zona horaria personalizada asignada, las experiencias del autor y del lector no se ven afectadas.
+ Una vez que se agrega una zona horaria a un análisis, la zona horaria se aplica a todas las imágenes y hojas del análisis.
+ Los autores rápidos solo pueden elegir una zona horaria para un análisis. Todos los paneles que se publican a partir del análisis utilizan la zona horaria que usa el análisis. Para crear un panel que utilice una zona horaria diferente de la que usa el análisis, cambie la zona horaria del análisis y vuelva a publicar el panel.
+ Los lectores rápidos no pueden cambiar la zona horaria de un panel.
+ Si establece la zona horaria de un análisis que usa un conjunto de datos almacenado en Direct Query y se ralentiza el tiempo de carga, considere la posibilidad de almacenar el conjunto de datos en SPICE. SPICE está diseñado para gestionar las conversiones de zonas horarias de manera eficaz.
+ Las zonas horarias personalizadas no son compatibles con los siguientes motores de base de datos:
  + Timestream
  + OpenSearch ¿Servicio
  + Teradata
  + SqlServer

## Establecimiento de días de inicio de semana personalizados en un análisis
<a name="analysis-week-start"></a>

Los autores rápidos pueden definir el día de inicio de la semana de un análisis para alinear sus datos con el cronograma que sigue su empresa o sector. Al establecer un día de inicio de semana personalizado, todas las dimensiones, los campos calculados y los filtros que se agregan a nivel de semana se calculan para alinearse con el nuevo día de inicio de la semana. El día de inicio de semana predeterminado es `Sunday`.

**Configuración del día de inicio de semana personalizado de un análisis**

1. En el análisis que desee cambiar, navegue hasta el menú superior y elija **Editar**.

1. Elija **Configuración de análisis** y, a continuación, elija **Fecha y hora**.

1. En **Día de inicio personalizado**, elija el día de inicio que desee.

1. Seleccione **Aplicar**.

**Consideraciones**

A continuación se describen las consideraciones que se aplican a los días de inicio de semana personalizados.
+ Los campos de fecha y hora se convierten en tiempo de ejecución. Cuando trabaje con campos calculados que usan valores de fecha y hora, defina los campos en el nivel de análisis en lugar de en el nivel del conjunto de datos.
+ Cuando elija un nuevo día de inicio de semana, el cambio se aplicará a todas las imágenes y hojas del análisis.
+ Los autores rápidos pueden elegir solo el día de inicio de una semana para un análisis. Todos los paneles que se publican a partir del análisis utilizan el día de inicio de semana que usa el análisis. Para crear un panel que utilice un día de inicio de semana diferente del que usa el análisis, cambie el día de inicio de semana del análisis y vuelva a publicar el panel.
+ Los lectores rápidos no pueden cambiar el día de inicio de la semana de un panel.

# El menú de análisis
<a name="analysis-menu"></a>

Mientras trabaja en un análisis, Amazon Quick ofrece varias opciones de menú. Estas opciones de menú se utilizan para realizar tareas de manera eficiente sin necesidad de navegar manualmente por el análisis para encontrar los activos que quiere cambiar.

Puede utilizar estas opciones para realizar las siguientes tareas.
+ *Archivo*: realiza tareas de gestión de análisis, como crear, compartir y publicar. Los autores pueden utilizar esta opción para realizar cambios en todas las hojas o elementos visuales de un análisis.
+ *Editar*: navegue entre los cambios que realice en el análisis. Puede deshacer o rehacer los cambios realizados.
+ *Datos*: administrar conjuntos de datos, campos de datos y parámetros. Los cambios que realice mediante esta opción se aplicarán a todas las hojas del análisis.
+ *Insertar*: use un punto de entrada donde pueda agregar elementos visuales, cuadros de texto, insights, objetos de informe, filtros y parámetros a un análisis. Puede insertar datos u objetos.
+ *Hojas*: administre la configuración de las hojas del análisis, incluida la configuración del diseño, las acciones para agregar o eliminar activos de una hoja y las propiedades de la hoja.
+ *Objetos*: administre los objetos y sus características, incluidos el estilo, la colocación en la hoja, el tamaño, el fondo de la tarjeta y los bordes. También puede administrar estos objetos mediante el panel **Propiedades** cuando trabaje en un objeto de elemento visual.
+ *Buscar*: permite acceder a la barra *Búsqueda rápida*. La búsqueda rápida es una barra de búsqueda que comienza a mostrar los resultados del activo que busca mientras escribe. Los resultados sugeridos se seguirán modificando a medida que escriba hasta que vea el resultado que busca.

  Para utilizar la búsqueda rápida, abra el menú **Buscar** y, en el cuadro **Buscar acciones de análisis**, comience a escribir un nombre o una frase asociada al activo que intenta encontrar.

# Configuración de los ajustes de análisis
<a name="analysis-settings"></a>

Los autores de Amazon Quick pueden utilizar el menú de ajustes de análisis para configurar los ajustes de actualización y fecha y hora de un análisis. Para acceder al menú Configuración de análisis, seleccione **Editar** y, a continuación, elija **Configuración de análisis**. A continuación se describen los ajustes que se pueden configurar en el menú Configuración de análisis:

**Actualización de la configuración**
+ **Recargar las imágenes cada vez que cambie de hoja**: utilice esta configuración para volver a cargar todas las imágenes de un análisis de Quick Sight cada vez que el usuario cambie a una hoja diferente del análisis.
+ **Actualizar elementos visuales manualmente**: use este ajuste para actualizar solo los elementos visuales aplicables en un análisis cuando el usuario aplique sus cambios. Cuando este ajuste está activado, el análisis carga los elementos visuales en blanco de forma predeterminada, ya que las consultas no se activarán hasta que el usuario seleccione el botón **ACTUALIZAR ELEMENTOS VISUALES**, que se encuentra en la barra de herramientas o en los elementos visuales afectados. El botón **ACTUALIZAR ELEMENTOS VISUALES** confirma que el usuario ha terminado con las selecciones de filtro y control que quiere aplicar a los elementos visuales afectados. La siguiente imagen muestra el botón **ACTUALIZAR ELEMENTOS VISUALES**.

  Si la opción **Actualizar elementos visuales manualmente** está activada, los autores pueden agregar elementos visuales, editarlos y editar selecciones de control, pero los elementos visuales afectados no se actualizarán hasta que el autor aplique los nuevos cambios. Esto permite a los autores crear análisis sin aumentar la carga de la base de datos y proporciona un mejor control sobre los valores que se cargan en un análisis.

**Configuración de fecha y hora**
+ **Convertir zona horaria**: utilice este ajuste para convertir todas las visualizaciones, filtros y parámetros relacionados con los campos de fecha para que reflejen la zona horaria elegida. Todos los ajustes del horario de verano se realizan automáticamente. Para obtener más información acerca de la configuración de la zona horaria, consulte [Personalización de los valores de fecha y hora de un análisis](analysis-date-time.md).
+ **Inicio de la semana**: use este ajuste para elegir el día de inicio de la semana para un análisis.

**Interactividad**
+ Use esta configuración para destacar puntos de datos específicos en los elementos visuales de una hoja. Al seleccionar o pasar el ratón sobre un punto de datos de un elemento visual, se destacarán los datos relacionados en otros elementos visuales, mientras que se atenuarán los datos no relacionados. Al destacarlos, puede comprender las correlaciones, detectar patrones, tendencias y valores atípicos, y facilitar análisis más sólidos y fundamentados. Seleccione **Al seleccionar** o **Al pasar el ratón** para activar el resaltado o **Sin resaltado** para desactivarlo.
+ Para personalizar el resaltado por hoja, consulte [Adición y administración de hojas](working-with-multiple-sheets.md).

# Límites de artículos para los análisis de Amazon Quick Sight en Quick Sight APIs
<a name="analysis-item-limits"></a>

Usa la siguiente tabla para revisar los límites o cuotas actuales de los distintos elementos de análisis en Amazon Quick Sight que se crean y administran con Amazon Quick Sight APIs. Si el análisis contiene más elementos de análisis de los admitidos, elimine algunos para optimizar el rendimiento del análisis. No se pueden agregar nuevos elementos de análisis a un análisis que contenga más elementos de los admitidos.


| Elemento de análisis | Límite | 
| --- | --- | 
|  [Hojas](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-multiple-sheets)  |  20 hojas por análisis  | 
|  [Imágenes](https://docs.aws.amazon.com/quicksuite/latest/userguide/creating-a-visual)  |  50 elementos visuales por hoja  | 
|  [Campos calculados](https://docs.aws.amazon.com/quicksuite/latest/userguide/working-with-calculated-fields)  |  500 por análisis y 200 por conjunto de datos\$1  | 
|  [Favoritos](https://docs.aws.amazon.com/quicksuite/latest/userguide/dashboard-bookmarks-create)  |  200 por panel  | 
|  [Acciones personalizadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/custom-actions)  |  10 por elemento visual  | 
|  [Filtrado de grupos](https://docs.aws.amazon.com/quicksuite/latest/userguide/add-a-compound-filter)  |  2000 por análisis  | 
|  [Filtros](https://docs.aws.amazon.com/quicksuite/latest/userguide/adding-a-filter)  |  20 filtros por grupo de filtros  | 
|  [Parámetros](https://docs.aws.amazon.com/quicksuite/latest/userguide/parameters-in-quicksight)  |  400 por análisis  | 
|  [Controles](https://docs.aws.amazon.com/quicksuite/latest/userguide/filter-controls)  |  200 por hoja  | 
|  [Cuadros de texto](https://docs.aws.amazon.com/quicksuite/latest/userguide/textbox)  |  100 por hoja  | 
|  [Componentes de imagen](https://docs.aws.amazon.com/quicksuite/latest/userguide/image-component)  |  10 por hoja  | 
|  [Elementos visuales de mapas en capas](https://docs.aws.amazon.com/quicksuite/latest/userguide/layered-maps)  |  5 por hoja  | 

\$1 El límite por conjunto de datos se aplica a los cálculos que se crearon en el análisis. Los cálculos por conjunto de datos no se incluyen en este límite. Para obtener más información sobre los cálculos de nivel de conjuntos de datos, consulte [Adición de campos calculados](adding-a-calculated-field-analysis.md).

# Guardado de cambios en los análisis
<a name="saving-changes-to-an-analysis"></a>

Cuando se trabaja en un análisis, puede establecer la opción Autosave ON (valor predeterminado) o Autosave OFF. Si la opción seleccionada es Autosave ON, los cambios se guardan automáticamente cada minuto más o menos. Cuando la opción autoguardado está desactivada, los cambios no se guardan automáticamente, lo que significa que puede realizar cambios y seguir diferentes líneas de investigación sin alterar permanentemente el análisis. Si, después de todo, decide que desea guardar los resultados, vuelva a habilitar Autosave. Se guardarán los cambios realizados hasta ese momento.

En cualquiera de los dos modos de autoguardado, puede deshacer o rehacer hasta 200 cambios realizados seleccionando **Deshacer** o **Rehacer** en la barra de aplicaciones.

## Cambio del modo de autoguardado
<a name="changing-autosave"></a>

Para cambiar el modo de autoguardado de un análisis, seleccione **Archivo** y, a continuación, elija **Guardado automático activado** o **Guardado automático desactivado**.

## Cuando el autoguardado no puede guardar los cambios
<a name="conflicting-changes"></a>

Suponga que se produce una de las siguientes situaciones: 
+ Autosave está activada y otro usuario realiza un cambio conflictivo en el análisis.
+ Autosave está activada y se produce un error de servicio, por lo que no se pueden guardar los cambios más recientes; o.
+ Autosave está desactivada, se activa y uno de los cambios pendientes que se guarda en el servidor entra en conflicto con los cambios de otro usuario.

En este caso, Amazon Quick Sight te da la opción de hacer una de estas dos cosas. Puede dejar que Amazon Quick Sight desactive el guardado automático y siga trabajando sin guardar, o bien volver a cargar el análisis desde el servidor y volver a hacer los cambios más recientes. 

Si vence la autenticación del cliente cuando se está editando un análisis, se dirige al usuario a la página de inicio de sesión. Cuando se inicia sesión correctamente, se dirige de nuevo al usuario al análisis donde puede seguir trabajando con normalidad.

Si se revocan los permisos para el análisis cuando se está editando, no se pueden hacer más cambios.

# Exportación de datos de los análisis de Quick Sight
<a name="exporting-data-analysis"></a>

**nota**  
Los archivos de exportación pueden devolver directamente información de la importación del conjunto de datos. Esto hace que los archivos sean vulnerables a ejecuciones CSV si los datos importados contienen fórmulas o comandos. Por este motivo, los archivos de exportación pueden provocar advertencias de seguridad. Para evitar actividades maliciosas, desactive los enlaces y las macros al leer los archivos exportados.

Puede exportar los datos de un análisis a un archivo CSV o PDF. Para exportar datos de un análisis o panel a un archivo CSV, siga el procedimiento que se indica en [Exportación de datos de elementos visuales](exporting-data.md).

Use el siguiente procedimiento para exportar un análisis como PDF.

1. En el análisis que desee exportar, elija **Archivo > Exportar a PDF**. Quick Sight comienza a preparar el análisis para su descarga. 

1. Seleccione **VER EXPORTACIONES** en la ventana emergente azul para abrir el panel **Exportaciones** de la derecha.

1. Seleccione **DESCARGAR** en la ventana emergente verde.

1. Para ver todos los análisis o informes que están listos para descargarse, seleccione **Archivo** y luego **Exportar**. El panel Exportaciones se abrirá en la parte derecha de la pantalla. Seleccione **Haga clic para descargar** junto al archivo que desee guardar en su ubicación preferida.

El proceso de exportación a PDF funciona de la misma manera tanto en los paneles como en los análisis.

También puede adjuntar un PDF a los informes de correo electrónico de los paneles. Para obtener más información, consulte [Programar y enviar informes de Quick Sight por correo electrónico](sending-reports.md).

# Eliminación de un análisis
<a name="deleting-an-analysis"></a>

Si tiene los permisos para hacerlo, puede eliminar un análisis desde la página **Análisis**. Cuando se elimina un análisis, los paneles basados en dicho análisis no se ven afectados. De hecho, se sigue mostrando el análisis eliminado, pero no podrá realizar cambios en el análisis una vez que lo haya eliminado. Navegue hasta la página Análisis y busque el análisis que desee eliminar. Seleccione el icono de detalles (⋮) en el análisis y, a continuación, elija **Eliminar**. Confirme la eliminación volviendo a elegir **Eliminar**. Esta acción no se puede deshacer.

# Adición y administración de hojas
<a name="working-with-multiple-sheets"></a>

Una *hoja* es un conjunto de elementos visuales que se visualizan juntos en una sola página. Cuando se crea un análisis, se colocan elementos visuales en el espacio de trabajo de una hoja. Imagine que es como una hoja de un periódico, pero que está llena de visualizaciones de datos. Puede añadir más hojas y especificar que funcionen por separado o juntas en el análisis. 

La hoja principal, también denominada la hoja predeterminada, es la que se muestra en el extremo izquierdo. Esta hoja se muestra en la parte superior de un análisis o panel de control. Cada análisis puede contener hasta 20 hojas.

Puede compartir análisis y publicar paneles con varias hojas. También puede programar informes por correo electrónico para cualquier combinación de hojas de un análisis.

Al crear un análisis nuevo o una hoja nueva en un análisis existente, puede elegir si desea convertir la nueva hoja en una **hoja interactiva** o en un **informe perfecto en píxeles**. De esta forma, puede tener análisis solo para hojas interactivas, análisis solo para informes con píxeles perfectos o puede tener un análisis que incluya tanto hojas interactivas como informes con píxeles perfectos.

Una *hoja interactiva* es una colección de datos expresados en elementos visuales con los que los usuarios pueden interactuar cuando la hoja se publica en un panel de control. Los autores de Amazon Quick pueden añadir diferentes controles y filtros a sus hojas interactivas. Los usuarios del panel pueden utilizarlos para obtener información detallada de los datos publicados. Para obtener más información sobre las hojas interactivas, consulte [Trabajar con hojas interactivas en Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/working-with-interactive-sheets.html).

Un *informe paginado* es una colección de tablas, gráficos y elementos visuales que se utilizan para transmitir información empresarial crítica, como resúmenes de transacciones diarias o informes empresariales semanales. Para crear informes con píxeles perfectos en Quick Sight, añada el **complemento Pixel Perfect Reporting** a su cuenta de Quick. Para obtener el **complemento Pixel Perfect Reporting** y empezar a trabajar con informes perfectos, consulta Cómo [trabajar con informes Pixel Perfect en Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/working-with-reports.html).

 Utilice la siguiente lista de acciones para usar las hojas:
+ Para agregar una nueva hoja, elija el signo más (\$1) a la derecha de las pestañas de hoja, elija el tipo de hoja que desee y, a continuación, seleccione **AGREGAR**.
+ Para cambiar el nombre de una hoja, elija el nombre de la hoja y empiece a escribir. El cambio de **nombre** también está disponible en el menú de hojas.
+ Para duplicar una hoja, elija el nombre de la hoja y, a continuación, elija **Duplicar** en el menú de hojas. Solo puede duplicar una hoja si la opción **Autoguardado** está activada.
+ Para duplicar una hoja interactiva y convertirla en un informe con píxeles perfectos, elija el nombre de la hoja y, a continuación, seleccione **Duplicar para informar** en el menú de hojas. No se puede convertir un informe con píxeles perfectos en una hoja interactiva.
+ Para eliminar una hoja, elija el nombre de la hoja y, a continuación, elija **Eliminar** en el menú de la hoja. No se puede eliminar la hoja si es la única hoja del análisis.
+ Para cambiar el orden de las hojas, elija el nombre de la hoja y arrástrela a una nueva posición.
+ Para copiar un elemento visual en una nueva hoja, seleccione **Duplicar elemento visual en** en el menú del elemento visual. A continuación, elija la hoja de destino. Los filtros solo existen en la hoja en la que los crea. Para duplicar los filtros, vuelva a crearlos en la hoja de destino.
+ Para resaltar puntos de datos específicos en las visualizaciones de una hoja, vaya a la pestaña **Hojas** y seleccione **Configuración de diseño**. En la sección, **Interactividad**, seleccione **Al seleccionar** o **Al pasar el ratón** para activar el resaltado o **Sin resaltado** para desactivarlo. De forma predeterminada, el resaltado de hojas sigue la misma configuración que el resaltado de análisis.

  Al seleccionar o pasar el ratón sobre un punto de datos de un elemento visual, se destacarán los datos relacionados en otros elementos visuales, mientras que se atenuarán los datos no relacionados. Al destacarlos, puede comprender las correlaciones, detectar patrones, tendencias y valores atípicos, y facilitar análisis más sólidos y fundamentados.

Puede utilizar los controles de parámetros de la hoja principal para controlar varias hojas. Para ello, abra cada hoja con la que quiera trabajar con el parámetro. A continuación, añada un filtro que utilice el mismo parámetro utilizado en el control de la hoja superior. O bien, si desea que una nueva hoja opere de manera independiente, puede añadirle parámetros y controles de parámetros independientes de los de la hoja principal.

# Trabajar con hojas interactivas en Amazon Quick Sight
<a name="working-with-interactive-sheets"></a>

Una *hoja interactiva* es una colección de datos expresados en elementos visuales con los que los usuarios pueden interactuar cuando la hoja se publica en un panel de control. Los autores de Amazon Quick pueden añadir diferentes diseños, controles y filtros a sus hojas interactivas que los usuarios de los paneles pueden utilizar para obtener información detallada a partir de los datos publicados. De forma predeterminada, cada hoja de un análisis es una hoja interactiva. Si tu cuenta no tiene el **complemento Pixel Perfect Reporting**, solo puedes crear y publicar hojas interactivas.

Para obtener más información sobre cómo crear hojas interactivas, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md).

Para obtener más información sobre el formato de las hojas interactivas, consulte los temas siguientes.

**Topics**
+ [Personalización de los diseños de los paneles en Amazon Quick Sight](customizing-dashboards-and-visuals.md)
+ [Parámetros en Amazon Quick](parameters-in-quicksight.md)
+ [Uso de acciones personalizadas para filtrar y navegar](quicksight-actions.md)

# Personalización de los diseños de los paneles en Amazon Quick Sight
<a name="customizing-dashboards-and-visuals"></a>

Puede personalizar el diseño de un panel para organizar los datos de forma que se ajusten a los requisitos de su empresa. Puede elegir entre tres diseños de panel. También puede cambiar el tamaño, el color de fondo, el color del borde y las interacciones de un elemento visual para crear un panel totalmente personalizado.

Utilice los siguientes temas para obtener más información sobre la personalización de paneles y elementos visuales.

**Topics**
+ [Tipos de diseño](types-of-layout.md)
+ [Selección de un diseño](choosing-a-layout.md)
+ [Personalización de elementos visuales en un diseño de formato libre](customizing-visuals-in-free-form.md)
+ [Reglas condicionales](conditional-rules.md)

# Tipos de diseño
<a name="types-of-layout"></a>

Puede elegir entre tres diseños de paneles: **En mosaico**, **Formato libre** y **Clásico**.

## Diseño en mosaico
<a name="tiled-layout"></a>

Los elementos visuales de un diseño en **mosaico** se ajustan a una cuadrícula con espaciado y alineación estándar. Puede crear elementos visuales de cualquier tamaño y colocarlos donde quiera dentro de un panel, pero los elementos visuales no pueden superponerse. 

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/fixed-layouts-tiled-demo.gif)


Los paneles se muestran tal y como están diseñados, con opciones para ajustarlos a la pantalla o verlos a tamaño real. También puede ajustar un panel completo a la ventana si elige **Ajustar a la ventana** en **Ver**, en la esquina superior derecha. Anteriormente, esta opción se llamaba **Optimizado**.

**nota**  
En los dispositivos móviles, los paneles con diseño en mosaico aparecen como una sola columna en modo vertical o exactamente como se diseñaron en modo horizontal. 

## Diseño de formato libre
<a name="free-form-layout.title"></a>

Los elementos visuales de un diseño de **formato libre** pueden colocarse en cualquier lugar del panel con unas coordenadas precisas. Puede arrastrar una imagen al lugar exacto que desee o ingresar las coordenadas de la ubicación del elemento visual. Siga este procedimiento para ingresar las coordenadas exactas de la ubicación del elemento visual.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/fixed-layouts-freeform-placement1.gif)


Los paneles de control se muestran de la forma que elija para diseñarlos, con opciones para ajustarlos a la pantalla o para verlos en su tamaño real. Puede optimizar los diseños de formato libre para verlos a resoluciones específicas, con la predeterminada de 1600 píxeles. También puede ajustar un panel completo a la ventana de un navegador si elige **Ajustar a la ventana** en **Ver**, en la esquina superior derecha.

**nota**  
Los paneles con resoluciones optimizadas pueden aparecer más grandes o más pequeños en el equipo del usuario si la resolución del equipo del usuario no es igual a la resolución establecida del panel.   
El cambio de **formato libre** a otro diseño puede hacer que algunos elementos visuales cambien.  
En los dispositivos móviles, los paneles de **formato libre** aparecen tal y como se publicaron, sin cambios en el diseño.

## Diseño clásico
<a name="classic-layout.title"></a>

Los elementos visuales de un diseño **clásico** se ajustan a una cuadrícula con espaciado y alineación estándar. Los paneles ocultan datos o cambian el formato para adaptarse a pantallas más pequeñas. Por ejemplo, si cambia un elemento visual para que sea considerablemente menor, el menú de elementos visuales y los editores se ocultan de forma que los elementos del gráfico dispongan de más espacio para mostrarse. Los elementos visuales del gráfico de barras también pueden mostrar menos puntos de datos.

Si reduce el tamaño de la ventana del navegador, Amazon Quick Sight cambia el tamaño y, si es necesario, reordena las imágenes para una visualización óptima. Por ejemplo, los elementos visuales más pequeños que se mostraban en paralelo pueden mostrarse de forma secuencial. El diseño original se restablece cuando el tamaño de la ventana del navegador se aumenta de nuevo.

**nota**  
En los dispositivos móviles, los paneles de control de diseño clásico aparecen como una sola columna o exactamente como se diseñaron en modo horizontal.

# Selección de un diseño
<a name="choosing-a-layout"></a>

**Cambio del diseño de un panel de control**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee cambiar.

1. En la página de análisis, elija **Editar** y, a continuación, elija **Configuración de análisis**.

1. Expanda **Diseño de la hoja** y elija el diseño que desea usar.

1. Cuando haya terminado, seleccione **Apply**.

# Personalización de elementos visuales en un diseño de formato libre
<a name="customizing-visuals-in-free-form"></a>

Puede utilizar el diseño de formato libre para personalizar completamente el color, tamaño, ubicación y visibilidad de cada elemento visual en un panel.

## Organización de elementos visuales
<a name="organizing-visuals.title"></a>

Además de arrastrar un elemento visual a su ubicación preferida dentro de un panel, hay muchas maneras diferentes de mover un elemento visual a la ubicación precisa en la que debe estar.

**Introducción de las coordenadas de la ubicación del elemento visual**

1. Elija el elemento visual que quiera.

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

1. En el panel **Propiedades** que se abrirá, elija **Ubicación**. 

1. Ingrese las coordenadas **X** e **Y** de la ubicación en la que desea colocar el elemento visual. También puede ajustar el tamaño del elemento visual si ingresa los valores de **Ancho** y **Alto**. 

Las imágenes seleccionadas también se pueden mover pixel-by-pixel con las teclas de flecha del teclado.

Puede superponer los elementos visuales para crear imágenes de varias capas que muestren datos.

Los elementos visuales pueden organizarse en varias capas que pueden desplazarse manualmente al frente y al fondo.

**Desplazamiento de los elementos visuales superpuestos al frente y al fondo**

1. Elija el elemento visual que quiera.

1. **En el menú de tres puntos situado en la parte superior derecha de la imagen, selecciona Opciones de menú.**

1. En **Opciones de menú**, elija entre las siguientes opciones:
   + **Enviar al fondo** envía el elemento visual al fondo.
   + **Enviar hacia atrás** envía el elemento visual una capa hacia atrás.
   + **Traer hacia delante** envía el elemento visual una capa hacia delante.
   + **Traer al frente** trae un elemento visual al frente.

## Cambio del color de fondo de un elemento visual
<a name="changing-a-visuals-background-color.title"></a>

Los colores del fondo, borde y marco de selección de un elemento visual pueden personalizarse en el panel **Configuración de visualización** del panel **Propiedades**.

**Cambio del color del fondo, borde o marco de selección de un elemento visual**

1. Elija el elemento visual que desea cambiar.

1. En el menú de la esquina superior derecha del elemento visual, elija el icono **Propiedades**.

1. En el panel **Propiedades** que aparece a la izquierda, elija **Configuración de visualización**.

1. Navegue hasta la sección **Estilo de tarjeta** y lleve a cabo una o varias de las acciones disponibles:
   + Para cambiar el color del fondo de un elemento visual, elija el cuadro **Color de fondo** y elija el color que desee.
   + Para cambiar el color del borde de un elemento visual, elija el cuadro **Color del borde** y elija el color que desee.
   + Para cambiar el color del marco de selección de un elemento visual, elija el cuadro **Color de selección** y elija el color que desee.

   Si desea usar un color personalizado para el fondo, el borde o el marco de selección del elemento visual, elija el cuadro de color de la propiedad que desee cambiar y, a continuación, elija **Color personalizado**. En la ventana **Color personalizado** que aparecerá, elija su color personalizado o introduzca el código hexadecimal del color. Cuando haya terminado elija **Apply (Aplicar)**.

También puede restablecer el aspecto predeterminado del fondo personalizado de un elemento visual.

**Restablecimiento del aspecto de un elemento visual**

1. Elija el elemento visual que desea cambiar.

1. En el menú de la esquina superior derecha del elemento visual, elija el icono **Propiedades**.

1. En el panel **Propiedades** que aparece a la izquierda, elija **Configuración de visualización**.

1. Elija el color que desee restablecer y, a continuación, elija **Restablecer al valor predeterminado**.

## Ocultación de fondos, bordes y colores de selección de elementos visuales
<a name="hiding-visual-backgrounds-and-borders.title"></a>

También puede elegir no mostrar el borde de fondo o el color de selección de un elemento visual. Esto resulta útil cuando desea superponer varios elementos visuales. Puede ocultar el fondo, el borde y los colores de selección de un elemento visual si elige el icono de ojo situado junto a las casillas **Color del borde**, **Color de fondo** o **Color de selección**. También puede eliminar la animación de carga de un elemento visual si desactiva la casilla **Mostrar animación de carga**. 

## Desactivación de los menús de los elementos visuales
<a name="disabling-visual-menus.title"></a>

Utilice el panel **Interacciones** del panel **Propiedades** para ocultar el **Menú contextual** y el **Menú visual** de las imágenes seleccionadas. Los menús de elementos visuales secundarios se pueden ocultar para que el elemento visual esté menos saturado o para que un elemento visual actúe como una superposición. 

El menú **contextual** se abre al hacer clic en un punto de datos. Las acciones más comunes del **Menú contextual** son **Enfocar**, **Excluir** y **Desglosar**.

El menú **En elemento visual** aparece en la parte superior derecha de un elemento visual. El menú **Elemento visual** se utiliza para acceder al panel **Propiedades**, **Maximizar** el elemento visual, acceder al panel **Opciones de menú** y revisar **Información de anomalías**.

Puede desactivar los menús visuales secundarios borrando las opciones **Menú contextual** y **Menú del elemento visual**.

**nota**  
No puede previsualizar los cambios del panel **Interacciones** en **Análisis**. Publique el panel para ver los cambios.

# Reglas condicionales
<a name="conditional-rules"></a>

Esta característica está disponible actualmente con el diseño de **formato libre**. Las reglas condicionales se usan para ocultar o mostrar elementos visuales cuando se cumplen determinadas condiciones. Esto es muy útil cuando hay varias versiones del mismo elemento visual superpuestas y se desea que el usuario vea la versión que mejor representa el valor del parámetro seleccionado. 

Las reglas condicionales utilizan parámetros y controles de parámetros para ocultar y mostrar elementos visuales. Los parámetros son variables con nombre que pueden pasar un valor para que lo use una acción o un objeto. Esta característica admite parámetros numéricos y de cadena. Para que los parámetros estén accesibles para el lector del panel, se añade un control de parámetros. Un control de parámetros permite a los usuarios elegir un valor para utilizarlo en un filtro predefinido o en una acción de URL. Para obtener más información sobre parámetros y controles de parámetros, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

Use las siguientes secciones para configurar y usar reglas condicionales.

**Topics**
+ [Ocultación de un elemento visual predeterminado](hiding-a-visual-by-default.title.md)
+ [Configuración de una regla condicional](setting-a-conditional-rule.title.md)
+ [Uso de reglas condicionales](using-conditional-rules.md)

# Ocultación de un elemento visual predeterminado
<a name="hiding-a-visual-by-default.title"></a>

En el panel **Interacciones** del panel **Propiedades**, puede optar por ocultar un elemento visual de forma predeterminada. Esto puede ser útil si quiere que el espectador solo vea elementos visuales basados en condiciones específicas.

**Ocultación de un elemento visual predeterminado**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. Elija el elemento visual al que desea agregar una regla.

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que se abrirá, elija **Interacciones** y abra el menú desplegable **Reglas**.

1. En el menú **Reglas**, seleccione **Ocultar este elemento visual de forma predeterminada**.

Los elementos visuales ocultos aparecen totalmente ocultos en un panel de visualización. En el panel **Análisis**, los elementos visuales ocultos aparecen con el mensaje “Oculto en función de una regla”. Con esta visualización, puede ver dónde se encuentran todos los elementos visuales de un panel.

**nota**  
No se pueden crear reglas condicionales que oculten elementos visuales que ya están ocultos de forma predeterminada o que muestren elementos visuales que ya aparecen de forma predeterminada. Si cambia la apariencia predeterminada de un elemento visual, se desactivarán las reglas existentes que contradigan la nueva apariencia predeterminada.

# Configuración de una regla condicional
<a name="setting-a-conditional-rule.title"></a>

Cuando se configura una regla condicional, se crea una instrucción condicional que ocultará o mostrará un elemento visual cuando se cumpla una condición específica. Actualmente se pueden crear reglas condicionales que oculten o muestren un elemento visual. Si quiere crear una regla condicional que haga aparecer un elemento visual oculto, seleccione **Ocultar este elemento visual de forma predeterminada** en el menú **Reglas** del panel **Propiedades**. 

**nota**  
Antes de empezar, cree un parámetro y un control de parámetro correspondiente en los que basar su nueva regla condicional. Los parámetros admitidos son parámetros de cadena y numéricos. Para obtener más información sobre parámetros y controles de parámetros, consulte [Parámetros en Amazon Quick](parameters-in-quicksight.md).

**Establecimiento de una regla condicional**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. Elija el elemento visual al que desea agregar una regla.

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que aparecerá a la izquierda, elija **Interacciones** y, a continuación, elija **Reglas**.

1. Seleccione **AGREGAR REGLA**.

1. En el primer menú del panel **Agregar regla**, elija el parámetro que desee.

1. En el segundo menú del panel **Agregar regla**, elija la condición que desee. Para los parámetros de cadena, las condiciones admitidas son **Igual a**, **Empieza por**, **Contiene** y **No es igual a**. Para los parámetros numéricos, las condiciones admitidas son **Igual a**, **Empieza por**, **Contiene** y **No es igual a**.

1. Ingrese el valor que desea que cumpla la regla condicional.
**nota**  
Los valores distinguen entre mayúsculas y minúsculas.

1. Seleccione **Agregar regla** para aplicar la nueva regla condicional al elemento visual. Para cancelar la regla, seleccione **Cancelar**.

Las reglas condicionales también pueden editarse y eliminarse. 

**Edición de una regla condicional**

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que aparecerá a la izquierda, elija **Interacciones** y, a continuación, elija **Reglas**.

1. Seleccione el icono de menú situado a la derecha de la regla que desea editar y elija **Editar**.

1. Realice los cambios que desee y seleccione **Guardar**.

**Eliminación de una regla condicional**

1. En el menú de la esquina superior derecha del elemento visual, elija **Propiedades**.

1. En el panel **Propiedades** que aparecerá a la izquierda, elija **Interacciones** y, a continuación, elija **Reglas**.

1. Seleccione el icono de menú situado a la derecha de la regla que desea editar y elija **Eliminar**.

# Uso de reglas condicionales
<a name="using-conditional-rules"></a>

Una vez que configuró una regla condicional que está conectada a un parámetro y a un control de parámetro, puede utilizar el control de parámetro para activar o desactivar las reglas condicionales que configuró. 

**Habilitación de una regla condicional**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. En la barra de **Controles** de la parte superior del área de trabajo, seleccione el icono desplegable.

1. Elija el control de parámetros asociado a la regla condicional que creó.

1. Elija el valor asociado a la regla condicional que creó en el menú del parámetro. También puede ingresar el valor que desee en el cuadro **Buscar valor**.
**nota**  
Los valores distinguen entre mayúsculas y minúsculas.

   Si selecciona el valor correcto, el elemento visual aparecerá o desaparecerá en función de la regla que se estableció.

También puede incorporar un control de parámetros a la hoja en la que se encuentra el elemento visual. Esto es útil cuando quiere que un control de parámetros esté junto al elemento visual al que está asociado o cuando quiere agregar una regla condicional al control para que solo aparezca cuando se cumplan determinadas condiciones. 

**Incorporación de un control de parámetros a una hoja**

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. En la barra de **Controles** de la parte superior del área de trabajo, elija el control que desea mover.

1. En la parte superior derecha del control, abra el menú **Opciones de menú**. 

1. Seleccione **Mover a la hoja**.

**Devolución de un control de parámetros a la barra de controles**

1. En su panel, seleccione el control de parámetros que desea mover. 

1. En la parte superior derecha del control, abra el menú **Opciones de menú**. 

1. Elija **Moverse a la parte superior de la hoja**. 

# Parámetros en Amazon Quick
<a name="parameters-in-quicksight"></a>

Los *parámetros* son variables con nombre que pueden pasar un valor para que lo use una acción o un objeto. Al utilizar parámetros, puede crear una forma más sencilla para que un usuario del panel interactúe con las características de éste de una forma menos técnica. Los parámetros también pueden conectar un panel con otro, lo que permite al usuario profundizar hasta llegar a datos de otro análisis.

Por ejemplo, un usuario de un panel puede utilizar una lista para elegir un valor. Ese valor define un parámetro que a su vez establece el valor elegido en un filtro, un cálculo o una acción de URL. A continuación, los elementos visuales del panel reaccionarán a las opciones que elija el usuario. 

Para que los parámetros estén accesibles para el lector del panel, se añade un control de parámetros. Puede configurar los controles en cascada, de modo que una selección en un control filtre las opciones que aparecen en otro. Un control puede aparecer como una lista de opciones, un control deslizante, o un área de entrada de texto. Aunque no cree un control, puede transferir un valor al parámetro en la URL del panel.

Para que un parámetro funcione, tiene que estar conectado a algo en su análisis, independientemente de si tiene un control relacionado. Puede hacer referencia a los parámetros de la siguiente manera:
+ Campos calculados (excepto los parámetros con varios valores)
+ Filtros
+ Panel de control y análisis URLs
+ Acciones
+ Títulos y descripciones a lo largo de un análisis

A continuación se indican algunas maneras de usar los parámetros:
+ Puede utilizar un cálculo para transformar los datos que se muestran en un análisis. 
+ Si agrega un control con un filtro a un análisis que va a publicar, los usuarios del panel podrán filtrar los datos sin necesidad de crear sus propios filtros.
+ Puede usar los controles y las acciones personalizadas para permitir que los usuarios del panel establezcan valores para las acciones de dirección URL. 

**Topics**
+ [Configuración de parámetros en Amazon Quick](parameters-set-up.md)
+ [Uso de un control con un parámetro en Amazon Quick](parameters-controls.md)
+ [Creación de parámetros predeterminados en Amazon Quick](parameters-default-values.md)
+ [Conexión a parámetros en Amazon Quick](parameters-connections.md)

# Configuración de parámetros en Amazon Quick
<a name="parameters-set-up"></a>

Utilice el siguiente procedimiento para crear o editar un parámetro básico.

**Creación o edición de un parámetro básico**

1. Elija un análisis con el que trabajar y, a continuación, decida qué campo desea parametrizar.

1. Elija el icono **Parámetros** de la lista de iconos situada en la parte superior de la página.

1. Para agregar un nuevo parámetro, seleccione el signo más (**\$1 Agregar**) situado en la parte superior del panel.

   Para editar un parámetro, elija el icono con forma de `v` situado cerca del nombre del parámetro y, a continuación, elija **Editar parámetro**. 

1. En **Nombre**, ingrese un valor alfanumérico para el parámetro.

1. En **Tipo de datos**, elija **Cadena**, **Número**, **Entero** o **Fecha y hora** y, a continuación, siga los pasos siguientes.
   + Si elige **Cadena**, **Número** o **Entero**, haga lo siguiente:

     1. En **Valores**, elija **Valor único** o **Valores múltiples**.

        Elija la opción de valor único para los parámetros que solo pueden contener un valor. Elija varios valores para los parámetros que pueden contener uno o más valores. Los parámetros con varios valores no puede ser de los tipos `datetime`. Tampoco admiten valores predeterminados dinámicos.

        Para cambiar un parámetro existente entre uno y varios valores, elimine el parámetro y vuelva a crearlo.

     1. (Opcional) En **Valor predeterminado estático** o **Valores predeterminados múltiples estáticos**, ingrese uno o más valores.

        Este tipo de valor estático se utiliza durante la primera carga de la página si no se proporciona un valor dinámico predeterminado o un parámetro URL.

     1. (Opcional) Seleccione **Mostrar como vacío de forma predeterminada**.

        Seleccione esta opción para mostrar el valor predeterminado de las listas de varios valores como en blanco. Esta opción solo se aplica a los parámetros de varios valores.
   + Si elige **Fecha y hora**, haga lo siguiente:

     1. En **Grado de detalle del periodo de tiempo**, elija **Día**, **Hora**, **Minuto** o **Segundo**.

     1. En **Fecha predeterminada**, seleccione **Fecha fija** o **Fecha relativa** y, a continuación, haga lo siguiente:
        + Si selecciona **Fecha fija**, ingrese una fecha y hora con el selector de fecha y hora.
        + Si selecciona **Fecha relativa**, elija una fecha variable. Puede elegir **Hoy**, **Ayer**, o puede especificar la **Condición de filtro** (inicio de o fin de), **Rango** (este, anterior o siguiente) y **Periodo** (año, trimestre, mes, semana o día).

1. (Opcional) Seleccione **Establecer un valor predeterminado dinámico** para crear un valor predeterminado específico del usuario.

   Un *valor predeterminado dinámico *es un valor predeterminado que varía en función del usuario y se utiliza la primera vez que se carga la página del panel. Utilice un valor predeterminado dinámico para crear una vista personalizada por usuario.

   No se pueden utilizar campos calculados como valores predeterminados dinámicos.

   Los valores predeterminados dinámicos no impiden que un usuario seleccione un valor diferente. Si desea proteger los datos, puede agregar un bloqueo de nivel de fila. Para obtener más información, consulte [Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datosUso de reglas basadas en usuarios](restrict-access-to-a-data-set-using-row-level-security.md).

   Esta opción solo aparece si elige un parámetro de valor único. Los parámetros con varios valores no pueden tener valores predeterminados dinámicos.
**nota**  
Si elige un parámetro con varios valores, la pantalla cambia para suprimir las opciones predeterminadas. En su lugar, verá un cuadro con el texto **Especifique los valores que desea usar para este control**. Puede escribir varios valores en este cuadro, cada uno en una línea. Estos valores se seleccionarán de forma predeterminada en el control del parámetro. Los valores indicados se agregan a los que decida incluir en el control del parámetro. Para obtener más información sobre los controles de parámetros, consulte [Controles de parámetros](parameters-controls.md).

1. (Opcional) Establezca un valor reservado para determinar el valor del valor **Seleccionar todo**. El *valor reservado* de un parámetro es el valor que se asigna a un parámetro cuando se elige **Seleccionar todo** como su valor. Cuando establece un valor reservado específico para su parámetro, ese valor ya no se considera un valor de parámetro válido en su conjunto de datos. El valor reservado no se puede utilizar en ningún *consumidor de parámetros*, como filtros, controles y campos calculados, ni en acciones personalizadas. Además, no aparece en la lista de control de parámetros. Puede elegir entre **Valor recomendado**, **Nulo** y **Personalizado**. El **valor recomendado** es el predeterminado. Si elige **Valor recomendado**, el valor reservado se establece en los siguientes valores en función del tipo de valor:
   + Cadenas: `"ALL_VALUES"`
   + Números: `"Long.MIN_VALUE"-9,223,372,036,854,775,808`
   + “Enteros: `Int.MIN_VALUE"-2147483648`

   Para establecer un valor reservado en su nuevo parámetro, elija la lista desplegable **Configuración avanzada** en la página **Crear un nuevo parámetro** o en la página **Editar parámetro** y seleccione el valor que desee.

1. Seleccione **Crear** o **Actualizar** para completarla creación o actualización del parámetro.

Después de crear un parámetro, puede utilizarlo de diversas formas. Puede crear un control (como, por ejemplo, un botón) que permita elegir un valor para el parámetro. Para obtener más información, consulte las siguientes secciones.

# Uso de un control con un parámetro en Amazon Quick
<a name="parameters-controls"></a>

En los paneles, los controles de parámetros aparecen en la parte superior de la hoja de datos, que contiene un conjunto de elementos visuales. Proporcionar un control permite a los usuarios elegir un valor para utilizarlo en un filtro o acción de URL. Los usuarios de un panel pueden utilizar controles para aplicar filtros a todos los conjuntos de datos de elementos visuales de un panel, sin tener que crear ellos mismos los filtros. 

Se aplican las siguientes reglas:
+ Para crear o editar un control de un parámetro, asegúrese de que el parámetro existe. 
+ Los controles de lista de selección múltiple son compatibles con el análisis URLs, el panel de control URLs, las acciones personalizadas y los filtros personalizados. El filtro tiene que ser igual o distinto a los valores proporcionados. No se admiten más comparaciones. 
+ Las listas muestran hasta 1000 valores. Si hay más de 1000 valores distintos, aparece un cuadro de búsqueda para que pueda filtrar la lista. Cuando la lista filtrada contiene menos de 1001 valores, el contenido de la lista aparece como partidas.
+ La opción **Estilo** solo muestra los tipos de estilos que correspondan al tipo de datos del parámetro y a la selección de valor individual o múltiple. Si el estilo que quiere utilizar no está en la lista, vuelva a crear el parámetro con la configuración adecuada e inténtelo de nuevo.
+ Si el parámetro está vinculado a un campo del conjunto de datos, debe ser un campo real. No se admiten campos calculados.
+ Los valores se muestran en orden alfabético en el control, a menos que haya más de 1000 valores distintos. A continuación, el control muestra un cuadro de búsqueda en su lugar. Cada vez que busca el valor que se desea utilizar, se inicia una nueva consulta. Si los resultados contienen más de 1000 valores, puede desplazarse por los valores con paginación. Se admite la búsqueda con comodines. Para obtener más información sobre la búsqueda con comodines, consulte [Uso de la búsqueda comodín](search-filter.md#search-filter-wildcard).

Utilice el siguiente procedimiento para crear o editar un control para un parámetro existente. 

**Creación o edición de un control para un parámetro existente**

1. Elija el menú contextual de un parámetro existente, el icono `v` situado junto al nombre del parámetro, y elija **Agregar control**.

1. Escriba un nombre para la etiqueta del nuevo control. Esta etiqueta aparece en la parte superior del área de trabajo y, posteriormente, en la parte superior de la hoja en la que se muestra un panel. 

1. Elija el estilo del control entre los siguientes:
   + **Campo de texto**

     Un campo de texto le permite escribir su propio valor. Un campo de texto funciona con números y texto (cadenas).
   + **Campo de texto: multilínea**

     Un campo de texto multilínea le permite ingresar sus propios valores. Con esta opción, puede elegir separar los valores que ingrese en el control de parámetros mediante un salto de línea, una coma, una barra (\$1) o un punto y coma. Un campo de texto funciona con números y texto (cadenas).
   + **Lista desplegable**

     Un control de lista desplegable que puede utilizar para seleccionar un único valor. Un control de lista funciona con números y texto (cadenas). 
   + **Lista desplegable multiselección**

     Un control de lista que puede utilizar para seleccionar varios valores. Un control de lista funciona con números y texto (cadenas). 
   + **Lista**

     Un control de lista que puede utilizar para seleccionar un único valor. Un control de lista funciona con números y texto (cadenas). 
   + **Lista: multiselección**

     Un control de lista que puede utilizar para seleccionar varios valores. Un control de lista funciona con números y texto (cadenas). 
   + **Slider**

     Un control deslizante permite seleccionar un valor numérico al deslizar el control de un extremo a otro de la barra. Un control deslizante funciona bien con números.
   + **Selector de fecha**

     Con un selector de fecha, puede elegir una fecha de un control de calendario. Al agregar un selector de fecha, puede personalizar el formato de las fechas en el control. Para ello, en **Formato de fecha**, ingrese el formato de fecha que quiera con los tokens descritos en [Personalización de los formatos de fecha en Quick](format-visual-date-controls.md).

1. (Opcional) Si elige un control desplegable, la pantalla se expande de modo que puede elegir los valores que se mostrarán. Puede especificar una lista de valores o utilizar un campo de un conjunto de datos. Seleccione una de las siguientes opciones:
   + **Valores específicos**

     Para crear una lista de valores específicos, escriba uno por línea, sin espacios ni comas de separación, tal y como se muestra en la siguiente captura de pantalla.

     En el control, los valores se muestran alfabéticamente, no en el orden en que los escribió.
   + **Enlazar a un campo del conjunto de datos**

     Para enlazar a un campo, elija el conjunto de datos que contiene el campo y, a continuación, seleccione el campo en la lista.

     Si cambia los valores predeterminados del parámetro, seleccione **Restablecer** en el control para mostrar los nuevos valores.

   Los valores que elija aquí se agregan a los valores predeterminados estáticos de la configuración del parámetro.

1. (Opcional) Active la opción **Ocultar [TODOS] del control si el parámetro tiene configurado un valor predeterminado**. Al hacer esto solo se muestran los valores de los datos y se elimina la opción de seleccionar todos los elementos en el control. Si no configura un valor predeterminado estático en el parámetro, esta opción no funciona. Para agregar un valor predeterminado después de añadir un control, elija el parámetro y **Editar parámetro**.

1. (Opcional) Puede limitar los valores que se muestran en los controles de modo que solo aparezcan los que sean válidos en función de lo seleccionado en otros controles. Esto se denomina control en cascada. 

   Para crear uno, elija **Mostrar solo valores relevantes**. Elija uno o varios controles que puedan cambiar lo que se muestra en este control. 

   Al crear controles en cascada, se aplican las siguientes limitaciones.
   + Los controles en cascada deben estar vinculados a columnas del mismo conjunto de datos.
   + El control secundario debe ser un control desplegable o de lista.
   + En el caso de los controles de parámetros, el control secundario debe estar vinculado a una columna del conjunto de datos.
   + En el caso de los controles de filtro, el control secundario debe estar vinculado a un filtro (en lugar de mostrar solo valores específicos).
   + El control principal debe ser uno de los siguientes.
     + Un control de parámetros de cadena, entero o numérico.
     + Un control de filtro de cadena (EXCLUIDOS los filtros superior e inferior).
     + Un control de filtro numérico no agregado.
     + Un control de filtro de fecha (EXCLUIDOS los filtros superior e inferior).

1. Cuando haya terminado de elegir opciones para el control, seleccione **Agregar**.

El control terminado aparece en la parte superior del espacio de trabajo. El menú contextual, con forma de `v`, ofrece cuatro opciones:
+ **Restablecer** restaura la selección del usuario a su estado predeterminado.
+ **Actualizar lista** se aplica únicamente a las listas desplegables que están enlazadas a un campo de un conjunto de datos. Al elegir **Actualizar lista** se consultan los datos para comprobar si hay cambios. Los datos utilizados en el control se almacenan en la caché.
+ **Editar** vuelve a abrir la pantalla de creación del control para que pueda modificar la configuración.

  Una vez que tenga abierto el panel **Editar control**, puede hacer clic en diferentes elementos visuales y controles para ver los datos de formato para el elemento visual o control específico. Para obtener más información sobre el formato de un elemento visual, consulte [Formatear en Amazon Quick](formatting-a-visual.md).
+ **Eliminar** elimina el control. Puede volver a crearlo eligiendo el menú contextual del parámetro.

En el espacio de trabajo, también puede reordenar y redimensionar los controles. Los usuarios del panel los verán exactamente igual que usted, salvo que no podrán editarlos ni eliminarlos.

# Creación de parámetros predeterminados en Amazon Quick
<a name="parameters-default-values"></a>

En esta sección obtendrá más información sobre los tipos de valores predeterminados de parámetros que están disponibles y cómo configurar cada uno de ellos. 

Cada campo puede tener asociado un parámetro y un control. Cuando alguien visualiza un panel o un informe por correo electrónico, cualquier control de hoja que tenga configurado un valor predeterminado estático utiliza el valor predeterminado estático. El valor predeterminado puede cambiar cómo se filtran los datos, cómo se comportan las acciones personalizadas y qué texto se muestra en un título de hoja dinámico. Los informes de correo electrónico también admiten valores predeterminados dinámicos. 

El valor predeterminado más sencillo es un valor predeterminado estático (que no cambia), que muestra el mismo valor a todo el mundo. Como diseñador del panel, elige el valor predeterminado. La persona que utiliza el panel no puede cambiarlo. Sin embargo, esa persona puede elegir cualquier valor de los controles. Establecer un valor predeterminado no cambia esto. Para restringir los valores que una persona puede seleccionar, considere el uso de la seguridad a nivel de fila. Para obtener más información, consulte [Uso de la seguridad a nivel de fila con reglas basadas en usuarios para restringir el acceso a un conjunto de datosUso de reglas basadas en usuarios](restrict-access-to-a-data-set-using-row-level-security.md). 

**Creación o edición de un valor predeterminado estático que se aplique a todas las vistas del panel**

1. Elija el menú contextual (`v`) situado junto al parámetro que desea editar o cree un parámetro nuevo siguiendo los pasos que se indican en [Configuración de parámetros en Amazon Quick](parameters-set-up.md). 

1. Ingrese un valor para **Valor predeterminado estático** para establecer un valor predeterminado estático. 

Para mostrar un valor predeterminado diferente en función de quién esté viendo el panel, cree un parámetro predeterminado dinámico (DDP). El uso de valores predeterminados dinámicos implica cierta preparación para asignar a las personas los valores predeterminados que tienen asignados. En primer lugar, debe crear una consulta de base de datos o un archivo de datos que contenga información sobre las personas, los campos y los valores predeterminados que se mostrarán. Esto se agrega a un conjunto de datos y, a continuación, se agrega el conjunto de datos al análisis. A continuación, encontrará procedimientos que puede utilizar para recopilar información, crear el conjunto de datos y agregar el valor predeterminado dinámico al parámetro.

Use las siguientes pautas cuando cree un conjunto de datos para valores predeterminados dinámicos:
+ Se recomienda utilizar un único conjunto de datos que contenga todas las definiciones dinámicas predeterminadas de una agrupación lógica de usuarios o grupos. Si puede, manténgalas en una única tabla o archivo. 
+ También recomendamos que los nombres de los campos del conjunto de datos coincidan con los nombres de los campos del análisis. No es necesario que todos los campos del conjunto de datos formen parte del análisis, por ejemplo, si utiliza el mismo conjunto de datos para los valores predeterminados en varios paneles. Los campos pueden estar en cualquier orden. 
+ No se recomienda combinar nombres de usuario y de grupo en la misma columna o incluso en el mismo conjunto de datos. Este tipo de configuración requiere más trabajo de mantenimiento y solución de problemas. 
+ Si utiliza un archivo delimitado por comas para crear el conjunto de datos, asegúrese de eliminar cualquier espacio entre los valores del archivo. El siguiente ejemplo muestra el formato correcto de valores separados por comas (CSV). Encierre el texto (cadenas) que incluya caracteres no alfanuméricos, como espacios, apóstrofes, etc. entre comillas simples o dobles. Puede entrecomillar los campos que contengan fechas u horas, pero no es obligatorio. Puede entrecomillar los campos numéricos, por ejemplo, si los números contienen caracteres especiales, como se muestra a continuación. 

  ```
  "Value includes spaces","Field contains ' other characters",12345.6789,"20200808"
  ValueWithoutSpaces,"1000,67","Value 3",2020-AUG-08
  ```
+ Tras crear el conjunto de datos, asegúrese de comprobar los tipos de datos que Quick selecciona para los campos.

Antes de empezar, necesita una lista de los nombres de usuario o grupo de las personas que van a tener valores predeterminados dinámicos. Para generar una lista de usuarios o grupos, puede utilizar la AWS CLI y obtener la información. Al ejecutar comandos de la CLI, asegúrese de tener instalada y configurada la AWS CLI . Para obtener más información, consulte [Installing the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) en la *Guía del usuario de AWS CLI *. 

Este es solo un ejemplo de cómo obtener una lista de nombres de usuarios o grupos. Utilice cualquier método que mejor le funcione.

**Identificación de las personas para un parámetro dinámico predeterminado (DDP)**
+ Enumere los nombres de usuario individuales o los nombres de grupo:
  + Para enumerar nombres de usuario individuales, incluya una columna que identifique a las personas para su DDP. Esta columna debe contener el nombre de usuario del sistema de cada persona que utilice para conectarse desde su proveedor de identidad a Quick. El nombre de usuario suele coincidir con el alias de correo electrónico de la persona antes del signo @, pero no siempre. 

    Para obtener una lista de usuarios, utilice la operación o el AWS CLI comando [ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html)Quick API. El comando de la CLI se muestra en el siguiente ejemplo. Especifique la Región de AWS para su proveedor de identidad, por ejemplo, `us-east-1`.

    ```
    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region
    ```

    El siguiente ejemplo modifica el comando anterior al agregar una consulta que limita los resultados a los usuarios activos.

    ```
    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'
    ```

    El conjunto de resultados es similar al siguiente ejemplo. Este ejemplo es un extracto de la salida JSON (`--output json`). Las personas que tienen nombres de usuario federados tienen un principio IDs que comienza por la palabra`federated`.

    ```
    [
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva",
            "UserName": "anacarolinasilva",
            "Email": "anacasilva@example.com",
            "Role": "ADMIN",
            "Active": true,
            "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate",
            "UserName": "Reader/liujie-stargate",
            "Role": "READER",
            "Active": true,
            "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal",
            "UserName": "embedding/cxoportal",
            "Email": "saanvisarkar@example.com",
            "Role": "AUTHOR",
            "Active": true,
            "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com",
            "UserName": "zhangwei@example.com",
            "Email": "zhangwei@example.com",
            "Role": "AUTHOR",
            "Active": true,
            "PrincipalId": "user/d-96123-example-id-1123"
        }
    ]
    ```
  + Para listar los nombres de grupo, incluya una columna que identifique los grupos que contienen los nombres de usuario para su DDP. Esta columna debe contener los nombres de los grupos del sistema que se utilizan para conectarse desde su proveedor de identidad a Quick. Para identificar los grupos que puede agregar al conjunto de datos, utilice una o más de las siguientes operaciones rápidas de API o comandos de CLI: 
    + [ListGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroups.html)— Muestra los grupos rápidos por Cuenta de AWS ID y espacio de nombres para los Región de AWS que contienen su proveedor de identidad.
    + [ListGroupMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListGroupMemberships.html)— Muestra los usuarios del grupo rápido especificado.
    + [ListUserGroups](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUserGroups.html)— Muestra los grupos rápidos de los que forma parte un usuario rápido.

    También puede pedir a su administrador de red que consulte a su proveedor de identidad para obtener esta información. 

Los dos procedimientos siguientes proporcionan instrucciones sobre cómo terminar de crear un conjunto de datos para valores dinámicos predeterminados. El primer procedimiento es para crear un conjunto de datos para un DDP de valor único. El segundo es para crear un conjunto de datos para un DDP de varios valores. 

**Creación de un conjunto de datos para un DDP de valor único**

1. Cree columnas de conjunto de datos con parámetros de valor único. La primera columna de la consulta o el archivo debe corresponder a las personas que utilizan el panel. Este campo puede contener nombres de usuario o de grupo. Sin embargo, la compatibilidad con los grupos solo está disponible en la edición Quick Enterprise. 

1. Para cada campo que muestre un valor predeterminado dinámico de un parámetro de valor único, agregue una columna al conjunto de datos. El nombre de la columna no es importante; puede utilizar el mismo nombre que el campo o el parámetro.

   Los parámetros de valor único solo funcionan según lo especificado si la combinación de entidad de usuario y valor predeterminado dinámico es única para el campo de ese parámetro. Si hay varios valores en un campo predeterminado para una entidad de usuario, el control de valor único para ese campo muestra el valor predeterminado estático en su lugar. Si no se define ningún valor predeterminado estático, el control no muestra ningún valor predeterminado. Tenga cuidado si utiliza nombres de grupo, porque algunos nombres de usuario pueden ser miembros de varios grupos. Si esos grupos tienen valores predeterminados diferentes, entonces este tipo de nombre de usuario funciona como una entrada duplicada. 

   El siguiente ejemplo muestra una tabla que parece contener dos parámetros de valor único. Suponemos esto porque ningún nombre de usuario está vinculado a varios valores predeterminados. Para que esta tabla sea más fácil de entender, agregamos la palabra `'default'` delante de los nombres de los campos del análisis. Así, puede leer la tabla mediante la siguiente instrucción, cambiándole los valores de cada fila: Cuando lo ve `anacarolinasilva` los controles muestran una región predeterminada `NorthEast` y un segmento predeterminado `SMB`.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/parameters-default-values.html)

1. Importe estos datos a Quick y guárdelos como un conjunto de datos nuevo. 

1. En su análisis, agregue el conjunto de datos que creó. El análisis necesita utilizar al menos otro conjunto de datos que coincida con las columnas que definió para los valores predeterminados. Para obtener más información, consulte [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md).

**Creación de un conjunto de datos para un DDP de varios valores**

1. Cree columnas de conjunto de datos con parámetros de varios valores. La primera columna de la consulta o el archivo debe corresponder a las personas que utilizan el panel. Este campo puede contener nombres de usuario o de grupo. Sin embargo, la compatibilidad con grupos solo está disponible en la edición Quick Enterprise. 

1. Para cada campo que muestre un valor predeterminado dinámico de un parámetro de varios valores, agregue una columna al conjunto de datos. El nombre de la columna no es importante; puede utilizar el mismo nombre que el campo o el parámetro. 

   A diferencia de los parámetros de valor único, los parámetros de varios valores permiten varios valores en el campo asociado al parámetro. 

   El siguiente ejemplo muestra una tabla que parece contener un parámetro de valor único y un parámetro de varios valores. Podemos suponerlo porque cada nombre de usuario tiene un valor único en una columna y algunos nombres de usuario tienen varios valores en la otra columna. Para que esta tabla sea más fácil de entender, agregamos la palabra `'default'` delante de los nombres de los campos del análisis. Así, puede leer la tabla mediante la siguiente instrucción, cambiándole los valores a cada fila: Cuando `viewed-by` es `liujie`, los controles muestran un valor de `default-region` `SouthEast`, y un valor de `default-city` `Atlanta`. Y si leemos una fila más adelante, veremos que `liujie` también tiene `Raleigh` como `default-city`.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/parameters-default-values.html)

   En este ejemplo, el parámetro al que aplicamos `default-region` funciona correctamente tanto si se trata de un parámetro de un solo valor como de varios valores. Si es un parámetro de valor único, funcionan dos entradas para un usuario porque ambas entradas tienen el mismo valor, `SouthEast`. Si es un parámetro de varios valores, funciona igual, salvo que se selecciona un solo valor predeterminado. Sin embargo, si cambiamos el parámetro que utiliza `default-city` predeterminada como valor predeterminado de un parámetro de varios valores a un parámetro de valor único, no veremos seleccionados estos valores predeterminados. En su lugar, el parámetro utiliza el valor predeterminado estático, si hay alguno definido. Por ejemplo, si el valor predeterminado estático se establece en `Atlanta`, `liujie` tiene `Atlanta` seleccionada en ese control, pero no `Raleigh`. 

   En algunos casos, es posible que el valor predeterminado estático también se utilice como valor predeterminado dinámico. Si es así, asegúrese de probar el control para un nombre de usuario que no utilice un valor predeterminado que pueda ser ambos.

   Si un nombre de usuario pertenece a varios grupos, el usuario nombrado ve un conjunto de valores predeterminados que es la unión de los valores predeterminados de los dos grupos. 

1. Importe estos datos a Quick y guárdelos como un conjunto de datos nuevo. 

1. En su análisis, agregue el conjunto de datos que creó. El análisis necesita utilizar al menos otro conjunto de datos que coincida con las columnas que definió para los valores predeterminados. Para obtener más información, consulte [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md).

Siga este procedimiento para agregar un parámetro dinámico predeterminado a su análisis. Antes de comenzar, asegúrese de que dispone de un conjunto de datos que contiene los valores predeterminados dinámicos para cada nombre de usuario o de grupo. Asegúrese también de que su análisis utiliza este conjunto de datos. Para obtener ayuda con estos requisitos, consulte los procedimientos anteriores.

**Adición de un DDP a su análisis**

1. En la consola rápida, elija el icono de **parámetros** en la parte superior de la página y elija un parámetro existente. Seleccione **Editar parámetro** en el menú del parámetro. Para agregar un nuevo parámetro, elija el signo más (`+`) cerca de **Parámetros**.

1. Elija **Establecer un valor predeterminado dinámico**.

1. Configure las siguientes opciones con sus parámetros:
   + **Conjunto de datos con valores predeterminados e información del usuario**: elija el conjunto de datos que creó y agregó a su análisis. 
   + **Columna de nombre de usuario**: para crear valores predeterminados basados en nombres de usuario, elija la columna del conjunto de datos que contiene los nombres de usuario.
   + **Columna de nombre de grupo**: para crear valores predeterminados basados en nombres de grupo, elija la columna del conjunto de datos que contiene los nombres de grupo.
   + **Columna para el valor predeterminado**: elija la columna que contiene los valores predeterminados para este parámetro.

1. Seleccione **Aplicar** para guardar los cambios de configuración y, a continuación, haga clic en **Actualizar** para guardar los cambios de los parámetros. Para salir sin guardar los cambios, elija **Cancelar**.

1. Agregue un filtro para cada campo que contenga valores predeterminados dinámicos para que los valores predeterminados funcionen. Para obtener más información sobre cómo usar filtros con parámetros, consulte [Uso de filtros con parámetros en Amazon Quick](parameters-filtering-by.md).

   Amazon Quick usa el valor predeterminado estático para cualquier persona cuyo nombre de usuario no exista en el conjunto de datos, no tenga un valor predeterminado asignado o no tenga un valor predeterminado único. Cada persona solo puede tener un conjunto de valores predeterminados. Si no desea usar valores predeterminados dinámicos, puede establecer un valor predeterminado estático en su lugar. 

# Conexión a parámetros en Amazon Quick
<a name="parameters-connections"></a>

Esta sección se utiliza para conectar un parámetro y hacer que funcione después de haberlo configurado. 

Después de crear un parámetro, puede crear consumidores de los parámetros. Los *consumidores de parámetros* son componentes que consumen el valor de un parámetro, tales como filtros, controles, campos calculados o acciones personalizadas. 

También puede desplazarse por estas opciones de la forma siguiente:
+ Para crear un filtro, selecciona el icono de **filtro** en la parte superior de la página. En resumen, debe crear un filtro con **Filtro personalizado** y habilitar **Utilizar parámetros**. La lista solo muestra los parámetros pertinentes.
+ Para añadir un control nuevo para el parámetro, seleccione el icono de **parámetros** situado en la parte superior de la página. En resumen, elija el parámetro y, a continuación, **Agregar control**. 
+ Para utilizar un parámetro en un campo calculado, edite un campo calculado existente o agregue uno nuevo eligiendo **Añadir** en la parte superior izquierda. La lista de parámetros aparece debajo de la lista de campos.
**nota**  
No es posible usar parámetros con varios valores para los campos calculados.
+ Para crear una acción de URL, elija el menú con forma de **v** en un elemento visual y, a continuación elija **Acciones de URL**.

Para obtener más información sobre cada uno de estos temas, consulte las secciones siguientes. 

**Topics**
+ [Uso de filtros con parámetros](parameters-filtering-by.md)
+ [Uso de campos calculados con parámetros](parameters-calculated-fields.md)
+ [Uso de acciones personalizadas con parámetros](parameters-custom-actions.md)
+ [Parámetros en URLs](parameters-in-a-url.md)
+ [Parámetros en títulos y descripciones](parameters-in-titles.md)

# Uso de filtros con parámetros en Amazon Quick
<a name="parameters-filtering-by"></a>

En esta sección se explica cómo filtrar los datos de un análisis o panel según el valor de un parámetro de valor único. Para utilizar un parámetro de varios valores (uno con un control desplegable multiselección), cree un filtro personalizado que sea igual (o no igual) a los valores. 

Antes de utilizar un filtro con un parámetro, debe conocer previamente cómo trabajar con filtros. 

1. Compruebe que ya se haya creado algún parámetro para el análisis. Elija **Editar** desde el parámetro o desde el menú del control para averiguar qué configuración está en uso.

1. Elija el panel **Filtro** a la izquierda de la pantalla. Si ya existe un filtro para el campo que desee utilizar, selecciónelo para abrir su configuración. De lo contrario, cree un filtro para el campo que desea filtrar según un parámetro.

1. Elija **Utilizar parámetros**.

1. Elija los parámetros en la lista o listas que aparecen debajo de **Usar parámetros**. Para los campos de texto (cadenas), elija en primer lugar **Filtro personalizado** y, a continuación, habilite **Usar parámetros**.

   Para los campos de fecha, elija los parámetros **Fecha de inicio** y **Fecha de finalización**, tal y como se muestra en la siguiente captura de pantalla. 

   Para los campos con otros tipos de datos, elija **Seleccionar un parámetro** y, a continuación, elija el parámetro en la lista. 
**nota**  
Los parámetros que pueden contener varios valores deben utilizar igual o distinto como tipo de comparación.

1. Elija **Aplicar** para guardar los cambios.

Pruebe el nuevo filtro eligiendo el control situado junto a la parte superior del análisis. En este ejemplo, utilizamos un parámetro básico que no tiene valores predeterminados y un control dinámico que está vinculado al campo **Región** del conjunto de datos de muestra denominado **Canalización de ventas**. El control consulta los datos y devuelve todos los valores. 

Si elimina o vuelve a crear un parámetro que está en uso en un filtro, puede actualizar el filtro con el nuevo parámetro. Para ello, abra el filtro, seleccione el nuevo parámetro que desea utilizar y, a continuación, elija **Aplicar**.

Si cambia el nombre de un parámetro, no es preciso actualizar el filtro ni ningún otro consumidor.

# Uso de campos calculados con parámetros en Amazon Quick
<a name="parameters-calculated-fields"></a>

Puede pasar el valor de un parámetro a un campo calculado de un análisis. Cuando crea un cálculo, puede elegir parámetros existentes de la lista de parámetros bajo **Lista de parámetros**. No puede crear un campo calculado que contenga un parámetro de varios valores, es decir, aquellos con un control desplegable multiselección.

Para la fórmula, puede utilizar cualquiera de las funciones disponibles. Puede pasar la selección del visor desde el control de parámetros, a la función `ifElse`. A cambio, obtiene una métrica. A continuación se muestra un ejemplo. 

```
ifelse(

${KPIMetric} = 'Sales',sum({Weighted Revenue}),

${KPIMetric} = 'Forecast',sum({Forecasted Monthly Revenue}),

${KPIMetric} = '# Active', distinct_count(ActiveItem),

NULL

)
```

El ejemplo anterior crea una métrica (un decimal) que se puede utilizar en un campo. Así, cuando un usuario elige un valor del control de parámetros, el elemento visual se actualiza para reflejar su selección.

# Uso de acciones personalizadas con parámetros en Amazon Quick
<a name="parameters-custom-actions"></a>

Una *acción personalizada* le permite lanzar URLs o filtrar imágenes seleccionando un punto de datos en una imagen o eligiendo el nombre de la acción en el menú contextual. Cuando utilice una acción de dirección URL con un parámetro, podrá pasar o enviar parámetros dinámicamente a la dirección URL. Para que eso funcione, configure un parámetro y, a continuación, úselo en la dirección URL cuando cree una acción personalizada con un tipo de **acción de dirección URL**. Los parámetros de los extremos emisor y receptor deben tener el mismo nombre y tipo de datos. Todos los parámetros son compatibles con acciones de dirección URL.

Para obtener información detallada acerca de la creación de una acción de dirección URL, consulte [Creación y edición de acciones personalizadas en Amazon Quick Sight](custom-actions.md). Si solo desea utilizar un parámetro en un enlace sin crear una acción de dirección URL, consulte [Uso de parámetros en una URL](parameters-in-a-url.md).

# Uso de parámetros en una URL
<a name="parameters-in-a-url"></a>

Puede usar el nombre y el valor de un parámetro en una URL de Amazon Quick para establecer un valor predeterminado para ese parámetro en un panel o análisis. 

En el siguiente ejemplo se muestra la dirección URL de un panel que establece un parámetro para otro panel.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.myParameter=12345
```

En el ejemplo anterior, la primera parte es el enlace del panel de destino: `https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234`. El símbolo de almohadilla (`#)` sigue a la primera parte para introducir los *fragmentos*, que contienen los valores que se desea establecer.

Los AWS servidores no reciben ni registran los valores de los fragmentos. Esta funcionalidad hace que los valores de datos estén más seguros.

El fragmento que sigue al símbolo `#` cumple las siguientes reglas: 
+ Los parámetros tienen el prefijo `p.`. Los nombres se refieren al parámetro, no al control. Puede ver el nombre del parámetro abriendo el análisis y eligiendo **Parámetro** en la barra lateral izquierda.
+ El valor se establece usando el signo igual (`=`). Se aplican las siguientes reglas:
  + Los valores literales no usan comillas. 
  + El navegador codifica automáticamente los espacios contenidos en los valores, por lo que no es necesario utilizar caracteres de escape al crear una URL manualmente. 
  + Para devolver todos los valores, establezca el parámetro igual a `"[ALL]"`.
  + Para asignar el valor del parámetro a `null`, configúrelo como igual a `%00`. Por ejemplo, `p.population=%00`.
  + En las acciones personalizadas, los nombres de los parámetros de destino comienzan por `$`. Por ejemplo: `<<$passThroughParameter>>`
  + En las acciones personalizadas, los valores de los parámetros se muestran con corchetes angulares `<< >>`, por ejemplo, `<<dashboardParameter1>>`). El usuario del panel ve el valor buscado, no la variable. 
+ Para una acción de URL personalizada, los parámetros con varios valores solo necesitan una instancia del mismo parámetro en el fragmento. Por ejemplo: `p.city=<<$city>>`
+ Para una URL directa, los distintos valores de un mismo parámetro tienen dos instancias del mismo parámetro en el fragmento. Más abajo se ofrece un ejemplo.
+ Los signos de Y comercial (`&`) separan los distintos parámetros. Más abajo se ofrece un ejemplo.

El servidor convierte la fecha a UTC y la envía al backend como una cadena sin zona horaria. Para utilizar fechas en horario universal coordinado (UTC), excluya la zona horaria. Los siguientes son algunos ejemplos de formatos de fecha que funcionan: 
+ `2017-05-29T00%3A00%3A00` 
+ `2018-04-04 14:51 -08:00`
+ `Wed Apr 04 2018 22:51 GMT+0000`

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30 08:01&p.city=New York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

En el navegador, este código se convierte en lo siguiente.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.shipdate=2018-09-30%2008:01&p.city=New%20York&p.city=Seattle&p.teamMember=12&p.percentageRank=2.3
```

El ejemplo anterior establece cuatro parámetros:
+ `shipDate` es un parámetro de fecha: `Sept 30, 2018`.
+ `city` es un parámetro de cadena con varios valores: `New York` y `Seattle`
+ `teamMember` es un parámetro de número entero: `12`.
+ `percentageRank` es un parámetro decimal: `2.3`.

En el siguiente ejemplo se muestra cómo establecer valores para un parámetro que acepta múltiples valores.

```
https://us-east-2.quicksight.aws.amazon.com/sn/dashboards/abc123-abc1-abc2-abc3-abcdefef1234#p.MultiParam=WA&p.MultiParam=OR&p.MultiParam=CA
```

Para transferir valores de un panel (o análisis) a otro en función de la selección del punto de datos del usuario, use acciones de direcciones URL personalizadas. Si lo desea, también puede generarlos URLs manualmente y usarlos para compartir una vista específica de los datos.

Para obtener más información sobre la creación de acciones personalizadas, consulte [Uso de acciones personalizadas para filtrar y navegar](quicksight-actions.md).

# Uso de parámetros en títulos y descripciones en Amazon Quick
<a name="parameters-in-titles"></a>

Al crear parámetros en Amazon Quick, puede utilizarlos en los títulos y descripciones de sus gráficos y análisis para mostrar de forma dinámica los valores de los parámetros. 

Puede utilizar parámetros en las siguientes áreas de su análisis:
+ Títulos y subtítulos de los gráficos
+ Títulos de ejes
+ Títulos de leyendas
+ Títulos de control de parámetros
+ Títulos y descripciones de hojas

En la imagen siguiente se muestra un título de gráfico que utiliza un parámetro.

![\[Imagen del panel Formato del elemento visual con un parámetro en el título del gráfico y un gráfico con el valor del parámetro en el título encerrado en un círculo rojo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/parameters-in-titles-labels2.png)


Utilice los siguientes procedimientos para obtener información sobre cómo agregar parámetros a áreas a lo largo de su análisis. Para obtener más información sobre parámetros y cómo crearlos, consulte [Parameters](parameters-in-quicksight.md).

## Adición de parámetros a títulos y subtítulos de gráficos
<a name="parameters-in-titles-chart-titles"></a>

Utilice el siguiente procedimiento para obtener información sobre cómo agregar parámetros a títulos y subtítulos de gráficos.

**Adición de un parámetro a un título o subtítulo de gráfico**

1. Abra el panel **Propiedades** para el elemento visual al que desea dar formato.

1. En el panel **Propiedades**, elija la pestaña **Título**.

1. Seleccione **Mostrar título** o **Mostrar subtítulo**. Es posible que estas opciones ya estén seleccionadas.

1. Seleccione los tres puntos a la derecha de **Editar título** o **Editar subtítulo** y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título en el panel **Propiedades**. En el gráfico, el valor del parámetro se muestra en el título.

   Para obtener más información sobre la edición de títulos y subtítulos en elementos visuales, consulte [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md).

## Adición de parámetros a los títulos de los ejes
<a name="parameters-in-titles-axis-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos de los ejes.

**Adición de un parámetro a un título de eje**

1. Abra el panel **Propiedades** para el elemento visual al que desea dar formato.

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Seleccione **Mostrar título**.

1. Seleccione los tres puntos a la derecha del título predeterminado del eje y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título del eje en el panel **Propiedades**. En el gráfico, el valor del parámetro se muestra en el título del eje.

   Para obtener más información sobre la edición de títulos de ejes, consulte [Ejes y líneas de cuadrícula](showing-hiding-axis-grid-tick.md).

## Adición de parámetros a los títulos de leyenda
<a name="parameters-in-titles-legend-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos de leyenda.

**Adición de un parámetro a un título de leyenda**

1. Abra el panel **Propiedades** para el elemento visual al que desea dar formato.

1. En el panel **Propiedades**, elija **Leyenda**.

1. Seleccione **Mostrar título de leyenda**.

1. Seleccione los tres puntos a la derecha de **Título de leyenda** y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título de leyenda en el panel **Propiedades**. En el gráfico, el valor del parámetro se muestra en el título de leyenda.

   Para obtener más información sobre cómo formatear leyendas, consulte [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md).

## Adición de parámetros a los títulos de control
<a name="parameters-in-titles-control-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos de control de parámetros.

**Adición de un parámetro a un título de control de parámetros**

1. Seleccione el control de parámetros que desea editar, elija los tres puntos a la derecha del título del control de parámetros y, a continuación, seleccione **Editar**.

1. En la página **Editar control** que se abre, seleccione **Mostrar título**.

1. Seleccione los tres puntos a la derecha de **Mostrar nombre** y, a continuación, seleccione un parámetro de la lista.

   El parámetro se agrega al título del control de parámetros.

   Para obtener más información sobre el uso de los controles de parámetros, consulte [Controles de parámetros](parameters-controls.md).

## Adición de parámetros a los títulos y descripciones de las hojas
<a name="parameters-in-titles-sheet-titles"></a>

Utilice el siguiente procedimiento para aprender a agregar parámetros a los títulos y descripciones de las hojas de su análisis.

**Adición de un parámetro a un título o descripción de hoja**

1. En la página de análisis, elija **Hojas** en la barra de aplicaciones y, a continuación, seleccione **Agregar título** o **Agregar descripción**.

   Aparecerá un título o descripción de hoja en la hoja.

1. En **Título de la hoja** o en **Descripción**, seleccione los tres puntos de la derecha y, a continuación, elija un parámetro de la lista.

   El parámetro se agregará al título o descripción de la hoja y el valor del parámetro aparecerá en el texto cuando cierre el cuadro de texto.

   Para obtener más información sobre cómo agregar títulos y descripciones de hoja, consulte [Adición de un título y una descripción a un análisis](adding-a-title-and-description.md).

# Uso de acciones personalizadas para filtrar y navegar
<a name="quicksight-actions"></a>

Para añadir opciones interactivas para los suscriptores del panel (lectores rápidos), debe crear acciones personalizadas en uno o más elementos visuales del análisis. Mejorar los paneles con acciones personalizadas ayuda a los usuarios a explorar los datos al agregar más contexto dentro del conjunto de datos. Puede facilitar la búsqueda de detalles y nuevas perspectivas en el mismo cuadro de mando, en otro distinto o en otra aplicación. Puede agregar hasta 10 acciones personalizadas a cada elemento visual de un panel.

Antes de empezar, es útil hacer una planificación. Por ejemplo, identifique los campos que son buenos candidatos para filtrar, para abrir una hoja diferente, para abrir una URL o para enviar un correo electrónico. Para cada hoja, identifique los widgets que muestran estos campos. A continuación, decida qué widgets van a contener acciones. También es una buena idea crear un esquema de nombres para que los nombres de las acciones sean coherentes en todo el análisis. Los nombres coherentes facilitan a la persona que utiliza el análisis la comprensión de lo que hará la acción, además de facilitarle el mantenimiento de las acciones que podría estar duplicando en todo el análisis. 

Las acciones solo existen en el widget del panel en el que se crean y funcionan en el contexto de la hoja principal de ese widget y de los campos secundarios que muestra. Solo se pueden crear acciones en determinados tipos de widgets: elementos visuales e información. No se pueden agregar a otros widgets, por ejemplo, controles de filtros o listas. Las acciones personalizadas solo se pueden activar desde el widget donde las crea.

Para activar una acción, la persona que utiliza el análisis puede hacer clic con el botón izquierdo (seleccionar) o con el botón derecho (utilizar el menú contextual) en un punto de datos. Un *punto de datos* es un elemento del conjunto de datos, por ejemplo, un punto en un gráfico de líneas, una celda en una tabla dinámica, un corte en un gráfico circular, etc. Si la persona hace clic en un elemento visual, se activa la acción de *selección*. Esta es la acción que actualmente pertenece a la categoría **En selección** de las **Acciones** de un análisis. Si, por el contrario, el usuario hace clic con el botón derecho del ratón en un elemento visual, puede elegir entre una lista de acciones de *menú*. Cualquier acción de la lista es actualmente miembro de la categoría **Opción de menú** de las **Acciones** de un análisis. La categoría **En selección** puede contener una y solo una acción miembro. 

De forma predeterminada, la primera acción que se crea se convierte en la acción de selección, la que se activa al hacer clic con el botón izquierdo. Para eliminar una acción de la categoría **En selección**, cambie la configuración de **Activación** de la acción a **Opción de menú**. Después de guardar el cambio, puede establecer la **Activación** de otra acción en **Seleccionar**. 

Al configurar una acción, puede elegir entre tres **tipos de acción**:
+ **Acción de filtrado**: filtra los datos incluidos en el elemento visual o en toda la hoja. De forma predeterminada, los filtros están disponibles para todos los campos del elemento visual principal. Los filtros en cascada están activados de forma predeterminada. Las acciones de filtrado funcionan en varios conjuntos de datos mediante mapeos de campos generadas automáticamente. 

  Si el análisis utiliza más de un conjunto de datos, puede ver los mapeos de campos generadas automáticamente para los campos que existen en varios conjuntos de datos. Para ello, seleccione ****Ver asignación de campos**** al final de la configuración de la acción, mientras edita una acción. Si visualiza una lista de acciones, seleccione ****Ver asignación de campos**** en el menú de cada acción. Los mapeos de campos aparecen en una nueva pantalla que muestra el mapeo entre el conjunto de datos inicial y todos los demás conjuntos de datos del elemento visual. Si no se mapea automáticamente ningún campo, aparecerá un mensaje con un enlace al [mapeo y unión de campos](mapping-and-joining-fields.md). 

  
+ **Acciones de navegación**: permiten navegar entre diferentes hojas de un mismo análisis. 
+ **Acciones de URL**: abren un enlace a otra página web. Si desea abrir un panel diferente, utilice una acción de URL. Puede utilizar una acción de URL para enviar puntos de datos y parámetros a otras URLs personas. Puede incluir cualquier campo o parámetro disponible. 

  Si la URL utiliza el esquema `mailto`, al ejecutar la acción se abre su editor de correo electrónico predeterminado. 

**Topics**
+ [Adición de filtros interactivos con un solo clic](quick-actions.md)
+ [Creación y edición de acciones personalizadas en Amazon Quick Sight](custom-actions.md)
+ [Reparación de acciones personalizadas](repairing-custom-actions.md)
+ [Descripción del mapeo de campos para acciones personalizadas en Amazon Quick Sight](quicksight-actions-field-mapping.md)

# Adición de filtros interactivos con un solo clic
<a name="quick-actions"></a>

El *filtrado interactivo con un solo clic proporciona un point-and-click filtrado* que va desde el elemento visual en el que se puede hacer clic hasta todos los demás elementos visuales e información de una hoja. Agréguelo a su análisis para comenzar con resúmenes y profundizar en las métricas, todo dentro de la misma hoja del panel. 

Una vez configurado, al hacer clic en un punto de datos (por ejemplo, un punto de un gráfico de líneas), se filtrará al instante con todos los campos asignados de todos los demás visuales de esa hoja. Si tiene varios conjuntos de datos, se deben mapear todos los campos de destino para que esto funcione. Además, solo puede tener una acción que funcione haciendo clic en un punto de datos; todas las demás acciones funcionan desde el menú contextual. 

Utilice el procedimiento siguiente para crear un filtro con un solo clic en un análisis.

**Creación de un filtro de un clic en un elemento visual o información**

1. En su análisis, elija un elemento visual o una información al que quiera agregar un filtro interactivo. 

1. Elija **Acciones** en el menú desplegable Opciones de menú ubicado en la esquina superior derecha.

1. Seleccione **Filtrar elementos visuales de la misma hoja.** Al hacer esto se agrega inmediatamente el filtrado con un solo clic. 

1. Repita este proceso para cada elemento visual que desee hacer interactivo.

# Creación y edición de acciones personalizadas en Amazon Quick Sight
<a name="custom-actions"></a>

Puede crear una acción para cada tarea que quiera agregar a un elemento visual. Las acciones que cree pasarán a formar parte de la funcionalidad de cada elemento visual o información.

La siguiente tabla define cuándo utilizar cada tipo de acción.


|  Acción a realizar  |  Tipo de acción  | 
| --- | --- | 
|  Adición o personalización de una acción de filtrado interactiva, incluidos los filtros de un solo clic  |  Acción de filtrado  | 
|  Apertura de otra hoja en el mismo panel  |  Acción de navegación  | 
|  Apertura de una hoja en un panel diferente en la misma Cuenta de AWS  |  Acciones de URL  | 
|  Apertura de una URL (`https`, `http`)  |  Acciones de URL  | 
|  Envío de un correo electrónico (`mailto`)  |  Acciones de URL  | 

Puede establecer los siguientes atributos y opciones para una acción personalizada:
+ ****Nombre de la acción****: se trata de un nombre descriptivo que se elige para la acción. De forma predeterminada, las acciones se denominan **Action 1**, **Action 2**, y así sucesivamente. Si la acción personalizada está activada desde un menú contextual, este nombre aparece en el menú al hacer clic con el botón derecho en un punto de datos.

  Para que el nombre de la acción sea dinámico, puede parametrizarlo. Usa el icono con el signo más situado junto al encabezado del nombre de la acción para mostrar una lista de las variables disponibles. Las variables aparecen entre corchetes `<< >>`. Los parámetros llevan el prefijo `$` , por ejemplo, `<<$parameterName>>`. Los nombres de campo no tienen prefijo, por ejemplo, `<<fieldName>>`.
+ ****Activación****: las opciones disponibles son **Seleccionar** u **Opción de menú**. Para utilizar una acción, puede *seleccionar* el punto de datos (clic con el botón izquierdo) o navegar hasta la *opción de menú* en el menú contextual (clic con el botón derecho). Las acciones de navegación y las acciones de URL aparecen en el centro del menú contextual, justo encima de las opciones de **Color**. Las acciones que se activan por menú también están disponibles en la leyenda en un elemento visual.
+ ****Tipo de acción****: el tipo de acción que desea. Los ajustes específicos de un tipo de acción solo se muestran después de elegir el tipo de acción. 
  + Las opciones de configuración de la **acción de filtrado** son las siguientes: 
    + ****Alcance de filtro****: los campos que se filtrarán. Para filtrar todos los campos, elija **Todos los campos**. De lo contrario, elija **Seleccionar campos** y, a continuación, desactive los elementos que no desee filtrar. 

      El valor predeterminado es **Todos los campos**.
    + ****Elementos visuales de destino****: los widgets del panel de destino. Para aplicar el filtro a todos ellos, elija **Todos los elementos visuales**. De lo contrario, elija **Seleccionar elementos visuales** y, a continuación, desactive los elementos que no desee filtrar. Cuando una acción de filtro se aplica a otros elementos visuales, el efecto se denomina *filtros en cascada*. 

      El valor predeterminado es **Todos los elementos visuales**.

      Un filtro en cascada aplica todos los elementos visuales configurados en la sección **Elementos visuales de destino** de una acción de filtro específica. Amazon Quick Sight evalúa inicialmente sus imágenes y preconfigura los ajustes por usted. Pero puede cambiar los valores predeterminados si lo desea. Puede configurar varios filtros en cascada en varios elementos visuales de la misma hoja o análisis. Cuando utilice el análisis o el panel, puede utilizar varios filtros en cascada al mismo tiempo, aunque los active de uno en uno. 

      Una acción de filtrado requiere al menos un elemento visual de destino, porque una acción de filtro requiere un origen y un destino. Para filtrar únicamente el elemento visual actual, cree un filtro normal eligiendo **Filtro** a la izquierda.
  + Las opciones de configuración de la **acción de navegación** son las siguientes: 
    + ****Hoja de destino****: la hoja de destino. 
    + ****Parámetros****: los parámetros que se enviarán a la hoja de destino. Elija el icono con el signo más para añadir un parámetro existente. 
  + Las opciones de configuración de la **acción de URL** son las siguientes: 
    + ****URL****: la URL que se abrirá. Las acciones de URL pueden ser enlaces directos a otra aplicación. Los esquemas de URL válidos incluyen `https`, `http` y `mailto`. 
    + ****\$1** (Valores)**: (opcional) Los parámetros que se van a enviar a la URL de destino. Los nombres de los parámetros empiezan por `$`. Los parámetros de los extremos emisor y receptor deben tener el mismo nombre y tipo de datos. 
    + ****Abrir en****: dónde abrir la URL. Puede elegir **Nueva pestaña del navegador**, **Misma pestaña del navegador** o **Nueva ventana del navegador**.

Algunos tipos de acciones permiten incluir valores de parámetros o campos disponibles en el elemento visual o la información. Puede escribirlos manualmente o elegir **\$1** para seleccionarlos de una lista. Para que la acción personalizada funcione, todos los campos y parámetros a los que hace referencia deben estar en uso en el widget principal.

Utilice el procedimiento siguiente para crear, ver o editar una acción personalizada en un análisis.

**Creación, visualización o edición de una acción personalizada**

1. Con el análisis abierto, elija **Acciones** en el menú desplegable **Opciones de menú** ubicado en la esquina superior derecha. 

   Las acciones existentes, si las hay, se muestran por tipo de activación. Para activar o desactivar una acción existente, utilice la casilla situada a la derecha del nombre de la acción.

1. (Opcional) Para editar o ver una acción existente, selecciona el icono de menú situado junto al nombre de la acción. 

   Para editar la acción, elija **Editar**. 

   Para eliminarlo, elija **Eliminar**.

1. Para crear una nueva acción, seleccione una de las siguientes opciones:
   + El icono de añadir situado junto al encabezado **Acciones**
   + El botón **Definir una acción personalizada**

1. En **Nombre de la acción**, defina un nombre para la acción. Para hacer que el nombre de la acción sea dinámico, utilice el icono del signo más para añadir valores de parámetros o campos. 

1. En **Activación**, elija cómo se ejecuta la acción.

1. En **Tipo de acción**, elija el tipo de acción que desea utilizar. 

1. En una **Acción de filtrado**, haga lo siguiente: 

   1. En **Alcance de filtro**, seleccione el alcance del filtro.

   1. En **Elementos visuales de destino**, elija el alcance del filtro en cascada.

1. En una **Acción de navegación**, haga lo siguiente: 

   1. En **Hoja de destino**, elija la hoja de destino.

   1. En **Parámetros**, seleccione el icono más situado junto al encabezado **Parámetros**, seleccione un parámetro y, a continuación, elija un valor de parámetro. Puede elegir todos los valores, ingresar valores personalizados o seleccionar campos específicos.

1. En una **Acción de URL**, haga lo siguiente: 

   1. En **URL**, ingrese el hipervínculo.

   1. Seleccione el icono con el signo más situado junto al encabezado de la **URL**. A continuación, agregue variables de la lista.

   1. En **Abrir en**, elija cómo abrir la URL.

1. Cuando haya terminado con la acción, elija una de las siguientes opciones en la parte inferior del panel **Acciones** (es posible que tenga que desplazarse hacia abajo):
   + **Guardar**: permite guardar las selecciones y crear la acción personalizada.
   + **Cerrar**: cierra esta acción personalizada y descarta los cambios.
   + **Eliminar**: elimina esta acción.

# Reparación de acciones personalizadas
<a name="repairing-custom-actions"></a>

Para que una acción personalizada funcione, todos los campos y parámetros a los que hace referencia deben estar activos en el widget principal. Si falta un campo en el widget de origen, o si falta un parámetro en el análisis, la acción para ese campo o parámetro deja de estar disponible. Las acciones de menú ya no se incluyen en el menú contextual. Las acciones de selección ya no responden a los intentos de interacción. Sin embargo, en todos los demás aspectos, el widget sigue funcionando. No se muestra ningún error a los usuarios. Puede corregir las acciones de filtrado y las acciones de URL dañadas si incluye de nuevo los campos que faltan en el visual o la información dañada.

El siguiente procedimiento explica cómo arreglar una acción que se interrumpió porque alguien eliminó un campo o parámetro sin actualizar la acción. Estos pasos proporcionan una guía básica para solucionar este problema. Sin embargo, utilice su propio criterio para decidir si debe realizar cambios en el análisis. Si no estás seguro, es mejor que pidas ayuda a un administrador de Amazon Quick antes de cambiar algo. Por ejemplo, podría haber una manera de restaurar una versión anterior del análisis, lo que podría ser más seguro si no está seguro de lo que le pasó.

**Eliminación de un campo de una acción interrumpida**

1. En la página de inicio, seleccione **Análisis**. A continuación, elija el análisis a arreglar.

1. Elija el elemento visual o la información en el que la acción ya no funciona. Asegúrese de que está resaltado en la hoja.

1. Elija **Acciones** en el menú desplegable Opciones de menú ubicado en la esquina superior derecha.

1. Busca la acción que deseas corregir y selecciona **Editar**.

1. Si el tipo de acción es **Acción de filtrado** y aparece un error que indica que *se eliminó el campo utilizado por esta acción*, compruebe la configuración de **Ámbito de filtro**. Los **campos seleccionados** solo pueden mostrar campos que estén en el elemento visual. Para desactivar los campos seleccionados que se eliminan, elija una de las siguientes opciones:
   + Cambie la configuración de **Alcance del filtro** a **Todos los campos**. De este modo, el widget podrá filtrar todos los campos. 
   + Si desea utilizar una lista de **Campos seleccionados**, verifique la lista de campos. Si necesita incluir otro campo, deberá agregarlo primero al elemento visual.

1. Si el tipo de acción es **Acción de navegación**, siga las indicaciones del mensaje de error, que refleja el tipo de cambio que causó el error.

1. Si el tipo de **acción es URL**, compruebe la configuración de **URL** para las variables marcadas con corchetes angulares dobles (`<<FIELD-OR-$PARAMETER>`). Abre la lista de variables disponibles seleccionando el icono con el signo más. Elimine los campos o parámetros que no estén en la lista. Asegúrese de eliminar también el *parámetro URL* correspondiente y su espaciador (`?` para el primer parámetro URL, o `&` para los siguientes). Los siguientes ejemplos muestran (en **negrita**) qué parte se elimina si estuviera eliminando el campo llamado `Product` del elemento visual.

   ```
   https://www.example.com/examplefunction?q=<<Product>
   ```

   ```
   https://www.example.com/examplefunction?q=<<Product>&uact=<<$CSN>
   ```

   ```
   https://www.example.com/examplefunction?pass=yes&q=<<Product>+<<City>&oq=<<Product>+<<City>&uact=<<$CSN>
   ```

   Asegúrese de probar la nueva URL. 

1. (Opcional) Para eliminar la acción, desplácese hasta el final y seleccione **Eliminar**.

1. Cuando haya terminado, confirme los cambios realizados en la acción. Desplácese hasta el final del panel **Acción** y seleccione **Guardar**. 

   Si el error también existe en un panel asociado, comparta y publique de nuevo el panel para propagar la corrección.

# Descripción del mapeo de campos para acciones personalizadas en Amazon Quick Sight
<a name="quicksight-actions-field-mapping"></a>

La asignación automatizada de campos se basa en campos idénticos. Los campos con el mismo nombre y tipo de datos se mapean automáticamente a través de conjuntos de datos. Sus nombres de campo y tipos de datos deben coincidir exactamente. Esto funciona de forma similar a una unión, excepto en que se genera automáticamente en función de los nombres y tipos de datos para cada campo coincidente. Si faltan campos, puede crearlos mediante campos calculados en el conjunto de datos al que le falta un campo. Si no desea que algunos de los campos se mapeen entre sí, puede cambiarlos o eliminarlos del conjunto de datos. 

Es importante asegurarse de que todos los campos de destino estén asignados si están habilitados para su uso con una acción de filtro (en el **ámbito de filtro**). Esto permite que el filtrado se aplique automáticamente. Si no se asignan algunos campos de destino, el filtrado automático no funciona.

La asignación solo se genera cuando se crea o se guarda una acción personalizada. Así que después de cada cambio que afecte a la asignación, asegúrese de volver a ella y guardarla de nuevo. Cuando se crea una acción, la asignación se basa en los campos tal y como existen en ese punto. Al guardar una acción, permanecerán asignados todos los campos asignados cuyo nombre haya cambiado desde que creó la acción personalizada. Sin embargo, si modifica el tipo de datos de un campo asignado, la asignación se eliminará.

Si a la asignación le faltan algunos campos, puede realizar una de las siguientes acciones para solucionarla:
+ Diríjase solo a los campos asignados. Para ello, quite los campos no asignados del **ámbito de filtro**.
+ Elimine el objeto visual en cuestión de los objetos visuales de destino.
+ Cree campos calculados para proporcionar los campos que faltan para la asignación y, a continuación, guarde la acción personalizada.
+ Edite el conjunto de datos y cambie el nombre de los campos o modifique sus tipos de datos y guarde la acción personalizada.
+ Edite el conjunto de datos y cambie el nombre de los campos o modifique sus tipos de datos y vuelva a guardar la acción personalizada.

**nota**  
La información que aparece en la pantalla de asignación muestra la configuración de la última vez que la guardó. Para actualizar o actualizar la vista, vuelva a guardar la acción.

Si agrega o edita conjuntos de datos, no se mapearán ni remapearán automáticamente. Esto hará que el filtrado funcione incorrectamente. Por ejemplo, supongamos que agrega un nuevo conjunto de datos y, a continuación, crea elementos visuales para él. Los nuevos objetos visuales no responderán a las acciones de filtrado, ya que no hay ninguna asignación de campos para conectarlos. Cuando realice cambios, recuerde guardar las acciones personalizadas de nuevo para rehacer las asignaciones de campos.

Si quita un campo parametrizado o cualquier otro campo de destino del objeto visual de origen, se interrumpirá la acción que lo utilice. La acción del campo que falta no funcionará cuando seleccione un punto de datos o si está oculta en el menú contextual. 

Para obtener información sobre cómo preparar el conjunto de datos para el mapeo automático de campos, consulte [Asignación de campos](mapping-and-joining-fields.md#mapping-and-joining-fields-automatic).

# Cómo trabajar con informes de píxeles perfectos en Amazon Quick Sight
<a name="working-with-reports"></a>

Con Amazon Quick Sight Pixel Perfect Reports, puede crear, programar y compartir informes en PDF de varias páginas con un gran formato. También puede programar la exportación de datos como archivos CSV mediante la interfaz web existente de Quick Sight. Esto unifica sistemas históricamente separados para paneles e informes. 

Los creadores de informes pueden utilizar la experiencia de creación basada en el navegador de Quick Sight para conectarse a una amplia gama de fuentes de datos compatibles y crear informes con un gran formato. De este modo, podrán especificar el tamaño exacto de la página, la longitud y la disposición de las imágenes, los gráficos y las tablas con una precisión a nivel de píxel. Luego, los autores pueden usar los mecanismos de programación de Quick Sight para configurar y programar la entrega de informes altamente personalizados a los usuarios finales, o archivar los informes para usarlos en el futuro.

Los informes Pixel Perfect están diseñados para imprimirse o distribuirse. El contenido del informe en píxeles perfectos está formateado para adaptarse a los tamaños de papel y muestra todos los datos de una tabla y una tabla dinámica, incluso si los datos ocupan varias páginas. Están formateados para tamaños de papel exactos y puedes controlar el diseño de la página con precisión. Cada informe con píxeles perfectos puede generar un PDF de hasta 1000 páginas.

Los informes Pixel Perfect proporcionan todos los datos disponibles que están presentes cuando el informe se publica en PDF o CSV. Por ejemplo, supongamos que tiene una tabla con 10 000 filas. Un informe con píxeles perfectos presenta el informe completo en varias páginas para que los lectores lo vean en su totalidad. Si incluye esta misma tabla en un informe de panel interactivo, el PDF generado incluirá una instantánea de la tabla que se rellena en una sola página por la que se podrá desplazar. Estos informes personalizados se pueden enviar a usuarios individuales y grupos mediante ráfagas de correo electrónico que generan hasta miles de informes personalizados en PDF o CSV.

**nota**  
Los informes con un nivel de píxeles perfectos no están disponibles en la región de `eu-central-2` Europa (Zúrich).

**Topics**
+ [Introducción](qs-reports-getting-started.md)
+ [Creación de informes a partir de un análisis en Amazon Quick Sight](qs-reports-create-reports.md)
+ [Formatear informes en Amazon Quick Sight](qs-reports-format-reports.md)
+ [Consumir informes con píxeles perfectos en Amazon Quick Sight](qs-reports-consume-reports.md)
+ [Cancelar la suscripción a los informes paginados en Quick Sight](qs-reports-getting-started-unsubscribe.md)

# Introducción
<a name="qs-reports-getting-started"></a>

Para empezar a trabajar con los informes de píxeles perfectos de Amazon Quick Sight, primero obtén el complemento de informes de píxeles perfectos para tu cuenta de Amazon Quick. El precio del complemento se aplica a toda tu cuenta de Quick y no es específico de una región. Tras suscribirse a Quick Reporting, los autores pueden empezar a crear, programar y enviar informes perfectos.

## Obtén el complemento Quick Pixel Perfect Reports
<a name="qs-reports-getting-started-subscribe"></a>

Para poder trabajar con informes de píxeles perfectos en Amazon Quick Sight, debe añadir el **complemento Pixel-Perfect Reports a su suscripción** a Quick.

**Para obtener el complemento de informes perfecto en Amazon Quick Sight**

1. En la página de inicio rápido, elige tu nombre de usuario en la esquina superior derecha y, a continuación, selecciona **Administrar rápido**.

1. Selecciona **Administrar suscripciones** y, a continuación, selecciona **Pixel-Perfect Reports**.

1. Elija el plan de suscripción que desee. Puede elegir entre un plan mensual y un plan anual.

1. **Revisa la información de precios del complemento Pixel-Perfect Reports y, a continuación, selecciona Confirmar suscripción.**

Una vez que obtengas el complemento Pixel Perfect Reports, la suscripción puede tardar varios minutos en surtir efecto. Cuando tu suscripción entre en vigor, podrás empezar a crear informes con píxeles perfectos en Amazon Quick Sight.

# Creación de informes a partir de un análisis en Amazon Quick Sight
<a name="qs-reports-create-reports"></a>

Los informes con píxeles perfectos se crean a nivel de hoja de un análisis en Amazon Quick Sight. Al crear un análisis nuevo o una hoja nueva en un análisis existente, puede elegir si desea convertir la nueva hoja en un **panel interactivo** o en un **informe perfecto en píxeles**. De esta forma, puede tener análisis solo para paneles interactivos, análisis solo para informes con píxeles perfectos o puede tener un análisis que incluya tanto paneles interactivos como informes con píxeles perfectos.

Hay tres formas de crear un informe con píxeles perfectos. Puede crear un nuevo informe a partir de una nueva hoja de un análisis, puede duplicar una hoja interactiva en un panel de control o puede duplicar un informe con píxeles perfectos que ya existe. Utilice los siguientes procedimientos para crear un informe con píxeles perfectos.

## Creación de informes a partir de un análisis en Amazon Quick Sight
<a name="qs-reports-create-reports-from-analysis"></a>

**Para crear un informe con píxeles perfectos a partir de un nuevo análisis**

1. En la página de inicio de Quick, selecciona **Análisis** y, a continuación, selecciona **Nuevo análisis**.

1. Elija el conjunto de datos que desee incluir en su nuevo análisis y, a continuación, seleccione **USAR EN ANÁLISIS** en la parte superior derecha.

1. En la ventana emergente **Nueva hoja** que aparece, selecciona **Pixel perfect report**.

1. (Opcional) Elija el tamaño de papel que desee para su informe con píxeles perfectos. Puede elegir entre las siguientes opciones:
   + Carta EE. UU. (8,5 x 11 pulgadas)
   + Legal EE. UU. (8,5 x 14 pulgadas)
   + A0 (841 x 1189 mm)
   + A1 (594 x 841 mm)
   + A2 (420 x 594 mm)
   + A3 (297 x 420 mm)
   + A4 (210 x 297 mm)
   + A5 (148 x 210 mm)
   + Japón B4 (257 x 364 mm)
   + Japón B5 (182 x 257 mm)

   El tamaño de papel predeterminado es Carta EE. UU. (8,5 x 11 pulgadas)

1. (Opcional) Elija entre una disposición vertical y horizontal para la hoja. La opción predeterminada es vertical.

1. Selecciona **AÑADIR**.

Si desea crear un nuevo informe con píxeles perfectos en un análisis existente, elija el icono del signo más (\$1) situado a la derecha de las pestañas de la hoja del análisis y siga los pasos 3 a 6 del procedimiento anterior.

## Crear informes desde un panel de control existente en Amazon Quick Sight
<a name="qs-reports-create-report-from-dashboard"></a>

También puede crear un informe con píxeles perfectos duplicando una hoja interactiva y convirtiendo la hoja duplicada en un informe con píxeles perfectos.

**Para crear un informe con píxeles perfectos a partir de una hoja interactiva**

1. En la hoja que desee duplicar de un análisis, elija el menú desplegable que se encuentra junto al nombre de la hoja que desee convertir.

1. Elija **Duplicar para informar**.

Puede convertir una hoja interactiva en un informe con píxeles perfectos, pero no puede convertir un informe con píxeles perfectos en una hoja interactiva.

## Duplicar un informe existente en Amazon Quick Sight
<a name="qs-reports-create-report-from-report"></a>

En esta sección se explicará cómo copiar un informe.

**Para copiar un informe a la perfección**

1. En la hoja que desee duplicar de un análisis, elija el menú desplegable que se encuentra junto al nombre de la hoja que desee convertir.

1. Elige **Duplicar**.

# Formatear informes en Amazon Quick Sight
<a name="qs-reports-format-reports"></a>

Utilice esta sección para obtener información sobre cómo dar formato a un informe con píxeles perfectos en Amazon Quick Sight.

**Topics**
+ [Trabajo con secciones](qs-reports-working-with-sections.md)
+ [Cambio de tamaño, márgenes y orientación del papel](qs-reports-paper-size.md)
+ [Incorporación y eliminación de saltos de página en un informe](qs-reports-page-breaks.md)
+ [Incorporación y eliminación de elementos visuales de un informe](qs-reports-add-visuals.md)
+ [Incorporación de un cuadro de texto a un informe](qs-reports-add-text-box.md)
+ [Configuración de peticiones para informes paginados](paginated-reports-prompts.md)

# Trabajo con secciones
<a name="qs-reports-working-with-sections"></a>

Una *sección* es un contenedor para distintos elementos visuales que crecen verticalmente para albergar el contenido. Cada sección se representa hasta su finalización, una tras otra, teniendo en cuenta los saltos de página y los ajustes de sección configurados. Los encabezados y pies de página son tipos especiales de sección que tienen un tamaño, una ubicación y una repetición predefinidos en cada página del informe.

Cada sección de un informe con píxeles perfectos se puede formatear de forma independiente del resto de secciones del informe. Los elementos visuales se pueden arrastrar y soltar en cualquier lugar que desee, de forma similar a un diseño de formato libre en una hoja interactiva. Los elementos visuales también se pueden superponer, cambiar de tamaño o llevar al frente o al fondo de la sección. Además, puede cambiar los márgenes de una sección para que la agrupación de elementos visuales destaque del resto del informe.

Cada informe de Quick Sight necesita al menos una sección. Puede añadir varias secciones para agrupar diferentes conjuntos de elementos visuales, o bien para controlar el orden de representación de las diferentes agrupaciones de elementos visuales.

Cada hoja de informe con píxeles perfectos admite hasta 30 secciones, incluidos encabezados y pies de página.

Utilice los temas que aparecen a continuación para obtener más información sobre las secciones.

**Topics**
+ [Incorporación, movimiento y eliminación de secciones](qs-reports-add-delete-section.md)
+ [Encabezados y pies de página](qs-reports-add-delete-headers-footers.md)
+ [Relleno de sección](qs-reports-section-padding.md)
+ [Creación de secciones repetidas](qs-reports-repeat-sections.md)

# Incorporación, movimiento y eliminación de secciones
<a name="qs-reports-add-delete-section"></a>

## Adición de una nueva sección
<a name="paginated-reports-add-section"></a>

Para añadir una nueva sección a un informe con píxeles perfectos, utilice el siguiente procedimiento.

**Para añadir una nueva sección a un informe con píxeles perfectos**

1. En la página de inicio de Quick, selecciona **Análisis** y, a continuación, elige el análisis que contiene el informe al que quieres añadir una sección.

1. Elija la hoja que contiene el informe con píxeles perfectos al que desee añadir una sección.

1. Elija el icono **AGREGAR** (\$1) en la esquina superior izquierda y elija **Agregar sección**.

También puede añadir una sección al seleccionar el icono con el signo más (\$1) de la parte inferior de una sección existente y elegir **Agregar sección**.

Cuando elige **Agregar sección**, se añade una nueva sección al final del informe.

No puede crear una sección dentro de otra sección. Si selecciona una sección existente y, a continuación, elige **Agregar sección**, aparecerá una nueva sección en la parte inferior del informe.

Si tienes varias secciones en un informe con píxeles perfectos, puedes organizarlas en el orden que desees.

## Desplazamiento de una sección
<a name="paginated-reports-move-section"></a>

**Desplazamiento de una sección de un informe**

1. Elija la sección que desee mover y, a continuación, elija el icono de tres puntos situado en la esquina derecha para abrir el menú de la sección.

1. Elija dónde desea mover la sección. Puede elegir entre las siguientes opciones:
   + **Mover la sección al inicio**
   + **Mover la sección hacia arriba**
   + **Mover la sección hacia abajo**
   + **Mover la sección al final**

En algunos casos, no podrá seleccionar algunas de las opciones anteriores. Por ejemplo, si la sección ya se encuentra en la parte inferior del informe, no podrá seleccionar **Mover hacia abajo** ni **Mover la sección al final**.

El nombre de las secciones se asigna según su orden ascendente en el informe. Al subir o bajar una sección en un informe, se cambia el nombre de todas las secciones afectadas por el movimiento según el nuevo orden ascendente.

Al eliminar una sección de un informe con píxeles perfectos, los nombres de las secciones restantes pueden cambiar en función de la ubicación de la sección eliminada. Por ejemplo, supongamos que decide eliminar `Section 1`. Al eliminar la sección, la `Section 2` anterior se subirá en el informe y pasará a ser la nueva `Section 1`.

## Eliminación de una sección
<a name="paginated-reports-delete-section"></a>

**Eliminación de una sección de un informe**

1. Navegue hasta la sección que desee eliminar y elija el icono de tres puntos situado en la esquina superior derecha para abrir el menú de la sección.

1. Elija **Eliminar**.

# Encabezados y pies de página
<a name="qs-reports-add-delete-headers-footers"></a>

*Los encabezados* y *pies* de página son secciones especiales opcionales que se encuentran en la parte superior e inferior de un informe con píxeles perfectos. Los encabezados y pies de página se suelen utilizar para mostrar información básica, como, por ejemplo, la fecha en que se creó el informe o el número de página. Puede interactuar con los encabezados y pies de página del mismo modo que interactúa con una sección normal de un informe.

De forma predeterminada, todos los informes de Amazon Quick Sight tienen un encabezado y un pie de página. Para quitar el encabezado o el pie de página del informe, utilice el procedimiento siguiente.

**Para eliminar un encabezado o un pie de página de un informe en píxeles, es perfecto**

1. **En tu informe con píxeles perfectos, navega hasta el encabezado o pie de página que deseas eliminar y abre la sección ON.**

1. Elija **Eliminar**.

Cuando se elimina un encabezado o un pie de página de un informe, se elimina de todas las páginas del informe. No se puede tener un encabezado o pie de página en algunas páginas, pero no en otras.

Si ha eliminado el encabezado o el pie de página del informe, pero desea que vuelvan a estar visibles, siga el procedimiento siguiente.

**Para añadir un encabezado o un pie de página a un informe con píxeles perfectos**

1. Navega hasta el informe perfecto en píxeles al que quieras añadir un encabezado o pie de página y selecciona **Insertar** en el menú superior.

1. Elija **Agregar encabezado** o **Agregar pie de página**.

# Relleno de sección
<a name="qs-reports-section-padding"></a>

Puedes usar el relleno de secciones para cambiar los márgenes de una sección individual en un informe con píxeles perfectos. De forma predeterminada, todas las secciones de un informe utilizan los márgenes de página configurados y aplicados a todo el informe. También puede añadir un relleno de sección a un encabezado o pie de página. Con el relleno de secciones, puede hacer que una sección destaque sobre otras secciones al crear otro conjunto de márgenes. Aplique el nuevo conjunto de márgenes a la sección por encima de los márgenes de página que utiliza el resto del informe.

**Cambio del relleno de una sección**

1. Navegue hasta la sección a la que desea añadir el relleno de sección y abra **Editar sección**.

1. En la sección **Relleno** de **Editar sección**, introduzca la cantidad de relleno que desea en pulgadas. Puede personalizar el relleno de cada lado de la sección (superior, inferior, izquierdo y derecho).

No puede usar el relleno de sección para reducir los márgenes de la sección. Por ejemplo, si los márgenes de todo el informe en píxeles perfectos son de 1 pulgada, solo puede añadir ese valor con el relleno de sección.

# Creación de secciones repetidas
<a name="qs-reports-repeat-sections"></a>

Utilice las secciones repetidas para crear duplicados de secciones específicas de un informe con el fin de mostrar los valores de una o varias dimensiones. Los datos de la sección repetida se dividen para que coincidan con las dimensiones de la sección. Las secciones repetidas se pueden replicar a escala para reducir la cantidad de tiempo que tarda la creación de los informes.

Utilice los siguientes procedimientos para crear y configurar una sección repetida en un informe.

**Definición de una sección repetida**

1. Navegue hasta la sección a la que desea agregar un comportamiento repetitivo y elija **Editar sección repetida** (panel triple).

1. En el panel **Editar sección** que se abrirá, elija **AGREGAR DIMENSIÓN** y, a continuación, elija la dimensión que desee agregar.

1. Para agregar dimensiones adicionales, repita el paso 2. Puede añadir hasta 3 dimensiones en cada configuración de sección de repetición.

**Consideraciones sobre las secciones repetidas**

A continuación se detallan las limitaciones que se aplican a las secciones repetidas.
+ Los elementos visuales de información no son compatibles con las secciones repetidas.
+ Las dimensiones de las secciones repetidas solo pertenecen al último conjunto de datos que se seleccionó para el uso en el análisis.

Tras crear una sección repetida, podrá definir la ordenación y los límites de la configuración de la sección repetida. También puede usar cuadros de texto para agregar parámetros del sistema a las secciones repetidas. 

# Definición de la ordenación de una sección repetida
<a name="qs-reports-repeat-sections-sort"></a>

**Definición de la ordenación de una sección repetida**

1. Navegue hasta la sección a la que desea agregar un comportamiento repetitivo y elija **Editar sección repetida** (panel triple).

1. En **Editar sección**, elija los puntos suspensivos (tres puntos) situados junto a la dimensión que desee cambiar.

1. Navegue hasta la pestaña **Repetición**, elija los puntos suspensivos (tres puntos) situados junto a la dimensión que desee ordenar y, a continuación, elija **Editar**.

1. En **Ordenar por**, use el menú desplegable para elegir la dimensión por la que desee ordenar.

1. En el menú desplegable **Agregación**, elija la agregación que desee especificar.

1. En **Orden de clasificación**, seleccione **Ascendente** o **Descendente**.

# Definición de los límites en una sección repetida
<a name="qs-reports-repeat-sections-limits"></a>

Puede establecer límites para mostrar solo un número determinado de valores de dimensión distintos para cada dimensión de una sección repetida. Puede optar por mostrar entre 1 y 1000 valores distintos. El límite predeterminado es 50.

**Definición de los límites en una sección repetida**

1. Navegue hasta la sección a la que desea agregar un comportamiento repetitivo y elija **Editar sección repetida** (panel triple).

1. En **Editar sección**, elija los puntos suspensivos (tres puntos) situados junto a la dimensión que desee cambiar.

1. En **Limitar a**, introduzca el número de valores a los que desee limitar la ordenación. Puede especificar un número comprendido entre 1 y 1000.

**Consideraciones acerca de los límites**

A continuación se detallan las limitaciones que se aplican a los límites en las secciones repetidas.
+ Una *instancia* se define como un valor distinto de una dimensión o una combinación única de valores de varias dimensiones.
+ Si el número de instancias únicas de una dimensión en una sección repetida supera las 1000, el informe en PDF NO se generará. Si esto ocurre, pruebe una de las siguientes opciones.
  + Defina un límite para su dimensión.
  + Cree un filtro de nivel de hoja para restringir los valores de la dimensión.
  + Utilice la seguridad a nivel de fila (RLS) para restringir los valores de la dimensión.
  + Aplique filtros de conjuntos de datos.

# Adición de parámetros del sistema a las secciones repetidas
<a name="qs-reports-repeat-sections-text-box"></a>

Puede usar cuadros de texto para agregar parámetros del sistema a la sección repetida del informe paginado. Esto permite acceder a las dimensiones que se han utilizado para configurar las secciones repetidas. Las secciones y dimensiones que se repiten deben configurarse antes de poder acceder a las dimensiones de un cuadro de texto. Los parámetros del sistema solo se pueden usar en una sección repetida.

**Adición de parámetros del sistema a una sección repetida desde un cuadro de texto**

1. Elija el elemento visual del cuadro de texto que desee y, a continuación, elija el icono **Parámetros del sistema** situado en el extremo derecho de la barra de herramientas del cuadro de texto.

1. En el menú desplegable que aparecerá, elija el parámetro que desee.

# Adición de saltos de página a las secciones repetidas
<a name="qs-reports-repeat-sections-page-break"></a>

Al igual que puede agregar saltos de página a las secciones, puede agregar saltos de página a las secciones repetidas.

**Adición de un salto de página a una sección repetida**

1. Navegue hasta la sección que contiene el comportamiento de repetición que desee cambiar y elija el icono **Editar sección repetida** (panel triple).

1. En la pestaña **Repetición** del panel de **Editar sección** que aparecerá, active la casilla **Salto de página después de cada instancia**.

Una instancia se define como un valor distinto de una dimensión o una combinación única de valores de varias dimensiones. El salto de página se eliminará si desactiva la casilla de verificación **Salto de página después de cada instancia**.

# Cambio de tamaño, márgenes y orientación del papel
<a name="qs-reports-paper-size"></a>

Después de crear un informe con píxeles perfectos en Amazon Quick Sight, puede cambiar el formato, la orientación y los márgenes del informe desde el menú de **configuración de Análisis** cuando lo desee.

## Para cambiar el tamaño del papel de un informe en píxeles perfectos
<a name="paginated-reports-paper-size"></a>

1. En la página de inicio de Quick, selecciona **Análisis** y, a continuación, elige el análisis que contenga el informe con todos los píxeles que deseas cambiar.

1. Elija **Hojas** en el menú de archivo y seleccione **Configuración de diseño**.

1. Abra el menú desplegable **Tamaño del papel** y elija el tamaño de papel que desee. Puede elegir entre las siguientes opciones:
   + Carta EE. UU. (8,5 x 11 pulgadas)
   + Legal EE. UU. (8,5 x 14 pulgadas)
   + A0 (841 x 1189 mm)
   + A1 (594 x 841 mm)
   + A2 (420 x 594 mm)
   + A3 (297 x 420 mm)
   + A4 (210 x 297 mm)
   + A5 (148 x 210 mm)
   + Japón B4 (257 x 364 mm)
   + Japón B5 (182 x 257 mm)

1. Seleccione **Aplicar**.

## Cambio de la orientación de un informe
<a name="paginated-reports-orientation"></a>

1. En la página de inicio de Quick, elija **Análisis** y, a continuación, elija el análisis que contenga el informe con píxeles perfectos que desee cambiar.

1. Elija el icono **Configuración** de la parte izquierda.

1. Elija la orientación del informe y, a continuación, seleccione **Aplicar**.

## Cambio de los márgenes de un informe
<a name="paginated-reprots-margins"></a>

1. En la página de inicio rápido, elija **Análisis** y, a continuación, elija el análisis que contenga el informe con píxeles perfectos que desee cambiar.

1. Seleccione **Editar < Configuración de análisis**.

1. Introduzca los valores de margen que desee que tenga el informe y, a continuación, seleccione **Aplicar**.

Los valores de margen se aplican a todas las páginas de un informe con píxeles perfectos. No puede establecer ajustes personalizados para páginas específicas de un informe, pero puede establecer márgenes personalizados para las secciones con el relleno de secciones. Para obtener más información sobre el relleno de sección, consulte [Relleno de sección](qs-reports-section-padding.md). Los valores de los márgenes se expresan en pulgadas. Los márgenes predeterminados de todos los informes son de 0,5 pulgadas.

# Incorporación y eliminación de saltos de página en un informe
<a name="qs-reports-page-breaks"></a>

Puede añadir saltos de página entre las secciones de un informe con píxeles perfectos para organizar la forma en que se representan los datos cuando se publica el informe por página. Por ejemplo, supongamos que tiene un informe que contiene dos secciones de 2,5 páginas cada una. De forma predeterminada, `Section 2` comienza en la tercera página del informe, justo después del final de `Section 1`. Si añade un salto de página al final de `Section 1`, `Section 2` comienza en una nueva página, incluso si la última página `Section 1` solo usa la mitad de una página. Esto resulta útil cuando no desea que diferentes secciones compartan páginas pero no sabe cuántas páginas necesitará cada sección.

**Adición o eliminación de un salto de página**

1. Seleccione su sección y elija el icono **Editar sección** en la esquina superior izquierda.

1. En el panel **Editar sección** que se abrirá a la izquierda, active la casilla de verificación **Salto de página después de**.

1. Seleccione **Aplicar**.

Al activar la casilla **Salto de página después de**, aparecerá un salto de página al final de la sección. Si desactiva la casilla de verificación **Salto de página después de**, el salto de página se eliminará del final de la sección. Además, la sección anterior se representa directamente debajo de la última página de la sección, incluso si hace que las dos secciones compartan una página.

También puede añadir o eliminar un salto de página de un informe al seleccionar el icono con el signo más (\$1) situado en la parte inferior de una sección existente y elegir **Agregar salto de página** o **Eliminar salto de página**.

# Incorporación y eliminación de elementos visuales de un informe
<a name="qs-reports-add-visuals"></a>

**Para añadir imágenes a una sección de un informe con píxeles perfectos**

1. En tu informe con píxeles perfectos, selecciona la sección a la que quieres añadir un elemento visual. 

1. Seleccione el icono **AGREGAR** (\$1) en el panel **Elementos visuales**.

1. Elija el tipo de elemento visual que desee usar en el informe.

Tras añadir un elemento visual a un informe, podrá interactuar con él de la misma manera que lo haría si el elemento visual formara parte de un panel interactivo. Puede arrastrar y soltar imágenes en cualquier lugar que desee, de forma similar a un diseño de formato libre en una hoja de panel de control interactivo de Quick Sight. También puede superponer elementos visuales, cambiar su tamaño o llevarlos al frente o al fondo de la sección. Para obtener más información sobre el formato de elementos visuales en Amazon Quick Sight, consulte[Formatear en Amazon Quick](formatting-a-visual.md).

**Eliminación de un elemento visual**

1. En la sección en la que desee eliminar un elemento visual, seleccione el elemento visual que desee eliminar.

1. Elija el icono con tres puntos de la esquina superior derecha del elemento visual para abrir el menú del elemento visual.

1. Elija **Eliminar**.

Al eliminar una imagen de una sección de un informe con píxeles perfectos, solo se elimina esa imagen específica del informe. Los elementos visuales duplicados que se encuentren en diferentes secciones del informe se mantendrán en el informe.

# Incorporación de un cuadro de texto a un informe
<a name="qs-reports-add-text-box"></a>

Puede añadir cuadros de texto a sus informes con píxeles perfectos para añadir contexto a sus informes. Los elementos visuales de cuadros de texto también se pueden utilizar como cuadros para añadir hipervínculos a sitios web externos. Para personalizar la fuente, el estilo de fuente, el color del texto, el espaciado del texto, la alineación y el tamaño del texto, utilice la barra de herramientas del cuadro de texto que se mostrará al seleccionar el elemento visual.

**Adición de un cuadro de texto a un informe**

1. En tu informe con píxeles perfectos, selecciona la sección a la que quieres añadir un cuadro de texto. 

1. Elija el icono de **Cuadro de texto** en la barra de tareas.

1. El nuevo cuadro de texto aparecerá en la sección del informe seleccionado.

Para editar un cuadro de texto, selecciónelo y comience a escribir lo que desee. Aparecerá una barra de herramientas que podrá utilizar para cambiar el formato y el estilo del texto.

**Eliminación de un cuadro de texto**

1. En la sección de la que desee eliminar el cuadro de texto, seleccione el cuadro de texto que desee eliminar.

1. Elija el icono con tres puntos de la esquina superior derecha del elemento visual para abrir el menú del cuadro de texto.

1. Elija **Eliminar**.

# Parámetros del sistema de cuadros de texto
<a name="text-box-parameters"></a>

Usa cuadros de texto para añadir parámetros del sistema a los encabezados y pies de página de tu informe, perfectos en píxeles. Los parámetros del sistema de cuadros de texto se muestran en el extremo derecho de la barra de herramientas del cuadro de texto. Puede añadir los siguientes parámetros a un encabezado o pie de página de su informe:
+ Números de página: número de página actual del informe.
+ Fecha de impresión del informe: fecha en que se generó el informe.

Para añadir un parámetro de número de página al cuadro de texto, elija el icono de número (\$1), que se encuentra en el extremo derecho de la barra de herramientas del cuadro de texto. Para añadir un parámetro `PrintDate` al cuadro de texto, elija el icono de calendario, que se encuentra en el extremo derecho de la barra de herramientas del cuadro de texto.

Para opciones de parámetros más avanzadas, añada información a su informe paginado.

# Configuración de peticiones para informes paginados
<a name="paginated-reports-prompts"></a>

Los autores de Amazon Quick pueden crear mensajes en informes con píxeles perfectos para que los usuarios del panel de control puedan filtrar los datos de los informes programados y bajo demanda. Las *peticiones* se comportan de la misma manera que un filtro o un control en una hoja interactiva.

**Para definir un mensaje en un informe con píxeles perfectos**

1. En una hoja con píxeles perfectos, defina un control de filtro o un control de parámetros. Para obtener más información sobre los controles de filtros en hojas, consulte [Adición de controles de filtro a las hojas de análisis](filter-controls.md). Para obtener más información acerca de los controles de parámetros, consulte [Uso de un control con un parámetro en Amazon Quick](parameters-controls.md).

1. En el nuevo filtro o parámetro, elija los valores de petición que desee. Las nuevas peticiones se reflejan inmediatamente en la hoja.

1. Para exportar el informe con las nuevas peticiones, seleccione **Archivo** y, a continuación, seleccione **Exportar a PDF**.

Las peticiones no se pueden mover a la propia hoja. En su lugar, se muestran en el panel superior.

Después de crear una solicitud para un informe con píxeles perfectos y publicarla como panel de control, los autores de Quick pueden usar la nueva solicitud para configurar y programar los informes que se envían a los visualizadores de Quick Dashboard. Los espectadores del panel también pueden usar estas peticiones para crear sus propios informes programados. Para obtener más información sobre los informes generados por lectores, consulte [Creación de un informe generado por un lector en Amazon Quick Sight](reader-scheduling.md).

# Consumir informes con píxeles perfectos en Amazon Quick Sight
<a name="qs-reports-consume-reports"></a>

Cuando un autor de Amazon Quick publique y, a continuación, envíe un informe programado con píxeles perfectos, Quick generará y guardará una instantánea del informe que se envía. Siempre que visites el panel de control del informe con píxeles perfectos, verás la instantánea generada del informe enviado más recientemente. Si intenta ver el panel de su informe pero aún no ha enviado ningún informe por correo electrónico, se le pedirá que programe su primer informe para ver la instantánea del panel. Para obtener más información sobre la programación de envío de informes por correo electrónico, consulte [Programar y enviar informes de Quick Sight por correo electrónico](sending-reports.md).

Si un autor de Quick Sight ha configurado un informe emergente para obtener un informe perfecto en cuanto a píxeles, los lectores de Quick Sight pueden utilizar el mensaje para programar ellos mismos sus propios informes bajo demanda. Para obtener más información sobre los informes generados por lectores, consulte [Creación de un informe generado por un lector en Amazon Quick Sight](reader-scheduling.md). Para obtener más información sobre las solicitudes de informes con píxeles perfectos, consulte[Configuración de peticiones para informes paginados](paginated-reports-prompts.md).

Los usuarios no pueden interactuar con un informe publicado en píxeles perfectos del mismo modo que pueden interactuar con una hoja interactiva publicada. A diferencia de las hojas interactivas, los informes con píxeles perfectos generan instantáneas estáticas de los datos que se presentan en grupos de imágenes o cuadros de texto. Estas instantáneas estáticas se generan en el momento en que se envía el informe, para que la audiencia pueda ver la última versión de los datos del informe. Los informes con píxeles perfectos son especialmente útiles para generar facturas o reseñas comerciales semanales. A continuación, los usuarios pueden comparar los informes actuales con los que se generaron en el pasado para hacer un mejor seguimiento de los datos de su empresa.

## Visualización del historial de instantáneas de un informe
<a name="qs-reports-snapshot-history"></a>

Cada vez que envías un informe de píxeles perfectos programado, Amazon Quick guarda una copia de la instantánea generada que se envía como referencia. Puede ver estas instantáneas en cualquier momento en la consola Quick.

**Visualización del historial de instantáneas de un informe**

1. En la página de inicio de Quick, elija **Paneles** y, a continuación, elija el panel cuyo historial de instantáneas desee ver.

1. Elija el icono **Programación** en la barra de herramientas superior derecha y, a continuación, elija **Instantáneas recientes**.

1. En el panel **Instantáneas recientes** que aparece a la derecha, elija la instantánea que desee ver y, a continuación, pulse el botón de descarga situado junto al archivo que desee descargar.

# Cancelar la suscripción a los informes paginados en Quick Sight
<a name="qs-reports-getting-started-unsubscribe"></a>

Puedes darte de baja de Quick Sight Pixel Perfect Reporting en cualquier momento. Si te das de baja de los informes con píxeles perfectos, perderás la posibilidad de crear y programar informes perfectos con píxeles perfectos en Quick Sight. Seguirá teniendo acceso a los informes paginados existentes, pero no podrá realizar cambios ni programar nuevos informes.

**Para cancelar la suscripción a Pixel Perfect Reporting en Amazon Quick Sight**

1. Desde cualquier página de Quick, elige tu nombre de usuario en la esquina superior derecha y selecciona **Administrar Quick**.

1. Selecciona **Administrar suscripciones** en la parte izquierda.

1. **En la página **Administrar suscripciones**, busca la sección **Informes de Pixel-Perfect** y selecciona Administrar.**

1. Desplácese hacia abajo hasta el plan de suscripción elegido y seleccione **Cancelar suscripción**.

# Trabajar con elementos en hojas en los análisis de Amazon Quick Sight
<a name="authoring-sheets"></a>

Utilice esta sección para aprender a trabajar con imágenes y otros elementos al crear hojas en Quick Sight

**Topics**
+ [Añadir imágenes a los análisis de Quick Sight](creating-a-visual.md)
+ [Uso de temas en hojas en Amazon Quick Sight](using-q-topics-on-sheets.md)
+ [Tipos visuales en Amazon Quick Sight](working-with-visual-types.md)
+ [Formatear en Amazon Quick](formatting-a-visual.md)
+ [Personalización de la presentación de datos](analyzing-data-analyses.md)

# Añadir imágenes a los análisis de Quick Sight
<a name="creating-a-visual"></a>

Un elemento *visual* es una representación gráfica de sus datos. Puede crear muy diversos elementos visuales en un análisis, mediante diferentes conjuntos de datos y tipos de elementos visuales. 

Una vez que haya creado un espacio de trabajo visual, puede modificar de diversas formas para personalizarlo según sus necesidades. Entre las personalizaciones posibles se incluyen el cambio de los campos que se asignan a los elementos visuales, el tipo de datos, el orden de los datos visuales o la aplicación de un filtro.

Quick Sight admite hasta 50 conjuntos de datos en un solo análisis y hasta 50 imágenes en una sola hoja, con un límite de 20 hojas por análisis.

Puede crear un elemento visual de diversas maneras. Puede seleccionar los campos que desee y utilizarlos AutoGraph para que Amazon Quick Sight determine el tipo visual más adecuado. Si lo prefiere, puede elegir un tipo visual específico y los campos para rellenarlo. Si no estás seguro de qué preguntas pueden responderte tus datos, puedes elegir **Sugeridas** en la barra de herramientas y elegir una imagen que sugiera Amazon Quick Sight. Los elementos visuales sugeridos son aquellos que consideramos de interés, basándonos en un examen previo de sus datos. Para obtener más información AutoGraph, consulte[Uso AutoGraph](autograph.md). 

Puede añadir elementos visuales al espacio de trabajo eligiendo **Agregar**, seguido de **Agregar elemento visual**. Los elementos visuales creados a partir del 21 de junio de 2018 tienen un tamaño inicial más pequeño, por lo que caben dos en cada fila. Puede cambiar el tamaño de los elementos visuales y arrastrarlos para reorganizarlos. 

Para crear un elemento visual útil, le ayuda saber qué pregunta está intentando responder de la forma más específica posible. También ayuda a utilizar el conjunto de datos menor que puede responder a esa pregunta. Esto le ayuda a crear elementos visuales más sencillos y fáciles de analizar. 

## Campos como dimensiones y medidas
<a name="dimensions-and-measures"></a>

En el panel **Elementos visuales**, los campos de dimensión tienen iconos azules y los de medida, naranja. Las *dimensiones* son campos de texto o de fecha que pueden ser elementos, como productos. O bien, pueden ser atributos relacionados con las medidas y se pueden utilizar para particionarlas, como la fecha de ventas para cifras de ventas. Las *medidas* son valores numéricos que se utilizan para la medición, la comparación y la agregación. Por lo general, utiliza una combinación de campos de dimensión y medida para producir un elemento visual; por ejemplo, totales de ventas (una medida) por fecha de ventas (una dimensión). Para obtener más información acerca de los tipos de campos previstos según los diferentes tipos de elementos visuales, consulte los temas específicos sobre tipos de elementos visuales en la sección [Tipos visuales en Amazon Quick Sight](working-with-visual-types.md). Para obtener más información sobre cómo cambiar la configuración de medida o dimensión de un campo, consulte [Configuración de campos como dimensiones o medidas](setting-dimension-or-measure.md).

## Limitaciones de campo
<a name="visual-field-limitations"></a>

Solo puede utilizar un campo de fecha por elemento visual. Esta limitación se aplica a todos los tipos de elementos visuales.

No puede utilizar el mismo campo para más de un cuadro de campo de dimensión o destino de colocación en un elemento visual. Para obtener más información acerca de cómo se indica el tipo de campo previsto por cuadros de campo y destinos de colocación, consulte [Uso de los controles de campo del elemento visual](using-visual-field-controls.md).

## Búsqueda de campos
<a name="searching-for-a-field"></a>

Si la lista de campos del panel **Lista de campos** es muy larga, puede hacer una búsqueda para encontrar un campo determinado. Para ello, elija el icono de búsqueda en la parte superior del panel **Datos** y, a continuación, escriba un término de búsqueda en el cuadro. Aparecen todos los campos cuyos nombres contienen el término de búsqueda. La búsqueda no distingue entre mayúsculas y minúsculas, y no admite el uso de comodines. Elija el icono de cancelar (**X**) que se encuentra a la derecha del campo de búsqueda para volver a visualizar todos los campos.

## Adición de un elemento visual
<a name="create-a-visual"></a>

Utilice el siguiente procedimiento para crear un nuevo elemento visual.

**Creación de un elemento visual nuevo**

1. Abra la [consola rápida](https://quicksight.aws.amazon.com/).

1. En la página de inicio de Quick, elija el análisis al que desee añadir una imagen.

1. En la página de análisis, elija el conjunto de datos que desea utilizar en la lista de conjuntos de datos de la parte superior del panel **Datos**. Para obtener más información, consulte [Añadir un conjunto de datos a un análisis](adding-a-data-set-to-an-analysis.md).

1. Abra el panel **Visualizar**, elija **Agregar** y, a continuación, elija **Agregar elemento visual**.

   Se crea un nuevo elemento visual en blanco, que queda resaltado.

1. Utilice una de las siguientes opciones:
   + Elija los campos que desea utilizar en el panel **Datos** de la izquierda. Si los campos no están visibles, elija **Visualizar** para mostrarlo. Amazon Quick Sight crea la imagen utilizando el tipo de imagen que determina que es más compatible con los datos que ha seleccionado.
   + Seleccione la flecha desplegable situada junto al botón **AGREGAR** para elegir un tipo de elemento visual. Una vez creado el elemento visual, elija los campos que desee rellenar.

     1. Elija el icono de un tipo de elemento visual en el panel **Tipos de elementos visuales**.  
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/visual-types.png)

        Los cuadros de campo muestran los campos que se visualizan.   
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/field-wells.png)

     1. En el panel **Datos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica por el color del cuadro de campo de destino. Si decide utilizar un campo de dimensión para completar un cuadro de campo **Valor**, la función de agregación **Recuento** se aplica automáticamente para crear un valor numérico.

        Amazon Quick Sight crea la imagen con el tipo de imagen que ha seleccionado.
   + Cree un elemento visual mediante una sugerencia.

     En la barra de herramientas, seleccione **Suggested** y, a continuación, elija un elemento visual sugerido.

# Importación de imágenes de Amazon Quick Sight a un análisis
<a name="import-visuals"></a>

Los autores de Quick Sight pueden importar imágenes de Quick Sight de un análisis o panel a un análisis nuevo que tenga privilegios de acceso. Al importar una imagen de un análisis o panel de Quick Sight a otro análisis de Quick Sight, se importan las siguientes dependencias junto con la imagen.
+ Conjuntos de datos asociados al elemento visual
+ Todos los parámetros configurados para el elemento visual
+ Campos calculados configurados para el elemento visual
+ Definiciones de filtros
+ Propiedades del elemento visual
+ Reglas de formato condicional

Utilice las siguientes secciones para obtener más información sobre la importación de imágenes de Quick Sight.

**Topics**
+ [Consideraciones](#import-visuals-considerations)
+ [Importación de un elemento visual](#import-visual-procedure)

## Consideraciones
<a name="import-visuals-considerations"></a>

Antes de importar un elemento visual, revise las siguientes limitaciones.
+ El autor de Quick Sight que desee importar una imagen debe tener privilegios de propiedad sobre el análisis al que desee importar la imagen
+ Los controles de filtrado no se pueden importar.
+ No se admite la importación de elementos visuales de varias hojas a la vez.
+ No se admiten algunas configuraciones de usuario, incluidas las configuraciones de filtros que se mantienen en función de los marcadores y las alertas.

## Importación de un elemento visual
<a name="import-visual-procedure"></a>

Utilice el siguiente procedimiento para importar un elemento visual de un panel o análisis de origen a un análisis diferente.

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el análisis al que desee importar una imagen.

1. Elija **Archivo** y, a continuación, **Importar**. Como alternativa, puede elegir el icono **Importar** de la barra de herramientas **AGREGAR**.

1. Se abre el modal **Explorador de activos**. Se muestra una lista de todos los paneles y análisis de orígenes aptos a los que puede acceder. Elija el artefacto desde el que desea importar un elemento visual y, a continuación, elija **CARGAR**. Como alternativa, ingrese el nombre del artefacto de origen que contiene el elemento visual que desea importar en la barra de búsqueda **Buscar origen para insertar**. Elija el artefacto que desea importar y, a continuación, elija **CARGAR**.

1. En la página **Seleccione los elementos visuales para importar** que se abre, elija la hoja que contiene los elementos visuales que desea importar y, a continuación, elija los elementos visuales que desea. Solo puede importar elementos visuales de una hoja a la vez. Cuando haya elegido todos los elementos visuales que desea importar, elija **IMPORTAR**.

Tras importar correctamente, los elementos visuales importados se agregan al análisis de destino. Los elementos visuales importados retienen las propiedades originales que se les configuraron en el panel o análisis de origen. Los elementos visuales importados heredan las propiedades por tema del tema que se aplica al análisis de destino.

# Duplicación de imágenes de Quick Sight
<a name="duplicating-a-visual"></a>

Puede duplicar un elemento visual para hacer una nueva copia en la misma hoja o en otra. 

Para duplicar un elemento visual, en el menú del elemento visual con forma de **v**, elija **Duplicar elemento visual** y, a continuación, elija la hoja en la que desea que aparezca el elemento visual. La pantalla muestra automáticamente el elemento visual duplicado.

Los elementos visuales duplicados conservan los mismos filtros y configuraciones que el elemento visual original. Sin embargo, si duplica un elemento visual en una hoja diferente, todos sus filtros copiados se aplican únicamente al duplicado. Todos los filtros copiados se reducen para que se apliquen únicamente a ese elemento visual. Si desea que los filtros se apliquen a más elementos visuales en la nueva hoja, edite el filtro y cambie el valor.

Los parámetros y los controles se aplican a todas las hojas. Para que los controles de parámetros funcionen con un elemento visual que duplique en otra hoja, añada filtros en la hoja de destino y conéctelos al parámetro. Para ello, elija **Filtro personalizado** como el tipo de filtro.

# Cambiar el nombre de las imágenes de Amazon Quick Sight
<a name="renaming-a-visual"></a>

Utilice el siguiente procedimiento para cambiar el nombre de un elemento visual.

**Cambio del nombre de un elemento visual**

1. En la página de análisis, elija el elemento visual cuyo nombre desee cambiar.

1. Seleccione el nombre del elemento visual en su parte superior izquierda y escriba un nombre nuevo.

1. Pulse **Enter** o haga clic fuera del campo de nombre del elemento visual para guardar el nombre nuevo.

# Visualización de datos visuales en Amazon Quick Sight
<a name="viewing-visual-data"></a>

Amazon Quick Sight ofrece diversas formas de ver los detalles de los datos que se muestran de forma visual. Los ejes o filas y columnas del elemento visual (en función del tipo de elemento visual) tienen etiquetas. Al pasar el ratón por encima de cualquier elemento gráfico de un elemento visual se muestran los datos asociados a dicho elemento. Algunos tipos de elementos visuales utilizan señales visuales para enfatizar el elemento sobre el que pasa el ratón y diferenciarlos más fácilmente. Por ejemplo, el tipo de elemento visual puede cambiar el color del elemento o resaltarlo.

Utilice las secciones siguientes para obtener más información sobre la visualización de datos en los elementos visuales.

**Topics**
+ [Visualización de los detalles de un elemento visual](viewing-visual-details.md)
+ [Desplazamiento por los datos de un elemento visual](scrolling-through-visual-data.md)
+ [Centrarse en los elementos visuales](focusing-on-visual-elements.md)
+ [Exclusión de elementos visuales](excluding-visual-elements.md)
+ [Búsqueda de valores específicos en sus datos en Quick Sight](search-filter.md)

# Visualización de los detalles de un elemento visual
<a name="viewing-visual-details"></a>

Cuando vea un elemento visual, sitúe el cursor sobre cualquier elemento gráfico para obtener detalles de dicho elemento. Por ejemplo, al pasar el ratón sobre una sola barra de un gráfico de barras, la información sobre esa barra específica se muestra en una descripción emergente de información sobre herramientas.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/bar-detail.png)


Al pasar el cursor sobre un único punto de datos en un diagrama de dispersión, también se muestra información sobre ese punto de datos específico.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/scatter-plot-detail.png)


Puede personalizar la información que aparece al pasar el cursor sobre los datos de un gráfico. Para obtener más información, consulte [Información sobre herramientas](customizing-visual-tooltips.md).

# Desplazamiento por los datos de un elemento visual
<a name="scrolling-through-visual-data"></a>

Para los gráficos de barras, los gráficos de líneas y las tablas dinámicas, el contenido del elemento visual puede ser mayor que el tamaño deseado. 

En estos casos, aparecen barras de desplazamiento para que pueda reducir los datos que se muestran o desplazarse por ellos. Este proceso es similar a la forma en que puede desplazarse por un video. 

Para reducir la longitud de la barra de desplazamiento, coloque el cursor sobre un extremo hasta que el cursor cambie de forma. A continuación, arrastre el widget para que la barra de desplazamiento sea más grande o más pequeña. Para desplazarse por los datos, haga clic y mantenga presionada la barra de desplazamiento y deslícela hacia el extremo que desee ver.

# Centrarse en los elementos visuales
<a name="focusing-on-visual-elements"></a>

Al ver elementos visuales, puede elegir los datos en los que desea centrarse o excluir. Para realizar esta elección, elija un elemento como una barra o burbuja, o un encabezado de fila o columna.

Al centrarse en los datos o excluirlos, Quick Sight crea un filtro y muestra solo los datos que ha seleccionado.

Para quitar el filtro, elija **Filtros** a la izquierda y, a continuación, deshabilite o elimine el filtro. También puede utilizar **Deshacer** para eliminar un filtro.

Si el elemento visual tiene una leyenda que muestra categorías (dimensiones), puede hacer clic en los valores de la leyenda para ver un menú de acciones disponibles. Por ejemplo, supongamos que el gráfico de barras tiene un campo en el cuadro de campo **Color** o **Grupo/color**. El menú del gráfico de barras muestra las acciones que puede elegir haciendo clic o haciendo clic con el botón derecho en una barra, como las que se muestran a continuación: 
+ Centrarse en elementos visuales o excluirlos
+ Cambiar los colores de los elementos visuales
+ Profundizar en una jerarquía
+ Acciones personalizadas activadas desde el menú, incluidas las acciones de filtrado o URL

# Exclusión de elementos visuales
<a name="excluding-visual-elements"></a>

Cuando se muestran elementos visuales, puede elegir un elemento y situar en él el enfoque. Algunos elementos que pueden recibir el enfoque son, por ejemplo, una barra o burbuja, o una fila o un encabezado de columna en el caso de una tabla dinámica. La excepción es que no puede excluir elementos que se asignan a campos de fecha. Puede excluir varios elementos en un solo gráfico.

Si se excluye el elemento, se crea un filtro que elimina únicamente ese elemento del elemento visual.

Para ver el elemento excluido de nuevo, puede elegir **Deshacer** en la barra de aplicaciones o puede deshabilitar o eliminar el filtro.

Para obtener más información acerca de los filtros, consulte [Filtrado de datos en Amazon Quick Sight](adding-a-filter.md).

# Búsqueda de valores específicos en sus datos en Quick Sight
<a name="search-filter"></a>

Al filtrar datos visuales, previsualizar anomalías o utilizar los controles de lista o desplegables de un panel, puede buscar rápidamente los valores que le interesen.

Puede buscar valores específicos o todos los valores que contengan una consulta de búsqueda específica. Por ejemplo, si busca *al* en una lista de estados de EE. UU., obtendrá como resultado **Al**abama, **Al**aska y C**al**ifornia.

También puede utilizar la búsqueda con caracteres comodín para buscar todos los valores que coincidan con un patrón de caracteres específico. Por ejemplo, puede buscar todos los estados de EE. UU. que terminen con las letras *ia* y limitar los resultados a California, Georgia, Pensilvania, Virginia y Virginia Occidental.

**Para buscar valores en un filtro o control**, ingrese una consulta de búsqueda en la barra de búsqueda. 

## Uso de la búsqueda comodín
<a name="search-filter-wildcard"></a>

Los siguientes caracteres comodín se pueden utilizar para buscar valores en los filtros Quick Sight, los controles de listas y desplegables y las vistas previas de anomalías.
+ **\$1**: utilice un asterisco para buscar valores que coincidan entre cero y varios caracteres en una posición específica.
+ **?**: utilice un signo de interrogación para hacer coincidir un carácter único en una posición específica.
+ **\$1**: utilice una barra invertida para utilizar los caracteres comodín de escape **\$1**, **?** o **\$1** y buscarlos en su consulta. Por ejemplo, puede buscar frases que terminen con un signo de interrogación.

A continuación se muestran ejemplos de cómo se pueden utilizar los caracteres comodín compatibles en una consulta de búsqueda de Quick Sight.
+ **al**: esta consulta busca todos los valores con **al** y devuelve Alabama, Alaska y California.
+ **al\$1**: esta consulta busca todos los valores que comiencen por **al** y terminen de cero a varios caracteres. Devuelve Alabama y Alaska en una lista de estados de EE. UU.
+ **\$1ia**: esta consulta busca todos los valores que comiencen de cero a varios caracteres y terminen con letras **ia**. Devuelve California, Georgia, Pensilvania, Virginia y Virginia Occidental.
+ **\$1al\$1**: esta consulta busca todos los valores que comiencen de cero a varios caracteres y terminen por las letras **al**. Devuelve Alabama, Alaska y California.
+ **a?a?a?a**: esta consulta busca todos los valores con un solo carácter en las posiciones exactas entre las letras **a**. Devuelve Alabama.
+ **a?a\$1a**: esta consulta busca todos los valores con un solo carácter entre las dos primeras letras **a** y varios caracteres entre las dos segundas letras **a**. Devuelve Alabama y Alaska.
+ **How\$1\$1?**: esta consulta busca todos los valores que comiencen por **How**, seguidos por entre cero y varios caracteres, y que terminen con un signo de interrogación. La barra invertida (\$1) de esta consulta indica a Quick Sight que busque signos de interrogación en cada valor, en lugar de utilizar el símbolo del signo de interrogación como carácter comodín. Esta consulta devuelve las preguntas: ¿Cómo está? y, ¿cómo es posible?
+ **\$1\$1\$1**: esta consulta busca todos los valores que comiencen por un asterisco, seguidos por entre cero y varios caracteres. La barra invertida (\$1) de esta consulta indica a Quick Sight que busque un asterisco real en los valores, en lugar de utilizar el símbolo del asterisco como carácter comodín. Esta consulta devuelve valores como \$1all, \$1above y \$1below.
+ **\$1\$1\$1**: esta consulta busca todos los valores que tengan una barra invertida, seguidos por entre cero y varios caracteres. La primera barra invertida (\$1) de esta consulta indica a Quick Sight que busque la segunda barra invertida (\$1) en cada valor, en lugar de utilizar el símbolo de barra invertida como carácter comodín. Esta consulta devuelve resultados como \$1Home.
+ **???**: esta consulta busca valores que contengan tres caracteres. Devuelve valores como ant, bug y car.

# Exportación de datos de elementos visuales
<a name="exporting-data"></a>

**nota**  
Los archivos de exportación pueden devolver directamente información de la importación del conjunto de datos. Esto hace que los archivos sean vulnerables a ejecuciones CSV si los datos importados contienen fórmulas o comandos. Por este motivo, los archivos de exportación pueden provocar advertencias de seguridad. Para evitar actividades maliciosas, desactive los enlaces y las macros al leer los archivos exportados.

Con la consola Amazon Quick, puede exportar datos de cualquier tipo de tabla o gráfico. La exportación solo contiene los datos de los campos que están actualmente visibles en la visualización seleccionada. Los datos que se filtran se excluyen del archivo de exportación. Puede exportar datos a los siguientes formatos:
+ Un archivo de texto que contiene valores separados por comas (CSV), disponible para todos los tipos visuales. 
+ Un archivo de libro de trabajo de Microsoft Excel (.xslx), disponible únicamente para tablas dinámicas y gráficos de tablas.

Se aplican las siguientes reglas:
+ Los archivos exportados se descargan en el directorio de descargas predeterminado configurado en el navegador que esté utilizando actualmente. 
+ El archivo descargado recibe el nombre de la visualización desde la que lo exportó. Para que el nombre de archivo sea único, este cuenta con una marca de tiempo secuencial (un tipo de datos de tiempo Unix). 
+ Límite predeterminado de exportación a formato CSV: 500 MB o 1 millón de filas, lo que ocurra primero
+ Límite predeterminado de exportación a formato de Excel: 
  + Del elemento visual de la tabla dinámica 400 000 celdas o 50 000 filas 
  + Del elemento visual de la tabla 800 000 celdas o 100 000 filas 
**nota**  
Con una suscripción a Informes paginados, podrá [programar la exportación de elementos visuales en formatos CSV y de Excel](https://docs.aws.amazon.com/quicksight/latest/user/sending-reports.html) y exportar hasta 3 millones de filas (CSV) y 16 millones de celdas (Excel). 
+ No puede exportar datos de una información, ya que la información consume los datos, pero no los contiene. 
+ Quick Sight no admite la exportación de datos de más de una visualización a la vez. Para exportar datos de elementos visuales adicionales en el mismo análisis o panel, repita este proceso con cada elemento visual. Para exportar todos los datos de un panel o un análisis, debe conectarse al origen de datos original con credenciales válidas y una herramienta que pueda utilizar para extraer datos. 

Utilice el siguiente procedimiento para exportar datos de una visualización en Amazon Quick Sight. Antes de empezar, abra el análisis o el panel que contiene los datos que desea exportar.

**Exportación de datos desde una visualización**

1. Elija el elemento visual que desea exportar. Asegúrese de que esté seleccionada y resaltada.

1. En la parte superior derecha del elemento visual, abra el menú y elija una de las siguientes opciones:
   + Para exportar a CSV, seleccione **Exportar a CSV**. 
   + Para exportar a XSLX, seleccione **Exportar a Excel**. Esta opción está disponible para tablas dinámicas tabulares y gráficos de tablas.

1.  Dependiendo de la configuración de su navegador, se produce una de las siguientes situaciones: 
   + El archivo va automáticamente a su ubicación de **Descarga** predeterminada. 
   + Aparece un cuadro de diálogo para que pueda elegir un nombre de archivo y ubicación. 
   + Aparece un cuadro de diálogo para que pueda elegir entre abrir el archivo con el software predeterminado o guardarlo. 

# Imágenes refrescantes en Quick Sight
<a name="refreshing-visuals"></a>

Cuando trabaja en un panel o un análisis de Quick Sight, las imágenes se actualizan y se recargan cuando cambia algo que las afecta, como actualizar un parámetro o un control de filtro. Si cambia a una hoja nueva después de cambiar un parámetro o filtro, solo las imágenes afectadas por el cambio se actualizan en la nueva hoja. De lo contrario, las imágenes se actualizan cada 30 minutos al cambiar de hoja. Este es el comportamiento predeterminado de todos los análisis y paneles.

Si desea actualizar todos los elementos visuales al cambiar de hoja, independientemente de los cambios, puede hacerlo para cada análisis que cree. 

**Actualización de todos los elementos visuales cada vez que cambie de hoja en un análisis**

1. En Amazon Quick, abra el análisis.

1. En el análisis, elija **Editar > Configuración de análisis**.

1. En el panel **Configuración de análisis** que se abrirá, en **Opciones de actualización**, active **Volver a cargar elementos visuales cada vez que cambio de hoja**.

1. Seleccione **Aplicar**.

# Eliminar imágenes de Amazon Quick Sight
<a name="deleting-a-visual"></a>

Utilice el siguiente procedimiento para eliminar un elemento visual.

**Eliminación de un elemento visual**

1. En la página de análisis, seleccione el elemento visual que desea eliminar.

1. Elija el menú del elemento visual en la esquina superior derecha de este y, a continuación, seleccione **Delete**.

# Uso de temas en hojas en Amazon Quick Sight
<a name="using-q-topics-on-sheets"></a>

Amazon Quick Sight proporciona un flujo de trabajo guiado para crear temas. Puede salir del flujo de trabajo guiado y volver a él más tarde, sin interrumpir su trabajo. 

Al habilitar uno o más temas de Quick Sight en su espacio de trabajo de análisis, activa la preparación automática de datos con tecnología ML, que acelera la creación de temas en lenguaje natural (NL). La preparación automática de datos selecciona automáticamente los campos de alto valor en función de cómo se utilizan y de las necesidades habituales de preguntas y respuestas. Elige automáticamente nombres de campo y sinónimos fáciles de usar, basándose en términos de los análisis existentes y en diccionarios comunes. También formatea los datos automáticamente, por lo que se pueden utilizar inmediatamente cuando se presentan.

La preparación automática de datos vincula el tema a su análisis y prepara un índice para realizar búsquedas en lenguaje natural. Un punto azul indica esta unión. Los usuarios del panel de control descubren que el nuevo tema de Amazon Quick Sight se selecciona automáticamente, lo que les facilita la consulta del conjunto de datos. 

Las siguientes reglas se aplican al trabajo con temas:
+ Debe ser propietario del conjunto de datos subyacente para poder crear un tema con ese conjunto de datos o un análisis que utilice ese conjunto de datos. 
+ Debe ser propietario de un tema para poder vincular el tema existente a un análisis.

**Para habilitar un tema**

1. Abra el análisis que desee utilizar con la preparación automática de datos.

1. En la barra de navegación superior, selecciona el icono del tema.

1. Seleccione una de las siguientes opciones:
   + Para activar un tema nuevo, selecciona **Crear tema nuevo** e introduce el título del tema y una descripción opcional.
   + Para activar un tema existente, seleccione **Actualizar tema existente** y elíjalo en la lista.

1. Elija **HABILITAR TEMA** para confirmar su elección.

1. Cuando el tema haya terminado de procesarse, puede usar lo aprendido del análisis para hacer preguntas en lenguaje natural.

   Ahora, cuando los usuarios naveguen al panel de control, el tema vinculado se selecciona automáticamente en la barra de búsqueda.

Una vez que se vincula un tema a un análisis, las actualizaciones posteriores del análisis no se sincronizan automáticamente con el tema. Los autores deben gestionar la actualización de los temas manualmente desde la página **Temas**. 

Al habilitar un tema para un análisis o un panel, se inicia un proceso en el que la preparación automática de datos aprende de la forma en que se analizan los datos. Hágale preguntas y proporcione comentarios y más información siguiendo las instrucciones de la pantalla. Cuanto más interactúes con el tema, mejor preparado estará para responder a tus preguntas. 

Para obtener más información, consulte [https://docs.aws.amazon.com/quicksight/latest/user/quicksight-q-starting-from-sheets.html](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-q-starting-from-sheets.html). 

# Tipos visuales en Amazon Quick Sight
<a name="working-with-visual-types"></a>

Amazon Quick Sight ofrece una variedad de tipos visuales que puede utilizar para mostrar sus datos. Utilice los temas de esta sección para obtener más información sobre las capacidades de cada tipo de elemento visual.

**Topics**
+ [Medidas y dimensiones](#measures-and-dimensions)
+ [Límites de visualización](#display-limits)
+ [Ocultar o mostrar la categoría other](#other-category)
+ [Personalización del número de puntos de datos que se van a mostrar](#customizing-number-of-data-points)
+ [Uso AutoGraph](autograph.md)
+ [Uso de los gráficos de barras](bar-charts.md)
+ [Uso de gráficos de cajas](box-plots.md)
+ [Uso de gráficos combinados](combo-charts.md)
+ [Uso de contenido de elemento visual personalizado](custom-visual-content.md)
+ [Uso de gráficos de anillos](donut-chart.md)
+ [Uso de gráficos de embudo](funnel-charts.md)
+ [Uso de gráficos de medidor](gauge-chart.md)
+ [Uso de los mapas térmicos](heat-map.md)
+ [Uso de Highcharts](highchart.md)
+ [Uso de histogramas](histogram-charts.md)
+ [Uso de componentes de imagen](image-component.md)
+ [Uso KPIs](kpi.md)
+ [Uso de mapas de capas](layered-maps.md)
+ [Uso de gráficos de líneas](line-charts.md)
+ [Creación de mapas y gráficos geoespaciales](geospatial-charts.md)
+ [Uso de múltiplos pequeños](small-multiples.md)
+ [Uso de los gráficos circulares](pie-chart.md)
+ [Uso de tablas dinámicas](pivot-table.md)
+ [Uso de gráficos radiales](radar-chart.md)
+ [Uso de diagramas de Sankey](sankey-diagram.md)
+ [Uso de gráficos de dispersión](scatter-plot.md)
+ [Uso de tablas como elementos visuales](tabular.md)
+ [Uso de cuadros de texto](textbox.md)
+ [Uso de gráficos de rectángulos](tree-map.md)
+ [Uso de gráficos en cascada](waterfall-chart.md)
+ [Uso de nubes de palabras](word-cloud.md)

## Medidas y dimensiones
<a name="measures-and-dimensions"></a>

El término *medida* hace referencia a los valores numéricos que usamos para la medición, la comparación y la agregación en los elementos visuales. Una medida puede ser un campo numérico, como el costo del producto, o un agregado numérico en un campo de cualquier tipo de datos, como el recuento de transacciones IDs.

Usamos el término *dimensión* o *categoría* para hacer referencia a los campos de texto o de fecha que pueden ser elementos, como, por ejemplo, productos, o atributos relacionados con las medidas y que se pueden usar para dividirlos. Algunos ejemplos son la fecha de ventas para las cifras de ventas o el fabricante del producto para los números de satisfacción de los clientes. Amazon Quick Sight identifica automáticamente un campo como una medida o una dimensión en función de su tipo de datos. 

Los campos numéricos pueden actuar como dimensiones, por ejemplo, los códigos postales y la mayoría de los números de identificación. Durante la preparación de los datos resulta útil especificar el tipo de datos cadena para estos campos. De esta forma, Amazon Quick Sight entiende que deben tratarse como dimensiones y que no son útiles para realizar cálculos matemáticos. 

Puede cambiar si un campo se muestra como una dimensión o una medida de analysis-by-analysis forma individual. Para obtener más información, consulte [Campos como dimensiones y medidas](creating-a-visual.md#dimensions-and-measures).

## Límites de visualización
<a name="display-limits"></a>

Todos los tipos de elementos visuales limitan el número de puntos de datos que muestran, de forma que los elementos visuales (como líneas, barras o burbujas) siguen siendo fáciles de ver y analizar. El elemento visual selecciona el primer número de filas *n* para mostrar hasta el límite para ese tipo de elemento visual. La selección se hace en función del orden, si se ha aplicado alguno, o del predeterminado, en otro caso. 

El número de puntos de datos compatibles varía en función del tipo de elemento visual. Consulte el tema correspondiente sobre el tipo para obtener más información sobre los límites de visualización. 

El título del elemento visual identifica el número de puntos de datos mostrados si ha alcanzado el límite de visualización para ese tipo de elemento visual. Si tiene un conjunto de datos grande y desea evitar que se ejecuten en el límite de visualización del elemento visual, utilice uno o varios filtros para reducir la cantidad de datos mostrados. Para obtener más información sobre el uso de filtros con los elementos visuales, consulte [Filtrado de datos en Amazon Quick Sight](adding-a-filter.md).

Para los paneles y los análisis, Amazon Quick Sight admite lo siguiente:
+ 50 conjuntos de datos por panel
+ 20 hojas por panel
+ 30 objetos de visualización por hoja 

**nota**  
Amazon Quick Sight admite más de 30 *tipos visuales* diferentes (categorías de gráficos y visualizaciones, como gráficos de barras, gráficos circulares y gráficos de líneas). Cada hoja de análisis puede contener hasta 30 *instancias visuales* (objetos gráficos individuales) de cualquier combinación de tipos.

También puede optar por limitar la cantidad de puntos de datos que se muestran en el elemento visual antes de que se añadan a la categoría **otros**. Esta categoría contiene los datos agregados para todos los datos que estén más allá del límite de corte para el elemento visual que utilice, ya sea el que usted haya establecido o el basado en los límites de la visualización. Puede utilizar el menú visual para mostrar la categoría **otros**. La **otra** categoría no se muestra en los gráficos de dispersión, los mapas térmicos, los mapas, las tablas (informes tabulares) ni en los indicadores clave de rendimiento (KPIs). Tampoco se muestra en los gráficos de líneas cuando el eje x es una fecha. No es posible descomponer la categoría **other**. 

## Ocultar o mostrar la categoría other
<a name="other-category"></a>

Utilice el siguiente procedimiento para ocultar o mostrar la categoría “other”.

**Ocultación o visualización de la categoría “otros”**

1. En la página de análisis, seleccione el elemento visual que desea modificar.

1. Elija el menú del elemento visual seleccionando la esquina superior derecha del mismo y, a continuación, elija **Ocultar la categoría “otros”** o **Mostrar la categoría “otros”**, según corresponda.

## Personalización del número de puntos de datos que se van a mostrar
<a name="customizing-number-of-data-points"></a>

Puede elegir el número de puntos de datos que se muestran en el eje principal de algunos elementos visuales. Una vez que se muestra este número en el gráfico, los puntos de datos adicionales se incluyen en la categoría “otros”. Por ejemplo, si decide incluir 10 puntos de datos de un total de 200, 10 se muestran en el gráfico y 190 pasan a formar parte de la categoría “otros”.

Para buscar esta opción, elija el menú visual con forma de **v** y, a continuación, elija **Formato del elemento visual**. Puede utilizar la siguiente tabla para determinar qué cuadro de campo contiene la opción de punto de datos y qué número de puntos de datos muestra el elemento visual de forma predeterminada. 


| Tipo de elemento visual | Dónde encontrar la opción de punto de datos | Número predeterminado de puntos de datos | 
| --- | --- | --- | 
|  Gráfico de barras horizontales  |  **Eje Y**: **número de puntos de datos mostrados**  | 10 000 | 
|  Gráfico de barras verticales  |  **Eje X**: **número de puntos de datos mostrados**  | 10 000 | 
|  Gráfico combinado  |  **Eje X**: **número de puntos de datos mostrados**  | 2.500 | 
|  Mapa térmico  |  **Filas**: **número de filas mostradas** **Columnas**: **número de columnas mostradas**  | 100 | 
|  Gráfico de líneas  |  **Eje X**: **número de puntos de datos mostrados**  | 10 000 | 
|  Gráfico circular  |  **Grupo/color**: **número de sectores mostrados**  | 20 | 
|  Gráfico de rectángulos  |  **Agrupar por**: **número de cuadrados mostrados**  | 100 | 

# Uso AutoGraph
<a name="autograph"></a>

AutoGraph no es un tipo visual en sí mismo, sino que te permite decirle a Amazon Quick que elija el tipo visual por ti. Al crear un elemento visual seleccionando AutoGraph y, a continuación, seleccionando campos, Amazon Quick utiliza el tipo visual más adecuado para el número y los tipos de datos de los campos que seleccione.

## Creación de una imagen mediante AutoGraph
<a name="create-autograph"></a>

Utilice el siguiente procedimiento para crear una utilización visual AutoGraph.

**Para crear una imagen utilizando AutoGraph**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **de tipos visuales**, elija el AutoGraph icono.

1. En el panel **Lista de campos**, elija los campos que desea utilizar.

# Uso de los gráficos de barras
<a name="bar-charts"></a>

Amazon Quick admite los siguientes tipos de gráficos de barras, con orientación horizontal o vertical:
+ **Una medida**: los *gráficos de barras de una medida* muestran valores de una única medida de una dimensión. 
+ **Varias medidas**: los *gráficos de barras de varias medidas* muestran valores de varias medidas de una dimensión. 
+ **Agrupadas**: los *gráficos de barras agrupados* muestran los valores de una sola medida de una dimensión agrupados por otra dimensión. 
+ **Apiladas**: los *gráficos de barras apiladas* son similares a los gráficos de barras agrupadas, ya que muestran una medida para dos dimensiones. Sin embargo, en lugar de barras agrupadas por cada dimensión secundaria por dimensión principal, se muestra una barra por dimensión principal. Utiliza los bloques de color de las barras para mostrar los valores relativos de cada elemento en la dimensión secundaria. Los bloques de colores reflejan el valor de cada elemento de la dimensión secundaria con respecto al total de la medida. El gráfico de barras apiladas utiliza una escala basada en el valor máximo de la medida seleccionada. 
+ **Apiladas al 100 por ciento**: los *gráficos de barras apiladas al 100 por ciento* son similares a los gráficos de barras apiladas. Sin embargo, en un gráfico de barras apiladas al 100 por ciento, los bloques de colores reflejan el porcentaje de cada elemento de la dimensión secundaria sobre un 100 por ciento. 

Los gráficos de barras muestran hasta 10 000 puntos de datos en el eje para elementos visuales que no usan ningún grupo o color. En el caso de los elementos visuales que utilizan grupo o color, los gráficos muestran hasta 50 puntos de datos en el eje y un máximo de hasta 50 puntos de datos para grupo o color. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Creación de gráficos de barras de una sola medida
<a name="create-bar-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico de barras de una sola medida.

**Creación de un gráfico de barras de una sola medida**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas de la izquierda.

1. Elija **Agregar** en la barra de aplicaciones de la parte superior izquierda y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **de tipos visuales**, elija el icono del **gráfico de barras horizontales** o del **gráfico de barras verticales**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Eje X** o **Eje Y**.

1. Desde el panel **Lista de campos**, arrastre una medida hasta el cuadro de campo **Valor**.

## Creación de gráficos de barras de varias medidas
<a name="create-bar-chart-multi"></a>

Utilice el siguiente procedimiento para crear un gráfico de barras de varias medidas.

**Creación de un gráfico de barras de varias medidas**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas de la izquierda.

1. Elija **Agregar** en la barra de aplicaciones de la parte superior izquierda y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **de tipos visuales**, elija el icono **Gráfico de barras horizontales o Gráficos** **de barras verticales**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Eje X** o **Eje Y**.

1. Desde el panel **Lista de campos**, arrastre dos o más medidas hasta el cuadro de campo **Valor**.

## Creación de gráficos de barras agrupadas
<a name="create-bar-chart-clustered"></a>

Utilice el siguiente procedimiento para crear un gráfico de barras agrupadas.

**Creación de un gráfico de barras agrupadas**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas de la izquierda.

1. Elija **Agregar** en la barra de aplicaciones de la parte superior izquierda y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **de tipos visuales**, elija el icono **Gráfico de barras horizontales o Gráficos** **de barras verticales**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Eje X** o **Eje Y**.

1. Desde el panel **Lista de campos**, arrastre una medida hasta el cuadro de campo **Valor**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Grupo/color**.

## Creación de gráficos de barras apiladas
<a name="create-bar-chart-stacked"></a>

Utilice el siguiente procedimiento para crear un gráfico de barras apiladas.

**Creación de un gráfico de barras apiladas**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas de la izquierda.

1. Elija **Agregar** en la barra de aplicaciones de la parte superior izquierda y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **de tipos visuales**, elija el icono Gráfico de **barras apiladas horizontales o Gráfico** de **barras apiladas verticales**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Eje X** o **Eje Y**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Grupo/color**.

1. Desde el panel **Lista de campos**, arrastre una medida hasta el cuadro de campo **Valor**.

1. (Opcional) Añada etiquetas de datos y muestre los totales:

   1. En el menú de la parte superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

   1. En el panel **Elemento visual**, elija **Etiquetas de datos**.

   1. Mueva el conmutador para mostrar las etiquetas de datos.

      Las etiquetas de cada valor de medida aparecen en el gráfico y aparece la opción para mostrar los totales en el panel.

   1. Active la opción **Mostrar totales**.

      Se muestran los totales para cada barra del gráfico.

## Creación de gráficos de barras apiladas al 100 por ciento
<a name="create-bar-chart-stacked-100"></a>

Utilice el siguiente procedimiento para crear un gráfico de barras apiladas al 100 %.

**Creación de un gráfico de barras apiladas al 100 por ciento**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas de la izquierda.

1. Elija **Agregar** en la barra de aplicaciones de la parte superior izquierda y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel de **tipos visuales**, elija el icono Gráfico de barras **apilado al 100% horizontal o Gráfico de barras** **100% apilado verticalmente**.

1. Desde el panel **Lista de campos**, arrastre una dimensión hasta el cuadro de campo **Eje X** o **Eje Y**.

1. Desde el panel **Lista de campos**, arrastre dos o más medidas hasta el cuadro de campo **Valor**.

## Características del gráfico de barras
<a name="bar-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos de barras.


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí, con excepciones | Los gráficos de varias medidas y de barras agrupadas muestran una leyenda, pero no así los gráficos de barras horizontales de una sola medida. | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | Sí |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Mostrar u ocultar las líneas de los ejes, las líneas de cuadrícula, las etiquetas de los ejes y los iconos de ordenación de ejes | Sí |  | [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en cualquier barra del gráfico o excluirla, excepto cuando se utiliza un campo de fecha como dimensión para el eje. En ese caso, solo puede centrarse en una barra, no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md)  | 
| Ordenar | Sí | Puede ordenar según los campos que elija para el eje y los valores. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación al campo o campos que elija para el valor y no puede aplicar la agregación a los campos que elija para el eje o grupo/color. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose a los cuadros de campo de eje y Grupo/color. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Mostrar etiquetas de datos | Sí |  | [Etiquetas de datos en tipos visuales en Quick](customizing-visual-data-labels.md) | 
| Mostrar los totales del gráfico de barras apiladas | Sí | La visualización de los totales en un gráfico de barras apiladas solo está disponible cuando se muestran las etiquetas de datos. | [Gráficos de barras apiladas](#create-bar-chart-stacked) | 

# Uso de gráficos de cajas
<a name="box-plots"></a>

Los *gráficos de cajas*, también conocidos como gráficos de cajas y bigotes, muestran datos agrupados de varios orígenes en un único elemento visual, lo que le ayuda a tomar decisiones basadas en datos. Utilice gráficos de cajas para ver cómo se distribuyen los datos en un eje o a lo largo del tiempo, como, por ejemplo, los vuelos que se retrasan durante un período de 7 días. Por lo general, los gráficos de cajas detallan la información en cuartos:
+ **Mínimo**: punto de datos más bajo sin incluir los valores atípicos.
+ **Máximo**: punto de datos más alto sin incluir los valores atípicos.
+ **Mediana**: valor medio del conjunto de datos.
+ **Primer cuartil**: valor intermedio entre el número más pequeño y la mediana del conjunto de datos. El primer cuartil no incluye el mínimo ni la mediana.
+ **Tercer cuartil**: valor intermedio entre el número más alto y la mediana del conjunto de datos. El tercer cuartil no incluye el máximo ni la mediana.

Los *valores atípicos* son puntos de datos extremos que no se incluyen en el cálculo de los valores clave de los gráficos de cajas. Como los valores atípicos se calculan por separado, sus puntos de datos no aparecen inmediatamente después de crear el gráfico de cajas. Los gráficos de cajas muestran hasta 10 000 puntos de datos. Si un conjunto de datos contiene más de 10 000 puntos de datos, se mostrará una advertencia en la esquina superior derecha de la imagen.

Los gráficos de cajas admiten hasta cinco métricas y una agrupación, aunque no se representan si se proporcionan métricas duplicadas.

Los gráficos de cajas admiten algunos campos calculados, pero no todos. Los campos calculados que utilicen una función de ventana, por ejemplo, `avgOver`, generarán un error de SQL.

Los gráficos de cajas no son compatibles con MySQL 5.3 y con versiones anteriores.

**Creación de un elemento visual de gráfico de cajas básico**

1. Inicia sesión en Amazon Quick en[https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).

1. Abre Quick y selecciona **Análisis** en el panel de navegación de la izquierda.

1. Seleccione una de las siguientes opciones:
   + Para crear un análisis nuevo, elija **Nuevo análisis** en la parte superior derecha. Para obtener más información, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md). 
   + Para usar un análisis existente, elija los análisis que desea editar.

1. Elija **Agregar**, **Agregar elemento visual**.

1. En la parte inferior izquierda, seleccione el icono del diagrama de cajas en **Tipos de elementos visuales**.

1. En el panel **Lista de campos**, elija los campos que desee utilizar para los cuadros de campo apropiados. Los gráficos de cajas requieren al menos un campo de medida único.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales al cuadro del campo **Grupo/color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md).

   Para comprender las características que admiten los gráficos de cajas, consulte [Formato de análisis por tipo en Quick](analytics-format-options.md). Para obtener información sobre las opciones de personalización, consulte [Formatear en Amazon Quick](formatting-a-visual.md). 

# Uso de gráficos combinados
<a name="combo-charts"></a>

Mediante un gráfico combinado, puede crear una visualización que muestre dos tipos diferentes de datos, por ejemplo, tendencias y categorías. Los gráficos combinados también se conocen como gráficos de líneas y columnas (barras), porque combinan un gráfico de líneas con un gráfico de barras. Los gráficos de barras son útiles para comparar categorías. Tanto los gráficos de barras como los gráficos de líneas son útiles para mostrar los cambios a lo largo del tiempo, aunque los gráficos de barras deben mostrar una mayor diferencia entre los cambios. 

Amazon Quick admite los siguientes tipos de gráficos combinados:
+ **Gráficos combinados de barras agrupadas**: muestran conjuntos de barras de un solo color, donde cada conjunto representa una dimensión principal y cada barra representa una dimensión secundaria. Utilice este gráfico para facilitar la determinación de valores para cada barra.
+ **Gráficos combinados de barras apiladas**: muestran conjuntos de barras de varios colores, donde cada barra representa una dimensión principal y cada color representa una dimensión secundaria. Utilice este gráfico para facilitar la consulta de las relaciones entre las dimensiones secundarias dentro de una dimensión principal. Este gráfico muestra el valor total de la dimensión principal y cómo se agrega cada dimensión secundaria al valor total. Para determinar el valor de cada dimensión secundaria, el lector de gráficos debe comparar el tamaño de la sección de color con las etiquetas de datos de ese eje.

Ambos tipos de gráfico combinados solo necesitarán una dimensión en el **eje X**, pero también suelen ser más eficaces cuando se muestra al menos una medida bajo **Lines**. 

Utilice solo gráficos combinados si desea mostrar una relación entre las barras y las líneas. Una buena regla general es que si necesita explicar cómo se relacionan los dos tipos de gráficos, probablemente debería usar dos gráficos separados en su lugar. 

Dado que cada gráfico funciona de manera diferente, puede ser útil comprender los siguientes puntos antes de comenzar:
+ Los puntos de datos de cada serie se representan en diferentes escalas. Los gráficos combinados usan una escala basada en el valor máximo de la medida seleccionada. 
+ La distancia entre los números del eje no coincidirá entre las líneas y las barras, incluso si selecciona la misma escala para cada tipo de gráfico.
+ Para mayor claridad, intente usar unidades diferentes para la medida en cada serie de datos. 

El gráfico combinado es como usar dos diferentes tipos de visualización al mismo tiempo. Asegúrese de que los datos de las barras (o las columnas) hagan referencia directa a los datos de la línea o las líneas. Esta relación no la impone la herramienta técnicamente, por lo que resulta esencial que la determine. Sin una relación entre las líneas y las barras, el elemento visual pierde significado.

Puede utilizar el tipo de gráfico combinado visual para crear un gráfico de una única medida o línea. Los gráficos combinados de una única medida muestran una medida para una dimensión. 

Para crear un diagrama de varias mediciones, puede elegir añadir varias líneas o barras. Un gráfico de barras de varias medidas muestra dos o varias medidas para una dimensión. Puede agrupar las barras o apilarlas. 

Para las barras, utilice una dimensión para el eje y una medida para el valor. La dimensión suele ser un campo de texto que está relacionado con la medida de algún modo y se puede utilizar para segmentarla y ver información más detallada. Cada barra del gráfico representa un valor de medida para un elemento en la dimensión que elija. 

Las barras y líneas muestran hasta 2500 puntos de datos en el eje para elementos visuales que no usan grupo o color. En el caso de los elementos visuales que utilizan grupo o color, las barras muestran hasta 50 puntos de datos en el eje y hasta 50 puntos de datos para grupo o color, mientras que las líneas muestran hasta 200 puntos de datos en el eje y hasta 25 puntos de datos para el grupo o color. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los gráficos combinados
<a name="combo-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos combinados.


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí, con excepciones | Los gráficos combinados de varias medidas muestran una leyenda y los de medida única, no. | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | Sí | Puede definir el intervalo del eje. | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Mostrar u ocultar las líneas de los ejes, las líneas de cuadrícula, las etiquetas de los ejes y los iconos de ordenación de ejes | Sí |  | [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en cualquier barra del gráfico o excluirla, excepto cuando se utiliza un campo de fecha como dimensión para el eje. En ese caso, solo puede centrarse en una barra, no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí | Puede ordenar según los campos que elija para el eje y los valores. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación al campo o los campos que elija para el valor. No puede aplicar la agregación a los campos que elija para el valor o grupo/color. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose a los cuadros de campo de eje y Grupo/color. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Sincronizar el eje Y | Sí |  Sincronice los ejes Y de las barras y las líneas en un solo eje.   | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 

## Creación de un gráfico combinado
<a name="create-combo-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico combinado.

**Creación de un gráfico combinado**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija unos de los iconos de gráfico combinado.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico. Puede crear gráficos combinados del modo siguiente:
   + Elija una dimensión para el **eje X**.
   + Para crear un gráfico combinado de una sola medida, elija una medida para **Barras** o **Líneas**.
   + Para crear un gráfico combinado de varias medidas, elija dos o más medidas para el campo **Barras** o **Líneas**. 
   + Si lo prefiere, agregue una dimensión al campo **Grupo/color**. Si tiene un campo en **Grupo/color**, no puede tener más de un campo en **Barras**.  
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/combo-chart-example2-clustered.png)

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales a los cuadros de campo **Eje X** o **Grupo/color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

# Uso de contenido de elemento visual personalizado
<a name="custom-visual-content"></a>

Puede incrustar páginas web y vídeos, formularios e imágenes en línea en sus paneles rápidos mediante el tipo de gráfico de contenido visual personalizado.

Por ejemplo, puede incrustar la imagen del logotipo de su empresa en sus paneles. También puede incrustar un video en línea de la última conferencia de su organización, o bien incrustar un formulario en línea para preguntar a los lectores del panel si el panel les resulta útil.

Después de crear el contenido de elemento visual personalizado, podrá utilizar las acciones de navegación para navegar por él. También podrá utilizar parámetros para controlar qué se muestra.

A continuación se describen las limitaciones aplicables al contenido de elementos visuales personalizados:
+ Solo se admiten los esquemas de URL `https`.
+ Los informes por correo electrónico no admiten el contenido de elemento visual personalizado.
+ Las imágenes y los sitios web que utilizan la protección contra enlaces directos no se cargarán en los elementos visuales personalizados.

Para incrustar una página web, un vídeo, un formulario en línea o una imagen en su panel de control, elija el icono de contenido visual personalizado en el panel de **tipos visuales**.

Para obtener más información sobre cómo añadir elementos visuales a un panel, consulte [Adición de un elemento visual](creating-a-visual.md#create-a-visual).

Utilice los siguientes procedimientos para obtener información sobre cómo incrustar elementos visuales personalizadas en sus paneles.

## Prácticas recomendadas de utilización de contenido de elemento visual personalizado
<a name="custom-visual-content-best-practices"></a>

Al incrustar contenido web mediante el tipo de gráfico de contenido de elemento visual personalizado, se recomienda hacer lo siguiente:
+ Elija contenido web de fuentes que permitan ver o abrir el contenido en un IFrame. Si la fuente del contenido web no permite verlo o abrirlo en una versión rápida IFrame, el contenido no aparecerá en Quick, aunque la URL sea correcta.
+ Siempre que sea posible, utiliza los elementos embebibles URLs, especialmente para vídeos, formularios online, hojas de cálculo y documentos. Embeddable URLs crea una mejor experiencia para los lectores de tu panel de control y facilita la interacción con el contenido. Por lo general, puede encontrar la URL incrustable para el contenido cuando elige compartir el contenido del sitio web de origen.
+ Para incrustarlos de URLs forma interna URLs o propia, es posible que tengas que configurarlos para que se abran en un. IFrame
+ Cuando visualice contenido de elemento visual personalizado en un análisis o un panel de control, asegúrese de activar todas las cookies. Si las cookies de terceros están bloqueadas en su navegador, las imágenes que forman parte del sitio web y que están integradas en el elemento visual de contenido personalizado no se representan.
**nota**  
Chrome ha anunciado planes para dejar de utilizar todas las cookies de terceros para finales de 2024. Esto significa que los sitios web que estén integrados en las imágenes de contenido personalizado de Quick ya no mostrarán ningún contenido que dependa de cookies de terceros en Chrome. Para obtener más información sobre los planes de Chrome para dejar de utilizar las cookies de terceros, consulte [Chrome dará de baja las cookies de terceros](https://cloud.google.com/looker/docs/best-practices/chrome-third-party-cookie-deprecation).

## Incrustación de imágenes en un panel
<a name="custom-visual-content-image"></a>

Puede incrustar una imagen en línea en un panel mediante la URL de la imagen. Utilice el siguiente procedimiento para incrustar una imagen mediante el tipo de gráfico de contenido de elemento visual personalizado.

Las imágenes incrustadas no se mostrarán en los navegadores que tengan bloqueadas las cookies de terceros. Para ver las imágenes incrustadas en un panel, habilite las cookies de terceros en la configuración de su navegador.

**Incrustación de una imagen en un panel**

1. En el panel **Tipos de elementos visuales**, elija el icono de contenido visual personalizado.

1. En la imagen, elija **Personalizar elemento visual**.

1. En el panel **Propiedades** que se abrirá, en **Contenido personalizado**, introduzca la URL de la imagen que desea incrustar.

1. Seleccione **Aplicar**.

   La imagen se mostrará como una página web en la imagen.

1. Elija **Mostrar como imagen**.

   Si la URL es una imagen, la imagen aparecerá en la imagen.

   Si la URL no es una imagen, como, por ejemplo, una URL de una presentación de diapositivas, galería o página web, aparecerá el mensaje siguiente: `This URL doesn't appear to be an image. Update the URL to an image`. Para ello, abra la imagen que desea incrustar en una pestaña independiente del navegador o elija una URL incrustable para la imagen (que normalmente se encuentra cuando opta por compartir la imagen).

1. (Opcional) En **Opciones de tamaño de la imagen**, elija una de las opciones siguientes:
   + **Ajustar al ancho**: esta opción ajusta la imagen a la anchura del elemento visual.
   + **Ajustar a la altura**: esta opción ajusta la imagen a la altura del elemento visual.
   + **Ajustar al elemento visual**: esta opción escala la imagen a la anchura y altura del elemento visual. Esta opción puede deformar la imagen.
   + **No escalar**: esta opción mantiene la imagen en su escala original y no la ajusta a las dimensiones del elemento visual. Con esta opción, la imagen se centra en el elemento visual y se muestran las partes de la imagen que se ajustan a la anchura y altura del elemento visual. Es posible que algunas partes de la imagen no se muestren si el elemento visual es más pequeño que la imagen. Sin embargo, si la imagen es más grande que el elemento visual, esta se centra en el elemento visual rodeada de espacio en blanco.

## Incrustación de formularios en línea en un panel
<a name="custom-visual-content-form"></a>

Puede incrustar un formulario en línea en un panel mediante la URL incrustable. Utilice el siguiente procedimiento para incrustar un formulario en línea mediante el tipo de gráfico de contenido de elemento visual personalizado.

**Incrustación de un formulario en línea en un panel**

1. En el panel **Tipos de elementos visuales**, elija el icono de contenido visual personalizado.

1. En la imagen, elija **Personalizar elemento visual**.

1. En el panel **Propiedades** que se abrirá, en **Contenido personalizado**, introduzca la URL del formulario en línea que desea incrustar.

   Si es posible, utilice una URL incrustable para el formulario. Utilizar una URL incrustable mejora la experiencia de los lectores del panel que deseen interactuar con el formulario. A menudo, la URL incrustable se encuentra cuando se comparte el formulario en el sitio en el que se creó.

1. Seleccione **Aplicar**.

   El formulario se mostrará en el elemento visual.

## Incrustación de páginas web en un panel
<a name="custom-visual-content-webpage"></a>

Puede incrustar una página web en un panel mediante la URL. Utilice el siguiente procedimiento para incrustar una página web mediante el tipo de gráfico de contenido de elemento visual personalizado.

**Incrustación de una página web en un panel**

1. En el panel **Tipos de elementos visuales**, elija el icono de contenido visual personalizado.

1. En la imagen, elija **Personalizar elemento visual**.

1. En el panel **Propiedades** que se abrirá, en **Contenido personalizado**, introduzca la URL de la página web que desea incrustar.

1. Seleccione **Aplicar**.

   La página web se mostrará en el elemento visual.

## Incrustación de videos en línea en un panel
<a name="custom-visual-content-video"></a>

Puede incrustar un video en línea en un panel mediante la URL del video incrustable. Utilice el siguiente procedimiento para incrustar un video en línea mediante el tipo de gráfico de contenido de elemento visual personalizado.

**Incrustación de un video en línea en un panel**

1. En el panel **Tipos de elementos visuales**, elija el icono de contenido visual personalizado.

1. En la imagen, elija **Personalizar elemento visual**.

1. En el panel **Propiedades** que se abrirá, en **Contenido personalizado**, introduzca la URL incrustable del video que desea incrustar.

   Para encontrar la URL que se puede incrustar de un vídeo, comparte el vídeo y copia la URL de inserción del código. IFrame El siguiente es un ejemplo de una URL de inserción para un YouTube video:. `https://www.youtube.com/embed/uniqueid` Este sería un ejemplo de URL incrustable de un video de Vimeo: `https://player.vimeo.com/video/uniqueid`.

1. Seleccione **Aplicar**.

   El video se mostrará en el elemento visual.

# Uso de gráficos de anillos
<a name="donut-chart"></a>

Utilice gráficos de anillos para comparar los valores de los elementos en una dimensión. El mejor uso posible para este tipo de gráfico es mostrar un porcentaje de una cantidad total.

Cada cuña de un gráfico de anillos representa un valor de una dimensión. El tamaño de la cuña representa la proporción del valor para la medida seleccionada que el elemento representa en comparación con la totalidad de la dimensión. Los gráficos de anillos son óptimos cuando la precisión no es importante y hay tan solo algunos elementos en la dimensión.

Para aprender a usar los gráficos de anillos en Amazon Quick, puedes ver este vídeo:

[![AWS Videos](http://img.youtube.com/vi/vR6H4bXaRBY/0.jpg)](http://www.youtube.com/watch?v=vR6H4bXaRBY)


Para crear un gráfico de anillos, utilice una dimensión en el cuadro del campo **Grupo/color**. Con solo un campo, el gráfico muestra la división de valores por número de filas. Para mostrar la división de valores de dimensión por un valor de métrica, puede agregar un campo de métrica al cuadro del campo **Valor**. 

Los gráficos de anillos muestran hasta 20 puntos de datos para grupo/color. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los gráficos de anillos
<a name="donut-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos de anillos.


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No aplicable |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en una cuña de un gráfico de anillos o excluirla, excepto cuando utiliza un campo de fecha como una dimensión. En ese caso, solo puede centrarse en una cuña, no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí | Puede ordenar los campos que elija para el valor o el grupo o color. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación al campo que elija para el valor y no puede aplicar la agregación al campo que elija para grupo o color. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose al cuadro de campo Grupo/color. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Selección del tamaño | Sí | Puede elegir el grosor del gráfico de anillos: pequeño, mediano o grande. | [Formatear en Amazon Quick](formatting-a-visual.md) | 
| Mostrar totales | Sí | Puede elegir mostrar u ocultar la suma del campo Valor. De forma predeterminada, se muestra el recuento total del campo Grupo/color o la suma total del campo Valor. | [Formatear en Amazon Quick](formatting-a-visual.md) | 

## Creación de un gráfico de anillos
<a name="create-donut-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico anillos.

**Creación de un gráfico de anillos**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija el icono de gráfico de anillos.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.

   Para crear un gráfico de anillos, arrastre una dimensión al cuadro del campo **Grupo/color**. Si lo desea, arrastre una medida al cuadro del campo **Valor**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales al cuadro del campo **Grupo/color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

# Uso de gráficos de embudo
<a name="funnel-charts"></a>

Utilice un gráfico de embudo para visualizar datos que atraviesan varias etapas de un proceso lineal. En los gráficos de embudo, cada etapa del proceso se representa en bloques de diferentes formas y colores. La primera etapa, que se conoce como *cabeza*, es el bloque más grande y le siguen las etapas más pequeñas, conocidas como *cuello*, en forma de embudo. El tamaño del bloque que representa cada etapa en un gráfico de embudo es un porcentaje del total y es proporcional a su valor. Cuanto mayor sea el tamaño del bloque, mayor será su valor.

Los gráficos de embudo suelen ser útiles en contextos empresariales, ya que permiten ver las tendencias o las posibles áreas problemáticas de cada etapa, como, por ejemplo, los cuellos de botella. Estos gráficos pueden ayudarle a visualizar el importe de los ingresos potenciales de cada etapa de una venta, desde el primer contacto hasta la venta final y, posteriormente, durante el mantenimiento. 

**Creación de un elemento visual de gráfico de embudos básico**

1. Abre Amazon Quick y selecciona **Analyses** en el panel de navegación de la izquierda.

1. Seleccione una de las siguientes opciones:
   + Para crear un análisis nuevo, elija **Nuevo análisis** en la parte superior derecha. Para obtener más información, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md). 
   + Para usar un análisis existente, elija el análisis que desea editar.

1. Elija **Añadir (\$1), Añadir elemento visual**.

1. En la parte inferior izquierda, seleccione el icono del gráfico de embudos de **Tipos de elementos visuales**.

1. En el panel **Lista de campos**, elija los campos que desee utilizar para los cuadros de campo apropiados. Los gráficos de embudo requieren una dimensión en **Grupo**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales al cuadro del campo **Grupo/color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md).

   Para comprender las características que admiten los gráficos de embudo, consulte [Formato de análisis por tipo en Quick](analytics-format-options.md). Para obtener información sobre las opciones de personalización, consulte [Formatear en Amazon Quick](formatting-a-visual.md). 

# Uso de gráficos de medidor
<a name="gauge-chart"></a>

Utilice gráficos de medición para comparar los valores de los elementos de una medida. Puede compararlos con otra medida o con una cantidad personalizada.

Un gráfico de medidor es similar a un medidor no digital, como, por ejemplo, el indicador de gasolina de un automóvil. Muestra la cantidad que hay de lo que está midiendo. En un gráfico de medición, esta medida puede existir sola o estar relacionada con otra. Cada sección de color de un gráfico de medición representa un valor. En el siguiente ejemplo, comparamos las ventas reales con el objetivo de ventas y el indicador nos dice que debemos vender un 33,27 % más para satisfacer el objetivo. 

Para aprender a usar los gráficos de indicadores en Amazon Quick, puedes ver este vídeo:

[![AWS Videos](http://img.youtube.com/vi/03gYx4-iGak/0.jpg)](http://www.youtube.com/watch?v=03gYx4-iGak)


Para crear un gráfico de medición, tendrá que utilizar al menos una medida. Coloque la medida en el cuadro del campo **Valor**. Si desea comparar dos medidas, coloque la medida adicional en el cuadro del campo **Valor de destino**. Si desea comparar una única medida con un valor de destino que no está en el conjunto de datos, puede utilizar un campo calculado que contenga un valor fijo. 

Puede elegir varias opciones para el gráfico de medición, incluidos los siguientes ajustes de **Formato del elemento visual**.
+ ****Valor mostrado****: permite ocultar el valor, mostrar el valor real o mostrar una comparación de dos valores.
+ ****Método de comparación****: permite comparar valores como porcentaje, como la diferencia real entre los valores o la diferencia como porcentaje.
+ ****Estilo del eje****: 
  + **Mostrar la etiqueta de eje**: permite mostrar u ocultar la etiqueta del eje.
  + **Intervalo**: intervalo numérico mínimo y máximo que se muestra en el gráfico de medidor.
  + **Reservar relleno (%)**: se añade a la parte superior del intervalo (destino, valor real o máximo).
+ ****Estilo del arco****: grados del arco (de 180º a 360º).
+ ****Grosor****: grosor del arco (pequeño, mediano o grande).

## Características de los gráficos de medidor
<a name="gauge-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos de medición.


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Formatear medidor | Sí | Puede personalizar el valor que se muestra, el método de comparación, el estilo del eje, el estilo de arco y el grosor del medidor. |  | 
| Cambiar el intervalo del eje | No |  |  | 
| Cambiar los colores del elemento visual | Sí | El color del primer plano del área rellena, representa el valor del campo Valor. El color de fondo del área sin rellenar; representa el valor del campo Valor de destino si se ha seleccionado uno. | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | No |  |  | 
| Ordenar | No |  | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí |  | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | No |  |  | 

## Creación de un gráfico de medidor
<a name="create-gauge-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico de medición.

**Creación de un gráfico de medidor**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija el icono de gráfico de medición.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Para crear un gráfico de medición, arrastre una medida al cuadro del campo **Valor**. Para añadir un valor de comparación, arrastre otra medida al cuadro del campo **Valor de destino**.

# Uso de los mapas térmicos
<a name="heat-map"></a>

Utilice mapas térmicos para mostrar una medida para la intersección de dos dimensiones, con codificación de colores para diferenciar fácilmente los valores cuando se encuentran dentro del intervalo. Los mapas térmicos también pueden utilizarse para mostrar el recuento de valores para la intersección de las dos dimensiones.

Cada rectángulo de un mapa térmico representa el valor para la medida especificada para la intersección de las dimensiones seleccionadas. El color del rectángulo representa el lugar en el que el valor se inscribe en el intervalo de la medida, con colores más oscuros para indicar los valores más elevados y más claros para indicar los más bajos.

Los mapas térmicos y las tablas dinámicas muestran los datos en un formato tabular similar. Utilice un mapa térmico si desea identificar las tendencias y los casos atípicos, ya que el uso de color permite detectarlos con mayor facilidad. Utilice una tabla dinámica si desea analizar en mayor profundidad los datos del elemento visual, por ejemplo, cambiando el orden de clasificación de columnas o aplicando las funciones de agregación a través de las filas o columnas.

Para crear un mapa térmico, elija al menos dos campos de cualquier tipo de datos. Amazon Quick rellena los valores del rectángulo con el recuento del valor del eje x para el valor del eje y que se cruza. Normalmente, puede elegir una medida y dos dimensiones.

Los mapas térmicos muestran hasta 50 puntos de datos para las filas y hasta 50 puntos de datos para las columnas. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los mapas térmicos
<a name="heat-map-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los mapas térmicos.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No aplicable |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Cambiar los colores del elemento visual | No |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en un rectángulo de un mapa térmico o excluirlo, excepto cuando se utiliza un campo de fecha como la dimensión de las filas. En ese caso, solo puede centrarse en un rectángulo, no excluirlo. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí | Puede ordenar por los campos que elija para las columnas y los valores. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación a los campos que elija para el valor, y no puede aplicar la agregación a los campos que elija para las filas o columnas. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose a los cuadros de campo Filas y Columnas. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Formato condicional | No |  | [Formato condicional en tipos visuales en Quick](conditional-formatting-for-visuals.md) | 

## Creación de un mapa térmico
<a name="create-heat-map"></a>

Utilice el siguiente procedimiento para crear un mapa térmico.

**Creación de un mapa térmico**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Visual types**, elija el icono de mapa térmico.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.

   Para crear un mapa térmico, arrastre una dimensión al cuadro de campo **Filas**, una dimensión al cuadro de campo **Columnas** y una medida al cuadro de campo **Valores**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales a los cuadros de campo **Filas** o **Columnas**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

# Uso de Highcharts
<a name="highchart"></a>

Use elementos visuales de Highcharts para crear elementos visuales y tipos de gráficos personalizados que utilicen la [Biblioteca de Highcharts Core](https://www.highcharts.com/blog/products/highcharts/). [Las imágenes de Highcharts proporcionan a los autores de Quick acceso directo a la API de Highcharts.](https://api.highcharts.com/highcharts/)

Para configurar una imagen de Highcharts, los autores de Quick deben añadir un esquema JSON de Highcharts a la imagen de Quick. Los autores pueden usar expresiones rápidas para hacer referencia a los campos rápidos y las opciones de formato del esquema JSON que utilizan para generar la imagen de Highcharts. El editor **Código del gráfico** JSON proporciona asistencia contextual para el autocompletado y la validación en tiempo real a fin de garantizar que los esquemas JSON de entrada estén configurados correctamente. Para mantener la seguridad, el editor visual de Highcharts no acepta la entrada de código CSS o HTML. JavaScript

Para obtener más información sobre las imágenes de Highcharts en Amazon Quick, consulte la Guía [visual QuickStart de Highcharts](https://democentral.learnquicksight.online/#Dashboard-FeatureDemo-Highcharts-Visual) en. [DemoCentral](https://democentral.learnquicksight.online/#)

La siguiente imagen muestra un gráfico de pintalabios configurado en el editor JSON de **código gráfico** de una imagen de Highcharts en Quick.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/highcharts-example1.png)


[Para ver más ejemplos de imágenes que puede crear con la imagen de Highcharts en Quick, consulte las demostraciones de Highcharts.](https://www.highcharts.com/demo)

## Consideraciones
<a name="highchart-considerations"></a>

Antes de empezar a crear imágenes de Highcharts en Amazon Quick, revise las siguientes limitaciones que se aplican a las imágenes de Highcharts.
+ Los siguientes valores JSON no se admiten en el editor JSON **Código del gráfico** de Highcharts:
  + Funciones
  + Fechas
  + Valores indefinidos
+ Los enlaces a archivos GeoJSON u otras imágenes no son compatibles con los elementos visuales de Highcharts.
+ Los colores de campos no están disponibles para los elementos visuales de Highcharts. Los colores de temas predeterminados se aplican a todos los elementos visuales de Highcharts.

## Creación de un elemento visual de Highcharts
<a name="highchart-create"></a>

Utilice el siguiente procedimiento para crear una imagen de Highcharts en Amazon Quick.

1. Abra la [consola Quick.](https://quicksight.aws.amazon.com/)

1. Abra el análisis rápido al que desee añadir una imagen de Highcharts.

1. En la barra de aplicaciones, elija **Agregar** y, a continuación, elija **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija el icono de elemento visual de Highcharts. Aparece un elemento visual vacío en la hoja de análisis y el panel **Propiedades** se abre a la izquierda.

1. En el panel **Propiedades**, expanda la sección **Configuración de visualización** y lleve a cabo las siguientes acciones:

   1. En **Editar título**, elija el icono del pincel, ingrese el título que desee que tenga el elemento visual y, a continuación, seleccione **GUARDAR**. También puede elegir el icono con forma de globo ocular para ocultar el título.

   1. (Opcional) En **Editar subtítulo**, elija el icono del pincel, ingrese el subtítulo que desee que tenga el elemento visual y, a continuación, seleccione **GUARDAR**. También puede elegir el icono con forma de globo ocular para ocultar el subtítulo.

   1. (Opcional) En **Texto alternativo**, agregue el texto alternativo que desea que aparezca en el elemento visual.

1. Expanda la sección **Límite de puntos de datos**. En **Número de puntos de datos a mostrar**, ingrese el número de puntos de datos que desea que se muestren en el elemento visual. Los elementos visuales de Highcharts pueden mostrar hasta 10 000 puntos de datos.

1. Amplíe la sección **de códigos de gráficos**.

1. Ingrese un esquema JSON en el editor JSON **Código del gráfico**. El editor proporciona asistencia contextual y validación en tiempo real para garantizar que los valores JSON de entrada estén configurados correctamente. Todos los errores que Quick identifique se pueden ver en el menú desplegable **Errores**. En el siguiente ejemplo se muestra un esquema JSON que crea un gráfico de barras que muestra las ventas del año actual por sector.

   ```
   {
     "xAxis": {
       "categories": ["getColumn", 0]
     },
     "yAxis": {
       "min": 0,
       "title": {
         "text": "Amount ($)"
       }
     },
     "tooltip": {
       "headerFormat": "<span style='font-size:10px'>{point.key}</span><table>",
       "pointFormat": "<tr><td style='color:{series.color};padding:0'>{series.name}: </td><td style='padding:0'><b>${point.y:,.0f}</b></td></tr>",
       "footerFormat": "</table>",
       "shared": true,
       "useHTML": true
     },
     "plotOptions": {
       "column": {
         "borderWidth": 0,
         "grouping": false,
         "shadow": false
       }
     },
     "series": [
       {
         "type": "column",
         "name": "Current Year Sales",
         "color": "rgba(124,181,236,1)",
         "data": ["getColumn", 1],
         "pointPadding": 0.3,
         "pointPlacement": 0.0
       }
     ]
   }
   ```

1. Elija **APLICAR CÓDIGO**. Quick convierte el esquema JSON en un elemento visual que aparece en el análisis. Para hacer cambios en el elemento visual renderizado, actualice las propiedades correspondientes en el esquema JSON y elija **APLICAR CÓDIGO**.

1. (Opcional) Abra el menú desplegable **Referencia** para acceder a los enlaces de material de referencia útil de Highcharts.

Cuando le satisfaga el elemento visual renderizado, cierre el panel Propiedades. Para obtener más información sobre las expresiones específicas de Quick Sight que se pueden utilizar para configurar una imagen de Highcharts, consulte[Lenguaje de expresión Amazon Quick JSON para imágenes de Highcharts](highchart-expressions.md).

## Características interactivas de Highcharts
<a name="interactive-features"></a>

Las visualizaciones de Highchart en Amazon Quick Sight admiten acciones personalizadas, resaltados y consistencias de color de campos personalizadas, lo que le permite crear gráficos interactivos y visualmente cohesivos que se integran perfectamente con otros elementos visuales de Quick Sight.

### Acciones personalizadas
<a name="custom-actions-feature"></a>

Con las acciones personalizadas, puede definir comportamientos específicos para cualquier punto de datos de sus visualizaciones de Highcharts. Esta función se integra perfectamente con el marco de acción existente de Quick Sight, lo que le permite crear gráficos interactivos que responden a los clics de los usuarios. Actualmente, el sistema admite la selección de puntos de datos únicos, lo que le permite controlar con precisión las interacciones de los usuarios. Las acciones personalizadas se pueden implementar en varios tipos de gráficos, como gráficos de líneas, de barras y de barras apiladas, entre otros.

Para implementar acciones personalizadas, tendrá que modificar la configuración de JSON de Highcharts. Para agregar un bloque de eventos a la configuración de su serie, especifique el evento de clic y la acción correspondiente. Por ejemplo:

```
{
  "series": [{
    "type": "line",
    "data": ["getColumn", 1],
    "name": "value",
    "events": {
      "click": [
        "triggerClick", { "rowIndex": "point.index" }
      ]
    }
}]
```

Esta configuración permite realizar eventos de clic en los puntos de datos del gráfico, lo que permite a Quick Sight gestionar acciones personalizadas en función de los datos seleccionados.

### Resaltado entre elementos visuales
<a name="visual-highlighting-feature"></a>

El resaltado entre elementos visuales mejora la interactividad de los paneles al crear conexiones visuales entre los distintos gráficos. Cuando un usuario selecciona elementos en un gráfico, los elementos relacionados de otras imágenes se resaltan automáticamente, mientras que los elementos no relacionados se atenúan. Esta característica ayuda a los usuarios a identificar rápidamente las relaciones y los patrones en múltiples visualizaciones, lo que mejora la comprensión y el análisis de los datos.

Para habilitar el resaltado entre elementos visuales y mantener la coherencia en el color de los campos, use la cláusula `quicksight` en la configuración de JSON de Highcharts. Esta cláusula actúa como un puente entre la representación de Highcharts y el sistema de interacción visual de Quick. A continuación se muestra un ejemplo de cómo configurarlo:

```
{
  "quicksight": {
    "pointRender": ["updatePointAttributes", {
      "opacity": ["case", 
        ["dataMarkMatch", ["getColumnName", 0], "series.name"],
        1,  // Full opacity for matching elements
        0.1 // Dim non-matching elements
      ],
      "color": ["getColumnColorOverrides", ["getColumnName", 0], "series.name"]
    }]
  }
}
```

Esta configuración utiliza el lenguaje de expresiones JSON de Quick Sight para modificar dinámicamente propiedades visuales como la opacidad y el color en función de las interacciones del usuario y los esquemas de color predefinidos.

Para escenarios más complejos, puede configurar el resaltado en función de varias condiciones. Esto permite una interactividad más matizada en sus visualizaciones. En el siguiente ejemplo se resaltan los elementos según el trimestre o el día de la semana:

```
{
  "quicksight": {
    "pointRender": ["updatePointAttributes", {
      "opacity": ["case",
        ["||",
          ["dataMarkMatch", "quarter", "series.name"],
          ["dataMarkMatch", "day_of_week", "point.name"]
        ],
        1,  // Full opacity for matching elements
        0.1 // Dim non-matching elements
      ],
    }]
  }
}
```

### Coherencia de color en los campos
<a name="field-color-feature"></a>

Mantener la coherencia visual en todo el panel es crucial para interpretar los datos de forma eficaz. La característica de coherencia de color en los campos garantiza que los colores asignados a dimensiones específicas persistan en todos los elementos visuales del panel. Esta coherencia ayuda a los usuarios a reconocer determinadas categorías de datos en distintos tipos de gráficos y vistas y hacer un seguimiento de estas, lo que mejora la experiencia general del usuario y la comprensión de los datos.

# Lenguaje de expresión Amazon Quick JSON para imágenes de Highcharts
<a name="highchart-expressions"></a>

Los elementos visuales de Highcharts aceptan la mayoría de los [valores JSON válidos](https://www.w3schools.com/js/js_json_datatypes.asp), operadores aritméticos estándar, operadores de cadenas y operadores condicionales. Los siguientes valores de JSON no son compatibles con los elementos visuales de Highcharts:
+ Funciones
+ Fechas
+ Valores indefinidos

Los autores rápidos pueden usar el lenguaje de expresiones JSON y crear esquemas JSON para crear imágenes de Highcharts. El lenguaje de expresiones JSON se usa para vincular JSON a conjuntos de datos APIs o conjuntos de datos para permitir la población y modificación dinámicas de las estructuras JSON. Los desarrolladores también pueden usar el lenguaje de expresión JSON para inflar y transformar los datos JSON con expresiones concisas e intuitivas.

Con el lenguaje de expresión JSON, las expresiones se representan como matrices, donde el primer elemento especifica la operación y los elementos siguientes son los argumentos. Por ejemplo, `["unique", [1, 2, 2]]` aplica la operación `unique` a la matriz `[1, 2, 2]` y da como resultado `[1, 2]`. Esta sintaxis basada en matrices permite expresiones flexibles que permiten transformaciones complejas en datos JSON.

El lenguaje de expresión JSON admite *expresiones anidadas*. Las expresiones anidadas son expresiones que contienen otras expresiones como argumentos. Por ejemplo, `["split", ["toUpper", "hello world"], " "]` convierte primero la cadena `hello world` en mayúscula y, a continuación, la divide en una matriz de palabras, lo que da como resultado `["HELLO", "WORLD"]`.

Utilice las siguientes secciones para obtener más información sobre el lenguaje de expresiones JSON para las imágenes de Highcharts en Amazon Quick.

**Topics**
+ [Aritmética](jle-arithmetics.md)
+ [Operaciones de matriz](jle-arrays.md)
+ [Expresiones rápidas de Amazon](jle-qs-expressions.md)

# Aritmética
<a name="jle-arithmetics"></a>

En la siguiente tabla se muestran las expresiones aritméticas que se pueden utilizar con el lenguaje de expresión JSON.


| Operación | Expression | Input | Output | 
| --- | --- | --- | --- | 
| Suma | ["\$1", operand1, operand2] | \$1 sum: ["\$1", 2, 4] \$1 | \$1 sum: 6 \$1 | 
| Resta | ["-", operand1, operand2] | \$1 difference: ["-", 10, 3] \$1 | \$1 difference: 7 \$1 | 
| Multiplicación | ["\$1", operand1, operand2] | \$1 product: ["\$1", 5, 6] \$1 | \$1 product: 30 \$1 | 
| División | ["/", operand1, operand2] | \$1 quotient: ["/", 20, 4] \$1 | \$1 quotient: 5 \$1 | 
| Módulo | ["%", operand1, operand2] | \$1 remainder: ["%", 15, 4] \$1 | \$1 remainder: 3 \$1 | 
| Potencia | ["\$1\$1", base, exponent] | \$1 power: ["\$1\$1", 2, 3] \$1 | \$1 power: 8 \$1 | 
| Valor absoluto | ["abs", operand] | \$1 absolute: ["abs", -5] \$1 | \$1 absolute: 5 \$1 | 
| Square Root (Raíz cuadrada) | ["sqrt", operand] | \$1 sqroot: ["sqrt", 16] \$1 | \$1 sqroot: 4 \$1 | 
| Logaritmo (base 10) | ["log10", operand] | \$1 log: ["log10", 100] \$1 | \$1 log: 2 \$1 | 
| Logaritmo natural | ["ln", operand] | \$1 ln: ["ln", Math.E] \$1 | \$1 ln: 1 \$1 | 
| Redondeo | ["round", operand] | \$1 rounded: ["round", 3.7] \$1 | \$1 rounded: 4 \$1 | 
| Techo | ["floor", operand] | \$1 floor: ["floor", 3.7] \$1 | \$1 floor: 3 \$1 | 
| Suelo | ["ceil", operand] | \$1 ceiling: ["ceil", 3.2] \$1 | \$1 ceiling: 4 \$1 | 
| Seno | ["sin", operand] | \$1 sine: ["sin", 0] \$1 | \$1 sine: 0 \$1 | 
| Coseno | ["cos", operand] | \$1 cosine: ["cos", 0] \$1 | \$1 cosine: 1 \$1 | 
| Tangente | ["tan", operand] | \$1 tangent: ["tan", Math.PI] \$1 | \$1 tangent: 0 \$1 | 

# Operaciones de matriz
<a name="jle-arrays"></a>

El lenguaje de expresión JSON permite la manipulación genérica de matrices para las siguientes funciones:
+ `map`: aplica una función de asignación a cada elemento de una matriz y devuelve una nueva matriz con los valores transformados.

  Por ejemplo, `["map", [1, 2, 3], ["*", ["item"], 2]]` asigna cada elemento de la matriz `[1, 2, 3]` al multiplicarlo por 2.
+ `filter`: filtra una matriz en función de una condición dada y devuelve una nueva matriz que contiene solo los elementos que cumplen la condición

  Por ejemplo, `["filter", [1, 2, 3, 4, 5], ["==", ["%", ["item"], 2], 0]]` filtra la matriz `[1, 2, 3, 4, 5]` para incluir solo los números pares.
+ `reduce`: reduce una matriz a un valor único al aplicar una función reductora a cada elemento y acumular el resultado.

  Por ejemplo, `["reduce", [1, 2, 3, 4, 5], ["+", ["acc"], ["item"]], 0]` reduce la matriz `[1, 2, 3, 4, 5]` a la suma de sus elementos.
+ `get`: recupera un valor de un objeto o una matriz al especificar una clave o un índice.

  Por ejemplo, `["get", ["item"], "name"]` recupera el valor de la propiedad `"name"` del elemento actual.
+ `unique`: dada una matriz, solo devuelve elementos únicos dentro de esta matriz.

  Por ejemplo, `["unique", [1, 2, 2]]` devuelve `[1, 2]`.

# Expresiones rápidas de Amazon
<a name="jle-qs-expressions"></a>

Amazon Quick ofrece expresiones adicionales para mejorar la funcionalidad de las imágenes de Highcharts. Utilice las siguientes secciones para obtener más información sobre las expresiones rápidas más comunes para las imágenes de Highcharts. Para obtener más información sobre el lenguaje de expresiones JSON en Amazon Quick, consulte la [ QuickStart Guía visual de Highcharts](https://democentral.learnquicksight.online/#Dashboard-FeatureDemo-Highcharts-Visual) en [DemoCentral](https://democentral.learnquicksight.online/#).

**Topics**
+ [`getColumn`](#highcharts-expressions-getcolumn)
+ [`formatValue`](#highcharts-expressions-formatvalue)

## `getColumn`
<a name="highcharts-expressions-getcolumn"></a>

Utilice las expresiones `getColumn` para devolver valores de índices de columnas específicos. Por ejemplo, en la siguiente tabla se muestra una lista de productos junto con su categoría y precio.


| Product name (Nombre del producto) | Categoría | Precio | 
| --- | --- | --- | 
|  Producto A  |  Tecnología  |  100  | 
|  Producto B  |  Venta minorista  |  50  | 
|  Producto C  |  Venta minorista  |  75  | 

La siguiente consulta `getColumn` genera una matriz que muestra todos los nombres de los productos junto con su precio.

```
{
	product name: ["getColumn", 0], 
	price: ["getColumn", 2]
}
```

Se devuelve el siguiente JSON:

```
{
	product name: ["Product A", "Product B", "Product C"],
	price: [100, 50, 75]
}
```

También puede pasar varias columnas a la vez para generar una matriz de matrices, como se muestra en el siguiente ejemplo.

**Entrada**

```
{
	values: ["getColumn", 0, 2]
}
```

**Salida**

```
{
	values: [["Product A", 100], ["Product B", 50], ["Product C", 75]]
}
```

De forma similar a `getColumn`, se pueden usar las siguientes expresiones para devolver valores de columnas de temas o pozos de campos:
+ `getColumnFromGroupBy` devuelve las columnas del grupo por campo. El segundo argumento es el índice de la columna que se devolverá. Por ejemplo, `["getColumnFromGroupBy", 0]` devuelve los valores del primer campo en forma de matriz. Puede pasar varios índices para obtener una matriz de matrices en la que cada elemento corresponda al campo del grupo por pozo de campos.
+ `getColumnFromValue` devuelve columnas del pozo de campos de valores. Puede pasar varios índices para obtener una matriz de matrices en la que cada elemento corresponda al campo del pozo de campos de valores.
+ `getColorTheme`devuelve la paleta de colores actual de un tema rápido, como se muestra en el siguiente ejemplo.

  ```
  {
  "color": ["getColorTheme"]
  }
  ```

  ```
  {
  "color": ["getPaletteColor", "secondaryBackground"]
  }
  ```

**Ejemplo**

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/get-column-example.png)


`getColumn` puede acceder a cualquier columna de la tabla:
+ `["getColumn", 0]`: devuelve una matriz `[1, 2, 3, 4, 5, ...]`
+ `["getColumn", 1]`: devuelve una matriz `[1, 1, 1, 1, 1, ...]`
+ `["getColumn", 2]`: devuelve una matriz `[1674, 7425, 4371, ...]`

`getColumnFromGroupBy` funciona de manera similar, pero su índice se limita a las columnas del grupo por pozo de campos:
+ `["getColumnFromGroupBy", 0]`: devuelve una matriz `[1, 2, 3, 4, 5, ...]`
+ `["getColumnFromGroupBy", 1]`: devuelve una matriz `[1, 1, 1, 1, 1, ...]`
+ `["getColumnFromGroupBy", 2]`: no funciona, ya que solo hay dos columnas en el grupo por pozo de campos

`getColumnFromValue` funciona de manera similar, pero su índice se limita a las columnas del pozo de campos de valores:
+ `["getColumnFromValue", 0]`: devuelve una matriz `[1, 2, 3, 4, 5, ...]`
+ `["getColumnFromValue", 1]`: no funciona, ya que solo hay una columna en el pozo de campos de valores
+ `["getColumnFromValue", 2]`: no funciona, ya que solo hay una columna en el pozo de campos de valores

## `formatValue`
<a name="highcharts-expressions-formatvalue"></a>

Use la `formatValue` expresión para aplicar un formato rápido a los valores. Por ejemplo, la siguiente expresión formatea la etiqueta del eje x con el valor de formato especificado en el primer campo de Quick field wells.

```
 "xAxis": {
		"categories": ["getColumn", 0],
		"labels": {
		"formatter": ["formatValue", "value", 0]
		}
	}
```

# Uso de histogramas
<a name="histogram-charts"></a>

Utilice un gráfico de histograma en Amazon Quick para mostrar la distribución de los valores numéricos continuos en los datos. Amazon Quick utiliza histogramas no normalizados, que utilizan un recuento absoluto de los puntos de datos o eventos de cada contenedor.

Para crear un histograma, se utiliza una medida. Un nuevo histograma muestra inicialmente diez *bins* (también llamados *buckets*) en el eje X. Aparecen como barras en el gráfico. Puede personalizar los bins para que se adapten a su conjunto de datos. El eje Y muestra la cantidad absoluta de los valores de cada bin.

Asegúrese de ajustar la configuración de formato para que tenga una forma claramente identificable. Si los datos contienen valores atípicos, esto queda claro si detecta uno o más valores al lado del eje X. Para obtener información sobre cómo gestiona Amazon Quick los datos que no cumplen los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los histogramas
<a name="histogram-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los histogramas.


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | No |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No | Sin embargo, puede cambiar la cantidad de bin o el ancho del intervalo de bin (intervalo de distribución). |  | 
| Mostrar u ocultar las líneas de los ejes, las líneas de cuadrícula, las etiquetas de los ejes y los iconos de ordenación de ejes | Sí |  | [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | No |  |  | 
| Ordenar | No |  |  | 
| Realización de la agregación de campos | No | Los histogramas utilizan solo la agregación de recuento. |  | 
| Añadir desgloses | No |  |  | 

## Creación de un histograma
<a name="create-histogram-chart"></a>

Utilice el siguiente procedimiento para crear un histograma.

**Creación de un histograma**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **de tipos visuales**, elija el icono del histograma.

1. En el panel **Lista de campos**, elija el campo que desee utilizar en el campo **Valor**. Un agregado de **Recuento** se aplica automáticamente al valor. 

   El histograma resultante muestra lo siguiente:
   + El eje X muestra 10 bins de forma predeterminada, lo que representa los intervalos de la medida elegida. Puede personalizar los bins en el siguiente paso.
   + El eje Y muestra la cantidad absoluta de valores individuales en cada bin.

1. (Opcional) Elija **Formato** en el control visual para cambiar el formato de histograma. Puede formatear los bins por recuento o ancho, no ambos juntos. La configuración de recuento cambia el número de bins que se muestran. La configuración del ancho cambia el ancho o el largo de un intervalo que contiene cada bin. 

## Asignación de formato a un histograma
<a name="format-histogram-chart"></a>

Utilice el procedimiento siguiente para formatear un histograma.

**Aplicación de formato a un histograma**

1. Elija el gráfico de histograma con el que desea trabajar. Debe ser la selección resaltada. Los controles visuales se muestran en la parte superior derecha del histograma.

1. Elija el icono de engranaje en el menú de control visual para consultar las opciones **Formato del elemento visual**.

1. En el panel **Propiedades**, configure las siguientes opciones para controlar la visualización del histograma:
   + Configuración del **Histograma**. Elija *una* de las siguientes opciones de configuración:
     + Cantidad de bin (opción 1): el número de bins que se muestran en el eje X. 
     + Ancho de bin (opción 1): el ancho (o longitud) de cada intervalo. Esta configuración controla el número de elementos o eventos que se van a incluir en cada bin. Por ejemplo, si los datos están en minutos, puede configurarlos en 10 para mostrar intervalos de 10 minutos.
   + Con la siguiente configuración, puede explorar la mejor manera de formatear el histograma para su conjunto de datos. Por ejemplo, en algunos casos, es posible que tenga un pico alto en un bin, mientras que la mayoría de los otros bins parecen dispersos. Esta vista no es útil. Puede utilizar las siguientes opciones de configuración de forma individual o conjunta:
     + Cambie el **Número de puntos de datos mostrados** en la configuración del **Eje X**.

       Amazon Quick muestra hasta 100 contenedores (cubos) de forma predeterminada. Si desea mostrar más (hasta 1000), cambie la configuración del eje X para **Número de puntos de datos mostrados**.
     + Habilite la **Escala logarítmica** en la configuración del **Eje Y**.

       A veces, los datos no se ajustan a la forma que desea y esto puede proporcionar resultados confusos. Por ejemplo, si la forma está tan sesgada hacia la derecha que no puede leerla correctamente, puede aplicarle una escala de registro. Hacer esto no normaliza los datos; sin embargo, reduce el sesgo. 
     + Muestre **Etiquetas de datos**.

       Puede habilitar la visualización de etiquetas de datos para ver las cantidades absolutas en el gráfico. Incluso si no desea mostrarlos en la mayoría de los casos, puede habilitarlos mientras desarrolla un análisis. Las etiquetas pueden ayudarle a decidir las opciones de formateo y filtrado porque revelan las cantidades en bins que son demasiado pequeñas para destacar. 

       Para consultar todas las etiquetas de datos, incluso si se superponen, habilite **Mostrar etiquetas que se van a solapar**.

1. (Opcional) Cambie otros ajustes visuales. Para obtener más información, consulte [Formatear en Amazon Quick](formatting-a-visual.md).

## Descripción de los histogramas
<a name="histogram-understanding"></a>

Aunque los histogramas parecen similares a los gráficos de barras, son muy diferentes. De hecho, la única similitud es su apariencia porque usan barras. En un histograma, cada barra se denomina *bin* o *bucket*.

Cada bin contiene un intervalo de valores denominado *intervalo*. Al hacer una pausa en uno de los bins, los detalles sobre el intervalo aparecen en una ayuda contextual que muestra dos números incluidos en glifos. El tipo de glifos incluido indica si los números dentro de ellos forman parte del intervalo que está dentro del bin seleccionado, de la siguiente manera:
+ Un corchete junto a un número significa que el número está incluido. 
+ Un paréntesis junto a un número significa que el número está excluido.

Por ejemplo, supongamos que la primera barra de un histograma muestra la siguiente notación.

```
[1, 10)
```

El corchete significa que el número 1 está incluido en el primer intervalo. El paréntesis significa que el número 10 está excluido. 

En el mismo histograma, una segunda barra muestra la siguiente notación.

```
[10, 20)
```

En este caso, 10 se incluye en el segundo intervalo y 20 se excluye. El número 10 no puede existir en ambos intervalos, por lo que la notación nos muestra cuál lo incluye.

**nota**  
El patrón utilizado para marcar intervalos en un histograma proviene de la notación matemática estándar. Los siguientes ejemplos muestran los patrones posibles, utilizando un conjunto de números que incluye 10, 20 y cada número intermedio.   
[10, 20]: este conjunto está cerrado. Tiene límites permanentes en ambos extremos.
[10, 21): este conjunto está medio abierto. Tiene un límite permanente a la izquierda y un límite provisional a la derecha.
(9, 20]: este conjunto está medio abierto. Tiene un límite provisional a la izquierda y un límite permanente a la derecha.
(9, 21): este conjunto está abierto. Tiene límites provisionales en ambos extremos.

Debido a que el histograma utiliza datos cuantitativos (números) en lugar de datos cualitativos, hay un orden lógico para la distribución de los datos. Esto se llama *forma*. La forma a menudo se describe por las cualidades que posee la forma, en función de la cantidad en cada bin. Los bins que contienen un número mayor de valores forman un *pico*. Los bins que contienen un número menor de valores forman una *cola* en el borde de un gráfico y un *valle* entre picos. La mayoría de los histogramas tienen una de las formas siguientes:
+ Las distribuciones asimétricas o *sesgos* tienen valores que se agrupan cerca de la izquierda o la derecha, es decir, en el extremo inferior o superior del eje X. La dirección del sesgo se define por dónde está la cola más larga de los datos, no por dónde está el pico. Se define de esta manera porque esta dirección también describe la ubicación de la media. En distribuciones sesgadas, la media y la mediana son dos números diferentes. Los diferentes tipos de distribución sesgada son los siguientes: 
  + Gráfico con sesgo *negativo* o *a la izquierda*: gráfico cuya media se encuentra a la izquierda del pico. Tiene una cola más larga a la izquierda y un pico a la derecha, a veces seguido de una cola más corta.
  + Gráfico con sesgo *positivo* o *a la derecha*: gráfico cuya media se encuentra a la derecha del pico. Tiene una cola más larga a la derecha y un pico a la izquierda, a veces precedido por una cola más corta.
+ Las distribuciones simétricas o *normales* tienen una forma que se refleja en cada lado de un punto central (por ejemplo, una curva de campana). En una distribución normal, la media y la mediana son el mismo valor. Los diferentes tipos de distribución normal son los siguientes:
  + Distribución normal o *unimodal*: gráfico que tiene un pico central que representa el valor más común. Esto se llama normalmente una curva de campana o una distribución gaussiana.
  + Bimodal: gráfico que tiene dos picos que representan los valores más comunes.
  + Multimodal: gráfico que tiene tres o más picos que representan los valores más comunes.
  + Uniforme: gráfico que no tiene picos ni valles, con una distribución de datos relativamente igual.

En la siguiente tabla se muestra la diferencia entre un histograma y un gráfico de barras.


| Histograma | Gráfico de barras | 
| --- | --- | 
| Un histograma muestra la distribución de los valores en un campo. | Un gráfico de barras compara los valores de un campo, agrupados por dimensión. | 
| Los histogramas clasifican los valores en contenedores que representan un intervalo de valores, como, por ejemplo, del 1 al 10, del 10 al 20, etc. | Un gráfico de barras traza valores agrupados en categorías.  | 
| La suma de todos los bins equivale exactamente al 100 % de los valores de los datos filtrados. | No es necesario un gráfico de barras para mostrar todos los datos disponibles. Puede cambiar la configuración de visualización en el nivel visual. Por ejemplo, un gráfico de barras puede mostrar solo las 10 categorías principales de datos. | 
| Reorganizar las barras resta valor al significado del gráfico como un todo. | Las barras pueden estar en cualquier orden sin cambiar el significado del gráfico como un todo. | 
| No hay espacios entre las barras, para representar el hecho de que se trata de datos continuos.  | Hay espacios entre las barras, para representar el hecho de que se trata de datos categóricos. | 
| Si se incluye una línea en un histograma, representa la forma general de los datos. | Si se incluye una línea en un gráfico de barras, se denomina gráfico combinado y la línea representa una medida diferente a las barras.  | 

# Uso de componentes de imagen
<a name="image-component"></a>

Utilice componentes de imagen para cargar imágenes estáticas desde su escritorio a un análisis rápido. Cada hoja de análisis rápido admite hasta 10 componentes de imagen. Los componentes de imagen no se incluyen en el límite de 50 elementos visuales por hoja. El tamaño de archivo de un componente de imagen no puede superar 1 MB.

Los siguientes formatos de archivo son compatibles con los siguientes formatos de archivo para componentes de imagen:
+ `.bmp`
+ `.jpg/.jpeg`
+ `.png`
+ `.tiff`
+ `.webp`

Utilice el siguiente procedimiento para añadir un componente de imagen a un análisis rápido:

**Para añadir un componente de imagen a un análisis rápido**

1. Abra la [consola rápida](https://quicksight.aws.amazon.com/).

1. Abra el análisis rápido al que desee añadir una imagen.

1. Elija el botón **Agregar imagen** en la barra de herramientas situada en la parte superior del análisis.

1. Se abre la selección de archivos de su escritorio. Elija el archivo que quiera cargar y, a continuación, elija **Abrir**. El tamaño de archivo del componente de imagen no puede superar 1 MB.

1. La imagen se carga en Quick y aparece en el análisis.

1. (Opcional) Para agregar texto alternativo o actualizar las opciones de escalado de la imagen, elija el icono **Propiedades** en la parte superior derecha de la imagen para abrir el panel **Propiedades**.

1. (Opcional) Para agregar [información sobre herramientas](https://docs.aws.amazon.com/quicksuite/latest/userguide/customizing-visual-tooltips) personalizada a la imagen, abra el panel **Propiedades**, elija **Interacciones** y, a continuación, **Agregar acción**. Las acciones de filtrado no son compatibles con los componentes de imagen. También puede utilizar la sección **Interacciones** para agregar acciones de navegación y URL personalizadas al componente de imagen.

1. (Opcional) Para duplicar o reemplazar la imagen, elija el icono de puntos suspensivos (tres puntos) de **Más opciones** situado en la parte superior derecha de la imagen y, a continuación, elija la acción que desea llevar a cabo.

# Uso KPIs
<a name="kpi"></a>

Utilice un indicador clave de rendimiento (KPI) para visualizar una comparación entre un valor clave y su valor de destino.

Los KPI muestran una comparación de valores, los dos valores que se comparan y una imagen que proporciona contexto a los datos que se muestran. Puede elegir entre un conjunto de diseños predefinidos en función de las necesidades de su empresa. En la siguiente imagen se muestra un ejemplo de elemento visual de KPI que utiliza un minigráfico.

1. Elija el menú desplegable **Agregar (\$1)** en el **panel Elementos visuales**.

1. Seleccione el icono del KPI en el menú Tipos de elementos visuales.

## Características de los KPI
<a name="kpi-features"></a>

Para entender las características que admite el tipo visual de KPI en Amazon Quick, utilice la siguiente tabla.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Eliminar el título | Sí | Puede optar por no mostrar un título. |  | 
| Cambiar el método de comparación | Sí | De forma predeterminada, Amazon Quick elige automáticamente un método. Los ajustes automáticos son auto, diferencia, por ciento y diferencia como por ciento. |  | 
| Cambiar el valor principal mostrado | Sí | Puede elegir comparación (predeterminada) o real. |  | 
| Mostrar o eliminar la barra de progreso | Sí | Puede formatear el elemento visual para mostrar (valor predeterminado) o no mostrar una barra de progreso. |  | 

Para obtener más información sobre las opciones de formato de los KPI, consulte [Opciones de KPI](KPI-options.md).

## Creación de un KPI
<a name="create-KPI"></a>

Utilice el siguiente procedimiento para crear un KPI.

**Creación de un KPI**

1. Cree un nuevo análisis para su conjunto de datos.

1. En el panel **Visual types**, elija el icono KPI.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Debe utilizar los campos de medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.

   Para crear un KPI, arrastre una medida al cuadro de campo **Valor**. Para comparar dicho valor con un valor de destino, arrastre otra medida al cuadro de campo **Valor de destino**. 

1. (Opcional) Elija las opciones de formato; para ello, seleccione el menú visual en la esquina superior derecha del elemento visual y, a continuación, seleccione **Formato del elemento visual**.

## Cambio del diseño de los KPI
<a name="KPI-layout"></a>

Utilice el procedimiento que se indica a continuación para cambiar el diseño de un KPI.

**Cambio del diseño de un KPI**

1. Navegue hasta el elemento visual del KPI que desee cambiar y elija **Diseños de KPI**.

1. En el panel **Diseños de KPI**, elija el diseño de KPI que desee usar.

# Uso de mapas de capas
<a name="layered-maps"></a>

Utilice los mapas de capas para visualizar los datos con límites geográficos personalizados, como distritos electorales, territorios de ventas o regiones definidas por el usuario. Con los mapas de capas, los autores de Quick cargan archivos GeoJSON en Amazon Quick que dan forma a las capas sobre un mapa base y se unen a los datos de Quick para visualizar las métricas y dimensiones asociadas. Las capas de formas se pueden diseñar por color, borde y opacidad. Los autores rápidos también pueden añadir interactividad a los mapas de capas mediante información sobre herramientas y acciones personalizadas.

**nota**  
Las imágenes de los mapas de capas de Amazon Quick solo admiten formas poligonales. No se admiten geometrías de líneas y puntos.

La siguiente imagen muestra un mapa de capas visual en Amazon Quick.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/layer-map.png)


## Creación de una capa de formas con mapas de capas
<a name="layered-maps-create"></a>

Utilice el procedimiento siguiente para crear una capa de formas con imágenes de mapas de capas en Amazon Quick.

1. Abra la [consola Quick.](https://quicksight.aws.amazon.com/)

1. Abra el análisis rápido al que desee añadir un mapa de capas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija uno de los iconos de mapas de capas.

1. En el análisis aparece una imagen de mapa vacía que le pide que continúe configurando la capa. Elija **CONFIGURAR CAPA** para continuar configurando el mapa de capas.

1. El panel **Propiedades de capa** se abre a la derecha. Vaya a la sección **Archivo de forma** y, a continuación, elija **CARGAR ARCHIVO DE FORMA**.

1. Elija el archivo GeoJSON que desea visualizar. El archivo debe tener un `.geojson` formato y no debe superar los 100 MB.

1. Vaya a la sección **Datos**.

1. En **Campo clave del archivo de forma**, elija el campo que desea que la forma visualice.

1. (Opcional) En **Campo clave del conjunto de datos**, elija el campo del conjunto de datos que desea que la forma visualice. Para asignar color a las formas, agregue un campo de color. Si el campo de color es una medida, la forma utiliza un degradado de color. Si el campo de color es una dimensión, la forma utiliza un color categórico. Si no hay ningún campo de color asignado a la forma, utilice la opción de color de relleno de la sección **Estilo** del panel **Propiedades de capa** para establecer un color común para todas las formas.

1. (Opcional) Para cambiar el nombre de la capa, vaya a la sección **Opciones de capa** e ingrese un nombre en la entrada de **Nombre de capa**.

1. (Opcional) Para cambiar los colores del relleno o del borde, vaya a la sección **Estilo** y elija el conmutador de color situado junto al objeto que desee cambiar. Para ajustar la opacidad del color, ingrese una cantidad porcentual en la entrada situada junto al icono del ojo. Si no asigna un campo de color a **Campo clave del conjunto de datos**, el color de relleno se puede usar para establecer un color común para todas las formas.

# Uso de gráficos de líneas
<a name="line-charts"></a>

Utilice gráficos de líneas para comparar los cambios en los valores de medida a lo largo de un periodo de tiempo, para los siguientes casos: 
+ Una medida a lo largo de un periodo de tiempo, por ejemplo, ventas brutas por mes. 
+ Varias medidas a lo largo de un periodo de tiempo, por ejemplo, ventas brutas y ventas netas por mes. 
+ Una medida para una dimensión a lo largo de un periodo de tiempo, por ejemplo, número de retrasos por día y por línea aérea. 

Los gráficos de líneas muestran los valores individuales de un conjunto de medidas o dimensiones frente al intervalo que muestra el eje Y. Los gráficos de líneas y áreas se diferencian de los gráficos de líneas normales en que cada valor está representado por un área coloreada del gráfico en lugar de tan solo una línea, con objeto de que sea más fácil evaluar los valores de los elementos relacionados entre sí.

Como un gráfico de líneas de áreas apiladas funciona de manera diferente a otros gráficos de líneas, simplifíquelo si es posible. De ese modo, el público no intentará interpretar los números. En su lugar, pueden centrarse en las relaciones de cada conjunto de valores con la totalidad. Una forma de simplificación consiste en eliminar los números en el lado izquierdo de la pantalla reduciendo el tamaño del paso del eje. Para ello, elija el icono **Opciones** en el menú del elemento visual. En **Opciones de formato**, en **Eje Y**, escriba **2** como el valor de **Tamaño del paso**.

Cada línea del gráfico representa un valor de medida durante un periodo de tiempo. Puede ver los valores del gráfico de forma interactiva. Pase el ratón sobre cualquier línea para ver una leyenda emergente que muestra los valores de cada línea del eje **X.** Si pasa el ratón por encima de un punto de datos, verá el **valor** de ese punto específico en el eje **X.**

Utilice gráficos de líneas para comparar los cambios en los valores para una o más medidas o dimensiones a lo largo de un periodo de tiempo. 

En los gráficos de líneas normales, cada valor lo representa una línea y, en los gráficos de líneas de área, cada valor está representado por un área coloreada del gráfico. 

Utilice gráficos de líneas de áreas apiladas para comparar los cambios en los valores para una o más grupos de medidas o dimensiones a lo largo de un periodo de tiempo. Los gráficos de líneas de áreas apiladas muestran el valor total de cada grupo en el eje x. Utilizan segmentos de color para mostrar los valores de cada medida o dimensión del grupo.

Los gráficos de líneas muestran hasta 10 000 puntos de datos en el eje X cuando no se selecciona ningún campo de color. Cuando se rellena el color, los gráficos de líneas muestran hasta 400 puntos de datos en el eje x y un máximo de 25 puntos de datos para el color. Para obtener más información sobre los datos que quedan fuera de los límites de visualización para este tipo de elemento visual, consulte [Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los gráficos de líneas
<a name="line-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos de líneas.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | Sí | Puede definir el intervalo para el eje Y. | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Mostrar u ocultar las líneas de los ejes, las líneas de cuadrícula, las etiquetas de los ejes y los iconos de ordenación de ejes | Sí |  | [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md) | 
| Incorporación de un segundo eje Y | Sí |  | [Creación de un gráfico de líneas de doble eje](#dual-axis-chart) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en cualquier línea del gráfico o excluirla, excepto en los casos siguientes: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/line-charts.html) En estos casos, solo puede centrarse en una línea, no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí, con excepciones | Puede ordenar datos para medidas numéricas en los cuadros de campo Eje X y Valor. Los demás datos se ordenan automáticamente en orden ascendente. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación al campo que elija para el valor y no puede aplicar la agregación a los campos que elija para el eje X y el color. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose a los cuadros de campo Eje X y Color. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 

## Creación de un gráfico de líneas
<a name="create-measure-line-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico de líneas.

**Creación de un gráfico de líneas**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija unos de los iconos de gráfico de líneas.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.
   + Para crear un gráfico de líneas de una sola medida, arrastre una dimensión al cuadro de campo **Eje X** y una medida al cuadro de campo **Valor**.
   + Para crear un gráfico de líneas de varias medidas, arrastre una dimensión al cuadro de campo **Eje X** y dos o más medidas al cuadro de campo **Valor**. Deje el cuadro de campo **Color** vacío.
   + Para crear un gráfico de líneas multidimensionales, arrastre una dimensión al cuadro de campo **Eje X**, una medida al cuadro de campo **Valor** y una dimensión al cuadro de campo **Color**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales a los cuadros de campo **Eje X** o **Color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

## Creación de un gráfico de líneas de doble eje
<a name="dual-axis-chart"></a>

Si tiene dos o más métricas que desea mostrar en el mismo gráfico de líneas, puede crear un gráfico de líneas de doble eje.

Los *gráficos de doble eje* son gráficos con dos ejes Y (un eje a la izquierda del gráfico y otro a la derecha). Por ejemplo, supongamos que crea un gráfico de líneas. Muestra el número de visitantes que se inscribieron en una lista de correo y en un servicio gratuito durante un período de tiempo. Si la escala entre esas dos medidas varía considerablemente a lo largo del tiempo, el gráfico podría tener un aspecto similar al del gráfico de líneas siguiente. Dado que la escala entre las medidas varía considerablemente, la medida con la escala más pequeña se muestra prácticamente plana en cero.

![\[Imagen de un gráfico de líneas con dos líneas y un eje. Una línea está plana en cero.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/dual-axis-chart1.png)


 Si desea mostrar estas medidas en el mismo gráfico, puede crear un gráfico de líneas de doble eje. A continuación, se muestra un ejemplo del mismo gráfico de líneas con dos ejes Y.

![\[Imagen del gráfico de líneas anterior con doble eje. Ambas líneas están ahora visibles.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/dual-axis-chart2.png)


**Creación de un gráfico de líneas de doble eje**

1. En el análisis, cree un gráfico de líneas. Para obtener más información sobre la creación de gráficos de líneas, consulte [Creación de un gráfico de líneas](#create-measure-line-chart). 

1. En el cuadro de campo **Valor**, elija un menú desplegable de campos, elija **Mostrar en: eje Y izquierdo** y, a continuación, elija **Eje Y derecho**.

   O bien, puede crear un gráfico de líneas de doble eje mediante el panel **Propiedades**:

   1. En el menú de la parte superior derecha del gráfico de líneas, seleccione el icono **Formato del elemento visual**.

   1. En el panel **Propiedades** que se abrirá, elija **Serie de datos**.

   1. En la sección **Serie de datos**, elija el icono **Mostrar en el eje derecho** para el valor que desee colocar en un eje independiente. Utilice la barra de búsqueda para encontrar rápidamente un valor si lo necesita.  
![\[Imagen de la sección de series de datos del panel Formato del elemento visual con el icono Mostrar en el eje derecho marcado con un círculo rojo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/dual-axis-chart3.png)

   El icono se actualiza para indicar que el valor se muestra en el eje derecho. El gráfico se actualiza con dos ejes.

   El panel **Propiedades** se actualizará con las siguientes opciones:
   + Para volver a sincronizar los ejes Y de ambas líneas en un solo eje, elija **Eje Y único** en la parte superior del panel **Propiedades**.
   + Para cambiar el formato del eje situado a la izquierda del gráfico, seleccione **Eje Y izquierdo**.
   + Para cambiar el formato del eje situado a la derecha del gráfico, seleccione **Eje Y derecho**.

   Para obtener más información sobre cómo cambiar el formato de las líneas de ejes, consulte [Ejes y líneas de cuadrícula](showing-hiding-axis-grid-tick.md). Para obtener más información sobre cómo ajustar el intervalo y la escala de un eje, consulte [Intervalo y escala](changing-visual-scale-axis-range.md).

# Creación de mapas y gráficos geoespaciales
<a name="geospatial-charts"></a>

Puede crear dos tipos de mapas en Quick: mapas de puntos y mapas rellenos. *Los mapas de puntos* muestran la diferencia entre los valores de datos de cada ubicación por tamaño. *Los mapas rellenados* muestran la diferencia entre los valores de datos de cada ubicación mediante la variación de los tonos de color.

**importante**  
Los gráficos geoespaciales de Quick actualmente no son compatibles con algunos Regiones de AWS, incluso en China.   
Si desea ayuda sobre cuestiones geoespaciales, consulte [Solución de problemas geoespaciales](geospatial-troubleshooting.md).

Antes de empezar a crear mapas, haga lo siguiente:
+ Asegúrese de que su conjunto de datos contenga datos de ubicación. *Los datos de ubicación* son datos que corresponden a valores de latitud y longitud. Los datos de ubicación pueden incluir una columna para la latitud y otra columna para la longitud en el conjunto de datos. También pueden incluir una columna con los nombres de las ciudades. Quick puede trazar las coordenadas de latitud y longitud. También reconoce componentes geográficos, como, por ejemplo, el país, el estado o región, el condado o distrito, la ciudad y el código postal.
+ Asegúrese de que los campos de datos de ubicación estén marcados como tipos de datos geoespaciales.
+ Considere la posibilidad de crear jerarquías geográficas.

Para obtener más información sobre cómo usar datos geoespaciales, incluido el cambio de tipos de datos de campo y la creación de jerarquías geoespaciales, consulte [Adición de datos geoespaciales](geospatial-data-prep.md).

Para obtener más información sobre la creación de mapas en Quick, consulta lo siguiente.

**Topics**
+ [Creación de mapas de puntos](point-maps.md)
+ [Creación de mapas rellenados](filled-maps.md)
+ [Interacción con los mapas](maps-interacting.md)

# Creación de mapas de puntos
<a name="point-maps"></a>

Puede crear mapas de puntos en Quick para mostrar la diferencia entre los valores de datos de cada ubicación por tamaño. Cada punto de este tipo de mapa corresponde a una ubicación geográfica de sus datos, como, por ejemplo, un país, un estado, una provincia o una ciudad. El tamaño de los puntos del mapa representa la magnitud del campo en el cuadro de campo **Tamaño** con respecto a otros valores del mismo campo. El color de los puntos representa los valores del cuadro de campo **Color**. Los valores de campo del cuadro de campo **Color** se mostrarán en la leyenda si elige un campo de color.

Utilice el siguiente procedimiento para crear un mapa de puntos en Quick.

Para crear mapas de puntos en Quick, asegúrese de tener lo siguiente:
+ Un campo geoespacial (como, por ejemplo, el país, el estado o región, el condado o distrito, la ciudad o el código postal). O bien, puede usar un campo de latitud y un campo de longitud.
+ Un campo numérico (medida) para el tamaño.
+ (Opcional) Un campo categórico (dimensión) para el color.

Para obtener información sobre como asignar formato a los mapas geoespaciales, consulte [Opciones de formato de mapas y gráficos geoespaciales](https://docs.aws.amazon.com/quicksight/latest/user/geospatial-formatting).

## Creación de mapas de puntos
<a name="point-maps-create"></a>

**Creación de un mapa de puntos**

1. Añada un nuevo elemento visual a su análisis. Para obtener más información sobre de cómo iniciar análisis, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md). Para obtener más información sobre cómo añadir elementos visuales a un análisis, consulte [Adición de un elemento visual](creating-a-visual.md#create-a-visual).

1. En **Tipo de elemento visual**, elija el icono **Puntos en el mapa**. Este icono tiene forma de globo terráqueo con un punto.

1. Arrastre un campo geográfico desde el panel **Lista de campos** hasta el cuadro de campo **Geospacial**, por ejemplo, `Country`. También puede elegir un campo de latitud o longitud.

   Aparecerá un mapa de puntos con un punto para cada ubicación de los datos.

   Si el campo forma parte de una jerarquía geográfica, la jerarquía se mostrará en el cuadro de campo.

1. Arrastre una medida desde el panel **Lista de campos** hasta el cuadro de campo **Tamaño**.

   Los puntos del mapa se actualizan para mostrar la magnitud de los valores de cada ubicación. 

1. (Opcional) Arrastre una dimensión desde el panel **Lista de campos** hasta el cuadro campo **Color**.

   Cada punto se actualiza para mostrar un punto por cada valor categórico de la dimensión.

# Creación de mapas rellenados
<a name="filled-maps"></a>

Puede crear mapas rellenos en Quick para mostrar la diferencia entre los valores de los datos de cada ubicación mediante distintos tonos de color. 

Utilice el siguiente procedimiento para crear un mapa relleno en Quick.

Para crear mapas rellenados en Quick, asegúrese de tener lo siguiente:
+ Un campo geoespacial (como, por ejemplo, el país, el estado o región, el condado o distrito, o el código postal).
+ (Opcional) Un campo numérico (medida) para el color.

## Creación de mapas rellenados
<a name="filled-maps-create"></a>

**Creación de un mapa rellenado**

1. Añada un nuevo elemento visual a su análisis. Para obtener más información sobre de cómo iniciar análisis, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md). Para obtener más información sobre cómo añadir elementos visuales a un análisis, consulte [Adición de un elemento visual](creating-a-visual.md#create-a-visual).

1. En **Tipo de elemento visual**, elija el icono **Mapa rellenado**.

1. Arrastre un campo geográfico desde el panel **Lista de campos** hasta el cuadro de campo **Ubicación**, por ejemplo, `Country`.

   Aparecerá un mapa rellenado con cada ubicación de los datos rellenada el número de veces que aparecen en el conjunto de datos (recuento).

   Si el campo forma parte de una jerarquía geográfica, la jerarquía se mostrará en el cuadro de campo.

1. (Opcional) Arrastre una dimensión desde el panel **Lista de campos** hasta el cuadro campo **Color**, por ejemplo, `Sales`.

   Cada ubicación se actualiza para mostrar la suma de las ventas.

# Interacción con los mapas
<a name="maps-interacting"></a>

Al ver un mapa visual en un panel de análisis rápido o publicado, puede interactuar con él para explorar sus datos. De este modo, podrá desplazarse por el mapa, ampliar o reducir la imagen o ampliar y reducir la imagen de forma automática con todos los datos.

De forma predeterminada, las vistas de mapas siempre se amplían o reducen en función los datos subyacentes. Al desplazarse por el mapa o al acercar y alejar la imagen a diferentes niveles, el icono de ampliar los datos aparecerá sobre iconos para acercar y alejar la vista, en la parte inferior derecha del mapa. Con esta opción, podrá acercar o alejar la vista de los datos subyacentes con rapidez.

**Desplazamiento por un vista del mapa**
+ Haga clic en cualquier punto de la vista del mapa y arrastre el cursor en la dirección en la que desee desplazarse en el mapa.

**Acercamiento o alejamiento de la vista del elemento visual de un mapa**
+ En la vista del mapa, seleccione los iconos de signo más o menos en la parte inferior derecha. O bien, puede hacer doble clic en el mapa para acercar o shift-double-click alejar el mapa.

**Pasos para alejar la vista y volver a mostrar todos los datos**
+ En la vista del mapa, elija el icono para ampliar o reducir los datos. Este icono se muestra cuando se desplaza por un mapa o al ampliar y reducir la imagen.

# Uso de múltiplos pequeños
<a name="small-multiples"></a>

Utilice esta característica cuando necesite definir varios elementos visuales comparativos en una fila. Al activar la función de *múltiplos pequeños*, Amazon Quick crea un contenedor o estantería con imágenes pequeñas presentadas. side-by-side Cada copia del elemento visual contiene una vista única de los datos. El uso de múltiplos pequeños es una manera de obtener una visión holística de su empresa de una manera eficiente e interactiva.

Los múltiplos pequeños no aparecen en los iconos de visualización de la paleta. En su lugar, la opción de crear múltiplos pequeños aparece como cuadro de campo en los elementos visuales compatibles. 

**Adición de pequeños elementos visuales a su análisis**

1. En un gráfico de líneas, barras o círculos, añada un campo al cuadro de campo **Múltiplos pequeños**.

1. Para ver los múltiplos pequeños, debe ampliar el contenedor que los contiene para poder verlos todos a la vez.

1. Para cambiar el formato del conjunto de múltiplos pequeños, elija Formato del elemento visual (icono de lápiz) en el menú del elemento visual. Puede ajustar la configuración siguiente:
   + **Diseño**
     + **Filas visibles**
     + **Columnas visibles**
     + **Número de paneles**
   + Opciones de título del panel (conmutador)
     + Tamaño y color de fuente
     + Espesor de fuente
     + Alineación de texto
   + **Opciones de orden de los paneles** (conmutador)

     Grosor, estilo y color de la línea
   + **Margen interno del panel** (conmutador) 

     **Spacing**
   + **Fondo del panel** (conmutador) 

     **Background color (Color de fondo)**

# Uso de los gráficos circulares
<a name="pie-chart"></a>

Utilice gráficos circulares para comparar los valores para los elementos en una dimensión. El mejor uso posible para este tipo de gráfico es mostrar un porcentaje de una cantidad total.

Cada cuña de un gráfico circular representa un elemento de la dimensión. El tamaño de la cuña representa la proporción del valor para la medida seleccionada que el elemento representa en comparación con la totalidad de la dimensión. Los gráficos circulares son óptimos cuando la precisión no es importante y hay tan solo algunos elementos en la dimensión.

Para crear un gráfico de anillos, utilice una dimensión en el cuadro del campo **Grupo/color**. Con solo un campo, el gráfico muestra la división de valores por número de filas. Para mostrar la división de valores de dimensión por un valor de métrica, puede agregar un campo de métrica al cuadro del campo **Valor**. 

Los gráficos circulares muestran hasta 20 puntos de datos para grupo o color. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características delos gráficos circulares
<a name="pie-chart-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos circulares.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No aplicable |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Mostrar u ocultar las etiquetas de los ejes. | Sí |  | [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en una cuña en un gráfico circular o excluirla, excepto cuando utiliza un campo de fecha como una dimensión. En ese caso, solo puede centrarse en una cuña, no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí | Puede ordenar los campos que elija para el valor o el grupo o color. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación al campo que elija para el valor y no puede aplicar la agregación al campo que elija para grupo o color. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose al cuadro de campo Grupo/color. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 

## Creación de un gráfico circular
<a name="create-pie-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico circular.

**Creación de un gráfico circular**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Visual types**, elija el icono de gráfico circular.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.

   Para crear un gráfico circular, arrastre una dimensión al cuadro del campo **Grupo/color**. Si lo desea, arrastre una medida al cuadro del campo **Valor**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales al cuadro del campo **Grupo/color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

# Uso de tablas dinámicas
<a name="pivot-table"></a>

Utilice tablas dinámicas para mostrar valores de medida para la intersección de dos dimensiones.

Los mapas térmicos y las tablas dinámicas muestran los datos en un formato tabular similar. Utilice un mapa térmico si desea identificar las tendencias y los casos atípicos, ya que el uso de color permite detectarlos con mayor facilidad. Utilice una tabla dinámica si desea analizar datos en el elemento visual.

Para crear una tabla dinámica, elija al menos un campo de cualquier tipo y elija el icono de la tabla dinámica. Amazon Quick crea la tabla y rellena los valores de las celdas con el recuento del valor de la columna correspondiente al valor de la fila que se interseca. Normalmente, puede elegir una medida y dos dimensiones mensurables para dicha medida.

Las tablas dinámicas admiten desplazamiento hacia abajo y hacia la derecha. Puede añadir hasta 20 campos como filas y 20 campos como columnas. Admiten hasta 500 000 registros.

Mediante una tabla dinámica, puede hacer lo siguiente:
+ Especificar varias medidas para completar los valores de las celdas de la tabla, de modo que pueda ver un conjunto de datos.
+ Agrupar las columnas y filas de la tabla dinámica para mostrar valores para subcategorías agrupadas por la dimensión relacionada.
+ Ordenar los valores en las filas o columnas de la tabla dinámica
+ Aplicar funciones estadísticas
+ Añadir totales y subtotales a filas y columnas
+ Utilizar el desplazamiento infinito
+ Transponer campos utilizados por filas y columnas
+ Crear agregaciones de totales personalizadas

Para transponer fácilmente los campos utilizados por las filas y columnas de la tabla dinámica, elija el icono de orientación (![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/pivot-orientation.png)) cerca de la parte superior derecha del elemento visual: Para ver opciones para mostrar y ocultar totales y subtotales, formatear el elemento visual o exportar datos a un archivo CSV, seleccione el icono de elementos de menú en la parte superior derecha. 

Al igual que ocurre con todos los tipos de elementos visuales, puede añadir y eliminar campos. También puede cambiar el campo asociado a un elemento visual, cambiar la agregación de campo y cambiar el grado de detalle del campo de fecha. Además, puede centrarse en las filas o columnas o excluirlas. Para obtener más información acerca de cómo realizar estos cambios en una tabla dinámica, consulte [Cambiar los campos utilizados por un elemento visual en Amazon Quick](changing-visual-fields.md). 

Para obtener más información sobre el formato de tablas dinámicas, consulte [Formatear en Amazon Quick](formatting-a-visual.md).

Para obtener información sobre las agregaciones totales personalizadas para las tablas dinámicas, consulte [Valores totales personalizados](tables-pivot-tables-custom-totals.md).

**Topics**
+ [Características de una tabla dinámica](#pivot-table-features)
+ [Creación de una tabla dinámica](create-pivot-table.md)
+ [Orientación de valores de tabla dinámica](pivot-table-value-orientation.md)
+ [Ampliación y contracción de clústeres de tablas dinámicas](expanding-and-collapsing-clusters.md)
+ [Mostrar y ocultar las columnas de la tabla dinámica en Quick](hiding-pivot-table-columns.md)
+ [Clasificación de tablas dinámicas en Quick](sorting-pivot-tables.md)
+ [Uso de cálculos de tabla en tablas dinámicas](working-with-calculations.md)
+ [Limitaciones de las tablas dinámicas](pivot-table-limitations.md)
+ [Prácticas recomendadas para tablas dinámicas](pivot-table-best-practices.md)

## Características de una tabla dinámica
<a name="pivot-table-features"></a>

Las tablas dinámicas no muestran leyendas.

Utilice la siguiente tabla para conocer las características compatibles con las tablas dinámicas.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | No |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No aplicable |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Cambiar los colores del elemento visual | No |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en cualquier columna o fila o excluirlas, excepto cuando se utiliza un campo de fecha como una de las dimensiones. En ese caso, solo puede centrarse en la columna o fila que utiliza la dimensión de fecha y no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí | Puede ordenar los campos del cuadro de campo Filas o Columnas alfabéticamente o por una métrica en orden ascendente o descendente. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) [Clasificación de tablas dinámicas en Quick](sorting-pivot-tables.md)  | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación al campo o los campos que elija para el valor. No puede aplicar la agregación a los campos que elija para las filas o columnas. Si decide crear una tabla dinámica de varias medidas, puede aplicar diferentes tipos de agregación para las distintas medidas. Por ejemplo, puede mostrar la suma de la cantidad de ventas y la cantidad de descuento máxima. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | No |  | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Mostrar y ocultar totales y subtotales | Sí | Puede mostrar u ocultar totales y subtotales de las filas y columnas. Las métricas se acumulan de forma automática para mostrar los subtotales al contraer una fila o columna. Si utiliza un cálculo de tabla, utilice agregaciones para mostrar las acumulaciones.  |  | 
| Exportación o copia de datos | Sí |  Puede exportar todos los datos a un archivo CSV. Puede seleccionar y copiar el contenido de las celdas.   | [Exportación de datos de elementos visuales](exporting-data.md) | 
| Formato condicional | Sí | Puede agregar formato condicional para valores, subtotales y totales. | [Formato condicional en tipos visuales en Quick](conditional-formatting-for-visuals.md) | 

**Topics**

# Creación de una tabla dinámica
<a name="create-pivot-table"></a>

Utilice el siguiente procedimiento para crear una tabla dinámica.

**Creación de una tabla dinámica**

1. En la página de análisis, elija el icono **Visualizar** en la barra de herramientas.

1. En el panel **Elementos visuales**, elija **\$1 Añadir** y, a continuación, seleccione el icono de la tabla dinámica.

1. Desde el panel **Lista de campos**, elija los campos que desea incluir. Amazon Quick los coloca automáticamente en los pozos de campo. 

   Para cambiar la colocación de un campo, arrástrelo a los cuadros de campo apropiados. Por norma general, utiliza los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.
   + Para crear una tabla dinámica de una sola medida, arrastre una dimensión al cuadro de campo **Filas**, una dimensión al cuadro de campo **Columnas** y una medida al cuadro de campo **Valores**.
   + Para crear una tabla dinámica de varias medidas, arrastre una dimensión al cuadro de campo **Filas**, una dimensión al cuadro de campo **Columnas** y dos o más medidas al cuadro de campo **Valores**.
   + Para crear una tabla dinámica agrupada, arrastre una o más dimensiones al cuadro de campo **Filas**, una o más dimensiones al cuadro de campo **Columnas** y una medida al cuadro de campo **Valores**.

   También puede seleccionar varios campos para todos los cuadros de campo de la tabla dinámica si así lo desea. Esto combina los enfoques de tabla dinámica de varias medidas y en clúster.

**nota**  
Para ver acumulaciones para campos calculados, asegúrese de que está utilizando agregaciones. Por ejemplo, un campo calculado con `field-1 / field-2 `no muestra un resumen cuando se acumula. Sin embargo, `sum(field-1) / sum(field-2) `muestra un resumen acumulado. 

## Selección de un diseño
<a name="pivot-table-layout"></a>

Al crear una tabla dinámica en Amazon Quick, puede personalizar aún más la forma en que se presentan los datos con las opciones de diseño tabular y jerárquico. En el caso de tablas dinámicas que utilizan un diseño tabular, cada campo de fila se muestra en su propia columna. En las tablas dinámicas que utilizan un diseño jerárquico, todos los campos de fila se muestran en una sola columna. La sangría se utiliza para distinguir los encabezados de fila de los distintos campos. Para cambiar el diseño de un elemento visual de tabla dinámica, abra el menú **Formato del elemento visual** de la tabla dinámica que desee cambiar y elija la opción de diseño que desee en la sección **Opciones de tabla dinámica**.

Se mostrarán diferentes opciones de formato en función del diseño que elija para el elemento visual de la tabla dinámica. Para obtener más información sobre las diferencias de formato que existen entre las tablas dinámicas tabulares y jerárquicas, consulte [Opciones de formato de tablas y tablas dinámicas en Quick](format-tables-pivot-tables.md).

# Orientación de valores de tabla dinámica
<a name="pivot-table-value-orientation"></a>

Puede elegir mostrar una tabla dinámica en un formato basado en filas o en columnas. Por columnas es el valor predeterminado. Al cambiar a un formato basado en filas, se añade una columna con el nombre del valor a la derecha de la columna con el encabezado de la fila.

**Cambio del formato de una tabla dinámica**

1. En la página de análisis, elija el elemento visual de la tabla dinámica que desea editar.

1. Amplíe el panel **Cuadros de campo** eligiendo los cuadros de campo en la parte superior del elemento visual.

1. En el campo **Valores**, elija una de las siguientes opciones:
   + Elija **Column** para un formato de columnas.
   + Elija **Fila** para un formato de filas.
**nota**  
Si utiliza una sola métrica, puede eliminar la encabezado repetido aplicando formato al elemento visual y estilo con la opción **Ocultar métrica única**.

# Ampliación y contracción de clústeres de tablas dinámicas
<a name="expanding-and-collapsing-clusters"></a>

Si utiliza columnas o filas agrupadas en una tabla dinámica, puede expandir o contraer un grupo para mostrar u ocultar sus datos en el elemento visual.

**Ampliación o contracción de un grupo de tablas dinámicas**

1. En la página de análisis, elija el elemento visual de la tabla dinámica que desea editar.

1. Seleccione una de las siguientes opciones:
   + Para contraer un grupo, elija el icono de contraer cerca del nombre del campo. 
   + Para ampliar un grupo, elija el icono de ampliar cerca del nombre del campo. El icono de contraer muestra un signo menos. El icono de ampliar muestra un signo más.

   En la siguiente captura de pantalla, `Customer Region` y el segmento `Enterprise` se amplían y `SMB` y `Startup` se contraen. Cuando se contrae un grupo, sus datos se resumen en la fila o columna.  
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/pivot-table-collapse.png)

# Mostrar y ocultar las columnas de la tabla dinámica en Quick
<a name="hiding-pivot-table-columns"></a>

De forma predeterminada, se muestran todas las columnas, filas y sus valores de campo cuando se crea una tabla dinámica. Puede ocultar las columnas y filas que no desee que se muestren en la tabla dinámica sin cambiar los valores de la tabla dinámica. Cuando tenga más de una medida en la tabla dinámica, también podrá ocultar los valores.

En cualquier momento, puede mostrar cualquier campo oculto en la tabla dinámica. Cuando se publica el elemento visual como parte de un panel, cualquier persona que se suscriba al panel podrá exportar la tabla dinámica a un archivo de valores separados por comas (CSV) o archivo de Microsoft Excel. De este modo, podrá exportar solo los campos visibles o todos los campos. Para obtener más información, consulte [Exportación de datos desde un panel a un CSV](export-or-print-dashboard.md#export-dashboard-to-csv).

**Ocultación de una columna o fila en una tabla dinámica**

1. En su análisis, seleccione el elemento visual de la tabla dinámica que desee utilizar.

1. **Elija el menú de tres puntos en los campos **Filas**, **Columnas** o **Valores** y, a continuación, elija Ocultar.**

**Visualización de todos los campos ocultos en una tabla dinámica**

1. En su análisis, seleccione el elemento visual de la tabla dinámica que desee utilizar.

1. Elija cualquier campo de **Cuadro de campos** y elija **Mostrar todos los campos ocultos**.

# Clasificación de tablas dinámicas en Quick
<a name="sorting-pivot-tables"></a>

En Amazon Quick, puede ordenar los valores de una tabla dinámica por campos en los campos de **filas** y **columnas** o rápidamente por encabezados de columna en la tabla dinámica. En las tablas dinámicas, puede ordenar filas y columnas de forma independiente por orden alfabético o por medida.

**nota**  
No es posible ejecutar los cálculos de tabla Total, Diferencia y Diferencia de porcentaje cuando la tabla dinámica se ordena según una medida. Para obtener más información sobre el uso de cálculos de tabla en las tablas dinámicas, consulte [Uso de cálculos de tabla en tablas dinámicas](working-with-calculations.md).

## Descripción de la ordenación en tablas dinámicas
<a name="sorting-pivot-tables-understanding"></a>

Cuando hay varios paneles en una tabla dinámica, la ordenación se aplica a cada panel de forma independiente. Por ejemplo, la columna `Segment` de la tabla dinámica de la izquierda se ordena en orden ascendente según `Cost`. Dado que hay varios paneles, la ordenación comienza de nuevo para cada panel, por lo que las filas de cada panel (para `Segment`) se ordenan por costo de menor a mayor. La tabla de la derecha tiene el mismo orden aplicado, aunque este se aplica a toda la tabla, tal como se muestra a continuación.

![\[Imagen de una tabla dinámica con una ordenación resaltada en rojo.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sorting-pivot-tables2.png)


Cuando se aplican varias ordenaciones a una tabla dinámica, la ordenación se aplica de la dimensión exterior a la dimensión interior. Preste atención a la siguiente imagen de ejemplo de tabla dinámica. La columna `Customer Region` se ordena según `Cost` en orden descendente (resaltado en naranja). La columna `Channel` se ordena por objetivo de ingresos en orden ascendente (resaltado en azul).

![\[Imagen de una tabla dinámica que muestra dos columnas de valores de medida ordenadas.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sorting-pivot-tables3.png)


## Ordenación de tablas dinámicas mediante encabezados de fila o columna
<a name="sorting-pivot-tables-columns"></a>

Utilice el procedimiento siguiente para ordenar una tabla dinámica según los encabezados de fila o columna.

**Ordenación de los valores de una tabla dinámica tabular según los encabezados de las tablas**

1. En un gráfico de tabla dinámica tabular, elija el encabezado que desee ordenar.

1. En **Ordenar por**, elija un campo para la ordenación, así como un criterio de ordenación.

   Los campos de dimensiones se pueden ordenar alfabéticamente (a–z o z–a), o bien por una medida en orden ascendente o descendente.  
![\[Archivo .gif animado que muestra cómo se ordenan valores en una tabla dinámica mediante encabezados de columna.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sorting-pivot-table7.gif)

## Ordenación de tablas dinámicas mediante encabezados de valores
<a name="sorting-pivot-tables-values"></a>

Utilice el procedimiento siguiente para ordenar una tabla dinámica según los encabezados de valores.

**Ordenación de una tabla dinámica mediante encabezados de valores**

1. En un gráfico de tabla dinámica, elija el encabezado de valor que desee ordenar.

1. Elija **Ascendente** o **Descendente**.  
![\[Archivo .gif animado que muestra cómo se ordenan valores en una tabla dinámica mediante encabezados de valores.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sorting-pivot-tables-value.gif)

   La ordenación por encabezados de valores en una tabla dinámica también funciona con los subtotales.

## Ordenación de tablas dinámicas tabulares mediante cuadros de campo
<a name="sorting-pivot-tables-field-wells"></a>

Utilice el procedimiento siguiente para ordenar los valores de una tabla dinámica tabular mediante cuadros de campo.

**Ordenación de los valores de una tabla dinámica tabular mediante cuadros de campo**

1. En la página de análisis, elija la tabla dinámica tabular que desea ordenar.

1. Amplíe **Cuadros de campo**.

1. En el cuadro de campo **Filas** o **Columnas**, elija el campo que desee ordenar y, a continuación, elija cómo desea ordenar el campo en **Ordenar por**.

   Los campos de dimensiones de los cuadros de campo **Filas** o **Columnas** se pueden ordenar alfabéticamente (a–z o z–a), o bien por una medida en orden ascendente o descendente. También puede contraer o ampliar todas las filas o columnas del campo que seleccione en el cuadro de campo. También puede eliminar el campo o reemplazarlo por otro campo. 
   + Para ordenar un campo de dimensión alfabéticamente, sitúe el cursor sobre el campo en el cuadro de campo **Filas** o **Columnas** y, a continuación, seleccione el icono de ordenación a–z o z–a.  
![\[Imagen de un campo del cuadro de campo Filas con los iconos de ordenación por campo y orden alfabético indicados en cuadrados rojos.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sorting-pivot-tables1.png)
   + Para ordenar un campo de dimensiones por una medida, sitúe el cursor sobre el campo en el cuadro de campo **Filas** o **Columnas**. A continuación, elija una medida de la lista y seleccione el icono de ordenación ascendente o descendente.  
![\[Imagen de un campo del cuadro de campo Filas con los iconos de ordenación por campo y ordenación indicados en cuadrados rojos.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sorting-pivot-tables4.png)

O bien, personalice las opciones de si desea tener más control sobre cómo se aplica la ordenación a la tabla dinámica.

**Creación de una ordenación mediante las **opciones de ordenación****

1. En la página de análisis, elija la tabla dinámica que desea ordenar.

1. Amplíe **Cuadros de campo**.

1. Elija el campo que desee ordenar en el cuadro de campo **Filas** o **Columnas** y, a continuación, elija **Opciones de ordenación**.

1. En el panel **Opciones de ordenación** que se abre a la izquierda, especifique las opciones siguientes:

   1. En **Ordenar por**, elija un campo de la lista desplegable.

   1. En **Agregación**, elija una agregación de la lista.

   1. En **Orden de clasificación**, seleccione **Ascendente** o **Descendente**.

   1. Seleccione **Aplicar**.

## Ordenación de tablas dinámicas jerárquicas mediante cuadros de campo
<a name="pivot-table-sorting-hierarchy"></a>

En el caso de tablas dinámicas tabulares, cada campo del cuadro de campo **Filas** tiene una celda de título independiente. En las tablas dinámicas jerárquicas, todos los campos de fila se muestran en una sola columna. Para ordenar, contraer y ampliar estos campos de fila, seleccione la etiqueta **Filas** para abrir el menú **Campos de fila combinados** y elija la opción que desee. Todos los campos de las tablas dinámicas jerárquicas se pueden ordenar de forma individual desde el menú **Campos de fila combinados**.

![\[Imagen del menú Campos de fila combinados.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/pivot-table-combined-row-fields-menu.png)


Encontrará opciones de formato más avanzadas, como, por ejemplo, **Ocultar** y **Eliminar**, en los menús de los cuadros de campo.

# Uso de cálculos de tabla en tablas dinámicas
<a name="working-with-calculations"></a>

Puede utilizar los cálculos de tabla para aplicar funciones estadísticas a las celdas de la tabla dinámica que contienen medidas (valores numéricos). Utilice las siguientes secciones para conocer las funciones que puede usar en los cálculos y cómo aplicarlas o eliminarlas.

El tipo de datos del valor de la celda cambia automáticamente para trabajar en su cálculo. Por ejemplo, supongamos que aplica la función **Clasificación** a un tipo de datos de divisa. Los valores se muestran como enteros en lugar de como divisas, ya que la clasificación no se mide como divisa. Del mismo modo, si aplica la función **Diferencia de porcentaje**, los valores de celda se muestran como porcentajes. 

**Topics**
+ [Adición y eliminación de cálculos de tabla dinámica](adding-a-calculation.md)
+ [Funciones para cálculos de tabla dinámica](supported-functions.md)
+ [Formas de aplicar los cálculos de tabla dinámica](supported-applications.md)

# Adición y eliminación de cálculos de tabla dinámica
<a name="adding-a-calculation"></a>

Utilice los siguientes procedimientos para añadir, modificar y eliminar los cálculos de tabla en una tabla dinámica.

**Topics**
+ [Adición de un cálculo de tabla dinámica](add-a-calculation.md)
+ [Cambio del modo en que se aplica un cálculo](change-how-a-calculation-is-applied.md)
+ [Eliminación de un cálculo](remove-a-calculation.md)

# Adición de un cálculo de tabla dinámica
<a name="add-a-calculation"></a>

Utilice los siguientes procedimientos para añadir un cálculo de tabla a una tabla dinámica.

**Adición de un cálculo de tabla a una tabla dinámica**

1. Amplíe el panel **Cuadros de campo**. Para ello, elija los cuadros de campo en la parte superior del elemento visual.

1. Elija el campo en el cuadro **Valores** que desea aplicar a un cálculo de tabla, seleccione **Agregar cálculo de tabla** y, a continuación, la función para aplicar.

**nota**  
No es posible ejecutar los cálculos de tabla Total, Diferencia y Diferencia de porcentaje cuando la tabla dinámica se ordena según una medida. Para usar estos cálculos de tabla, elimine la ordenación de la tabla dinámica.

# Cambio del modo en que se aplica un cálculo
<a name="change-how-a-calculation-is-applied"></a>

Utilice los siguientes procedimientos para cambiar el modo en que un cálculo de tabla se aplica a una tabla dinámica.

**Cambio del modo en que se aplica un cálculo de tabla a una tabla dinámica**

1. Amplíe el panel **Cuadros de campo** eligiendo los cuadros de campo en la parte superior del elemento visual.

1. Elija el campo del cuadro **Valores** que tiene el cálculo de tabla que desea modificar, seleccione **Calcular como** y, a continuación, elija el modo en que desea aplicar el cálculo.

# Eliminación de un cálculo
<a name="remove-a-calculation"></a>

Utilice el siguiente procedimiento para eliminar un cálculo de tabla de una tabla dinámica.

**Eliminación de un cálculo de tabla de una tabla dinámica**

1. Amplíe el panel **Cuadros de campo**. Para ello, elija los cuadros de campo en la parte superior del elemento visual.

1. Elija el campo en el cuadro **Valores** del que desea eliminar el cálculo de tabla y, a continuación, seleccione **Eliminar**.

# Funciones para cálculos de tabla dinámica
<a name="supported-functions"></a>

Puede utilizar las siguientes funciones en los cálculos de tabla dinámica.

**Topics**
+ [Total acumulado](#running-total)
+ [Diferencia](#difference)
+ [Diferencia de porcentaje](#percent-difference)
+ [Porcentaje del total](#percent-of-total)
+ [Rank](#rank)
+ [Percentil](#percentile)

Puede aplicar las funciones que se muestran a los siguientes datos:

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total1.png)


![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total1.png)


## Total acumulado
<a name="running-total"></a>

La función **Total acumulado** calcula la suma de un valor de celda determinado y los valores de todas las celdas anteriores a esta. Esta suma se calcula como `Cell1=Cell1, Cell2=Cell1+Cell2, Cell3=Cell1+Cell2+Cell3` y así sucesivamente. 

Aplicando la función **Total acumulado** en las filas de la tabla, utilizando **Tabla transversal** en **Calcular como**, le ofrece los resultados siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total2.png)


## Diferencia
<a name="difference"></a>

La función **Diferencia** calcula la diferencia entre un valor de una celda y el valor de la celda anterior a esta. Esta diferencia se calcula como `Cell1=Cell1-null, Cell2=Cell2-Cell1, Cell3=Cell3-Cell2,` y así sucesivamente. Debido a que `Cell1-null = null`, el valor Cell1 está siempre vacío.

Aplicando la función **Diferencia** en las filas de la tabla, utilizando **Tabla transversal** en **Calcular como**, le ofrece los resultados siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/difference.png)


## Diferencia de porcentaje
<a name="percent-difference"></a>

La función **Diferencia de porcentaje** calcula la diferencia porcentual entre un valor de una celda y el valor de la celda anterior, dividido por el valor de la celda anterior. Este valor se calcula como `Cell1=(Cell1-null)/null, Cell2=(Cell2-Cell1)/Cell1, Cell3=(Cell3-Cell2)/Cell2,` y así sucesivamente. Debido a que `(Cell1-null)/null = null`, el valor Cell1 está siempre vacío.

Aplicando la función **Diferencia de porcentaje** en las filas de la tabla, utilizando **Tabla transversal** en **Calcular como**, le ofrece los resultados siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentage-difference.png)


## Porcentaje del total
<a name="percent-of-total"></a>

La función **Porcentaje del total** calcula el porcentaje que una celda determinada representa en la suma de todas las celdas que se incluyen en el cálculo. Este porcentaje se calcula como `Cell1=Cell1/(sum of all cells), Cell2=Cell2/(sum of all cells),` y así sucesivamente. 

Aplicando la función **Porcentaje del total** en las filas de la tabla, utilizando **Tabla transversal** en **Calcular como**, le ofrece los resultados siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percent-of-total.png)


## Rank
<a name="rank"></a>

La función **Clasificación** calcula la clasificación del valor de la celda en comparación con los valores de las otras celdas que se incluyen en el cálculo. La clasificación siempre muestra el máximo valor igual a 1 y el mínimo valor igual al recuento de las celdas que se incluyen en el cálculo. Si hay dos o más celdas con los mismos valores, reciben la misma posición pero se consideran que toman sus propios lugares en la clasificación. Por lo tanto, el valor más elevado siguiente baja en la posición según el número de celdas de la posición anterior menos uno. Por ejemplo, si clasifica los valores 5,3,3,4,3,2, sus clasificaciones son 1,3,3,2,3,6. 

Por ejemplo, suponga que tiene los datos siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rank.png)


Aplicando la función **Clasificación** en las filas de la tabla, utilizando **Tabla transversal** en **Calcular como**, le ofrece los resultados siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rank2.png)


## Percentil
<a name="percentile"></a>

La función **Percentil** calcula el porcentaje de los valores de las celdas incluidas en el cálculo que tienen el mismo valor o inferior al de la celda en cuestión. 

Este porcentaje se calcula del siguiente modo. 

```
percentile rank(x) = 100 * B / N

Where:
   B = number of scores below x
   N = number of scores
```

Aplicando la función **Percentil** en las filas de la tabla, utilizando **Tabla transversal** en **Calcular como**, le ofrece los resultados siguientes.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/percentile.png)


# Formas de aplicar los cálculos de tabla dinámica
<a name="supported-applications"></a>

Puede aplicar los cálculos de tabla de las formas que se describen a continuación. Los cálculos de tabla se aplican únicamente a un campo a la vez. Por lo que si dispone de una tabla dinámica con varios valores, los cálculos solo se aplican a las celdas que representan el campo al que aplicó el cálculo.

**Topics**
+ [Tabla transversal](#table-across)
+ [Tabla descendente](#table-down)
+ [Tabla transversal descendente](#table-across-down)
+ [Tabla descendente transversal](#table-down-across)
+ [Grupo transversal](#group-across)
+ [Grupo descendente](#group-down)
+ [Grupo transversal descendente](#group-across-down)
+ [Grupo descendente transversal](#group-down-across)

## Tabla transversal
<a name="table-across"></a>

El uso de la opción **Tabla transversal** aplica el cálculo a través de las filas de la tabla dinámica, independientemente del grupo. Esta aplicación es el valor predeterminado. Por ejemplo, en el caso de la tabla dinámica siguiente.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sample-pivot.png)


Aplicar la función **Total acumulado** mediante la opción **Tabla transversal** le ofrece los siguientes resultados, con totales de fila en la última columna.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/table-across.png)


## Tabla descendente
<a name="table-down"></a>

El uso de la opción **Tabla descendente** aplica el cálculo en sentido descendente a lo largo de las columnas de la tabla dinámica, independientemente del grupo.

Aplicar la función **Total acumulado** mediante la opción **Tabla descendente** le ofrece los siguientes resultados, con los totales de columna en la última fila.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/table-down.png)


## Tabla transversal descendente
<a name="table-across-down"></a>

El uso de la opción **Tabla transversal descendente** aplica el cálculo a través de las filas de la tabla dinámica y, a continuación, toma los resultados y vuelve a aplicar el cálculo en sentido descendente por las columnas de la tabla dinámica.

Aplicar la función **Total acumulado** utilizando **Tabla transversal descendente** le ofrece los siguientes resultados. En este caso, los totales se suman en sentido descendente y transversal, con el total general en la celda inferior derecha.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total-across-down.png)


En este caso, suponga que aplica la función **Clasificación** con **Tabla transversal descendente**. Esto significa que las clasificaciones iniciales se determinan a través de las filas de la tabla y, a continuación, esas clasificaciones se clasifican a su vez en sentido descendente a lo largo de las columnas. Este enfoque le ofrece los siguientes resultados.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rank-table-across-down.png)


## Tabla descendente transversal
<a name="table-down-across"></a>

El uso de la opción **Tabla transversal descendente** aplica el cálculo en sentido descendente a lo largo de las columnas de la tabla dinámica. A continuación toma los resultados y vuelve a aplicar el cálculo a través de las filas de la tabla dinámica. 

Puede aplicar la función **Total acumulado** utilizando **Tabla descendente transversal** para obtener los siguientes resultados. En este caso, los totales se suman en sentido descendente y transversal, con el total general en la celda inferior derecha.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total-down-across.png)


Puede aplicar la función **Clasificación** utilizando **Tabla descendente transversal** para obtener los siguientes resultados. En este caso, las clasificaciones iniciales se determinen hacia abajo en las columnas de la tabla. A continuación, esas clasificaciones se clasifican a su vez en sentido transversal a través de las filas.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rank-table-down-across.png)


## Grupo transversal
<a name="group-across"></a>

El uso de la opción **Grupo transversal** aplica el cálculo a través de las filas de la tabla dinámica dentro de los límites de grupo, como determina el segundo nivel de agrupación aplicado a las columnas. Por ejemplo, si agrupa por campo 2 y seguidamente por campo 1, la agrupación se aplica en el nivel de campo 2. Si agrupa por campo 3, campo 2 y campo 1, la agrupación se vuelve a aplicar en el nivel de campo 2. Cuando no hay agrupación, la opción **Grupo transversal** devuelve los mismos resultados que la opción **Tabla transversal**. 

Por ejemplo, en el caso de la siguiente tabla dinámica donde las columnas se agrupan por `Service Line` y después por `Consumption Channel`.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sample-pivot.png)


Puede aplicar la función **Total acumulado** utilizando **Grupo transversal** para obtener los siguientes resultados. En este caso, la función se aplica a través de las filas, limitadas por las columnas para cada grupo de categoría de servicio. Las columnas `Mobile` muestran el total para ambos valores de `Consumption Channel` para la `Service Line` dada, para la `Customer Region` y `Date` (año) representado por la fila determinada. Por ejemplo, la celda resaltada representa el total para la región `APAC` para `2012`, para todos los valores `Consumption Channel` en la `Service Line` denominada `Billing`.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/group-across.png)


## Grupo descendente
<a name="group-down"></a>

El uso de **Grupo descendente** aplica el cálculo en sentido descendente a lo largo de las columnas de la tabla dinámica dentro de los límites de grupo, como determina el segundo nivel de agrupación aplicado a las filas. Por ejemplo, si agrupa por campo 2 y seguidamente por campo 1, la agrupación se aplica en el nivel de campo 2. Si agrupa por campo 3, campo 2 y campo 1, la agrupación se vuelve a aplicar en el nivel de campo 2. Cuando no hay agrupación, **Grupo descendente** devuelve los mismos resultados que **Tabla descendente**.

Por ejemplo, en el caso de la siguiente tabla dinámica donde las filas se agrupan por`Customer Region` y después por `Date` (año).

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sample-pivot.png)


Puede aplicar la función **Total acumulado** utilizando **Grupo descendente** para obtener los siguientes resultados. En este caso, la función se aplica hacia abajo en sentido descendente a lo largo de las columnas, limitadas por las filas para cada grupo de `Customer Region`. Las filas `2014` muestran el total para todos los años para la `Customer Region` dada, para la `Service Line` y `Consumption Channel` representados por la columna dada. Por ejemplo, la celda resaltada representa el total para la región `APAC`, para el servicio `Billing` para el canal `Mobile`, para todos los valores `Date` (años) que se muestran en el informe.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/group-down.png)


## Grupo transversal descendente
<a name="group-across-down"></a>

El uso de la opción **Grupo transversal descendente** aplica el cálculo a través de las filas dentro de los límites de grupo, como determina el segundo nivel de agrupación aplicado a las columnas. A continuación la función toma los resultados y vuelve a aplicar el cálculo en sentido descendente en las columnas de la tabla dinámica. Lo hace dentro de los límites del grupo, como determina el segundo nivel de agrupación que se aplica a las filas. 

Por ejemplo, si agrupa una fila o una columna por campo 2 y seguidamente por campo 1, la agrupación se aplica en el nivel de campo 2. Si agrupa por campo 3, campo 2 y campo 1, la agrupación se vuelve a aplicar en el nivel de campo 2. Cuando no hay agrupación, la opción **Grupo transversal descendente** devuelve los mismos resultados que **Tabla transversal descendente**.

Por ejemplo, en el caso de la siguiente tabla dinámica donde las columnas se agrupan por `Service Line` y después por `Consumption Channel`. Las filas se agrupan por `Customer Region` y, a continuación, por `Date` (año).

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sample-pivot.png)


Puede aplicar la función **Total acumulado** utilizando **Grupo transversal descendente** para obtener los siguientes resultados. En este caso, los totales se suman en sentido descendente y transversal dentro de los límites de grupo. Aquí, estos límites son `Service Line` para las columnas y `Customer Region` para las filas. El total general aparece en la celda inferior derecha para el grupo.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total-group-across-down.png)


Puede aplicar la función **Clasificación** utilizando **Grupo transversal descendente** para obtener los siguientes resultados. En este caso, la función se aplica primero en sentido transversal en las filas, limitadas por cada grupo de `Service Line`. A continuación, la función se aplica de nuevo a los resultados de ese primer cálculo; esta vez se aplica en sentido descendente a lo largo de las columnas limitadas por cada grupo de `Customer Region`.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rank-group-across-down.png)


## Grupo descendente transversal
<a name="group-down-across"></a>

El uso de la opción **Grupo descendente transversal** aplica el cálculo a las columnas dentro de los límites de grupo, como determina el segundo nivel de agrupación que se aplica a las filas. A continuación, Amazon Quick toma los resultados y vuelve a aplicar el cálculo en las filas de la tabla dinámica. Una vez más, vuelve a aplicar el cálculo dentro de los límites del grupo, como determina el segundo nivel de agrupación que se aplica a las columnas. 

Por ejemplo, si agrupa una fila o una columna por campo 2 y seguidamente por campo 1, la agrupación se aplica en el nivel de campo 2. Si agrupa por campo 3, campo 2 y campo 1, la agrupación se vuelve a aplicar en el nivel de campo 2. Cuando no hay agrupación, la opción **Grupo descendente transversal** devuelve los mismos resultados que **Tabla descendente transversal**.

Por ejemplo, en el caso de la tabla dinámica siguiente. Las columnas se agrupan por `Service Line` y, a continuación, por `Consumption Channel`. Las filas se agrupan por `Customer Region` y, a continuación, por `Date` (año).

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/sample-pivot.png)


Puede aplicar la función **Total acumulado** utilizando **Grupo descendente transversal** para obtener los siguientes resultados. En este caso, los totales se suman en sentido descendente y transversal dentro de los límites de grupo. En este caso, son `Service Category` para las columnas y `Customer Region` para las filas. El total general se encuentra en la celda inferior derecha para el grupo.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/running-total-group-across-down.png)


Puede aplicar la función **Clasificación** utilizando **Grupo descendente transversal** para obtener los siguientes resultados. En este caso, la función se aplica primero hacia abajo en sentido descendente a lo largo de las columnas, limitadas por cada grupo de `Customer Region`. A continuación, la función se aplica de nuevo a los resultados de ese primer cálculo; esta vez se aplica en sentido transversal a lo largo de las filas limitadas por cada grupo de `Service Line`.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/rank-group-down-across.png)


# Limitaciones de las tablas dinámicas
<a name="pivot-table-limitations"></a>

Las limitaciones siguientes son aplicables a tablas dinámicas:
+ Puede crear tablas dinámicas con hasta 500 000 registros.
+ Puede agregar cualquier combinación de valores de campo de fila y columna hasta un total de 40. Por ejemplo, si tiene 10 valores de campo de fila, puede agregar hasta 30 valores de campo de columna.
+ Puede crear los cálculos de tabla dinámica solo en valores no agregados. Por ejemplo, si crea un campo calculado que es la suma de una medida, además no puede añadirle un cálculo de tabla dinámica. 
+ Si realiza la ordenación por una métrica personalizada, no se puede añadir un cálculo de tabla hasta que elimine la ordenación de métrica personalizada.
+ Si utiliza un cálculo de tabla y, a continuación, añada una métrica personalizada, no puede ordenar por la métrica personalizada.
+ Los totales y subtotales están en blanco para cálculos de tabla en métricas agregadas por recuento distinto.

# Prácticas recomendadas para tablas dinámicas
<a name="pivot-table-best-practices"></a>

Es mejor implementar un conjunto mínimo de filas, columnas, métricas y cálculos de tabla, en lugar de ofrecer todas las combinaciones posibles en una tabla dinámica. Si se incluyen demasiadas, corre el riesgo de abrumar al lector y también puede alcanzar las limitaciones de proceso de la base de datos subyacente. 

Para reducir el nivel de complejidad y el potencial de errores, puede realizar las acciones siguientes: 
+ Aplicar filtros para reducir los datos incluidos para el elemento visual.
+ Usar menos campos en los cuadros de campos **Fila** y **Columna**.
+ Usar el mínimo de campos como sea posible en el cuadro de campos **Valores**.
+ Crear tablas dinámicas adicionales, de modo que cada una muestre menos métricas.

En algunos casos, hay una necesidad de negocio de examinar numerosas métricas relacionadas entre sí. En estos casos, puede ser mejor utilizar varios elementos visuales en el mismo panel, de modo que cada uno muestre una sola métrica. Puede reducir el tamaño de los elementos visuales en el panel y colocarlos para formar una agrupación. Si una decisión que el lector toma en función de un elemento visual crea la necesidad de una vista diferente, puede implementar acciones de URL personalizadas para lanzar otro panel de acuerdo con las selecciones del usuario.

Le recomendamos que considere los elementos visuales como bloques de construcción. En lugar de utilizar un elemento visual para varios propósitos, use cada elemento visual para facilitar un aspecto de una decisión de negocio más amplia. El lector debe tener suficientes datos para tomar una decisión bien informada, sin sentirse abrumado por la inclusión de todas las posibilidades. 

# Uso de gráficos radiales
<a name="radar-chart"></a>

Puede utilizar gráficos radiales, también conocidos como gráficos de araña, para visualizar datos multivariantes en Amazon Quick. En un gráfico radial, se representan uno o más grupos de valores sobre varias variables comunes. Cada variable tiene su propio eje y cada eje está dispuesto de forma radial alrededor de un punto central. Los puntos de datos de una sola observación se representan en cada eje y se conectan entre sí para formar un polígono. Se pueden representar varias observaciones en un único gráfico radial para mostrar varios polígonos, lo que facilita la detección rápida de valores periféricos de varias observaciones. 

En Quick, puede organizar un gráfico radial según sus ejes de categorías, valores o colores arrastrando y soltando campos en los campos de **categoría**, **valor** y **color**. La forma en que elija distribuir los campos en los cuadros de campo determina el eje en el que se representan los datos.

En la siguiente imagen se muestra un ejemplo de gráfico radial.

![\[Gráfico radial que representa las variables de satisfacción de los empleados por departamento.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/radar-chart-example.png)


## Características de los gráficos radiales
<a name="radar-chart-features"></a>

Utilice la siguiente tabla para ver las características que admiten los gráficos radiales.


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | Sí |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí |  |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Limitado | Solo puede ordenar los campos de datos que se encuentren en los cuadros de campo Categoría y Color. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí |  | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | No compatible |  | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Selección del tamaño | Sí |  | [Formatear en Amazon Quick](formatting-a-visual.md) | 
| Mostrar totales | No compatible |  | [Formatear en Amazon Quick](formatting-a-visual.md) | 

## Creación de un gráfico radial
<a name="create-radar-chart"></a>

Utilice el siguiente procedimiento para crear un gráfico radial.

**Creación de un gráfico radial**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija el icono de gráfico radial.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. En la mayoría de los casos, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino.

   Para crear un gráfico radial, arrastre los campos a los cuadros de campo **Categoría**, **Valor** y **Grupo/color**. El eje en torno al cual se organiza un gráfico radial depende de la forma en que se organizan los campos en sus respectivos cuadros de campo:
   + En un gráfico radial que utiliza un **eje de valores**, los valores de las dimensiones se muestran como líneas y los ejes representan campos de valores. Para crear un gráfico radial que utilice un eje de valores, añada un campo de categoría al campo **Color** y uno o más valores al campo **Valor**.
   + En un gráfico radial que utiliza un **eje dimensional**, los valores de las dimensiones de grupo se muestran como ejes y los campos de valores se muestran como líneas. Todos los ejes comparten un rango y una escala. Para crear un gráfico radial que utilice un eje dimensional, añada una dimensión al campo **Grupo** y uno o más valores al cuadro de campo **Valor**.
   + En un gráfico radial que utiliza un **eje dimensional de color**, los valores de las dimensiones de grupo se muestran como ejes y los valores de dimensiones de color se muestran como líneas. Todos los ejes comparten un rango y una escala. Para crear un gráfico radial que utiliza un eje dimensional de color, añada una dimensión al cuadro de campo **Categoría**, un valor al cuadro de campo **Valor** y una dimensión al cuadro de campo **Color**.

# Uso de diagramas de Sankey
<a name="sankey-diagram"></a>

Utilice los diagramas de Sankey para mostrar los flujos de una categoría a otra, o las rutas de una etapa a la siguiente.

Por ejemplo, un diagrama de Sankey puede mostrar el número de personas que migran de un país a otro. Un diagrama de Sankey también puede mostrar la ruta que sigue un visitante web de una página a la siguiente en el sitio web de una empresa, con posibles paradas en el recorrido.

## Datos para los diagramas de Sankey
<a name="sankey-diagram-data"></a>

Para crear diagramas de Sankey en Quick, el conjunto de datos debe contener una medida y dos dimensiones (una dimensión que contiene las categorías de origen y otra que contiene las categorías de destino).

La siguiente tabla muestra un ejemplo sencillo de datos para un diagrama de Sankey.


| Dimensión (origen) | Dimensión (destino) | Medida (peso) | 
| --- | --- | --- | 
|  A  |  W  |  500  | 
|  A  |  X  |  23  | 
|  A  |  Y  |  147  | 

El siguiente diagrama de Sankey se crea cuando las dimensiones y la medida se añaden al cuadro de campo, con el nodo A de la izquierda vinculado con los nodos W, Y y X de la derecha. El ancho de cada vínculo entre los nodos depende del valor de la columna Medida (peso). Los nodos se ordenan de forma automática.

Para crear diagramas Sankey de varios niveles en Amazon Quick, el conjunto de datos debe contener una medida y dos dimensiones (una para el origen y otra para el destino), pero en este caso los valores de los datos son diferentes.

La siguiente tabla muestra un ejemplo sencillo de datos para un diagrama de Sankey de varios niveles.


| Dimensión (origen) | Dimensión (destino) | Medida (peso) | 
| --- | --- | --- | 
|  A  |  W  |  500  | 
|  A  |  X  |  23  | 
|  A  |  Y  |  147  | 
|  W  |  Z  |  300  | 
|  X  |  Z  |  5  | 
|  Y  |  Z  |  50  | 

El siguiente diagrama de Sankey se crea cuando las dimensiones y la medida se añaden al cuadro de campo. Aquí, el nodo A de la izquierda se vincula con los nodos W, Y y X del centro y, a continuación, los nodos W, Y y X se vinculan con el nodo Z de la derecha. El ancho de cada vínculo entre los nodos depende del valor de la columna Medida (peso).

### Uso de datos cíclicos
<a name="sankey-diagram-cycle"></a>

A veces, los datos que se utilizan para un diagrama de Sankey contienen ciclos. Por ejemplo, supongamos que visualiza los flujos de tráfico de usuarios de las páginas de un sitio web. Puede que descubra que los usuarios que acceden a la página A pasan a la página E y, a continuación, regresan a la página A. Un flujo completo podría tener un aspecto similar a A-E-A-B-A-E-A.

Cuando los datos contienen ciclos, los nodos de cada ciclo se repiten en Quick. Por ejemplo, si los datos contienen el flujo A-E-A-B A-E-A, se crea el siguiente diagrama de Sankey.

## Preparación de datos para los diagramas de Sankey
<a name="sankey-diagram-prepare"></a>

Si su conjunto de datos no contiene columnas de origen o destino, prepare los datos para incluirlas. Puede preparar los datos cuando cree un nuevo conjunto de datos o al editar un conjunto de datos existente. Para obtener más información sobre la creación de un nuevo conjunto de datos y su preparación, consulte [Creación de conjuntos de datos](creating-data-sets.md). Para obtener más información sobre la apertura de un conjunto de datos existente para la preparación de datos, consulte [Edición de conjuntos de datos](edit-a-data-set.md).

El siguiente procedimiento utiliza una tabla de ejemplo (que se ilustra a continuación) para demostrar cómo preparar los datos para los diagramas de Sankey en Quick. La tabla incluye tres columnas: ID de cliente, Hora y Acción.


| ID de de cliente | Time | Action | 
| --- | --- | --- | 
|  1  |  9:05 a. m.  |  Paso 1  | 
|  1  |  9:06 a. m.  |  Paso 2  | 
|  1  |  9:08 a. m.  |  Paso 3  | 
|  2  |  11:44 a. m.  |  Paso 1  | 
|  2  |  11:47 a. m.  |  Paso 2  | 
|  2  |  11:48 a. m.  |  Paso 3  | 

Para crear un diagrama de Sankey en Quick con estos datos, primero añada las columnas de origen y destino a la tabla. Utilice el siguiente procedimiento para obtener información sobre cómo hacerlo.

**Adición de las columnas Origen y Destino a la tabla**

1. Agregue la columna Número de pasos a la tabla para numerar o clasificar cada fila.

   La columna Número de pasos se puede calcular de varias formas. Si la fuente de datos es compatible con SQL y la base de datos es compatible `ROW_NUMBER` o `RANK` funciona, puede utilizar el SQL personalizado en Quick para ordenar las filas de la columna Número de pasos. Para obtener más información sobre el uso de SQL personalizado en Quick, consulte[Uso de SQL para personalizar los datos](adding-a-SQL-query.md).    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/sankey-diagram.html)

1. Agregue la columna Número de fila siguiente a la tabla con valores iguales a los de la columna Número de pasos más uno.

   Por ejemplo, en la primera fila de datos de la tabla, el valor de Número de pasos es 1. Para calcular el valor de Número de pasos siguientes para esa fila, añada 1 a ese valor.

   1 \$1 1 = 2

   El valor de Número de pasos de la segunda fila de datos de la tabla es 2; por lo tanto, el valor de Número de pasos siguientes es 3.

   2 \$1 1 = 3    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/sankey-diagram.html)

1. Una la tabla a consigo misma:

   1. En **Tipo de Join**, seleccione **Interior**.

   1. En **Cláusulas de Join**, haga lo siguiente:

      1. Elija **ID de cliente** = **ID de cliente**.

      1. Elija **Número de pasos siguientes** = **Número de pasos**

   Al unir las dos tablas, se crean dos columnas para ID de cliente, Hora, Acción, Número de pasos y Número de pasos siguientes. Las columnas de la tabla situada a la izquierda de la unión son las columnas de origen. Las columnas de la tabla situada a la izquierda de la unión son las columnas de destino.

   Para obtener más información sobre cómo unir datos en Quick, consulte[Unir datos](joining-data.md).

1. (Opcional) Cambie el nombre de las columnas para indicar los orígenes y los destinos.

   A continuación, se muestra un ejemplo:

   1. Cambie el nombre de la columna **Acción** de la izquierda a **Origen**.

   1. Cambie el nombre de la columna **Acción [copiar]** de la derecha a **Destino.**

   1. Cambie el nombre de la columna **Hora** de la izquierda a **Hora de inicio**.

   1. Cambie el nombre de la columna **Hora [copiar]** de la derecha a **Hora de finalización**.

   Los datos están listos para su visualización.

## Creación de diagramas de Sankey
<a name="sankey-diagram-create"></a>

Utilice el siguiente procedimiento para crear un diagrama de Sankey.

**Creación de un diagrama de Sankey**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas de la izquierda.

1. En la barra de aplicaciones, elija **Agregar** y, a continuación, elija **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija el icono del diagrama de Sankey.

1. En el menú de la parte superior derecha del elemento visual, seleccione el icono **Propiedades**.

1. En el panel **Propiedades**, elija la sección **Origen** o **Destino**.

### Personalización del número de nodos
<a name="sankey-diagram-number-nodes"></a>

Utilice el siguiente procedimiento para personalizar el número de nodos que se muestran en un diagrama de Sankey. Quick admite hasta 100 nodos de origen/destino.

**Personalización del número de nodos que se muestran en un diagrama de Sankey**

1. En la página de análisis, elija el elemento visual del diagrama de Sankey al que desee cambiar el formato.

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

1. En el panel **Propiedades** que se abrirá, elija la pestaña **Origen** o **Destino**.

1. En **Número de nodos mostrados**, introduzca un número.

   Los nodos del diagrama se actualizan al número especificado. Los nodos superiores se muestran automáticamente. Todos los demás nodos se colocan en la categoría **Otros**.
**nota**  
Especificar el número de nodos de origen controla el número de nodos de origen que pueden aparecer en el diagrama. Especificar el número de nodos de destino controla el número de nodos de destino que pueden aparecer por cada nodo de origen. Esto significa que si hay más de un nodo de origen en el diagrama, el número total de nodos de destino será superior al número especificado.   
Quick admite hasta 100 nodos de origen/destino.

   Por ejemplo, el siguiente diagrama de Sankey tiene un límite de tres nodos de origen (de un total de cinco), por lo que se muestran los tres primeros en el diagrama. Los otros dos nodos de origen se sitúan en la categoría Otros.

   Para eliminar la categoría **Otros** del diagrama, selecciónela en la vista y elija **Ocultar la categoría “Otros”**.

## Características de los diagramas de Sankey
<a name="sankey-diagram-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los diagramas de Sankey.


| Característica | ¿Se admite? | Para obtener más información | 
| --- | --- | --- | 
| Cambiar la visualización de la leyenda | No |  | 
| Cambiar la visualización del título | Sí | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No |  | 
| Cambiar los colores del elemento visual | No |  | 
| Centrarse en los elementos o excluirlos | Sí |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md)  | 
| Ordenar | No |  | 
| Realización de la agregación de campos | Sí | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | No |  | 
| Formato condicional | No |  | 

# Uso de gráficos de dispersión
<a name="scatter-plot"></a>

Use gráficos de dispersión para visualizar dos o tres medidas en dos dimensiones.

Cada burbuja del gráfico de dispersión representa uno o dos valores de dimensión. Los ejes X e Y representan dos medidas distintas que se aplican a la dimensión. Una burbuja aparece en el gráfico en el punto en que los valores para las dos medidas de un elemento en la dimensión se cruzan. Si lo prefiere, también puede utilizar el tamaño de la burbuja para representar una medida adicional. 

Los gráficos de dispersión muestran hasta 2500 puntos de datos en escenarios agregados y no agregados, independientemente de si se utiliza una dimensión de color o de etiqueta en la imagen en el elemento visual. Debido al orden de las operaciones de límite, puede haber casos en los que se muestren menos puntos de datos para un conjunto de datos. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los gráficos de dispersión
<a name="scatter-plot-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos de dispersión.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí, con excepciones | Los gráficos de dispersión muestran una leyenda si ha completado el cuadro de campo Grupo/color.  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | Sí | Puede definir el intervalo para los ejes X e Y. | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Mostrar u ocultar las líneas de los ejes, las líneas de cuadrícula, las etiquetas de los ejes y los iconos de ordenación de ejes | Sí |  | [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md) | 
| Cambiar los colores del elemento visual | Sí |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en una burbuja en un gráfico de dispersión o excluirla, excepto cuando utiliza un campo de fecha como una dimensión. En ese caso, solo puede centrarse en una burbuja, no excluirla. |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | No |  | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación a los campos que elija para los ejes X e Y y el tamaño y no puede aplicar la agregación al campo que elija para grupo o color. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Mostrar campos no agregados | Sí | En el menú contextual del campo, seleccione Ninguno para mostrar los valores no agregados de los ejes X e Y. Si el diagrama de dispersión muestra campos no agregados, no podrá aplicar las agregaciones al campo que se encuentra en el cuadro de campo de color o etiqueta. Los gráficos de dispersión no admiten la agregación mixta. |  | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose al cuadro de campo Grupo/color. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 

## Creación de un gráfico de dispersión
<a name="create-scatter-plot"></a>

Utilice el siguiente procedimiento para crear un gráfico de dispersión.

**Creación de un gráfico de dispersión**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Visual types**, elija el icono de gráfico de dispersión.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.

   Para crear un gráfico de dispersión, arrastre una medida al cuadro de campo **Eje X**, una medida al cuadro de campo **Eje Y** y una dimensión al cuadro de campo **Color** o **Etiqueta**. Para representar otra medida con tamaño de burbuja, arrastre esa medida al cuadro de campo **Tamaño**.

1. (Opcional) Arrastre uno o más campos adicionales al cuadro de campo **Color** para añadir capas de desglose. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

## Casos de uso de los diagramas de dispersión
<a name="scatter-use-cases"></a>

Puede representar valores no agregados incluso si utiliza un campo en Color mediante la opción de agregación **ninguno** del menú de campos, que también contiene opciones de agregación como, por ejemplo, **suma**, **mínimo** y **máximo**. Si un valor está configurado para agregarse, el otro valor se establecerá automáticamente como agregado. Lo mismo sucede con los escenarios no agregados. No se admiten los escenarios de agregación mixta, lo que significa que un valor no se puede establecer como agregado si el otro es un valor no agregado. Tenga en cuenta que el escenario no agregado, que corresponde con la opción **ninguno**, solo se admite para valores numéricos, mientras que los valores categóricos, como, por ejemplo, las fechas o dimensiones, solo mostrarán valores agregados, como, por ejemplo, **recuento** y **contar elementos distintos**.

Si utiliza la opción **ninguno**, podrá configurar los valores de X e Y como agregados o no agregados desde los menús de campo **Eje X** y **Eje Y**. Esto definirá si los valores se agregarán o no por dimensiones en los cuadros de campo **Color** y **Etiqueta**. Para empezar, añada los campos obligatorios y elija la agregación adecuada en función de su caso de uso, tal como se muestra en las siguientes secciones. 

### Casos de uso no agregados
<a name="advanced-scatter-plot-options-unaggregated"></a>
+ Valores X e Y no agregados con color  
![\[color, no agregado\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/unaggregated-color.png)
+ Valores X e Y no agregados con etiqueta  
![\[etiqueta, no agregado\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/unaggregated-label.png)
+ Valores X e Y no agregados con color y etiqueta  
![\[unaggregated-color-label\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/unaggregated-color-label.png)

### Casos de uso agregados
<a name="advanced-scatter-plot-options-aggregated"></a>
+ Valores X e Y agregados con color  
![\[color, agregado\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/aggregated-color.png)
+ Valores X e Y agregados con etiqueta  
![\[etiqueta, agregado\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/aggregated-label.png)
+ Valores X e Y agregados con color y etiqueta  
![\[aggregated-color-label\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/aggregated-color-label.png)

# Uso de tablas como elementos visuales
<a name="tabular"></a>

Utilice un elemento visual para ver una vista de tabla personalizada de los datos. Para crear un elemento visual, elija al menos un campo de cualquier tipo de datos. Puede agregar tantas columnas como necesite hasta un máximo de 200. Además, puede añadir columnas calculadas.

Los elementos visuales de tabla no muestran una leyenda. Puede ocultar o mostrar el título de una tabla. También puede ocultar o mostrar los totales y, a continuación, elegir mostrar los totales en la parte superior o la parte inferior de la tabla. Para obtener más información, consulte [Formato de análisis por tipo en Quick](analytics-format-options.md). 

**Creación de un elemento visual de tabla**

1. Abre Amazon Quick y selecciona **Analyses** en el panel de navegación de la izquierda.

1. Seleccione una de las siguientes opciones:
   + Para crear un análisis nuevo, elija **Nuevo análisis** en la parte superior derecha. Para obtener más información, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md). 
   + Para usar un análisis existente, elija el análisis que desea editar.

1. Seleccione **Insertar** en el menú del archivo y, a continuación, **Agregar elemento visual**.

1. En la parte inferior izquierda, seleccione el icono de la tabla de **Tipos de elementos visuales**.

1. En el panel **Lista de campos**, elija los campos que desea utilizar. Si desea agregar un campo calculado, elija **Insertar** en el menú de archivo y, a continuación, elija **Agregar campo calculado**.

   Para crear una vista no agregada de los datos, agregue campos solo al cuadro de campo **Valor**. Esto muestra los datos sin agregaciones. 

   Para crear una vista agregada de los datos, elija los campos que desea agregar y, a continuación, añádalos al cuadro de campo **Agrupar por**.

**Pasos para mostrar u ocultar columnas en una tabla**

1. En el elemento visual, elija el campo que desea ocultar y, a continuación, elija **Ocultar columna**.

1. Para mostrar columnas ocultas, elija cualquiera de las columnas y después elija **Mostrar todas las columnas ocultas**.

**Transposición de columnas a filas y filas a columnas**
+ Seleccione el icono de transposición (![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/transpose-icon.png)), que se encuentra cerca de la parte superior derecha del elemento visual. Tiene dos flechas en un ángulo de 90 grados..

**Alineación vertical de columnas**

1. En el elemento visual, elija el icono **Formato del elemento visual** (![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/format-visual-icon.png)) situado cerca de la parte superior derecha del elemento visual.

1. En el panel **Propiedades**, elija **Opciones de la tabla** y elija la alineación vertical de la tabla.

**Ajuste del texto de los encabezados**

1. En el elemento visual, elija el icono **Formato del elemento visual** (![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/format-visual-icon.png)) situado cerca de la parte superior derecha del elemento visual.

1. En el panel **Propiedades**, elija **Opciones de la tabla** y seleccione **Ajustar texto del encabezado**.

**Reorganización de las columnas de un gráfico de tabla**

1. Abra el análisis con el elemento visual que desea ordenar. El panel de elementos visuales estará abierto de forma predeterminada.

1. Realice una de las siguientes acciones:
   + Arrastre y suelte uno o más campos en **Cuadros de campo** para reorganizar su orden.
   + Seleccione un campo directamente en la tabla y elija la flecha izquierda o derecha en **Mover columna**.

# Uso de estilos de campo
<a name="field-styling"></a>

Puede renderizar URLs una tabla como enlaces mediante el panel de **estilos de campo** del menú visual de formatos. Puede añadir hasta 500 filas de vínculos para cada página de una tabla. Solo se admiten los hipervínculos https y mailto.

**Adición de vínculos a las tablas**

1. En la página principal de Quick, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. Elija la tabla que desea cambiar.

1. En el menú de la parte superior derecha de la tabla, elija **Formato del elemento visual**.

1. En **Formato del elemento visual**, elija **Estilo de campo**.

1. En el panel **Estilo de campo**, elija el campo al que desee aplicar estilo en el menú. 

1. En la sección de **opciones de URL** del menú de **estilos de campo**, seleccione **Crear URLs hipervínculos**.

Tras añadir vínculos a la tabla, podrá elegir dónde desea que se abran los vínculos cuando se seleccionen en la sección **Abrir en** del panel **Estilo de campo**. Puede especificar que los enlaces se abran en una pestaña nueva, en una ventana nueva o en la misma pestaña.

También puede elegir el estilo que desea aplicar al vínculo en la sección **Formatear como** del panel **Estilo de campo**. Los enlaces pueden aparecer como hipervínculos, iconos o texto sin formato, o bien puede configurar un vínculo personalizado. 

Para ajustar el tamaño de fuente del icono o la URL de un vínculo, cambie el valor de **Tamaño de fuente** en la sección **Celdas** del panel **Opciones de tabla** del menú **Formato del elemento visual**.

Puedes configurar cualquier elemento de URLs la tabla que apunte a imágenes para que se represente en la tabla como imágenes. Esto puede resultar útil cuando desea incluir una imagen de un producto como parte de una tabla.

**Para mostrarlas URLs como imágenes**

1. En la página de inicio rápida, elija **Análisis** y, a continuación, elija el análisis que desee personalizar.

1. Elija la tabla que desea cambiar.

1. En el menú de la parte superior derecha de la tabla, elija **Formato del elemento visual**.

1. En el menú **Formato del elemento visual**, elija **Estilo de campo**.

1. En el panel **Estilo de campo**, elija el campo al que desee aplicar estilo desde el menú. 

1. En la sección de **opciones de URL** del menú de **estilos de campo**, seleccione **Mostrar URLs como imágenes**.

Tras representar las imágenes en una tabla, puede elegir el tamaño de las imágenes en la sección **Tamaño de la imagen** del panel **Estilo de campo**. Puede ajustar las imágenes al alto o ancho de su celda, o bien puede optar por no escalar la imagen. Las imágenes se ajustan a la altura de la celda de forma predeterminada. 

# Inmovilización de columnas para convertirlas en elementos visuales de una tabla
<a name="tables-freeze-columns"></a>

Puede inmovilizar columnas de los elementos visuales de sus tablas para bloquear columnas específicas en su lugar en la pantalla. Esto permite que la información esencial permanezca visible mientras los lectores se desplazan por la tabla. Puede inmovilizar las columnas de una en una, o bien puede inmovilizar grupos de columnas con una sola acción. Todas las columnas ancladas se fijan en el extremo izquierdo de la tabla y permanecen visibles en la pantalla en todo momento. Esto permite a los lectores rápidos tener un punto de referencia constante para los datos o la información clave a medida que interactúan con otras partes de la tabla.

**Inmovilización de las columnas en una tabla**

1. En la tabla en la que desee congelar una columna, elija la columna que desee anclar.

1. Elija una de las siguientes opciones.
   + Para inmovilizar una sola columna, Elija **Congelar columna**.
   + Para inmovilizar todas las columnas hasta la columna que elija, seleccione **Congelar hasta esta columna**.

Si la tabla tiene varias columnas ancladas, puede reordenar las columnas en el orden que desee. Para ajustar el orden de las columnas ancladas en una tabla, elija el encabezado de la columna que desee mover y, a continuación, elija **Mover** en la dirección que desee.

**Desbloqueo de las columnas de una tabla**

1. En la tabla que desee cambiar, elija la columna anclada que desee desanclar.

1. Elija una de las siguientes opciones.
   + Para desbloquear una sola columna, elija **Descongelar columna**.
   + Para desbloquear todas las columnas inmovilizadas, elija **Descongelar todas las columnas**.

# Valores totales personalizados
<a name="tables-pivot-tables-custom-totals"></a>

Los autores rápidos pueden definir las agregaciones totales y subtotales para sus imágenes de tabla o tabla dinámica de los pozos de campo. En el caso de las tablas, el menú de totales personalizados solo está disponible si los totales están activados para el elemento visual.

**Cambio de la agregación de un total o un subtotal**

1. Navegue hasta el análisis que desee cambiar y elija el elemento visual de la tabla o tabla dinámica cuyo total desee definir.

1. Elija el campo que desee cambiar en los cuadros de campo.

1. Elija **Total** y, a continuación, elija la agregación que desee. Están disponibles las siguientes opciones.
   + **Predeterminado**: el cálculo total utiliza la misma agregación que el campo métrico.
   + **Suma**: calcula la suma de los datos del elemento visual.
   + **Promedio**: calcula el promedio de los datos del elemento visual.
   + **Mínimo**: calcula el valor mínimo de los datos del elemento visual.
   + **Máximo**: calcula el valor máximo de los datos del elemento visual.
   + **Ninguno (OCULTAR)**: los totales no se calculan. Al elegir esta opción, las celdas de total y subtotal de la imagen se dejan en blanco. Si la dimensión exterior se ordena con el campo métrico que calcula el total o el subtotal, la dimensión se ordena alfabéticamente. Al cambiar el valor de **Ninguno (OCULTAR)** a otro valor, la dimensión exterior se ordena según los subtotales que se calculan con el tipo de agregación especificado.

A continuación se detallan las limitaciones que se aplican a los totales personalizados.
+ No se admite el formato condicional para los totales personalizados.
+ Las agregaciones totales no son compatibles con las columnas de cadenas. Las agregaciones totales incluyen **Mínimo**, **Máximo**, **Suma** y **Promedio**.
+ Las columnas de fecha no son compatibles con las funciones de agregación de totales **Promedio** y **Suma**.

# Ordenación de tablas
<a name="table-sort"></a>

En Amazon Quick, puede ordenar los valores de una tabla por campos en los encabezados de las columnas de la tabla o con la herramienta **visual Ordenar**. Puede ordenar hasta 10 columnas en una sola tabla. **Quick también puede utilizar una ordenación no visual. Puede ordenar las columnas en orden **ascendente** o descendente.** La siguiente imagen muestra el icono **Ordenar elemento visual** y una ventana emergente.

![\[Se abren el icono Ordenar elemento visual y el cuadro emergente Ordenar elemento visual.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/table-sort-icon.png)


## Opciones de ordenación de una sola columna
<a name="table-sort-single-column"></a>

**Los autores rápidos pueden acceder a las opciones de clasificación de una sola columna desde los campos, los encabezados de las columnas o desde el menú visual Ordenar.** Utilice el siguiente procedimiento para configurar una ordenación de columnas individuales en una tabla en Quick.

1. Abra la [consola rápida](https://quicksight.aws.amazon.com/).

1. Abra el análisis en el que desee trabajar y navegue hasta la tabla que desee ordenar.

1. Elija el encabezado de la columna que desee ordenar.

1. En **Ordenar por**, elija el icono de flecha y, a continuación, elija el campo por el que desee ordenar.

También puede configurar una ordenación de una sola columna en el menú **Ordenar elemento visual**. Para acceder al menú de ordenación de elemento visual, seleccione el icono **Ordenar elemento visual** en el menú visual. En el menú **Ordenar elemento visual**, elija el campo según el que desee ordenar y, a continuación, elija si desea ordenar en orden ascendente o descendente. De forma predeterminada, las nuevas ordenaciones se clasifican en orden ascendente. Cuando haya terminado elija **Aplicar**.

Las tablas que utilizan la ordenación de una sola columna se ordenan columna por columna. Cuando un usuario elige una nueva columna para ordenar, se anula el orden de clasificación anterior.

Para realizar cambios en la ordenación de una sola columna, abra el menú **Ordenar elemento visual** y use los menús desplegables para elegir un nuevo campo u orden de clasificación. Cuando termine de realizar los cambios, elija **APLICAR**.

Para restablecer una tabla a su estado original, abra el menú **Ordenar elemento visual** y elija **RESTABLECER**.

## Opciones de ordenación de varias columnas
<a name="table-sort-multi-column"></a>

Los autores rápidos pueden acceder a las opciones de ordenación de varias columnas desde el menú **visual Ordenar**. Utilice el procedimiento que se indica a continuación para configurar una clasificación de varias columnas para una tabla.

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el análisis en el que desee trabajar y navegue hasta la tabla que desee ordenar.

1. Seleccione el icono **Ordenar elemento visual** para abrir el menú **Ordenar elemento visual**.

   1. También puede elegir un encabezado que desee ordenar.

   1. En **Ordenar por**, seleccione el icono de flecha y, a continuación, seleccione **Varios campos**.

1. En el menú **Ordenar elemento visual** que se abrirá, elija un campo del menú desplegable **Ordenar por** y, a continuación, elija si desea que el campo se ordene en orden ascendente o descendente.

1. Para añadir otra clasificación, seleccione **AGREGAR ORDENACIÓN** y repita el flujo de trabajo del paso 4. Puede agregar hasta 10 ordenaciones a cada tabla.

1. Cuando haya terminado elija **APLICAR**.

Las columnas se ordenan en el orden en que se agregan al menú **Ordenar elemento visual**. Para cambiar el orden en que se ordenan las columnas, abra el menú **Ordenar elemento visual** y use los menús desplegables **Ordenar por** para volver a ordenar las clasificaciones. Cuando haya terminado, elija **APLICAR** para aplicar el nuevo orden de clasificación a la tabla.

Para restablecer una tabla a su estado original, abra el menú **Ordenar elemento visual** y elija **RESTABLECER**.

## Opciones de ordenación no visuales
<a name="table-sort-off-visual"></a>

Los autores rápidos pueden configurar una ordenación no visual para ordenar los valores de una tabla por un campo y por una agregación que forma parte del conjunto de datos que utiliza la tabla, pero no en uno de los campos de la tabla. Se puede configurar una ordenación no visual del campo en una sola tabla a la vez.

Utilice el siguiente procedimiento para configurar una ordenación no visual.

**Adición de una ordenación no visual a una tabla**

1. Abre la [consola rápida.](https://quicksight.aws.amazon.com/)

1. Abra el análisis en el que desee trabajar y navegue hasta la tabla que desee ordenar.

1. Elija el encabezado de cualquier columna de la tabla.

1. En **Ordenar por**, seleccione el icono de flecha y, a continuación, seleccione **Campo no visual**.

1. En el panel **Campo no visual** que aparecerá, abra el menú desplegable **Ordenar por** y elija el campo que desee ordenar.

1. En **Agregación**, abra el menú desplegable y elija la agregación que desee usar.

1. En **Orden de clasificación**, elija si desea que la clasificación sea en orden ascendente o descendente.

1. Cuando haya terminado elija **Apply (Aplicar)**.

Después de aplicar una ordenación no visual a una tabla, la ordenación se muestra en el menú **Ordenar elemento visual**. El orden de clasificación de una tabla que contiene una ordenación no visual depende de la configuración de ordenación de la tabla cuando se añade la ordenación no visual. Si se añade una ordenación no visual a una tabla que ya tiene configurada una ordenación de una o varias columnas, la ordenación no visual anula todas las demás clasificaciones. Si la ordenación no visual se aplica antes de las ordenaciones de una o varias columnas, puede añadir y volver a ordenar más clasificaciones en la tabla.

# Uso de cuadros de texto
<a name="textbox"></a>

Añada texto para añadir contexto a las hojas de un análisis mediante un cuadro de texto. El texto puede contener indicaciones, descripciones o incluso hipervínculos a sitios web externos. La barra de herramientas del cuadro de texto ofrece ajustes de fuente que permiten personalizar el tipo de fuente, el estilo, el color, el tamaño, el espaciado, el tamaño en píxeles, el resaltado del texto y la alineación. El cuadro de texto en sí no tiene ajustes de formato. 

Para añadir texto a un cuadro de texto nuevo, basta con seleccionarlo y empezar a escribir. 

# Uso de gráficos de rectángulos
<a name="tree-map"></a>

Utilice gráficos de rectángulos para visualizar una o dos medidas para una dimensión.

Cada rectángulo del gráfico de rectángulos representa un elemento en la dimensión. El tamaño del rectángulo representa la proporción del valor para la medida seleccionada que el elemento representa en comparación con la totalidad de la dimensión. Si lo desea, puede utilizar el color del rectángulo para representar otra medida del elemento El color del rectángulo representa el lugar en el que el valor del elemento se inscribe en el intervalo de la medida, con colores más oscuros para indicar los valores más elevados y más claros para indicar los más bajos.

Los gráficos de rectángulos muestran hasta 100 puntos de datos para el campo **Agrupar por**. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de los gráficos de rectángulos
<a name="tree-map-features"></a>

Utilice la siguiente tabla para conocer las características compatibles con los gráficos de rectángulos. 


****  

| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | Sí |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No aplicable |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Cambiar los colores del elemento visual | No |  | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí, con excepciones | Puede centrarse en cualquier rectángulo de un gráfico de rectángulos o excluirlo, excepto cuando se utiliza un campo de fecha como la dimensión. En ese caso, solo puede centrarse en un rectángulo, no excluirlo.  |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | No | La clasificación predeterminada es descendente según la medida de la columna Tamaño. | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | Debe aplicar la agregación a los campos que elija para el tamaño y el color y no puede aplicar la agregación al campo que elija para definir la agrupación. | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose al cuadro de campo Agrupar por. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 

## Creación de gráficos de rectángulos
<a name="create-tree-map"></a>

Utilice el siguiente procedimiento para crear un gráfico de rectángulos.

**Creación de un gráfico de rectángulos**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Visual types**, elija el icono de gráfico de rectángulos.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de suma **Recuento** se le aplica automáticamente para crear un valor numérico.

   Para crear un gráfico de rectángulos, arrastre una medida al cuadro de campo **Tamaño** y una dimensión al cuadro de campo **Agrupar por**. Si lo prefiere, arrastre otra medida al cuadro de campo **Color**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales a los cuadros de campo **Agrupar por**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

# Uso de gráficos en cascada
<a name="waterfall-chart"></a>

Use un gráfico en cascada para visualizar una suma secuencial a medida que se suman o restan valores. En un gráfico de cascada, el valor inicial pasa por un cambio (positivo o negativo) y cada cambio se representa como una barra. El total final se representa con la última barra. Los gráficos de cascada también se conocen como *puentes* porque los conectores entre las barras tienden puentes entre las barras, lo que demuestra visualmente que están relacionadas.

Los gráficos en cascada se suelen utilizar para presentar datos financieros, ya que permiten mostrar los cambios dentro de un período de tiempo o de un período a otro. De esta forma, puede visualizar los diferentes factores que influyen en el costo de su proyecto. Por ejemplo, puede usar un gráfico en cascada para mostrar las ventas brutas y los ingresos netos en el mismo mes, o bien la diferencia entre los ingresos netos del año pasado y los factores responsables de este cambio.

También puede utilizar los gráficos en cascada para presentar datos estadísticos, como, por ejemplo, cuántos empleados nuevos ha contratado y cuántos han dejado la empresa en un año.

La siguiente captura de pantalla muestra un gráfico en cascada.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/waterfall-chart.png)


**Creación de un elemento visual de gráfico en cascada básico**

1. Abre Amazon Quick y selecciona **Analyses** en el panel de navegación de la izquierda.

1. Seleccione una de las siguientes opciones:
   + Para crear un análisis nuevo, elija **Nuevo análisis** en la parte superior derecha. Para obtener más información, consulte [Inicio de un análisis en Quick Sight](creating-an-analysis.md). 
   + Para usar un análisis existente, elija el análisis que desea editar.

1. Elija **Añadir (\$1), Añadir elemento visual**. 

1. En la parte inferior izquierda, seleccione el icono del gráfico en cascada de **Tipos de elementos visuales**.

1. En el panel **Lista de campos**, elija los campos que desee utilizar para los cuadros de campo apropiados. Los gráficos en cascada requieren una categoría o medida en **Valor**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales al cuadro del campo **Grupo/color**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md).

   Para comprender las características que admiten los gráficos en cascada, consulte [Formato de análisis por tipo en Quick](analytics-format-options.md). Para obtener información sobre las opciones de personalización, consulte [Formatear en Amazon Quick](formatting-a-visual.md). 

# Uso de nubes de palabras
<a name="word-cloud"></a>

Utilice nubes de palabras como una forma atractiva de mostrar la frecuencia con la que se utiliza una palabra en relación con otras palabras de un conjunto de datos. El mejor uso de este tipo de elemento visual es mostrar la frecuencia de la palabra o frase. También puede ser una adición divertida para mostrar acciones o elementos populares. Puede utilizar un conjunto de datos fijo con fines creativos. Por ejemplo, puede crear una nube con los objetivos del equipo, frases de motivación, diversas traducciones de una palabra específica o cualquier otra cosa sobre la que desee llamar la atención.

Cada palabra de una nube de palabras representa uno o varios valores de una dimensión. El tamaño de la palabra representa la frecuencia de la aparición de un valor en una dimensión seleccionada con relación a las apariciones de otros valores en la misma dimensión. Las nubes de palabras son más útiles cuando la precisión no es importante y no hay un gran número de valores distintos. 

En la siguiente captura de pantalla se muestra un ejemplo de nube de palabras.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/word-cloud.png)


Para crear una nube de palabras, utilice una dimensión en el cuadro del campo **Agrupar por**. Si lo desea, puede añadir una métrica al cuadro del campo **Tamaño**.

Las nubes de palabras suelen tener un mejor aspecto si contienen entre 20 y 100 palabras o frases. No obstante, la configuración de formato ofrece numerosas posibilidades. Si tiene demasiadas palabras puede que no sea posible leerlas si son muy pequeñas, según el tamaño de la pantalla. De forma predeterminada, las nubes de palabras muestran 100 palabras distintas. Para mostrar más, modifique la configuración de formato de **Número de palabras**. 

Las nubes de palabras están limitadas a 500 valores únicos para **Agrupar por**. Para evitar mostrar la palabra **Other**, configure el formato del elemento visual para ocultar la categoría **Otro**. Para obtener más información sobre cómo Amazon Quick gestiona los datos que están fuera de los límites de visualización, consulte[Límites de visualización](working-with-visual-types.md#display-limits).

## Características de las nubes de palabras
<a name="word-cloud-features"></a>

Para conocer las características compatibles con las nubes de palabras, consulte la siguiente tabla.


| Característica | ¿Se admite? | Comentarios | Para obtener más información | 
| --- | --- | --- | --- | 
| Cambiar la visualización de la leyenda | No |  | [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md) | 
| Cambiar la visualización del título | Sí |  | [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md) | 
| Cambiar el intervalo del eje | No aplicable |  | [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md) | 
| Cambiar los colores del elemento visual | Sí | Para cambiar el color, elija una palabra y, a continuación, elija un color. | [Colores en tipos visuales en Quick](changing-visual-colors.md) | 
| Centrarse en los elementos o excluirlos | Sí |  |  [Centrarse en los elementos visuales](focusing-on-visual-elements.md) [Exclusión de elementos visuales](excluding-visual-elements.md) | 
| Ordenar | Sí |  | [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md) | 
| Realización de la agregación de campos | Sí | No puede aplicar la agregación al campo que elija para Agrupar por. Debe aplicar una agregación al campo que elija para Tamaño.  | [Cambio de la agregación de campo](changing-field-aggregation.md) | 
| Añadir desgloses | Sí | Puede añadir niveles de desglose al cuadro de campo Agrupar por. | [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md) | 
| Uso de las opciones de formato | Sí | Puede permitir palabras verticales, realzar la escala, utilizar un diseño fluido, utilizar minúsculas y establecer la cantidad de relleno entre palabras. Puede establecer la longitud máxima de cadena de la nube de palabras (el valor predeterminado es 40). También puede elegir el número de palabras para el campo Agrupar por (el valor predeterminado es 100, el máximo es 500). | [Formatear en Amazon Quick](formatting-a-visual.md) | 
| Mostrar totales | No |  | [Formatear en Amazon Quick](formatting-a-visual.md) | 

## Creación de una nube de palabras
<a name="create-word-cloud"></a>

Utilice el siguiente procedimiento para crear una nube de palabras.

**Creación de una nube de palabras**

1. En la página de análisis, elija **Visualizar** en la barra de herramientas.

1. Elija **Agregar** en la barra de aplicaciones y, a continuación, seleccione **Agregar elemento visual**.

1. En el panel **Tipos de elementos visuales**, elija el icono de la nube de palabras.

1. En el panel **Lista de campos**, arrastre los campos que desee utilizar a los cuadros de campo correspondientes. Por norma general, es conveniente que utilice los campos de dimensión o medida tal como se indica en el cuadro de campo de destino. Si decide utilizar un campo de dimensión como una medida, la función de agregación **Recuento** se aplica de forma predeterminada.

   Para crear una nube de palabras, añada una dimensión al cuadro del campo **Agrupar por**. Opcionalmente, añada una medida al cuadro del campo **Tamaño**.

1. (Opcional) Añada capas de desglose arrastrando uno o más campos adicionales a los cuadros de campo **Agrupar por**. Para obtener más información acerca de cómo añadir desgloses, consulte [Añadir desgloses a los datos visuales en Quick Sight](adding-drill-downs.md). 

# Formatear en Amazon Quick
<a name="formatting-a-visual"></a>

Puede elegir entre una variedad de opciones para dar formato y estilo a sus visualizaciones de datos. Para dar formato a un elemento visual, seleccione el elemento al que desee dar formato y elija el icono de **formato visual** situado en la esquina superior derecha de la imagen. Una vez que tenga abierto el panel Formato del elemento visual, puede hacer clic en diferentes elementos visuales y controles para ver los datos de formato para el elemento visual o control específico. Para más información sobre el formato de un elemento visual, consulte [Uso de un control con un parámetro en Amazon Quick](parameters-controls.md).

Usa las siguientes secciones para dar formato y estilo al contenido:

**nota**  
Cualquier cambio de formato aplicado desde los cuadros de campo se aplica solo al objeto visual seleccionado.

**Topics**
+ [Formato de análisis por tipo en Quick](analytics-format-options.md)
+ [Opciones de formato de tablas y tablas dinámicas en Quick](format-tables-pivot-tables.md)
+ [Añadir barras de datos a las tablas en Quick](format-data-bars.md)
+ [Añadir minigráficos a las tablas en Quick](format-sparklines.md)
+ [Opciones de formato de mapas y gráficos geoespaciales en Quick](geospatial-formatting.md)
+ [Ejes y líneas de rejilla en tipos visuales en Quick](showing-hiding-axis-grid-tick.md)
+ [Colores en tipos visuales en Quick](changing-visual-colors.md)
+ [Trabajar con colores a nivel de campo en Amazon Quick](format-field-colors.md)
+ [Formato condicional en tipos visuales en Quick](conditional-formatting-for-visuals.md)
+ [Opciones de KPI](KPI-options.md)
+ [Etiquetas en tipos visuales en Quick](customizing-visual-labels.md)
+ [Formatear datos numéricos visuales en función de la configuración de idioma en Quick](customizing-visual-language-preferences.md)
+ [Leyendas sobre los tipos visuales en Quick](customizing-visual-legend.md)
+ [Estilo de líneas y marcadores en gráficos de líneas en Quick](line-and-marker-styling.md)
+ [Faltan datos sobre los tipos visuales en Quick](customizing-missing-data-controls.md)
+ [Líneas de referencia en los tipos de imágenes en Quick](reference-lines.md)
+ [Formatear gráficos radiales en Quick](format-radar-chart.md)
+ [Rango y escala de los tipos visuales en Quick](changing-visual-scale-axis-range.md)
+ [Opciones de ejes múltiples pequeños](small-multiples-options.md)
+ [Títulos y subtítulos en tipos visuales en Quick](customizing-a-visual-title.md)
+ [Información sobre herramientas sobre tipos visuales en Quick](customizing-visual-tooltips.md)

# Formato de análisis por tipo en Quick
<a name="analytics-format-options"></a>

Utilice la siguiente lista para ver qué tipo de formato funciona en una visualización durante el análisis:
+ Los gráficos de barras (horizontal y vertical) admiten el siguiente formato:
  + Personalizar, mostrar u ocultar el título, las etiquetas de campo y las etiquetas de datos
  + Personalizar, mostrar u ocultar la leyenda (a excepción de los gráficos simples sin agrupación de elementos ni varias medidas, en los que no se muestra una leyenda)
  + Especificar el intervalo y los pasos del eje X para los gráficos de barras horizontales y del eje Y para los gráficos de barras verticales
  + Elegir la cantidad de puntos de datos que se muestran en el eje X para gráficos de barras verticales y en el eje Y para gráficos de barras horizontales
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos
  + Personalizar, mostrar o eliminar las líneas de referencia
  + Mostrar u ocultar la categoría “otros”

  Los gráficos de barras horizontales permiten ordenar según el eje Y y el **valor**. Los gráficos de barras vertical permiten ordenar según el eje X y el **valor**.

  Los gráficos de barras apiladas permiten mostrar los totales.
+ Los gráficos de cajas admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título
  + Personalizar, mostrar u ocultar la leyenda
  + Especificar el rango de ejes y la marca de etiqueta en el eje X y el rango del eje y pase el eje Y
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos
  + Elegir la cantidad de puntos de datos que se muestran en el eje Y
  + Mostrar u ocultar la categoría “other” 
  + Agregar líneas de referencia

  Los diagramas de cajas permiten ordenar por **Agrupar por**.
+ Los gráficos combinados admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, las etiquetas de campo y las etiquetas de datos
  + Personalizar, mostrar u ocultar la leyenda (a excepción de los gráficos simples sin agrupación de elementos, apilamiento ni varias medidas, en los que no se muestra una leyenda)
  + Especificar el intervalo del eje en los gráficos de barras y de líneas
  + Sincronizar los ejes Y para barras y líneas en un solo eje.
  + Elegir la cantidad de puntos de datos que se muestran en el eje X
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos
  + Personalizar, mostrar o eliminar las líneas de referencia
  + Mostrar u ocultar la categoría “otros”

  Los gráficos combinados permiten ordenar según el eje X, las **barras** y **las líneas**.
+ Los gráficos de anillos admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, las etiquetas de datos y la leyenda
  + Personalizar, mostrar u ocultar las etiquetas para los campos de grupo o color y valores
  + Elección del número de sectores que se muestran en **Grupo/color**
  + Mostrar u ocultar la categoría “otros”

  Los gráficos circulares permiten ordenar por **Grupo/color** y **Valor**.
+ Los mapas rellenados admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título.
  + Personalizar, mostrar u ocultar la leyenda

  Los mapas rellenados permiten ordenar por **Ubicación** y **Color**.
+ Los gráficos de embudo admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título y las etiquetas de datos
  + Personalizar, mostrar u ocultar las etiquetas para los campos de grupo o color y valores
  + Elección del número de etapas que se muestran en el campo **Agrupar por**
  + Mostrar u ocultar la categoría “otros”

  Los gráficos de embudo permiten ordenar por **Grupo/color** y **Valor**.
+ Los gráficos de medición admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título. Mostrar u ocultar etiquetas de eje.
  + Personalizar cómo se muestra el valor o los valores: ocultos, valor real, comparación
  + Elegir el método de comparación (disponible cuando se utilizan dos medidas)
  + Elegir el intervalo del eje y el relleno que se muestran en el gráfico de medición
  + Elegir el estilo de arco (grados de 180 a 360) y el grosor del arco

  Los gráficos de medición no permiten la ordenación.
+ Los gráficos geoespaciales (mapas) admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título y la leyenda
  + Elegir la imagen del mapa de base 
  + Elegir mostrar los puntos del mapa con o sin agrupación 

  Los gráficos geoespaciales no permiten la ordenación.
+ Los mapas de calor admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, la leyenda y las etiquetas
  + Elegir la cantidad de filas y columnas que se muestran
  + Elegir colores o gradientes
  + Mostrar u ocultar la categoría “otros”

  Los mapas térmicos admiten la ordenación según **Valores** y **Columnas**.
+ Los gráficos de histograma admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, las etiquetas de campo y las etiquetas de datos
  + Especificar el intervalo del eje, la escala y los pasos en el eje Y
  + Elegir la cantidad de puntos de datos que se muestran en el eje X
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos

  Los gráficos de histograma no permiten la ordenación.
+ Los indicadores clave de rendimiento (KPIs) admiten el siguiente formato:
  + Personalizar, mostrar u ocultar el título
  + Mostrar u ocultar las flechas de tendencias y la barra de progreso
  + Personalizar el método de comparación como automático, diferencia, porcentaje (%) o diferencia en porcentaje (%)
  + Personalizar el valor principal mostrado como comparación o real
  + Formato condicional

  KPIs no admiten la clasificación.
+ Los gráficos de líneas admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, las etiquetas de campo y las etiquetas de datos
  + Personalizar, mostrar u ocultar la leyenda (a excepción de los gráficos simples, en los que no se muestra una leyenda)
  + Especificar el intervalo y los pasos del eje (en el eje Y)
  + Elegir la cantidad de puntos de datos que se muestran en el eje X
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos
  + Personalizar, mostrar o eliminar las líneas de referencia
  + Personalizar el estilo de las líneas y los marcadores de los puntos de datos de una línea
  + Mostrar u ocultar la categoría “otros”, salvo cuando el eje X es una fecha

  Los gráficos de líneas admiten la ordenación según el eje X y el **valor** únicamente con fines numéricos.
+ Los gráficos circulares admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, las etiquetas de datos y la leyenda
  + Personalizar, mostrar u ocultar las etiquetas para los campos de grupo o color y valores
  + Mostrar las métricas como valores, porcentajes o ambos
  + Elección del número de sectores que se muestran en el campo **Grupo/color**
  + Mostrar u ocultar la categoría “otros”

  Los gráficos circulares permiten ordenar por **Valor** y **Grupo/color**.
+ Las tablas dinámicas admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título
  + Personalizar, mostrar u ocultar las etiquetas de campos de columna, fila y valores
  + Personalice los tamaños de fuente para los encabezados de las tablas y cells/body 
  + Muestra u oculta los totales y subtotales en filas o columnas
  + Etiquetas personalizadas para los totales o subtotales
  + Seleccionar opciones de estilo adicionales: ajustar tabla a vista, ocultar nombres de campo de columna, ocultar etiqueta duplicada al utilizar una métrica única
  + Formato condicional

  Las tablas dinámicas permiten ordenar por **Columna** y **Fila**. Para obtener más información acerca de la ordenación de datos de tablas dinámicas, consulte [Clasificación de tablas dinámicas en Quick](sorting-pivot-tables.md). 
+ Los gráficos de dispersión admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, la leyenda, las etiquetas de campo y las etiquetas de datos
  + Personalizar, mostrar o eliminar las líneas de referencia
  + Especificar el intervalo de los ejes (en el eje X y el eje Y)
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos

  Los gráficos de dispersión no admiten la ordenación.
+ Las tablas admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título, la leyenda y las columnas
  + Personalizar, mostrar u ocultar los nombres de las columnas para los campos de “agrupar por” y de valores
  + Personalice los tamaños de fuente para los encabezados de las tablas y cells/body 
  + Mostrar u ocultar los totales en la parte superior o inferior de la tabla
  + Proporcionar una etiqueta personalizada para los totales
  + Agregar formato condicional

  Las tablas permiten ordenar por **Grupo/color** y **Valor**.
+ Los gráficos de rectángulos admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título y la leyenda
  + Personalizar, mostrar u ocultar las etiquetas para los campos de “agrupar por”, tamaño y color
  + Elegir colores o gradientes
  + Elección del número de cuadrados que se muestran en el campo **Agrupar por**
  + Mostrar u ocultar la categoría “otros”

  Los gráficos de líneas permiten ordenar por **Tamaño**, **Agrupar por** y **Color**.
+ Los gráficos en cascada admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título o subtítulo
  + Personalizar la etiqueta total
  + Especificar el tamaño y la orientación de la etiqueta en el eje X y el rango y la orientación de la etiqueta en el eje Y
  + Mostrar u ocultar las líneas de los ejes, las etiquetas de los ejes, los iconos de ordenación de ejes y las líneas de cuadrícula de los gráficos
  + Mostrar u ocultar la categoría “otros”
  + Personalizar el tamaño y la posición de la leyenda
  + Personalizar y mostrar u ocultar las etiquetas de datos

  Los gráficos en cascada permiten ordenar por **Categoría** y **Valor**.
+ Los nubes de palabras admiten los siguientes formatos:
  + Personalizar, mostrar u ocultar el título
  + Personalización del color de la palabra y el número de palabras que se muestran en el campo **Agrupar por**
  + Mostrar u ocultar la categoría “otros”
  + Elegir opciones de estilo adicionales: permitir palabras verticales, realzar la escala o trabajar con diseño fluido, utilizar minúsculas, nivel de relleno y longitud máxima de cadena

  Las nubes de palabras permiten ordenar por **Agrupar por**.

# Opciones de formato de tablas y tablas dinámicas en Quick
<a name="format-tables-pivot-tables"></a>

Puede personalizar las tablas y tablas dinámicas en Quick para adaptarlas a las necesidades de su empresa. Puede personalizar los encabezados, las celdas y los totales de las tablas especificando el color, el tamaño, el formato y la alineación del texto en cada uno de ellos. También puede especificar la altura de las filas de una tabla, añadir bordes y líneas de rejilla y añadir colores de fondo personalizados. Además, puede personalizar la forma de mostrar los totales y subtotales.

Si ha aplicado el formato condicional a una tabla o tabla dinámica, prevalecerá sobre cualquier otro estilo que configure.

Al exportar imágenes de tablas o tablas dinámicas a Microsoft Excel, las personalizaciones de formato que aplicó a las imágenes no se reflejan en el archivo Excel descargado.

**Aplicación de formato a una tabla o tabla dinámica**
+ En el análisis, elija la tabla o tabla dinámica que desee personalizar y, a continuación, elija el icono **Formato del elemento visual**.  
![\[Imagen del icono de formato del elemento visual.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/format-tables-icon.png)

  El panel **Propiedades** se abre a la izquierda.

A continuación, encontrará descripciones de las opciones para personalizar cada área de la tabla o tabla dinámica en el panel **Propiedades**.

**Topics**
+ [Encabezados](format-tables-headers.md)
+ [Formato de celdas](format-tables-pivot-tables-cells.md)
+ [Totales y subtotales](format-tables-pivot-tables-totals.md)
+ [Tamaño de fila y columna en tablas y tablas dinámicas en Quick](format-tables-pivot-tables-resize-rows-columns.md)
+ [Personalización de los datos de la tabla dinámica](format-tables-pivot-tables-layout-options.md)

# Encabezados
<a name="format-tables-headers"></a>

## Expandir todos los encabezados
<a name="format-tables-headers-expand"></a>

Puede optar por expandir todos los encabezados de una tabla dinámica para mostrar todas las filas secundarias y descendientes de las secundarias de un encabezado.

**Expansión de todos los encabezados de una tabla dinámica**

1. En el elemento visual que desee cambiar, seleccione cualquier encabezado para abrir el menú **On-Visual**.

1. Seleccione **Expandir todo a continuación**.

## Altura del encabezado
<a name="format-tables-headers-row"></a>

Puede personalizar la altura del encabezado de la tabla.

**Personalización de la altura de los encabezados de una tabla**

1. En el panel **Propiedades**, elija **Encabezados**.

1. En **Altura de la fila**, introduzca un número en píxeles. Puede especificar un número entero entre 8 y 500.

**Personalización de la altura de los encabezados de una tabla dinámica**

1. En el panel **Propiedades**, elija **Encabezados**.

1. En la sección **Columnas**, en **Altura de la fila**, introduzca un número en píxeles. Puede especificar un número entero entre 8 y 500.

## Texto del encabezado
<a name="format-tables-headers-text"></a>

Puede personalizar el texto del encabezado de la tabla.

**Personalización del texto del encabezado en una tabla**

1. En el panel **Propiedades**, elija **Encabezados**.

1. Navegue hasta la sección **TEXTO** y lleve a cabo una o más de las siguientes acciones:
   + Para cambiar el color del texto del encabezado, elija la muestra de color situada debajo de **Estilo de texto** y elija el color que desea que tenga el texto de la tabla.
   + Para cambiar la fuente o el tamaño de fuente del texto del encabezado, abra el menú desplegable **Fuente** o **Tamaño de fuente** y elija la fuente o el tamaño de fuente que desee.
   + Para poner el texto del encabezado en negrita, cursiva o subrayado, elija el icono correspondiente en la barra de estilos.
   + Para ajustar el texto en encabezados que son demasiado largos, seleccione **Ajustar texto**. Ajustar el texto en un encabezado no aumenta automáticamente la altura del encabezado. Siga el procedimiento anterior para aumentar la altura del encabezado.
   + Para cambiar la alineación horizontal del texto del encabezado, elija un icono de alineación horizontal. Puede elegir la alineación izquierda, la alineación central, la alineación derecha o la alineación automática.
   + Para cambiar la alineación vertical del texto del encabezado, elija un icono de alineación vertical. Puede elegir la alineación superior, la alineación media o la alineación inferior.

**Personalización del texto del encabezado en una tabla dinámica**

1. En el panel **Propiedades**, elija **Encabezados**.

   La sección Encabezados se expande para mostrar opciones para personalizar los encabezados de columnas y filas.

1. En la sección **Encabezados**, lleve a cabo una o varias de las siguientes acciones:
   + Para aplicar un estilo de fila a los nombres de campo de las filas o columnas, elija **Etiqueta de filas de estilo** o **Etiqueta de columnas de estilo** en función de la etiqueta que desee personalizar.
   + Para personalizar la fuente del encabezado, vaya a la subsección **TEXTO** de la sección **Filas** o **Columnas** y lleve a cabo una o varias de las siguientes acciones:
     + Para cambiar el color del texto del encabezado, elija la muestra de color situada debajo de **Estilo de texto** y elija el color que desea que tenga el texto de la tabla.
     + Para cambiar la fuente o el tamaño de fuente del texto del encabezado, abra el menú desplegable **Fuente** o **Tamaño de fuente** y elija la fuente o el tamaño de fuente que desee.
     + Para poner el texto del encabezado en negrita, cursiva o subrayado, elija el icono correspondiente en la barra de estilos.
   + Para cambiar la alineación horizontal del texto del encabezado, elija un icono de alineación. Puede elegir la alineación izquierda, la alineación central, la alineación derecha o la alineación automática. Puede elegir una alineación horizontal para los encabezados de las columnas en la sección **Columnas** y para los encabezados de las filas en la sección **Filas**.
   + Para cambiar la alineación vertical del texto del encabezado, elija un icono de alineación. Puede elegir la alineación superior, la alineación media o la alineación inferior. Puede elegir una alineación vertical para los encabezados de las columnas en la sección **Columnas** y para los encabezados de las filas en la sección **Filas**.
   + Para ocultar la etiqueta de las filas o los nombres de los campos de las columnas, seleccione el icono en forma de ojo situado junto a **Etiqueta de filas** o **Nombres del campo de columnas**.

## Color de fondo del encabezado
<a name="format-tables-headers-background"></a>

Puede personalizar el color de fondo de los encabezados de las tablas.

**Personalización del color de fondo de los encabezados de las tablas**

1. En el panel **Propiedades**, elija **Encabezados**.

1. En **Fondo**, elija el icono del color de fondo y, a continuación, elija un color. Puede elegir uno de los colores proporcionados, restablecer el color del texto del encabezado al color predeterminado o crear un color personalizado.

**Personalización del color de fondo de los encabezados de las tablas dinámicas**

1. En el panel **Propiedades**, elija **Encabezados**.

   La sección **Encabezados** se expande para mostrar opciones para personalizar los encabezados de columnas y filas.

1. En la sección **Columnas**, elija el icono del color de fondo y, a continuación, elija un color.

1. En la sección **Filas**, elija el icono del color de fondo y, a continuación, elija un color. 

## Bordes del encabezado
<a name="format-tables-headers-border"></a>

Puede personalizar el color de los bordes del encabezado.

**Personalización de los bordes del encabezado en una tabla**

1. En el panel **Propiedades**, elija **Encabezados**.

1. En **Bordes**, realice una o más de las siguientes acciones:
   + Para personalizar el tipo de borde que desee, elija un icono de tipo de borde. Puede elegir no tener bordes, solo bordes horizontales, solo bordes verticales o todos los bordes.
   + Para personalizar el grosor del borde, elija un grosor de borde.
   + Para personalizar el color del borde, elija el icono del color del borde y, a continuación, elija un color. Puede elegir uno de los colores proporcionados, restablecer el color del borde al color predeterminado o crear un color personalizado.

**Personalización de los bordes del encabezado en una tabla dinámica**

1. En el panel **Propiedades**, elija **Encabezados**.

   La sección **Encabezados** se expande para mostrar opciones para personalizar los encabezados de columnas y filas.

1. En las secciones **Columnas** y **Filas**, en el caso de **Bordes**, realice una o varias de las siguientes acciones:
   + Para personalizar el tipo de borde que desee, elija un icono de tipo de borde. Puede elegir no tener bordes, solo bordes horizontales, solo bordes verticales o todos los bordes.
   + Para personalizar el grosor del borde, elija un grosor de borde.
   + Para personalizar el color del borde, elija el icono del color del borde y, a continuación, elija un color. Puede elegir uno de los colores proporcionados, restablecer el color del borde al color predeterminado o crear un color personalizado.

## Opciones de estilo de encabezado para tablas dinámicas jerárquicas
<a name="format-pivot-tables-header-styling"></a>

Puede ocultar o cambiar el nombre de la etiqueta **Filas** de una tabla dinámica jerárquica.

**Cambios en la etiqueta **Filas** de una tabla dinámica jerárquica**

1. Seleccione la tabla dinámica jerárquica que desee cambiar y abra el menú **Formato del elemento visual**.

1. En la sección **Encabezados** puede llevar a cabo las tareas siguientes:
   + Seleccione **Ocultar etiqueta de filas** para ocultar la etiqueta de **Filas** de la tabla dinámica.
   + En **Etiqueta de filas**, introduzca la etiqueta que desee que aparezca en la tabla dinámica.

# Formato de celdas
<a name="format-tables-pivot-tables-cells"></a>

## Altura de fila
<a name="format-tables-pivot-tables-cells-row"></a>

Puede personalizar la altura de la fila de la tabla.

**Personalización de la altura de las filas de una tabla o una tabla dinámica**

1. En el panel **Propiedades**, elija **Celdas**.

   La sección **Celdas** se expande para mostrar las opciones de personalización de las celdas.

1. En **Altura de la fila**, introduzca un número en píxeles. Puede especificar un número entero entre 8 y 500.

## Texto de celda
<a name="format-tables-pivot-tables-cells-text"></a>

Puede personalizar el formato del texto de las celdas de una tabla.

**Aplicación de formato al texto de las celdas una tabla o tabla dinámica**

1. En el panel **Propiedades**, elija **Celdas**.

   La sección **Celdas** se expande para mostrar las opciones de personalización de las celdas.

1. En **Texto**, realice una o más de las siguientes acciones:
   + Para cambiar el color del texto de la celda, elija la muestra de color situada debajo de **Estilo de texto** y elija el color que desea que tenga el texto de la tabla.
   + Para cambiar la fuente o el tamaño de fuente del texto de la celda, abra el menú desplegable **Fuente** o **Tamaño de fuente** y elija la fuente o el tamaño de fuente que desee.
   + Para poner el texto de la celda en negrita, cursiva o subrayado, elija el icono correspondiente en la barra de estilos.
   + Para ajustar el texto en encabezados que son demasiado largos, seleccione **Ajustar texto**. Ajustar el texto de las celdas no aumenta automáticamente la altura de la fila. Siga el procedimiento anterior para aumentar la altura de la fila.
   + Para cambiar la alineación horizontal del texto de las celdas, elija un icono de alineación horizontal. Puede elegir la alineación izquierda, la alineación central, la alineación derecha o la alineación automática. La alineación horizontal solo se puede configurar para los campos de **Filas** de una tabla dinámica jerárquica.
   + Para cambiar la alineación vertical del texto de las celdas, elija un icono de alineación vertical. Puede elegir la alineación superior, la alineación media, la alineación inferior o la automática. En las tablas dinámicas tabulares, el valor de **Automático** es vertical. En las tablas dinámicas jerárquicas, el valor de **Automático** es intermedio.  
![\[Opciones de alineación vertical y horizontal de celdas en el menú Formato del elemento visual.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/format-pivot-table-alignment.png)

## Color de fondo de la celda
<a name="format-tables-pivot-tables-cells-background"></a>

Puede personalizar el color de fondo de las celdas de las tablas.

**Personalización del color de fondo de las celdas de una tabla o tabla dinámica**

1. En el panel **Propiedades**, elija **Celdas**.

   La sección **Celdas** se expande para mostrar las opciones de personalización de las celdas.

1. En **Fondo**, realice una o más de las siguientes acciones:
   + Para alternar los colores de fondo entre las filas, seleccione **Alternar colores de fila**. Al desactivar esta opción, todas las celdas tendrán el mismo color de fondo.
   + Si decide alternar los colores de fondo entre las filas, elija un color para **Filas impares** y un color para **Filas pares**; para ello, elija el icono del color de fondo de cada una de ellas y seleccione un color. Puede elegir uno de los colores proporcionados, restablecer el color del fondo al color predeterminado o crear un color personalizado.
   + Si decide no alternar los colores de fondo entre las filas, elija el icono del color de fondo y seleccione un color para todas las celdas. Puede elegir uno de los colores proporcionados, restablecer el color del fondo al color predeterminado o crear un color personalizado.

## Bordes de celdas
<a name="format-tables-pivot-tables-cells-border"></a>

Puede personalizar los bordes de las celdas de la tabla.

**Personalización de los bordes de las celdas de una tabla o tabla dinámica**

1. En el panel **Propiedades**, elija **Celdas**.

   La sección **Celdas** se expande para mostrar las opciones de personalización de las celdas.

1. En **Bordes**, realice una o más de las siguientes acciones:
   + Para personalizar el tipo de borde que desee, elija un icono de tipo de borde. Puede elegir no tener bordes, solo bordes horizontales, solo bordes verticales o todos los bordes.
   + Para personalizar el grosor del borde, elija un grosor de borde.
   + Para personalizar el color del borde, elija el icono del color del borde y, a continuación, elija un color. Puede elegir uno de los colores proporcionados, restablecer el color del borde al color predeterminado o crear un color personalizado.

# Totales y subtotales
<a name="format-tables-pivot-tables-totals"></a>

En tablas y tablas dinámicas, puede configurar la visualización de totales o subtotales. Las tablas pueden mostrar totales en la parte superior o la parte inferior del elemento visual. Las tablas dinámicas pueden mostrar los totales y subtotales en filas y columnas.

## Añadir totales y subtotales a tablas y tablas dinámicas en Quick
<a name="format-tables-pivot-tables-totals-position"></a>

Puede añadir el total de columnas a la tabla y a los elementos visuales de la tabla dinámica. También puede añadir el subtotal de columnas a los elementos visuales de la tabla dinámica.

**Visualización u ocultación de los totales y subtotales de una tabla dinámica**

1. Para mostrar los totales, abra el panel **Propiedades** y elija **Total**.
   + Para mostrar los totales de las filas, active el conmutador **FILAS**. Los totales se muestran en la fila inferior del elemento visual. Seleccione **Anclar totales** para mantener los totales visibles a medida que se desplaza por la tabla.
   + Para mostrar los totales de las columnas, active el conmutador **COLUMNAS**. Los totales se muestran en la última columna del elemento visual.

1. Para mostrar los totales, abra el panel **Propiedades** y elija **Subtotal**.
   + Para mostrar los subtotales de las filas, active el conmutador **FILAS**. Los totales se muestran en la fila inferior del elemento visual.
   + Para mostrar los subtotales de las columnas, active el conmutador **COLUMNAS**.
   + En **Nivel**, elija una de las siguientes opciones:
     + Seleccione **Último** para mostrar solo el subtotal del último campo de la jerarquía del gráfico. Esta es la opción predeterminada.
     + Elija **Todos** para mostrar los subtotales de cada campo.
     + Elija **Personalizado** para personalizar qué campos muestran los subtotales.

Después de añadir los totales de las filas a la tabla o tabla dinámica, también puede optar por colocar los totales en la parte superior o inferior de la imagen. También puede cambiar la posición de los totales de las columnas en las tablas dinámicas.

**Colocación de los totales de filas o columnas en una tabla o tabla dinámica**

1. En el panel **Propiedades**, elija **Total**.

1. (Opcional) En **Filas**, elija **Mostrar totales**.

1. (Opcional) En **Columnas**, elija **Mostrar totales**.

1. (Opcional) En el menú **Filas**, abra el menú desplegable **Posición** y elija la posición en la que desee que se muestren los totales. Seleccione **Parte superior** para colocar los totales en la parte superior de la tabla o **Parte inferior** para colocar los totales en la parte inferior de la tabla.

1. (Opcional) En el menú **Columnas**, abra el menú desplegable **Posición** y elija la posición en la que desee que se muestren los totales. Seleccione **Izquierda** para colocar los totales a la izquierda de la tabla o **Derecha** para colocar los totales a la derecha de la tabla.

No puede cambiar la posición de los subtotales de una imagen de tabla dinámica. Si la tabla dinámica utiliza un diseño jerárquico, las filas de los subtotales se colocan en la parte superior de la tabla. Los subtotales de la tabla dinámica tabular se muestran en la parte inferior de la tabla.

## Personalización de las etiquetas de los totales y subtotales
<a name="format-tables-pivot-tables-totals-text"></a>

Puede cambiar el nombre de los totales en los elementos visuales de las tablas y tablas dinámicas para proporcionar un mejor contexto a los lectores de las cuentas. De forma predeterminada, los totales y los subtotales aparecen sin etiqueta.

**Cambio del nombre de los totales en un elemento visual de una tabla o una tabla dinámica**

1. En el panel **Propiedades**, elija **Total** o **Subtotal**.

1. En **Etiqueta**, introduzca la palabra o frase corta que desee que aparezca en el total.

   En las tablas dinámicas, también puede añadir etiquetas a los totales y subtotales de las columnas. Para ello, ingrese una palabra o frase corta para **Etiqueta** en la sección **Columnas**.

1. (Opcional) En el caso de las tablas dinámicas tabulares, también puede añadir nombres de grupos a los subtotales. Para añadir un nombre de grupo a los subtotales de las filas, seleccione el icono con el **signo más (\$1)** situado junto al campo **Etiqueta** para añadir el parámetro de nombre de grupo que desee. También puede introducir una palabra o frase corta en este campo.

También puede realizar cambios en el tamaño del texto y el color de fuente de las etiquetas de total y subtotal de la tabla y de las imágenes de las tablas dinámicas.

**Para dar formato al texto de los totales y subtotales**

1. En el panel **Propiedades**, elija **Total** o **Subtotal**.

1. Para **Texto**, realice una o más de las siguientes acciones.
   + Para cambiar el color del texto del total o el subtotal, elija la muestra de color situada debajo de **Estilo de texto** y elija el color que desea que tenga el texto de la tabla.
   + Para cambiar la fuente o el tamaño de fuente del texto del total o el subtotal, abra el menú desplegable **Fuente** o **Tamaño de fuente** y elija la fuente o el tamaño de fuente que desee.
   + Para poner el texto del total o el subtotal en negrita, cursiva o subrayado, elija el icono correspondiente en la barra de estilos.

   En las tablas dinámicas, también puede dar formato al texto de los totales y subtotales de las columnas. Para ello, repita los pasos anteriores en la sección **Columnas**.

## Color de fondo de los totales y subtotales
<a name="format-tables-pivot-tables-totals-background"></a>

**Personalización del color de fondo de los totales y subtotales**

1. En el panel **Propiedades**, elija **Total** o **Subtotal**.

1. En **Fondo**, elija el icono del color de fondo y, a continuación, elija un color. Puede elegir uno de los colores proporcionados, restablecer el color del fondo al color predeterminado o crear un color personalizado.

   En las tablas dinámicas, también puede dar agregar colores de fondo a los totales y subtotales de las columnas. Para ello, seleccione un icono de color de fondo como **Fondo** en la sección **Columnas**.

## Bordes totales y subtotales
<a name="format-tables-pivot-tables-totals-border"></a>

**Personalización de los bordes de los totales y subtotales**

1. En el panel **Propiedades**, elija **Total** o **Subtotal**.

1. En **Bordes**, realice una o más de las siguientes acciones:
   + Para personalizar el tipo de borde que desee, elija un icono de tipo de borde. Puede elegir no tener bordes, solo bordes horizontales, solo bordes verticales o todos los bordes.
   + Para personalizar el grosor del borde, elija un grosor de borde.
   + Para personalizar el color del borde, elija el icono del color del borde y, a continuación, elija un color. Puede elegir uno de los colores proporcionados, restablecer el color del borde al color predeterminado o crear un color personalizado.

   En las tablas dinámicas, también puede agregar bordes a los totales y subtotales de las columnas. Para ello, repita los pasos anteriores en la sección **Columnas**.

## Aplicación de estilos de totales y subtotales a las celdas
<a name="format-tables-pivot-tables-totals-apply"></a>

En las tablas dinámicas, puede aplicar cualquier texto, color de fondo y estilo de borde que aplique a los totales de las celdas de la misma columna o fila. Los subtotales de las filas aparecen de forma diferente según el diseño que utilice la tabla dinámica. En el caso de las tablas dinámicas tabulares, los encabezados de subtotales explícitos aparecen en la imagen. En las tablas dinámicas jerárquicas, los encabezados de subtotales explícitos no aparecen. En su lugar, los autores aplican un estilo de subtotal a los campos individuales del menú **Formato del elemento visual**. Los encabezados contraídos no se pueden diseñar como subtotales.

**Aplicación de estilos de totales y subtotales a las celdas**

1. En el panel **Propiedades**, elija **Total** o **Subtotal**.

1. En **Aplicar estilo a**, elija el elemento visual al que desee aplicar el estilo de subtotal. Puede elegir entre las siguientes opciones.
   + **Ninguno**: elimina las opciones de estilo de todas las celdas.
   + **Solo encabezados**: aplica opciones de estilo a todos los encabezados de la tabla dinámica.
   + **Solo celdas**: aplica opciones de estilo a todas las celdas que no son encabezados en la tabla dinámica.
   + **Encabezados y celdas**: aplica opciones de estilo a todas las celdas de la tabla dinámica.

# Tamaño de fila y columna en tablas y tablas dinámicas en Quick
<a name="format-tables-pivot-tables-resize-rows-columns"></a>

Los autores y los lectores pueden cambiar el tamaño de las filas y columnas de una tabla o tabla dinámica. Pueden ajustar tanto la altura de las filas como el ancho de las columnas. Los autores también pueden establecer el ancho de columna predeterminado para las columnas de una imagen de tabla dinámica.

**Cambio del tamaño de una fila de una tabla o tabla dinámica**
+ En la imagen de la tabla o tabla dinámica, coloque el cursor sobre la línea cuyo tamaño desee cambiar hasta que aparezca el cursor horizontal. Cuando aparezca, seleccione la línea y arrástrela a una nueva altura.

  Puede ajustar la altura de las filas seleccionando las líneas horizontales de las celdas y los encabezados de las filas.  
![\[Cambie el tamaño de una fila de una tabla o tabla dinámica.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/resize-table-row1.gif)

**Cambio del ancho de una columna en una tabla o tabla dinámica**
+ En la imagen de la tabla o tabla dinámica, coloque el cursor sobre la línea cuyo tamaño desee cambiar hasta que aparezca el cursor vertical. Cuando aparezca, seleccione la línea y arrástrela a un nuevo ancho.

  Puede ajustar el ancho de las columnas seleccionando las líneas verticales de las celdas, los encabezados de las columnas y los encabezados de las filas.  
![\[Cambie el tamaño de una columna en una tabla o tabla dinámica.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/resize-table-row2.gif)

**Establecimiento del ancho de columna predeterminado para las columnas de una tabla dinámica**

1. Seleccione la tabla dinámica que desee cambiar y abra el menú **Formato del elemento visual**.

1. En la sección **Opciones de tabla dinámica**, navegue hasta el campo **Ancho de columna del valor (píxeles)** e introduzca el valor predeterminado que desee en píxeles.

# Personalización de los datos de la tabla dinámica
<a name="format-tables-pivot-tables-layout-options"></a>

Puede personalizar la forma en que los lectores rápidos ven las tablas dinámicas para que sean más fáciles de leer y entender de un vistazo. Puede optar por ocultar los iconos más y menos de una tabla dinámica, ocultar las columnas que solo tienen un valor métrico único y ocultar las columnas contraídas para que no se vean. Estas opciones pueden ayudar a los autores de Quick a eliminar el desorden de sus tablas dinámicas y proporcionar una experiencia de lectura más sencilla a los usuarios de Quick. Esto no es lo mismo que elegir un diseño de tabla dinámica. Para obtener más información sobre las opciones de formato de tablas dinámicas, consulte [Selección de un diseño](create-pivot-table.md#pivot-table-layout).

También se puede acceder a estas opciones desde el menú **Campos de fila combinados** de una tabla dinámica. El diseño que elija para la tabla dinámica determina cómo se accede a este menú. Para obtener más información sobre cómo acceder al menú **Campos de fila combinados**, consulte .

**Cambios en el diseño de una tabla dinámica**

1. En el panel **Formato del elemento visual**, seleccione **Opciones de tabla dinámica**.

1. En el menú **Opciones de tabla dinámica**, seleccione las siguientes opciones para personalizar la vista:
   + **Ocultar los botones \$1/—**: oculta los íconos más y menos de la tabla dinámica de forma predeterminada. Los lectores aún pueden elegir mostrar los iconos de más y menos y expandir o contraer las columnas y filas.
   + **Ocultar métrica única**: oculta las columnas que solo tienen un único valor de métrica.
   + **Ocultar columnas contraídas**: permite ocultar automáticamente todas las columnas contraídas de una tabla dinámica. Esta opción solo está disponible para las tablas dinámicas tabulares.

# Añadir barras de datos a las tablas en Quick
<a name="format-data-bars"></a>

Puede utilizar barras de datos para añadir contexto visual a las imágenes de las tablas en Amazon Quick. Al inyectar color a las tablas, las barras de datos pueden facilitar la visualización y la comparación de los datos en una variedad de campos. Las *barras de datos* son barras de diferentes colores o sombras que se agregan a las celdas de una tabla. Las barras se miden en relación con el rango de todas las celdas de una sola columna, lo que es similar a un gráfico de barras. Puede utilizar las barras de datos para resaltar una tendencia fluctuante, como el beneficio trimestral durante el año.

Solo puede aplicar barras de datos a los campos que se agreguen al campo **Valores** en la parte visual. No puede aplicar barras de datos a los elementos que se agregan a los bloques de grupo.

Puede crear hasta 200 configuraciones de barras de datos diferentes para una sola tabla.

![\[Imagen que muestra las barras de datos de una tabla.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/data-bars-1.png)


**Adición de barras de datos a una tabla**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**. El panel **Formato del elemento visual** se abrirá.

1. En el panel **Propiedades**, abra la lista desplegable **Elementos visuales** y elija **AGREGAR BARRAS DE DATOS**.

1. En la ventana emergente **Barras de datos** que aparece, elija el campo de valores que desee representar mediante las barras de datos. Solo puede elegir entre los campos que se agreguen al campo **Valores** en la parte visual.

1. (Opcional) Elija el icono denominado **Color positivo** para seleccionar el color que desee que represente las barras de datos con valores positivos. El color predeterminado es el verde.

1. (Opcional) Elija el icono denominado **Color negativo** para seleccionar el color que desee que represente las barras de datos con valores negativos. El color predeterminado es el rojo.

Al crear barras de datos, se les asigna el nombre de los valores de campo que representan. Por ejemplo, si agrega barras de datos para representar el beneficio de un producto a lo largo del tiempo, la configuración de la barra de datos se denomina “Beneficio”. En el panel **Elementos visuales** del menú **Propiedades**, las barras de datos se muestran en el orden en que se crearon.

**Eliminación de las barras de datos de un elemento visual**

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**. Se abrirá el panel **Propiedades**.

1. En el panel **Propiedades**, abra la lista desplegable **Elementos visuales** y elija la barra de datos que desea eliminar.

1. Seleccione **ELIMINAR BARRAS DE DATOS**.

# Añadir minigráficos a las tablas en Quick
<a name="format-sparklines"></a>

Los minigráficos son pequeños gráficos en línea que muestran las tendencias directamente dentro de las celdas de la tabla, lo que ayuda a los lectores a identificar rápidamente los patrones y la estacionalidad sin salir de la vista de tabla. Usa minigráficos cuando necesites una visualización compacta de tendencias junto con tus datos tabulares.

**Para aplicar minigráficos a una tabla**

1. En la página de análisis, elija la imagen de tabla a la que desee dar formato.

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**. El panel **Formato del elemento visual** se abrirá.

1. En el panel de **propiedades**, abra la lista desplegable de **imágenes** y elija **APPLY** SPARKLINES.

1. En el panel de edición de minigráficos, configure los ajustes de datos:
   + En **la columna Valor**, elija el campo de medida que desee que represente el minigráfico. Los campos que ya estén siendo utilizados por otro minigráfico o barra de datos no están disponibles.
   + Para el **campo del eje X**, elija el campo de dimensión que desee trazar a lo largo del eje horizontal. El campo del eje X no debe ser el mismo que un campo del pozo **Agrupar por** campo. También puede configurar la dirección de clasificación y la granularidad horaria (para los campos de fecha y hora) del campo del eje X.

1. (Opcional) Amplíe la sección de **presentación** para personalizar el aspecto del minigráfico. Para obtener más información, consulte [Opciones de minigráficos](#format-sparklines-options).

1. (Opcional) Configure la visibilidad de los marcadores. Todos los marcadores están ocultos de forma predeterminada. Puede elegir mostrar:
   + **Todos los puntos**: muestra un marcador en cada punto de datos.
   + **Valor máximo**: muestra un marcador en el valor más alto.
   + **Valor mínimo**: muestra un marcador en el valor más bajo.

1. Seleccione **Aplicar**.

El minigráfico recibe el nombre del campo de valor que representa (por ejemplo, «Beneficio»). Los minigráficos aparecen en el panel de **imágenes** en el orden en que se crearon.

## Opciones de minigráficos
<a name="format-sparklines-options"></a>

En la siguiente tabla se describen las opciones de presentación con minigráficos.


| Opción | Opciones | Predeterminado | Description (Descripción) | 
| --- | --- | --- | --- | 
| Comportamiento del eje Y | Compartido, independiente | Compartido | Shared utiliza la misma escala del eje Y en todas las filas para facilitar la comparación. Independent escala cada fila por separado para resaltar las formas de tendencia individuales. | 
| Tipo de elemento visual | Línea, línea de área | Línea | La línea de área agrega un área sombreada debajo de la línea. | 
| Color de línea | Selector de color | Color del tema | Color personalizado para la línea de destellos. | 
| Interpolación de líneas | Lineal, liso, escalonado | Lineal | Controla cómo se conectan los puntos. | 

## Edición y eliminación de minigráficos
<a name="format-sparklines-edit-remove"></a>

Para editar un **minigráfico**, abra el menú desplegable Imágenes en el panel **visual Formato** y elija el icono de edición situado junto al minigráfico que desee modificar. **Actualice la configuración y seleccione Aplicar.**

**Para eliminar un minigráfico, abre el panel de edición del minigráfico y selecciona Eliminar.**

## Eliminación automática
<a name="format-sparklines-auto-removal"></a>

Quick elimina automáticamente los minigráficos cuando los cambios en los campos los invalidan:
+ Se eliminan todos los campos **agrupados por**; se eliminan todos los minigráficos.
+ La columna de valores de un minigráfico se elimina bien del campo **Valores**; ese minigráfico se elimina.
+ El campo del eje X de un minigráfico se añade al campo **Agrupar por** campo; ese minigráfico se elimina.

Cuando un minigráfico se elimina automáticamente, aparece una notificación.

## Limitaciones de Sparkline
<a name="format-sparklines-limitations"></a>

Tenga en cuenta lo siguiente al trabajar con minigráficos:
+ **Número máximo de minigráficos por tabla**: hasta 3 columnas de minigráficos por imagen de tabla
+ **Puntos de datos máximos**: hasta 52 puntos de datos por minigráfico. Si sus datos superan este límite, Quick muestra los últimos 52 puntos de datos según el orden de clasificación del eje X.
+ **Requisitos de campo**: al menos un campo en el pozo **Agrupar por** campos y un campo en el campo **Valores**
+ **Restricción del eje** **X: el campo del eje X no puede ser igual a ningún campo del grupo por**
+ **Uso exclusivo de columnas de valores**: una columna de valores no se puede utilizar tanto en un minigráfico como en una barra de datos
+ **Soporte de exportación**: los minigráficos se incluyen en las exportaciones a PDF, pero no en las exportaciones a CSV o Excel
+ **Comportamiento del filtro**: los filtros aplicados a la tabla también filtran los datos de minigráficos

# Opciones de formato de mapas y gráficos geoespaciales en Quick
<a name="geospatial-formatting"></a>

En Amazon Quick, puede elegir entre varias opciones de formato para sus mapas y gráficos geoespaciales. Puede ver las opciones de formato abriendo el panel **Propiedades** en el menú visual situado en la parte superior derecha del mapa geoespacial actualmente seleccionado. 

Los autores y lectores rápidos también pueden cambiar las diferentes opciones de formato de un mapa geoespacial desde el menú visual.

![\[Cambie las opciones de formato de los mapas geoespaciales desde el menú visual.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/geospatial-map-options-1.gif)


**Topics**
+ [Basar mapas en mapas geoespaciales en Quick](base-maps.md)
+ [Mapas térmicos geoespaciales en Amazon Quick](heat-maps.md)
+ [Agrupación de marcadores en mapas de puntos geoespaciales en Quick](marker-clustering-on-maps.md)

# Basar mapas en mapas geoespaciales en Quick
<a name="base-maps"></a>

Al crear un mapa visual en Quick, puede cambiar la base del mapa. Un *mapa base* es el estilo de mapa que aparece debajo de los datos en un mapa. Un ejemplo es una vista de satélite frente a una vista de calle.

En Quick, hay cuatro opciones para los mapas base: lienzo gris claro, lienzo gris oscuro, calles e imágenes. La siguiente lista contiene un ejemplo de cada opción de mapa base:

**importante**  
En la región de AWS Asia-Pacífico (Mumbai) (ap-south-1), solo se admite el lienzo gris claro.
+ Lienzo gris claro  
![\[Esta es una imagen de ejemplo de un mapa visual con una base de lienzo gris claro.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/map-layers1.png)
+ Lienzo gris oscuro  
![\[Esta es una imagen de ejemplo de un mapa visual con una base de lienzo gris oscuro.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/map-layers2.png)
+ Calles  
![\[Esta es una imagen de ejemplo de un mapa visual con una base de calles.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/map-layers3.png)
+ Imágenes  
![\[Esta es una imagen de ejemplo de un mapa visual con una base de imágenes.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/map-layers4.png)

## Cambio de los mapas base
<a name="base-maps-change"></a>

Utilice el siguiente procedimiento para cambiar un mapa base.

**Cambio de un mapa base**

1. Cree un mapa de puntos o relleno en un análisis. Para obtener más información, consulte [Creación de mapas y gráficos geoespaciales](geospatial-charts.md).

1. En el elemento visual del mapa, elija el icono **Formato del elemento visual**.

1. En el panel **Propiedades** que se abre, elija la sección **Mapa base** y, a continuación, elija el mapa base que desee.

# Mapas térmicos geoespaciales en Amazon Quick
<a name="heat-maps"></a>

Utilice mapas térmicos geoespaciales para revelar patrones de concentración de marcadores en sus imágenes geoespaciales. Los mapas térmicos muestran las concentraciones de puntos de datos mediante una superposición de colores que resalta la intensidad o la concentración de los marcadores visuales.

![\[Este es un ejemplo de cómo funciona la agrupación de marcadores.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/heat-map-1.png)


**Conversión de un mapa geoespacial en un mapa térmico**

1. Abra el análisis y elija el mapa geoespacial al que desee aplicar formato. Al seleccionar una imagen, se muestra con un resaltado a su alrededor.

1. Para abrir el panel de formato, seleccione el icono **visual Formato** en el menú visual.

1. En el panel de formato de la izquierda, elija **Puntos**.

1. Seleccione **Mapa térmico**.

1. (Opcional) En **Gradiente de mapa térmico**, elija el color que desee para los valores **Densidad alta** y **Densidad baja**.

# Agrupación de marcadores en mapas de puntos geoespaciales en Quick
<a name="marker-clustering-on-maps"></a>

Use el agrupamiento en clústeres de marcadores para mejorar la legibilidad de los puntos coubicados en un mapa. Las ubicaciones geoespaciales en los mapas de puntos se representan mediante marcadores. Por lo general, hay un marcador por punto de datos. Sin embargo, si hay demasiados marcadores juntos, el mapa se vuelve difícil de leer. Para facilitar la interpretación del mapa, puede habilitar la agrupación de marcadores para representar agrupaciones de ubicaciones en el mapa. A medida que el lector amplía el mapa, los marcadores agrupados dejan que el marcador de área se muestre por separado. 

![\[Este es un ejemplo de cómo funciona la agrupación de marcadores.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/map-marker-clustering.gif)


**Adición de puntos de clúster a un mapa**

1. Abra el análisis y elija el mapa geoespacial al que desee aplicar formato. Al seleccionar una imagen, se muestra con un resaltado a su alrededor.

1. Para abrir el panel de formato, seleccione el icono **visual Formato** en el menú visual.

1. En el panel de formato de la izquierda, elija **Puntos**.

1. Elija una de las siguientes opciones:
   + **Básico**: utilice la configuración de visualización predeterminada para los puntos del mapa.
   + **Puntos de clúster**: agrupe en clúster los puntos del mapa cuando hay muchos en un área.

# Ejes y líneas de rejilla en tipos visuales en Quick
<a name="showing-hiding-axis-grid-tick"></a>

Al crear un gráfico en Quick, las líneas de eje, las etiquetas de eje, los iconos de ordenación de ejes y las líneas de cuadrícula se añaden al gráfico automáticamente. Si lo desea, puede aplicar formato a las imágenes para mostrarlas u ocultarlas, y también personalizar el tamaño y la orientación de las etiquetas de los ejes.

Puede aplicar formato a las líneas de los ejes, las líneas de cuadrícula y las etiquetas de los ejes, así como los iconos de ordenación de ejes para los siguientes tipos de gráficos:
+ Gráficos de barras
+ Gráficos de cajas
+ Gráficos combinados
+ Histogramas
+ Gráficos de líneas
+ Gráficos de dispersión
+ Gráficos de cascadas

**Aplicación de formato a las líneas de los ejes, las etiquetas de los ejes y las líneas de cuadrícula de un gráfico**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. En el menú de la esquina superior derecha del elemento visual, seleccione el icono Formato del elemento visual.

   El panel **Propiedades** se abre a la izquierda. 

**Pasos para mostrar u ocultar las líneas de los ejes**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Seleccione **Mostrar línea de eje**. Desactive la casilla de verificación para ocultar la línea del eje elegido. Seleccione la casilla de verificación para que se muestre.

**Personalización de los títulos de los ejes**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Elija **Mostrar título**. Desactive la casilla de verificación para ocultar el título del eje y el icono de intercalación desplegable del eje elegido. Seleccione la casilla de verificación para que se muestren.

1. Para cambiar el título del nombre de campo predeterminado, introduzca un título en el cuadro de texto.

**nota**  
Además de los tipos de gráficos enumerados anteriormente en este tema, también puede personalizar los títulos de los ejes en gráficos circulares, gráficos de anillos, gráficos de embudos, mapas térmicos y gráficos de rectángulos.

**Para modificar la configuración de fuente de los ejes**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Ajuste las siguientes propiedades:
   + **Familia de fuentes**
   + **Tamaño del texto**
   + **Estilo** (negrita, cursiva, subrayado)
   + **Color**

**nota**  
Se admite el **subrayado** en los títulos de los ejes, pero no en las etiquetas de los ejes
Los distintos tipos de gráficos utilizan una terminología diferente:  
**Gráficos de barras y líneas: ejes** ****X** y Y**
****Gráficos circulares: valores****
**Mapas de calor**: **filas** y **columnas**

**Pasos para mostrar u ocultar el icono de ordenación**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Elija **Mostrar ordenación**. Desactive la casilla de verificación para ocultar el icono de ordenación del eje elegido. Seleccione la casilla de verificación para que se muestre.

   Si decide eliminar el icono de ordenación, el icono de ordenación se eliminará del eje. Las clasificaciones que se hayan aplicado a la imagen antes de eliminar el icono no se eliminarán de la imagen. 

**nota**  
Además de los tipos de gráficos enumerados anteriormente en este tema, también puede mostrar u ocultar el icono de ordenación en gráficos circulares, gráficos de anillos, gráficos de embudos, mapas térmicos y gráficos de rectángulos.

**Pasos para mostrar u ocultar el zoom de datos**

1. En el panel **Propiedades**, elija **Eje X**.

1. Elija **Mostrar zoom de datos**. Desactive la casilla de verificación para ocultar el zoom de datos. Seleccione la casilla de verificación para que se muestre.

   La barra de zoom de datos aparece automáticamente en los gráficos con un eje X que contienen más de un punto de datos. Ajuste la barra desde la izquierda y la derecha para ampliar puntos de datos específicos del gráfico.
**nota**  
Si amplía o reduce la imagen con la barra de zoom de datos y, a continuación, opta por ocultarla, la posición del zoom no se mantiene. La imagen se reduce completamente para incluir todos los puntos de datos. Al volver a mostrar el zoom de datos, la imagen vuelve a su estado anterior.

**Pasos para mostrar u ocultar las etiquetas de los ejes**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Seleccione **Mostrar etiquetas**. Desactive la casilla de verificación para ocultar las etiquetas de eje del eje elegido. Seleccione la casilla de verificación para que se muestre.

**Cambio del tamaño de la etiqueta**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. En **Tamaño de etiqueta**, elija un tamaño.

**Cambio de la orientación de la etiqueta**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. En **Orientación de etiqueta**, elija una orientación.

**Pasos para mostrar u ocultar las líneas de cuadrículas**

1. En el panel **Propiedades**, seleccione el eje al que desea dar formato.

1. Seleccione **Mostrar líneas de cuadrícula**. Desactive la casilla de verificación para ocultar las líneas de cuadrícula del eje elegido. Seleccione la casilla de verificación para que se muestre.

# Colores en tipos visuales en Quick
<a name="changing-visual-colors"></a>

Puede cambiar el color de uno, algunos o todos los elementos de los siguientes tipos de gráficos:
+ Gráficos de barras
+ Gráficos de anillos
+ Gráficos de medición
+ Mapas térmicos
+ Gráficos de líneas
+ Gráficos de dispersión
+ Gráficos de rectángulos

Para cambiar los colores de los gráficos de barras, los gráficos de anillos, los gráficos de indicadores, los gráficos de líneas y los gráficos de dispersión, consulte [Cambio de colores de gráficos](#format-colors-on-charts). 

Para cambiar los colores de los mapas térmicos y los gráficos de rectángulos, consulte [Cambio de los colores de los mapas térmicos y los gráficos de rectángulos](#format-colors-on-heatmaps-and-treemaps). 

## Cambio de colores de gráficos
<a name="format-colors-on-charts"></a>

Puede cambiar el color del gráfico que utilizan todos los elementos del gráfico y también el color de elementos concretos. Cuando establece el color de un elemento concreto, esto anula el color del gráfico. 

Por ejemplo, suponga que establece el color del gráfico en verde. 

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/color-priority1.png)


Todas las barras se vuelven de color verde. Aunque elija la primera barra, el color del gráfico se aplica a todas las barras. A continuación, establece el color de la barra **SMB** en azul.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/color-priority2.png)


Al observar el resultado, decide que necesita más contraste entre las barras verde y azul, por lo que cambia el color del gráfico a naranja. Si va a cambiar el color del gráfico, no importa desde qué barra elija abrir el menú contextual.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/color-priority3.png)


La barra **SMB** permanece de color azul. Esto se debe a que se ha configurado directamente. Las barras restantes se cambian a color naranja.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/color-priority4.png)


Al cambiar el color de un elemento que está agrupado, el color de dicho elemento cambia en todos los grupos. Un ejemplo es una barra en un gráfico de barras agrupadas. En el siguiente ejemplo, el segmento de cliente se mueve fuera de **Eje Y** y al cuadro de campo **Grupo/color**. La región del cliente se agrega como **Eje Y**. El color del gráfico sigue siendo naranja y SMB permanece de color azul para todas las regiones del cliente.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/color-priority5.png)


Si el elemento visual tiene una leyenda que muestra categorías (dimensiones), puede hacer clic en los valores de la leyenda para ver un menú de acciones disponibles. Por ejemplo, supongamos que el gráfico de barras tiene un campo en el cuadro de campo **Color** o **Grupo/color**. El menú del gráfico de barras muestra las acciones que puede elegir haciendo clic o haciendo clic con el botón derecho en una barra, como las que se muestran a continuación: 
+ Centrarse en elementos visuales o excluirlos
+ Cambiar los colores de los elementos visuales
+ Profundizar en una jerarquía
+ Acciones personalizadas activadas desde el menú, incluidas las acciones de filtrado o URL

A continuación se muestra un ejemplo del uso de la leyenda para cambiar el color de una dimensión.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/visual-elements-legend-color.png)


### Establecimiento de nuevos colores para un elemento visual
<a name="change-visual-color"></a>

Utilice el siguiente procedimiento para cambiar los colores de un elemento visual.

**Cambio de los colores de una imagen**

1. En la página de análisis, seleccione el elemento visual que desea modificar.

1. Para cambiar el color del gráfico, elija cualquier elemento del elemento visual y, a continuación seleccione **Color del gráfico**.

   Para seleccionar elementos, haga lo siguiente: 
   +  En un gráfico de barras, seleccione cualquier barra. 
   +  En un gráfico de líneas, elija el final de una línea. 
   +  En un gráfico de dispersión, elija un elemento. El campo debe estar en la sección **Grupo/color** de **Cuadros de campo**. 

1. Elija el color que desee usar. Puede elegir un color de la paleta existente o puede elegir un color personalizado. Para utilizar un color personalizado, escriba un código hexadecimal para ese color.

   Todos los elementos del elemento visual cambian para utilizar ese color, excepto aquellos cuyo color se haya establecido de manera individual previamente. En ese caso, el color del elemento anula el color del gráfico.

1. Para cambiar el color de un único elemento del elemento visual, elija ese elemento, elija **Color <nombre del campo>** y, a continuación, el color que desee usar. Puede elegir un color de la paleta existente o puede elegir un color personalizado. Para utilizar un color personalizado, escriba un código hexadecimal para ese color.

   Repita este paso hasta que defina el color de todos los elementos que desea modificar. Para volver a cambiar al color original, elija **Restablecer al valor predeterminado**.

### Devolución de los colores del elemento visual nuevamente a los valores predeterminados
<a name="reset-visual-color"></a>

Utilice el siguiente procedimiento para volver a utilizar los colores predeterminados en un elemento visual.

**Pasos para volver a los colores predeterminados de un elemento visual**

1. En la página de análisis, seleccione el elemento visual que desea modificar.

1. Elija **Color del gráfico**, elija cualquier elemento de la imagen y, a continuación, elija **Restablecer al valor predeterminado**. De este modo, el color del gráfico volverá al color predeterminado para ese tipo de imagen. 

   Todos los elementos del elemento visual cambian al color predeterminado para ese tipo de elemento visual, excepto aquellos cuyo color se haya establecido de manera individual previamente. En ese caso, la configuración del color del elemento anula la configuración del color del gráfico.

1. Para cambiar el color de un único elemento nuevamente al color predeterminado, elija ese elemento, seleccione **Color <nombre del campo>** y, a continuación, **Restablecer al valor predeterminado**. 

   El color predeterminado para elementos individuales es el color del gráfico si ha especificado uno; o, de lo contrario, el color predeterminado para el tipo de elemento visual.

## Cambio de los colores de los mapas térmicos y los gráficos de rectángulos
<a name="format-colors-on-heatmaps-and-treemaps"></a>

**Cambio de los colores que se muestran en un mapa térmico o un gráfico de rectángulos**

1. Elija el mapa térmico o el mapa de árboles que desea editar.

1. Seleccione **Expandir** en el menú de ajustes y seleccione el icono con forma de engranaje para abrir el panel **Propiedades**. 

1. Para **Color**, elija los ajustes que desee usar:

1. Para **Color del gradiente** o **Color discreto**, elija el cuadrado de color situado junto a la barra de colores y, a continuación, elija el color que desee utilizar. Repita este procedimiento para cada cuadro de color. La barra contiene dos colores por defecto.

1. Seleccione la casilla **Activar 3 colores** si desea añadir un tercer color. Aparecerá un nuevo cuadrado en el centro de la barra de colores. 

   Puede introducir un número que defina el punto medio entre los dos colores principales del degradado. Si agrega un valor, el color central representa el número que ingresó. Si lo deja en blanco, el color central actúa como los demás colores del degradado. 

1. Seleccione la casilla **Habilitar pasos** si desea limitar el gráfico a los colores que elija. De este modo, la etiqueta de la barra de colores cambia de **Color del gradiente** a **Color discreto**. 

1. En **Color para el valor Null**, elija un color para representar los valores NULL. Esta opción solo está disponible en los mapas térmicos.

# Trabajar con colores a nivel de campo en Amazon Quick
<a name="format-field-colors"></a>

Con la coloración a nivel de campo, puede asignar colores específicos a valores de campo específicos en todos los elementos visuales de un panel o un análisis rápido. Los colores se asignan por campo para simplificar el proceso de configuración de los colores y garantizar la coherencia en todos los elementos visuales que utilizan el mismo campo. Por ejemplo, supongamos que tiene una empresa de transporte que quiere crear un conjunto de imágenes para hacer un seguimiento de las tarifas de envío en diferentes regiones. Con el color a nivel de campo, puede asignar a cada región un color diferente para representar el campo en todos los elementos visuales de un análisis o un panel. De esta forma, los lectores de cuentas aprenden rápidamente qué colores de campo están buscando y les resulta más fácil encontrar la información que necesitan.

Los autores rápidos pueden configurar hasta 50 colores basados en campos por campo. Los colores que se definen a nivel visual tienen prioridad sobre los colores basados en campos. Esto significa que si el autor establece un color para un valor de la imagen, ese color anulará la configuración de colores basada en el campo para esa imagen individual.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/field-coloring.gif)


**Aplicación de colores a nivel de campo a una cuenta antigua**

1. En el panel **Campos** del análisis, elija los puntos suspensivos (tres puntos) situados junto al campo al que desee asignar un color y, a continuación, elija **Editar colores del campo**.

1. En el panel **Editar colores del campo** que aparece, elija el valor al que desee asignar un color y elija el color que desee. Puede aplicar colores a todos los valores que aparecen en el panel **Valores de campo**.

1. Cuando termine de asignar los colores a los campos que desee, elija **Aplicar**.

Si desea restablecer el valor de color de un campo, abra el panel **Editar colores del campo** y elija el icono de actualización situado junto al campo que desee restablecer. Puede restablecer todos los valores de color de un análisis seleccionando **RESTABLECER COLORES**.

Para ver una lista de colores no utilizados que se pueden configurar para nuevos campos, seleccione **Mostrar colores no utilizados** en el panel **Editar colores del campo**. Al restablecer el color de un campo, el color descartado se añade a la lista de **Colores no utilizados** y se puede asignar a un campo nuevo.

# Formato condicional en tipos visuales en Quick
<a name="conditional-formatting-for-visuals"></a>

En algunos tipos de elementos visuales, puede añadir formato condicional para resaltar algunos de sus datos. Entre las opciones de formato condicional que se admiten actualmente se incluyen el cambio de texto o color de fondo y el uso de iconos simbólicos. Puede utilizar los iconos del conjunto proporcionado o bien puede utilizar iconos Unicode en su lugar. 

El formato condicional está disponible en los siguientes elementos visuales:
+ Gráficos de medición
+ Indicadores clave de rendimiento () KPIs
+ Tablas dinámicas
+ Tablas

En el caso de las tablas y las tablas dinámicas, puede establecer varias condiciones para campos o agregaciones admitidas, junto con opciones de formato para aplicar a una celda de destino. En el caso de los gráficos KPIs y de los indicadores, puede formatear el valor principal en función de las condiciones que se apliquen a cualquier dimensión del conjunto de datos. Para los gráficos de medición, también puede formatear el color de primer plano del arco en función de las condiciones.

**Uso del formato condicional en un elemento visual**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. En el elemento visual, abra el menú contextual en el icono inferior situado en la parte superior derecha. A continuación, elija **Formato condicional**.

   Las opciones para dar formato se muestran a la izquierda. Seleccione una de las siguientes opciones:
   + ****Para tablas dinámicas****: comience por elegir una medida que desee utilizar. Puede establecer el formato condicional en uno o más campos. La selección se limita a las medidas que se encuentran en el cuadro de campo **Valores**.
   + ****Para tablas****: comience por seleccionar un campo que desee utilizar. Puede establecer el formato condicional en uno o más campos. También puede aplicar formato a toda la fila. Al dar formato a toda la fila se añade una opción a **Aplicar en la parte superior**, la cual aplica el formato de la fila además del formato que han añadido otras condiciones.
   + ****Para KPIs****: aplique formato al valor principal, a la barra de progreso o a ambos.

1. Para los pasos restantes de este procedimiento, elija las características que desee utilizar. No todas las opciones están disponibles para todos los elementos visuales. 

1. (Opcional) Seleccione **Agregar color de fondo** para establecer un color de fondo. Si ya se ha añadido un color de fondo, seleccione **Fondo**.
   + **Tipo de relleno**: el color de fondo puede ser **Sólido** o **Gradiente**. Si elige utilizar un gradiente, se muestran opciones de color adicionales, lo que le permite seleccionar un valor mínimo y máximo para la escala de gradiente. El valor mínimo se establece de forma predeterminada en el valor mínimo y el valor máximo en el valor máximo.
   + **Campo de formato basado en**: el campo que se usará al aplicar el formato.
   + **Agregación**: la agregación que se utilizará (solo se muestran las agregaciones disponibles). 
   + **Condición**: el factor de comparación que se usará, por ejemplo, “mayor que”.
   + **Valor**: el valor que se usará. 
   + **Color**: el color que se usará.
   + **Opciones adicionales:** en las tablas dinámicas, puede establecer a lo que desea dar formato mediante la elección de las opciones en el menú contextual (**…**): **Valores**, **Subtotales** y **Totales**.

1. (Opcional) Seleccione **Agregar color del texto** para establecer un color de texto. Si ya se ha añadido un color de texto, elija **Texto**.
   + **Campo de formato basado en**: el campo o el elemento que se usará al aplicar el formato. 
   + **Agregación**: la agregación que se utilizará (solo se muestran las agregaciones disponibles). Esta opción se aplica a las tablas y las tablas dinámicas.
   + **Condición**: el factor de comparación que se usará, por ejemplo, “mayor que”.
   + **Valor**: el valor que se usará. 
   + **Color**: el color que se usará.
   + **Opciones adicionales:** en las tablas y las tablas dinámicas, puede establecer a lo que desea dar formato mediante la elección de las opciones en el menú contextual (**…**): **Valores**, **Subtotales** y **Totales**.

1. (Opcional) Elija **Agregar iconos** para establecer un icono o un conjunto de iconos. Si ya se ha añadido un icono, elija **Icono**.
   + **Campo de formato basado en**: el campo o el elemento que se usará al aplicar el formato.
   + **Agregación**: la agregación que se utilizará (solo se muestran las agregaciones disponibles). Esta opción se aplica a las tablas y las tablas dinámicas.
   + **Conjunto de íconos**: el conjunto de íconos que se aplicará al campo **Campo de formato basado en**. Esta opción se aplica a las tablas y las tablas dinámicas.
   + **Invertir colores**: invierte los colores de los iconos de las tablas y las tablas dinámicas.
   + **Condiciones personalizadas**: proporciona más opciones de iconos para tablas y tablas dinámicas.
   + **Condición**: el operador de comparación que se usará. 
   + **Valor**: el valor que se usará. 
   + **Icono**: el icono que se usará. Para elegir un conjunto de iconos, utilice el símbolo **Icono** para elegir los iconos que desee utilizar. Elija uno de los conjuntos de iconos proporcionados. En algunos casos, puede añadir el suyo propio. Para usar su propio icono, elija **Usar ícono de unicode personalizado**. Pegue el glifo Unicode que desee utilizar como icono. Elija **Aplicar** para guardar o **Cancelar** para salir de la configuración de iconos.
   + **Color**: el color que se usará.
   + **Mostrar solo el icono**: reemplaza el valor por el icono en tablas y tablas dinámicas.
   + **Opciones adicionales:**
     + En las tablas y las tablas dinámicas, puede establecer a lo que desea dar formato mediante la elección de las opciones en el menú contextual (**…**): **Valores**, **Subtotales** y **Totales**.
     + En las tablas dinámicas, al activar **Condiciones personalizadas** se activa el formato condicional preestablecido que puede conservar, añadir o sobrescribir con su propia configuración.

1. (Opcional) Seleccione **Agregar color de primer plano** para definir el color de primer plano de una barra de progreso de KPI. Si ya se ha añadido un color de primer plano, elija **Primer plano**. 
   + **Campo de formato basado en**: el campo que se usará al aplicar el formato. 
   + **Condición**: el operador de comparación que se usará. 
   + **Valor**: el valor que se usará. 
   + **Color**: el color que se usará.

1. Cuando haya terminado de configurar el formato condicional, elija una o varias de las opciones siguientes:
   + Para guardar el trabajo, elija **Aplicar**.
   + Para cancelar las selecciones y volver al panel anterior, elija **Cancelar**.
   + Para cerrar el panel de configuración, elija **Cerrar**. 
   + Para restablecer toda la configuración de este panel, elija **Borrar**.

# Opciones de KPI
<a name="KPI-options"></a>

Puedes personalizarlo KPIs en Amazon Quick para adaptarlo a las necesidades de tu empresa. Puede añadir minigráficos o barras de progreso contextuales, asignar valores principales y secundarios y añadir formato condicional a los suyos KPIs.

**Para dar formato a un KPI en Quick, navegue hasta el KPI que desee cambiar y elija el icono **visual Formato** para abrir la imagen Formato.**

Utilice los siguientes procedimientos para realizar tareas de formato. KPIs

## Adición de un elemento visual a un KPI
<a name="KPI-add-visual"></a>

Puede añadir un minigráfico de área, un minigráfico o una barra de progreso a cualquier KPI de Quick. Añadir imágenes para KPIs proporcionar un contexto visual a los lectores que están viendo los datos de los KPI. Utilice el siguiente procedimiento para agregar un elemento visual a un KPI.

**Adición de un elemento visual a un KPI**

1. Desplácese hasta el KPI que desee cambiar y abra el menú Formato del elemento visual.

1. En el menú **Propiedades**, seleccione el cuadro **Elemento visual** para mostrar una imagen en el gráfico de KPI.

1. (Opcional) Abra el menú desplegable **Elemento visual** y elija el tipo de imagen que desea mostrar en su KPI. Puede optar por mostrar un minigráfico de área, un minigráfico o una barra de progreso. Para mostrar un minigráfico, asegúrese de que su KPI tenga un valor en el campo **Tendencia**. **Área del minigráfico** es el valor predeterminado.

1. (Opcional) Para cambiar el color del minigráfico, elija el icono de color situado a la izquierda del menú desplegable **Elemento visual** y elija el color que desea. La barra de progreso no admite el formato de color.

1. (Opcional) Seleccione **Agregar información sobre herramientas** para añadir una información sobre herramientas al elemento visual del KPI.

## Personalización de los valores principales y secundarios
<a name="KPI-customize-values"></a>

Utilice el menú **Formato del elemento visual** para personalizar la fuente y el color y elegir el valor principal que se mostrará. También puede optar por mostrar un valor secundario.

**Personalización de los valores principales y secundarios de un KPI**

1. Desplácese hasta el KPI que desee cambiar, abra el menú **Formato del elemento visual** y vaya a la sección **KPI**.

1. Para **Valor principal**, use el menú desplegable **Fuente** para elegir el tamaño de fuente que desee. El valor predeterminado es **Auto**.

1. (Opcional) Para cambiar el color de la fuente del valor principal, elija el icono de color situado junto al menú desplegable **Fuente** y elija el color que desea.

1. Para **Valor principal mostrado**, puede elegir mostrar el valor real o el valor de comparación del valor principal.

1. Para añadir un valor secundario, elija **Valor secundario**.

   1. (Opcional) Use el menú desplegable **Fuente** para elegir el tamaño de fuente que desee. El valor predeterminado es **Extragrande**.

   1. (Opcional) Para cambiar el color de la fuente del valor secundario, elija el icono de color situado junto al menú desplegable **Fuente** y elija el color que desea.

## Opciones de formato condicional para KPIs
<a name="KPI-conditional-formatting"></a>

El formato condicional para KPIs se establece automáticamente para los valores de comparación. De forma predeterminada, los valores positivos se representan en verde y los negativos en rojo. Puede personalizar los valores de color de estos valores de color desde el menú **Propiedades**.

**Cambio del color de los valores positivos y negativos**

1. En el panel **Propiedades**, abra la sección **Formato condicional** y elija el valor de comparación que desee cambiar.

1. Para cambiar el color del valor positivo, navegue hasta **Condición n.º 1**, elija el icono **Color** y, a continuación, elija el color que desee.

1. Para cambiar el color del valor negativo, navegue hasta **Condición n.º 2**, elija el icono **Color** y, a continuación, elija el color que desee.

1. Cuando haya terminado de realizar los cambios que desee, elija **Aplicar**.

También puede añadir colores e iconos de texto para **Valor real** en el menú **Formato condicional**. Para añadir un color de texto o un icono al valor real, seleccione **Agregar color del texto** o **Agregar icono** para establecer los nuevos valores.

# Etiquetas en tipos visuales en Quick
<a name="customizing-visual-labels"></a>

Utilice el procedimiento siguiente para personalizar, mostrar u ocultar las etiquetas de un elemento visual. 

**Personalización, visualización u ocultación de las etiquetas de un elemento visual**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato. Para cambiar las etiquetas, elija la etiqueta directamente en el elemento visual y elija **Cambiar nombre**. Para recuperar el nombre predeterminado, elimine la entrada.

1. Para ver más opciones, selecciona el menú visual en el icono de abajo situado en la esquina superior derecha de la imagen y, a continuación, selecciona el icono de **formato** visual.

   Para las tablas dinámicas, puede volver a etiquetar los nombres de fila, los nombres de columna y los nombres de los valores. Además, en **Estilo**, puede elegir ocultar etiquetas de columnas o etiquetas de métricas (solo para métricas únicas).

   Puede añadir el mismo valor al mismo elemento visual varias veces. Puede hacerlo para mostrar el mismo valor con distintos cálculos de tabla o agregaciones aplicados. De forma predeterminada, todos los campos muestran la misma etiqueta. Puede editar los nombres mediante el panel **Propiedades**, que podrá abrir si selecciona el icono con forma de **V** en la parte superior derecha.

1. En el panel **Propiedades**, active o desactive **Mostrar título**. Esta opción elimina el título del eje.

1. Cierre el panel **Propiedades**. Para ello, elija el icono **X** de la esquina superior derecha del panel.

# Etiquetas de datos en tipos visuales en Quick
<a name="customizing-visual-data-labels"></a>

Para personalizar las etiquetas de datos en un elemento visual, puede utilizar el panel **Propiedades** para mostrar etiquetas de datos y, a continuación, utilice la configuración para configurarlos. La personalización de las etiquetas de datos es compatible con los gráficos de barras, líneas, combinaciones, áreas, gráficos de dispersión, anillos, diagramas de caja, cascadas, mapas de calor, mapas de árboles, histogramas, embudos, sankey, indicadores, radares y circulares.

Puede personalizar las opciones siguientes:
+ Posición, que determina dónde aparece la etiqueta en relación con el punto de datos (para los gráficos de barras, combinado y de líneas):
  + Para los gráficos de barras verticales, puede personalizar para establecer la posición:
    + Por encima de barras
    + Dentro de barras
    + En la parte inferior de las barras
    + En la parte superior de las barras
  + Para los gráficos de barras horizontales, puede personalizar para establecer la posición:
    + A la derecha de las barras
    + Dentro de barras
  + Para los gráficos de líneas, puede personalizar para establecer la posición:
    + Por encima de líneas
    + A la derecha o a la izquierda de los puntos en las líneas
    + Por debajo de las líneas
  + Para los gráficos de dispersión, puede personalizar para establecer la posición:
    + Por encima de los puntos
    + A la derecha o a la izquierda de los puntos
    + Debajo de los puntos
+ Tamaño y color de fuente (para gráficos de barras, combinado, de líneas, de dispersión y circulares)
+ Patrón de etiqueta, que determina cómo se etiquetan los datos (para gráficos de barras, combinado, de líneas y de dispersión):
  + Para los gráficos de barras, combinados y de dispersión, puede etiquetar:
    + Todos 
    + Por grupo o color
  + Para los gráficos de líneas, están disponibles las siguientes opciones de etiqueta:
    + Todos 
    + Por grupo o color
    + Extremos de línea
    + Valor mínimo o máximo solo
    + Valores mínimos y máximos
  + Para los gráficos circulares, están disponibles las siguientes opciones de etiqueta:
    + Mostrar categoría 
    + Mostrar métrica
    + Elija mostrar la etiqueta de métrica como valor, porcentaje o ambos 
+ Selección de grupo (para barras y líneas, cuando el patrón de etiqueta es “por grupo/color”)
+ Permitir que las etiquetas se solapen (para barras y líneas), para su uso con menos puntos de datos
+ Para los gráficos de barras verticales, combinados y de líneas, las etiquetas que son demasiado largas son angulares de forma predeterminada. Puede configurar el grado del ángulo en la opción de configuración **Eje X**. 

**nota**  
Si añade más de una medida a un eje, la etiqueta de datos solo muestra el formato para la primera medida. 

**Configuración de las etiquetas de datos**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. **Seleccione el menú visual en el icono descendente situado en la esquina superior derecha de la imagen y, a continuación, elija el icono visual Formato.**

1. En el panel **Propiedades**, elija **Etiquetas de datos**. 

1. Habilite **Mostrar etiquetas de datos** para mostrar y personalizar etiquetas. Desactive esta opción para ocultar las etiquetas de datos.

1. Elija los ajustes que desee usar. Los ajustes que se ofrecen son ligeramente diferentes para cada tipo de gráfico. Para ver todas las opciones disponibles, consulte la lista antes de este procedimiento. 

   Puede ver inmediatamente el efecto de cada cambio en el elemento visual. 

1. Para modificar la configuración de la fuente de las etiquetas de datos, ajuste las siguientes propiedades:
   + **Familia de fuentes**
   + **Tamaño del texto**
   + **Estilo** (negrita, cursiva)
   + **Color**

1. Cierre el panel **Propiedades**. Para ello, elija el icono X de la esquina superior derecha del panel.

# Formatear datos numéricos visuales en función de la configuración de idioma en Quick
<a name="customizing-visual-language-preferences"></a>

En Amazon Quick, puede elegir cómo aparecen los valores de los datos numéricos en las imágenes para que se alineen con el idioma regional que haya elegido.

Como autor de Quick, puede elegir el formato de idioma que mejor se adapte a su audiencia. Amazon Quick configura los lenguajes de datos numéricos en el nivel de análisis en función del idioma que haya elegido para ver Quick in. Puede cambiar el formato de los números, las divisas y las fechas. Puede cambiar la configuración de idioma de Quick en la lista desplegable de **idiomas** del menú Quick **User**, en la esquina superior derecha. Puede cambiar el formato de idioma de un campo en cada elemento visual de una hoja o puede cambiar el formato de idioma a nivel visual individual.

**Cambio del formato de idioma numérico de todos los elementos visuales de un análisis**

1. En el panel **Elementos visuales** del análisis que desee cambiar, elija el icono de más acciones (tres puntos) situado junto al campo que desee cambiar. En el menú que aparece, abra la lista desplegable **Formato** y, a continuación, seleccione **Más opciones de formato**.

1. En el panel **Formato de datos** que aparece a la izquierda, seleccione **Aplicar formato de lenguaje**.

   Para restablecer el formato de idioma predeterminado del campo, vuelva a abrir el menú **Formato de datos** y seleccione **Restablecer a los valores predeterminados**. El formato de idioma predeterminado es el inglés de Estados Unidos.

**Cambio del formato de idioma numérico de un solo elemento visual de un análisis**

1. En la página de análisis, seleccione el elemento visual que desea modificar.

1. Navegue hasta el panel **Formato de datos** mediante una de las siguientes opciones:
   + En la imagen que contiene los datos que desea cambiar, seleccione el campo que desee cambiar, abra la lista desplegable **Formato** y, a continuación, elija **Más opciones de formato**.  
![\[Acceda al panel Formato de datos en el elemento visual.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/format-visual-numeric-data-language-3.png)
   + En la sección **Cuadros de campo** del análisis, abra el menú desplegable situado junto al campo que desee cambiar. Abra el menú **Formato** y seleccione **Más opciones de formato**.  
![\[Acceda al panel Formato de datos desde los cuadros de campos.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/format-visual-numeric-data-language-6.png)

1. En el panel **Formato de datos** que aparece, seleccione **Aplicar formato de lenguaje**.

   Para restablecer el formato de idioma predeterminado del elemento visual, vuelva a abrir el menú **Formato de datos** y seleccione **Restablecer a los valores predeterminados**. El formato de idioma predeterminado es el inglés de Estados Unidos.

# Leyendas sobre los tipos visuales en Quick
<a name="customizing-visual-legend"></a>

La *leyenda del elemento visual* le ayuda a identificar lo que representa un elemento visual mapeando su valor a un color. De forma predeterminada, la leyenda se muestra a la derecha del elemento visual. Puede optar por ocultar o mostrar la leyenda visual y dar formato al título y la posición de la leyenda. También puede personalizar la configuración de fuente para el título y los elementos de la leyenda.

**Pasos para mostrar u ocultar la leyenda de un elemento visual**

1. Inicie sesión en Quick at[https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. Elija el elemento visual al que desee dar formato y, a continuación, elija el icono **Propiedades** para abrir el panel Propiedades.

1. Active la **Leyenda** para mostrar la leyenda del elemento visual. Cuando se muestra, la leyenda muestra los valores en orden alfabético. Para ocultar la leyenda, desactive el conmutador **Leyenda**.

**Personalización de la leyenda de un elemento visual**

1. Abra el panel Propiedades y expanda la sección **Leyenda**.

1. Use el menú desplegable **Posición** para personalizar la posición de la leyenda en el elemento visual.

1. En **Título de leyenda**, ingrese un nombre personalizado para la leyenda y lleve a cabo todas o algunas de las siguientes acciones:

   1. (Opcional) Para cambiar el color del título de la leyenda, elija la muestra de color situada debajo de Título de leyenda y elija el color que desea que tenga el título de la leyenda.

   1. (Opcional) Para cambiar la fuente o el tamaño del título de la leyenda, abra el menú desplegable **Fuente** o **Tamaño de fuente** y elija la fuente o el tamaño de fuente que desee.

   1. (Opcional) Para poner el título de la leyenda en negrita, cursiva o subrayado, elija el icono correspondiente en la barra de estilos.

1. Para el **elemento Leyenda**, lleve a cabo todas o algunas de las siguientes acciones:

   1. (Opcional) Para cambiar el color de la fuente del elemento de la leyenda, elija la muestra de color y elija el color que desea que tenga el título de la leyenda.

   1. (Opcional) Para cambiar la fuente o el tamaño de fuente del título de la leyenda, abra el menú desplegable **Fuente** o **Tamaño** de fuente y elija la fuente o el tamaño de fuente que desee.

   1. (Opcional) Para poner la fuente del elemento de leyenda en negrita, cursiva o subrayado, elija el icono correspondiente en la barra de estilos.

1. Elija el icono **X** en la esquina superior derecha para cerrar el panel **Propiedades**.

# Estilo de líneas y marcadores en gráficos de líneas en Quick
<a name="line-and-marker-styling"></a>

En los gráficos de líneas rápidas, tienes varias opciones para enfatizar aquello en lo que quieres que se centren los lectores: el color, el estilo de línea y los marcadores. Puede usar estas opciones juntas o por separado para ayudar a los lectores a entender sus gráficos de líneas más rápidamente en diferentes circunstancias. Por ejemplo, si algunos de sus lectores no ven diferencias de color (quizás debido al daltonismo o a la impresión monocromática), puede utilizar patrones de líneas para distinguir una o más líneas de un gráfico. 

En otros casos, puede utilizar líneas escalonadas para llamar la atención sobre cambios bruscos o intervalos entre cambios en los datos. Por ejemplo, supongamos que crea un gráfico que muestra los cambios en el precio de los sellos postales en EE. UU. y desea hacer hincapié en el aumento del precio a lo largo del tiempo. Puede utilizar una línea escalonada, que permanece plana entre los puntos de datos hasta que se produzca el siguiente cambio de precio. La historia de los datos sobre los aumentos bruscos de precios es más clara para el lector si se trata de una línea escalonada. Si quisiera mostrar una historia de cambios graduales a lo largo del tiempo, lo más probable es que prefiera diseñar la línea con una inclinación suave.

**Personalización del estilo de una visualización**

1. Abra el análisis y elija el gráfico al que desee aplicar formato.

1. En la parte superior derecha de la imagen que desee formatear, seleccione **Formato del elemento visual**, que se representa mediante un icono de lápiz.

1. A la izquierda, seleccione **Serie de datos**.

1. Elija una de las siguientes opciones:
   + **Estilo base**: para editar el estilo de todas las líneas y marcadores del gráfico
   + **Seleccionar la serie a la que aplicar un estilo**: para editar el estilo del campo que elija de la lista

   Se muestran diferentes opciones en función del número de campos compatibles que haya en la imagen.

1. Active **Línea** para activar o desactivar el estilo de línea. 

   Puede personalizar las siguientes opciones de línea:
   + El grosor o espesor de la línea.
   + El estilo de la línea: continuo, discontinuo o punteado.
   + El color de la línea.
   + El tipo de línea que es: lineal, suave o escalonada.

1. Active **Marcador** para activar o desactivar el estilo del marcador.

   Puede personalizar las opciones de marcador siguientes:
   + El grosor o espesor del marcador.
   + El estilo del marcador: círculo, triángulo, cuadrado, rombo, etc.
   + El color del marcador.

1. En **Eje**, elija si desea mostrar el eje a la izquierda o a la derecha.

1. Los cambios se guardan automáticamente. 

1. (Opcional) Para deshacer las personalizaciones, elija una o más de las siguientes opciones:
   +  Para deshacer un cambio, haga clic en la flecha de deshacer situada en la parte superior izquierda. Repita este procedimiento según sea necesario. También hay una flecha para rehacer. 
   +  Para restablecer el estilo base de una serie de datos, seleccione **Estilo base** y, a continuación, haga clic en **Restablecer al valor predeterminado**. 
   +  Para eliminar todos los estilos de una serie de datos, incluida en **Serie de estilos**, seleccione un campo y, a continuación, haga clic en **Eliminar estilo**. 

# Faltan datos sobre los tipos visuales en Quick
<a name="customizing-missing-data-controls"></a>

Puede personalizar la forma en que se visualizan los puntos de datos faltantes en sus gráficos de líneas y áreas. Puede elegir que los puntos de datos que faltan aparezcan en los siguientes formatos:
+ *Broken line*: línea discontinua que se rompe cuando falta un punto de datos. Este es el formato predeterminados para falta de datos.
+ *Continuous line*: muestra una línea continua saltando el punto de datos que falta y conectando la línea con el siguiente punto de datos disponible de la serie. Para mostrar una línea continua, debe desactivar la casilla **Mostrar intervalos de fecha** en el panel **Eje X**.
+ *Mostrar como cero*: establece el valor del punto de datos que falta en cero.

**Personalización de la configuración de datos faltantes de un elemento visual**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. Elija el icono **Formato del elemento visual** en la esquina superior derecha del elemento visual para acceder al menú **Formato del elemento visual**.

1. Abra el panel **Eje Y** del menú Formato del elemento visual y navegue hasta la sección **Faltan datos**.

1. Seleccione el formato de datos que desee.

# Líneas de referencia en los tipos de imágenes en Quick
<a name="reference-lines"></a>

Las *líneas de referencia* son marcas visuales en un elemento visual, similares a las líneas de regla. Por lo general, se utiliza una línea de referencia para un valor que debe mostrarse con los datos. La línea de referencia se utiliza para comunicar los umbrales o límites de los valores. La línea de referencia no forma parte de los datos que se utilizan para crear un gráfico. En cambio, se basa en un valor que se introduce o en un campo que se identifica en el conjunto de datos utilizado por el gráfico. 

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/formatting-reference-lines-example.png)


Quick admite las siguientes líneas de referencia: 
+  Gráficos de barras
+  Gráficos de líneas
+  Gráficos combinados

Puede crear, cambiar y eliminar líneas de referencia al diseñar un análisis. Puede personalizar el patrón de líneas, la fuente de la etiqueta y los colores de cada uno de ellos por separado. Puede mostrar los valores numéricos como números, divisas o porcentajes. También puede personalizar el formato numérico de un valor del mismo modo que puede personalizar un cuadro de campo.

Hay dos tipos de líneas de referencia:
+ Se muestra una *línea constante* en una posición que se basa en un valor que se especifique en la configuración del formato. No es necesario que este valor esté relacionado con ningún campo. Puede personalizar el formato de la línea. 
+ Una *línea calculada* se muestra en una posición que se basa en un valor que es el resultado de una función. Durante la configuración, se especifica qué medida (métrica) se quiere utilizar y qué agregación se va a aplicar. Estas son las mismas agregaciones a las que puede aplicar en los cuadros de campo. A continuación, debe proporcionar una agregación para aplicarla al cálculo de campo de la línea de referencia, por ejemplo, promedio, mínimo, máximo o percentil. El campo debe estar en el conjunto de datos que utiliza el gráfico, aunque no es necesario que se muestre en los pozos de campo del gráfico. 

Las líneas de referencia calculadas no se admiten en los gráficos apilados al 100 %.

**Adición o edición de una línea de referencia (consola)**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el análisis que desee cambiar.

1. Elija el elemento visual que desee cambiar y abra el menú **Propiedades**.

1. En el panel **Propiedades** que se abrirá, abra el menú desplegable **Líneas de referencia** y, a continuación, elija **AGREGAR NUEVA LÍNEA**.

1. Se abrirá el menú **Nueva línea de referencia**. Utilice este menú para configurar la nueva línea de referencia. La siguiente lista describe todas las propiedades de la línea de referencia que se pueden configurar.
   + **Datos** 
     + **Tipo**: el tipo de línea de referencia que desea utilizar. Elija una de las siguientes opciones:
       + Para crear una línea constante basada en un único valor que introduzca, elija **Línea constante**. 
       + Para crear una línea calculada basada en un campo, elija **Línea calculada**. 
     + **Valor**: (solo para líneas constantes) el valor que desea usar. Se convierte en la ubicación de la línea en la imagen. Aparece inmediatamente, por lo que puede experimentar con la configuración.
     + **Columna**: (solo para líneas calculadas) la columna que desea usar como línea de referencia.
     + **Agregado como** (columna): (solo para líneas calculadas) la agregación que desea aplicar a la columna seleccionada.
     + **Calcular**: (solo para las líneas calculadas) el cálculo que desea aplicar a la agregación.
     + **Valor de percentil**: (solo si ha establecido **Calcular** como **Percentil**) introduzca un número comprendido entre 1 y 100.
     + **Tipo de gráfico** (para gráficos combinados) elija **Barras** o **Líneas**.
   + **Estilo de línea** 
     + **Patrón**: el patrón utilizado para la línea. Las opciones válidas incluyen **De guiones**, **De puntos** y **Sólido**.
     + **Color**: el color utilizado para la línea.
   + **Etiqueta**
     + **Tipo**: el tipo de etiqueta que se va a mostrar. Las opciones válidas son **Solo valor**, **Texto personalizado**, **Texto y valor personalizados** y **Sin etiqueta**. Si elige una opción que incluya texto personalizado, escriba el texto de etiqueta que desea que aparezca en la línea. 
     + **Escriba el texto personalizado** (cuadro de texto): (solo si ha establecido **Tipo** como **Texto y valor personalizados**. Elija dónde desea mostrar el valor en relación con la etiqueta. Las opciones válidas son **Izquierda** o **Derecha**.
     + **Posición**: la posición de la etiqueta en relación con la línea. Las opciones válidas incluyen una combinación de las siguientes: izquierda, centro, derecha, arriba y abajo. 
     + **Formato de valor**: el formato que se va a utilizar para el valor. Seleccione una de las siguientes opciones:
       + **Igual que el valor**: usa el formato que ya está seleccionado para este campo en la visualización.
       + **Mostrar como**: elija entre las opciones disponibles, por ejemplo, número, divisa o porcentaje.
       + **Formato**: elija entre las opciones de formato disponibles.
     + **Tamaño de fuente**: el tamaño de fuente que se va a utilizar para el texto de la etiqueta. 
     + **Color**: el color que se va a utilizar para el texto de la etiqueta.

1. Para guardar lo que ha seleccionado, elija **Listo**.

**Enumeración de las líneas de referencia existentes**

1. Elija el elemento visual que desee cambiar y abra el panel **Propiedades**.

1. En el panel **Propiedades**, abra el menú desplegable **Líneas de referencia** y, a continuación, elija los puntos suspensivos (tres puntos) situados junto a la línea que desee cambiar.

1. Elija **Edit (Edición de)**.

1. Se abrirá el menú **Nueva línea de referencia**. Use este menú para realizar cambios en la línea de referencia. Cuando haya terminado, elija **Listo**.

**Deshabilitación de una línea de referencia**

1. Elija el elemento visual que desee cambiar y abra el panel **Propiedades**.

1. En el panel **Propiedades**, abra el menú desplegable **Líneas de referencia** y, a continuación, elija los puntos suspensivos (tres puntos) situados junto a la línea que desee cambiar.

1. Elija **Deshabilitar**.

**Eliminación de una línea de referencia**

1. Elija el elemento visual que desee cambiar y abra el panel **Propiedades**.

1. En el panel **Propiedades**, abra el menú desplegable **Líneas de referencia** y, a continuación, elija los puntos suspensivos (tres puntos) situados junto a la línea que desee cambiar.

1. Elija **Eliminar**.

# Formatear gráficos radiales en Quick
<a name="format-radar-chart"></a>

Puede personalizar los gráficos de radar en Amazon Quick para organizar los datos de la forma que desee. Puede personalizar el estilo de serie, el ángulo inicial, el área de relleno y la forma de la cuadrícula de un gráfico de radar.

**Establecimiento del estilo de serie de un gráfico de radar**

1. Elija la imagen del gráfico de radar que desee cambiar y elija el icono **Formato del elemento visual** situado en la esquina superior derecha de la imagen.

1. En el panel **Propiedades** de la izquierda, abra la lista desplegable **Gráfico de radar**.

1. En **Estilo de serie**, elija el estilo que desee. Puede elegir entre los siguientes estilos:
   + **LÍNEA**. Cuando se selecciona, se perfilan los polígonos creados por los datos. 
   + **ÁREA**. Cuando se selecciona, se perfilan los polígonos creados por los datos. 

   El valor seleccionado por defecto es **LÍNEA**.

**Elección del ángulo inicial de un gráfico de radar**

1. Elija la imagen del gráfico de radar que desee cambiar y elija el icono **Formato del elemento visual** situado en la esquina superior derecha de la imagen.

1. En el panel **Propiedades** de la izquierda, abra la lista desplegable **Gráfico de radar**.

1. En **Ángulo de inicio**, introduzca el valor del ángulo inicial que desee. El valor predeterminado es de 90 grados.

**Establecimiento del área de relleno de un gráfico de radar**

1. Elija la imagen del gráfico de radar que desee cambiar y elija el icono **Formato del elemento visual** situado en la esquina superior derecha de la imagen.

1. En el panel **Propiedades** de la izquierda, abra la lista desplegable **Eje**.

1. Active la casilla de verificación **Rellenar líneas de cuadrícula**.

1. (Opcional) Seleccione los colores de las líneas de cuadrícula con números pares e impares.
   + Elija el icono **Color uniforme** que aparece y, a continuación, elija el color que desee que tengan las líneas de cuadrícula con números pares. El color predeterminado para este valor es el blanco.
   + Elija el icono **Color irregular** que aparece y, a continuación, elija el color que desee que tengan las líneas de cuadrícula con números impares. El color predeterminado para este valor es el blanco.

**Elección de la forma de cuadrícula de un gráfico de radar**

1. Elija la imagen del gráfico de radar que desee cambiar y elija el icono **Formato del elemento visual** situado en la esquina superior derecha de la imagen.

1. En el panel **Propiedades** de la izquierda, abra la lista desplegable **Gráfico de radar**.

1. En **Forma de cuadrícula**, elija la forma que desee que tenga la cuadrícula del gráfico de radar. Puede elegir entre un **POLÍGONO** y un **CÍRCULO**.

# Rango y escala de los tipos visuales en Quick
<a name="changing-visual-scale-axis-range"></a>

Para cambiar la escala de los valores que se muestran en el elemento visual, puede usar el panel **Propiedades** para definir el intervalo de uno o de los dos ejes del elemento visual. Esta opción está disponible para los ejes de valores de los gráficos combinados, de barras, de líneas y de dispersión. 

De forma predeterminada, el intervalo del eje comienza en 0 y finaliza en el valor más alto de la medida que se muestra. Para el eje que se utiliza para la agrupación, puede usar la herramienta de zoom de datos del elemento visual para ajustar la escala de manera dinámica.

**Establecimiento del rango de ejes de una imagen**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. Elija el menú de control en la esquina superior derecha del elemento visual y pulse el icono del engranaje.

1. En el panel **Propiedades**, elija **Eje X** o **Eje Y**, en función del tipo de elemento visual que vaya a personalizar. La sección **Eje X** se utiliza para gráficos de barras horizontales, la sección **Eje Y** para gráficos de barras verticales y gráficos de líneas, y ambos ejes están disponibles para gráficos de dispersión. En los gráficos combinados, utilice **Barras** y **Líneas**. 

1. Escriba un nuevo nombre en el cuadro para cambiar el nombre del eje. Para recuperar el nombre predeterminado, elimine la entrada.

1. Establezca el intervalo para el eje seleccionando una de las siguientes opciones:
   + Elija **Auto (a partir de 0)** para el intervalo que comienza en 0 y finaliza en torno al valor más alto para la medida que se muestra.
   + Elija **Auto (en función del intervalo de datos)** para que el intervalo comience en el valor más bajo para la medida que se muestra y finalice en torno al valor más alto de dicha medida.
   + Elija **Intervalo personalizado** para que el intervalo comience y finalice en los valores que especifique.

     Si elige **Intervalo personalizado**, escriba los valores de inicio y fin en los campos de esa sección. Por norma general, debe utilizar los enteros para los valores del intervalo. Para los gráficos de barras apiladas al 100%, utilice un valor decimal para indicar el porcentaje que desee. Por ejemplo, si desea que el intervalo sea del 0 al 30 por ciento en lugar del 0 al 100 por ciento, escriba 0 para el valor inicial y ,3 para el valor final.

1. En **Escala**, el valor por defecto es escala lineal. Para mostrar la escala logarítmica, también llamada escala de registro, habilite la opción logarítmica. Quick elige las etiquetas de los ejes que se van a mostrar en función del rango de valores de ese eje.
   + En una escala lineal, las etiquetas del eje se espacian uniformemente para mostrar la diferencia aritmética entre ellas. Las etiquetas muestran los números en conjuntos como \$11000, 2000, 3000...\$1 o \$10, 50 millones, 100 millones...\$1, pero no \$110 mil, 1 millón\$1.

     Utilice una *escala lineal* para los siguientes casos:
     + Todos los números que aparecen en el gráfico están en el mismo orden de magnitud. 
     + Las etiquetas del eje deben estar espaciadas de manera uniforme.
     + Los valores del eje tienen un número similar de dígitos, por ejemplo, 100, 200, 300, etc. 
     + La velocidad de cambio entre los números es relativamente lenta y constante; en otras palabras, la línea de tendencia nunca se acerca a convertirse en vertical.

     Ejemplos:
     + Beneficios en diferentes regiones del mismo país
     + Gastos de fabricación de un artículo
   + En una *escala logarítmica*, los valores del eje se espacian para mostrar los órdenes de magnitud como una forma de compararlos. La escala de registro se utiliza a menudo para mostrar rangos muy grandes de valores o porcentajes, o para mostrar un crecimiento exponencial.

     Utilice la escala logarítmica para los siguientes casos:
     + Los números que aparecen en el gráfico no están en el mismo orden de magnitud. 
     + Las etiquetas del eje deben estar espaciadas de forma flexible para reflejar el amplio rango de valores en ese eje. Esto podría significar que los valores del eje tienen un número diferente de dígitos, por ejemplo, 10, 100, 1000, etc. También podría significar que las etiquetas del eje están separadas de manera desigual.
     + La tasa de cambio entre números está creciendo exponencialmente o es demasiado grande para mostrarse de manera significativa.
     + El cliente del gráfico entiende cómo interpretar los datos en una escala de registro.
     + El gráfico muestra valores que crecen cada vez más rápido. Mover la distancia dada en la escala significa que el número se ha multiplicado por otro número. 

     Ejemplos:
     + Precios de las acciones de alto rendimiento durante un largo periodo de tiempo
     + Aumento de las tasas de infección de una pandemia

1. Para personalizar el número de valores que se deben mostrar en las etiquetas del eje, escriba un número entero entre 1 y 50.

1. En los gráficos combinados, elija **Eje Y único** para sincronizar los ejes Y de las barras y las líneas en un único eje.

1. Cierre el panel **Propiedades**. Para ello, elija el icono **X** de la esquina superior derecha del panel.

# Opciones de ejes múltiples pequeños
<a name="small-multiples-options"></a>

Puede configurar los ejes x e y de cada panel individual de un elemento visual de múltiplos pequeños. Puede agrupar los datos a lo largo de un eje x independiente o un eje y independiente. También puede colocar los ejes x e y dentro o fuera del gráfico para mejorar la legibilidad de los datos.

En el caso de imágenes de múltiplos pequeños que utilizan un eje x independiente, solo se muestran en el eje los valores que son relevantes para cada panel. Por ejemplo, supongamos que tiene una imagen de múltiplos pequeños que utiliza un panel para representar cada región de los Estados Unidos. Con un eje x independiente, cada panel solo muestra los estados de la región que representa y oculta los estados que están fuera de la región del panel.

En el caso de imágenes múltiples pequeñas que utilizan un eje Y independiente, cada panel utiliza su propia escala de eje Y, determinada por el rango de datos que contiene. De forma predeterminada, las etiquetas de datos aparecen en el interior del panel.

**Configuración de ejes independientes para imágenes múltiples pequeñas**

1. Seleccione el elemento visual de múltiplos pequeños que desee cambiar y abra el menú **Formato del elemento visual**.

1. En el panel **Propiedades** que aparece, abra el menú **Varias opciones**.

1. En **Eje X**, elija **Independiente** en el menú desplegable.

   O bien, en **Eje Y**, elija **Independiente** en el menú desplegable.

Para revertir los cambios, seleccione **Compartido** en los menús desplegables del **eje X** o del **eje Y**.

También puede configurar las posiciones de las etiquetas de los ejes x e y de todos los paneles en un elemento visual de múltiplos pequeños. Puede elegir mostrar las etiquetas de los ejes dentro o fuera del panel.

**Configuración de la posición de la etiqueta del eje para elementos visuales de múltiplos pequeños**

1. Seleccione el elemento visual de múltiplos pequeños que desee cambiar y abra el menú **Formato del elemento visual**.

1. En el panel **Propiedades** que aparece, abra el menú **Varias opciones**.

1. Para **Etiquetas del eje X**, seleccione **Interior** o **Exterior** en el menú desplegable.

   O bien, para **Etiquetas del eje Y**, seleccione **Interior** o **Exterior** en el menú desplegable.

# Títulos y subtítulos en tipos visuales en Quick
<a name="customizing-a-visual-title"></a>

En Quick, puede dar formato a los títulos y subtítulos visuales para adaptarlos a las necesidades de su empresa. Quick ofrece un formato de texto enriquecido para títulos y subtítulos, y la posibilidad de añadir hipervínculos y parámetros a los títulos. Puede editar los títulos en el panel Propiedades o haciendo doble clic en un título o subtítulo del elemento visual.

Utilice el siguiente procedimiento para personalizar la forma en que se muestran el título y el subtítulo de un elemento visual. El título del elemento visual se muestra de forma predeterminada. Una vez creados los subtítulos, también se muestran de forma predeterminada.

1. Inicie sesión en Quick at[https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).

1. Abra el análisis que desee actualizar.

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. A la derecha del elemento visual, elija el icono **Propiedades**.

1. En el panel **Propiedades** que se abrirá, elija la pestaña **Configuración de visualización**.

1. Para editar el título o el subtítulo de un elemento visual, elija el icono del pincel situado junto a **Editar título** o **Editar subtítulo**. Como alternativa, puede elegir el icono en forma de globo ocular situado junto a **Editar título** o **Editar subtítulo** para ocultar el título o el subtítulo, como se muestra en la siguiente imagen.

1. En la ventana emergente **Editar título** o **Editar subtítulo** que se abre, puede usar las siguientes opciones para llevar a cabo las actualizaciones que desee:
   + Para introducir un título o subtítulo personalizado, ingrese el texto del título o del subtítulo en el editor. Los títulos pueden tener una longitud máxima de 120 caracteres, incluidos los espacios. Los subtítulos pueden tener hasta 500 caracteres.
   + Para cambiar el tipo de fuente, elija un tipo de fuente de la lista de la izquierda.
   + Para cambiar el tamaño de la fuente, elija un tamaño de la lista de la derecha.
   + Para cambiar el grosor y el énfasis de la fuente, o para subrayar o tachar el texto, elija los iconos de negrita, énfasis, subrayado o tachado.
   + Para cambiar el color de la fuente, seleccione el icono de color (Abc) y, a continuación, elija un color. También puede introducir un número hexadecimal o valores RGB.
   + Para añadir una lista desordenada, elija el icono de lista desordenada.
   + Para cambiar la alineación del texto, seleccione los iconos de alineación izquierda, central o derecha.
   + Para añadir un parámetro a un título o subtítulo, seleccione un parámetro existente de la lista situada en **Parámetros**, a la derecha. Para más información sobre cómo crear parámetros, consulte [Configuración de parámetros en Amazon Quick](parameters-set-up.md).
   + Para añadir un hipervínculo, resalte el texto que desee vincular, elija el icono del hipervínculo y, a continuación, elija una de las siguientes opciones:
     + En **Escribir enlace**, introduzca la URL a la que quiere vincular.

       Seleccione el icono \$1 de la derecha para añadir un parámetro, función o cálculo existente a la URL.
     + Para editar el texto de visualización, introduzca el texto en Texto para **Mostrar texto**.
     + Para abrir el hipervínculo en la misma pestaña del navegador que Quick, seleccione **Misma pestaña**.
     + Para abrir el hipervínculo en una nueva pestaña del navegador, seleccione **Nueva pestaña**.
     + Para eliminar el hipervínculo, seleccione el icono de eliminación situado en la parte inferior izquierda.

     Cuando termine de configurar las etiquetas, elija **Guardar**.

1. Cuando termine de actualizar las etiquetas, elija **Guardar**.

1. En **Texto alternativo**, ingrese el texto alternativo que desee para la imagen.

1. Cuando haya terminado, cierre el panel de propiedades.

# Información sobre herramientas sobre tipos visuales en Quick
<a name="customizing-visual-tooltips"></a>

Al pasar el cursor sobre cualquier elemento gráfico de una imagen rápida, aparece una descripción emergente con información sobre ese elemento específico. Por ejemplo, cuando coloca el cursor sobre las fechas de un gráfico de líneas, aparece una información sobre herramientas con información sobre esas fechas. De forma predeterminada, los campos del cuadro de campos determinan qué información se muestra en la información sobre herramientas. La información sobre herramientas puede mostrar hasta 10 campos.

Puede proporcionar a sus espectadores información adicional sobre los datos de su imagen, personalizando lo que pueden ver los espectadores. Incluso puede impedir que aparezca información sobre herramientas cuando los espectadores sitúen el cursor sobre un elemento. Para ello, puede personalizar la información de herramientas para ese elemento visual. 

## Personalización de la información sobre herramientas en un elemento visual
<a name="customizing-visual-tooltips-customize"></a>

Utilice el siguiente procedimiento para personalizar información sobre herramientas en un elemento visual.

**Personalización de la información sobre herramientas en un elemento visual**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. En el menú de la parte superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

1. En el panel **Propiedades** que se abrirá, elija **Información sobre herramientas**.

1. En **Tipo**, elija **Información detallada sobre herramientas**. Aparece un nuevo conjunto de opciones.

**Pasos para mostrar u ocultar los títulos de información sobre herramientas**
+ Elija **Utilice el valor principal como título**.

  Al desactivar la opción, se ocultan los títulos en la información sobre herramientas. Al seleccionar la opción, se muestra el valor del campo principal como título en la información sobre herramientas.

**Pasos para mostrar u ocultar las agregaciones de los campos en la información sobre herramientas**
+ Seleccione **Mostrar agregaciones**.

  Al desactivar la opción, se oculta la agregación de los campos en la información sobre herramientas. Al seleccionar la opción, se oculta la agregación de los campos en la información sobre herramientas.

**Adición de un campo a la información sobre herramientas**

1. Seleccione **Agregar campo**.

1. En la página **Agregar campo a la información sobre herramientas** que se abre, seleccione **Seleccionar campo** y, a continuación, seleccione un campo de la lista.

   Puede agregar hasta 10 campos a la información de herramientas.

1. (Opcional) En **Etiqueta**, introduzca una etiqueta para el campo. Esta opción crea una etiqueta personalizada para el campo de la información sobre herramientas.

1. (Opcional) Dependiendo de si agrega una dimensión o una medida, elija cómo desea que se muestre la agregación en la descripción emergente. Si no selecciona ninguna opción, Quick utiliza la agregación predeterminada.

   Si agrega una medida a la información sobre herramientas, puede seleccionar cómo desea que se agregue el campo. Para ello, elija **Seleccionar agregación** y, a continuación, seleccione una agregación de la lista. Para obtener más información sobre los tipos de agregaciones de Quick, consulte[Cambio de la agregación de campo](changing-field-aggregation.md).

1. Seleccione **Save**.

   Se agregará un campo nuevo a la lista de campos de la información sobre herramientas.

**Eliminación de un campo de la información sobre herramientas**
+ En la lista **Campos**, seleccione el menú de campos del campo que desee eliminar (los tres puntos) y elija **Ocultar**.

**Reorganización del orden de los campos en la información sobre herramientas**
+ En la lista **Campos**, seleccione el menú de campos de un campo (los tres puntos) y elija **Subir** o **Bajar**.

**Personalización de la etiqueta de un campo en la información sobre herramientas**

1. Seleccione el menú de campos para el campo que desee personalizar (los tres puntos) y elija **Editar**.

1. En la página **Editar campo de información sobre herramientas** que se abre, en **Etiqueta**, introduzca la etiqueta que desee que aparezca en la información sobre herramientas.

1. Seleccione **Save**.

## Uso de la información sobre herramientas de las hojas en Quick
<a name="customizing-visual-tooltips-sheet"></a>

La información sobre herramientas de Sheet transforma la forma en que los espectadores exploran los datos al proporcionar un contexto detallado sin interrumpir el flujo de análisis. En lugar de alejarse de una imagen o abrir hojas independientes, los usuarios tienen acceso instantáneo a desgloses detallados, tendencias e información complementaria, lo que hace que los paneles sean más intuitivos y reduce la necesidad de tener varias hojas.

La información sobre herramientas sobre las hojas solo está disponible en las hojas interactivas. No se admiten en los informes paginados. Puede duplicar una hoja de información sobre herramientas en otra hoja de información sobre herramientas o duplicar una hoja de información sobre herramientas en una hoja interactiva normal. Además, puede duplicar una imagen en una hoja de información sobre herramientas.

### Cómo funciona la información sobre herramientas de las hojas
<a name="customizing-visual-tooltips-sheet-how"></a>

Cuando un autor crea una descripción emergente de una hoja, se crea una hoja de información sobre herramientas y se asocia a un elemento visual. Esta hoja de información sobre herramientas funciona como una hoja normal. Puede añadirle elementos visuales, cuadros de texto e imágenes mediante un diseño de formato libre. Cuando un espectador pasa el ratón sobre un punto de datos, la hoja de información sobre herramientas hereda todos los filtros del elemento visual original y añade un filtro adicional para el punto de datos específico. Por ejemplo, si la imagen de origen se filtra para obtener «datos de 2025» y el espectador pasa el ratón por encima de «Electrónica», la información sobre herramientas mostrará únicamente los datos de electrónica de 2025.

Considera un gráfico de barras que muestre las ventas por categoría de producto. Puedes crear una hoja de información sobre herramientas que muestre una línea de tendencia de las ventas mensuales, un KPI de year-over-year crecimiento y un cuadro de texto con el nombre de la categoría, todos filtrados según la categoría por la que pase el cursor del ratón.

### Límites de la descripción emergente de la hoja
<a name="customizing-visual-tooltips-sheet-limits"></a>

Se aplican los siguientes límites a la información sobre herramientas de las hojas:
+ Hasta 50 hojas de información sobre herramientas por análisis
+ Hasta 5 imágenes por hoja de información sobre herramientas
+ Hasta 5 cuadros de texto por hoja de información sobre herramientas
+ Hasta 5 imágenes por hoja de información sobre herramientas
+ Las hojas de información sobre herramientas utilizan únicamente un diseño de formato libre
+ No se permiten imágenes de mapas de capas en las hojas de información sobre herramientas
+ El tamaño máximo de una hoja de información sobre herramientas es de 640 px de ancho por 720 px de alto

### Cómo crear una hoja de información sobre herramientas
<a name="customizing-visual-tooltips-sheet-create"></a>

Utilice el siguiente procedimiento para crear una descripción emergente de una hoja con fines visuales.

**Para crear una hoja de información sobre herramientas**

1. En la página de análisis, elija la imagen a la que desee añadir la información sobre herramientas de la hoja.

1. En el menú de la parte superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

1. En el panel de **propiedades** que se abre, elija **Interacciones > Información** sobre **herramientas**.

1. En **Tipo**, elija la información sobre **herramientas Hoja**.

1. Seleccione **Crear hoja de información sobre herramientas.** Accederá automáticamente a una experiencia de edición de hojas de información sobre herramientas. El nombre de la información sobre herramientas se genera automáticamente y puede editarlo eligiendo el título de la pestaña.

1. Añada elementos visuales, cuadros de texto o imágenes a la hoja de información sobre herramientas. Organícelos utilizando el diseño de forma libre.

1. **Cuando haya terminado, vuelva a la hoja de origen pulsando el botón Atrás situado a la izquierda del título de la información sobre herramientas de la hoja.** Para obtener una vista previa de la información sobre herramientas, coloque el puntero del ratón sobre cualquier punto de datos de la imagen.

### Asignación de una hoja de información sobre herramientas a una imagen
<a name="customizing-visual-tooltips-sheet-assign"></a>

Al seleccionar la información sobre **herramientas Hoja como** tipo de información sobre herramientas en el panel de **propiedades**, aparece un control que le permite seleccionar todas las hojas de información sobre herramientas disponibles en el análisis. Puede asignar una hoja de información sobre herramientas a varios elementos visuales o crear hojas de información sobre herramientas independientes para cada elemento visual.

****Si desea aplicar la misma hoja de información sobre herramientas a otro elemento visual, puede hacerlo asignando una hoja de información sobre herramientas a varios elementos visuales en el acordeón **Interacciones > Información sobre herramientas del panel Propiedades**.****

### Edición de una hoja de información sobre herramientas
<a name="customizing-visual-tooltips-sheet-edit"></a>

Utilice el siguiente procedimiento para editar la información sobre herramientas de una hoja existente.

**Para editar una hoja de información sobre herramientas**

1. Elija cualquier elemento visual en el que esté habilitada la información sobre herramientas de una hoja.

1. Abra el panel de **propiedades** y vaya a **Interacciones > Información** sobre **herramientas**.

1. En el acordeón de **información** sobre herramientas, seleccione la descripción emergente que desee editar y elija el icono de edición situado junto al nombre de la hoja de información sobre herramientas para acceder a ella.

1. Realice los cambios que desee en los elementos visuales, los cuadros de texto o las imágenes de la hoja de información sobre herramientas.

### Cambiar entre los tipos de información sobre herramientas
<a name="customizing-visual-tooltips-sheet-switch"></a>

Puede cambiar la descripción emergente de un elemento visual entre los tipos de información básica, detallada y de hoja en cualquier momento.

**Para cambiar el tipo de información sobre herramientas**

1. Elija el elemento visual que desee actualizar.

1. Abra el panel de **propiedades**, elija **Interacciones** y, a continuación, elija Información **sobre herramientas.**

1. **En **Tipo**, seleccione el tipo de información sobre herramientas que desee: información sobre **herramientas básica, información sobre herramientas** **detallada o información sobre hojas**.**

**nota**  
Si se deja de utilizar una hoja de información, se conserva el trabajo. Siempre puede volver a cambiar sin perder el diseño de la hoja de información sobre herramientas.

### Hoja: consideraciones sobre la información sobre herramientas
<a name="customizing-visual-tooltips-sheet-considerations"></a>

Tenga en cuenta lo siguiente al trabajar con información sobre herramientas de hojas:
+ Las tablas y tablas dinámicas admiten la información sobre herramientas de hojas, pero no la información sobre herramientas básica o detallada.
+ Los elementos visuales de una hoja de información sobre herramientas no admiten menús contextuales, menús visuales ni acciones personalizadas.
+ [Uso de acciones personalizadas para filtrar y navegar](quicksight-actions.md)Los elementos visuales de una hoja de información sobre herramientas no se admiten cuando la hoja se representa como información sobre herramientas.
+ La información sobre herramientas de las hojas admite filtros, filtros entre hojas y parámetros. No se admiten los controles de filtro.
+ Las descripciones de las hojas no se muestran en las hojas de información sobre herramientas.
+ Los filtros de hojas cruzadas no se pueden aplicar a las hojas de información sobre herramientas.
+ Un análisis debe contener al menos una hoja interactiva normal. Un análisis no puede consistir únicamente en hojas de información sobre herramientas.
+ Las imágenes del mapa de capas no se pueden colocar dentro de una hoja de información sobre herramientas.
+ No se admite la información sobre herramientas en las hojas de información sobre herramientas.

Estos límites garantizan que las hojas de información sobre herramientas se carguen rápidamente y que los espectadores disfruten de una experiencia centrada y fácil de escanear. Para realizar análisis más complejos, considere la posibilidad de utilizar acciones de desglose u hojas de detalles independientes.

## Ocultación de la información sobre herramientas en un elemento visual
<a name="customizing-visual-tooltips-hide"></a>

Si no desea que la información sobre herramientas aparezca al pasar el cursor sobre los datos de una imagen, puede ocultarla. 

**Ocultación de la información sobre herramientas en un elemento visual**

1. En la página de análisis, elija el elemento visual al que desee cambiar el formato.

1. En el menú de la parte superior derecha del elemento visual, seleccione el icono **Formato del elemento visual**.

1. En el panel **Propiedades** que se abrirá, elija **Información sobre herramientas**.

1. Elija **Mostrar información sobre herramientas**.

   Al desactivar la opción, se oculta la información sobre herramientas del elemento visual. Al seleccionar la opción, se muestra.

# Personalización de la presentación de datos
<a name="analyzing-data-analyses"></a>

Para obtener más información sobre sus datos al crear imágenes (gráficos) en un análisis rápido, puede ordenar y filtrar los datos en una imagen. También puede cambiar el grado de detalle de los campos de fecha, tipo de datos, rol y formato de los campos en un visual.

**Topics**
+ [Cambiar los campos utilizados por un elemento visual en Amazon Quick](changing-visual-fields.md)
+ [Clasificación de datos visuales en Amazon Quick](sorting-visual-data.md)

# Cambiar los campos utilizados por un elemento visual en Amazon Quick
<a name="changing-visual-fields"></a>

Puede añadir o modificar los campos para un elemento visual mediante el panel **Lista de campos**, los cuadros de campo, los editores visuales o los destinos de colocación en el elemento visual. 

Los cuadros de campo, los editores visuales y los destinos de colocación disponibles para un elemento visual específico dependen del tipo de elemento visual seleccionado. Para más detalles, consulte el tema del tipo de elemento visual correspondiente en la sección [Tipos visuales en Amazon Quick Sight](working-with-visual-types.md).

**importante**  
También puede cambiar el tipo de datos y el formato de los campos numéricos mediante la utilización de cuadros de campo y editores visuales. Si cambia un campo de esa manera, solo cambiará para el objeto visual seleccionado. Para obtener más información sobre cómo cambiar los formatos y los tipos de datos del campo numérico, consulte [Cambiar los campos utilizados por un elemento visual en Amazon Quick](#changing-visual-fields).

Utilice los siguientes temas para obtener más información sobre cómo añadir, eliminar y modificar campos de un elemento visual.

**Topics**
+ [Uso de los controles de campo del elemento visual](using-visual-field-controls.md)
+ [Adición o eliminación de un campo](adding-or-removing-a-field.md)
+ [Cambiar el campo asociado a un elemento visual](changing-a-field-association.md)
+ [Cambio de la agregación de campo](changing-field-aggregation.md)
+ [Modificación del grado de detalle de los campos de fecha](changing-date-field-granularity.md)
+ [Personalización del formato de un campo](customizing-field-format.md)

# Uso de los controles de campo del elemento visual
<a name="using-visual-field-controls"></a>

Puede editar los campos que usa un elemento visual mediante los controles de la interfaz de usuario (IU).

También puede utilizar estos controles del modo siguiente:
+ Cree un elemento visual y asigne campos a diferentes elementos. Para ello, seleccione los campos en el panel **Lista de campos** o arrastre los campos a los cuadros de campo o a los destinos de colocación.
+ Cambie el campo asociado a un elemento visual al arrastrar el campo a un cuadro de campo o a un destino de colocación, o bien al seleccionar un campo diferente en un cuadro de campo o en un editor visual.
+ Cambie la agregación del campo o el grado de detalle de la fecha mediante los cuadros de campo o los editores visuales.

Los cuadros de campo, los editores visuales y los destinos de colocación disponibles en un elemento visual específico dependen del tipo de elemento visual seleccionado. 

## Arrastrar campos a los destinos de colocación o cuadros de campo
<a name="dragging-a-field"></a>

Cuando arrastras un campo a un objetivo desplegable o a un pozo de campo, Amazon Quick te proporciona información sobre si el elemento objetivo espera una medida o una dimensión. Amazon Quick también le proporciona información sobre si ese elemento está disponible para la asignación de campos.

Por ejemplo, al arrastrar una medida al valor de destino de colocación en un gráfico de línea de medición de un solo gráfico, verá el objetivo de colocación de color verde. Esta codificación de color verde indica que el destino de colocación espera una medida. La etiqueta de arrastre indica que el destino está disponible para añadir un campo. 

Al arrastrar una dimensión al eje x o destino de colocación de color en un nuevo gráfico de líneas, verá una etiqueta de color azul. Esta codificación de color azul indica que el destino de colocación espera una dimensión. La etiqueta de arrastre indica que el destino está disponible para añadir un campo. 

También puede arrastrar una medida o una dimensión a un destino de colocación en un gráfico de líneas en el que el elemento ya está asociado a un campo. En este caso, la etiqueta indica que está reemplazando el campo actualmente asociado por el destino de colocación. 

# Adición o eliminación de un campo
<a name="adding-or-removing-a-field"></a>

Puede añadir un campo a un elemento visual eligiéndolo en el panel **Lista de campos**. También puede arrastrarlo a un destino de colocación en el elemento visual o a un cuadro de campo. Existe una correspondencia 1:1 entre los destinos de colocación y los cuadros de campo para cada tipo de elemento visual, por lo que puede utilizar cualquiera de los dos métodos.

En algunos gráficos, el campo **Título de eje** se oculta cuando hay dos o más campos en el campo **Valor** en cualquier lado del gráfico. Este efecto puede producirse con los siguientes gráficos:
+ Gráficos de barras
+ Gráficos de líneas
+ Gráficos de cajas
+ Gráficos combinados
+ Gráficos de cascadas

Para eliminar un campo de un visual, borre la selección del mismo en el panel **Lista de campos**. O seleccione un editor visual o un cuadro de campo que utilice ese campo y, a continuación, elija **Eliminar** en el menú contextual (botón derecho del ratón).

## Adición de un campo seleccionándolo en el panel de la lista de campos
<a name="add-a-field-data-set"></a>

También puedes dejar que Amazon Quick asigne el campo al elemento visual más adecuado. Para ello, seleccione el campo en el panel **Lista de campos**. Amazon Quick añade el campo a la imagen rellenando el primer pozo de campo vacío que corresponde a ese tipo de campo (medida o dimensión). Si todos los elementos visuales ya están rellenados, Amazon Quick determina bien el campo más adecuado y sustituye el campo que contiene por el campo que ha seleccionado.

## Adición de un campo mediante un destino de colocación
<a name="add-a-field-drop-target"></a>

Para añadir un campo a un elemento visual usando un destino de colocación, elija un campo en el panel **Lista de campos**. A continuación, arrastre el campo hasta el destino elegido en el elemento visual y asegúrese de que el indicador de colocación muestra que el campo se va a agregar.

## Adición de un campo mediante un cuadro de campo
<a name="add-a-field-field-well"></a>

Para añadir un campo a un elemento visual usando un cuadro de campo, elija un campo en el panel **Lista de campos**. A continuación, arrástrelo al campo de destino y asegúrese de que el indicador de colocación muestra que el campo se está añadiendo.

1. Arrastre un elemento de campo a un **Cuadro de campo**.

1. Arrastre el campo que desea añadir desde el panel **Lista de campos** al cuadro de campo apropiado.

**nota**  
Puede añadir el mismo valor al mismo elemento visual varias veces. Puede hacerlo para mostrar el mismo valor con distintos cálculos de tabla o agregaciones aplicados. De forma predeterminada, todos los campos muestran la misma etiqueta. Puede editar los nombres mediante el panel **Propiedades**, que podrá abrir si selecciona el icono con forma de **V** en la parte superior derecha.

# Cambiar el campo asociado a un elemento visual
<a name="changing-a-field-association"></a>

Puede cambiar el campo asignado a un elemento de un elemento visual mediante los cuadros de campo, los destinos de colocación o los editores visuales en el elemento visual. En el caso de las tablas dinámicas, utilice cuadros de campo o destino de colocación porque este tipo de elemento visual no proporciona editores visuales.

## Cambio de una asignación de campo mediante un editor visual
<a name="change-field-mappings-element-controls"></a>

Utilice el siguiente procedimiento para modificar el mapeo de un campo a un elemento visual.

**Modificación de la asignación de un campo mediante un editor visual**

1. En el elemento visual, elija el editor visual del elemento visual cuyo campo desea cambiar.

1. En el menú del editor visual, elija el campo que desea asociar a ese elemento visual.

## Cambio de la asignación de un campo mediante un destino de colocación
<a name="change-field-mappings-drop-target"></a>

Para modificar el mapeo de un campo a un elemento visual usando un destino de colocación, elija un campo en el panel **Lista de campos**. A continuación, arrástrelo al campo de destino en el elemento visual y asegúrese de que el indicador de colocación muestra que el campo se está reemplazando.

## Cambio de una asignación de campo mediante un cuadro de campo
<a name="change-field-mappings-field-wells"></a>

Utilice el siguiente procedimiento para modificar el mapeo de un campo a un elemento visual.

**Modificación de la asignación de un campo mediante un cuadro de campo**

1. Arrastre un elemento de campo a un **Cuadro de campo**.

1. Seleccione el cuadro de campo que representa el elemento que quiere reasignar y, a continuación, selecciona un nuevo campo en el menú que aparece.

# Cambio de la agregación de campo
<a name="changing-field-aggregation"></a>

Puede aplicar funciones a los campos para mostrar la información agregada, como la suma de las ventas para un producto concreto. Puede aplicar una función de agregación mediante la utilización de las opciones de un editor visual o un cuadro de campo. Las siguientes funciones agregadas están disponibles en Amazon Quick:
+ Promedio: calcula el valor promedio del campo seleccionado.
+ Recuento: proporciona un recuento del número de registros que contienen la medida seleccionada para una dimensión determinada. Un ejemplo es un recuento del ID de pedido por Estado. 
+ Recuento distinto: ofrece un recuento de todos los valores diferentes que hay en la medida seleccionada para la dimensión o dimensiones seleccionadas. Un ejemplo es un recuento de Producto por Región. Un recuento sencillo puede mostrar cuántos productos se venden para cada región. Un recuento distintivo puede mostrar cuántos productos diferentes se venden para cada región. Puede que haya vendido 2000 artículos, pero solo dos tipos diferentes de artículos. 
+ Máx: calcula el valor máximo del campo seleccionado.
+ Mín: calcula el valor mínimo del campo seleccionado.
+ Mediana: calcula el valor medio de la medida especificada, agrupado por la dimensión o dimensiones elegidas.
+ Suma: suma todos los valores del campo seleccionado.
+ Desviación estándar: calcula la desviación estándar del conjunto de números de la medida especificada, agrupados por la dimensión o dimensiones elegidas, basándose en una muestra o en una población sesgada. 
+ Varianza: calcula la varianza del conjunto de números de la medida especificada, agrupados por la dimensión o dimensiones elegidas, basándose en una muestra o en una población sesgada. 
+ Percentil : calcula el percentil *n* de la medida especificada, agrupado por la dimensión o dimensiones elegidas. 

Todas las funciones de agregación pueden aplicarse a los campos numéricos. *Count* se aplica automáticamente a una dimensión si decide utilizarla en un cuadro de campo que espera una medida. Si ha usado una dimensión de ese modo, también puede cambiar la función de agregación que se le ha aplicado. No puede aplicar funciones de agregación a los campos en los cuadros de campo de dimensión.

Los elementos visuales que admiten los campos agregados varían en función del tipo de elemento visual.

## Cambiar o agregar la agregación de un campo mediante un editor visual
<a name="change-field-aggregation-element-controls"></a>

Utilice el siguiente procedimiento para cambiar o añadir la agregación a un campo.

**Cambio o adición de una agregación a un campo**

1. En el elemento visual, elija el editor visual del campo al que desea aplicar la agregación.

1. En el menú del editor visual, seleccione **Agregar** y, a continuación, elija la función de agregación que desea aplicar.

## Cambio o adición de la agregación a un campo mediante un cuadro de campo
<a name="change-field-aggregation-field-wells"></a>

Utilice el siguiente procedimiento para añadir la agregación a un campo de una tabla dinámica visual.

**Adición de una agregación a un campo de una tabla dinámica visual**

1. Arrastre un elemento de campo a un **Cuadro de campo**.

1. Elija el cuadro de campo que contiene el campo al que desea aplicar una función de agregación.

1. En el menú del cuadro de campo, seleccione **Agregar** y, a continuación, elija la función de agregación que desea aplicar.

# Modificación del grado de detalle de los campos de fecha
<a name="changing-date-field-granularity"></a>

Puede cambiar el grado de detalle de un campo de fecha de un elemento visual para determinar qué intervalos de los valores del elemento se muestran. Puede establecer el grado de detalle del campo de fecha a uno de los siguientes valores:
+ Año
+ Trimestre
+ Mes
+ Semana
+ Día (predeterminado)
+ Hora
+ Minuto
+ Segundo

Hora y minuto solo están disponibles si el campo contiene los datos de hora.

## Cambio del grado de detalle del campo de fecha mediante un editor visual
<a name="change-date-granularity-element-controls"></a>

Utilice el siguiente procedimiento para cambiar el grado de detalle del campo de fecha mediante un editor visual.

**Cambio del grado de detalle de los campos de fecha con un editor visual**

1. En el elemento visual, elija el cuadro de campo del campo de fecha cuyo grado de detalle desea cambiar.

1. En el menú del cuadro de campo, seleccione **Agregar** y, a continuación, elija el intervalo de tiempo que desea aplicar, tal como se muestra a continuación:

## Cambio del grado de detalle del campo de fecha mediante un cuadro de campo
<a name="change-date-granularity-field-wells"></a>

Utilice el siguiente procedimiento para cambiar el grado de detalle del campo de fecha mediante un cuadro de campo.

**Cambio del grado de detalle de un campo de fecha con un cuadro de campo**

1. Arrastre un elemento de campo a un **Cuadro de campo**.

1. Elija el cuadro de campo que contenga el campo de fecha y, a continuación, seleccione **Agregar**. Elija el grado de detalle de fecha que desea utilizar.

# Personalización del formato de un campo
<a name="customizing-field-format"></a>

Utilice el siguiente procedimiento para personalizar el aspecto de los campos de un análisis. 

**Personalización de la apariencia de los campos de un análisis**

1. En un análisis, elija el campo cuyo formato desea modificar. Puede elegirlo en el cuadro de campo o en la **lista de campos** del panel **Visualizar**.

1. Elija **Mostrar como** para cambiar la forma en que se muestra el campo en el análisis y seleccione una de las opciones del menú contextual. La lista de opciones disponibles varía en función del tipo de datos del campo. Si elige un campo no numérico en la lista de campos, puede cambiar el *formato de recuento*, que es el formato que se utiliza cuando se cuenta el campo.

1. Elija **Formato** para cambiar el formato del campo y seleccione entre las opciones del menú contextual. Si no ve la opción que desea utilizar, elija **Más opciones de formato** en el menú contextual.

   Se abre el panel **Formato de datos**, que muestra opciones para el tipo de campo numérico o de fecha que haya elegido.

   Las opciones del menú contextual **Mostrar como** ahora aparecen en la lista desplegable de la parte superior del panel **Formato de datos**. El resto de las opciones son específicas para el tipo de datos y la forma en que elija mostrar el campo. 

Para los datos de fecha y hora, el patrón de formato predeterminado es YYYY-MM-DD **`T`**HH:mm:sszz, por ejemplo 2016-09-22T 17:00:00-07:00.

Para los números, puede mostrar cualquiera de las siguientes unidades después del número:
+ Sin sufijo de unidad. Es el predeterminado.
+ Miles (K)
+ Millones (M)
+ Miles de millones (B)
+ Billones (T)
+ Un prefijo o sufijo personalizado para una unidad

Para la divisa, puede elegir entre los siguientes símbolos:
+ Dólares (\$1)
+ Euros (€)
+ Libras (£)
+ Yenes (¥)

# Cambio del formato de un campo
<a name="changing-a-field-format"></a>

Puede cambiar el formato de un campo en el contexto de un análisis. Las opciones de formato disponibles para los campos varían en función del tipo de datos del campo.

Puede utilizar las opciones de menú del panel **Lista de campos** o los cuadros de campo de los elementos visuales para realizar cambios de formato sencillos. También puede realizar cambios de formato más profundos a través del panel **Formato de datos**.

**Topics**
+ [Aplicación de formato a un campo de divisa](format-a-currency-field.md)
+ [Dar formato a un campo de fecha](format-a-date-field.md)
+ [Aplicación de formato a un campo numérico](format-a-number-field.md)
+ [Aplicación de formato a un campo de porcentaje](format-a-percent-field.md)
+ [Aplicación de formato a un campo de texto](format-a-text-field.md)
+ [Restablecer el formato de un campo a la configuración predeterminada](set-field-format-to-default.md)

# Aplicación de formato a un campo de divisa
<a name="format-a-currency-field"></a>

Para dar formato a un campo de divisa, puede elegir el símbolo de la divisa en la lista de opciones comunes o puede abrir el panel **Formato de datos** y dar formato al campo manualmente. Dar formato al campo manualmente permite elegir qué símbolos utilizar, qué separadores utilizar, cuántos decimales mostrar, qué unidades utilizar y cómo mostrar los números negativos.

Al cambiar el formato de un campo, se modifica en todos los elementos visuales del análisis, pero no en el conjunto de datos subyacente. 

Si desea elegir el símbolo de un campo de divisa de una lista de opciones comunes, puede obtener acceso a dicha lista de varias formas. Puede obtener acceso a él desde el panel **Field list (Lista de campos)**, un editor visual o un cuadro de campo de elementos visuales.

**Selección del símbolo de un campo de divisa mediante una opción de la lista**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo de divisa al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar. 

1. Elija **Formato** y, a continuación, elija el campo de divisa que desee:
   + Mostrar en dólares (\$1).
   + Mostrar en libras (£).
   + Mostrar en euros (€).
   + Mostrar en yenes o yuanes (¥).

**Cambio manual del formato de un campo de divisa**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo numérico al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Elija **Formato** y, a continuación, seleccione **Más opciones de formato**. 

   Se abre el panel **Formato de datos**. 

1. Amplíe la sección **Symbol** y seleccione una de las siguientes opciones:
   + Mostrar en dólares (\$1). Es el valor por defecto.
   + Mostrar en libras (£).
   + Mostrar en euros (€).
   + Mostrar en yenes o yuanes (¥).

1. Amplíe la sección **Separadores** y seleccione una de las siguientes opciones:
   + En **Decimal**, seleccione el punto o la coma como separador decimal. El valor predeterminado es el punto. Si elige una coma en su lugar, utilice un punto o un espacio como separador de miles. 
   + En **Miles**, seleccione o desactive **Habilitado** para indicar si desea o no utilizar un separador de millares. De forma predeterminada, la opción **Habilitado** está seleccionada.
   + Si utiliza un separador de millares, elija si desea utilizar una coma, un punto o un espacio como separador. El valor predeterminado es la coma. Si elige el punto, utilice una coma o un espacio como separador decimal.

1. Amplíe la sección **Decimal Places** y elija el número de decimales que desea utilizar. El valor predeterminado es 2. Los valores de campo se redondean a los decimales especificados. Por ejemplo, si especifica dos decimales, el valor 6,728 se redondea a 6,73.

1. Amplíe la sección **Unidades** y seleccione una de las siguientes opciones:
   + Elija la unidad que desea utilizar. Al seleccionar una unidad se añade el sufijo adecuado al valor numérico. Por ejemplo, si elige **Miles**, el valor de campo 1234 se muestra como 1,234K.

     Las opciones de unidad son las siguientes:
     + Sin sufijo de unidad. Es el valor predeterminado.
     + Miles (K)
     + Millones (M)
     + Miles de millones (B)
     + Billones (T)
   + Si desea utilizar un prefijo o sufijo personalizado, especifíquelo en el cuadro **Prefijo** o **Sufijo**. El uso de un sufijo personalizado es una buena forma de especificar un sufijo de moneda distinto de los que ya ofrece Amazon Quick. Puede especificar ambas cosas. También puede especificar un prefijo personalizado además del sufijo que se añade al seleccionar una unidad.

1. Amplíe la sección **Negativos** y elija si desea mostrar un valor negativo usando el signo menos o incluyendo el valor entre paréntesis. El signo menos es la opción predeterminada.

1. Expanda la sección **Valores nulos** y elija si desea mostrar los valores nulos como `null` o como un valor personalizado. El valor predeterminado es `null`.
**nota**  
Cuando se utiliza una tabla o una tabla dinámica, los valores nulos solo se muestran para los campos que se colocan en los cuadros de campo **Filas**, **Columnas** o **Agrupar por**. Los valores nulos de los campos del campo **Valores** aparecen vacíos en la tabla o tabla dinámica.

# Dar formato a un campo de fecha
<a name="format-a-date-field"></a>

Para dar formato a un campo de fecha, puede elegir en una lista de opciones de formato comunes. También puede abrir el panel **Formato de datos**, elegir en una lista de formatos comunes o especificar un formato personalizado para los valores de fecha y hora.

Cambiar el formato de un campo lo cambia para todos los elementos visuales del análisis que utilizan ese conjunto de datos, pero no lo cambia en el propio conjunto de datos.

Si desea dar formato a un campo de fecha eligiéndolo en una lista de opciones comunes, puede obtener acceso a dicha lista de varias formas. Puede obtener acceso al mismo desde el panel **Lista de campos**, un editor visual o un cuadro de campo visual.

**Cambiar el formato de un campo de fecha mediante una opción de la lista**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo numérico al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Elija **Formato** y seleccione el formato que desea utilizar. Se ofrecen las siguientes opciones de formato rápido para los campos de fecha:
   + Mostrar el mes, día, año y hora
   + Mostrar el mes, día y año
   + Mostrar el mes y año
   + Mostrar el año

**Cambio manual del formato de un campo de fecha**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo numérico al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Elija **Formato** y, a continuación, seleccione **Más opciones de formato**. 

   Se abre el panel **Formato de datos**. 

1. Amplíe la sección **Date**. Elija un formato de fecha existente o seleccione **Personalizar** y especifique un patrón de formato en la sección **Personalizar** que aparece más abajo en el panel **Formato de fecha**. Si selecciona **Personalizar** en la sección **Fecha**, también debe seleccionar **Personalizar** en la siguiente sección **Hora**. El patrón que especifique en la sección **Personalizar** debe incluir el formato de fecha y hora que quiera.

   La selección predeterminada es **Personalizada**, con un patrón de formato predeterminado de MMM D, AAAA h:mma, por ejemplo, sep 20, 2022 17:30.

1. Amplíe la sección **Time**. Elija un formato de hora existente o seleccione **Personalizar** y especifique un patrón de formato en la sección **Personalizar** que aparece más abajo en el panel **Formato de fecha**. Si selecciona **Personalizado** en la sección **Hora**, también debe seleccionar **Personalizado** en la sección **Fecha** anterior. El patrón que especifique en la sección **Personalizar** debe incluir el formato de fecha y hora que quiera.

   La selección predeterminada es **Personalizada**, con un patrón de formato predeterminado de MMM D, AAAA h:mma, por ejemplo, sep 20, 2022 17:30.

1. Si eligió **Personalizado** en las secciones de **fecha** y **hora**, amplíe la sección **Personalizado** y especifique el patrón de formato que desee, utilizando la sintaxis del patrón de formato especificada en [Formato de visualización de Moment.js](https://momentjs.com/docs/#/displaying/) en la JavaScript documentación de Moment.js.
**nota**  
Quick admite el token `Z` de visualización relacionado con la zona horaria de la biblioteca Moment.js, pero no el `z` token.

   Si ha elegido una opción distinta a **Custom** en las secciones **Date** y **Time**, **Custom** se cumplimenta con el patrón de formato que refleje las selecciones que ha realizado. Por ejemplo, si eligió junio 21 de 2016 en la sección **Fecha** y 17:00:00pm en la sección **Hora**, la sección **Personalizada** muestra el patrón de formato MMM D, AAAA H:mm:ssa.

1. (Opcional) Amplíe la sección **Personalizado** y, a través de la opción **Vista previa**, verifique el formato especificado.

1. Expanda la sección **Valores nulos** y elija si desea mostrar los valores nulos como `null` o como un valor personalizado. El valor predeterminado es `null`.

# Personalización de los formatos de fecha en Quick
<a name="format-visual-date-controls"></a>

En Quick, puede personalizar el formato de las fechas en los controles de filtros y parámetros. Por ejemplo, puede especificar el formato de la fecha en un control como 20-09-2021 o, si lo prefiere, como 09-20-2021. También puede especificar acortar el mes en sus fechas (como septiembre) a tres letras (Sep), entre otras personalizaciones.

A continuación encontrará una lista de tokens que puede utilizar para crear formatos de fecha personalizados. Puede utilizarlos en combinación con otros para controlar cómo aparecen las fechas en sus controles.

## Lista de tokens admitidos para dar formato a las fechas
<a name="format-date-supported-tokens"></a>

Utilice los siguientes símbolos para personalizar el formato de las fechas en Quick.


| Ejemplo | Description (Descripción) | Token | 
| --- | --- | --- | 
|  De 0 a 6  |  Representación numérica de un día concreto de la semana. 0 es domingo y 6 es sábado.  |  `d`  | 
|  De lu a do  |  Representación textual de 2 caracteres de un día concreto de la semana.  |  `dd`  | 
|  De lun a dom  |  Representación textual de 3 caracteres de un día concreto de la semana.  |  `ddd`  | 
|  De lunes a domingo  |  Representación textual de un día concreto de la semana.  |  `dddd`  | 
|  99 o 21  |  Representación de 2 dígitos de un año.  |  `YY`  | 
|  1999 o 2021  |  Representación numérica completa de 4 dígitos de un año.  |  `YYYY`  | 
|  De 1 a 12  |  Número de un mes, sin ceros a la izquierda.  |  `M`  | 
|  Del primero, segundo al duodécimo  |  Número de un mes sin ceros a la izquierda y con un sufijo ordinal.  |  `Mo`  | 
|  De 01 a 12  |  Número de un mes, con ceros a la izquierda.  |  `MM`  | 
|  De ene a dic  |  Representación textual de 3 dígitos de un mes.  |  `MMM`  | 
|  De enero a diciembre  |  Representación textual completa de un mes.  |  `MMMM`  | 
|  1–4  |  Representación numérica de un trimestre.  |  `Q`  | 
|  De 1.º a 4.º  |  Representación numérica de un trimestre con un sufijo ordinal.  |  `Qo`  | 
|  1–31  |  Día del mes sin ceros a la izquierda.  |  `D`  | 
|  De 1.º, 2.º a 31.º  |  Día del mes sin ceros a la izquierda y sufijo ordinal.  |  `Do`  | 
|  De 01 a 31  |  Día del mes de 2 dígitos con ceros a la izquierda.  |  `DD`  | 
|  De 1 a 365  |  Día del año sin ceros a la izquierda.  |  `DDD`  | 
|  De 001 a 365  |  Día del año con ceros a la izquierda.  |  `DDDD`  | 
|  De 1 a 53  |  Día de la semana sin ceros a la izquierda.  |  `w`  | 
|  De 1.º a 53.º  |  Semana del año sin ceros a la izquierda y con sufijo ordinal.  |  `wo`  | 
|  De 01 a 53  |  Día de la semana con ceros a la izquierda.  |  `ww`  | 
|  De 1 a 23  |  Horas, en formato de 24 horas, sin ceros a la izquierda.  |  `H`  | 
|  De 01 a 23  |  Horas, en formato de 24 horas, con ceros a la izquierda.  |  `HH`  | 
|  De 1 a 12  |  Horas, en formato de 12 horas, sin ceros a la izquierda.  |  `h`  | 
|  De 01 a 12  |  Horas, en formato de 12 horas, con ceros a la izquierda.  |  `hh`  | 
|  De 0 a 59  |  Minutos sin ceros a la izquierda.  |  `m`  | 
|  De 00 a 59  |  Minutos con ceros a la izquierda.  |  `mm`  | 
|  De 0 a 59  |  Segundos sin ceros a la izquierda.  |  `s`  | 
|  De 00 a 59  |  Segundos con ceros a la izquierda.  |  `ss`  | 
|  am o pm  |  am/pm  |  `a`  | 
|  AM o PM  |  AM/PM  |  `A`  | 
|  1632184215  |  Una marca temporal Unix.  |  `X`  | 
|  1632184215000  |  Marca de tiempo Unix en milisegundos.  |  `x`  | 
|  Z  |  Diferencia cero con respecto a UTC.  |  `Z`  | 

No se admiten los siguientes tipos de fecha.
+ Zonas horarias desplazadas con dos puntos. Por ejemplo, \$107:00.
+ Zonas horarias desplazadas sin dos puntos. Por ejemplo, \$10730.

### Formatos de fecha predefinidos
<a name="visuals-preset-date-formats"></a>

Para personalizar rápidamente las fechas y horas para que aparezcan en uno de los siguientes formatos de ejemplo, puede utilizar los siguientes símbolos de preajuste rápido.


| Ejemplo | Token | 
| --- | --- | 
|  8:30 PM  |  `LT`  | 
|  8:30:25 PM  |  `LTS`  | 
|  2 agosto 1985  |  `LL`  | 
|  2 ago 1985  |  `ll`  | 
|  2 agosto 1985 08:30 PM  |  `LLL`  | 
|  2 ago 1985 08:30 PM  |  `lll`  | 
|  Jueves, 2 agosto 1985 08:30 PM  |  `LLLL`  | 
|  Jue, 2 ago 1985 08:30 PM  |  `llll`  | 

## Formatos de fecha comunes
<a name="visuals-common-date-formats"></a>

A continuación se presentan tres ejemplos de fechas comunes y sus formatos de token asociados para su rápida referencia.


| Ejemplo | Formato de token | 
| --- | --- | 
|  20 de sep 2021  |  `MMM DD, YYYY`  | 
|  20-09-21 5pm  |  `DD-MM-YY ha`  | 
|  Lunes, 20 de septiembre de 2021 17:30:15  |  `dddd, MMMM DD, YYYY HH:mm:ss`  | 

## Adición de palabras a las fechas
<a name="visuals-adding-words-to-dates"></a>

Para incluir palabras en sus formatos de fecha, como la palabra “de” en *20 de sep. de 2021*, introduzca barras invertidas (\$1) antes de cada carácter de la palabra. Por ejemplo, para el ejemplo de fecha del 20 de septiembre de 2021, utilice el siguiente formato de token: `Do \o\f MMM, YYYY`.

## Ejemplo: personalización del formato de fecha en un control de filtro
<a name="format-visual-date-controls-example"></a>

Siga este procedimiento para obtener información sobre cómo utilizar los formatos de token de fecha para personalizar las fechas de un control de filtro.

**Información sobre cómo personalizar fechas para un control de filtro con tokens de datos**

1. En un análisis rápido, elija el control de filtro que desee personalizar.

1. En el control de filtro, seleccione el icono **Editar control**.

1. En la página **Editar control** que se abre, en **Formato de fecha**, introduzca el formato de fecha personalizado que quiera. Utilice los tokens listados anteriormente en este tema.

   Por ejemplo, digamos que quiere personalizar sus fechas con el siguiente formato: *3 septiembre 2020 a las 5pm*. Para ello, puede introducir el siguiente formato de token:

   `MMM Do, YYYY \a\t ha`

   Aparecerá una vista previa del formato de fecha debajo del campo de entrada a medida que introduzca cada token.

1. Seleccione **Aplicar**.

   Las fechas del control se actualizan con el formato especificado.

# Aplicación de formato a un campo numérico
<a name="format-a-number-field"></a>

Al formatear un campo numérico, puede elegir el formato del separador decimal y de miles de una lista de opciones comunes. También puede abrir el panel **Formato de datos** y dar formato al campo manualmente. Dar formato al campo manualmente le permite elegir los separadores que utilizar y el número de decimales que mostrar. También le permite elegir las unidades que utilizar y cómo mostrar números negativos.

Al cambiar el formato de un campo, se modifica en todos los elementos visuales del análisis, pero no en el conjunto de datos subyacente.

Si desea dar formato a un campo numérico realizando una selección en una lista de opciones comunes, puede acceder a dicha lista desde el panel **Lista de campos**, un editor visual o un cuadro de campo de elementos visuales.

**Para cambiar el formato de un campo numérico seleccionando una opción de la lista:**
+ Elija una de las siguientes opciones:
  + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
  + En cualquier elemento visual que contenga un editor visual asociado con el campo numérico al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.
+ Elija **Formato** y seleccione el formato que desea utilizar. A continuación se ofrecen las opciones de formato rápido para los campos numéricos:
  + Separe los grupos de miles con un punto y utilice la coma decimal para mostrar la parte fraccional del número, por ejemplo, 1.234,56.
  + Utilice la coma decimal para mostrar la parte fraccional del número, por ejemplo, 1234,56.
  + Muestre el número como un entero y separe los grupos de miles con un punto, por ejemplo, 1.234.
  + Muestre el número como un entero, por ejemplo, 1234.

**Para cambiar manualmente el formato de un campo numérico:**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo numérico al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Elija **Formato** y, a continuación, seleccione **Más opciones de formato**. 

   Se abre el panel **Formato de datos**. 

1. Amplíe la sección **Separadores** y seleccione una de las siguientes opciones:
   + En **Decimal**, seleccione el punto o la coma como separador decimal. El valor predeterminado es el punto. Si elige una coma en su lugar, utilice un punto o un espacio como separador de miles. 
   + En **Miles**, seleccione o desactive **Habilitado** para indicar si desea o no utilizar un separador de millares. De forma predeterminada, la opción **Habilitado** está seleccionada.
   + Si utiliza un separador de millares, elija si desea utilizar una coma, un punto o un espacio como separador. El valor predeterminado es la coma. Si elige el punto, utilice una coma o un espacio como separador decimal.

1. Amplíe la sección **Decimal Places** y seleccione una de las siguientes opciones:
   + Elija **Automático** para que Amazon Quick determine automáticamente el número apropiado de decimales, o elija **Personalizado** para especificar un número de decimales. **Auto** es el valor predeterminado. 
   + Si ha elegido **Custom**, escriba el número de decimales que desea utilizar. Los valores de campo se redondean a los decimales especificados. Por ejemplo, si especifica dos decimales, el valor 6,728 se redondea a 6,73.

1. Amplíe la sección **Unidades** y seleccione una de las siguientes opciones:
   + Elija la unidad que desea utilizar. Al seleccionar una unidad se añade el sufijo adecuado al valor numérico. Por ejemplo, si elige **Miles**, el valor de campo 1234 se muestra como 1,234K.

     Las opciones de unidad son las siguientes:
     + Sin sufijo de unidad. Es el valor predeterminado.
     + Miles (K)
     + Millones (M)
     + Miles de millones (B)
     + Billones (T)
   + Si desea utilizar un prefijo o sufijo personalizado, especifíquelo en el cuadro **Prefijo** o **Sufijo**. Puede especificar ambas cosas. También puede especificar un prefijo personalizado además del sufijo que se añade al seleccionar una unidad.

1. Amplíe la sección **Negativos** y elija si desea mostrar un valor negativo usando el signo menos o incluyendo el valor entre paréntesis. El signo menos es la opción predeterminada.

1. Expanda la sección **Valores nulos** y elija si desea mostrar los valores nulos como `null` o como un valor personalizado. El valor predeterminado es `null`.
**nota**  
Cuando se utiliza una tabla o una tabla dinámica, los valores nulos solo se muestran para los campos que se colocan en los cuadros de campo **Filas**, **Columnas** o **Agrupar por**. Los valores nulos de los campos del campo **Valores** aparecen vacíos en la tabla o tabla dinámica.

# Aplicación de formato a un campo de porcentaje
<a name="format-a-percent-field"></a>

Al dar formato a un campo de porcentaje, puede elegir el número de decimales de una lista de opciones comunes. También puede abrir el panel **Formato de datos** y dar formato al campo manualmente. Dar formato al campo manualmente le permite elegir los separadores que utilizar. También le permite elegir el número de decimales que mostrar y cómo mostrar los números negativos.

Al cambiar el formato de un campo, se modifica en todos los elementos visuales del análisis, pero no en el conjunto de datos subyacente. 

Si desea elegir el número de decimales para un campo de porcentaje de una lista de opciones comunes, puede obtener acceso a dicha lista de varias formas. Puede obtener acceso a él desde el panel **Field list (Lista de campos)**, un editor visual o un cuadro de campo de elementos visuales.

**Cambio del número de decimales de un campo de porcentaje mediante una opción de la lista**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo de porcentaje al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Seleccione **Formato** y, a continuación, el número de decimales que quiera. Se ofrecen las siguientes opciones de formato rápido para los campos de porcentaje:
   + Mostrar el valor con dos decimales
   + Mostrar el valor con un decimal
   + Mostrar el valor sin decimales

**Cambio manual del formato de un campo porcentual**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo numérico al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Elija **Formato** y, a continuación, seleccione **Más opciones de formato**. 

   Se abre el panel **Formato de datos**. 

1. Amplíe la sección **Separadores** y seleccione una de las siguientes opciones:
   + En **Decimal**, seleccione el punto o la coma como separador decimal. El valor predeterminado es el punto. Si elige una coma en su lugar, utilice un punto o un espacio como separador de miles.
   + En **Miles**, seleccione o desactive **Habilitado** para indicar si desea o no utilizar un separador de millares. De forma predeterminada, la opción **Habilitado** está seleccionada.
   + Si utiliza un separador de millares, elija si desea utilizar una coma, un punto o un espacio como separador. El valor predeterminado es la coma. Si elige el punto, utilice una coma o un espacio como separador decimal.

1. Amplíe la sección **Decimal Places** y seleccione una de las siguientes opciones: 
   + Elija **Automático** para que Amazon Quick determine automáticamente el número apropiado de decimales, o elija **Personalizado** para especificar un número de decimales. **Auto** es el valor predeterminado. 
   + Si ha elegido **Custom**, escriba el número de decimales que desea utilizar. Los valores de campo se redondean a los decimales especificados. Por ejemplo, si especifica dos decimales, el valor 6,728 se redondea a 6,73.

1. Amplíe la sección **Negativos** y elija si desea mostrar un valor negativo usando el signo menos o incluyendo el valor entre paréntesis. El signo menos es la opción predeterminada.

1. Expanda la sección **Valores nulos** y elija si desea mostrar los valores nulos como `null` o como un valor personalizado. El valor predeterminado es `null`.
**nota**  
Cuando se utiliza una tabla o una tabla dinámica, los valores nulos solo se muestran para los campos que se colocan en los cuadros de campo **Filas**, **Columnas** o **Agrupar por**. Los valores nulos de los campos del campo **Valores** aparecen vacíos en la tabla o tabla dinámica.

# Aplicación de formato a un campo de texto
<a name="format-a-text-field"></a>

Cuando da formato a un campo de texto, puede elegir cómo mostrar los valores nulos mediante el panel **Lista de campos**, un editor visual o un cuadro de campo visual.

**Elección de cómo mostrar los valores nulos de un campo de texto**

1. Elija una de las siguientes opciones:
   + En el panel **Lista de campos**, seleccione el icono selector situado a la derecha del campo numérico que desea dar formato. 
   + En cualquier elemento visual que contenga un editor visual asociado con el campo de porcentaje al que desea dar formato, elija ese editor visual. Amplíe el panel **Cuadros de campo** y, a continuación, seleccione el cuadro de campo asociado con el campo numérico que desea cambiar.

1. Elija **Formato** y, a continuación, seleccione **Más opciones de formato**. 

   Se abre el panel **Formato de datos**. 

1. Expanda la sección **Valores nulos** y elija si desea mostrar los valores nulos como `null` o como un valor personalizado. El valor predeterminado es `null`.

# Restablecer el formato de un campo a la configuración predeterminada
<a name="set-field-format-to-default"></a>

Utilice el siguiente procedimiento para restablecer el formato de un campo a la configuración predeterminada.

**Restablecimiento del formato predeterminado de un campo**

1. En el panel **Listado de campo**, seleccione el icono de selector que aparece a la derecha del campo que desea restablecer.

1. Elija **Formato** y, a continuación, seleccione **Más opciones de formato**. 

   Se abre el panel **Formato de datos**. 

1. Elija **Restablecer a los valores predeterminados**. 

# Clasificación de datos visuales en Amazon Quick
<a name="sorting-visual-data"></a>

Puede ordenar los datos con varios métodos para la mayoría de los tipos de elementos visuales. Puede elegir el orden de los datos de elementos visuales con la opción de ordenación rápida o los cuadros de campo. También puede utilizar los cuadros de campo para ordenar los datos por una métrica no visual. El elemento visual por el que se puede ordenar depende del tipo de elemento visual y de si se admite la ordenación para ese elemento visual. Para más información sobre qué tipos de elementos visuales admiten la ordenación, consulte [Formato de análisis por tipo en Quick](analytics-format-options.md). 

Las tablas dinámicas se comportan de forma diferente a las tablas a la hora de ordenar valores. Para obtener más información acerca de la ordenación de las tablas dinámicas, consulte [Clasificación de tablas dinámicas en Quick](sorting-pivot-tables.md). 

Para los conjuntos de datos SPICE, puede ordenar cadenas de texto de tamaños hasta las siguientes limitaciones: 
+ Hasta dos millones de valores únicos (2 000 000)
+ Hasta 16 columnas

Cuando se superan las limitaciones, el elemento visual muestra una notificación en la parte superior derecha.

Puede ordenar cualquier tipo de elemento visual que admita la ordenación. Si un tipo de elemento visual admite la ordenación, puede ordenar con la opción de ordenación rápida o con un cuadro de campo. 

**Ordenación rápida de dimensiones y medidas**
+ Realice una de las siguientes acciones:
  + Seleccione el icono de ordenación que aparece junto al nombre del campo en cualquiera de los ejes. En las consultas directas, este icono aparece para cualquier tipo de dato. En SPICE, este icono solo está disponible para los tipos de datos de fecha y hora, numéricos y decimales.
  + Seleccione el nombre del campo y, a continuación, elija la opción de ordenación en el menú. Si la etiqueta no aparece en el eje, compruebe el formato del elemento visual y si el eje está configurado para mostrar etiquetas. Las etiquetas de visualización se ocultan automáticamente en elementos visuales más pequeños. Es posible que necesite hacer que el elemento visual sea lo suficientemente grande como para mostrar etiquetas.

**Ordenación mediante una métrica no visual**

1. Abra el análisis con el elemento visual que desea ordenar. El panel de elementos visuales estará abierto de forma predeterminada.

1. Elija un cuadro de campo que admita la ordenación y, a continuación, elija **Ordenar por**, **Opciones de ordenación**.

1. En el panel **Opciones de ordenación**, ordene por campos específicos, elija una agregación u ordene de forma ascendente o descendente, o realice una combinación de estas opciones. 

1. Elija **Aplicar** para guardar los cambios. O elija **Borrar** para empezar de nuevo o **Cancelar** para volver atrás.

**Ordenación con un cuadro de campo**

1. Abra el análisis con el elemento visual que desea ordenar. El panel de elementos visuales estará abierto de forma predeterminada.

1. Elija un cuadro de campo que admita la ordenación.

1. En el menú del cuadro de campo, seleccione **Sort** y, a continuación, elija el icono de ordenación ascendente o descendente.

# Uso de temas en Amazon Quick Sight
<a name="themes-in-quicksight"></a>

En Amazon Quick Sight, un *tema* es un conjunto de ajustes que se pueden aplicar a varios análisis y paneles. Amazon Quick Sight incluye algunos temas y puedes añadir los tuyos propios mediante el editor de temas. Puede compartir temas con niveles de permisos definidos como usuario o propietario. Cualquier usuario que tenga acceso al tema puede aplicarlo a análisis y paneles o utilizar **Guardar como** para hacer su propia copia del mismo. Los propietarios de temas también pueden editar el tema y compartirlo con otros usuarios.

Un análisis solo puede tener un tema aplicado. Si aplica un tema a un análisis (mediante el botón **Aplicar**), este cambia instantáneamente para todos, tanto para los usuarios del análisis como para los del panel de control. Para explorar y guardar las opciones de color sin aplicarlas, evite editar y guardar el tema aplicado. 

Todos los colores están en pares de colores de fondo y primer plano. Los colores de primer plano están pensados para que aparezcan específicamente por encima de su color de fondo correspondiente, así que elija algo que ofrezca un buen contraste. 

En la siguiente tabla se definen los distintos parámetros.


| Group | Opción | Cambios en la configuración | 
| --- | --- | --- | 
|  Principal   |  Fondo principal  | El color de fondo utilizado para los elementos visuales y otras interfaces de usuario de alto énfasis.  | 
|  Principal   |  Primer plano principal  | El color del texto y otros elementos de primer plano que aparecen sobre las regiones del fondo principal, como líneas de cuadrícula, bordes, bandas de tabla, iconos, etc.   | 
|  Principal   |  Fondo secundario  |  El color de fondo que se utiliza para el fondo y los controles de la hoja.  | 
|  Principal   |  Primer plano secundario  | El color de primer plano que se utiliza para cualquier título de hoja, texto de control de hoja o interfaz de usuario que aparezca sobre el fondo secundario. | 
|  Principal   |  Acento  | Esta configuración se utiliza como una sugerencia interactiva para lo siguiente:[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/themes-in-quicksight.html) | 
|  Principal   |  Primer plano de acento  | El color de primer plano se aplica a cualquier texto u otros elementos que aparecen sobre el color de acento. | 
| Principal | Font | La fuente que se utilizará para todo el texto. Puedes elegir entre una variedad de fuentes compatibles con Amazon Quick Sight. | 
|  Datos   |  Colores de datos  | Son los colores de datos que recorren los gráficos al asignar colores a los grupos. Puede añadir o quitar colores a esta lista, o bien elegir un color para cambiarlo. | 
|  Datos   |  Degradado mínimo-máximo  | Los colores de degradado mínimo y máximo predeterminados que se utilizarán cuando se utilice un degradado como escala, por ejemplo, en mapas térmicos. | 
|  Datos   |  Color de relleno vacío  | Este es el color que se utiliza con los colores de los datos para indicar que faltan datos. Por ejemplo, este color aparece en la parte vacía de las barras de progreso que se muestran en los indicadores clave de rendimiento (KPI) y en los gráficos de medición, o en las celdas vacías del mapa térmico. | 
|  Diseño   |  Borde  | Esta configuración cambia el borde alrededor de los elementos visuales que no están seleccionados actualmente. El borde del elemento visual seleccionado sigue mostrando el color de acento. | 
|  Diseño   |  Margen  | Esta configuración alterna el espacio entre los límites de la hoja y los elementos visuales.  | 
|  Diseño   |  Margen interior  | Esta configuración muestra u oculta el espacio entre elementos visuales en la cuadrícula. | 
|  Otro   |  Success  Primer plano con éxito  | Estos colores se utilizan para los mensajes de éxito, por ejemplo, la marca de verificación de una descarga correcta. | 
|  Otro   |  Advertencia  Primer plano con advertencia  | Estos colores se utilizan para los mensajes de advertencia e informativos. | 
|  Otro   |  Peligro  Primer plano con peligro  | Estos colores se utilizan para los mensajes de error. | 
|  Otro   |  Dimensión  Primer plano con dimensión  | Estos colores se utilizan para los nombres de los campos que se identifican como dimensiones. Esta opción también establece el color de las dimensiones en el panel de filtros de los paneles integrados. | 
|  Otro   |  Medida  Primer plano con medida  | Estos colores se utilizan para los nombres de los campos que se identifican como medidas. Estos colores también se aplican a las medidas del panel de filtrado de los paneles de control integrados. | 

**Breve recorrido por el visor y el editor de temas**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra un análisis o cree uno nuevo. Debe tener un análisis abierto para trabajar con temas. Sin embargo, la vista que aparece con el tema aplicado es solo una vista previa.

   Los temas están separados de los análisis. No se realizan cambios en el análisis, aunque se guarde un tema. 

1. Elija **Editar** desde la barra de aplicaciones y, a continuación, elija **Temas**. Se abrirá el panel de temas.

1. La lista de temas muestra lo siguiente:
   + **Tema aplicado** muestra el tema que se aplica actualmente a este análisis y a sus paneles.
   + **Mis temas** muestra los temas que ha creado y los que se comparten con usted. 
   +  **Los temas de inicio** muestran los temas creados por Amazon Quick Sight.

1. Cada tema tiene un menú contextual al que se puede acceder desde el icono **…**.

   Las acciones disponibles en cada tema dependen de su nivel de acceso.
   + ****Propietarios del tema****: si creó el tema, o alguien lo compartió con usted y lo hizo propietario, puede hacer lo siguiente:
     + **Editar**: cambie la configuración del tema y guárdela.
     + **Guardar**: guarde los cambios que haya realizado en el tema. Si edita el tema aplicado y guarda los cambios, la nueva configuración del tema se aplicará a todos los análisis y paneles que lo utilicen. Aparece un mensaje informativo antes de sobrescribir un tema aplicado.
     + **Compartir**: comparta el tema y asigne permisos de usuario o propietario a otras personas.
     + **Eliminar**: elimine un tema. Esta acción no se puede deshacer. Aparece un mensaje informativo antes de confirmar la eliminación.
   + ****Usuarios del tema****: si alguien ha compartido el tema contigo o si es un tema de Amazon Quick Sight, puedes hacer lo siguiente:
     + **Aplicar**: aplique el tema al análisis actual. Esta opción también aplica el tema a los paneles creados a partir del análisis. Aparece un mensaje informativo antes de sobrescribir un tema aplicado.
     + **Guardar como**: guarde el tema actual con otro nombre para poder editarlo.
   + ****Autores del análisis****: si tiene acceso al análisis, pero no al tema, puede hacer lo siguiente:
     + Puede ver el análisis con el tema aplicado. 
     + Puede ver el tema en el panel **Tema**.
     + Puede utilizar **Guardar como** para crear su propia copia del tema.
   + ****Espectadores del panel****: si tiene acceso al panel, pero no al tema, puede hacer lo siguiente:
     + Puede ver el panel con el tema aplicado. 
     + No puede ver el tema ni su configuración. Los usuarios del panel no pueden ver el panel **Tema**.

1. Para explorar la configuración de un tema, elija los iconos de la izquierda para ver la configuración de los colores.

El siguiente procedimiento le guiará por la creación de un tema. Puede comenzar con el análisis, o con una copia del análisis, que desea utilizar para obtener una vista previa de los colores. O puede comenzar un nuevo análisis. Después de guardar el tema, puede aplicarlo al análisis actual o a otros análisis. Si lo comparte, otras personas también pueden usarlo.

**Uso del editor de temas**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra un análisis o cree uno nuevo. Elija **Editar** desde la barra de aplicaciones y, a continuación, elija **Temas**. Se abrirá el panel **Temas**.

   Debe tener un análisis abierto para trabajar con temas. Sin embargo, la vista que aparece con el tema aplicado es solo una vista previa. Los temas están separados de los análisis. No se realizan cambios en el análisis, aunque se guarde un tema. 

1. Elija **Principal**. El selector de color utilizado en cada uno de estos ajustes es el estándar que se utiliza en Amazon Quick Sight.

   Defina colores para **Fondo principal** y **Primer plano principal** para utilizarlos en elementos visuales y otras interfaces de usuario de alto impacto.

   Defina colores para **Fondo secundario** y **Primer plano secundario** para utilizarlos en hojas y controles de hoja.

   Establezca colores para **Acento** y **Primer plano de acento** para utilizarlos en sugerencias interactivas, incluidos botones, bordes alrededor de elementos visuales seleccionados, indicadores de carga, personalizaciones de narración, enlaces y el panel de filtros de los paneles integrados.

1. Elija **Datos**.

   Defina los valores de **Colores** que desea utilizar como colores de datos. Los gráficos los recorren al asignar colores. Puede añadir o eliminar colores, o cambiar el orden arrastrando y soltando. Para cambiar un color existente, selecciónelo para abrir el editor de colores.

   Defina colores para el valor de **Degradado mín./máx.** que se utiliza cuando se usa un gradiente como escala, por ejemplo, en mapas térmicos.

   Establezca el color de **Relleno vacío** que se utilizará cuando se muestre que faltan datos, por ejemplo, la parte no rellenada de una barra de progreso.

1. Elija **Diseño**.

   Active o desactive la casilla de verificación **Borde** para mostrar u ocultar el borde alrededor de los elementos visuales que no están seleccionados actualmente. 

   Active o desactive la casilla de verificación **Margen** para mostrar u ocultar el espacio entre los límites de la hoja y los elementos visuales. 

   Active o desactive la casilla de verificación **Margen de encuadernación** para mostrar u ocultar el espacio entre los elementos visuales en la cuadrícula.

1. Elija **Otro**.

   Establezca el color de **Correcto** que se utilizará en los mensajes de realización correcta, por ejemplo, cuando descargue correctamente un archivo .csv. El color de primer plano de realización correcta no se utiliza actualmente.

   Establezca el color de **Advertencia** que se usará en mensajes informativos y de advertencia. El color de primer plano de advertencia no se utiliza actualmente.

   Establezca el color para de **Peligro** que se utilizará en los mensajes de error. El color de primer plano de peligro no se utiliza actualmente.

   Establezca el color de **Dimensión** que se utilizará para los nombres de los campos que se identifican como dimensiones. Esta opción también establece el color de las dimensiones en el panel de filtros de los paneles integrados.

   Establezca el color de **Medida** que se utilizará para los nombres de los campos que se identifican como medidas. Esta opción también establece el color de las medidas en el panel de filtros de los paneles integrados.

1. Para guardar el tema, seleccione **Principal**, asigne un nombre al nuevo tema y, a continuación, seleccione **Guardar** en la parte superior derecha del navegador. 

   Al guardar un tema no se aplica al análisis, aunque puede obtener una vista previa de los colores que utiliza el análisis actual. 

1. Para compartir el tema, guarde o cierre el tema que está viendo. Busque el tema en su colección de temas. Seleccione **Compartir** en el menú contextual (…).

1. Para aplicar el tema, guarde o cierre el tema que está viendo. Busque el tema en su colección de temas. Seleccione **Aplicar** en el menú contextual (…).

# Acceso a Amazon Quick Sight mediante atajos de teclado
<a name="quicksight-accessibility"></a>

Puede utilizar los siguientes atajos de teclado para navegar por un panel o un análisis de Amazon Quick Sight:
+ Use la tecla `TAB` para navegar entre las opciones del menú o los elementos visuales.
+ Use las teclas `Shift+TAB` para retroceder a la selección anterior.
+ Use la tecla `Enter` para seleccionar un elemento visual o una opción de menú.
+ Use la tecla `ESC` para borrar la selección de un elemento visual o del menú.

![\[alt_text\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/keyboard-shortcuts-1.gif)


## Uso de atajos dentro con un elemento visual
<a name="in-visual-shortcuts"></a>

Puede usar las teclas `TAB`, `Shift+TAB` y `Enter` para navegar y seleccionar diferentes campos dentro de un elemento visual seleccionado. Por ejemplo, supongamos que quiere usar un enlace que forma parte del título de su elemento visual. Para ello, seleccione el elemento visual que desee y, a continuación, use la tecla `TAB` hasta que solo se seleccione el enlace. Luego, use la tecla `Enter` para hacer clic en el enlace.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/keyboard-shortcuts-2.gif)


También puede usar estos atajos de teclado para navegar e ingresar al menú visual situado en la esquina superior derecha de un elemento visual. Para ello, seleccione el elemento visual que desee y utilice la tecla `TAB` para ir al campo que desee seleccionar. Si se salta el campo que desea, utilice las teclas `Shift+TAB` para retroceder a un campo.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/keyboard-shortcuts-3.gif)


# Compartir datos y suscribirse a ellos en Amazon Quick Sight con paneles e informes
<a name="working-with-dashboards"></a>

Un *panel* es una instantánea de solo lectura de un análisis que puede compartir con otros usuarios de Amazon Quick Sight con fines de elaboración de informes. Un panel conserva la configuración del análisis en el momento de su publicación, incluidos elementos tales como filtros, parámetros, controles y orden de clasificación. Los datos utilizados para el análisis no se capturan como parte del panel. Cuando se mira el panel, este refleja los datos actuales contenidos en los conjuntos de datos utilizados por el análisis.

Cuando comparte un panel, debe especificar qué usuarios pueden obtener acceso a él. Los usuarios con la función de lectura del panel pueden ver y filtrar los datos contenidos en él. Todas las opciones seleccionadas de filtros, controles u ordenación que los usuarios aplican mientras están mirando el panel solamente se mantienen mientras el usuario está viendo el panel; no se guardan cuando este se cierra. Los usuarios que son propietarios del panel pueden editarlo y compartirlo y, opcionalmente, editar y compartir el análisis. Si desea que también puedan editar y compartir el conjunto de datos, puede establecerlo en el análisis. 

Un panel compartido también se puede integrar en un sitio web o en una aplicación, si se usa la edición Enterprise. Para obtener más información acerca de los paneles integrados, consulte [Análisis integrados para Amazon Quick Sight](embedded-analytics.md). 

Utilice las siguientes secciones para obtener información sobre cómo publicar y compartir paneles, suscribirse a las alertas de umbrales y enviar y suscribirse a los informes de correo electrónico de los paneles.

**Topics**
+ [Publicación de paneles](creating-a-dashboard.md)
+ [Compartir los paneles de Amazon Quick Sight](sharing-a-dashboard.md)
+ [Uso de conectores de acción rápida en las imágenes del tablero](action-connectors-in-dashboard-visuals.md)
+ [Compartir tu vista de un panel de Amazon Quick Sight](share-dashboard-view.md)
+ [Programar y enviar informes de Quick Sight por correo electrónico](sending-reports.md)
+ [Suscribirse a informes por correo electrónico en Amazon Quick Sight](subscribing-to-reports.md)
+ [Uso de alertas de umbral en Amazon Quick Sight](threshold-alerts.md)
+ [Impresión de un panel o análisis](printing1.md)
+ [Exportación de análisis o paneles de Amazon Quick Sight como PDFs](export-dashboard-to-pdf.md)
+ [Códigos de error para trabajos de exportación en PDF fallidos](qs-reports-error-codes.md)
+ [Organización de los activos en carpetas para Amazon Quick Sight](folders.md)

# Publicación de paneles
<a name="creating-a-dashboard"></a>

Cuando publicas un análisis, ese análisis se convierte en un panel que los usuarios de tu cuenta Amazon Quick pueden compartir e interactuar con él o, en algunos casos, con usuarios anónimos que no están en tu cuenta. Puede optar por publicar una hoja de un análisis, todas las hojas del análisis o cualquier otra combinación de hojas que desee. Al publicar una hoja interactiva, esta se convierte en un panel interactivo con el que los usuarios pueden interactuar. Cuando publicas una hoja de informe con píxeles perfectos, la hoja se convierte en un informe con píxeles perfectos que genera y guarda una instantánea de los datos del informe al programar un informe en Amazon Quick Sight. Puede publicar un panel que contenga cualquier combinación de hojas interactivas e informes detallados a partir del mismo análisis.

Para obtener más información acerca de la programación de un informe, consulte [Programar y enviar informes de Quick Sight por correo electrónico](sending-reports.md).

Para obtener más información sobre la visualización de las instantáneas de los informes, consulte [Consumir informes con píxeles perfectos en Amazon Quick Sight](qs-reports-consume-reports.md).

Utilice el siguiente procedimiento para publicar y compartir, si lo desea, un panel. También puede utilizar este procedimiento para cambiar el nombre de un panel publicado. Un panel al que se cambia el nombre conserva su configuración de seguridad y de informes por correo electrónico.

1. Abra el análisis que desee utilizar. Elija **Publicar**.

1. Realice una de las siguientes acciones:
   + Para crear un nuevo panel, elija **Nuevo panel** y, a continuación, escriba un nombre de panel.
   + Para sustituir un panel existente, realice una de las siguientes operaciones. Al sustituir un panel, este se actualiza sin modificar la configuración de los informes por correo electrónico o de seguridad. 
     + Para actualizarlo con los cambios, elija **Reemplazar un panel existente** y, a continuación, elija un panel de la lista. 
     + Para cambiar el nombre, elija **Reemplazar un panel existente**, elija un panel de la lista y, a continuación, seleccione el icono del lápiz. Ingrese un nuevo nombre para cambiar el nombre del panel existente y haga clic en la marca de verificación o pulse Intro para confirmar. Al publicar un panel después de cambiar el nombre, también guarda los cambios hechos en el análisis. Los cambios en el análisis o el panel no se conservan hasta que los **publique**. Se debe publicar una versión inicial de un panel para cambiarle el nombre. 

1. (Opcional) Elija las hojas que desee publicar en el menú desplegable **HOJAS**. Al seleccionar las hojas para añadirlas al nuevo panel, el menú desplegable muestra cuántas hojas están seleccionadas para su publicación. La opción predeterminada es **SE SELECCIONARON TODAS LAS HOJAS**.

   Si va a sustituir un panel existente, las hojas que ya están publicadas en dicho panel se preseleccionan en el menú desplegable, a menos que publique desde un análisis desde el que no haya publicado antes. Puede realizar cambios en esta opción seleccionando las hojas de la lista desplegable o anulando su selección.

1. (Opcional) Agregue comentarios sobre los cambios que ha hecho en la sección de notas, que está disponible en el [Historial de versiones](publishing-a-previous-dashboard-version.md).

1. (Opcional) Para permitir que los lectores del panel compartan historias de datos, elija **Permitir compartir historias de datos**. Para obtener más información acerca de las historias de datos, consulte [Trabajar con historias de datos en Amazon Quick Sight](working-with-stories.md).

1. (Opcional) Abra **Más ajustes**. Estas opciones solo están disponibles si al menos una hoja del nuevo panel es una hoja interactiva.
**nota**  
Esta es una ventana desplazable. Desplácese hacia abajo en la ventana **Publicar un panel** para ver todas las opciones disponibles.

   Hay algunas opciones que puede deshabilitar para simplificar la experiencia de este panel, tal y como se indica a continuación:
   + Para las **opciones del panel**:
     + Deje desactiva la opción **Ampliar controles en la hoja de forma predeterminada** para ver una vista simplificada. Esta opción está deshabilitada de forma predeterminada. Para mostrar los controles de forma predeterminada, habilite esta opción.
     + Desactive **Habilitar filtrado avanzado en el panel izquierdo** para eliminar la posibilidad de que los usuarios del panel filtren los datos por sí mismos. Si crean sus propios filtros, los filtros solo existen mientras el usuario está viendo el panel. Los filtros no se pueden guardar ni reutilizar. 
     + Desactive **Habilitar la información sobre herramientas al pasar el ratón** para deshabilitar la información sobre herramientas. 
   + En **Opciones visuales**:
     + Desactive **Habilitar menú visual** para deshabilitar el menú del elemento visual al completo.
     + Elija **Habilitar las opciones de descarga** si los usuarios del panel necesitan poder descargar datos de los elementos visuales del panel. El archivo CSV incluye solo lo que está visible actualmente en el elemento visual en el momento en que lo descarga. El usuario descarga datos mediante el menú visual de cada elemento visual individual. 
     + Desactive **Habilitar la opción de maximización del elemento visual** para deshabilitar la capacidad de ampliar los elementos visuales para llenar la pantalla.
   + Para **opciones de punto de datos**:
     + Desactive **Habilitar la opción de desglose en sentido ascendente o descendente** si su panel no ofrece jerarquías de campo que se puedan desglosar.
     + Desactive **Habilitar la información sobre herramientas al hacer clic** para deshabilitar la información sobre herramientas que aparece cuando el lector elige un punto de datos (hace clic en él). 
     + Desactive **Habilitar opciones de ordenación** para deshabilitar los controles de ordenación. 

1. Elija **Publicar panel**. 

   Si ha cambiado el nombre del panel existente, la parte superior de la pantalla se actualiza para mostrar el nuevo nombre.

1. (opcional) Realice una de las operaciones siguientes:
   + Para publicar un panel sin necesidad compartirlo, elija **x** en la parte superior derecha de la pantalla **Compartir panel con los usuarios** cuando aparezca. Siempre podrá compartir el panel más adelante si selecciona **Archivo>Compartir** en la barra de aplicaciones. 
   + Para compartir el panel, siga el procedimiento indicado en [Compartir los paneles de Amazon Quick Sight](sharing-a-dashboard.md).

   Después de completar estos pasos, habrá terminado de crear y compartir el panel. Los suscriptores del panel reciben un correo electrónico que contiene un enlace al panel. Los grupos no reciben correos electrónicos de invitación.

# Copiar un panel de Amazon Quick Sight
<a name="copying-a-dashboard"></a>

Si tiene acceso de copropietario o privilegios de **Guardar como** en un panel existente, puede copiarlo. Para ello, cree un nuevo análisis a partir del panel y, a continuación, cree un nuevo panel a partir del análisis que ha copiado.

Una vez guardado el panel original como un nuevo análisis, puede colaborar en él compartiendo el nuevo análisis con otros usuarios. Por ejemplo, puede utilizar este flujo de trabajo para conservar una versión de producción del panel, mientras también desarrolla o prueba una nueva versión del mismo.

**Copia de un panel**

1. Inicie sesión en Quick y seleccione **Paneles** de control en la página de inicio.

1. Abra el panel que quiera duplicar.

1. En la parte superior derecha, elija **Guardar como** y, a continuación, escriba un nombre para el nuevo análisis. Al guardar un panel existente mediante la opción **Guardar como**, se crea un análisis basado en el panel.
**nota**  
Si no puede ver **Guardar como**, consulte con su administrador si tiene los permisos correctos.

1. (Opcional) Realice cambios en el nuevo análisis.

1. (Opcional) Comparta el análisis con otros usuarios para colaborar en los cambios. Todos los usuarios que tienen acceso pueden realizar cambios en el nuevo análisis.

   Para compartir el análisis con otros usuarios, seleccione **Compartir** en la esquina superior derecha de la página y, a continuación, seleccione **Compartir análisis**.

1. (Opcional) Cree un nuevo panel con los cambios en el nuevo análisis, elija **Compartir** y, a continuación, **Publicar panel**.

Para obtener más información, consulte los siguientes temas: 
+ [Compartir los paneles de Amazon Quick Sight](sharing-a-dashboard.md)
+ [Compartir los análisis de Quick Sight](sharing-analyses.md)

# Eliminar un panel de Amazon Quick Sight
<a name="deleting-a-dashboard"></a>

Cuando eliminas un panel de Amazon Quick Sight, el panel se elimina permanentemente de tu cuenta y de todas las carpetas de las que formaba parte el panel. Ya no podrá acceder al panel eliminado. Solo puede eliminar aquellos paneles de los que sea propietario o copropietario. Utilice el siguiente procedimiento para eliminar un panel.

**Eliminación de un panel**

1. En la pestaña **Paneles** de la página de inicio de Amazon Quick, selecciona el icono de detalles (puntos verticales) del panel de control que quieras eliminar.

1. Elija **Eliminar**. A continuación, vuelva a elegir **Eliminar** para confirmar que desea eliminarlo. Al eliminar un panel, se elimina permanentemente el panel de su cuenta y el panel desaparecerá de todas las carpetas a las que pertenecía. Aún puede acceder a otros paneles y crearlos a partir del análisis desde el que se publicó el panel eliminado.

# Publicar una versión anterior de un panel de Amazon Quick Sight
<a name="publishing-a-previous-dashboard-version"></a>

Cada vez que actualiza un análisis y lo publica, se crea una nueva versión del panel de Amazon Quick Sight. Para volver a una versión anterior de un panel, puede buscarla en el **Historial de versiones** del panel y publicar la versión anterior que le interese. Cada panel puede almacenar hasta 1000 versiones que nunca se eliminan. Siga este procedimiento para publicar una versión anterior de un panel.

**Publicación de una versión anterior de un panel**

1. En la pestaña **Paneles** de la página de inicio de Amazon Quick, elige el panel que quieres gestionar.

1. Elija **Historial de versiones** en la barra de herramientas de la derecha. La versión del panel que está publicada actualmente, así como las versiones anteriores disponibles, aparecerán en una lista. Todos los comentarios que se hayan agregado en la sección de notas aparecerán con la versión correspondiente. 

1. Seleccione la versión del panel que le interese. Puede ver cuándo se publicó esta versión y qué usuario la publicó.

1. Para volver a esta versión, seleccione **Publicar**. Haga clic en **Confirmar** para publicar la versión.

# Compartir los paneles de Amazon Quick Sight
<a name="sharing-a-dashboard"></a>

De forma predeterminada, los paneles de Amazon Quick Sight no se comparten con nadie y solo el propietario puede acceder a ellos. Sin embargo, después de publicar un panel, puedes compartirlo con otros usuarios o grupos de tu cuenta de Amazon Quick. También puedes optar por compartir el panel con todos los usuarios de tu cuenta de Quick y hacer que el panel esté visible en la página de inicio de Quick para todos los usuarios de tu cuenta. Además, puede copiar un enlace al panel para compartirlo con otras personas que tengan acceso a él.

**importante**  
Los usuarios que tienen acceso al panel también ven los datos utilizados en el análisis asociado.

Después de haber compartido un panel, puede revisar qué otros usuarios o grupos tienen acceso a él y controlar el tipo de acceso que tienen. También puede revocar el acceso al panel de cualquier usuario. También puede eliminarse del panel.

También puede integrar paneles y elementos visuales interactivos en sitios web y aplicaciones al copiar el panel o el código de integración visual y pegándolo en la aplicación. Para obtener más información, consulte [Incrustar imágenes y paneles de Amazon Quick Sight para usuarios registrados con un código de inserción de 1 clic](embedded-analytics-1-click.md).

# Concesión de acceso a un panel
<a name="share-a-dashboard"></a>

Puedes compartir paneles e imágenes con usuarios o grupos específicos de tu cuenta o con todos los usuarios de tu cuenta de Amazon Quick. O puede compartirlos con cualquier persona en Internet. Puede compartir paneles e imágenes mediante la consola Quick o la API Quick Sight. El acceso a un elemento visual compartido depende de los ajustes de uso compartido configurados para el panel al que pertenece el elemento visual. Para compartir e integrar elementos visuales en su sitio web o aplicación, ajuste la configuración de uso compartido del panel al que pertenece. Para obtener más información, consulte lo siguiente:
+ [Otorgar a usuarios y grupos individuales de Amazon Quick Sight acceso a un panel de control en Amazon Quick Sight](share-a-dashboard-grant-access-users.md)
+ [Conceder a todos los usuarios de tu cuenta de Amazon Quick Sight acceso a un panel](share-a-dashboard-grant-access-everyone.md)
+ [Conceder a cualquier usuario de Internet acceso a un panel de Amazon Quick Sight](share-a-dashboard-grant-access-anyone.md)
+ [Conceder a todos los usuarios de tu cuenta de Amazon Quick acceso a un panel de control con la API Quick Sight](share-a-dashboard-grant-access-everyone-api.md)
+ .[Conceder a cualquier usuario de Internet acceso a un panel de Amazon Quick Sight mediante la API Quick Sight](share-a-dashboard-grant-access-anyone-api.md)

# Otorgar a usuarios y grupos individuales de Amazon Quick Sight acceso a un panel de control en Amazon Quick Sight
<a name="share-a-dashboard-grant-access-users"></a>

Siga este procedimiento para conceder acceso a un panel.

**Concesión de acceso a un panel a usuarios o grupos**

1. Abra el panel publicado y seleccione **Compartir** en la esquina superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, haga lo siguiente:

   1. En **Invitar a usuarios y grupos al panel**, en la izquierda, introduzca el correo electrónico de un usuario o un nombre de grupo en el cuadro de búsqueda.

      Los usuarios o grupos que coincidan con su consulta aparecen en una lista situada debajo del cuadro de búsqueda. Solo los usuarios y grupos activos se muestran en la lista.

   1. Para el usuario o grupo al que quiera conceder acceso al panel, seleccione **Añadir**. Luego, elija el nivel de permisos que quiere que tenga.

      Puede seleccionar **Visor** o **Copropietario**, en función del rol rápido del usuario. Los permisos disponibles para cada rol son los siguientes:
      + **Lectores**: a los lectores rápidos solo se les puede conceder acceso como **espectadores** a los paneles. Pueden ver, exportar e imprimir el panel, pero no pueden guardarlo como un análisis. Pueden ver, filtrar y ordenar los datos del panel. También pueden utilizar los controles y acciones personalizadas del panel. Los cambios que realicen en el panel solo permanecerán mientras estén viéndolo y no se guardarán cuando lo cierren.
      + **Autores**: a los autores rápidos se les puede conceder acceso como **espectadores** o **copropietarios** a los paneles.
        + Los autores con acceso como Espectador pueden ver, exportar e imprimir el panel. Pueden ver, filtrar y ordenar los datos del panel. También pueden utilizar los controles y acciones personalizadas del panel. Los cambios que realicen en el panel solo permanecerán mientras estén viéndolo y no se guardarán cuando lo cierren.

          Sin embargo, pueden guardar el panel como un análisis, a menos que el propietario del panel especifique lo contrario. Este privilegio les concede acceso de solo lectura a los conjuntos de datos para que puedan crear nuevos análisis a partir de ellos. El propietario tiene la opción de proporcionarles los mismos permisos sobre el análisis. Si el propietario quiere que también editen y compartan los conjuntos de datos, puede establecerlo dentro del análisis. 
        + Los autores con acceso como Copropietario pueden ver, exportar e imprimir el panel. También pueden editarlo, compartirlo y eliminarlo. También pueden guardar el panel como un análisis, a menos que el propietario del panel especifique lo contrario. Este privilegio les concede acceso de solo lectura a los conjuntos de datos para que puedan crear nuevos análisis a partir de ellos. El propietario tiene la opción de proporcionarles los mismos permisos sobre el análisis. Si el propietario quiere que también editen y compartan los conjuntos de datos, puede establecerlo dentro del análisis.
      + **Grupos**: a los grupos rápidos solo se les puede conceder el acceso de los **espectadores** a los paneles. Pueden ver, exportar e imprimir el panel, pero no pueden guardarlo como un análisis.

      Después de añadir un usuario o un grupo al panel, puede ver información sobre ellos en la sección **Administrar permisos**, en **Usuarios y grupos**. Puede ver sus nombre de usuario, correo electrónico, nivel de permisos y privilegios de “guardar como”.

      Para permitir que un usuario o un grupo guarde el panel como un análisis, active **Permitir “guardar como”** en la columna **Guardar como análisis**.

   1. Para añadir más usuarios al panel, introduzca el correo electrónico de otro usuario o el nombre de un grupo en el cuadro de búsqueda y repita los pasos A y B.

# Conceder a todos los usuarios de tu cuenta de Amazon Quick Sight acceso a un panel
<a name="share-a-dashboard-grant-access-everyone"></a>

Como alternativa, puedes compartir tu panel de Amazon Quick Sight con todos los miembros de tu cuenta. De este modo, todos los miembros de su cuenta pueden acceder al panel, incluso si no se les ha concedido el acceso de forma individual ni se les han asignado permisos. Pueden acceder al panel si tienen un enlace al mismo (compartido por usted) o si está integrado.

Compartir el panel con todos los miembros de su cuenta no afecta a los informes de correo electrónico. Por ejemplo, supongamos que decide compartir el panel con todos los miembros de la cuenta. Supongamos que también elige **Enviar un informe por correo electrónico a todos los usuarios con acceso al panel** al configurar un informe por correo electrónico para el mismo panel. En este caso, el informe por correo electrónico se envía solo a las personas que tengan acceso al panel. Reciben acceso a través de alguien que lo comparte explícitamente con ellos, a través de grupos o a través de carpetas compartidas.

**Concesión de acceso a un panel a todos los miembros de su cuenta**

1. Abra el panel publicado y seleccione **Compartir** en la esquina superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, seleccione **Habilitar el acceso para**, en la parte inferior izquierda, y active **Todos los usuarios de esta cuenta**. Las cuentas que inicien sesión con Active Directory no pueden acceder al interruptor **Todos los usuarios de esta cuenta**. Las cuentas que usan Active Directory pueden habilitar esta configuración mediante una llamada a la API `UpdateDashboardPermissions`. Para obtener más información`UpdateDashboardPermissions`, consulte la *referencia [UpdateDashboardPermissions](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_UpdateDashboardPermissions.html)de la API de Amazon Quick Sight*.

1. (Opcional) Activa **Discoverable en Quick Sight**.

   Cuando compartes un panel con todos los miembros de la cuenta, los propietarios también pueden optar por hacer que el panel sea visible en Quick Sight. Un panel visible aparece en la lista de paneles de todos de la página **Paneles**. Cuando esta opción está habilitada, todos los usuarios de la cuenta pueden ver y buscar el panel. Cuando esta opción está deshabilitada, solo pueden acceder al panel si tienen un enlace o si está integrado. El panel no aparece en la página **Paneles** y los usuarios no pueden buscarlo.

# Conceder a cualquier usuario de Internet acceso a un panel de Amazon Quick Sight
<a name="share-a-dashboard-grant-access-anyone"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

También puedes compartir tu panel de Amazon Quick Sight con cualquier usuario de Internet desde el menú **Compartir** de la consola Amazon Quick. Si lo haces, cualquier usuario de Internet podrá acceder al panel de control, incluso si no es un usuario registrado en tu cuenta de Quick, si compartes el enlace del panel o lo insertas.

Use las secciones siguientes para permitir que cualquier usuario de Internet tenga acceso al panel cuando lo comparta.

**Topics**
+ [Antes de comenzar](share-a-dashboard-grant-access-anyone-prerequisites.md)
+ [Concesión de acceso a un panel a cualquier persona de Internet](share-a-dashboard-grant-access-anyone-access.md)
+ [Actualización de un panel compartido públicamente](share-a-dashboard-grant-access-anyone-update.md)
+ [Deshabilitación de la configuración de uso compartido en público](share-a-dashboard-grant-access-anyone-no-share.md)

# Antes de comenzar
<a name="share-a-dashboard-grant-access-anyone-prerequisites"></a>

Antes de compartir un panel con cualquier persona en Internet, asegúrese de hacer lo siguiente:

1. Active los precios de capacidad por sesión en su cuenta. Si no ha activado el precio de capacidad por sesión en su cuenta, no podrá actualizar la configuración de uso compartido público de su cuenta. 

1. Asigne permisos de uso compartido público a un usuario administrador en la consola de IAM. Puede añadir estos permisos con una nueva política o puede añadir los nuevos permisos a un usuario existente.

   La siguiente política de ejemplo ofrece estos permisos para usar con `UpdatePublicSharingSettings`.

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

****  

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

------

   Las cuentas que no deseen que los usuarios con acceso de administrador utilicen esta característica pueden añadir una política de IAM que deniegue los permisos de uso compartido público. El siguiente ejemplo de política deniega los permisos para usar con `UpdatePublicSharingSettings`.

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

****  

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

------

   Para obtener más información sobre el uso de IAM con Quick Sight, consulte[Uso de Quick con IAM](security_iam_service-with-iam.md).

   También puede usar la política de “denegar” como política de control de servicios (SCP) si no desea que ninguna de las cuentas de su organización tenga la característica de uso compartido público. Para obtener más información, consulte [las políticas de control de servicios (SCPs)](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_policies_scps.html) en la *Guía del AWS Organizations usuario*.

1. Activa la opción de compartir en público en tu cuenta Amazon Quick.

   1. En la página de inicio rápido de Amazon, elige el icono de usuario en la parte superior derecha de la ventana del navegador y, a continuación, selecciona **Manage Quick**.

   1. En la página que se abre, desplázate hacia abajo hasta la sección **Permisos**.

   1. Seleccione **Acceso público a los paneles** de control a la izquierda.

   1. En la página que se abre, seleccione **Cualquier persona en Internet**.

      Cuando active esta configuración, aparecerá una ventana emergente pidiéndole que confirme su elección. Una vez que la haya confirmado, puede conceder al público acceso a paneles específicos y compartirlos con ellos mediante un enlace, o bien integrando el panel en una aplicación, wiki o portal públicos.

# Concesión de acceso a un panel a cualquier persona de Internet
<a name="share-a-dashboard-grant-access-anyone-access"></a>

**Concesión de acceso a un panel a cualquier persona de Internet**

1. En Quick, abra el panel publicado que desee compartir. Debe ser el propietario o copropietario del panel.

1. En el panel publicado, seleccione el icono **Compartir** en la parte superior derecha y, a continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, seleccione **Cualquier persona en Internet (público)** en la sección **Habilitar el acceso para**, situada en la parte inferior izquierda.

   Esta configuración le permite compartir el panel con cualquier persona en Interne con el enlace para compartir o cuando está integrado. Al activar este botón, también se activa automáticamente la opción **Todos los miembros de esta cuenta**, lo que significa que el panel se compartirá con todos los usuarios de tu cuenta de Quick. Si no lo desea, desactive esta opción.

1. En la ventana emergente **Permitir acceso público** que aparece, ingrese `confirm` en el cuadro para confirmar su elección y, a continuación, seleccione **Confirmar**.

Tras confirmar la configuración de acceso a tu panel de control, aparecerá una etiqueta **PUBLIC** naranja en la parte superior derecha de tu panel de control en la consola Amazon Quick. Además, aparece un icono en forma de ojo en el panel de control de la página de paneles de Quick Sight, tanto en forma de mosaico como de lista.

Tenga en cuenta que cuando el acceso público está activado, solo se puede acceder al panel mediante el enlace o, cuando está integrado, mediante el código de inserción. Para obtener más información acerca de cómo compartir un enlace en el panel, consulte [Uso compartido de un enlace con un panel compartido](share-a-dashboard-share-link.md). Para obtener más información sobre cómo incrustar paneles para cualquier usuario de Internet, consulte [Incrustar imágenes y paneles de Amazon Quick Sight para usuarios anónimos con un código de inserción de 1 clic](embedded-analytics-1-click-public.md).

# Actualización de un panel compartido públicamente
<a name="share-a-dashboard-grant-access-anyone-update"></a>

Utilice el siguiente procedimiento para actualizar un panel compartido al que pueda acceder cualquier usuario de Internet.

**Para actualizar un panel público:**

1. En la página de inicio rápido de Amazon, selecciona el análisis vinculado al panel de control que deseas actualizar y realiza los cambios que desees. Debe ser el propietario o copropietario del análisis.

1. En el análisis, elija **Publicar**.

1. En la ventana emergente que aparece, seleccione **Reemplazar un panel existente** y seleccione el panel público que desee actualizar.

1. Para confirmar su elección, introduzca `confirm` y, a continuación, seleccione **Publicar panel**.

   Una vez que seleccione **Publicar panel**, su panel público se actualizará para reflejar los nuevos cambios.

# Deshabilitación de la configuración de uso compartido en público
<a name="share-a-dashboard-grant-access-anyone-no-share"></a>

Puede deshabilitar la configuración de uso compartido público de los paneles en cualquier momento. Puede deshabilitar el uso compartido público de un panel individual o de todos los paneles de su cuenta. La configuración de uso compartido visual se determina a nivel de panel. Si desactiva la configuración para compartir en público en un panel que contenga un elemento visual que estés insertando, los usuarios no podrán acceder a ella.

En la siguiente tabla se describen los distintos escenarios en los que un panel está disponible públicamente.


| Configuración pública a nivel de cuenta | Configuración pública a nivel de panel | Acceso público | Indicadores visuales | 
| --- | --- | --- | --- | 
|  Desactivado  |  Desactivado  |  Desactivado  |  Ninguno  | 
|  Activado  |  Desactivado  |  Desactivado  |  Ninguno  | 
|  Activado  |  Activado  |  Sí  |  Aparece una insignia naranja en el panel y un icono de ojo en el panel de la página **Paneles**.  | 
|  Desactivado  |  Activado  |  No  |  Aparece una insignia gris en el panel y, en la página **Paneles**, aparece un icono en forma de ojo con una barra inclinada. La revocación del acceso público de un panel puede tardar hasta dos minutos.  | 

**Desactivación del uso compartido público de un único panel**

1. En Amazon Quick, abre el panel publicado que ya no quieras compartir. Debe ser el propietario o copropietario del panel.

1. En el panel publicado, seleccione el icono **Compartir** en la parte superior derecha y, a continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, desactive el interruptor **Cualquier persona en Internet (público)** en la sección **Habilitar el acceso para**, situada en la parte inferior izquierda.

   Esta acción eliminará el acceso público al panel. Ahora solo podrán acceder a él los usuarios con los que se haya compartido.

**Para desactivar la configuración de uso compartido en público de todos los paneles de una cuenta de usuario de Quick**

1. En la página de inicio rápido de Amazon, elige el icono de usuario en la parte superior derecha de la ventana del navegador y, a continuación, selecciona **Manage Quick**.

1. En la página que se abre, desplázate hacia abajo hasta la sección **Permisos**.

1. Seleccione **Acceso público a los paneles** de control a la izquierda.

1. En la página que se abre, desactive el interruptor **Cualquier persona en Internet**.

   Si desactiva la configuración para compartir en público desde el menú **Uso compartido público**, aparecerá una ventana emergente en la que se le pedirá que confirme su elección. Seleccione **He leído y acepto este cambio** y, a continuación, seleccione **Confirmar** para confirmar su elección.

   Esta acción eliminará el acceso público a todos los paneles de su cuenta. Los paneles que estaban visibles para cualquier persona en Internet ahora solo serán accesibles para los usuarios con los que se haya compartido cada panel. Los paneles individuales que tengan la configuración pública activada tendrán una insignia gris, y el icono en forma de ojo que aparece en la página **Paneles** aparecerá tachado para indicar que la configuración pública a nivel de cuenta está deshabilitada y que el panel no se puede ver. La revocación del acceso público de un panel puede tardar hasta dos minutos.

Si su suscripción con el precio de capacidad por sesión ha caducado, la configuración de uso compartido en público se eliminará automáticamente de su cuenta. Renueve su suscripción para restablecer el acceso a la configuración de uso compartido en público.

# Conceder a todos los usuarios de tu cuenta de Amazon Quick acceso a un panel de control con la API Quick Sight
<a name="share-a-dashboard-grant-access-everyone-api"></a>


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Como alternativa, puedes permitir que todos los miembros de tu cuenta accedan al panel de control con la API Quick Sight mediante la `UpdateDashboardPermissions` operación. 

El siguiente ejemplo de solicitud de la API ilustra cómo hacerlo mediante un comando de la AWS CLI . Otorga permisos de enlace en el panel de su cuenta y permite las siguientes operaciones: `DescribeDashboard`, `QueryDashboard` y `ListDashboard`.

```
aws quicksight update-dashboard-permissions \
--aws-account-id account-id \
--region aws-directory-region \
--dashboard-id dashboard-id \
--grant-link-permissions 
	Principal="arn:aws:quicksight:aws-directory-region:account-id:namespace/default",
	Actions="quicksight:DescribeDashboard, quicksight:QueryDashboard, 
	quicksight:ListDashboardVersions"
```

La respuesta de la solicitud anterior tiene un aspecto similar a la siguiente.

```
{
		"Status": 200,
		"DashboardArn": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:dashboard/
		DASHBOARDID",
		"DashboardId": "DASHBOARDID",
		"LinkSharingConfiguration": {
			"Permissions": [
				{
					"Actions": [
						"quicksight:DescribeDashboard",
						"quicksight:ListDashboardVersions",
						"quicksight:QueryDashboard"
					],
					"Principal": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:namespace/default"
				}
			]
		},
		"Permissions": [
			// other dashboard permissions here
		],
		"RequestId": "REQUESTID"
	}
```

También puede impedir que todos los usuarios de su cuenta accedan al panel mediante la misma operación de la API. La siguiente solicitud de ejemplo ilustra cómo hacerlo mediante un comando de la CLI.

```
aws quicksight update-dashboard-permissions \
--aws-account-id account-id \
--region aws-directory-region \
--dashboard-id dashboard-id \
--revoke-link-permissions 
	Principal="arn:aws:quicksight:aws-directory-region:account-id:namespace/default",
	Actions="quicksight:DescribeDashboard, quicksight:QueryDashboard, 
	quicksight:ListDashboardVersions"
```

Para obtener más información, consulta [UpdateDashboardPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPermissions.html)la *Amazon Quick API Reference*.

Cuando todos los usuarios de una cuenta de usuario de Quick tienen acceso al panel de control, se añade el siguiente fragmento al AWS CloudTrail registro como parte del `eventName``UpdateDashboardAccess`, y del. `eventCategory` `Management`

```
"linkPermissionPolicies": 
	[
		{
			"principal": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:
							namespace/default",
			"actions": 
			[
				"quicksight:DescribeDashboard",
				"quicksight:ListDashboardVersions",
				"quicksight:QueryDashboard"
			]
		}
	]
```

# Conceder a cualquier usuario de Internet acceso a un panel de Amazon Quick Sight mediante la API Quick Sight
<a name="share-a-dashboard-grant-access-anyone-api"></a>

Como alternativa, puedes conceder a cualquier usuario de Internet acceso al panel de control con la API Amazon Quick Sight mediante la `UpdateDashboardPermissions` operación.

Antes de comenzar, asegúrese de conceder acceso al panel a todos los miembros de su cuenta. Para obtener más información, consulte [Conceder a todos los usuarios de tu cuenta de Amazon Quick acceso a un panel de control con la API Quick Sight](share-a-dashboard-grant-access-everyone-api.md).

El siguiente ejemplo de solicitud de API ilustra cómo conceder a cualquier persona en Internet acceso a un panel mediante un comando AWS CLI. Otorga permisos de enlace en el panel de su cuenta y permite las siguientes operaciones: `DescribeDashboard`, `QueryDashboard` y `ListDashboardVersions`.

```
aws quicksight update-dashboard-permissions 
--aws-account-id account-id 
--region aws-directory-region
--dashboard-id dashboard-id
--grant-link-permissions 
Principal="arn:aws:quicksight:::publicAnonymousUser/*",
Actions="quicksight:DescribeDashboard, quicksight:QueryDashboard, 
quicksight:ListDashboardVersions"
```

La respuesta de la solicitud anterior tiene un aspecto similar a la siguiente.

```
{
    "Status": 200,
    "DashboardArn": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:dashboard/
    DASHBOARDID",
    "DashboardId": "DASHBOARDID",
    "LinkSharingConfiguration": {
        "Permissions": [
            {
                "Actions": [
                    "quicksight:DescribeDashboard",
                    "quicksight:ListDashboardVersions",
                    "quicksight:QueryDashboard"
                ],
                "Principal": "arn:aws:quicksight:AWSDIRECTORYREGION:ACCOUNTID:namespace/default"
            },
                "Principal": "arn:aws:quicksight:::publicAnonymousUser/*",
                "Actions": [
                    "quicksight:DescribeDashboard",
                    "quicksight:ListDashboardVersions",
                    "quicksight:QueryDashboard"
                ]
            }
        ]
    },
    "Permissions": [
        // other dashboard permissions here
    ],
    "RequestId": "REQUESTID"
}
```

También puede impedir que cualquier usuario de Internet acceda al panel mediante la misma operación de la API. La siguiente solicitud de ejemplo ilustra cómo hacerlo mediante un comando de la CLI.

```
aws quicksight update-dashboard-permissions \
--aws-account-id account-id \
--region aws-directory-region \
--dashboard-id dashboard-id \
--revoke-link-permissions 
Principal="arn:aws:quicksight:::publicAnonymousUser/*",
Actions="quicksight:DescribeDashboard, quicksight:QueryDashboard, 
quicksight:ListDashboardVersions"
```

Para obtener más información, consulta [UpdateDashboardPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPermissions.html)la *Amazon Quick API Reference*.

Cuando cualquier usuario de Internet tiene acceso al panel de control, se agrega el siguiente fragmento al AWS CloudTrail registro como parte del `eventName``UpdateDashboardAccess`, y del. `eventCategory` `Management`

```
"linkPermissionPolicies": 
	[
		{
			"principal": "arn:aws:quicksight:::publicAnonymousUser/*",
			"actions": 
			[
				"quicksight:DescribeDashboard",
				"quicksight:ListDashboardVersions",
				"quicksight:QueryDashboard"
			]
		}
	]
```

# Uso compartido de un enlace con un panel compartido
<a name="share-a-dashboard-share-link"></a>

Después de conceder a los usuarios el acceso a un panel, puede copiar un enlace al mismo y enviárselo. Cualquier persona que tenga acceso al panel puede acceder al enlace y verlo.

**Envío de un enlace al panel a los usuarios**

1. Abra el panel publicado y seleccione **Compartir** en la esquina superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, seleccione **Copiar enlace** en la esquina superior izquierda.

   El enlace al panel se copia en el portapapeles. Tendrá un aspecto similar al siguiente,

   `https://quicksight.aws.amazon.com/sn/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias`

   Los usuarios y grupos (o todos los usuarios de su cuenta Quick) que tengan acceso a este panel pueden acceder a él mediante el enlace. Si acceden a Quick por primera vez, se les pedirá que inicien sesión con su dirección de correo electrónico o con el nombre de usuario y la contraseña de Quick de la cuenta. Después de iniciar sesión, tendrán acceso al panel.

# Visualización de quién tiene acceso a paneles compartidos
<a name="view-users-dashboard"></a>

Utilice el siguiente procedimiento para ver qué usuarios o grupos tienen acceso al panel.

1. Abra el panel publicado y seleccione **Compartir** en la esquina superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, en **Administrar permisos**, revise los usuarios y grupos, así como sus roles y configuraciones.

   Puede realizar una búsqueda para localizar un usuario o grupo específico ingresando su nombre o cualquier parte de su nombre en el cuadro de búsqueda en la parte superior derecha. La búsqueda distingue entre mayúsculas y minúsculas, y no admite el uso de comodines. Elimine el término de búsqueda para devolver la vista a todos los usuarios.

# Revocación del acceso a paneles compartidos
<a name="revoke-access-to-a-dashboard"></a>

Utilice el siguiente procedimiento para revocar el acceso de un usuario a un panel.

**Revocación del acceso de un usuario a un panel**

1. Abra el panel y seleccione **Compartir** en la parte superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, en **Administrar permisos**, localice el usuario que desea eliminar y seleccione el icono de eliminación situado en el extremo derecho.

# Uso de conectores de acción rápida en las imágenes del tablero
<a name="action-connectors-in-dashboard-visuals"></a>

## Requisitos previos
<a name="action-connectors-in-dashboards-prerequisites"></a>

Antes de empezar, asegúrese de [crear al menos un conector de acción](builtin-services-integration.md).

El conector debe cumplir los siguientes requisitos:
+ Utiliza el **método de autenticación de usuario**
+ Utiliza una de las siguientes integraciones:
  + Atlassian Jira Cloud
  + Microsoft Outlook
  + Microsoft Teams
  + Salesforce
  + ServiceNow
  + Slack

## Activa las acciones rápidas en un panel de control para usar los conectores de acciones
<a name="enable-quick-actions-on-dashboards"></a>

**Para habilitar las acciones rápidas en un panel, utilice conectores de acciones**

1. Si existe un cuadro de mando, vaya al análisis de origen del cuadro de mando. De lo contrario, [cree un análisis nuevo](quickstart-createanalysis.md).

1. Elija **Publicar**.

1. Elija entre **Nuevo panel** o **Reemplazar panel existente**.

1. Seleccione la casilla **Habilitar acciones rápidas** en las **opciones del panel** de control.

1. Elija **Publicar panel**.

## Utilice los conectores de acción de forma visual
<a name="use-action-connectors-on-visuals"></a>

**Para usar conectores de acción en un elemento visual**

1. Abra un panel con la opción **Habilitar la publicación de acciones rápidas** activada.

1. Coloca el cursor sobre un elemento visual.

1. Selecciona el icono del relámpago.

1. Aparece un menú con una lista de todos los conectores de acción y acciones compatibles.

1. Seleccione la acción que desee de la lista.

1. Si no ha utilizado el conector anteriormente o si sus credenciales de inicio de sesión anteriores han caducado, aparecerá un modo de autenticación. Inicie sesión con las credenciales adecuadas para su organización.

1. Aparece un formulario de **acción** en el panel derecho.

1. Introduce toda la información que necesitas incluir en la acción.

1. Algunos campos permiten incluir valores de relleno automático. Seleccione **Autocompletar** para abrir el menú. Elija los valores que necesite y se añadirán al texto introducido.
   + **Fecha de hoy**: Inyecta la fecha de hoy
   + **Nombre visual**: Inyecta un nombre visual
   + **Todos**: Inyecta las dos opciones anteriores

1. Algunas acciones respaldan la posibilidad de incluir un archivo adjunto. Si lo desea, puede adjuntar una imagen del elemento visual con estas acciones seleccionando la casilla **Imagen visual**.

1. Seleccione el botón de acción situado en la parte inferior del formulario para invocar la acción.

## Seguridad y personalizaciones
<a name="dashboard-security-and-customizations"></a>

**Personalización personalizada Permissions/Capability **
+ Capacidad de **acciones**: no puede ver ni usar acciones si su usuario o rol tiene restringido el permiso para usar la capacidad de acciones

Para obtener más información sobre los permisos personalizados, consulte [Crear un perfil de permisos personalizado en Amazon Quick](create-custom-permissions-profile.md).

**Seguridad a nivel de fila (RLS) /Seguridad a nivel de columna (CLS)**
+ No puede ver ni usar acciones en imágenes que estén basadas en conjuntos de datos que usen RLS o CLS.

Para obtener más información sobre el RLS, consulte [Uso de la seguridad a nivel de fila en Amazon Quick](row-level-security.md).

Para obtener más información sobre el CLS, consulte [Uso de la seguridad a nivel de columna para restringir el acceso a](row-level-security.md) un conjunto de datos.

**Opciones de publicación del panel**
+ Habilite las acciones rápidas
  + No puede ver ni usar acciones en ningún elemento visual de un panel que se haya publicado con la opción **Habilitar la publicación de acciones rápidas** desactivada.

Para obtener más información sobre las opciones de publicación de los paneles, consulte [Publicar los paneles](creating-a-dashboard.md).

## Limitaciones
<a name="action-connectors-on-dashboard-limitations"></a>

**Compatibilidad con archivos adjuntos de imágenes visuales**

Los siguientes tipos de imágenes no admiten archivos adjuntos de imágenes:
+ Gráficos altos (cuando se utiliza HTML)
+ ML Insights (cuando se utiliza HTML)
+ Cuadro de texto e información (cuando se utiliza HTML)
+ Contenido personalizado

**nota**  
En el caso de estas imágenes, la casilla de verificación **Imagen visual** no aparecerá en la interfaz de usuario.

# Compartir tu vista de un panel de Amazon Quick Sight
<a name="share-dashboard-view"></a>

Al interactuar con un panel publicado, puede optar por compartir un enlace único al panel con solo los cambios que haya hecho. Por ejemplo, si filtra los datos del panel, puede compartir lo que ve con otras personas que tengan permisos para ver el panel. De esta forma, podrán ver lo que usted ve, sin que tenga que crear un panel nuevo. 

Cuando otras personas accedan a su vista del panel mediante el enlace que les envió, verán el panel exactamente como estaba cuando se creó el enlace. Pueden ver todos los parámetros, filtros o controles que haya modificado.

**Uso compartido de la vista de un panel**

1. Abra el panel publicado y realice los cambios que desee.

1. Seleccione **Compartir** en la esquina superior derecha y, a continuación, seleccione **Compartir esta vista**.

1. En la página **Compartir mediante un enlace** que se abre, seleccione **Copiar enlace**.

1. Pegue el enlace en un correo electrónico o mensaje de mensajería instantánea para compartirlo con otras personas.

   Solo las personas con permisos para ver el panel de control en Quick Sight pueden acceder al enlace.

# Programar y enviar informes de Quick Sight por correo electrónico
<a name="sending-reports"></a>

**importante**  
Amazon Quick Sight en la región Europa (España) (eu-south-2) utiliza un servicio de correo electrónico interno (Amazon SES) en Europa (Irlanda) (eu-west-1) para enviar correos electrónicos a los usuarios de Quick Sight. Los datos de los clientes que se incluyen en los informes programados, las alertas y otras funciones se transmiten por correo electrónico desde Europa (España) a Europa (Irlanda) antes de que lleguen a los usuarios de Quick Sight.  
Como medida de protección de la privacidad, las siguientes características que envían datos de los clientes por correo electrónico están limitadas o desactivadas de forma predeterminada.  
Archivos adjuntos y vistas previas de hojas en correos electrónicos con informes programados. La [opción de enlace de descarga](https://docs.aws.amazon.com/quicksuite/latest/userguide/email-reports-from-dashboard) es la predeterminada.
Correos electrónicos que usan alertas de umbral.
Alertas de detección de anomalías.
Para obtener más información sobre las funciones AWS de privacidad, consulte [Características de privacidad de AWS los servicios](https://aws.amazon.com/compliance/privacy-features/).

En Enterprise Edition, puede enviar un panel en forma de informe, ya sea de manera única o de manera programada (diaria, semanal, mensual o anual). Puedes enviar los informes por correo electrónico a los usuarios o grupos que comparten tu suscripción a Amazon Quick. Para recibir informes de correo electrónico, los usuarios o los miembros del grupo deben cumplir las condiciones siguientes: 
+ Forman parte de tu suscripción a Quick.
+ Ya ha compartido el panel con ellos.
+ Amazon Quick Sight no puede enviar correos electrónicos programados a más de 5000 miembros.

Amazon Quick Sight genera una instantánea de correo electrónico personalizada para cada usuario o grupo en función de sus permisos de datos, que se definen en el panel de control. La seguridad a nivel de fila (RLS), la seguridad a nivel de columna (CLS) y los parámetros dinámicos predeterminados para los informes de correo electrónico funcionan tanto para los correos programados como para los ad hoc (únicos). 

Los autores de Quick pueden ejecutar informes programados con el botón **Reportar ahora** de la consola Quick o con la [https://docs.aws.amazon.com//quicksight/latest/APIReference/API_StartDashboardSnapshotJobSchedule.html](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_StartDashboardSnapshotJobSchedule.html)API.

Los suscriptores que son lectores ven una opción para **Informes** en el panel cuando un informe de correo electrónico está disponible para ese panel. Pueden utilizar el menú **Programaciones** para suscribirse o cancelar la suscripción a los mensajes de correo electrónico. Para obtener más información, consulte [Suscribirse a informes por correo electrónico en Amazon Quick Sight](subscribing-to-reports.md).

Puede crear un máximo de cinco programaciones para cada panel.

Los usuarios del panel de Quick Sight también pueden programar sus propios informes desde un panel de Quick Sight. Para obtener más información sobre los informes generados por lectores, consulte [Creación de un informe generado por un lector en Amazon Quick Sight](reader-scheduling.md).

Consulte los siguientes temas para obtener más información sobre la configuración de informes de correo electrónico y la facturación de informes. 

**Topics**
+ [Configuración de los ajustes de los informes de correo electrónico para un panel de Quick Sight](email-reports-from-dashboard.md)
+ [Cómo funciona la facturación de informes de correo electrónico](sending-reports-billing-info.md)

# Configuración de los ajustes de los informes de correo electrónico para un panel de Quick Sight
<a name="email-reports-from-dashboard"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

En la edición Amazon Quick Enterprise, puedes enviar un informe por correo electrónico desde cualquier hoja de un panel de control. Puede enviar informes desde paneles interactivos y hojas de informes con píxeles perfectos. Las programaciones incluyen la configuración de cuándo enviarlos, el contenido que se debe incluir y quién recibe el correo electrónico. Puede ver un ejemplo de informe y una lista de los conjuntos de datos utilizados en el informe. Para configurar o cambiar la programación enviada desde un panel, asegúrese de ser el propietario o copropietario.

Si tiene acceso al panel, puede cambiar las opciones de suscripción al abrir la vista del panel. Para obtener más información sobre cómo funciona, consulte [Suscribirse a informes por correo electrónico en Amazon Quick Sight](subscribing-to-reports.md).

Las opciones de programación que están disponibles para un informe de correo electrónico incluyen las siguientes:
+ **Una vez (no repetir)**: envía el informe solo una vez en la fecha y hora que elija.
+ **Diariamente**: se repite todos los días a la hora que elija.
+ **Semanalmente**: se repite cada semana el mismo día o días a la hora que elija. También puede usar esta opción para enviar informes en intervalos semanales, por ejemplo, cada dos o tres semanas.
+ **Mensualmente**: se repite cada mes el mismo día, a la hora que elija. También puede usar esta opción para enviar informes en días específicos del mes, como el segundo miércoles o el último viernes de cada mes.
+ **Anualmente**: se repite cada año el mismo día del mes o meses seleccionados, a la hora que elija. También puede usar esta opción para enviar informes en días o conjuntos de días específicos en meses seleccionados. Por ejemplo, puede configurar un informe para que se envíe el primer lunes de enero, marzo y septiembre, o el 14 de julio, o el segundo día de febrero, abril y junio de cada año.
+ **Personalizado**: configure su propio informe programado que mejor se adapte a las necesidades de su empresa.

Puede personalizar el título del informe, el asunto opcional del correo electrónico y el cuerpo de texto.

Si bien puede configurar el informe para que todos los que tengan acceso reciban una copia, este no suele ser el mejor plan. Recomendamos limitar los correos electrónicos automatizados, especialmente los que se envían a grupos. Puede empezar con un número reducido de suscriptores. Para ello, elija personas específicas de la lista de acceso. Verifique la política de su empresa antes de suscribir a alguien a una suscripción. 

Puede añadir personas directamente a una suscripción a un informe de las siguientes maneras:
+ (Recomendado) Elija destinatarios de la lista de acceso proporcionada para especificar y mantener una lista de personas a las que desea enviar informes de correo electrónico. Puede utilizar el cuadro de búsqueda para encontrar a las personas por correo electrónico o nombre del grupo.
+ Para enviar informes a todos los suscriptores del panel, seleccione **Enviar un informe por correo electrónico a todos los usuarios con acceso al panel** cuando se pida. 

Cualquier otra persona que desee recibir los correos electrónicos puede abrir el panel y configurar sus propias opciones de suscripción para participar o excluirse. 

**importante**  
Cuando compartes el panel con nuevos grupos o nombres de usuario de Quick, estos comenzarán a recibir automáticamente los informes por correo electrónico. Si no quiere que esto suceda, tendrá que editar la configuración del informe cada vez que añada personas al panel. 

Para las programaciones de correo electrónico existentes, puede pausar la programación en Amazon Quick Sight mientras realiza cambios. En el panel **Programaciones**, puede pausar o reanudar un informe programado con la tecla que aparece debajo de cada informe. Al pausar un informe no se elimina la programación del informe de Quick Sight.

Si su informe incluye elementos visuales personalizados, tenga en cuenta que no puede incluir imágenes de una red privada en un informe por correo electrónico, incluso si puede acceder a las imágenes. Si desea incluir una imagen, utilice una que esté disponible públicamente.

Antes de empezar, asegúrese de utilizar la edición Amazon Quick Enterprise y de haber compartido el panel con los destinatarios previstos. 

**Creación o cambio de un informe de correo electrónico**

1. Abre Quick y selecciona **Paneles** de control en el panel de navegación de la izquierda.

1. Abra un panel para configurar su informe de correo electrónico. 

1. En la parte superior derecha, seleccione **Programaciones** y, a continuación, seleccione **Programaciones**.

1. Elija **AGREGAR PROGRAMACIÓN**.

1. En el panel **Nueva programación** que aparece, introduzca el nombre de la programación. También puede optar por agregar una descripción para la nueva programación.

1. En la pestaña **Contenido**, active los interruptores **PDF**, **CSV** o **Excel** para elegir el formato del informe. Actualmente, los formatos CSV y Excel son compatibles con los informes con píxeles perfectos.

1. En el menú desplegable **Hoja** de la pestaña **Contenido**, elija la hoja para la que desea programar un informe.

   Si elige **CSV** o **Excel**, elija los elementos visuales de la tabla o tabla dinámica de cualquier hoja del panel que desee incluir en el informe. Puede seleccionar hasta 5 elementos visuales para cada programación.

   Si elige **Excel**, se generará un libro de Excel como resultado final.

1. En la pestaña **Fechas**, elija la frecuencia del informe en el menú desplegable **Repetir**. Si tiene dudas, seleccione **Enviar una vez (no repetir)**.

1. En **Fecha de inicio**, elija la fecha de inicio y el tiempo de ejecución en los que quiere enviar el primer informe.

1. En **Zona horaria**, seleccione la zona horaria en el menú desplegable.

1. En la pestaña **Correo electrónico**, en **Línea de asunto del correo electrónico**, introduzca una línea de asunto personalizada o déjela en blanco para usar el título del informe.

1. Introduzca las direcciones de correo electrónico del nombre del grupo rápido de los usuarios o grupos que desee que reciban el informe. También puede seleccionar la casilla **Enviar a todos los usuarios con acceso** para enviar el informe a todas las personas que tengan acceso al panel de su cuenta.

1. En **Encabezado del correo electrónico**, introduzca el encabezado que quiere que muestre el informe del correo electrónico.

1. (Opcional) En **Cuerpo del correo electrónico**, déjelo en blanco o introduzca un mensaje personalizado para que aparezca al principio del correo electrónico.

1. (Opcional) En el caso de los archivos adjuntos en PDF, puede seleccionar **Incluir la hoja en el cuerpo del correo electrónico** para que aparezca la primera página de la instantánea en PDF en el cuerpo del correo electrónico.

1. Elija el método de adjunto que desea que utilice el informe. Están disponibles las siguientes opciones.
   + **Archivo adjunto**: carga un archivo adjunto de la instantánea al correo electrónico. El tamaño del correo electrónico no puede ser superior a 10 MB. Este límite incluye todos los archivos adjuntos.
   + **Enlace de descarga**: añade un enlace al cuerpo del correo electrónico al que los usuarios pueden acceder para descargar el informe instantáneo. Cuando un usuario elige el enlace de descarga, se le pide que inicie sesión antes de que el informe comience a descargarse. El enlace caduca un año después del envío del informe.

1. (Opcional, recomendado) Para enviar una muestra del informe antes de guardar los cambios, seleccione **Enviar informe de prueba**. Esta opción aparece junto al nombre de usuario del propietario del panel.

1. Realice una de las siguientes acciones: 
   + (Recomendado) Seleccione **Guardar** para confirmar las entradas.
   + Para enviar un informe de forma inmediata, seleccione **Guardar y ejecutar ahora**. El informe se envía inmediatamente, incluso si la fecha de inicio de su programación es futura.

# Cómo funciona la facturación de informes de correo electrónico
<a name="sending-reports-billing-info"></a>

Los autores y los administradores pueden recibir cualquier número de informes de correo electrónico sin cargo adicional.

Para los lectores (usuarios con función de lector), cuesta una sesión por informe, hasta el máximo mensual. Tras recibir un informe de correo electrónico, el lector obtiene crédito de una sesión para obtener acceso al panel sin costo adicional durante el mismo mes. Los créditos de sesión de lector no se conservan al siguiente mes de facturación. 

Para un lector, los cargos de informes de correo electrónico y sesiones interactivas se acumulan hasta el cargo máximo mensual. Para los lectores que alcancen el cargo máximo mensual, no hay cargos adicionales y pueden recibir tantos informes de correo electrónico adicionales como necesiten. 

# Suscribirse a informes por correo electrónico en Amazon Quick Sight
<a name="subscribing-to-reports"></a>

En la edición Enterprise, los autores de Amazon Quick pueden configurar suscripciones a un panel de control en forma de informe. Para obtener más información, consulte [Programar y enviar informes de Quick Sight por correo electrónico](sending-reports.md). A continuación, los lectores y autores de Quick pueden suscribirse a un panel y ajustar la configuración de sus informes. Para obtener más información acerca de la suscripción a paneles como lector, consulte [Suscribirse a los correos electrónicos y alertas del panel de control de Amazon Quick Sight](subscriber-alerts.md).

Utilice el siguiente procedimiento para cambiar su suscripción y notificar la configuración de un panel específico.

1. En primer lugar, abra un panel que se comparta con usted o un panel del que sea propietario o copropietario.

1. Elija el icono **Informes** en la parte superior derecha.

1. Aparece la pantalla **Cambiar las preferencias del informe**. En esta pantalla, se muestra el informe actual de programación, además de la suscripción y las opciones de optimización.

   En **Suscripción**, seleccione **Suscribirse** para empezar a recibir informes, o **Cancelar la suscripción** para dejar de recibir informes.

   En **Optimizar**, elija el dispositivo en el que prefiera ver el informe. 
   + Si suele utilizar un dispositivo móvil o prefiere ver los informes en formato vertical, elija **Ver en un dispositivo móvil**. Cuando reciba el informe, los elementos visuales se mostrarán en una única columna vertical. 
   + Si suele utilizar un dispositivo de escritorio o prefiere ver los informes en formato horizontal, elija **Ver en un dispositivo de escritorio**. Cuando reciba el informe, los elementos visuales se mostrarán en el mismo diseño en el que se muestran en su panel en su escritorio.

1. Elija **Actualizar** para confirmar sus opciones o en **Cancelar** para descartar los cambios.

# Uso de alertas de umbral en Amazon Quick Sight
<a name="threshold-alerts"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

Para mantenerse informado sobre los cambios importantes en sus datos, puede crear alertas de umbral utilizando imágenes de KPI, indicadores, tablas y tablas dinámicas en un panel de Amazon Quick Sight. Con estas alertas, puede establecer umbrales para sus datos y recibir una notificación por correo electrónico cuando sus datos los superen. También puede ver y gestionar sus alertas en cualquier momento en un navegador web compatible con Quick Sight.

Por ejemplo, supongamos que usted es customer sucess manager para una organización grande y desea saber cuándo la cantidad de tiques en una cola de soporte excede un número determinado. Digamos también que tiene un panel con un elemento visual de KPI, indicador, tabla o tabla dinámica que realiza un seguimiento del número de tiques en esta cola. En este caso, puede crear una alerta y recibir una notificación por correo electrónico cuando el número supere el umbral que especificó. De esta forma, podrá tomar medidas en cuanto reciba la notificación.

Puede crear varias alertas para un solo elemento visual. Si el autor actualiza o elimina el elemento visual después de crear una alerta, la configuración de la alerta no cambiará. Al crear una alerta, esta adopta todos los filtros que se hayan aplicado al elemento visual en ese momento. Si usted o el autor cambian el filtro, la alerta existente no cambia. Sin embargo, si crea una alerta nueva, esta adoptará la nueva configuración del filtro.

Por ejemplo, supongamos que tiene un panel con un control de filtro que puede usar para cambiar los datos de cada elemento visual del panel de una ciudad de EE. UU. a otra. Tiene un elemento visual de KPI en el panel que muestra la media de los retrasos de los vuelos, y le interesan los retrasos de los vuelos que salen de Seattle (Washington, EE. UU.). Usted cambia el control del filtro a Seattle y establece una alerta en el elemento visual. Esta alerta realiza un seguimiento de los retrasos en los vuelos desde Seattle. Supongamos que mañana también quiere hacer un seguimiento de los retrasos de los vuelos desde Portland (Oregón), así que cambia el control del filtro a Portland y crea otra alerta. Esta nueva alerta realiza un seguimiento los retrasos de los vuelos desde Portland. Ahora tiene dos alertas, una en Seattle y otra en Portland, que funcionan de forma independiente.

Las alertas de umbral no están disponibles en la región de `eu-central-2` Europa (Zúrich).

Para obtener más información sobre los elementos visuales de KPI, indicador, tablas o tablas dinámicas, consulte [Tipos visuales en Amazon Quick Sight](working-with-visual-types.md).

**nota**  
No puedes crear alertas para imágenes en un panel integrado ni desde la aplicación móvil Quick.  
Para los elementos visuales de tablas, no se pueden crear alertas de umbral para valores que se encuentren en el cuadro de campo `Group by`. Las alertas solo se pueden crear para valores que estén ubicados en el cuadro de campo `Value`.  
Los elementos visuales de KPI que no utilizan un campo de fecha y hora como tendencia no admiten alertas. Un ejemplo es un KPI que muestra la diferencia en los vuelos entre las compañías aéreas X e Y, en lugar de un KPI que muestra la diferencia en los vuelos entre las fechas A y B. 

Usa las siguientes secciones para crear y configurar alertas de umbral para imágenes de KPI, indicador, tabla y tabla dinámica en Quick Sight.

**Topics**
+ [Permisos de alertas](threshold-alerts-permissions.md)
+ [Creación de alertas](threshold-alerts-creating.md)
+ [Administración de alertas de umbral](threshold-alerts-managing.md)
+ [Investigación de los errores de las alertas](threshold-alerts-failures.md)
+ [Programación de alertas](threshold-alerts-scheduling.md)
+ [Uso de conectores de acción rápida en las alertas de umbral](action-connectors-in-threshold-alerts.md)

# Permisos de alertas
<a name="threshold-alerts-permissions"></a>

Si es administrador, puede controlar qué miembros de su organización pueden establecer alertas de umbral en Quick Sight mediante la creación de una política de permisos personalizada. Para configurar permisos personalizados en Quick, elija su nombre de usuario en la esquina superior derecha de cualquier página de Quick, elija **Administrar** rápidamente y, a continuación, elija Permisos **personalizados**.

# Creación de alertas
<a name="threshold-alerts-creating"></a>

Utilice el siguiente procedimiento para crear alertas de umbral para elementos visuales de KPI o indicador en un panel.

**Creación de una alerta**

1. Abre Quick y navega hasta el panel de control que desees.

   Para obtener más información sobre cómo ver los paneles de control como suscriptor de paneles en Quick, consulte[Interacción con los paneles de Amazon Quick Sight](exploring-dashboards.md).

1. En el panel, seleccione el elemento visual para el que desee crear una alerta, abra el menú de la parte superior derecha y elija **Crear alerta**.

1. En el menú de la parte superior derecha del elemento visual, seleccione el icono **Crear alerta**.

   Como alternativa, puede elegir el icono de alerta en la barra de herramientas azul situada en la esquina superior derecha. A continuación, en la página **Crear alerta** que se abre, seleccione el elemento visual del KPI, indicador, tabla o tabla dinámica para el que desee crear una alerta y, a continuación, seleccione **Siguiente**.

   También puede crear alertas en elementos visuales de tablas o tablas dinámicas al seleccionar una celda y elegir **Crear alerta**. Solo puede crear alertas para celdas individuales. No se pueden crear alertas para columnas enteras ni para valores que usen una agregación personalizada. Para obtener más información acerca de las agregaciones personalizadas, consulte [Funciones de agregación](calculated-field-aggregations.md).

1. En la página **Crear alerta** que se abre a la derecha, haga lo siguiente:

   1. En **Nombre**, escriba un nombre para la alerta.

      De forma predeterminada, se usa el nombre del elemento visual para denominar la alerta. Si lo desea, puede cambiarlo.

   1. En **Valor del que se va a hacer un seguimiento**, elija un valor para el que desee establecer el umbral. La información presentada variará según el tipo de elemento visual para el que esté creando una alerta.

      Los valores disponibles para esta opción se basan en los valores que el autor del panel establece en el elemento visual. Por ejemplo, supongamos que tiene un elemento visual de KPI que muestra una diferencia de porcentaje entre dos fechas. En ese caso, verá dos opciones de valores de alerta: diferencia porcentual y real.

      Si solo hay un valor en el elemento visual, no puede cambiar esta opción. Es el valor actual y se muestra aquí para que pueda usarlo como referencia al elegir un umbral. Por ejemplo, si establece una alerta sobre el costo medio, este valor le mostrará cuál es el costo medio actual (por ejemplo, 5 USD). Con este valor de referencia, puede tomar decisiones más informadas y, al mismo tiempo, establecer el umbral.

   1. En **Condición**, elija una condición para el umbral. 

      Puede escoger las condiciones siguientes.
      + **Es superior**: establece una regla que la alerta activa si el valor de la alerta supera el umbral establecido.
      + **Es inferior**: establece una regla que la alerta activa si el valor de la alerta es inferior al umbral establecido.
      + **Es igual a**: establece una regla que la alerta activa si el valor de la alerta es igual al umbral establecido.

   1. En **Umbral**, introduzca un valor para generar la alerta.

   1. En **Preferencia de notificación**, elija la frecuencia con la que desea que se le notifique si se infringe el umbral establecido.

      Puede elegir entre las siguientes opciones.
      + **Con la mayor frecuencia posible**: esta opción le avisa cada vez que se supera el umbral. Si elige esta opción, es posible que reciba alertas varias veces al día.
      + **A diario como máximo**: esta opción le avisa una vez al día cuando se supera el límite.
      + **Semanal como máximo**: esta opción le avisa una vez por semana cuando se supera el umbral.

   1. (Opcional) Seleccione **Enviadme un correo electrónico cuando no haya datos**: al seleccionar esta opción, recibirá una notificación cuando no haya datos para comprobar su regla de alertas.

   1. Seleccione **Guardar**.

      Aparece un mensaje en la parte superior derecha que indica que la alerta se ha guardado. Si tus datos superan el umbral que has establecido, recibirás una notificación por correo electrónico en la dirección asociada a tu cuenta de Quick. 

# Administración de alertas de umbral
<a name="threshold-alerts-managing"></a>

Puede editar las alertas existentes, activarlas o desactivarlas, o ver el historial de las veces en que se activó la alerta. Para ello, siga el procedimiento que se indica a continuación.

**Edición de una alerta existente**

1. Abra Rápido, elija **Paneles** y, a continuación, navegue hasta el panel para el que desee editar una alerta.

1. En la página de paneles, seleccione **Alertas** en la parte superior derecha.

1. En la página **Administrar alertas** que se abre, busque la alerta que desea editar y, a continuación, seleccione **Editar** debajo del nombre de la alerta.

   Puede editar el nombre, la condición y el umbral de la alerta.

1. Seleccione **Save**.

**Visualización del historial de cuándo se activó una alerta**

1. Abre Quick, selecciona **Paneles** y, a continuación, navega hasta el panel en el que deseas ver el historial de alertas.

1. En la página de paneles, seleccione **Alertas** en la parte superior derecha.

1. En la página **Administrar alertas** que se abre, busque la alerta cuyo historial desee ver y, a continuación, seleccione **Historial** debajo del nombre de la alerta.

**Habilitación o deshabilitación de una alerta existente**

1. Abre Quick, selecciona **Paneles** y navega hasta el panel en el que deseas activar o desactivar una alerta.

1. En la página de paneles, seleccione **Alertas** en la parte superior derecha.

1. En la página **Administrar alertas** que se abre, busque la alerta que desee habilitar o deshabilitar y, a continuación, active o desactive la casilla situada junto al nombre de la alerta.

   La alerta se activa cuando el conmutador está en azul y se desactiva cuando el conmutador está en gris.

**Eliminación de una alerta existente**

1. Abre Quick, selecciona **Paneles** y navega hasta el panel del que deseas eliminar una alerta.

1. En la página de paneles, seleccione **Alertas** en la parte superior derecha.

1. En la página **Administrar alertas** que se abre, busqur la alerta que quiera activar o desactivar, seleccione el menú de tres puntos situado junto a la alerta y, a continuación, seleccione **Eliminar** en el menú desplegable.

# Investigación de los errores de las alertas
<a name="threshold-alerts-failures"></a>

Cuando se produce un error en una alerta, Quick le envía una notificación por correo electrónico sobre el error. Las alertas pueden fallar por muchos motivos, incluidos los siguientes:
+ El conjunto de datos que utiliza la alerta se eliminó.
+ El propietario de la alerta perdió los permisos del conjunto de datos o de determinadas filas o columnas del conjunto de datos.
+ El propietario de la alerta perdió el acceso al panel.
+ No hay datos para los datos de los que la alerta realiza un seguimiento.

Cuando se produce un error, Quick le envía una notificación y desactiva la alerta si no es probable que se haya solucionado el motivo del error. Por ejemplo, si se produce un error en la alerta debido a la pérdida de acceso a un panel o si se eliminó el panel. De lo contrario, Quick volverá a intentar comprobar si sus datos han infringido los umbrales. Tras cuatro errores, Quick desactiva la alerta y le notifica que está desactivada. Si se puede volver a comprobar la alerta, Quick le enviará una notificación.

Para averiguar por qué se ha producido un error en una alerta, compruebe que todavía tiene acceso al panel. Compruebe también que tiene permisos para acceder al conjunto de datos correcto y a las filas y columnas correctas del conjunto de datos. Si ha perdido el acceso o los permisos, póngase en contacto con el propietario del panel. Si tiene el acceso y los permisos necesarios, es posible que deba editar la alerta para evitar que se produzcan errores en futuras alertas.

# Programación de alertas
<a name="threshold-alerts-scheduling"></a>

Cuando crea una alerta, Quick comprueba sus datos para detectar cualquier infracción con respecto a los umbrales que haya establecido en función de la fecha programada para la actualización de su conjunto de datos. La información que se presenta en la alerta varía según el tipo de elemento visual para el que esté creando una alerta. En el caso de los conjuntos de datos de SPICE, las reglas de alerta se comprueban tras una actualización correcta del conjunto de datos de SPICE. En el caso de los conjuntos de datos de consulta directa, las reglas de alerta se comprueban de forma aleatoria, entre las 18:00 y las 8:00 horas, en el lugar Región de AWS que contiene el conjunto de datos de forma predeterminada.

Si usted es propietario de un conjunto de datos, puede establecer una programación de evaluación de alertas en la configuración del conjunto de datos. Consulte el siguiente procedimiento para aprender a hacerlo.

**Establecimiento de una programación de evaluación de alertas de un conjunto de datos**

1. En Rápido, selecciona **Datos** en la barra de navegación de la izquierda.

1. Elija el conjunto de datos para el que desea programar las evaluaciones de alertas.

1. Elija **Establecer la programación de alertas**.

1. En la página **Establecer la programación de alertas** que se abre, haga lo siguiente.
   + Para **Zona horaria**, elija una zona horaria.
   + En **Repeticiones**, elija la frecuencia con la que desea que se evalúen los datos.
   + En **Inicia**, introduzca la hora a la que desea que comience la evaluación de la alerta.

# Uso de conectores de acción rápida en las alertas de umbral
<a name="action-connectors-in-threshold-alerts"></a>

## Requisitos previos
<a name="action-connectors-in-threshold-alerts-prerequisites"></a>

Antes de empezar, asegúrese de [crear al menos un conector de acción](builtin-services-integration.md).

El conector debe cumplir los siguientes requisitos:
+ Utiliza el método **de autenticación Service Auth**
+ Utiliza una de las siguientes integraciones:
  + Atlassian Jira Cloud
  + Microsoft Outlook
  + Salesforce
  + ServiceNow

## Activa las acciones rápidas en un panel de control para usar los conectores de acciones
<a name="enable-quick-actions-on-dashboards-for-threshold-alert"></a>

**Para habilitar las acciones rápidas en un panel, utilice conectores de acciones**

1. Si existe un cuadro de mando, vaya al análisis de origen del cuadro de mando. De lo contrario, [cree un análisis nuevo](quickstart-createanalysis.md).

1. Elija **Publicar**.

1. Elija entre **Nuevo panel** o **Reemplazar panel existente**.

1. Seleccione la casilla de verificación **Habilitar acciones rápidas** en las **opciones del panel** de control.

1. Elija **Publicar panel**.

## Utilice conectores de acción en una alerta de umbral
<a name="use-action-connectors-in-threshold-alert"></a>

**Para usar conectores de acción en una alerta de umbral**

1. Abra un panel con la opción **Habilitar la publicación de acciones rápidas** activada.

1. Coloca el cursor sobre un elemento visual que admita las alertas de umbral. [Los tipos de imágenes que admiten las alertas se encuentran aquí.](threshold-alerts.md)

1. Selecciona el icono de la campana.

1. El panel **Crear alertas** se abre a la derecha.

1. Elija **Añadir acción**.

1. Aparece un menú con una lista de todos los conectores de acciones y acciones compatibles.

1. Seleccione la acción que desee de la lista.

1. Aparece un formulario de **acción** en el panel derecho.

1. Introduce toda la información que necesitas incluir en la acción.

1. Algunos campos permiten incluir valores de relleno automático. Seleccione **Autocompletar** para abrir el menú. Elija los valores que necesite y se añadirán al texto introducido.
   + **Valor**: inyecta el valor actual que utilizó la alerta para evaluar el estado de la alerta
   + **Nombre de la alerta**: inyecta el nombre de la alerta
   + **Condición**: inyecta la condición de alerta
   + **Umbral**: inyecta el valor umbral
   + **Todo**: inyecta todo lo anterior

1. Algunas acciones respaldan la posibilidad de incluir un archivo adjunto. Si lo desea, puede adjuntar un PDF de la hoja de cuadro de mando actual con estas acciones; para ello, active la casilla de verificación **Incluir esta hoja como PDF**.

1. Seleccione **Añadir acción** para añadir la acción a la alerta.

1. Al volver al panel **Crear alerta**, la acción configurada se añade a la alerta de la parte inferior.

1. Configure todos los demás campos de la alerta que desee y seleccione **Guardar**.

1. Cuando se supere el umbral configurado, se debe invocar esta acción. Para obtener más información sobre cuándo se evalúa una alerta de umbral, consulte [Programación de alertas](threshold-alerts-scheduling.md).

## Seguridad y personalizaciones
<a name="threshold-alert-security-and-customizations"></a>

**Personalización personalizada Permissions/Capability **
+ Capacidad de **acciones**: no puede ver ni usar acciones si su usuario o rol tiene restringido el permiso para usar la capacidad de acciones
+ Capacidad **de exportación a PDF**:
  + Nuevas acciones en las alertas: no verá la opción de adjuntar un PDF de la hoja al añadir una nueva acción a una alerta si su usuario o función tiene restringido el permiso para utilizar la función **Exportar a PDF**.
  + Acciones existentes en relación con las alertas: si tiene alertas existentes con acciones que contienen archivos adjuntos en PDF, esas acciones se enviarán sin los archivos adjuntos en PDF cuando su usuario o rol no pueda utilizar la función **Exportar a PDF**.

Para obtener más información sobre los permisos personalizados, consulte [Crear un perfil de permisos personalizado en Amazon Quick](create-custom-permissions-profile.md).

**Seguridad a nivel de fila (RLS) /Seguridad a nivel de columna (CLS)**
+ Nuevas acciones en las alertas: si su panel de control contiene un conjunto de datos con RLS o CLS, entonces
  + No puedes añadir acciones a las alertas nuevas que rastrean el conjunto de datos con RLS o CLS
  + Puedes añadir acciones a las alertas nuevas que rastrean un conjunto de datos diferente sin RLS ni CLS, pero no puedes incluir archivos PDF adjuntos en estas acciones
+ Acciones existentes en las alertas: si añades RLS o CLS a un conjunto de datos después de crear alertas con acciones,
  + Las acciones existentes en las alertas que rastrean ese conjunto de datos dejarán de funcionar por completo
  + Las acciones existentes relacionadas con las alertas que rastrean un conjunto de datos diferente en el mismo panel se enviarán sin ningún archivo PDF adjunto

Para obtener más información sobre el RLS, consulte [Uso de la seguridad a nivel de fila en Amazon Quick](row-level-security.md).

Para obtener más información sobre el CLS, consulte [Uso de la seguridad a nivel de columna para restringir el acceso a](row-level-security.md) un conjunto de datos.

**Opciones de publicación del panel**
+ Habilite la generación de PDF para hojas interactivas
  + Nuevas acciones en las alertas: si su panel de control tiene desactivada la opción **Habilitar la generación de PDF para la publicación de hojas interactivas, no verá la opción de adjuntar un PDF** de la hoja y añadir una nueva acción a la alerta.
  + Acciones existentes en relación con las alertas: si tiene alertas existentes con acciones que contienen archivos adjuntos en PDF, esas acciones se enviarán sin los archivos adjuntos en PDF cuando la opción **Habilitar la generación de PDF para la publicación de hojas interactivas** esté desactivada en su panel de control.
+ Activa las acciones rápidas
  + Acciones nuevas en las alertas: no verá la opción de añadir una acción a la alerta si su panel de control tiene desactivada la opción **Habilitar la publicación de acciones rápidas**.
  + Acciones existentes en las alertas: tus acciones actuales en las alertas dejarán de funcionar por completo cuando la opción **Habilitar la publicación de acciones rápidas** se desactive en tu panel de control.

Para obtener más información sobre las opciones de publicación de los paneles, consulte [Publicar los paneles](creating-a-dashboard.md).

# Impresión de un panel o análisis
<a name="printing1"></a>

Puede imprimir un panel o un análisis en Amazon Quick Sight. 

Utilice el siguiente procedimiento para imprimir.

1. Abra el panel o el análisis que desee imprimir.

1. Elija el icono **Imprimir** en la parte superior derecha.

1. En la pantalla **Preparar para la impresión**, elija el tamaño y la orientación del papel que desee utilizar.

1. Elija **Ir a la vista previa**. 

1. Realice una de las siguientes acciones:
   + Para continuar con la impresión, elija **Imprimir** para abrir el cuadro de diálogo de impresión del sistema operativo.
   + Para realizar cambios en el tamaño o la orientación del papel, elija **Configurar**.

1. Para salir de la pantalla de vista previa, elija **Salir de vista previa**.

# Exportación de análisis o paneles de Amazon Quick Sight como PDFs
<a name="export-dashboard-to-pdf"></a>

Puede exportar el contenido de un panel a un archivo de formato de documento portátil (PDF). Al igual que una copia impresa, este formato proporciona una instantánea de la hoja actual tal y como aparece en pantalla en el momento de la descarga. 

**Exportación de una hoja de panel como PDF**

1. Abre Quick y selecciona **Paneles** de control en el panel de navegación de la izquierda.

1. Abra el panel que desee exportar.

1. En la esquina superior derecha, seleccione **Exportar** y **Descargar como PDF**. La descarga se prepara en segundo plano.

   Cuando el archivo esté listo para la descarga, aparecerá el mensaje **Su PDF está listo**. 

1. Seleccione **Descargar ahora** para descargar el archivo. Seleccione **Cerrar** para cerrar sin descargar.

   Si cierra este cuadro de diálogo sin descargar el archivo y desea volver a crearlo, repita el paso anterior. Además, el archivo descargable solo estará disponible temporalmente durante cinco minutos. Si espera demasiado para descargarlo, el archivo caducará. Si esto ocurre, Quick Sight muestra en su lugar un mensaje de error que indica que la solicitud ha caducado. 

1. Repita los pasos anteriores para cada hoja que desee exportar.

También puedes adjuntar informes por correo electrónico PDFs al panel de control. Para obtener más información, consulte [Programar y enviar informes de Quick Sight por correo electrónico](sending-reports.md).

# Códigos de error para trabajos de exportación en PDF fallidos
<a name="qs-reports-error-codes"></a>

Al generar informes en PDF en Amazon Quick Sight, es posible que se produzcan casos en los que no se pueda generar un informe en PDF. Existen muchos motivos por los que se puede producir un error. Quick Sight proporciona códigos de error que pueden ayudarle a entender por qué se ha producido el error y proporcionarle orientación para solucionar el problema. En la siguiente tabla se enumeran los códigos de error que Quick Sight devuelve cuando se produce un error en un trabajo de exportación a un PDF.


| Código de error | Indicaciones | 
| --- | --- | 
| INVALID\$1DATAPREP\$1SYNTAX | Compruebe la sintaxis de los campos calculados e inténtelo de nuevo. | 
| POST\$1AGGREGATED\$1METRIC\$1AS\$1DIMENSION |  metrics/operands Los agregados no se pueden usar como dimensiones de agrupamiento de elementos visuales. Elija las dimensiones de agrupación de un elemento visual válido e inténtelo de nuevo. | 
| SPICE\$1TABLE\$1NOT\$1FOUND | El conjunto de datos se ha eliminado o no está disponible. Importe un conjunto de datos válido e inténtelo de nuevo. | 
| FIELD\$1NOT\$1FOUND | Un campo ya no está disponible. Actualice o reemplace los campos que faltan en este conjunto de datos e inténtelo de nuevo. | 
| FIELD\$1ACCESS\$1DENIED | No tiene acceso a algunos campos de este conjunto de datos. Solicite acceso e inténtelo de nuevo.  | 
| PERMISSIONS\$1DATASET\$1INVALID\$1COLUMN\$1VALUE | Se ha encontrado un valor de columna de permiso de nivel de fila no válido. Compruebe las reglas del conjunto de datos principal e inténtelo de nuevo. | 
| COLUMN\$1NOT\$1FOUND | Sustituya las columnas que faltan en sus filtros o parámetros e inténtelo de nuevo. | 
| INVALID\$1COLUMN\$1TYPE | Los tipos de datos de algunos campos se han modificado y no se pueden actualizar automáticamente. Ajuste estos campos en el conjunto de datos e inténtelo de nuevo. | 
| PERMISSIONS\$1DATASET\$1USER\$1DENIED | No tiene acceso a este conjunto de datos. Solicite acceso a este conjunto de datos e inténtelo de nuevo. | 
| DATA\$1SOURCE\$1TIMEOUT | Se ha agotado el tiempo de espera de su consulta. Reduzca la cantidad de datos, o impórtelos a SPICE, e inténtelo de nuevo. | 
| MAX\$1PAGE\$1EXCEEDED\$1ERROR | El archivo está listo, pero el contenido no está completo. PDFs tienen un límite de 1000 páginas. Elija un PDF más corto e inténtelo de nuevo. | 
| INSUFICIENT\$1BODY\$1HEIGHT\$1ERROR | Ajuste el encabezado y el pie de página para que sean inferiores a la altura de la página e inténtelo de nuevo. | 
| FIRST\$1PAGE\$1HEIGHT\$1TOO\$1SMALL\$1ERROR | Ajuste las secciones para dejar espacio para las tablas e inténtelo de nuevo. | 
| INTERNAL\$1ERROR | Ahora mismo no podemos crear su PDF. Espere unos minutos e inténtelo de nuevo. | 

# Organización de los activos en carpetas para Amazon Quick Sight
<a name="folders"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

En la edición Quick Enterprise, los miembros de su equipo pueden crear carpetas personales y compartidas para añadir una estructura jerárquica a la gestión de activos de Quick Sight. Al utilizar las carpetas, las personas pueden organizar, explorar y descubrir paneles, análisis, conjuntos de datos, orígenes de datos y temas con mayor facilidad. Dentro de una carpeta, puede seguir utilizando las herramientas habituales para buscar activos o agregarlos a su lista de favoritos.

Puede usar los siguientes tipos de carpetas con Quick Sight:
+ Carpetas personales para organizar el trabajo por sí mismo. 

  Las carpetas personales solo son visibles para la persona que las posee. No puede transferir la propiedad de las carpetas personales a nadie más. 
+ Carpetas compartidas:
  + Las **carpetas compartidas** organizan el trabajo y simplifican el uso compartido entre varias personas. Para crear y administrar carpetas compartidas, debe ser administrador de Quick Sight.
  + Las **carpetas restringidas compartidas** son un tipo de carpeta compartida de Quick Sight que garantiza que los activos permanezcan en la carpeta compartida. Los activos que se crean a partir de activos que existen en una carpeta restringida compartida también deben permanecer en la carpeta restringida. Los activos que se encuentran en carpetas restringidas no se pueden mover ni compartir fuera de la carpeta restringida. Por ejemplo, si crea un conjunto de datos que utiliza un origen de datos ubicado en una carpeta restringida compartida, el nuevo conjunto de datos no se puede mover fuera de esa carpeta restringida compartida.

    Los activos que se encuentran en una carpeta restringida se pueden mover dentro del árbol de carpetas restringidas a una o más subcarpetas. Las subcarpetas de las carpetas restringidas se comportan como carpetas restringidas, pero los activos dependientes pueden estar en distintas subcarpetas de la misma carpeta restringida raíz. La carpeta restringida raíz actúa como un límite en el que pueden existir todos los activos de todas las subcarpetas siempre que permanezcan dentro del árbol de carpetas raíz. Por ejemplo, un conjunto de datos ubicado en una subcarpeta puede usar un origen de datos que esté ubicado en otra subcarpeta del mismo árbol de carpetas o en la carpeta raíz. Se puede crear cualquier tipo de activo compatible en una carpeta raíz o en cualquiera de sus subcarpetas. Los usuarios pueden tener diferentes roles en distintas subcarpetas. Los permisos de subcarpeta se heredan de las carpetas principales de esa subcarpeta.

    Las carpetas restringidas solo se pueden crear con la operación de la [https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html](https://aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html)API Quick Sight.
  + Los usuarios que visualizan una carpeta y tienen el rol de autor o administrador en Quick pueden ver todos los tipos de activos que hay en la carpeta. Los usuarios que visualizan una carpeta y tienen la función de lector en Quick solo pueden ver los paneles y las historias que estén en la carpeta.

  Todas las carpetas compartidas son visibles para las personas que tienen acceso a ellas.

Utilice los siguientes temas para obtener más información sobre cómo crear y configurar una carpeta o subcarpeta en Quick Sight.

**Topics**
+ [Consideraciones sobre las carpetas Quick Sight](folders-limitations.md)
+ [Descripción general de las carpetas Quick Sight](folders-functionality.md)
+ [Permisos para las carpetas compartidas de Quick Sight](folders-security.md)
+ [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md)
+ [Creación de carpetas escaladas de Quick Sight con Quick Sight APIs](folders-scaled.md)

# Consideraciones sobre las carpetas Quick Sight
<a name="folders-limitations"></a>

Antes de empezar a crear y modificar carpetas en Amazon Quick Sight, revise las siguientes limitaciones que se aplican a las carpetas de Quick Sight.
+ No puedes compartir carpetas de tu AWS cuenta con personas de otras cuentas Cuentas de AWS.
+ Para las personas que tienen permisos de lectura rápida, se aplican las siguientes limitaciones:
  + Los lectores no pueden ser propietarios de una carpeta personal o compartida.
  + Los lectores no pueden crear ni administrar carpetas ni su contenido. 
  + Los lectores no pueden tener el nivel de acceso de *colaborador*.
  + En las carpetas compartidas, los lectores solo pueden ver los activos del panel. 

Además, estas limitaciones se aplican específicamente a las carpetas compartidas:
+ El nombre de una carpeta compartida (en el nivel superior del árbol) debe ser único en tu AWS cuenta. 
+ En una sola carpeta, varios activos no pueden tener el mismo nombre. Por ejemplo, en la carpeta de nivel superior, no puede crear dos subcarpetas con el mismo nombre. En la misma carpeta, no puedes añadir dos activos con el mismo nombre, aunque tengan un activo diferente IDs. La ruta a cada activo se comporta como un nombre clave de Amazon S3. Debe ser único en tu AWS cuenta. 
+ Las carpetas compartidas restringidas solo se pueden crear con la CLI de Quick Sight.

Consulte [Descripción general de las carpetas Quick Sight](folders-functionality.md) para obtener más información sobre los distintos tipos de carpetas disponibles en Amazon Quick Sight.

# Descripción general de las carpetas Quick Sight
<a name="folders-functionality"></a>

En Quick Sight, puede crear carpetas personales y compartidas. También puede marcar como favoritas sus carpetas personales o compartidas para acceder rápidamente a ellas seleccionando el icono de favoritos (![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/favorite-icon.png)) situado junto a ellas. 

Puede hacer lo siguiente con las carpetas personales:
+ Cree subcarpetas.
+ Agregue activos a su carpeta, incluidos análisis, paneles, conjuntos de datos y orígenes de datos. Para agregar activos a una carpeta personal, ya debe tener acceso a los activos. Varios activos pueden tener el mismo nombre.

**Carpetas compartidas (sin restricciones)**

Los administradores rápidos pueden realizar las siguientes tareas con las carpetas compartidas.
+ Cree o elimine una carpeta compartida y las subcarpetas que contenga. Puede mover cualquiera de estas opciones dentro de la carpeta de nivel superior.
+ Agregue o elimine propietarios, colaboradores y espectadores. Al convertir a una persona en *propietaria* de la carpeta, le otorga la propiedad de todos los activos de la carpeta. Para obtener más información, consulte [Permisos para las carpetas compartidas de Quick Sight](folders-security.md).

En la siguiente tabla se resumen las acciones que un usuario de Quick puede realizar cuando trabaja con carpetas compartidas sin restricciones en función de su función.


****  

| Action | Propietario | Colaborador | Lector | 
| --- | --- | --- | --- | 
| Compartir un activo de una carpeta con los usuarios que no tengan acceso a la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Modificar los permisos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear activos en la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Modificar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Agregar un activo existente a una carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar un recurso de una carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Ver los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | 
| Crear activos descendentes fuera de la carpeta compartida que utilicen los activos que se encuentran en la carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1 | 
| Crear activos descendentes en la carpeta que utilicen los activos que se encuentran fuera de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Administrar permisos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Agregar los activos existentes a las subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear nuevos activos en subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar activos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 

\$1Se debe asignar al usuario un rol de administrador o autor para crear activos.

**Carpetas compartidas restringidas**

Las carpetas compartidas restringidas proporcionan un límite de seguridad adicional que restringe el uso compartido de datos fuera de la carpeta. Los administradores con los permisos de IAM adecuados pueden realizar las siguientes tareas con carpetas compartidas restringidas.
+ Las carpetas restringidas se pueden crear con la operación de la API `CreateFolder`. Para obtener más información sobre el funcionamiento de la `CreatFolder` API, consulte [CreateFolder](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateFolder.html).
+ El rol de colaborador se asigna a los usuarios que pueden crear y editar activos dentro de las carpetas restringidas. Los colaboradores no pueden administrar los permisos de la carpeta ni de los activos que se encuentran en la carpeta restringida.
+ Los administradores pueden asignar permisos de colaborador y espectador de la carpeta a los usuarios mediante la operación de la API `UpdateFolderPermissions`. Para obtener más información sobre el funcionamiento `UpdateFolderPermissions` de la API, consulte [UpdateFolderPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateFolderPermissions.html).

En la siguiente tabla se resumen las acciones que un usuario de Quick Sight puede realizar cuando trabaja con carpetas compartidas restringidas en función de su función.


****  

| Action | Colaborador | Lector | 
| --- | --- | --- | 
| Compartir un activo de una carpeta con los usuarios que no tengan acceso a la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Modificar los permisos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear activos en la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Modificar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Agregar un activo existente a una carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar un recurso de una carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Ver los activos de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | 
| Crear activos descendentes fuera de la carpeta compartida que utilicen los activos que se encuentran en la carpeta compartida | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear activos descendentes en la carpeta que utilicen los activos que se encuentran fuera de la carpeta | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Administración de permisos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Agregar los activos existentes a las subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Crear nuevos activos en subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 
| Eliminar activos de subcarpetas | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí | ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No | 

El rol de propietario no se admite en las carpetas compartidas restringidas.

Una vez que haya elegido el tipo de carpeta que mejor se adapte a su caso de uso, consulte [Permisos para las carpetas compartidas de Quick Sight](folders-security.md) y [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md) para crear carpetas y configurar los permisos de las carpetas.

# Permisos para las carpetas compartidas de Quick Sight
<a name="folders-security"></a>

Las carpetas compartidas tienen tres niveles de permisos. Para configurar los permisos a nivel de carpeta para un usuario o grupo, consulte [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md).
+ **Propietarios**: el *propietario* de la carpeta es el propietario de todo el contenido de la carpeta (carpetas, análisis, paneles, conjuntos de datos, orígenes de datos y temas). Pueden crear, editar y eliminar los activos de la carpeta, modificar los permisos de la carpeta y sus activos y eliminar la carpeta por completo. El rol de propietario no se admite en las carpetas compartidas restringidas.
+ **Colaboradores**: un *colaborador* puede crear, editar y eliminar activos de una carpeta igual que un propietario. No pueden eliminar la carpeta ni modificar los permisos de la carpeta o de los activos en los que tienen acceso de colaborador y que hayan heredado de la carpeta. 
+ **Espectadores**: un *espectador* solo puede ver los activos (carpetas, paneles, conjuntos de datos, orígenes de datos y temas) de la carpeta. Un espectador no puede editar ni compartir esos activos.

Las siguientes reglas también se aplican a la seguridad de las carpetas compartidas:
+ El estado de uso compartido de una carpeta por parte de los lectores rápidos se comparte con la carpeta. Sin embargo, el lector solo tiene acceso de lectura a las carpetas y solo acceso de panel a los elementos visuales. 
+ AWS la seguridad se aplica a todos los objetos de una carpeta. La carpeta aplica el mismo tipo de seguridad a los activos de la persona con la que se comparte la carpeta según su nivel de acceso (administrador, autor o lector).
+ La *carpeta de nivel superior* es la carpeta raíz de todas las subcarpetas. Cuando se comparte una subcarpeta en cualquier nivel, la persona con la que se compartió verá la carpeta raíz en la vista de carpetas de nivel superior.
+ El permiso de carpeta es el permiso de la carpeta actual, combinado con los permisos de todas las carpetas que conducen a la carpeta raíz.
+ Un *recurso compartido* hereda su permiso de la carpeta. Un activo compartido se crea cuando un activo que pertenece al propietario de la carpeta se agrega a una carpeta compartida.
+ Si tienes una carpeta compartida sin restricciones, puedes transferir la propiedad de la carpeta a otro administrador de Quick.
+ El rol de propietario no se admite en las carpetas restringidas. El rol de colaborador se asigna a los autores que crean y editan activos dentro de las carpetas restringidas. Los colaboradores de la carpeta no pueden administrar los permisos de la carpeta restringida ni sus activos.
+ Se requieren los permisos de IAM correctos para actualizar los permisos de una carpeta compartida restringida con la API `UpdateFolderPermissions`.

Para crear y administrar los permisos de una carpeta compartida, consulte [Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight](sharing-folders.md).

# Crear y administrar los permisos de membresía para las carpetas compartidas de Quick Sight
<a name="sharing-folders"></a>

**Carpetas compartidas (sin restricciones)**

Para crear una carpeta compartida y compartirla con uno o más grupos en la consola rápida, debe ser QuickSight administrador de Amazon. También puede crear una carpeta compartida con la operación de la API `CreateFolder`. Utilice el siguiente procedimiento para compartir o modificar los permisos de membresía de una carpeta compartida.

1. En el menú de navegación de la izquierda, selecciona **Carpetas** y, a continuación, **Carpetas compartidas**. Busca la carpeta en la que quieres compartir o gestionar los permisos.

1. Para abrir el menú de acciones de la fila de esa carpeta, seleccione los puntos suspensivos (tres puntos).

1. Elija **Compartir**.

1. En el modal **Compartir carpeta**, agregue los grupos y usuarios con los que quiere compartir el contenido de la carpeta.

1. Para cada usuario y grupo que añada, elija un nivel de permisos en el menú **Permisos** de esa fila. 

1. Para actualizar el tipo de permiso de un usuario existente, elija **Administrar el acceso a las carpetas**.

1. Cuando haya terminado de configurar los permisos de usuario y grupo para la carpeta, elija **Compartir**. No se notifica a los usuarios que ahora tienen acceso a la carpeta.

**Carpetas compartidas restringidas** 

Las carpetas compartidas restringidas solo se pueden crear con la operación de la API `CreateFolder`. En el ejemplo siguiente se crea una carpeta compartida restringida.

```
aws quicksight create-folder \
--aws-account-id AWSACCOUNTID \
--region us-east-1 \
--folder-id example-folder-name \
--folder-type RESTRICTED \
--name "Example Folder" \
```

Tras crear una carpeta compartida restringida, asigne los permisos de colaborador y espectador de la carpeta mediante una llamada a la API `UpdateFolderPermissions`. En el siguiente ejemplo, se actualizan los permisos de una carpeta compartida restringida para conceder permisos de colaborador a un usuario.

```
aws quicksight update-folder-permissions \
--aws-account-id AWSACCOUNTID \
--region us-east-1 \
--folder-id example-folder-name \
--grant-permissions Principal=arn:aws:quicksight::us-east-
1::AWSACCOUNTID:user/default/:username,Actions=quicksight:CreateFolder
,quicksight:DescribeFolder, \
quicksight:CreateFolderMembership,quicksight:DeleteFolderMembership,qu
icksight:DescribeFolderPermissions \
```

Los permisos que se transfieren al usuario dependen del tipo de función de carpeta que se le quiera conceder. Utilice las siguientes listas para determinar qué permisos son necesarios para el usuario al que desee conceder acceso a la carpeta.

**Propietario de la carpeta**
+ vista rápida: CreateFolder
+ vista rápida: DescribeFolder
+ vista rápida: UpdateFolder
+ vista rápida: DeleteFolder
+ vista rápida: CreateFolderMembership
+ vista rápida: DeleteFolderMembership
+ vista rápida: DescribeFolderPermissions
+ vista rápida: UpdateFolderPermissions

**Colaborador de la carpeta**
+ vista rápida: CreateFolder
+ vista rápida: DescribeFolder
+ vista rápida: CreateFolderMembership
+ vista rápida: DeleteFolderMembership
+ vista rápida: DescribeFolderPermissions

**Visualizador de la carpeta**
+ vista rápida: DescribeFolder

Tras crear una carpeta compartida, puede empezar a utilizarla en Quick Sight.

También puedes usar Quick Sight APIs para crear carpetas a una escala especial que se puedan compartir con hasta 3000 espacios de nombres. Para obtener más información sobre cómo crear una carpeta escalada, consulte [Creación de carpetas escaladas de Quick Sight con Quick Sight APIs](folders-scaled.md).

# Creación de carpetas escaladas de Quick Sight con Quick Sight APIs
<a name="folders-scaled"></a>

Puede usar Amazon Quick Sight APIs para crear carpetas a escala especiales que se pueden compartir con hasta 3000 espacios de nombres. Cada espacio de nombres que se agrega a una carpeta puede contener hasta 100 entidades principales. Una *entidad principal* es un usuario o un grupo de usuarios. Tras crear una carpeta a escala y añadir los elementos principales que desee, podrá añadir cualquier QuickSight activo a la carpeta. A continuación, se puede compartir con todas las entidades principales de los espacios de nombres a los que están asignadas las entidades principales de la carpeta. Esto agiliza el proceso de compartir los activos de Quick Sight con miles de usuarios.

Las carpetas escaladas solo se pueden crear con Quick Sight. APIs Al crear una carpeta escalada, puede compartirla con hasta 100 entidades principales que estén en el mismo espacio de nombres. Puede agregar entidades principales que pertenezcan a un espacio de nombres diferente con una llamada a la API `UpdateFolderPermissions`. Una vez creada la carpeta, puede añadir y eliminar activos de la carpeta con Quick Sight APIs o la consola Quick.

Cada cuenta de Amazon Quick Sight contiene hasta 100 carpetas escaladas. Puede agregar hasta 100 activos a una carpeta escalada. Si quiere compartir una carpeta escalada con más de 3000 espacios de nombres, póngase en contacto con [AWS Support](https://aws.amazon.com/contact-us/).

## Ejemplos
<a name="folders-scaled-examples"></a>

Los siguientes ejemplos muestran cómo crear una carpeta a escala con Quick Sight. APIs

**Requisitos previos**

Antes de empezar, compruebe que tiene una AWS Identity and Access Management función que conceda al usuario de la API acceso para llamar a las operaciones de la API de Quick Sight. En el siguiente ejemplo se muestra una política de IAM que puede agregar a un rol de IAM existente para crear, eliminar o modificar una carpeta escalada. Con el ejemplo de política, los usuarios pueden agregar paneles, análisis y conjuntos de datos a una carpeta escalada.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
        "Effect": "Allow",
        "Action": [
            "quicksight:CreateFolder",
            "quicksight:CreateFolderMembership",
            "quicksight:DeleteFolderMembership",
            "quicksight:DeleteFolder",
            "quicksight:DescribeFolderPermissions",
            "quicksight:DescribeFolderResolvedPermissions",
            "quicksight:UpdateFolderPermissions",
            "quicksight:UpdateDashboardPermissions",
            "quicksight:UpdateAnalysisPermissions",
            "quicksight:UpdateDataSetPermissions"
        ],
        "Resource": "*"
        }
    ]
}
```

------

En el ejemplo siguiente se crea una carpeta escalada.

```
aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "eastcoast-users" \
--sharing-model "NAMESPACE" \
--folder-id "eastcoast-users"
```

Tras crear una carpeta escalada, compártala con una entidad principal de la cuenta. Solo puede conceder o revocar permisos a los usuarios y grupos que estén dentro del mismo espacio de nombres en cada llamada a la API. En el siguiente ejemplo, se comparte una carpeta escalada con un usuario de la misma cuenta en la que se encuentra la carpeta.

```
aws quicksight update-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--grant-permissions \
    '[
        {"Actions":
            ["quicksight:DescribeFolder",
            "quicksight:UpdateFolder",
            "quicksight:DeleteFolder",
            "quicksight:DescribeFolderPermissions",
            "quicksight:UpdateFolderPermissions",
            "quicksight:CreateFolderMembership",
            "quicksight:DeleteFolderMembership",
            "quicksight:CreateFolder"
            ],
        "Principal":"arn:aws:quicksight:us-east-1:AWSACCOUNTID:user/default/my-user"
        }
    ]'
```

Después de compartir la carpeta con una nueva entidad principal, valide los permisos de la nueva carpeta con una llamada a la API `describe-folder-permissions`.

```
aws quicksight describe-folder-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "eastcoast-users" \
--namespace "default"
```

Tras validar los permisos de la nueva carpeta, crea una subcarpeta dentro de la carpeta escalada. La subcarpeta hereda los permisos de la carpeta escalada en la que se creó.

```
aws quicksight create-folder \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--name "new-york-users" \
--sharing-model "NAMESPACE" \
--folder-id "new-york-users" \
--parent-folder-arn "arn:aws:quicksight:us-east-1:AWSACCOUNTID:folder/eastcoast-users"
```

En el siguiente ejemplo, se validan los permisos heredados de la nueva subcarpeta.

```
aws quicksight describe-folder-resolved-permissions \
--aws-account-id "AWSACCOUNTID" \
--region "us-east-1" \
--folder-id "new-york-users" \
--namespace "default"
```

Tras validar los permisos de la subcarpeta, añada a la carpeta el activo de Quick Sight que desee compartir. Tras agregar el recurso a la subcarpeta, se comparte con todas las entidades principales con las que se comparte la subcarpeta. En el siguiente ejemplo, se agrega un panel a una subcarpeta.

```
aws quicksight create-folder-membership \
--aws-account-id "AWSACCOUNTID" \
--folder-id "new-york-users" \
--member-id "my-dashboard" \
--member-type "DASHBOARD" \
--region "us-east-1"
```

# Exploración de los paneles interactivos en Amazon Quick Sight
<a name="using-dashboards"></a>

****  
**Público objetivo: suscriptores o audiencia** de Amazon Quick Dashboard 

En Amazon Quick Sight, un *panel de datos* es un conjunto de tablas, gráficos e información. Es como un periódico en el que todo gira en torno a los datos que le interesan, excepto que tiene páginas digitales. En lugar de leerlo, usted interactúa con él. 

Los paneles vienen en una amplia variedad de diseños, según lo que haga y los análisis que necesite para hacerlo bien. Con Quick Sight, puede interactuar con sus datos en una página web o en su dispositivo móvil. Si también se suscribe por correo, podrá ver una vista previa estática de esta. 

La historia que cuentan sus datos refleja la experiencia de los analistas y científicos de datos que crearon los paneles. Refinan los datos, añaden cálculos, encuentran ángulos sobre la historia y deciden cómo presentarla. El publicador diseña el panel y lo rellena con visualizaciones de datos interactivas y controles que ajustan la vista. Los publicadores pueden personalizar el nivel de interactividad del que dispone, incluidas las opciones de filtro y búsqueda. Puede interactuar con los elementos activos de la pantalla para filtrarlos, ordenarlos, desglosarlos o pasar a otra herramienta. 

Cuando ve un panel, ve los datos recibidos más recientemente. A medida que interactúe con los elementos de la pantalla, los cambios que realice cambiarán su forma de ver el panel y no la de los demás. Por lo tanto, la privacidad de su dispositivo está asegurada, aunque el publicador puede saber lo que ha visto. Tras cerrar el panel, ni las exploraciones ni los datos se conservarán. Como siempre, si eres lector de Quick Reader, los editores de los paneles te proporcionan tu suscripción mensual sin coste adicional.

Si también publica paneles (los llamamos autores porque redactan informes), también puede guardar una copia del panel para analizarlo más a fondo. Si encuentra una nueva característica de los datos que desea publicar, trabaje con los autores originales para actualizarla. De esta forma, todos podrán ver la misma versión de la historia. Sin embargo, también puede usar su copia para obtener información sobre cómo funciona su diseño o para inspirarse en algo completamente nuevo. Luego, cuando haya terminado, podrá publicar su análisis como un nuevo panel. 

Para aprender a configurar los paneles, consulte [Compartir datos y suscribirse a ellos en Amazon Quick Sight con paneles e informes](working-with-dashboards.md). 

**Topics**
+ [Interacción con los paneles](exploring-dashboards.md)
+ [Interactuar con informes de píxeles perfectos](interacting-with-paginated-reports.md)
+ [Suscripción a correos electrónicos y alertas](subscriber-alerts.md)
+ [Informes generados por lectores](reader-scheduling.md)
+ [Marcadores](dashboard-bookmarks.md)

# Interacción con los paneles de Amazon Quick Sight
<a name="exploring-dashboards"></a>

Para acceder a un panel que ha sido invitado a compartir, siga las instrucciones del correo electrónico de invitación. También puede acceder a un panel si está integrado en una aplicación o sitio web al que ya tiene acceso.

Para ajustar el panel a la pantalla, abra el menú **Ver** en la esquina superior derecha y seleccione **Ajustar a la ventana**.

En función de cómo esté configurado el panel, podrá encontrar todos o algunos de los siguientes elementos:
+ La barra de menús: muestra el nombre del panel. Además, la barra de menús muestra qué puede hacer con el panel, como **Deshacer**, **Rehacer** y **Restablecer**, a la izquierda. A medida que interactúa con el panel, puede utilizarlas como herramientas para explorar, teniendo en cuenta que puede cambiar de vista sin perder nada. A la derecha, encontrará opciones para **imprimir** el panel, trabajar con **datos**, elegir una **región** de AWS diferente y abrir su **Perfil de usuario**. El menú del perfil de usuario tiene opciones para que pueda elegir el idioma en el que se mostrará Amazon Quick Sight. También incluye enlaces a la **comunidad** rápida y a la documentación en línea (**Ayuda**).
+ Las hojas del panel: si su panel tiene varias hojas, se muestran como pestañas en la parte superior del panel. 
+ El menú de **Filtro**: esta opción se muestra a la izquierda del panel si el publicador del panel permite filtrar.
+ La paleta de **Controles**: si su panel incluye controles, puede utilizarlos para elegir las opciones (parámetros) que desea aplicar al panel. A veces se selecciona un valor de control y, a veces, se establece en **TODOS**.
+ El título del panel: si el panel tiene un título, suele ser un encabezado más grande. Es posible que tenga información de estado o instrucciones debajo. 
+ Los widgets del panel: los elementos de la pantalla pueden incluir diagramas, gráficos, información, narrativas o imágenes. Para verlos todos, puede que tenga que desplazarse en vertical u horizontal.

# Uso de filtros en los datos del panel de Amazon Quick Sight
<a name="filtering-dashboard-data"></a>

Puede utilizar filtros para definir los datos que se muestran en un elemento visual. Los filtros se aplican a los datos antes que las funciones de agregación. Si tiene varios filtros, todos los filtros de nivel superior se aplican juntos mediante la operación AND. Si los filtros están agrupados dentro de un filtro de nivel superior, los filtros del grupo se aplicarán usando la operación OR. 

Amazon Quick Sight aplica todos los filtros habilitados al campo. Por ejemplo, suponga que hay un filtro de `state = WA` y otro filtro de `sales >= 500`. En este caso, el conjunto de datos solo contiene registros que cumplan ambos criterios. Si desactiva uno de ellos, solo se aplicará un filtro. Asegúrese de que los diversos filtros que se aplican al mismo campo no se excluyan mutuamente.

## Visualización de filtros
<a name="subscriber-dashboards-viewing-filters"></a>

Para ver los filtros existentes, seleccione **Filtro** en el menú de configuración del elemento y, a continuación, elija ver los filtros. Aparecen en el panel **Filtros aplicados** en orden de creación, con el filtro más antiguo en la parte superior.

### Descripción de los iconos de filtro en un panel de Amazon Quick Sight
<a name="subscriber-dashboards-understanding-filter-icons"></a>

Los filtros del panel **Filtros aplicados** muestran iconos para indicar la forma en que se asignan y si están o no habilitados.

Los filtros que no están activados aparecen atenuados y la casilla de verificación no se puede marcar.

Uno de los diversos iconos de ámbito se muestra a la derecha del nombre del filtro para indicar el ámbito definido en ese filtro. El icono de ámbito tiene el aspecto de cuatro cajas en un cuadrado. Si todos los cuadros están rellenos, el filtro se aplica a todos los elementos visuales de la hoja de análisis. Si solo un cuadro está relleno, el filtro se aplica únicamente al elemento visual seleccionado. Si algunos cuadros están rellenos, el filtro se aplica a algunos de los elementos visuales de la hoja, incluido el seleccionado actualmente.

Los iconos de ámbito coinciden con los que aparecen en el menú del filtro cuando elige el ámbito del filtro.

### Visualización de los detalles de los filtros en un panel de Amazon Quick Sight
<a name="subscriber-dashboards-viewing-filter-details"></a>

Para ver los detalles del filtro, elija **Filtro** a la izquierda. La vista de filtro conserva la última selección. Por lo tanto, cuando abra **Filtro**, verá la vista **Filtros aplicados** o **Editar filtro**.

En la vista **Filtros aplicados**, puede elegir cualquier filtro para ver sus detalles. Los filtros de esta lista pueden cambiar en función del ámbito del filtro y del elemento visual seleccionado actualmente.

Puede cerrar la vista **Editar filtro** eligiendo el selector de la derecha. De este modo se restablecerá la vista **Filtro**.

# Filtrar datos durante la sesión en Amazon Quick Sight
<a name="subscriber-dashboards-filtering-your-view-of-the-data"></a>

Mientras la sesión del panel esté activa, puede filtrar los datos de tres maneras:

1. Si el panel tiene controles en la parte superior de la pantalla, puede usarlos para filtrar los datos eligiendo de una lista de valores preestablecida.

1. Puede usar el icono de filtro en el menú de configuración de cada widget. 

1. Puede crear sus propios filtros mediante el panel de filtro del lado izquierdo de la página. El icono de filtro tiene el siguiente aspecto.

Para crear un filtro, seleccione el icono de **filtro** de la izquierda. 

El primer paso consiste en elegir qué elemento del panel desea filtrar.

Haga clic en el elemento que elija para que aparezca un resaltado alrededor del elemento seleccionado. Además, si ya hay algún filtro, aparecerá en una lista. Si no hay ningún filtro, puede añadir uno con el signo más (**\$1**) situado junto a **Filtros**.

Las opciones de filtrado varían en función del tipo de datos del campo que desee filtrar y de las opciones que elija dentro del filtro. La siguiente captura de pantalla muestra algunas de las opciones disponibles para un filtro de fechas por rango de tiempo.

Para cada filtro, puede elegir si desea aplicarlo a uno, a algunos o a todos los elementos del panel. También puede habilitar o deshabilitar los filtros mediante la casilla de verificación situada junto al nombre del filtro. Para eliminar un filtro, edítelo y desplácese hasta la parte inferior para ver las opciones. Recuerde que los filtros no se guardan de una sesión a otra.

Para obtener más información sobre la creación de filtros, consulte [Filtrado de datos en Amazon Quick Sight](adding-a-filter.md).

# Uso de los elementos del panel de Amazon Quick Sight
<a name="using-visuals-on-a-dashboard"></a>

Cada widget tiene un menú de configuración que aparece cuando lo selecciona. Este menú ofrece opciones para acercar o alejar, filtrar los datos, exportarlos y mucho más. Las opciones varían en función del tipo de widget que sea el elemento.

Al elegir un punto de datos, hay varias acciones disponibles. Puede hacer clic o tocar un punto de datos, por ejemplo, una barra en un gráfico de barras, un punto donde la línea se flexibiliza en un gráfico de líneas, y así sucesivamente. Las opciones disponibles varían según el tipo de elemento del que se trate. 

Estas acciones son las siguientes:
+ Centrarse en datos o excluirlos.

  Puede centrarse en determinados datos de un campo o excluirlos, como, por ejemplo, las regiones, las métricas o las fechas. 
+ Desglosar en sentido ascendente o descendente.

  Si su panel contiene datos que se pueden desglosar en sentido descendente o ascendente, puede desglosarlos en sentido ascendente en un nivel superior o en sentido descendente para explorar más detalles. 
+ Acciones de URL personalizadas.

  Si su panel contiene acciones personalizadas, puede activarlas seleccionando un punto de datos o haciendo clic con el botón derecho del ratón. Por ejemplo, es posible que pueda enviar un correo electrónico a alguien directamente desde el panel. O bien, puede abrir otra hoja, sitio web o aplicación y enviarle el valor que haya elegido de entre estos.
+ Cambiar colores de gráficos o colores de campos específicos.

  Puede cambiar todos los colores del gráfico a un color específico. O bien, puede elegir un valor de campo específico para cambiar el color del elemento del que forma parte. 

# Clasificación de los datos del panel de control en Amazon Quick Sight
<a name="sorting-dashboard-data"></a>

Puede ordenar datos de tres formas: 

1. Puede colocar el cursor sobre la etiqueta del campo que desea ordenar y, a continuación, seleccione el icono de ordenar. 

1. Puede elegir el icono de filtro situado en la parte superior derecha de uno de los elementos del panel.

1. Puede hacer clic o tocar el campo y elegir **Ordenar** en el menú contextual.

La ordenación de las tablas dinámicas es diferente; especifique el orden mediante el icono de ordenación de la columna en la tabla dinámica.

# Exportación e impresión de informes interactivos del panel de control de Amazon Quick Sight
<a name="export-or-print-dashboard"></a>

Puede exportar o imprimir una versión en PDF de un panel interactivo. También puede exportar algunos elementos visuales de un panel a un CSV. Actualmente, no se admite la exportación de un panel completo a un CSV para paneles interactivos. 

## Exportación de datos desde un panel a un archivo PDF
<a name="export-dashboard-to-pdf"></a>

**Exportación de un informe de panel interactivo en formato PDF**

1. En el informe del panel que desee exportar, seleccione el icono **Exportar** situado en la parte superior derecha.

1. Seleccione **Generar PDF**.

1. Al seleccionar **Generar PDF**, Quick Sight empezará a preparar el informe del panel de control para su descarga. Seleccione **Ver descargas** en la ventana emergente azul para abrir el panel **Descargas** de la derecha.

1. Hay dos formas de descargar su informe:
   + Seleccione **DESCARGAR AHORA** en la ventana emergente verde.
   + Seleccione el icono **Exportar** en la parte superior derecha y, a continuación, seleccione **Ver descargas** para ver y descargar todos los informes que estén listos para descargar.

**Impresión de un informe de panel interactivo**

1. En el informe que desee imprimir, elija el icono **Exportar** situado en la parte superior derecha y, a continuación, seleccione **Imprimir**.

1. En la ventana emergente **Preparar para la impresión** que aparece, elija el tamaño y la orientación del papel que desee. Si lo desea, puede optar por incluir el color de fondo seleccionando **Imprimir color de fondo**.

1. Elija **IR A LA VISTA PREVIA**.

1. En la ventana de vista previa que aparece, seleccione **IMPRIMIR**.

## Exportación de datos desde un panel a un CSV
<a name="export-dashboard-to-csv"></a>

**nota**  
Los archivos de exportación pueden devolver directamente información de la importación del conjunto de datos. Esto hace que los archivos sean vulnerables a ejecuciones CSV si los datos importados contienen fórmulas o comandos. Por este motivo, los archivos de exportación pueden provocar advertencias de seguridad. Para evitar actividades maliciosas, desactive los enlaces y las macros al leer los archivos exportados.

Para exportar datos de un análisis o panel a un archivo de valores separados por comas (CSV), utilice el menú de configuración en la parte superior derecha de un widget. Las exportaciones solo incluyen los datos que se muestran actualmente en el elemento que elija. 

En las tablas y las tablas dinámicas, puede exportar los datos a un archivo de valores separados por comas (CSV) o a un archivo de Microsoft Excel. Puede exportar solo los campos visibles o todos los campos. 

Para exportar solo los campos visibles a un archivo CSV o de Excel, seleccione el menú situado en la parte superior derecha del elemento visual. Seleccione **Exportar a CSV** o **Exportar a Excel** y, a continuación, seleccione **Exportar los campos visibles a CSV** o **Exportar los campos visibles a Excel**.

Para exportar todos los campos a un archivo CSV o de Excel, seleccione el menú situado en la parte superior derecha del elemento visual. Seleccione **Exportar a CSV** o **Exportar a Excel** y, a continuación, seleccione **Exportar todos los campos a CSV** o **Exportar todos los campos a Excel**.

# Genere un resumen ejecutivo de un panel de Amazon Quick Sight
<a name="use-executive-summaries"></a>

Los lectores del panel de control pueden generar resúmenes ejecutivos que proporcionan un resumen de toda la información que Quick Sight ha generado para el panel. Los resúmenes ejecutivos facilitan a los lectores la búsqueda de información y datos clave sobre paneles de un vistazo.

Cuando los lectores están viendo un panel que utiliza resúmenes ejecutivos, la opción de **resumen ejecutivo** está disponible en la lista desplegable **Crear** que se encuentra en la parte superior derecha de la página del panel. Utilice el procedimiento que se indica a continuación para generar un resumen ejecutivo. Si un panel no utiliza resúmenes ejecutivos, la opción de **resumen ejecutivo** no aparece en la lista desplegable **Crear**.

**Generación de un resumen ejecutivo**

1. En el panel en el que desee trabajar, elija **Crear** y, a continuación, elija **Resumen ejecutivo**.

1. Elija **Resumir**. El resumen ejecutivo se generará y se mostrará a la izquierda.

Los resúmenes ejecutivos usan los datos de la configuración de la hoja del panel y el elemento visual actuales. Si se actualizan la configuración del panel o el elemento visual, aparecerá una advertencia en la parte superior del resumen ejecutivo. Para actualizar el resumen ejecutivo de un panel actualizado, genere un nuevo resumen ejecutivo.

Tras generar un resumen ejecutivo, los lectores de Amazon Quick pueden copiarlo en su portapapeles para compartirlo con otras personas o incluirlo en una historia de Quick Sight. Para obtener más información sobre las historias de Quick Sight, consulte[Trabajar con historias de datos en Amazon Quick Sight](working-with-stories.md). 

# Interactuar con informes de píxeles perfectos en Amazon Quick Sight
<a name="interacting-with-paginated-reports"></a>

Para acceder a un informe perfecto que te hayan invitado a compartir, sigue las instrucciones del correo electrónico de invitación. También puedes acceder a un informe perfecto si está integrado en una aplicación o sitio web al que ya tienes acceso.

Para que el informe se ajuste perfectamente a tu pantalla, abre el menú **Ver** en la esquina superior derecha y selecciona **Ajustar a la ventana**. También puede acercar y alejar el informe con los iconos más (\$1) y menos (-) situados en la esquina superior izquierda del informe.

# Exportación e impresión de informes de Amazon Quick Sight
<a name="interacting-with-paginated-reports-export"></a>

Los informes Pixel Perfect están diseñados para visualizarse desde un punto de tiempo específico. Estos informes, o instantáneas, se pueden imprimir o descargar en formato PDF o CSV.

**Para exportar un informe de Pixel Perfect en formato PDF**

1. En el informe con píxeles perfectos que quieras exportar, selecciona el icono de **exportación** situado en la parte superior derecha.

1. Seleccione **Generar PDF**.

1. Si eliges **Generar PDF**, Quick Sight empezará a preparar el informe con píxeles perfectos para su descarga. Cuando el informe esté listo, aparecerá una ventana emergente verde que indica que **su PDF está listo**.

1. Hay dos formas de descargar su informe:
   + Seleccione **DESCARGAR AHORA** en la ventana emergente verde.
   + Seleccione el icono **Exportar** en la parte superior derecha y, a continuación, seleccione **Ver descargas** para ver y descargar todos los informes que estén listos para descargar.

**Para exportar un informe con píxeles perfectos como CSV**

1. En el informe que desee exportar, elija el icono de **Programación** situado en la parte superior derecha y, a continuación, seleccione **Instantáneas recientes**.

1. En el menú **Instantáneas recientes** que aparece a la derecha, las instantáneas se ordenan de las más recientes a las más antiguas. Las instantáneas se almacenan durante un año como máximo. Busque el informe que desee descargar y elija el icono de descarga situado a la derecha del informe.

1. En la ventana emergente del informe que aparece, selecciona el icono de descarga situado junto a la versión del informe que quieres descargar. Puede elegir descargar el informe en formato CSV o puede descargarlo en formato PDF.

**Para imprimir un informe con píxeles perfectos**

1. En el informe que desee imprimir, elija el icono **Exportar** situado en la parte superior derecha y, a continuación, seleccione **Imprimir**.

1. Al seleccionar **Imprimir**, aparece la ventana emergente de la impresora del navegador. Desde aquí, puede imprimir el PDF de la misma manera que imprimiría cualquier otra cosa en su navegador.

# Suscribirse a los correos electrónicos y alertas del panel de control de Amazon Quick Sight
<a name="subscriber-alerts"></a>

Con Amazon Quick Sight, puede suscribirse a las actualizaciones de determinados eventos, como las actualizaciones del panel de control y las alertas de anomalías.

**Topics**
+ [Suscribirse a los correos electrónicos del panel](#subscribing-to-a-dashboard-report-for-readers)
+ [Suscripción a las alertas de anomalías](#anomaly-alerts)

## Suscribirse a los correos electrónicos del panel
<a name="subscribing-to-a-dashboard-report-for-readers"></a>

Puede suscribirse para recibir un panel en forma de informe mediante un correo electrónico. También puede configurar la configuración del informe.

**Cambio de la configuración de suscripción e informes de un panel**

1. Abra un panel compartido con usted.

1. Seleccione el icono **Programaciones** en la parte superior derecha y, a continuación, seleccione **Programaciones** en el menú desplegable.

1. El panel **Programaciones** aparece a la derecha. Este panel muestra todos los diferentes informes programados a los que está suscrito o a los que puede estar suscrito. Navegue hasta el informe que desee y active el interruptor para suscribirse o cancelar la suscripción al informe.

## Suscripción a las alertas de anomalías
<a name="anomaly-alerts"></a>

Puede suscribirse a alertas para detectar anomalías y análisis de contribuciones en un panel con información de narrativas configurada para la detección de anomalías. Recibirá las alertas de anomalías cuando se actualicen las anomalías. El correo electrónico de las alertas muestra el número total de anomalías y proporciona detalles de las cinco primeras, según su configuración personal de las alertas. Recibirá el análisis de contribuciones de controladores clave cuando se actualice, siempre que el análisis de contribuciones esté configurado para ejecutarse con la detección de anomalías.

**Configuración de alertas de anomalías**

1. Abra un panel compartido con usted.

1. Puede configurar las alertas desde una de las dos pantallas. Elija una de las siguientes opciones y vaya al siguiente paso:
   + En el panel, localice el widget de anomalías que le interese. Selecciónelo de modo que tenga un cuadro resaltado a su alrededor. 
   + Si está en el panel y tiene abierta la página **Explorar anomalías**, puede configurar la alerta sin volver a la vista del panel. 

1. En la parte superior derecha, elija **Configurar alerta**. Se abrirá la pantalla de configuración de **Alerta**.

1. En **Gravedad**, elija el nivel más bajo de importancia que desee ver. 

   En **Dirección**, elija obtener alertas sobre anomalías que sean **Más de lo previsto** o **Menos de lo previsto**. También puede elegir **[ALL] [TODO]** para recibir alertas sobre todas las anomalías.

1. Para confirmar sus opciones, elija **Aceptar**. 

1. Para dejar de recibir alertas de anomalías, localice el widget de anomalías en el panel y utilice el icono de campana para cancelar la suscripción. También puede utilizar el enlace **Para administrar esta alerta** en la parte inferior de un correo electrónico de alerta.

# Creación de un informe generado por un lector en Amazon Quick Sight
<a name="reader-scheduling"></a>

Si un autor de Amazon Quick ha configurado un informe solicitado para obtener un informe perfecto en píxeles de Quick Sight, los usuarios del panel de Quick Sight pueden usar el mensaje para programar sus propios informes. Para obtener más información sobre las solicitudes de informes con píxeles perfectos, consulte[Configuración de peticiones para informes paginados](paginated-reports-prompts.md).

Utilice las secciones siguientes para obtener información sobre cómo crear y modificar informes generados por lectores.

**Topics**
+ [Creación de informes generados por lectores](#reader-scheduling-create)
+ [Cargar una vista guardada de un informe generado por un lector Quick Sight](#reader-scheduling-load-view)
+ [Actualización de la vista de informes programados generados por lectores](#reader-scheduling-update-view)
+ [Actualización de informes programados generados por lectores](#reader-scheduling-update-schedule)

## Creación de informes generados por lectores
<a name="reader-scheduling-create"></a>

Utilice el siguiente procedimiento para crear informes generados por lectores.

**Cómo crear informes generados por lectores**

1. Abra la [consola rápida.](https://quicksight.aws.amazon.com/)

1. Abra el panel para el que desea crear un informe.

1. Elija **Programación** en la parte superior de la página del panel.

1. Se abre el panel de programación. Para agregar una nueva programación de informes, elija **Agregar**. Si no ves el botón **Añadir**, significa que el panel no contiene una hoja con píxeles perfectos o tu cuenta Quick no tiene el complemento de informes con píxeles perfectos. Para obtener más información acerca del complemento Informes paginados, consulte [Introducción](qs-reports-getting-started.md).

1. En **Nombre de la programación**, escriba un nombre para la nueva programación. El nombre de la programación puede tener una longitud máxima de 100 caracteres.

1. En **Descripción**, elija la opción de vista que desea que utilice el informe. Puede elegir entre las siguientes vistas:
   + **Vista personalizada**: la vista actual del panel.
   + **Vista original**: la vista publicada por el autor del panel.

1. En **Contenido**, elige la hoja de informe perfecta para la que deseas generar un informe en PDF.

1. En **Fechas**, elija la frecuencia con la que desea recibir el informe. Las opciones de programación que están disponibles para un informe de correo electrónico incluyen las siguientes:
   + **Una vez (no repetir)**: envía el informe solo una vez en la fecha y hora que elija.
   + **Diariamente**: se repite todos los días a la hora que elija.
   + **Semanalmente**: se repite cada semana el mismo día o días a la hora que elija. También puede usar esta opción para enviar informes en intervalos semanales, por ejemplo, cada dos o tres semanas.
   + **Mensualmente**: se repite cada mes el mismo día, a la hora que elija. También puede usar esta opción para enviar informes en días específicos del mes, como el segundo miércoles o el último viernes de cada mes.
   + **Anualmente**: se repite cada año el mismo día del mes o meses seleccionados, a la hora que elija. También puede usar esta opción para enviar informes en días o conjuntos de días específicos en meses seleccionados. Por ejemplo, puede configurar un informe para que se envíe el primer lunes de enero, marzo y septiembre, o el 14 de julio, o el segundo día de febrero, abril y junio de cada año.
   + **Personalizado**: configure su propio informe programado que mejor se adapte a las necesidades de su empresa.

   El informe programado se envía dentro de una hora desde la hora especificada. Pueden producirse retrasos durante las horas pico.

1. En la pestaña **Correo electrónico**, en **Línea de asunto del correo electrónico**, introduzca una línea de asunto personalizada o déjela en blanco para usar el título del informe.

1. Introduzca las direcciones de correo electrónico del nombre del grupo rápido de los usuarios o grupos para los que desea recibir el informe.

1. En **Encabezado del correo electrónico**, introduzca el encabezado que quiere que muestre el informe del correo electrónico.

1. (Opcional) En **Cuerpo del correo electrónico**, déjelo en blanco o introduzca un mensaje personalizado para que aparezca al principio del correo electrónico.

1. (Opcional, recomendado) Para enviar una muestra del informe antes de guardar los cambios, seleccione **Enviar informe de prueba**.

1. Realice una de las siguientes acciones: 
   + (Recomendado) Seleccione **Guardar** para confirmar las entradas.
   + Para enviar un informe de forma inmediata, seleccione **Guardar y ejecutar ahora**. El informe se envía inmediatamente, incluso si la fecha de inicio de su programación es futura.

Después de guardar una programación de informe, esta aparece en el panel **Programaciones**. Los informes generados por lectores solo están disponibles para el usuario que los creó y no se pueden compartir.

## Cargar una vista guardada de un informe generado por un lector Quick Sight
<a name="reader-scheduling-load-view"></a>

Los lectores de Amazon Quick pueden usar el panel **Programaciones** para cargar una vista guardada de cualquier informe programado en píxeles perfectos que haya creado o recibido. Utilice el siguiente procedimiento para cargar una vista guardada de un informe programado.

**Carga de una vista guardada de un informe programado**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el panel que contiene el informe que desee cambiar.

1. Elija **Programación** en la parte superior de la página del panel.

1. Se abre el panel de programación. Busque la programación que desee cambiar, elija el icono de puntos suspensivos (tres puntos) situado junto al informe para abrir el menú de programación y, a continuación, elija **Detalles**.

1. Seleccione **Cargar vista guardada**. Se representa la vista guardada del panel que se utilizó para la programación seleccionada. Todos los valores de filtro que estaban activos cuando se tomó la instantánea del panel se aplican al panel. Cuando se carga una vista guardada de un panel, se pierde la vista actual del panel que tiene el lector.

## Actualización de la vista de informes programados generados por lectores
<a name="reader-scheduling-update-view"></a>

Una vez que un lector de Amazon Quick haya creado un informe en Quick Sight, podrá utilizar el panel **Programaciones** para actualizar la vista del panel que se utiliza en el informe programado. Siga este procedimiento para actualizar la vista del panel de un informe programado.

**Cambio de la vista del panel de un informe programado**

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el panel que contiene el informe que desee cambiar.

1. Elija **Programación** en la parte superior de la página del panel.

1. Se abre el panel de programación. Busque la programación que desee cambiar, elija el icono de puntos suspensivos (tres puntos) situado junto al informe para abrir el menú de programación y, a continuación, elija **Detalles**.

1. Seleccione **Cargar vista guardada**. Se representa la vista guardada del panel que se utilizó para la programación seleccionada. Todos los valores de filtro que estaban activos cuando se tomó la instantánea del panel se aplican al panel. Cuando se carga una vista guardada de un panel, se pierde la vista actual del panel que tiene el lector.

1. Actualice los filtros del panel que desee cambiar.

1. Elija **Programación** en la parte superior de la página del panel.

1. Se abre el panel de programación. Busque la programación que desee cambiar, elija el icono de puntos suspensivos (tres puntos) situado junto al informe para abrir el menú de programación y, a continuación, elija **Editar**.

1. Vaya a la sección **Vista de panel** y, a continuación, seleccione **Vista personalizada**. Los nuevos valores de filtro que ha actualizado se aplican al informe del panel.

1. Elija **Guardar** para actualizar la programación.

## Actualización de informes programados generados por lectores
<a name="reader-scheduling-update-schedule"></a>

Tras crear un informe generado por un lector, los lectores de Amazon Quick pueden utilizar el panel **Programaciones** para activar o inactivar un programa de informes. Siga este procedimiento para actualizar el estado activo de una programación de informes generados por lectores.

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Abra el panel que contiene el informe que desee cambiar.

1. Elija **Programación** en la parte superior de la página del panel para abrir el panel **Programaciones**.

1. Elija **Programaciones**.

1. Vaya a la sección **Mis programaciones** y busque el horario que desea actualizar.

1. Use el conmutador para configurar la programación del informe como **Activo** o **Inactivo**.

1. Cuando haya terminado de hacer los cambios en la programación del informe, cierre el panel **Programaciones**.

# Marcar vistas de un panel de Amazon Quick Sight
<a name="dashboard-bookmarks"></a>

Cuando cargas un panel como lector rápido o autor de Amazon Quick, puedes crear marcadores para capturar vistas específicas de tus intereses. Por ejemplo, puede crear un favorito para un panel con una configuración de filtro específica que difiera del panel publicado originalmente. De este modo, puede volver rápidamente a los datos que le interesan.

Después de crear un favorito, puede configurarlo como la vista predeterminada del panel que aparece al abrir el panel en una nueva sesión. Esto no afecta a cómo los demás ven el panel.

Puede crear hasta 200 favoritos para un panel y compartirlos mediante un enlace URL con otros suscriptores del panel.

Los marcadores del panel de control están disponibles en la consola Quick.

Actualmente, no se admiten los marcadores del panel de control para informes con píxeles perfectos. Para obtener más información sobre los informes con píxeles perfectos, consulte[Cómo trabajar con informes de píxeles perfectos en Amazon Quick Sight](working-with-reports.md).

Use los temas siguientes para obtener información sobre cómo usar los favoritos.

**Topics**
+ [Creación de marcadores en Amazon Quick Sight](dashboard-bookmarks-create.md)
+ [Actualización de marcadores en Amazon Quick Sight](dashboard-bookmarks-update.md)
+ [Cambiar el nombre de los marcadores en Amazon Quick Sight](dashboard-bookmarks-rename.md)
+ [Convertir un marcador en la vista predeterminada en Amazon Quick Sight](dashboard-bookmarks-default.md)
+ [Compartir marcadores en Amazon Quick Sight](dashboard-bookmarks-share.md)
+ [Eliminar marcadores en Amazon Quick Sight](dashboard-bookmarks-delete.md)

# Creación de marcadores en Amazon Quick Sight
<a name="dashboard-bookmarks-create"></a>

Utilice el siguiente procedimiento para crear un favorito para un panel.

**Creación de un favorito para un panel**

1. Abra el panel publicado que desee ver y modifique los filtros o parámetros, o bien seleccione la hoja que desee. Por ejemplo, puede filtrar por la región que le interese o puede seleccionar un intervalo de fechas específico mediante un control de hoja en el panel.

1. Seleccione el icono del favorito en la esquina superior derecha y, a continuación, seleccione **Agregar favorito**.

1. En el panel **Añadir un favorito** que se abre, introduzca un nombre para el favorito y, a continuación, seleccione **Guardar**.

   El favorito se guarda y el nombre del panel se actualiza con el nombre del favorito (en la parte superior izquierda).

   Puede volver a la vista de panel original que el autor publicó en cualquier momento seleccionando **Panel original** en el panel **Favoritos** de la derecha.

# Actualización de marcadores en Amazon Quick Sight
<a name="dashboard-bookmarks-update"></a>

En cualquier momento, puede cambiar la vista del panel de favoritos y actualizar el favorito para que refleje siempre esos cambios. 

**Actualización de un favorito**

1. Abra el panel publicado y realice los cambios necesarios en los filtros o parámetros, o seleccione una hoja.

1. Seleccione el icono de favorito en la esquina superior derecha.

1. En el panel **Favoritos** que se abre, seleccione el menú contextual (los tres puntos verticales) del favorito que quiera actualizar y, a continuación, seleccione **Actualizar**.

   Aparece un mensaje que confirma la actualización.

# Cambiar el nombre de los marcadores en Amazon Quick Sight
<a name="dashboard-bookmarks-rename"></a>

Utilice el siguiente procedimiento para cambiar el nombre de un favorito.

**Cambio del nombre de un favorito**

1. En un panel publicado, elija el icono de favorito situado en la parte superior derecha para abrir el panel **Favoritos**.

1. En el panel **Favoritos**, elija el menú contextual (los tres puntos verticales) del favorito al que desee cambiar el nombre y, a continuación, elija **Cambiar el nombre**.

1. En el panel **Renombrar el marcador**, introduzca un nombre para el favorito y, a continuación, seleccione **Guardar**.

# Convertir un marcador en la vista predeterminada en Amazon Quick Sight
<a name="dashboard-bookmarks-default"></a>

De forma predeterminada, cuando actualizas un panel, Quick Sight recuerda esos cambios y los guarda después de cerrar el panel. De esta forma, puede continuar donde lo dejó al volver a abrir el panel. En su lugar, puede configurar un favorito como vista predeterminada de un panel. Si lo hace, cada vez que abra el panel, se le mostrará la vista de favoritos, independientemente de los cambios que haya realizado durante la última sesión. 

**Configuración de un favorito como vista predeterminada del panel**

1. En un panel publicado, elija el icono de favorito situado en la parte superior derecha para abrir el panel **Favoritos**.

1. En el panel **Favoritos**, elija el menú contextual (los tres puntos) del favorito que desee establecer como vista predeterminada y, a continuación, elija **Establecer como predeterminada**.

# Compartir marcadores en Amazon Quick Sight
<a name="dashboard-bookmarks-share"></a>

Después de crear un favorito, puede compartir un enlace URL de la vista con otras personas que tengan permiso para ver el panel. A continuación, podrán guardar esa vista en sus favoritos.

**Uso compartido de un favorito con otro suscriptor del panel**

1. En un panel publicado, elija el icono de favorito situado en la parte superior derecha para abrir el panel **Favoritos**.

1. En el panel **Favoritos**, elija el favorito que desee compartir para que el panel se actualice a esa vista.

1. Seleccione el icono de compartir en la esquina superior derecha y, a continuación, seleccione **Compartir esta vista**. 

   Puede copiar el enlace URL que proporciona Quick Sight y pegarlo en un correo electrónico o mensaje de mensajería instantánea para compartirlo con otras personas. A continuación, el destinatario del enlace URL puede guardar la vista como su propio favorito. Para obtener más información acerca del uso compartido de vistas de un panel, consulte [Compartir tu vista de un panel de Amazon Quick Sight](share-dashboard-view.md).

# Eliminar marcadores en Amazon Quick Sight
<a name="dashboard-bookmarks-delete"></a>

Utilice el siguiente procedimiento para eliminar un favorito.

**Eliminación de un favorito**

1. En un panel publicado, elija el icono de favorito situado en la parte superior derecha para abrir el panel **Favoritos**.

1. En el panel **Favoritos**, seleccione el menú contextual (los tres puntos verticales) del favorito que quiera eliminar y, a continuación, seleccione **Eliminar**.

1. En el panel **Eliminar favorito** que se abre, seleccione **Sí, eliminar de favoritos**.

# Obtener información con el aprendizaje automático (ML) en Amazon Quick Sight
<a name="making-data-driven-decisions-with-ml-in-quicksight"></a>

Amazon Quick Sight utiliza el aprendizaje automático para ayudarlo a descubrir información y tendencias ocultas en sus datos, identificar los factores clave y pronosticar las métricas empresariales. También puede consumir esta información en narraciones de lenguaje natural integrada en los paneles. 

Con capacidades de aprendizaje automático (ML) y lenguaje natural, Amazon Quick Sight Enterprise Edition lo lleva más allá del análisis descriptivo y de diagnóstico, y lo lanza a la previsión y la toma de decisiones. Puede entender sus datos de un vistazo, compartir sus hallazgos y detectar las mejores decisiones para lograr sus objetivos. Puede hacerlo sin necesidad de desarrollar equipos y tecnología para crear los modelos y algoritmos de machine learning necesarios. 

Es probable que ya haya creado visualizaciones que respondan a preguntas sobre lo que sucedió, cuándo y dónde, y que proporcionen información detallada para la investigación y la identificación de patrones. Con la información de machine learning puede evitar pasar horas analizando e investigando manualmente. Puede seleccionar de una lista de narraciones personalizadas sensibles al contexto, llamadas *narraciones automáticas*, y añadirlas a su análisis. Además de elegir las narraciones automáticas, puede optar por ver las previsiones, las anomalías y los factores que contribuyen a ellas. También puede añadir narraciones automáticas que expliquen las principales actividades en un lenguaje sencillo, proporcionando una única realidad basada en datos de su compañía. 

A medida que pasa el tiempo y los datos fluyen por el sistema, Amazon Quick Sight aprende continuamente para poder ofrecer información cada vez más pertinente. En lugar de decidir qué significan los datos, puede decidir qué hacer con la información que proporcionan. 

Con un fundamento compartido basado en el machine learning, todos sus analistas y partes interesadas pueden ver tendencias, anomalías, previsiones y narraciones personalizadas que se basan en millones de métricas. Pueden ver las causas principales, considerar las previsiones, evaluar los riesgos y tomar decisiones con fundamento y justificables. 

Puede crear un panel como este sin análisis manual, sin habilidades de desarrollo personalizadas y sin entender el modelado o los algoritmos de machine learning. Toda esta capacidad está integrada en Amazon Quick Sight Enterprise Edition.

**nota**  
Las capacidades de machine learning se utilizan según sea necesario en el producto. Las características que utilizan activamente el machine learning se etiquetan como tales. 

Con ML Insights, Amazon Quick Sight ofrece tres funciones principales:
+ Detección de **anomalías con tecnología ML:** Amazon Quick Sight utiliza la probada tecnología de aprendizaje automático de Amazon para analizar continuamente todos sus datos y detectar anomalías (valores atípicos). Puede identificar los principales factores que contribuyen a cualquier cambio significativo en las métricas de su empresa, como las higher-than-expected ventas o la caída del tráfico de su sitio web. Amazon Quick Sight utiliza el algoritmo Random Cut Forest en millones de métricas y miles de millones de puntos de datos. Esto le permite obtener información detallada que suele estar enterrada en los agregados e inaccesible a través del análisis manual. 
+ **Pronósticos basados en ML:** Amazon Quick Sight permite a los usuarios sin conocimientos técnicos pronosticar con confianza sus principales métricas empresariales. El algoritmo integrado de bosque de corte aleatorio del machine learning controla automáticamente complejos escenarios del mundo real, como la detección de estacionalidad y tendencias, la exclusión de valores atípicos y la imputación de valores perdidos. Puede interactuar con los datos de forma sencilla. point-and-click
+ **Narrativas** automáticas: al usar narrativas automáticas en Amazon Quick Sight, puede crear paneles completos con narrativas integradas para contar la historia de sus datos en un lenguaje sencillo. De este modo puede ahorrar horas de análisis de gráficos y tablas para extraer la información clave para la elaboración de informes. También crea una comprensión compartida de los datos en su organización para que pueda tomar decisiones más rápidamente. Puede utilizar la narración automática sugerida o puede personalizar los cálculos y el lenguaje para satisfacer sus necesidades únicas. Amazon Quick Sight es como proporcionar un analista de datos personales a todos sus usuarios.

**Topics**
+ [Descripción del algoritmo de aprendizaje automático que utiliza Amazon Quick Sight](concept-of-ml-algorithms.md)
+ [Requisitos de conjuntos de datos para usar información sobre aprendizaje automático con Amazon Quick Sight](ml-data-set-requirements.md)
+ [Cómo trabajar con información en Amazon Quick Sight](computational-insights.md)
+ [Creación de narrativas automáticas con Amazon Quick Sight](narratives-creating.md)
+ [Detección de valores atípicos mediante la detección de anomalías basada en ML](anomaly-detection.md)
+ [Previsión y creación de escenarios hipotéticos con Amazon Quick Sight](forecasts-and-whatifs.md)

# Descripción del algoritmo de aprendizaje automático que utiliza Amazon Quick Sight
<a name="concept-of-ml-algorithms"></a>


|  | 
| --- |
|  No necesita ninguna experiencia técnica en aprendizaje automático para utilizar las funciones de aprendizaje automático de Amazon Quick Sight. En esta sección, se analizan los aspectos técnicos del algoritmo, para quienes deseen conocer los detalles sobre cómo funciona. No es obligatorio leer esta información para utilizar las características.   | 

Amazon Quick Sight utiliza una versión integrada del algoritmo Random Cut Forest (RCF). En las siguientes secciones se explica qué significa y cómo se usa en Amazon Quick Sight.

En primer lugar, veamos algunos de los términos implicados: 
+ Anomalía: algo que se caracteriza por su diferencia con respecto a la mayoría del resto de cosas de la misma muestra. También se denomina valor atípico, excepción, desviación, etc.
+ Punto de datos: una unidad independiente o, dicho de manera sencilla, una fila de un conjunto de datos. Sin embargo, una fila puede contar con varios puntos de datos si utiliza una medida en diferentes dimensiones.
+ Árbol de toma de decisiones: una forma de visualizar el proceso de decisión del algoritmo que evalúa patrones en los datos.
+ Previsión: una predicción de un comportamiento futuro basada en el comportamiento actual y del pasado.
+ Modelo: una representación matemática del algoritmo o de lo que aprende el algoritmo.
+ Estacionalidad: la repetición de patrones de comportamiento que se dan cíclicamente en datos de serie temporal.
+ Series temporales: un conjunto ordenado de datos de fechas u horas en un campo o una columna.

**Topics**
+ [¿Cuál es la diferencia entre la detección de anomalías y la previsión?](difference-between-anomaly-detection-and-forecasting.md)
+ [¿Qué es RCF?](what-is-random-cut-forest.md)
+ [Cómo se aplica RCF para detectar anomalías](how-does-rcf-detect-anomalies.md)
+ [Cómo se aplica RCF para crear previsiones](how-does-rcf-generate-forecasts.md)
+ [Referencias sobre machine learning y RCF](learn-more-about-machine-learning-and-rcf.md)

# ¿Cuál es la diferencia entre la detección de anomalías y la previsión?
<a name="difference-between-anomaly-detection-and-forecasting"></a>

La detección de anomalías identifica los valores atípicos y los factores que contribuyen a que se produzcan, para responder a la pregunta «¿Qué ha ocurrido que no suele suceder?» La previsión responde a la pregunta: “Si todo sigue sucediendo del modo previsto, ¿qué ocurrirá en el futuro?”. El cálculo matemático que permite predecir también nos permite preguntarnos: “Si algunas cosas cambian, ¿qué sucederá?”. 

Tanto la previsión como la detección de anomalías comienzan por examinar los puntos de datos conocidos actualmente. La detección de anomalías de Amazon Quick Sight comienza con lo que se conoce para poder establecer lo que está fuera del conjunto conocido e identificar esos puntos de datos como anómalos (valores atípicos). Las previsiones de Amazon Quick Sight excluyen los puntos de datos anómalos y siguen el patrón conocido. La previsión se centra en el patrón establecido de la distribución de datos. Por el contrario, la detección de anomalías se centra en los puntos de datos que se desvían de lo previsto. Cada método aborda la toma de decisiones desde una dirección distinta. 

# ¿Qué es RCF?
<a name="what-is-random-cut-forest"></a>

Un *bosque de corte aleatorio* (RCF) es un tipo especial de algoritmo de *bosque aleatorio* (RF), una técnica que goza de amplia difusión en el machine learning. Este toma un conjunto de puntos de datos aleatorios, los reduce al mismo número de puntos y, a continuación, crea una colección de modelos. En contraste, un modelo corresponde a un árbol de decisiones, de ahí el nombre de bosque. Debido a que no se RFs puede actualizar fácilmente de forma incremental, RCFs se inventaron variables en la construcción de árboles que se diseñaron para permitir actualizaciones incrementales. 

Como algoritmo no supervisado, el RCF utiliza el análisis del clúster para detectar picos en los datos de serie temporal, interrupciones en la periodicidad o estacionalidad y excepciones de puntos de datos. Los bosques de corte aleatorio pueden funcionar como una sinopsis o un boceto de un flujo de datos dinámico (o una secuencia de números indexados en el tiempo). Las respuestas a nuestras preguntas sobre el flujo proceden de dicha sinopsis. Las siguientes características se aplican al flujo y al modo en que efectuamos las conexiones para la previsión y la detección de anomalías:
+ Un *algoritmo de streaming *es un algoritmo online que ocupa poco en la memoria. Un algoritmo online toma su decisión sobre el punto de entrada indexado por el tiempo **t** antes de ver el punto **(t\$11)**ésimo. El poco espacio en memoria permite algoritmos ágiles que pueden producir respuestas con baja latencia y permiten al usuario interactuar con los datos.
+ Respetar el orden impuesto por el tiempo, como en un algoritmo *online*, es necesario en la detección y previsión de anomalías. Si ya sabemos lo que sucederá pasado mañana, predecir lo que sucederá mañana no es un previsión, tan solo es una interpolación de un valor desconocido que falta. Del mismo modo, un nuevo producto presentado hoy puede ser una anomalía, pero no necesariamente lo seguirá siendo al final del próximo trimestre. 

# Cómo se aplica RCF para detectar anomalías
<a name="how-does-rcf-detect-anomalies"></a>

Una persona puede distinguir fácilmente un punto de datos que destaca del resto. RCF hace lo mismo mediante la creación de un “bosque” de árboles de decisión y, a continuación, monitorizando cómo los nuevos puntos de datos cambian el bosque. 

Una *anomalía* es un punto de datos que aleja su atención de los puntos normales. Piense, por ejemplo, en una imagen de una flor roja en un campo de flores amarillas. Este “desplazamiento de la atención” se codifica en la posición (esperada) de un árbol (es decir, un modelo en RCF) que estaría ocupado por el punto de entrada. La idea es crear un bosque donde cada árbol de decisiones crezca de una partición de los datos muestreados para entrenar el algoritmo. En términos más técnicos, cada árbol crea un tipo específico de árbol de partición de espacio binario en las muestras. A medida que Amazon Quick Sight toma muestras de los datos, RCF asigna a cada punto de datos una puntuación de anomalía. Concede puntuaciones más altas a los puntos de datos que parecen anómalos. La puntuación es, en aproximación, inversamente proporcional a la profundidad resultante del punto en el árbol. El bosque de corte aleatorio asigna una puntuación de anomalías calculando la puntuación media de cada árbol constituyente y escalando el resultado en relación con el tamaño de la muestra. 

Se suman los votos o las puntuaciones de los diferentes modelos porque cada uno de los modelos es, en sí mismo, un predictor débil. Amazon Quick Sight identifica un punto de datos como anómalo cuando su puntuación es significativamente diferente de los puntos recientes. La consideración de anomalía depende de la aplicación. 

El artículo [Random Cut Forest Based Anomaly Detection On Streams](http://proceedings.mlr.press/v48/guha16.pdf) proporciona varios ejemplos de esta detección de anomalías state-of-the-art en línea (detección de anomalías en series temporales). RCFsse utilizan en segmentos contiguos o «tejas» de datos, donde los datos del segmento inmediato actúan como contexto para el segmento más reciente. Las versiones anteriores de los algoritmos de detección de anomalías basados en RCF puntúan una capa completa. El algoritmo de Amazon Quick Sight también proporciona una ubicación aproximada de la anomalía en el contexto extendido actual. Esta ubicación aproximada puede ser útil en el caso de que se produzca un retraso en la detección de la anomalía. Los retrasos se deben a que cualquier algoritmo debe caracterizar las "desviaciones vistas anteriormente" como “desviaciones anómalas”, que pueden desarrollarse a lo largo del tiempo. 

# Cómo se aplica RCF para crear previsiones
<a name="how-does-rcf-generate-forecasts"></a>

Para prever el siguiente valor en una secuencia temporal estacionaria, el algoritmo RCF responde a la pregunta: “¿Cuál sería la finalización más probable, después de tener un valor candidato?”. Utiliza un solo árbol en el RCF para realizar una búsqueda del mejor candidato. Se agregan los candidatos en los diferentes árboles, porque cada uno, en sí mismo, es un predictor débil. La agregación también permite la generación de errores de cuantiles. Este proceso se repite **v** veces para predecir el valor **v**ésimo en el futuro. 

El algoritmo de Amazon Quick Sight se denomina *BIFOCAL*. Utiliza dos RCFs para crear una FOrest arquitectura de CALibrated BI. El primer RCF se utiliza para filtrar las anomalías y proporcionar una previsión débil, que se corrige con el segundo. En general, este enfoque proporciona previsiones significativamente más sólidas en comparación con otros algoritmos de amplia disponibilidad, como ETS. 

El número de parámetros del algoritmo de pronóstico Quick Sight de Amazon es significativamente menor que el de otros algoritmos ampliamente disponibles. Esto permite que sea útil de manera inmediata, sin ajustes manuales para un mayor número de puntos de datos de series temporales. A medida que se acumulan más datos en una serie temporal determinada, las previsiones de Amazon Quick Sight se pueden ajustar a las desviaciones de los datos y a los cambios de patrón. En el caso de las series temporales que muestran tendencias, la detección de estas se realiza en primer lugar para convertir la serie en estacionaria. La previsión de esa secuencia estacionaria se proyecta con la tendencia. 

Debido a que el algoritmo se basa en un eficiente algoritmo online (RCF), puede admitir consultas “condicionales” interactivas. En estas, algunas de las previsiones se pueden modificar y tratar como casos hipotéticos para ofrecer previsiones condicionales. Este es el origen de la capacidad de explorar escenarios “condicionales” durante el análisis. 

# Referencias sobre machine learning y RCF
<a name="learn-more-about-machine-learning-and-rcf"></a>

Para obtener más información sobre el machine learning y este algoritmo, sugerimos los siguientes recursos:
+ En el artículo [Robust Random Cut Forest (RRCF): A No Math Explanation](https://www.linkedin.com/pulse/robust-random-cut-forest-rrcf-math-explanation-logan-wilt/) se ofrece una explicación lúcida sin las ecuaciones matemáticas. 
+ El libro [*The Elements of Statistical Learning: Data Mining, Inference, and Prediction*, Second Edition (Springer Series in Statistics)](https://www.amazon.com/Elements-Statistical-Learning-Prediction-Statistics/dp/0387848576) constituye una base sólida para el machine learning. 
+ [http://proceedings.mlr.press/v48/guha16.pdf](http://proceedings.mlr.press/v48/guha16.pdf), un documento técnico académico que examina en profundidad los aspectos técnicos de la previsión y la detección de anomalías con ejemplos. 

En otros AWS servicios aparece un enfoque diferente del RCF. Si desea saber cómo se utiliza el RCF en otros servicios, consulte los siguientes temas:
+ *Amazon Managed Service para Apache Flink Referencia de SQL:* [https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sqlrf-random-cut-forest-with-explanation.html](https://docs.aws.amazon.com/kinesisanalytics/latest/sqlref/sqlrf-random-cut-forest-with-explanation.html)
+ *Guía para SageMaker desarrolladores de Amazon:* [algoritmo Random Cut Forest (RCF)](https://docs.aws.amazon.com/sagemaker/latest/dg/randomcutforest.html). Este enfoque también se explica en [The Random Cut Forest Algorithm](https://freecontent.manning.com/the-randomcutforest-algorithm/), un capítulo de [Machine Learning for Business](https://www.amazon.com/Machine-Learning-Business-Doug-Hudgeon/dp/1617295833/ref=sr_1_3) (octubre de 2018). 

# Requisitos de conjuntos de datos para usar información sobre aprendizaje automático con Amazon Quick Sight
<a name="ml-data-set-requirements"></a>

Para empezar a utilizar las capacidades de aprendizaje automático de Amazon Quick Sight, debe conectarse a sus datos o importarlos. Puede usar un conjunto de datos de Amazon Quick Sight existente o crear uno nuevo. Puede consultar directamente su origen compatible con SQL o adquirir los datos en SPICE. 

Los datos deben tener las siguientes propiedades: 
+  Al menos una métrica (por ejemplo, ventas, pedidos, unidades enviadas, inscripciones, etc.). 
+  Al menos una dimensión de categoría (por ejemplo, categoría de producto, canal, segmento, sector, etc.). Se ignoran las categorías con valores NULL.
+ La detección de anomalías requiere un mínimo de 15 puntos de datos para el entrenamiento. Por ejemplo, si la frecuencia de datos es diaria, necesita al menos 15 días de datos. Si la frecuencia es mensual, necesita al menos 15 meses de datos. 
+ La previsión funciona mejor con más datos. Asegúrese de que su conjunto de datos tenga suficientes datos históricos para obtener resultados óptimos. Por ejemplo, si la frecuencia de datos es diaria, necesita al menos 38 días de datos. Si la frecuencia es mensual, necesita al menos 43 meses de datos. A continuación se muestran los requisitos para cada frecuencia de tiempo:
  + Años: 32 puntos de datos
  + Trimestres: 35 puntos de datos
  + Meses: 43 puntos de datos
  + Semanas: 35 puntos de datos
  + Días: 38 puntos de datos
  + Horas: 39 puntos de datos
  + Minutos: 46 puntos de datos
  + Segundos: 46 puntos de datos
+ Si desea analizar anomalías o previsiones, también necesita al menos una dimensión de fecha. 

Si no tiene un conjunto de datos para comenzar, puede descargar este de muestra: [Conjunto de datos de muestra VI de ML Insights](samples/ml-insights.csv.zip). Después de tener listo un conjunto de datos, cree un nuevo análisis a partir de él.

# Cómo trabajar con información en Amazon Quick Sight
<a name="computational-insights"></a>

En Amazon Quick Sight, puede añadir cálculos ready-to-use analíticos a sus análisis como widgets. Puede trabajar con la información de dos formas:
+ **Información sugerida**

  Amazon Quick Sight crea una lista de información sugerida en función de su interpretación de los datos que incluye en sus imágenes. La lista cambia en función del contexto. En otras palabras, puede ver diferentes sugerencias según los campos que añada a su elemento visual y el tipo de elemento visual que elija. Por ejemplo, si tiene una visualización de series temporales, sus conocimientos pueden incluir period-over-period cambios, anomalías y previsiones. A medida que añada más visualizaciones a su análisis, generará más sugerencias de información.
+ **Información personalizada**

  La información personalizada le permite crear su propio cálculo, utilizando sus propias palabras para dar contexto a los campos que aparecen en el widget. Al crear información personalizada, se añade al análisis y, a continuación, se elige el tipo de cálculo que se desea utilizar. Después, puede añadir texto y formato para que tenga el aspecto que desea. También puede añadir más campos, cálculos y parámetros.

Puede añadir cualquier combinación de información sugerida y personalizada a su análisis para crear el entorno de toma de decisiones que mejor se adapte a sus fines.

**Topics**
+ [Adición de información sugerida](adding-suggested-insights.md)
+ [Adición de información personalizada a su análisis](adding-insights.md)

# Adición de información sugerida
<a name="adding-suggested-insights"></a>

Utilice el siguiente procedimiento para añadir información sugerida a su análisis.

Antes de comenzar, asegúrese de que el conjunto de datos cumpla los criterios que se describen en [Requisitos de conjuntos de datos para usar información sobre aprendizaje automático con Amazon Quick Sight](ml-data-set-requirements.md).

1. Comience con un análisis que tenga unos pocos campos añadidos a un elemento visual. 

1. A la izquierda, seleccione **Información**. Se abre el panel **Perspectivas** y muestra una lista de ideas ready-to-use sugeridas. 

   Cada elemento visual también muestra un pequeño cuadro en su borde superior para indicar la cantidad de información disponible para dicho elemento visual. Puede elegir este cuadro para abrir el panel **Información**, que se abre en cualquier vista que haya abierto más recientemente.

   Desplácese hacia abajo para obtener una vista previa de más información. 

   El tipo de datos de los campos que elija incluir en el elemento visual controla la información que aparece. Esta lista se genera cada vez que cambie el elemento visual. Si hace cambios, consulte **Información** para ver las novedades. Para obtener una información concreta, consulte [Adición de información personalizada a su análisis](adding-insights.md).

1. (Opcional) Abra el menú contextual con más opciones para una información. Para ello, elija los puntos suspensivos en la parte superior derecha de la información (**…**).

   Las opciones son diferentes para cada tipo de información. Entre las opciones con las que puede interactuar se incluyen las siguientes:
   + **Cambiar la agregación de serie temporal**: a año, trimestre, mes, semana, día, hora o minuto.
   + **Analizar las contribuciones a las métricas**: elija las contribuciones y un periodo de tiempo para analizar.
   + **Mostrar todas las anomalías**: se buscarán las anomalías en este periodo de tiempo.
   + **Editar previsión**: elija la duración de la previsión, el intervalo de predicción y la estacionalidad.
   + **Centrarse en** o **Excluir**: permiten aumentar o reducir los datos dimensionales.
   + **Mostrar detalles**: se muestra más información sobre una anomalía reciente (valor atípico).
   + Proporcione comentarios sobre la utilidad de la información en su análisis.

1. Para agregar una sugerencia de información en su análisis, seleccione el signo más (**\$1**) cerca del título de la información.

1. (Opcional) Después de añadir una información a su análisis, personalice la narración que desea que se muestre. Para ello, seleccione el menú en el elemento visual en forma de **v** y, a continuación, **Personalizar narración**. Para obtener más información, consulte [Creación de narrativas automáticas con Amazon Quick Sight](narratives-creating.md).

   Si la información es de anomalías (valores atípicos), también puede cambiar la configuración del trabajo de detección de anomalías. Para ello, elija **Configure anomalía**. Para obtener más información, consulte [Configuración de la detección de anomalías basada en ML para el análisis de valores atípicos](anomaly-detection-using.md).

1. (Opcional) Para eliminar la información de su análisis, elija en el elemento menú visual en forma de **v** en la parte superior derecha del elemento visual. A continuación, elija **Eliminar**. 

# Adición de información personalizada a su análisis
<a name="adding-insights"></a>

Si no desea utilizar la información sugerida, puede crear su información personalizada. Siga este procedimiento para crear una información informática personalizada.

1. Comience con un análisis existente. En la barra de menú superior, elija **Agregar**. A continuación, elija **Agregar información**. 

   Se añade al análisis un contenedor para la nueva información.

1. Realice una de las siguientes acciones:
   + Seleccione el cálculo que desea utilizar de la lista. A medida que selecciona cada elemento, se muestra un ejemplo de la salida de esa información. Cuando encuentre la que desea utilizar, elija **Seleccionar**. 
   + Salga de esta pantalla y personalice la información manualmente. Una información no configurada tiene el botón **Personalizar información**. Elija el botón para abrir la pantalla **Configurar narración**. Para obtener más información acerca del uso del editor de expresiones, consulte [Creación de narrativas automáticas con Amazon Quick Sight](narratives-creating.md). 

   Debido a que está iniciando la creación de la información, no se basa en un elemento visual existente. Cuando se añade la información al análisis, se muestra una nota que presenta el tipo de datos que necesita para completar su solicitud. Por ejemplo, podría solicitar **1 dimensión en el tiempo**. En este caso, añada una dimensión al cuadro de campos **Tiempo**. 

1. Una vez que tenga los datos correctos, siga las restantes instrucciones de la pantalla para terminar de crear la información personalizada.

1. (Opcional) Para eliminar la información de su análisis, elija en el elemento menú visual en forma de **v** en la parte superior derecha del elemento visual. A continuación, elija **Eliminar**. 

# Creación de narrativas automáticas con Amazon Quick Sight
<a name="narratives-creating"></a>

Una *narración automática *es un widget de resumen en lenguaje natural que muestra texto descriptivo en lugar de gráficos. Puede integrar estos widgets en su análisis para resaltar las informaciones y las llamadas clave. No tiene que analizar el elemento visual, desglosar, comparar valores y volver a revisar las ideas para extraer una conclusión. Tampoco es necesario que intente comprender el significado de los datos ni que debata las diferentes interpretaciones con sus compañeros. En su lugar, puede extrapolar la conclusión a partir de los datos y mostrarla en el análisis, como se indica claramente. Una sola interpretación puede ser compartida por todos.

Amazon Quick Sight interpreta automáticamente los gráficos y las tablas del panel de control y proporciona una serie de sugerencias de información en lenguaje natural. La información sugerida que puede elegir ya está preparada e incluye texto, cálculos y funciones. Pero puede cambiarla si lo desea. También puede diseñar una propia. Como autor del panel, tiene total flexibilidad para personalizar los cálculos y el texto según sus necesidades. Puede utilizar narraciones para contar de un modo eficaz la historia de sus datos en un lenguaje sencillo.

**nota**  
Las narraciones son independientes del machine learning. Solo utilizan el machine learning si se añaden cálculos de previsión o de anomalías (valores atípicos).

**Topics**
+ [Información que incluye narraciones automáticas](auto-narratives.md)
+ [Uso del editor de expresiones de narración](using-narratives-expression-editor-step-by-step.md)
+ [Espacio de trabajo del editor de expresiones](using-narratives-expression-editor-menus.md)
+ [Añadir URLs](using-narratives-expression-editor-urls.md)
+ [Uso de cálculos de narraciones automáticas](auto-narrative-computations.md)

# Información que incluye narraciones automáticas
<a name="auto-narratives"></a>

Cuando se añade una información, también conocida como narración automática, al análisis, puede elegir una de las siguientes plantillas. En la siguiente lista, se definen mediante un ejemplo. Cada definición incluye una lista de los campos obligatorios mínimos para que la narración automática funcione. Si utiliza únicamente la información sugerida en la pestaña **Información**, elija los campos correspondientes para obtener la información que se mostrará en la lista de información sugerida.

Para obtener más información sobre la personalización de las narraciones automáticas, consulte [Uso de cálculos de narraciones automáticas](auto-narrative-computations.md)
+ **Peor clasificado**: por ejemplo, los tres últimos estados por ingresos de ventas. Requiere que disponga de al menos una dimensión en el cuadro de campo **Categorías**. 
+ **Impulsores inferiores**: por ejemplo, los tres últimos productos vendidos, por ingresos de ventas. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo** y al menos una dimensión en el cuadro de campo **Categorías**. 
+ **Previsión** *(información basada en ML)*: por ejemplo, “Se prevé un total de ventas de 58 613 USD para enero de 2016”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**. 
+ **Tasa de crecimiento**: por ejemplo, “La tasa de crecimiento compuesto de las ventas en 3 meses es del 22,23 %”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**. 
+ **Máximo**: por ejemplo, “El mes más alto es noviembre de 2014, con ventas de 112 326 USD”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**. 
+ **Comparación de métricas**: por ejemplo, “El total de ventas de diciembre de 2014 es de 90 474 USD, un 10 % más que el objetivo de 81 426 USD”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo** y al menos dos medidas en el cuadro de campo **Valores**. 
+ **Mínimo**: por ejemplo, “El mes más bajo es febrero de 2011, con ventas de 4810 USD”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**. 
+ **Detección de anomalías** *(información basada en ML)*: por ejemplo, los tres valores atípicos principales y los factores que contribuyen a que se produzcan para el total de las ventas del 3 de enero de 2019. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**, al menos una medida en el cuadro de campo **Valores** y al menos una dimensión en el cuadro de campo **Categorías**. 
+ **Periodo por periodo**: por ejemplo, “El total de ventas de noviembre de 2014 aumentó un 44,39 % (34 532 USD) de 77 793 USD a 112 326 USD”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**. 
+ **Período hasta la fecha**: por ejemplo, «ear-to-datelas ventas de Y del 30 de noviembre de 2014 aumentaron un 25,87% (132.236 dólares), pasando de 511.236 dólares a 643.472 dólares». Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo**. 
+ **Mejor clasificado**: por ejemplo, los tres primeros estados por ingresos de ventas. Requiere que disponga de al menos una dimensión en el cuadro de campo **Categorías**. 
+ **Impulsores principales**: por ejemplo, los mejores productos por ingresos de ventas en noviembre de 2014. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo** y al menos una dimensión en el cuadro de campo **Categorías**. 
+ **Suma total**: por ejemplo, “Los ingresos totales son de 2 297 200 USD”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Tiempo** y al menos una medida en el cuadro de campo **Valores**. 
+ **Valores únicos**: por ejemplo, “Hay 793 valores únicos en `Customer_IDs`”. Requiere que disponga de al menos una dimensión en el cuadro de campo **Categorías**. 

# Uso del editor de expresiones de narración
<a name="using-narratives-expression-editor-step-by-step"></a>

El siguiente tutorial muestra un ejemplo de cómo personalizar una narración. En este ejemplo utilizamos un tipo de cálculo de periodo a periodo.

1. Comience con un análisis existente. Agréguele una **información de periodo a periodo**. La forma más fácil de hacerlo es elegir el icono \$1, **Agregar información** y, a continuación, un tipo de información de la lista. Para saber qué tipo de información computacional puede añadir como narraciones automáticas, consulte [Información que incluye narraciones automáticas](auto-narratives.md).

   Después de elegir un tipo de información, elija **Seleccionar** para crear el widget. Para crear una narración vacía, cierre esta pantalla sin elegir una plantilla. Para seguir este ejemplo, seleccione **Periodo por periodo**.

   Si seleccionó un elemento visual cuando agregó la información, los cuadros de campos tienen campos preconfigurados para la fecha, la métrica y la categoría. Proceden de la visualización que eligió al crear la información. Es posible personalizar los campos según sea necesario.

   Solo puede personalizar una narración para un widget de información (basada en texto) nuevo o ya existente. No puede añadir uno a un elemento visual existente (basado en gráfico), porque es un tipo diferente de widget. 

1. Edite la narración en el editor de expresiones eligiendo el menú del elemento visual y, a continuación, **Personalizar narración**.

   En este contexto, los **cálculos** son cálculos predefinidos (period-over-period, period-to-date, tasa de crecimiento, valores máximos, mínimos, máximos, máximos, etc.) a los que puede hacer referencia en la plantilla para describir los datos. Actualmente, Amazon Quick Sight admite 13 tipos diferentes de cálculos que puede añadir a sus conocimientos. En este ejemplo, **PeriodOverPeriod**se añade de forma predeterminada porque elegimos la plantilla **Periodo tras Periodo** del panel de información sugerida. 

1. Elija **Añadir cálculo** en parte inferior derecha para agregar un nuevo cálculo y, a continuación, elija uno de la lista. Para este tutorial, elija **Tasa de crecimiento** y, a continuación, **Siguiente**.

1. Configure el cálculo eligiendo el número de periodos en los que desea realizar el cálculo. El valor predeterminado es cuatro y sirve para nuestro ejemplo. También puede cambiar el nombre del cálculo en la parte superior de la pantalla. Sin embargo, para nuestro propósito, no cambie el nombre.
**nota**  
Los nombres de cálculo que cree son únicos en la información. Puede hacer referencia a varios cálculos del mismo tipo en su plantilla de narración. Por ejemplo, suponga que tiene dos métricas, ingresos de ventas y unidades vendidas. Puede crear cálculos de la tasa de crecimiento para cada métrica, siempre y cuando tengan nombres diferentes.   
Sin embargo, los cálculos de anomalías no son compatibles con ningún otro tipo de cálculo en el mismo widget. La detección de anomalías debe existir en una información por sí misma. Para utilizar otros cálculos en el mismo análisis, inclúyalos en informaciones independientes de las anomalías.

   Para continuar, elija **Añadir**.

1. Expanda **Cálculos** en la parte derecha. Los cálculos que forman parte de la narración se muestran en la lista. En este caso, es **PeriodOverPeriod**y **GrowthRate**. 

1. En el espacio de trabajo, agregue el siguiente texto después del período final: **Compounded growth rate for the last** y, después, agregue un espacio.

1. A continuación, para agregar el cálculo, deje el cursor después del espacio, tras la palabra **last** A la derecha, debajo **GrowthRate**, elija la expresión denominada **TimePeriods** (haga clic solo una vez para añadirla). 

   De este modo, se inserta la expresión **GrowthRate.TimePeriods**, que es el número de períodos para los que se establece en la configuración. **GrowthRate** 

1. **Complete la oración con ** days is ** (un espacio antes y después) y añada la expresión. GrowthRate compoundedGrowthRate.formattedValue**, seguido de un punto (). `.` Elija la expresión de la lista, en lugar de escribirla. Sin embargo, puede editar el contenido de la expresión después de añadirla.  
![\[Editor de expresiones con lista de expresiones abierta.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/narrative-add-expression.png)
**nota**  
La expresión **formattedValue** devuelve una cadena que se formatea según el formato aplicado a la métrica en el campo. Para realizar el cálculo de métrica, utilice **valor** en su lugar, que devuelve el valor bruto como un entero o un decimal.

1. Añada una instrucción condicional y un formato. Coloque el cursor al final de la plantilla, después de la expresión `formattedValue`. Agregue un espacio, si es necesario. En la barra de menús **Editar narración**, elija **Insertar código** y, a continuación, seleccione **Instrucción IF insertada** en la lista. Se abre un bloque de expresión.

1. Con el bloque de expresiones abierto, elija, **GrowthRate**compoundedGrowthRate****, **valor en la lista** de expresiones. Escriba **>0** al final de la expresión. Seleccione **Save**. No mueva el cursor todavía.

   Aparece una solicitud del contenido condicional; escriba **better than expected\$1**. A continuación, seleccione el texto que acaba de escribir y use la barra de herramientas de formato en la parte superior para ponerlo en verde y en negrita.

1. Repita el paso anterior para añadir otro bloque de expresión para el caso en el que la tasa de crecimiento no haya sido tan grande. Pero esta vez, conviértalo en **<0** y escriba el texto **worse than expected**. Cámbielo a color rojo en vez de verde. 

1. Seleccione **Save**. La narración personalizada que acabamos de crear debe ser similar a la siguiente.  
![\[Narración personalizada.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/narrative-example-result.png)

El editor de expresiones le proporciona una herramienta sofisticada para personalizar las narraciones. También puede hacer referencia a los parámetros que crea para el análisis o panel, y utilizar un conjunto de funciones integradas para ofrecer una mayor personalización.

**sugerencia**  
Para crear una narración vacía, añada una información con el icono **\$1** y, a continuación, **Añadir información**. Pero en lugar de elegir una plantilla, cierre la pantalla.   
La mejor manera de comenzar a personalizar narraciones es usar las plantillas existentes para aprender la sintaxis.

# Espacio de trabajo del editor de expresiones
<a name="using-narratives-expression-editor-menus"></a>

Use el editor de expresiones para personalizar una narración que se adapte mejor a las necesidades de su empresa. La siguiente información proporciona una descripción general del espacio de trabajo del editor de expresiones y enumera todas las opciones de menú que se pueden configurar para su narración. Para ver un tutorial que muestra cómo crear una narración personalizada, consulte [Uso del editor de expresiones de narración](using-narratives-expression-editor-step-by-step.md).

En el lado derecho de la pantalla hay una lista de los elementos que puede agregar a la narración:
+ **Cálculos**: utilice esta opción para elegir entre los cálculos disponibles en este apartado. La lista puede expandirse.
+ **Parámetros**: utilice esta opción para elegir entre los parámetros que existen en el análisis. La lista puede expandirse.
+ **Funciones**: utilice esta opción para elegir entre las funciones que se pueden agregar a una narración. La lista puede expandirse.
+ **Agregar cálculo**: utilice este botón para crear otro cálculo. Los nuevos cálculos aparecen en la lista **Cálculos**, listos para agregarlos a la información.

En la parte inferior del editor de expresiones de narración aparece una vista previa de la narración, que se actualiza a medida que trabaja. Además, se muestra una alerta en esta área en caso de introducirse un error en la narración o si la narración está vacía. Para obtener una vista previa de la información basada en ML, como las previsiones o la detección de anomalías, ejecute su información al menos una vez antes de personalizar la narración. 

Las herramientas de edición se encuentran en la parte superior de la pantalla. Ofrecen las siguientes opciones:
+ **Insertar código**: puede insertar los siguientes bloques de código desde este menú:
  + **Expresiones**: agregue una expresión de forma libre. 
  + **IF en línea**: agregue una instrucción IF que aparezca en línea con el bloque de texto existente. 
  + **FOR en línea**: agregue una instrucción FOR que aparezca en línea con el bloque de texto existente.
  + **IF en bloque**: agregue una instrucción IF que aparezca en un bloque de texto independiente. 
  + **FOR en bloque**: agregue una instrucción FOR que aparezca en un bloque de texto independiente. 

  Las instrucciones IF y FOR le permiten crear contenido con formato condicional. Por ejemplo, puede agregar una instrucción **IF en bloque** y, a continuación, configurarla para comparar un entero con el valor de un cálculo. Para ello, realice los pasos siguientes, que también se muestran en [Uso del editor de expresiones de narración](using-narratives-expression-editor-step-by-step.md):

  1. Abra el menú de cálculos a la derecha y elija uno de los elementos resaltados en azul de uno de los cálculos. Al hacerlo, el elemento se agrega a la narración.

  1. Haga clic una vez en el elemento para abrirlo.

  1. Escriba la comparación que desea realizar. La expresión tiene un aspecto similar a este: `PeriodOverPeriod.currentMetricValue.value>0`. 

  1. Guarde la expresión en el editor emergente, que solicita **Contenido condicional**. 

  1. Escriba los elementos que desea incluir en la información y aplique formato para que aparezcan tal y como desea. Si lo prefiere, puede agregar una imagen o una URL o bien agregar una URL a una imagen.
+ **Párrafo**: este menú ofrece opciones para cambiar el tamaño de la fuente:
  + **Encabezado grande H1**
  + Encabezado H2
  + Encabezado pequeño H3
  + ¶1 Párrafo grande
  + ¶2 Párrafo
  + ¶3 Párrafo pequeño
+ **Fuente**: utilice esta bandeja de menús para elegir opciones de formato de texto. Entre estas se incluyen las opciones de negrita, cursiva, subrayado, tachado, color de primer plano del texto (las propias letras) y color de fondo de este. Elija el icono para activar una opción y vuelva a elegirlo para desactivarla.
+ **Formato**: utilice esta bandeja de menús para elegir opciones de formato de párrafos, como la lista con viñetas, el alineado a la izquierda o a la derecha y el centrado. Elija el icono para activar una opción y vuelva a elegirlo para desactivarla.
+ **Imagen**: utilice este icono para agregar la URL de una imagen. La imagen se muestra en la información, siempre que se pueda acceder al enlace. El tamaño de las imágenes puede modificarse. Para mostrar una imagen en función de una condición, incluya dicha imagen dentro de un bloque IF.
+ **URL**: utilice este icono para agregar una URL estática o dinámica. También puede añadir URLs a las imágenes. Por ejemplo, puede agregar imágenes de indicadores de semáforo a la información de un panel ejecutivo, con enlaces a una nueva hoja en función de las distintas condiciones: rojo, ámbar y verde.

# Añadir URLs
<a name="using-narratives-expression-editor-urls"></a>

Con el botón **URL** del menú de edición del editor de expresiones narrativas, puede añadir elementos estáticos y dinámicos URLs (hipervínculos) a una narración. También puede utilizar los siguientes métodos abreviados de teclado: ⌘\$1⇧\$1L o Ctrl\$1⇧\$1L. 

Una URL estática es un enlace que no cambia; siempre abre la misma URL. Una URL dinámica es un enlace que cambia en función de las expresiones o parámetros que se proporcionan al configurarlo. Se construye con expresiones o parámetros evaluados dinámicamente. 

A continuación se muestran algunos ejemplos de cuándo puede agregarse un enlace estático a la narración: 
+ **En una instrucción IF, puede usar la URL en el contenido condicional.** Si lo hace y alguna de las métricas no cumple un valor esperado, es posible que el enlace envíe al usuario a una wiki con una lista de prácticas recomendadas para mejorar la métrica. 
+ **Puede usar una URL estática para crear un enlace a otra hoja en el mismo panel, si realiza los pasos siguientes:**

  1. Vaya a la hoja para la que desea crear el enlace.

  1. Copie la URL de esa hoja.

  1. Vuelva al editor de narraciones y cree un enlace con la URL que acaba de copiar.

A continuación se muestran algunos ejemplos de cuándo puede agregarse un enlace dinámico a la narración: 
+ **Para buscar en un sitio web con una consulta, siga estos pasos.**

  1. Cree una URL con el enlace siguiente.

     ```
     https://google.com?q=<<formatDate(now(),'yyyy-MM-dd')>>
     ```

     El enlace envía una consulta a Google con el texto de búsqueda, que es el valor evaluado de lo siguiente.

     ```
     formatDate(now(), 'yyyy-MM-dd')
     ```

     Si el valor de `now()` es `02/02/2020`, el enlace de la narración contiene `https://google.com?q=2020-02-02`.
+ **Para crear un enlace que actualice un parámetro.** Para ello, cree o edite un enlace y establezca la URL en la dirección URL de análisis o del panel actual. A continuación, agregue la expresión que establece el valor del parámetro al final, por ejemplo, `#p.myParameter=12345`. 

  Supongamos que el siguiente es el enlace el panel con el que comienza.

  ```
  https://us-east-1.quicksight.aws.amazon.com/sn/analyses/00000000-1111-2222-3333-44444444
  ```

  Si le agrega una asignación de valor de parámetro, tendrá el siguiente aspecto.

  ```
  https://us-east-1.quicksight.aws.amazon.com/sn/analyses/00000000-1111-2222-3333-44444444#p.myParameter=12345
  ```

  Para obtener más información sobre los parámetros de URLs, consulte[Uso de parámetros en una URL](parameters-in-a-url.md).

# Uso de cálculos de narraciones automáticas
<a name="auto-narrative-computations"></a>

Utilice esta sección para comprender las funciones que tiene a su disposición cuando personalice una narración automática. Solo necesita personalizar una narración si desea cambiar o ampliar el cálculo predeterminado.

Después de crear una narración automática, se abre el editor de expresiones. También puede activar el editor de expresiones eligiendo el menú en el elemento visual y, a continuación, **Personalizar narración**. Para añadir un cálculo con el editor de expresiones, seleccione **\$1 Añadir cálculo**.

Puede usar la siguiente expresión de código para crear su narración automática. Está disponible en la lista que está etiquetada como **Insertar código**. Las instrucciones de código pueden mostrarse insertadas (en una frase) o como un bloque (en una lista).
+ Expresión: cree su propia expresión de código.
+ IF: una instrucción IF que incluye una expresión después de evaluar una condición. 
+ FOR: una instrucción FOR que recorre los valores. 

Puede usar los siguientes cálculos para crear su narración automática. Puede usar el editor de expresiones sin editar la sintaxis, pero también puede personalizarla si lo desea. Para interactuar con la sintaxis, abra el widget de cálculo en el editor de expresiones de narraciones automáticas.

**Topics**
+ [Detección de anomalías basada en ML para valores atípicos](anomaly-detection-function.md)
+ [Cálculo de impulsores inferiores](bottom-movers-function.md)
+ [Cálculo de peor clasificado](bottom-ranked-function.md)
+ [Previsión basada en ML](forecast-function.md)
+ [Cálculo de tasa de crecimiento](growth-rate-function.md)
+ [Cálculo de máximo](maximum-function.md)
+ [Cálculo de comparación de métricas](metric-comparison-function.md)
+ [Cálculo de mínimo](minimum-function.md)
+ [Cálculo de periodo por periodo](period-over-period-function.md)
+ [Cálculo de periodo hasta fecha concreta](period-to-date-function.md)
+ [Cálculo de impulsores principales](top-movers-function.md)
+ [Cálculo de mejor clasificado](top-ranked-function.md)
+ [Cálculo de suma total](total-aggregation-function.md)
+ [Cálculo de valores únicos](unique-values-function.md)

# Detección de anomalías basada en ML para valores atípicos
<a name="anomaly-detection-function"></a>

El cálculo de detección de anomalías basada en ML busca valores atípicos en los datos. Por ejemplo, puede detectar los tres valores atípicos más importantes del total de ventas del 3 de enero de 2019. Si habilita el análisis de contribuciones, también puede detectar los factores clave que contribuyen a generar cada valor atípico. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**, al menos una medida en el cuadro de campo **Valores** y al menos una dimensión en el cuadro de campo **Categorías**. La pantalla de configuración proporciona una opción para analizar la contribución de otros campos en tanto que factores clave, aunque esos campos no pertenezcan a los cuadros de campo.

Para obtener más información, consulte [Detección de valores atípicos mediante la detección de anomalías basada en ML](anomaly-detection.md).

**nota**  
No puede añadir la detección de anomalías basada en ML a otro cálculo y no puede añadir otro cálculo a una detección de anomalías.

## Resultados del cálculo
<a name="anomaly-detection-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Puede utilizar los elementos que se muestran en **`bold monospace font`** a continuación en la narración. 
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `categoryFields`: del cuadro de campo **Categorías**.
  + `name`: el nombre de visualización con formato del campo.
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `itemsCount`: el número de elementos incluidos en este cálculo.
+ `items`: elementos anómalos.
  + `timeValue`: los valores en la dimensión de fecha.
    + `value`: el campo de fecha/hora en el punto de la anomalía (valor atípico).
    + `formattedValue`— El valor formateado del date/time campo en el punto de la anomalía.
  + `categoryName`: el nombre real de la categoría (cat1, cat2, etc.).
  + `direction`: la dirección en el eje x o el eje y que se identifica como anómala: `HIGH` o `LOW`. `HIGH` significa “más alto de lo esperado”. `LOW` significa “más bajo de lo esperado”. 

    Al iterar sobre elementos, `AnomalyDetection.items[index].direction` puede contener `HIGH` o `LOW`. Por ejemplo, `AnomalyDetection.items[index].direction='HIGH'` o `AnomalyDetection.items[index].direction=LOW`. `AnomalyDetection.direction` puede tener una cadena vacía para `ALL`. Un ejemplo es `AnomalyDetection.direction=''`. 
  + `actualValue`: el valor real de la métrica en el punto de la anomalía o valor atípico.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
  + `expectedValue`: el valor previsto de la métrica en el punto de la anomalía (valor atípico).
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.

# Cálculo de impulsores inferiores
<a name="bottom-movers-function"></a>

El cálculo de los impulsores inferiores cuenta el número de categorías solicitadas por fecha que se encuentran en la parte inferior del conjunto de datos de la narración automática. Por ejemplo, puede crear un cálculo para encontrar los tres últimos productos vendidos, por ingresos de ventas.

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo** y al menos una dimensión en el cuadro de campo **Categorías**. 

## Parameters
<a name="bottom-movers-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar.

*Categoría*   
La dimensión de categoría que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

*Número de impulsores*   
El número de resultados clasificados que desea mostrar.

*Ordenar por*   
La orden que desea utilizar: diferencia porcentual o diferencia absoluta.

## Resultados del cálculo
<a name="bottom-movers-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 

**nota**  
Estos son los mismos parámetros de salida que los que devuelve el cálculo de impulsores principales.
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `categoryField`: del cuadro de campo **Categorías**.
  + `name`: el nombre de visualización con formato del campo.
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `startTimeValue`: el valor en la dimensión de fecha.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `endTimeValue`: el valor en la dimensión de fecha.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor absoluto con formato del campo de fecha y hora.
+ `itemsCount`: el número de elementos incluidos en este cálculo.
+ `items`: elementos transferibles inferiores.
  + `categoryField`: el campo de categoría.
    + `value`: el valor (contenido) del campo de categoría.
    + `formattedValue`: el valor con formato (contenido) del campo de categoría. Si el campo es nulo, se muestra “`NULL`”. Si el campo está vacío, se muestra “`(empty)`”.
  + `currentMetricValue`: el valor actual del campo de métrica.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
  + `previousMetricValue`: el valor anterior del campo de métrica.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
  + `percentDifference`: la diferencia porcentual entre los valores actual y anterior del campo de métrica.
    + `value`: el valor sin formato del cálculo de la diferencia porcentual.
    + `formattedValue`: el valor con formato de la diferencia porcentual (por ejemplo, -42 %).
    + `formattedAbsoluteValue`: el valor absoluto con formato de la diferencia porcentual (por ejemplo, 42 %).
  + `absoluteDifference`: la diferencia absoluta entre los valores actual y anterior del campo de métrica.
    + `value`: el valor sin formato del cálculo de la diferencia absoluta.
    + `formattedValue`: la diferencia absoluta con formato de la configuración en las preferencias de formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto de la diferencia con formato del campo de métrica.

# Cálculo de peor clasificado
<a name="bottom-ranked-function"></a>

El cálculo de peor clasificado calcula el número de categorías solicitadas por valor que se encuentran en la parte inferior del conjunto de datos de la narración automática. Por ejemplo, puede crear un cálculo para encontrar los tres últimos estados, por ingresos de ventas.

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Categorías**. 

## Parameters
<a name="bottom-ranked-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Categoría*   
La dimensión de categoría que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

*Número de resultados*   
El número de resultados clasificados que desea mostrar.

## Resultados del cálculo
<a name="bottom-ranked-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 

**nota**  
Estos son los mismos parámetros de salida que los que devuelve el cálculo mejor clasificado.
+ `categoryField`: del cuadro de campo **Categorías**.
  + `name`: el nombre de visualización con formato del campo.
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `itemsCount`: el número de elementos incluidos en este cálculo.
+ `items`: elementos peor clasificados.
  + `categoryField`: el campo de categoría.
    + `value`: el valor (contenido) del campo de categoría.
    + `formattedValue`: el valor con formato (contenido) del campo de categoría. Si el campo es nulo, se muestra “`NULL`”. Si el campo está vacío, se muestra “`(empty)`”.
  + `metricValue`: el campo de métrica.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.

## Ejemplo
<a name="bottom-ranked-function-example"></a>

En la siguiente captura de pantalla se muestra la configuración predeterminada para el cálculo de peor clasificado.

![\[Configuración predeterminada para el cálculo de peor clasificado.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/bottom-ranked-computation.png)


# Previsión basada en ML
<a name="forecast-function"></a>

El cálculo de la previsión basada en machine learning prevé métricas futuras basándose en patrones de métricas anteriores por estacionalidad. Por ejemplo, puede crear un cálculo para prever los ingresos totales de los próximos seis meses.

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**. 

Para obtener más información sobre el uso de las previsiones, consulte [Previsión y creación de escenarios hipotéticos con Amazon Quick Sight](forecasts-and-whatifs.md).

## Parameters
<a name="forecast-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

*Periodos futuros*   
El número de periodos de tiempo en el futuro que desea prever. Va de 1 a 1000.

*Periodos pasados*   
El número de periodos de tiempo en el pasado en los que desea basar la previsión. Va de 0 a 1000.

*Estacionalidad*   
El número de estaciones incluidas en el año natural. La configuración predeterminada, **automático**, lo detecta automáticamente. Va de 1 a 180.

## Resultados del cálculo
<a name="forecast-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `metricValue`: el valor en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `timeValue`: el valor en la dimensión de fecha.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha.
+ `relativePeriodsToForecast`: el número relativo de periodos ente el último registro de fecha y hora y el último registro de previsión.

# Cálculo de tasa de crecimiento
<a name="growth-rate-function"></a>

El cálculo de la tasa de crecimiento compara valores a lo largo de periodos de tiempo. Por ejemplo, puede crear un cálculo para encontrar la tasa de crecimiento compuesto de tres meses para las ventas, expresada como un porcentaje.

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**. 

## Parameters
<a name="growth-rate-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

*Número de periodos*   
El número de periodos de tiempo en el futuro que desea utilizar para calcular la tasa de crecimiento.

## Resultados del cálculo
<a name="growth-rate-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `previousMetricValue`: el valor anterior en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `previousTimeValue`: el valor anterior en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `compoundedGrowthRate`: la diferencia porcentual entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia porcentual.
  + `formattedValue`: el valor con formato de la diferencia porcentual (por ejemplo, -42 %).
  + `formattedAbsoluteValue`: el valor absoluto con formato de la diferencia porcentual (por ejemplo, 42 %).
+ `absoluteDifference`: la diferencia absoluta entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia absoluta.
  + `formattedValue`: la diferencia absoluta con formato de la configuración en las preferencias de formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto de la diferencia con formato del campo de métrica.

# Cálculo de máximo
<a name="maximum-function"></a>

El cálculo de máximo encuentra la dimensión máxima por valor. Por ejemplo, puede crear un cálculo para encontrar el mes con los ingresos más altos. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**. 

## Parameters
<a name="maximum-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

## Resultados del cálculo
<a name="maximum-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 

**nota**  
Estos son los mismos parámetros de salida que los que devuelve el cálculo del mínimo.
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `metricValue`: el valor en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `timeValue`: el valor en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.

# Cálculo de comparación de métricas
<a name="metric-comparison-function"></a>

El cálculo de comparación de métricas compara valores en diferentes medidas. Por ejemplo, puede crear un cálculo para comparar dos valores, como las ventas reales comparadas con los objetivos de ventas. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo** y al menos dos medidas en el cuadro de campo **Valores**. 

## Parameters
<a name="metric-comparison-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

*Valor de destino*   
El campo que desea comparar con el valor.

## Resultados del cálculo
<a name="metric-comparison-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `fromMetricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `fromMetricValue`: el valor en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `toMetricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `toMetricValue`: el valor actual en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `timeValue`: el valor en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `percentDifference`: la diferencia porcentual entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia porcentual.
  + `formattedValue`: el valor con formato de la diferencia porcentual (por ejemplo, -42 %).
  + `formattedAbsoluteValue`: el valor absoluto con formato de la diferencia porcentual (por ejemplo, 42 %).
+ `absoluteDifference`: la diferencia absoluta entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia absoluta.
  + `formattedValue`: la diferencia absoluta con formato de la configuración en las preferencias de formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto de la diferencia con formato del campo de métrica.

# Cálculo de mínimo
<a name="minimum-function"></a>

El cálculo de mínimo encuentra la dimensión mínima por valor. Por ejemplo, puede crear un cálculo para encontrar el mes con los ingresos más bajos. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**. 

## Parameters
<a name="minimum-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar.

*Valor*   
La medida agregada en la que se basa el cálculo.

## Resultados del cálculo
<a name="maximum-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 

**nota**  
Estos son los mismos parámetros de salida que los que devuelve el cálculo del máximo.
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `metricValue`: el valor en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `timeValue`: el valor en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.

# Cálculo de periodo por periodo
<a name="period-over-period-function"></a>

El cálculo de periodo por periodo compara valores de dos periodos de tiempo diferentes. Por ejemplo, puede crear un cálculo para averiguar cuánto aumentaron o disminuyeron las ventas desde el periodo de tiempo anterior. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**. 

## Parameters
<a name="period-over-period-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar. 

*Valor*   
La medida agregada en la que se basa el cálculo. 

## Resultados del cálculo
<a name="period-over-period-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `previousMetricValue`: el valor anterior en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `previousTimeValue`: el valor anterior en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `currentMetricValue`: el valor actual en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `currentTimeValue`: el valor actual en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `percentDifference`: la diferencia porcentual entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia porcentual.
  + `formattedValue`: el valor con formato de la diferencia porcentual (por ejemplo, -42 %).
  + `formattedAbsoluteValue`: el valor absoluto con formato de la diferencia porcentual (por ejemplo, 42 %).
+ `absoluteDifference`: la diferencia absoluta entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia absoluta.
  + `formattedValue`: la diferencia absoluta con formato de la configuración en las preferencias de formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto de la diferencia con formato del campo de métrica.

## Ejemplo
<a name="period-over-period-computation-example"></a>

**Creación de un cálculo de periodo por periodo**

1. En el análisis que desee cambiar, elija **Agregar información**.

1. En **Tipo de cálculo**, elija **Período por período** y, a continuación, elija **Seleccionar**.

1. En la nueva información que ha creado, añada los campos de dimensión de tiempo y dimensión de valor que desee comparar. En la captura de pantalla siguiente, `Order Date` y `Sales (Sum)` se agregan a la información. Con estos dos campos seleccionados, Quick Sight muestra las ventas del último mes en lo que va de año y la diferencia porcentual en comparación con el mes anterior.  
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/periodOverPeriod1.png)

1. (Opcional) Para personalizar aún más la información, abra el menú visual y seleccione **Personalizar narración**. En la ventana **Editar narrativa** que aparece, arrastre y suelte los campos que necesite de la lista **Cálculos** y, a continuación, seleccione **Guardar**.

# Cálculo de periodo hasta fecha concreta
<a name="period-to-date-function"></a>

El cálculo del periodo hasta la fecha evalúa los valores de un periodo hasta una fecha concreta especificado. Por ejemplo, puede crear un cálculo para averiguar cuánto ha ganado en year-to-date ventas. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo**. 

## Parameters
<a name="period-to-date-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Fecha*   
La dimensión de fecha que desea clasificar. 

*Valor*   
La medida agregada en la que se basa el cálculo. 

*Grado de detalle del periodo de tiempo*   
El grado de detalle de fechas que desea utilizar para el cálculo, por ejemplo, año a año.

## Resultados del cálculo
<a name="period-to-date-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `timeField`: del cuadro de campo **Tiempo**. 
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `metricField`: del cuadro de campo **Valores**. 
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `previousMetricValue`: el valor anterior en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `previousTimeValue`: el valor anterior en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `currentMetricValue`: el valor actual en la dimensión de métrica.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
+ `currentTimeValue`: el valor actual en la dimensión de fecha y hora.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `periodGranularity`: el grado de detalle del periodo para este cálculo (**MES**, **AÑO**, etc.).
+ `percentDifference`: la diferencia porcentual entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia porcentual.
  + `formattedValue`: el valor con formato de la diferencia porcentual (por ejemplo, -42 %).
  + `formattedAbsoluteValue`: el valor absoluto con formato de la diferencia porcentual (por ejemplo, 42 %).
+ `absoluteDifference`: la diferencia absoluta entre los valores actual y anterior del campo de métrica.
  + `value`: el valor sin formato del cálculo de la diferencia absoluta.
  + `formattedValue`: la diferencia absoluta con formato de la configuración en las preferencias de formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto de la diferencia con formato del campo de métrica.

## Ejemplo
<a name="period-to-date-computation-example"></a>

**Creación de un cálculo de período hasta fecha concreta**

1. En el análisis que desee cambiar, elija **Agregar información**.

1. En **Tipo de cálculo**, elija **Período hasta fecha concreta** y, a continuación, elija **Seleccionar**.

1. En la nueva información que ha creado, agregue los campos de dimensión de tiempo y dimensión de valor que desee comparar. En la captura de pantalla siguiente, `Order Date` y `Sales (Sum)` se agregan a la información. Con estos dos campos seleccionados, Quick Sight muestra las ventas del último mes en lo que va de año y la diferencia porcentual en comparación con el mes anterior.  
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/periodOverPeriod1.png)

1. (Opcional) Para personalizar aún más la información, abra el menú visual y seleccione **Personalizar narración**. En la ventana **Editar narrativa** que aparece, arrastre y suelte los campos que necesite de la lista **Cálculos** y, a continuación, seleccione **Guardar**.

# Cálculo de impulsores principales
<a name="top-movers-function"></a>

El cálculo de los impulsores principales cuenta el número de categorías solicitadas por fecha que se encuentran en la parte superior del conjunto de datos de la narración automática. Por ejemplo, puede crear un cálculo para encontrar los tres primeros productos por ingresos de ventas durante un periodo de tiempo.

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo** y al menos una dimensión en el cuadro de campo **Categorías**. 

## Parameters
<a name="top-movers-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Categoría*   
La dimensión de categoría que desea clasificar. 

*Valor*   
La medida agregada en la que se basa el cálculo. 

*Número de resultados*   
El número de elementos de la clasificación superior que desea encontrar.

## Resultados del cálculo
<a name="top-movers-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 

**nota**  
Estos son los mismos parámetros de salida que los que devuelve el cálculo de impulsores inferiores.
+ `timeField`: del cuadro de campo **Tiempo**.
  + `name`: el nombre de visualización con formato del campo.
  + `timeGranularity`: el grado de detalle del campo de tiempo (**DÍA**, **AÑO**, etc.).
+ `categoryField`: del cuadro de campo **Categorías**.
  + `name`: el nombre de visualización con formato del campo.
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `startTimeValue`: el valor en la dimensión de fecha.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de fecha y hora.
+ `endTimeValue`: el valor en la dimensión de fecha.
  + `value`: el valor sin formato.
  + `formattedValue`: el valor absoluto con formato del campo de fecha y hora.
+ `itemsCount`: el número de elementos incluidos en este cálculo.
+ `items`: elementos transferibles superiores.
  + `categoryField`: el campo de categoría.
    + `value`: el valor (contenido) del campo de categoría.
    + `formattedValue`: el valor con formato (contenido) del campo de categoría. Si el campo es nulo, se muestra “`NULL`”. Si el campo está vacío, se muestra “`(empty)`”.
  + `currentMetricValue`: el valor actual del campo de métrica.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
  + `previousMetricValue`: el valor anterior del campo de métrica.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.
  + `percentDifference`: la diferencia porcentual entre los valores actual y anterior del campo de métrica.
    + `value`: el valor sin formato del cálculo de la diferencia porcentual.
    + `formattedValue`: el valor con formato de la diferencia porcentual (por ejemplo, -42 %).
    + `formattedAbsoluteValue`: el valor absoluto con formato de la diferencia porcentual (por ejemplo, 42 %).
  + `absoluteDifference`: la diferencia absoluta entre los valores actual y anterior del campo de métrica.
    + `value`: el valor sin formato del cálculo de la diferencia absoluta.
    + `formattedValue`: la diferencia absoluta con formato de la configuración en las preferencias de formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto de la diferencia con formato del campo de métrica.

# Cálculo de mejor clasificado
<a name="top-ranked-function"></a>

El cálculo de mejor clasificado encuentra las dimensiones de la clasificación superior por valor. Por ejemplo, puede crear un cálculo para encontrar los tres primeros estados, por ingresos de ventas. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Categorías**. 

## Parameters
<a name="top-ranked-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Categoría*   
La dimensión de categoría que desea clasificar. 

*Valor*   
La medida agregada en la que se basa el cálculo. 

*Número de resultados*   
El número de elementos de la clasificación superior que desea encontrar.

## Resultados del cálculo
<a name="top-ranked-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 

**nota**  
Estos son los mismos parámetros de salida que los que devuelve el cálculo peor clasificado.
+ `categoryField`: del cuadro de campo **Categorías**.
  + `name`: el nombre de visualización con formato del campo.
+ `metricField`: del cuadro de campo **Valores**.
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `itemsCount`: el número de elementos incluidos en este cálculo.
+ `items`: elementos mejor clasificados.
  + `categoryField`: el campo de categoría.
    + `value`: el valor (contenido) del campo de categoría.
    + `formattedValue`: el valor con formato (contenido) del campo de categoría. Si el campo es nulo, se muestra “`NULL`”. Si el campo está vacío, se muestra “`(empty)`”.
  + `metricValue`: el campo de métrica.
    + `value`: el valor sin formato.
    + `formattedValue`: el valor con formato del campo de métrica.
    + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.

# Cálculo de suma total
<a name="total-aggregation-function"></a>

El cálculo de suma total crea un total general del valor. Por ejemplo, puede crear un cálculo para encontrar los ingresos totales. 

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Tiempo** y al menos una medida en el cuadro de campo **Valores**. 

## Parameters
<a name="total-aggregation-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Valor*   
La medida agregada en la que se basa el cálculo. 

## Resultados del cálculo
<a name="total-aggregation-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `categoryField`: el campo de categoría. 
  + `name`: el nombre de visualización del campo de categoría.
+ `metricField`: del cuadro de campo **Valores**. 
  + `name`: el nombre de visualización con formato del campo.
  + `aggregationFunction`: la agregación utilizada para la métrica (**SUMA**, **PROMEDIO**, etc.).
+ `totalAggregate`: el valor total de la agregación de métricas. 
  + `value`: el valor sin formato.
  + `formattedValue`: el valor con formato del campo de métrica.
  + `formattedAbsoluteValue`: el valor absoluto con formato del campo de métrica.

# Cálculo de valores únicos
<a name="unique-values-function"></a>

El cálculo de valores únicos cuenta los valores únicos en un campo de categoría. Por ejemplo, puede crear un cálculo para contar el número de valores únicos de una dimensión, como el número de clientes que tiene.

Para utilizar esta función, necesita de al menos una dimensión en el cuadro de campo **Categorías**. 

## Parameters
<a name="unique-values-function-parameters"></a>

*name*   
Un nombre descriptivo único que se asigna o modifica. Se asigna un nombre si no crea uno. Puede editarlo más adelante.

*Categoría*   
La dimensión de categoría que desea clasificar. 

## Resultados del cálculo
<a name="unique-values-computation-outputs"></a>

Cada función genera un conjunto de parámetros de salida. Puede añadir estos resultados a la narración automática para personalizar qué se muestra. También puede añadir su propio texto personalizado. 

Para localizar los parámetros de salida, abra la pestaña **Cálculos** a la derecha y localice el cálculo que desea utilizar. Los nombres de los cálculos provienen del nombre que proporciona al crear la información. Elija el parámetro de salida haciendo clic solo una vez. Si hace clic dos veces, añade el mismo resultado dos veces. Los elementos que se muestran en **negrita** se pueden utilizar en la narración. 
+ `categoryField`: el campo de categoría. 
  + `name`: el nombre de visualización del campo de categoría.
+ `uniqueGroupValuesCount`: el número de valores únicos incluidos en este cálculo. 

# Detección de valores atípicos mediante la detección de anomalías basada en ML
<a name="anomaly-detection"></a>

Amazon Quick Sight utiliza la tecnología comprobada de Amazon para ejecutar de forma continua la detección de anomalías mediante ML en millones de métricas para descubrir tendencias ocultas y valores atípicos en sus datos. Esta herramienta le permite obtener información detallada que suele estar oculta en los agregados y que no es escalable con el análisis manual. Con la detección de anomalías basada en ML, puede encontrar valores atípicos en sus datos sin necesidad de analizarlos manualmente, realizar desarrollos personalizados ni tener experiencia en el ámbito del ML. 

Amazon Quick Sight le notifica en sus imágenes si detecta que puede analizar una anomalía o realizar alguna previsión con sus datos. 

La detección de anomalías no está disponible en la región de `eu-central-2` Europa (Zúrich).

**importante**  
La detección de anomalías basada en ML es una tarea de cómputo intensivo. Antes de comenzar a utilizarla, puede hacerse una idea de los costos si analiza la cantidad de datos que desea utilizar. Ofrecemos un modelo de precios por niveles que se basa en el número de métricas que procesa por mes. 

**Topics**
+ [Conceptos relativos a la detección de anomalías o valores atípicos](anomaly-detection-outliers-and-key-drivers.md)
+ [Configuración de la detección de anomalías basada en ML para el análisis de valores atípicos](anomaly-detection-using.md)
+ [Exploración de los valores atípicos y los factores clave con la detección de anomalías basada en ML y el análisis de contribuciones](anomaly-exploring.md)

# Conceptos relativos a la detección de anomalías o valores atípicos
<a name="anomaly-detection-outliers-and-key-drivers"></a>

Amazon Quick Sight usa la palabra *anomalía* para describir los puntos de datos que quedan fuera de un patrón general de distribución. Hay muchos otros términos que se refieren a las anomalías, que es un término científico, tales como valores atípicos, desviaciones, rarezas, excepciones, irregularidades o peculiaridades, entre otros. El término utilizado puede basarse en el tipo de análisis que se lleva a cabo, en el tipo de datos que se utiliza o, incluso, en las preferencias del grupo. Estos puntos de datos atípicos representan una entidad (una persona, un lugar, un objeto o un momento) que es excepcional de alguna manera. 

Los seres humanos reconocemos fácilmente los patrones y detectamos los elementos que no son como los demás. Nuestros sentidos nos proporcionan esta información. Si el patrón es simple y la cantidad de datos es reducida, se puede trazar fácilmente un gráfico para resaltar los valores atípicos presentes en los datos. A continuación citamos algunos ejemplos sencillos:
+ Un globo rojo en un grupo de globos azules
+ Un caballo de carreras que está muy por delante de los demás
+ Un niño que no está prestando atención durante la clase
+ Un día en que los pedidos en línea han subido pero los envíos han bajado
+ Una persona que se ha curado entre varias que no

Algunos puntos de datos representan un hecho significativo y otros representan un suceso aleatorio. El análisis revela qué datos merece la pena investigar, en función de los factores que han contribuido al hecho (factores clave). Las preguntas son esenciales para el análisis de datos. ¿Por qué ha sucedido? ¿Con qué está relacionado? ¿Ha ocurrido una sola vez o muchas? ¿Qué se puede hacer para fomentar o evitar que se produzcan casos iguales? 

Comprender cómo y por qué se produce una variación, así como si existe algún un patrón en las variaciones, requiere más reflexión. Sin la ayuda del machine learning, cada persona puede llegar a una conclusión diferente, porque tienen diferentes experiencias e información. Por lo tanto, cada persona podría tomar una decisión de negocio ligeramente diferente. Si hay muchos datos o variables que tener en cuenta, el esfuerzo de análisis puede ser abrumador. 

La detección de anomalías basada en ML identifica las causas y las correlaciones que permiten tomar decisiones basadas en datos. Usted controla la definición de cómo desea efectuar el trabajo con los datos. Puede especificar sus propios parámetros y elegir opciones adicionales, tales como identificar los factores clave en un análisis de contribuciones. Si lo prefiere, puede utilizar la configuración predeterminada. La siguiente sección le guía a lo largo del proceso de configuración y proporciona explicaciones sobre las opciones disponibles. 

# Configuración de la detección de anomalías basada en ML para el análisis de valores atípicos
<a name="anomaly-detection-using"></a>

Utilice los procedimientos de las siguientes secciones para empezar a detectar valores atípicos, detectar anomalías e identificar los factores clave que contribuyen a que se produzcan.

**Topics**
+ [Visualización de notificaciones de anomalías y previsiones](anomaly-detection-adding-from-visuals.md)
+ [Adición de información sobre el ML para detectar valores atípicos y factores clave](anomaly-detection-adding-anomaly-insights.md)
+ [Uso del análisis de contribuciones para los factores clave](anomaly-detection-adding-key-drivers.md)

# Visualización de notificaciones de anomalías y previsiones
<a name="anomaly-detection-adding-from-visuals"></a>

Amazon Quick Sight le notifica de forma visual si detecta una anomalía, factores clave o una oportunidad de previsión. Puede seguir las instrucciones para configurar la detección o la previsión de anomalías en función de los datos de ese elemento visual.

1. En un gráfico de líneas existente, busque una notificación de información en el menú del widget visual. 

1. Selecciona el icono de la bombilla para mostrar la notificación.

1. Si quiere obtener más información acerca de la información sobre el ML, puede seguir las instrucciones de la pantalla para agregar información sobre el ML.

# Adición de información sobre el ML para detectar valores atípicos y factores clave
<a name="anomaly-detection-adding-anomaly-insights"></a>

Puede agregar información sobre el ML que detecte *anomalías*, que son valores atípicos que parecen significativos. Para empezar, debe crear un widget para la información, también conocido como *narración automática*. A medida que vaya configurando sus opciones, podrá ver una captura de pantalla limitada de la información en el panel **Vista previa** situado a la derecha de la pantalla.

En el widget de información, puede agregar hasta cinco campos de dimensiones que no sean campos calculados. En los pozos de campo, los valores de **las categorías** representan los valores dimensionales que Amazon Quick Sight utiliza para dividir la métrica. Por ejemplo, supongamos que está analizando los ingresos de todas las categorías de productos y productos SKUs. Hay 10 categorías de productos, cada una con 10 productos SKUs. Amazon Quick Sight divide la métrica entre las 100 combinaciones únicas y realiza la detección de anomalías en cada combinación de la división.

El siguiente procedimiento muestra cómo hacerlo y también cómo agregar un análisis de contribuciones para detectar los factores clave que causan cada anomalía. Puede agregar el análisis de contribuciones más adelante, tal y como se describe en [Uso del análisis de contribuciones para los factores clave](anomaly-detection-adding-key-drivers.md).

**Configuración de análisis de valores atípicos, incluidos los factores clave**

1. Abra el análisis y, en la barra de herramientas, elija **Información** y, continuación, **Agregar**. En la lista, elija **Detección de anomalías** y **Seleccionar**.

1. Siga las instrucciones de la pantalla del nuevo widget, que le indican que elija los campos para la información. Agregue al menos una fecha, una medida y una dimensión. 

1. Seleccione **Comenzar** en el widget. Aparecerá la pantalla de configuración.

1. En **Opciones de cálculo**, elija valores para las siguientes opciones.

   1. En **Combinaciones que desee analizar**, elija una de las siguientes opciones:

      1. **Jerárquico**

         Elija esta opción si desea analizar los campos de forma jerárquica. Por ejemplo, si ha elegido una fecha (T), una medida (N) y categorías de tres dimensiones (C1, C2 y C3), Quick Sight analiza los campos jerárquicamente, como se muestra a continuación.

         ```
         T-N, T-C1-N, T-C1-C2-N, T-C1-C2-C3-N
         ```

      1. **Exacto**

         Elija esta opción si desea analizar únicamente la combinación exacta de campos del cuadro de campo Categoría, tal como aparecen en la lista. Por ejemplo, si eligió una fecha (T), una medida (N) y categorías tridimensionales (C1, C2 y C3), Quick Sight analiza solo la combinación exacta de los campos de categoría en el orden en que aparecen, como se muestra a continuación.

         ```
         T-C1-C2-C3-N
         ```

      1. **Todo**

         Elija esta opción si desea analizar todas las combinaciones de campos del cuadro de campo Categoría. Por ejemplo, si eligió una fecha (T), una medida (N) y categorías de tres dimensiones (C1, C2 y C3), Quick Sight analiza todas las combinaciones de campos, como se muestra a continuación.

         ```
         T-N, T-C1-N, T-C1-C2-N, T-C1-C2-C3-N, T-C1-C3-N, T-C2-N, T-C2-C3-N, T-C3-N
         ```

      Si ha elegido solo una fecha y una medida, Quick Sight analiza los campos por fecha y, después, por medida.

      En la sección **Campos que se van a analizar** puede ver una lista de campos de los cuadros de campo, con fines de referencia.

   1. En **Nombre**, introduzca un nombre alfanumérico descriptivo sin espacios o elija el valor predeterminado. Proporciona un nombre para el cálculo.

      Si va a editar la narración que se muestra automáticamente en el widget, puede usar su nombre para identificar el cálculo de este widget. Personalice el nombre si tiene previsto editar la narración automática y tiene otros cálculos similares en el análisis.

1. En la sección **Opciones de visualización**, elija las siguientes opciones para personalizar lo que se muestra en el widget de información. Puede seguir explorando todos los resultados, independientemente de lo que muestre.

   1. **Número máximo de anomalías que se pueden mostrar**: el número de valores atípicos que quiere mostrar en el widget narrativo. 

   1. **Gravedad**: el nivel mínimo de gravedad de las anomalías que desea mostrar en el widget de información.

      Un *nivel de gravedad* es un rango de puntuaciones de anomalía que se caracteriza por la puntuación de anomalía real más baja incluida en el rango. Todas las anomalías que tengan una puntuación más alta se incluyen en el rango. Si establece la gravedad en **Baja**, la información muestra todas las anomalías que se sitúan entre las gravedades baja y muy alta. Si establece la gravedad en **Muy alta**, la información muestra solo las anomalías que tienen las puntuaciones de anomalía más altas.

      Puede usar las siguientes opciones:
      + **Muy alta** 
      + **Alta y más** 
      + **Media y más** 
      + **Baja y más** 

   1. **Dirección**: la dirección en el eje x o el eje y que desea identificar como anómala. Puede elegir entre las siguientes opciones:
      + **Más alto de lo esperado** para identificar valores más altos como anomalías.
      + **Más bajo de lo esperado** para identificar valores más bajos como anomalías. 
      + **[TODOS]** para identificar todos los valores anómalos, altos y bajos (configuración predeterminada).

   1. **Delta**: introduzca un valor personalizado para usarlo para identificar anomalías. Cualquier cantidad superior al valor de umbral se considerará una anomalía. Los valores que se especifican aquí cambian el modo en que opera la información en el análisis. En esta sección, puede establecer lo siguiente:
      + **Valor absoluto**: el valor real que desea usar. Por ejemplo, supongamos que es 48. A continuación, Amazon Quick Sight identifica los valores como anómalos cuando la diferencia entre un valor y el valor esperado es superior a 48. 
      + **Porcentaje**: umbral porcentual que desea utilizar. Por ejemplo, supongamos que es 12,5 %. A continuación, Amazon Quick Sight identifica los valores como anómalos cuando la diferencia entre un valor y el valor esperado es superior al 12,5%.

   1. **Ordenar por**: elija un método de clasificación para los resultados. Algunos métodos se basan en la puntuación de anomalías que genera Amazon Quick Sight. Amazon Quick Sight otorga puntuaciones más altas a los puntos de datos que parecen anómalos. Puede utilizar cualquiera de las siguientes opciones: 
      + **Puntuación de anomalías ponderada**: la puntuación de anomalías multiplicada por el registro del valor absoluto de la diferencia entre el valor real y el valor esperado. Esta puntuación es siempre un número positivo. 
      + **Puntuación de anomalías**: la puntuación de anomalías real asignada a este punto de datos.
      + **Diferencia ponderada del valor esperado**: la puntuación de anomalías multiplicada por la diferencia entre el valor real y el valor esperado (predeterminado).
      + **Diferencia del valor esperado**: la diferencia real entre el valor real y el valor esperado (es decir, real esperado).
      + **Valor real**: el valor real sin la fórmula aplicada.

1. En la sección **Programación** puede establecer la programación con el fin de ejecutar automáticamente el nuevo cálculo de información. La programación se ejecuta solo para los paneles publicados. En el análisis, puede ejecutarlo manualmente según sea necesario. La programación incluye las opciones siguientes.
   + **Incidencia**: la frecuencia con la que se desea que se ejecute el recálculo: cada hora, cada día, cada semana o cada mes.
   + **Iniciar programación el**: establezca la fecha y la hora para comenzar la ejecución de esta programación.
   + **Zona horaria**: establezca la zona horaria en la que se ejecuta la programación. Para ver una lista, elimine la entrada actual. 

1. En la sección **Colaboradores principales**, configure Amazon Quick Sight para que analice los factores clave cuando se detecte un valor atípico (anomalía).

   Por ejemplo, Amazon Quick Sight puede mostrar los principales clientes que contribuyeron al aumento de las ventas de productos de mejoras para el hogar en EE. UU. Puede agregar hasta cuatro dimensiones a su conjunto de datos. Estas incluyen dimensiones que no agregó a los cuadros de campo de este widget de información.

   Para ver una lista de dimensiones disponibles para el análisis de contribuciones, elija **Seleccionar campos**.

1. Seleccione **Guardar** para confirmar sus opciones. Elija **Cancelar** para salir sin guardar.

1. En el widget de información, elija **Ejecutar ahora** para ejecutar la detección de anomalías y ver la información.

El periodo de tiempo que tarda en completarse la detección de anomalías varía según el número de puntos de datos únicos que esté analizando. El proceso puede durar unos minutos para un número mínimo de puntos o puede durar muchas horas.

Mientras se ejecuta en segundo plano, puede realizar otras tareas en su análisis. Asegúrese de que se complete antes de cambiar la configuración, editar la narración o abrir la página **Explorar anomalías** correspondiente a esta información.

El widget de información debe ejecutarse al menos una vez para que pueda ver los resultados. Si cree que el estado podría no estar actualizado, puede actualizar la página. La información puede tener los siguientes estados.


| Aparece en la página | Status | 
| --- | --- | 
| Botón Ejecutar ahora | El trabajo aún no ha comenzado. | 
| Mensaje Analizando en busca de anomalías | El trabajo se está ejecutando actualmente. | 
| Narración sobre las anomalías detectadas (valores atípicos)  | El trabajo se ha ejecutado correctamente. El mensaje indica cuándo se actualizó por última vez el cálculo de este widget. | 
| Icono de alerta con un signo de exclamación (\$1)  | Este icono indica que se ha producido un error durante la última ejecución. Si también aparece la narración, puede usar Explorar anomalías para utilizar los datos de la última ejecución correcta.  | 

# Uso del análisis de contribuciones para los factores clave
<a name="anomaly-detection-adding-key-drivers"></a>

Amazon Quick Sight puede identificar las dimensiones (categorías) que contribuyen a los valores atípicos en las medidas (métricas) entre dos momentos. El factor clave que contribuye a la aparición de un valor atípico le ayuda a responder a la siguiente pregunta: ¿Qué causó esta anomalía? 

Si ya utiliza la detección de anomalías sin un análisis de contribuciones, puede utilizar la información sobre el ML existente para encontrar los factores clave. Utilice el siguiente procedimiento para agregar un análisis de contribuciones e identificar los factores clave que se encuentran detrás de los valores atípicos. La información para la detección de anomalías debe incluir un campo de tiempo y al menos una métrica agregada (SUMA, PROMEDIO o RECUENTO). Si lo desea, puede incluir varias categorías (campos de dimensiones), pero también puede realizar un análisis de contribuciones sin especificar ningún campo de categoría o dimensión.

También puede utilizar este procedimiento para cambiar o eliminar campos como factores clave en la detección de anomalías.

**Adición de un análisis de contribuciones a fin de identificar los factores clave**

1. Abra el análisis y localice información sobre el ML existente para la detección de anomalías. Seleccione el widget de información para resaltarlo.

1. Seleccione **Opciones de menú** (**...**) en el menú del elemento visual.

1. Seleccione **Configurar anomalía** para editar la configuración.

1. La configuración **Análisis de contribución (opcional)** permite a Amazon Quick Sight analizar los factores clave cuando se detecta un valor atípico (anomalía). Por ejemplo, Amazon Quick Sight puede mostrarte los principales clientes que han contribuido al aumento de las ventas de productos de mejoras para el hogar en EE. UU. Puede agregar hasta cuatro dimensiones del conjunto de datos, incluidas las dimensiones que no agregó a los cuadros de campo de este widget de información.

   Para ver una lista de dimensiones disponibles para el análisis de contribuciones, seleccione **Seleccionar campos**.

   Si desea cambiar los campos que utiliza como factores clave, cambie los campos que están habilitados en esta lista. Si los desactiva todos, Quick Sight no realizará ningún análisis de contribución a esta información.

1. Para guardar los cambios, desplácese hasta la parte inferior de las opciones de configuración y elija **Guardar**. Para salir sin guardar, elija **Cancelar**. Para eliminar completamente esta configuración, elija **Eliminar**.

# Exploración de los valores atípicos y los factores clave con la detección de anomalías basada en ML y el análisis de contribuciones
<a name="anomaly-exploring"></a>

Puede explorar de forma interactiva las anomalías (también denominadas valores atípicos) en su análisis, junto con los contribuidores (controladores clave). El análisis está disponible después de que se haya ejecutado la detección de anomalías basada en ML. Los cambios que se efectúan en esta pantalla no se guardan al volver al análisis.

Para empezar, elija **Explorar anomalías** en la información. En la siguiente captura de pantalla se muestra la pantalla de anomalías tal y como aparece la primera vez que la abre. En este ejemplo, el análisis de los colaboradores está configurado y muestra dos factores clave.

![\[Se muestra el análisis de anomalías con los colaboradores.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/anomaly-exploration-v2.png)


Las secciones de la pantalla incluyen lo siguiente, desde la parte superior izquierda hasta la parte inferior derecha:
+ **Colaboradores** muestra los factores clave. Para ver esta sección, necesita tener los colaboradores configurados en la configuración de anomalías. 
+ **Controles** contiene ajustes para la exploración de anomalías.
+ **Número de anomalías** muestra los valores atípicos detectados a lo largo del tiempo. Puede ocultar o mostrar esta sección del gráfico.
+ Los **nombres de los campos** de categorías o dimensiones actúan como títulos para los gráficos que muestran anomalías en cada categoría o dimensión. 

En las siguientes secciones se proporciona información detallada sobre cada aspecto de la exploración de anomalías.

**Topics**
+ [Exploración de los colaboradores (factores clave)](exploring-anomalies-key-drivers.md)
+ [Configuración de los controles para la detección de anomalías](exploring-anomalies-controls.md)
+ [Muestra y ocultación de anomalías por fecha](exploring-anomalies-by-date.md)
+ [Exploración de anomalías por categoría o dimensión](exploring-anomalies-per-category-or-dimension.md)

# Exploración de los colaboradores (factores clave)
<a name="exploring-anomalies-key-drivers"></a>

Si su análisis de anomalías está configurado para detectar los factores clave, Quick Sight ejecuta el análisis de contribución para determinar qué categorías (dimensiones) influyen en los valores atípicos. La sección **Colaboradores** aparece a la izquierda. 

**Colaboradores** contiene las siguientes secciones:
+ **Narración**: en la parte superior izquierda, hay un resumen que describe cualquier cambio en las métricas.
+ **Configuración de colaboradores principales**: elija **Configurar** para cambiar los colaboradores y el intervalo de fechas que se utilizarán en esta sección.
+ **Ordenar por**: establece el orden aplicado a los resultados que se muestran debajo. Puede elegir entre las siguientes opciones:
  + **Diferencia absoluta** 
  + **Porcentaje de contribución** (predeterminado) 
  + **Desviación de lo previsto** 
  + **Diferencia de porcentaje** 
+ **Resultados de los colaboradores principales**: muestra los resultados del análisis de los colaboradores principales para el momento seleccionado en la línea temporal de la derecha. 

  El análisis de contribuciones identifica hasta cuatro de los principales factores contribuyentes o factores clave de una anomalía. Por ejemplo, Amazon Quick Sight puede mostrarte los principales clientes que han contribuido al aumento de las ventas de productos de salud en EE. UU. Este panel solo aparece si ha seleccionado campos para incluirlos en el análisis de contribuciones al configurar la anomalía. 

  Si este panel no está visible y desea mostrarlo, puede activarlo. Para ello, vuelva al análisis, elija la configuración de anomalías en el menú de información y elija hasta cuatro campos que analizar en busca de contribuciones. Si realiza cambios en los controles de hoja que excluyen los factores contribuyentes, se cerrará el panel **Colaboradores**.

# Configuración de los controles para la detección de anomalías
<a name="exploring-anomalies-controls"></a>

Puede encontrar los ajustes para la detección de anomalías en la sección **Controles** de la pantalla. Para abrir y cerrar esta sección, haga clic en la palabra **Controles**.

La configuración incluye lo siguiente:
+ **Controles**: la configuración actual aparece en la parte superior del espacio de trabajo. Puede expandir esta sección con el icono de flecha doble en el extremo derecho. Los siguientes ajustes están disponibles para explorar los valores atípicos generados por la detección de anomalías basada en ML:
  + **Gravedad**: establece la sensibilidad del detector con las anomalías (valores atípicos) detectadas. Es posible que vea más anomalías con el umbral establecido en **Baja y más** y menos anomalías si el umbral se establece en **Alta y más**. Esta sensibilidad se determina basándose en las desviaciones estándar de la puntuación de anomalía generada por el algoritmo RCF. El valor predeterminado es **Media y más**.
  + **Dirección**: la dirección en el eje x o el eje y que desea identificar como anómala. El valor predeterminado es [TODOS]. Puede elegir entre las siguientes opciones:
    + Configure esta opción en **Más alto de lo esperado** para identificar valores más altos como anomalías. 
    + Configure esta opción en **Más bajo de lo esperado** para identificar valores más bajos como anomalías. 
    + Configure esta opción en **[TODOS]** para identificar todos los valores anómalos, altos y bajos (configuración predeterminada). 
  + **Delta mínimo: valor absoluto**: introduzca un valor personalizado para usarlo como umbral absoluto para identificar las anomalías. Cualquier cantidad superior a este valor se considerará una anomalía. 
  + **Delta mínimo: porcentaje**: introduzca un valor personalizado para usarlo como umbral porcentual para identificar las anomalías. Cualquier cantidad superior a este valor se considerará una anomalía. 
  + **Ordenar por**: elija el método que desea aplicar a la clasificación de anomalías. Se muestran en el orden preferido en la pantalla. Consulte la siguiente lista para ver una descripción de cada método.
    + **Puntuación de anomalías ponderada**: la puntuación de anomalías multiplicada por el registro del valor absoluto de la diferencia entre el valor real y el valor esperado. Esta puntuación es siempre un número positivo.
    + **Puntuación de anomalías**: la puntuación de anomalías real asignada a este punto de datos.
    + **Diferencia ponderada del valor esperado**: (predeterminado) la puntuación de anomalías multiplicada por la diferencia entre el valor real y el valor esperado.
    + **Diferencia del valor esperado**: la diferencia real entre el valor real y el valor esperado (real esperado).
    + **Valor real**: el valor real sin la fórmula aplicada.
  + **Categorías**: pueden aparecer una o más configuraciones al final de las otras configuraciones. Hay una para cada campo de categoría que haya agregado correctamente al campo de categoría. Puede utilizar esta configuración de categoría para limitar los datos que se muestran en la pantalla. 

# Muestra y ocultación de anomalías por fecha
<a name="exploring-anomalies-by-date"></a>

El gráfico **Número de anomalías** muestra los valores atípicos detectados a lo largo del tiempo. Si no ve este gráfico, puede mostrarlo seleccionando **MOSTRAR ANOMALÍAS POR FECHA**. 

Este gráfico muestra las anomalías (valores atípicos) del punto de datos más reciente de la serie temporal. Al expandirse, muestra los siguientes componentes:
+ **Anomalías**: en el medio de la pantalla se muestran las anomalías del punto de datos más reciente de la serie temporal. En uno o varios gráficos se muestra un gráfico con las variaciones de una métrica a lo largo del tiempo. Para utilizar este gráfico, seleccione un punto a lo largo de la línea temporal. El punto en el tiempo seleccionado actualmente se resalta en el gráfico e incluye un menú que le ofrece la opción de analizar las contribuciones en la métrica actual. También puede arrastrar el cursor sobre la línea temporal sin seleccionar un punto específico, para mostrar el valor de la métrica de ese punto en el tiempo.
+ **Anomalías por fecha**: si elige **MOSTRAR ANOMALÍAS POR FECHA**, aparece otro gráfico que muestra cuántas anomalías significativas había para cada punto temporal. Puede ver los detalles en este gráfico en el menú contextual de cada barra. 
+ **Ajuste de la línea temporal**: cada gráfico tiene una herramienta de ajuste de la línea temporal debajo de las fechas, que puede utilizar para comprimir, expandir o elegir un periodo de tiempo para verlo.

# Exploración de anomalías por categoría o dimensión
<a name="exploring-anomalies-per-category-or-dimension"></a>

La sección principal de la pantalla **Explorar anomalías** está bloqueada en la parte inferior derecha de la pantalla. Permanece aquí sin importar cuántas otras secciones de la pantalla estén abiertas. Si existen varias anomalías, puede desplazarse hacia abajo para resaltarlas. El gráfico muestra las anomalías en gamas de colores y muestra dónde se producen durante un período de tiempo. 

![\[Pantalla Explorar anomalías.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/anomaly-exploration-1.png)


Cada categoría o dimensión tiene un gráfico independiente que utiliza el nombre del campo como título del gráfico. Cada gráfico contiene los siguientes componentes:
+ **Configurar alertas**: si está explorando anomalías en un panel, puede utilizar este botón para suscribirse a alertas y análisis de contribuciones (si está configurado). Puede configurar las alertas según el nivel de gravedad (medio, alto, etc.). Puede obtener las cinco primeras alertas para **Más de lo previsto**, **Menos de lo previsto** o TODO. Los lectores de paneles pueden configurar alertas para sí mismos. La página **Explorar anomalías** no muestra este botón si la página se abre desde un análisis.
**nota**  
La capacidad de configurar alertas solo está disponible en los paneles publicados.
+ **Estado**: debajo del encabezado **Anomalías**, la etiqueta de estado muestra información sobre la última ejecución. Por ejemplo, es posible que vea “Anomalías en los ingresos del 17 de noviembre de 2018”. Esta etiqueta indica cuántas métricas se han procesado y cuánto tiempo ha transcurrido. Puede elegir el enlace para obtener más información sobre los detalles, por ejemplo, cuántas métricas se ignoraron.

# Previsión y creación de escenarios hipotéticos con Amazon Quick Sight
<a name="forecasts-and-whatifs"></a>

Con la previsión basada en ML, puede pronosticar las métricas clave de su empresa con sencillez. point-and-click No se requiere experiencia en machine learning. El algoritmo de aprendizaje automático integrado en Amazon Quick Sight está diseñado para gestionar escenarios complejos del mundo real. Amazon Quick Sight utiliza el aprendizaje automático para ofrecer pronósticos más fiables que los disponibles por medios tradicionales.

Por ejemplo, suponga que administra un negocio. Suponga que desea prever las ventas para ver si va a alcanzar su objetivo para finales de año. O bien, suponga que espera que se cierre un gran acuerdo en dos semanas y desea saber cómo va a afectar a su previsión general. 

Puede pronosticar los ingresos de su empresa con varios niveles de estacionalidad (por ejemplo, las ventas con tendencias semanales y trimestrales). Amazon Quick Sight excluye automáticamente las anomalías en los datos (por ejemplo, un aumento en las ventas debido a una bajada de precio o a una promoción) para que no influyan en la previsión. Tampoco tiene que limpiar y volver a representar los datos con los valores faltantes, ya que Amazon Quick Sight se encarga automáticamente de ello. Además, con la previsión basada en ML, puede realizar análisis condicionales interactivos para determinar la trayectoria de crecimiento que necesita para alcanzar los objetivos de negocio.

## Uso de previsiones y escenarios condicionales
<a name="using-forecasts"></a>

Puede añadir un widget de previsión a su análisis existente y publicarlo como un panel. Para analizar escenarios condicionales, utilice un análisis, no un panel. Con la previsión basada en ML, Amazon Quick Sight le permite pronosticar escenarios complejos del mundo real, como datos con varias estacionalidades. Excluye automáticamente los valores atípicos que identifica e imputa los valores que faltan.

Utilice el siguiente procedimiento para añadir una previsión gráfica a su análisis y explorar los escenarios condicionales.

Aunque el siguiente procedimiento corresponde a la previsión gráfica, también puede agregar una previsión como narración en un widget de información. Para obtener más información, consulte [Creación de narrativas automáticas con Amazon Quick Sight](narratives-creating.md).

[La previsión basada en ML no es compatible con múltiplos pequeños.](small-multiples.md) Para garantizar una visualización precisa de los datos y las previsiones, evite utilizar múltiplos pequeños en sus visualizaciones.

**Adición de una previsión gráfica a su análisis**

1. Cree un elemento visual que utilice un único campo de fecha y hasta tres métricas (medidas).

1. En el menú de la esquina superior derecha de la imagen, seleccione el icono de **opciones de menú** (los tres puntos) y, a continuación, elija **Agregar previsión**.

   Quick Sight analiza automáticamente los datos históricos mediante el aprendizaje automático y muestra una previsión gráfica para los próximos 14 períodos. Las propiedades de previsión se aplican a todas las métricas del elemento visual. Si quiere previsiones individuales para cada métrica, considere la posibilidad de crear una imagen independiente para cada métrica y agregar una previsión a cada una de ellas.  
![\[Imagen de un gráfico de líneas con tres métricas pronosticadas.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/forecast2.png)

1. En el panel **Propiedades de previsión** que se abre en la parte izquierda, personalice una o más de las siguientes opciones:
   + **Duración de la previsión**: establezca **Periodos futuros** para la previsión y **Periodos pasados** para buscar patrones en los que se basará la previsión.
   + **Intervalo de la predicción**: establezca el intervalo estimado para la previsión. Al hacerlo, se cambia la amplitud de la banda de posibilidad en torno a la línea prevista. 
   + **Estacionalidad**: establezca el número de periodos de tiempo que intervienen en el patrón estacional predecible de los datos. El rango es 1–180, y la configuración predeterminada es **Automático**.
   + **Límites de previsión**: defina un valor de previsión mínimo o máximo para evitar que los valores de previsión superen o bajen un valor especificado. Por ejemplo, si la previsión predice que el número de nuevas contrataciones que la empresa contratará en el mes siguiente será negativo, puede establecer un límite mínimo de previsión en cero. Esto evita que los valores pronosticados nunca caigan por debajo de cero.

   Para guardar los cambios, elija **Aplicar**.

   Si su previsión contiene varias métricas, puede aislar una de las previsiones seleccionando cualquier punto dentro de la banda naranja. Al hacer esto, las demás previsiones desaparecen. Vuelva a seleccionar la banda de previsión aislada para que vuelva a aparecer.

1. Analice escenarios condicionales seleccionando un punto de datos previsto (en la banda naranja) en el gráfico y, a continuación, seleccione **Análisis condicional** del menú contextual.

   Se abre el panel **Análisis condicional** en la parte izquierda. Establezca las siguientes opciones:
   + **Escenario**: establezca un objetivo para una fecha o defina un objetivo para un intervalo de tiempo.
   + **Fechas**: si establece un objetivo para una fecha específica, escriba aquí la fecha. Si usa un intervalo de tiempo, defina las fechas de inicio y finalización.
   + **Objetivo**: establezca un valor objetivo para la métrica.

   Amazon Quick Sight ajusta la previsión para cumplir el objetivo. 
**nota**  
La opción **Análisis condicional** no está disponible para las previsiones con varias métricas. Si desea realizar un escenario condicional en la previsión, el elemento visual debe contener solo una métrica.

1. Para mantener los cambios, elija **Aplicar**. Para descartarlos, cierre el panel **Análisis condicional**. 

   Si mantiene los cambios, la nueva previsión se ajustará al objetivo, junto con la previsión original sin el análisis condicional. 

   El análisis condicional se representa en el elemento visual como un punto en la línea de métrica. Puede colocar el cursor por encima de los puntos de datos en la línea de previsión para ver los detalles. 

A continuación se indican otras acciones que puede hacer:
+ Para interactuar con un análisis condicional o eliminarlo, elija el punto en la línea de métrica. 
+ Para crear escenarios condicionales adicionales, cierre el análisis condicional antes de elegir un nuevo punto en la línea.

**nota**  
Los análisis condicionales solo pueden estar un análisis, no en un panel.

# BI generativa con Quick Sight
<a name="quicksight-gen-bi"></a>

**nota**  
 Desarrollado por Amazon Bedrock: Amazon Q in Quick se basa en Amazon Bedrock e incluye la [detección automática de abusos](https://docs.aws.amazon.com//bedrock/latest/userguide/abuse-detection.html) implementada en Amazon Bedrock para garantizar la protección, la seguridad y el uso responsable de la IA. 

Con Amazon Quick Chat, puede utilizar la experiencia de creación de BI generativa, crear resúmenes ejecutivos de sus datos, formular y responder preguntas sobre datos y generar historias de datos.

Para acceder a todas las funciones de BI generativa de Quick Sight que son relevantes para su tarea, elija el icono brillante situado en la parte superior derecha de cualquier página de Quick Sight. En el panel que se abre, el chat muestra todo el contenido disponible en función del contexto de la tarea que esté realizando. Por ejemplo, si está trabajando en un análisis, puede crear un cálculo, editar elementos visuales, configurar preguntas y respuestas o hacer preguntas sobre sus datos. Si trabaja en un panel, puede crear una historia de datos, generar un resumen ejecutivo o hacer preguntas sobre el panel.

**nota**  
Las funciones de BI generativa no están disponibles en todas AWS las regiones. Para ver una lista de las regiones en las que están disponibles las características de BI generativa, consulte [Regiones de AWS Compatible con Amazon Q en Quick](regions.md#regions-aqs)

Utilice los siguientes temas para obtener más información sobre la BI generativa.

**Topics**
+ [Introducción a la BI generativa](generative-bi-get-started.md)
+ [Cómo aumentar los conocimientos de Amazon Quick Sight con Amazon Q Business](generative-bi-q-business.md)
+ [Experiencia de creación de contenido con BI generativa](generative-bi-author-experience.md)
+ [Creación de resúmenes ejecutivos](gen-bi-executive-summaries.md)
+ [Creación de preguntas y respuestas](gen-bi-author-q-and-a.md)
+ [Gestione los permisos de los temas a través de paneles en Amazon Quick Sight](gen-bi-manage-topic-permissions.md)
+ [Activa la experiencia de preguntas y respuestas del panel de control en Amazon Quick Sight](dashboard-qa.md)
+ [Soporte para valores nulos de preguntas y respuestas](gen-bi-q-and-a-null-support.md)
+ [Mejora de la precisión de las preguntas y respuestas con instrucciones personalizadas](gen-bi-improve-qa-accuracy-with-custom-instructions.md)
+ [Formulación y respuesta a preguntas sobre datos con BI generativa](gen-bi-data-q-and-a.md)
+ [Optar por no participar en el BI generativo](generative-bi-opt-out.md)
+ [Cómo trabajar con Amazon Quick Sight Topics](topics.md)
+ [Trabajar con historias de datos en Amazon Quick Sight](working-with-stories.md)
+ [Trabajar con escenarios en Amazon Quick Sight](scenarios.md)

# Introducción a la BI generativa
<a name="generative-bi-get-started"></a>

Para empezar a utilizar las funciones de BI generativa de Quick Sight, actualice los usuarios de su cuenta a los roles de Admin Pro, Author Pro o Reader Pro. Los roles Pro otorgan a los usuarios acceso a todas las capacidades de BI generativa relevantes para el rol asignado al usuario. Los usuarios Pro pueden compartir temas generativos de preguntas y respuestas con otro usuario. Para saber qué capacidades de BI generativa están disponibles para los diferentes roles de usuario en Quick, consulte la tabla siguiente. Para entender cómo se asignan los nombres de las suscripciones a las funciones de los usuarios, consulte [Descripción de las suscripciones y funciones de Amazon Quick](https://docs.aws.amazon.com/quicksight/latest/user/user-types.html#subscription-role-mapping).

**nota**  
Los autores y lectores no Pro pueden seguir accediendo a los temas de preguntas y respuestas generativas si un usuario con el rol Autor Pro o Administrador Pro comparte el tema con ellos. Los autores y lectores no Pro también pueden acceder a las historias de datos si un usuario con el rol Lector Pro, Autor Pro o Administrador Pro comparte una con ellos.


| Nombre de la característica  | Descripción de la característica | Lector | Autor | Administrador | Lector Pro | Autor Pro | Administrador Pro | 
| --- | --- | --- | --- | --- | --- | --- | --- | 
|  [Creación de una historia de datos con BI generativa](working-with-stories-create.md)  |  Permite crear historias de datos que expliquen sus datos con elementos visuales, información e ideas para ayudar a mejorar su negocio.  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  [Visualización de una historia de datos generada en Amazon Quick Sight](working-with-stories-view.md)  |  Permite ver las historias de datos de narración que se comparten con usted.  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  [Creación de preguntas y respuestas](gen-bi-author-q-and-a.md)  |  Cree y perfeccione temas que utilicen preguntas y respuestas generativas para los paneles de Quick Sight.  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  [Formulación y respuesta a preguntas sobre datos con BI generativa](gen-bi-data-q-and-a.md)  |  Permite hacer preguntas sobre los datos para acelerar las decisiones basadas en los datos con respuestas multivisuales.  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg)Sí\$1  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  [Creación de resúmenes ejecutivos](gen-bi-executive-summaries.md)  |  Obtenga un resumen ejecutivo de la información clave en un panel de Quick Sight.  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  [Experiencia de creación de contenido con BI generativa](generative-bi-author-experience.md)  |  Permite crear un análisis para crear elementos visuales, cálculos y perfeccionar los elementos visuales existentes con lenguaje natural.  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 

\$1Los roles que no sean Pro de cuentas que se hayan creado el 30 de abril de 2024 o después podrán acceder a los temas de preguntas y respuestas que compartan con ellos. Si tu cuenta Quick se creó antes del 30 de abril de 2024 y quieres activar esta nueva función, ponte en contacto con tu equipo de AWS cuentas. 

Cualquier administrador de Quick puede convertir a un usuario en un puesto Pro siguiendo el siguiente procedimiento.

**Actualización de un usuario a un rol Pro**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Selecciona el icono de usuario en la parte superior derecha y, a continuación, selecciona **Administrar rápidamente**.

1. Seleccione **Administrar usuarios** para abrir la página **Administrar usuarios**.

1. Para cambiar el rol de un usuario existente, búsquelo en la tabla **Administrar usuarios** y elija el rol que quiere asignarle en el menú desplegable **Rol**.

Para obtener más información sobre la administración de los usuarios de Quick, consulte[Administrar el acceso de los usuarios dentro de Amazon Quick](managing-users.md).

# Cómo aumentar los conocimientos de Amazon Quick Sight con Amazon Q Business
<a name="generative-bi-q-business"></a>

Los administradores de cuentas de Amazon Quick pueden conectar su cuenta de Amazon Quick a Amazon Q Business para obtener información valiosa con fuentes de datos no estructuradas. [Amazon Q Business](https://aws.amazon.com//q/business/) es un asistente de IA generativo que ayuda a su equipo a trabajar de forma más inteligente. Puede responder a preguntas, proporcionar resúmenes, generar contenido y completar tareas de forma segura en función de la información de los sistemas de su empresa.

Cuando una cuenta Quick se integra con Amazon Q Business, los usuarios ahora pueden aprovechar este vasto repositorio de conocimiento organizacional junto con sus análisis de datos estructurados. Esta integración permite obtener información más completa y rica en contexto, ya que combina datos cuantitativos de Quick con información cualitativa de varios documentos y aplicaciones empresariales.

Para obtener más información sobre cómo conectar tu cuenta de Amazon Q Business con Quick, consulta [Cómo crear una aplicación de integración rápida](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/create-application-quicksight.html).

Utilice los siguientes temas para configurar una aplicación Amazon Q Business en Quick.

**Topics**
+ [Consideraciones](#generative-bi-q-business-considerations)
+ [Configuración de una aplicación Amazon Q Business en Amazon Quick Sight](generative-bi-q-business-configure.md)
+ [Conectar una cuenta Quick a una aplicación Amazon Q Business existente](generative-bi-q-business-link-existing-account.md)
+ [Desconectar una aplicación de Amazon Q Business de una cuenta de Amazon Quick](generative-bi-q-business-delete-connection.md)

## Consideraciones
<a name="generative-bi-q-business-considerations"></a>

La aplicación de Amazon Q Business presenta las siguientes limitaciones.
+ Quick y Amazon Q Business deben estar en la misma AWS cuenta. No se admiten llamadas entre cuentas.
+ Las cuentas Quick y Amazon Q Business deben estar en la misma AWS región. No se admiten llamadas entre regiones. Para ver una lista de todas las regiones rápidas compatibles, consulte[Regiones de AWS Compatible con Amazon Q en Quick](regions.md#regions-aqs). Para ver una lista de todas las regiones de Amazon Q Business admitidas, consulte [Service quotas for Amazon Q Business](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/quotas-regions.html).

  Si su cuenta Quick existe en más de una región, puede conectar una aplicación de Amazon Q Business de cada región a la cuenta Quick. Por ejemplo, si su cuenta Quick está en EE.UU. Este (Norte de Virginia) y EE.UU. Oeste (Oregón), se puede conectar a la cuenta Quick una aplicación Amazon Q Business ubicada en EE.UU. Este (Norte de Virginia) y una aplicación Amazon Q Business ubicada en EE.UU. Oeste (Oregón).
+ Las cuentas Quick y Amazon Q Business integradas deben usar los mismos métodos de identidad. Por ejemplo, si una cuenta Quick usa el Centro de identidad de IAM para la administración de identidades, la cuenta de Amazon Q Business con la que se está integrando también debe usar el Centro de identidad de IAM para la administración de identidades.
+ Las direcciones de correo electrónico asociadas a los usuarios y grupos de Quick se utilizan para realizar comprobaciones de autorización en Amazon Q Business.

# Configuración de una aplicación Amazon Q Business en Amazon Quick Sight
<a name="generative-bi-q-business-configure"></a>

Utilice el siguiente procedimiento para conectar una cuenta Amazon Quick con Amazon Q Business

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Selecciona el icono de usuario en la parte superior derecha y, a continuación, selecciona **Administrar rápidamente**.

1. Elija **Seguridad y permisos**.

1. En la página **Acceso rápido a AWS los servicios**, selecciona la casilla de verificación de la **aplicación Amazon Q Business**.

1. En la ventana emergente **Crear una conexión de Amazon Q Business a datos no estructurados** que aparece, elige la región rápida en la que quieres que esté tu conexión.

1. Seleccione **Listo**.

1. Al elegir **Listo**, se crea una cuenta de Amazon Q Business y se le redirige a una nueva pestaña que muestra la página **Aplicaciones** de la consola de Amazon Q Business.

1. Para **Aplicaciones**, elige la conexión a Amazon Q Business que creaste en Quick.

1. Se abrirá la página **Detalles de la aplicación** de la conexión. Seleccione la pestaña **Índice** y, a continuación, **Seleccionar índice**.

1. En la ventana emergente que aparece, elija la opción **Aprovisionamiento de índices** que desea usar y, a continuación, seleccione **Confirmar**. Para obtener más información sobre los índices de Amazon Q Business, consulte [Creating a retriever for an Amazon Q Business application](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/select-retriever.html).

1. Después de elegir un índice, configure una conexión al origen de datos. Para configurar una conexión a un origen de datos, seleccione la sección **Orígenes de datos** del menú **Mejoras** en el panel lateral izquierdo.

1. Elija **Agregar origen de datos**.

1. Elija el origen de datos que desea agregar. El origen de datos que elija determina los pasos necesarios para configurar la conexión al origen de datos. Para obtener más información sobre cómo agregar un origen de datos a una cuenta de Amazon Q Business, consulte [Connecting Amazon Q Business data sources](https://docs.aws.amazon.com/amazonq/latest/qbusiness-ug/supported-connectors.html). Cuando termine de configurar el origen de datos, elija **Agregar origen de datos**.

Tras elegir un índice, un recuperador y una fuente de datos para su cuenta de Amazon Q Business, su conexión a Amazon Q Business estará completa y podrá volver a la consola Quick.

# Conectar una cuenta Quick a una aplicación Amazon Q Business existente
<a name="generative-bi-q-business-link-existing-account"></a>

Si ya tiene una aplicación de Amazon Q Business que utiliza la misma gestión de identidades y existe en la misma región que su cuenta Quick, utilice el siguiente procedimiento para vincular la cuenta Amazon Q Business existente a Quick.

1. Abre la [consola Quick](https://quicksight.aws.amazon.com/).

1. Selecciona el icono de usuario en la parte superior derecha y, a continuación, selecciona **Administrar rápidamente**.

1. Elija **Seguridad y permisos**.

1. En la página **Acceso rápido a AWS los servicios**, selecciona la casilla de verificación de la **aplicación Amazon Q Business**.

1. En la ventana emergente **Crear una conexión de Amazon Q Business a datos no estructurados** que aparece, elige la región rápida en la que quieres que esté tu conexión.

1. Elija la aplicación existente de Amazon Q Business en el menú desplegable.
**nota**  
Su aplicación Amazon Q Business no aparece si la aplicación existe en una región diferente a la de su cuenta Quick o si la aplicación utiliza una opción de gestión de identidades diferente a la de su cuenta Quick.

Después de elegir la aplicación Amazon Q Business en el menú desplegable, se configura la conexión entre Quick y Amazon Q Business.

# Desconectar una aplicación de Amazon Q Business de una cuenta de Amazon Quick
<a name="generative-bi-q-business-delete-connection"></a>

Los administradores de cuentas de Quick pueden utilizar el siguiente procedimiento para desconectar una aplicación de Amazon Q Business de una cuenta de Quick.

1. Abre la [consola Quick.](https://quicksight.aws.amazon.com/)

1. Selecciona el icono de usuario en la parte superior derecha y, a continuación, selecciona **Administrar rápidamente**.

1. Elija **Seguridad y permisos**.

1. En la página de **acceso rápido a AWS los servicios**, elija **SELECCIONAR APLICACIÓN**.

1. Lleve a cabo una de las siguientes opciones:

   1. Para desconectar una sola aplicación de Amazon Q Business de una cuenta Quick, navega hasta la aplicación que deseas eliminar, abre el menú desplegable y selecciona **NINGUNA**.

   1. Para desconectar todas las aplicaciones de Amazon Q Business de una cuenta Quick, desmarca la casilla de verificación de la **aplicación Amazon Q Business**.

Al desconectar una aplicación de Amazon Q Business de una cuenta de Quick, la aplicación de Amazon Q Business que ha creado para Quick no se elimina. La aplicación, el índice, el recuperador y cualquier conexión de origen de datos no estructurados que haya configurado permanecen en su cuenta de Amazon Q Business.

# Experiencia de creación de contenido con BI generativa
<a name="generative-bi-author-experience"></a>

Con Quick Chat, los autores pueden usar las nuevas capacidades de BI generativa para crear campos calculados y crear y refinar imágenes. Consulte los siguientes temas para obtener más información sobre la experiencia de creación de BI generativa.

**Topics**
+ [Creación de elementos visuales con BI generativa](generative-bi-build-visuals.md)
+ [Creación de cálculos con BI generativa](generative-bi-build-calculations.md)
+ [Perfeccionamiento de elementos visuales con la inteligencia empresarial generativa](generative-bi-refine-visual.md)

# Creación de elementos visuales con BI generativa
<a name="generative-bi-build-visuals"></a>

Los autores rápidos pueden usar el botón **Crear una imagen visual** para crear una imagen personalizada que se genere a partir de las entradas del autor. La aportación del autor utiliza lenguaje natural para describir el resultado deseado para el nuevo elemento visual. Puede especificar una descripción personalizada, o bien elegir de una lista de sugerencias generadas por Amazon Q para el tema adjunto al análisis. La siguiente imagen muestra un elemento visual personalizado creado con el menú **Crear elemento visual**.

**Creación de un elemento visual con BI generativa**

1. Navegue hasta el análisis en el que desee trabajar y elija **Preguntar para crear una imagen**.

1. En el panel **Crear un elemento visual** que se mostrará, lleve a cabo los pasos siguientes.

   1. Describa los datos que desea visualizar. Puede introducir una descripción personalizada, o bien puede elegir entre las preguntas **recomendadas** que se generan en función de los datos del análisis.

      Al describir los datos que desea visualizar, puede formularlos en forma de pregunta, o bien usar frases o filtros conversacionales. Por ejemplo, puede escribir “¿Cuántas personas se suscribieron a una prueba gratuita el mes pasado?” o “Inscripciones de prueba gratuitas por mes”. Ambas declaraciones generan un elemento visual que muestra el número de suscripciones de prueba gratuitas por mes. También puede obtener respuestas a solicitudes de lenguaje impreciso o estilos de palabras clave.

      Las preguntas sugeridas pueden incluir una combinación de preguntas generadas por inteligencia artificial (IA) y preguntas verificadas por humanos. Las preguntas verificadas por humanos aparecen con una marca de verificación junto a la sugerencia.

   1. Elija **Compilar**.

   1. Revisa el elemento visual que se genera. Para refinar los datos que se presentan en el elemento visual, introduzca una nueva descripción en la barra **Crear** y, a continuación, seleccione **Crear**. Usa las flechas hacia adelante y hacia atrás para revisar los cambios realizados en el elemento visual sin perder ningún progreso.

   1. Cuando esté satisfecho con el elemento visual, elija **AGREGAR AL ANÁLISIS**.

# Creación de cálculos con BI generativa
<a name="generative-bi-build-calculations"></a>

Con la BI generativa, puede utilizar indicaciones en lenguaje natural para crear campos calculados en Amazon Quick Sight, como se muestra en la imagen siguiente. Para obtener más información acerca de los campos calculados, consulte [Adición de campos calculados](adding-a-calculated-field-analysis.md).

![\[Incorporación de un campo calculado con la herramienta Crear.\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/gen-bi-build-calculation-1.png)


**Creación de un campo calculado con BI generativa**

1. Navegue hasta el análisis en el que desee trabajar y elija **Datos** en la barra de herramientas de la parte superior de la página. A continuación, elija **Agregar campo calculado**.

1. En el editor de cálculos que aparecerá, elija **Crear**.

1. Describa el resultado del cálculo que desea obtener. Por ejemplo, “cambio porcentual interanual en las ventas diarias”.

1. Elija **CREAR**.

1. Revise la expresión que se devuelve y elija **Insertar** para agregarla al editor de expresiones. También puede elegir el icono **Copiar** para copiar la expresión al portapapeles. Para eliminar la expresión y volver a empezar, elija el icono **Eliminar** que se encuentra junto a la expresión.

1. Cuando termine, cierre el editor.

Tras agregar un cálculo al editor de expresiones, deberá asignarle un nombre para poder guardarlo.

# Perfeccionamiento de elementos visuales con la inteligencia empresarial generativa
<a name="generative-bi-refine-visual"></a>

Los autores rápidos también pueden usar instrucciones en lenguaje natural para editar las imágenes de un análisis, como se muestra en la siguiente imagen. Los autores pueden usar esta funcionalidad para editar imágenes sin realizar tareas manuales en la interfaz de usuario rápida. Los autores solo pueden usar la BI generativa para realizar tareas de formato que actualmente son compatibles con Quick.

A continuación se describen los tipos de ediciones admitidas:
+ Cambiar el tipo de elemento visual.
+ Mostrar u ocultar los títulos de los ejes, las etiquetas de los ejes o las etiquetas de datos.
+ Mostrar, ocultar o cambiar el título de un gráfico.
+ Cambiar los nombres de las columnas de tablas y ejes.
+ Añada campos o cuadros de campo a un elemento visual.
+ Quitar campos de un elemento visual.
+ Cambiar la agregación de un eje.
+ Mostrar u ocultar leyendas y líneas de cuadrícula.
+ Mostrar u ocultar el zoom de datos.
+ Añada campos o cuadros de campo a un elemento visual.
+ Cambiar o quitar los controles de ordenación de un elemento visual.
+ Actualizar el formato condicional de los colores de un elemento visual, los gradientes de color, el color de fondo o el color del texto de un elemento visual.
+ Cambiar el grado de detalle del periodo de tiempo de un elemento visual.
+ Ajustar la escala y el rango de un eje, así como los valores máximos y mínimos.
+ Cambiar el tamaño de fuente de los títulos y subtítulos.
+ Mostrar, ocultar y ajustar las etiquetas de datos.
+ Ajustar el formato de las columnas (cambiar entre números, porcentajes, fechas y divisas).

**Edición de un elemento visual con BI generativa**

1. Navegue hasta el elemento visual que desee editar y, a continuación, elija **Editar con Q**.

1. Describa la tarea que desea realizar y, a continuación, elija **APLICAR**.

1. Revise los cambios del elemento visual. Si está satisfecho con los cambios generados, cierre el modal **Editar elemento visual**. Para deshacer los cambios, elija **Deshacer** y especifique una nueva petición.

# Creación de resúmenes ejecutivos
<a name="gen-bi-executive-summaries"></a>

Con Quick Chat, puede aprovechar modelos lingüísticos de gran tamaño (LLMs) para generar resúmenes ejecutivos de paneles de control. Los resúmenes ejecutivos se basan en la información sugerida por Quick Sight para un panel de control. Los resúmenes ejecutivos ayudan a los lectores a encontrar información clave de un vistazo sin tener que identificar datos específicos de los elementos visuales del panel.

Para activar los resúmenes ejecutivos para un panel, active **Permitir resumen ejecutivo** en el modal **Publicar un panel**.

Para obtener más información sobre cómo pueden los lectores interactuar con los resúmenes ejecutivos, consulte [Genere un resumen ejecutivo de un panel de Amazon Quick Sight](use-executive-summaries.md).

Los resúmenes ejecutivos funcionan mejor cuando un análisis contiene varias sugerencias de información. Para ver una lista de todas las ideas sugeridas para un análisis, navegue hasta el análisis en el que desee trabajar y, a continuación, abra el panel **Información**.

# Creación de preguntas y respuestas
<a name="gen-bi-author-q-and-a"></a>

## Conversión a la experiencia de preguntas y respuestas generativa
<a name="gen-bi-data-q-and-a-converting-to-beta"></a>

Si tiene temas existentes, puede convertirlos fácilmente para aprovechar nuestras nuevas capacidades generativas. Navegue hasta un tema y, a continuación, elija **Convertir** junto al nombre del tema. A continuación, se le pedirá que **duplique y convierta el tema** en un cuadro de diálogo. Duplicaremos su tema para que la conversión a nuestra experiencia beta no afecte a sus usuarios finales. Cuando esté satisfecho con el rendimiento del tema en la nueva experiencia, puede dejar de compartir el tema original y compartir el nuevo.

## Entidades nombradas
<a name="gen-bi-data-q-and-a-named-entities"></a>

Las entidades nombradas son uno de los componentes más importantes de la selección de temas. La información contenida en las entidades nombradas (sobre todo, el orden de los campos y su clasificación) es la que permite presentar respuestas contextuales y multivisuales en respuesta a preguntas incluso vagas. Para encontrar las entidades nombradas, los autores pueden navegar hasta un tema, elegir la pestaña **Datos** y, a continuación, elegir **Entidades nombradas**. Desde aquí, los autores pueden obtener una vista previa o editar las entidades nombradas asignadas existentes y crear otras nuevas.

Los autores pueden configurar las siguientes facetas de las entidades nombradas asignadas:

1. **Campos**: elija un conjunto de datos y, a continuación, elija los campos de ese conjunto de datos que desea incluir. Esto definirá el ámbito de los datos que se tendrán en cuenta al usar esta entidad nombrada para responder a las preguntas de los usuarios finales.

1. **Clasificación y presentación de los campos**: el rango relativo de las dimensiones y medidas de una entidad nombrada determina cómo se usan esos campos al generar respuestas contextuales y multivisuales. Observe en la siguiente demostración que al ajustar el rango relativo de los **beneficios** para que sea superior al de las **ventas** se muestran datos diferentes. De forma predeterminada, el orden de los campos en el elemento visual de la tabla es el mismo que el orden de los campos. Sin embargo, puede controlar estos dos de forma individual si desactiva la opción **Sincronizar vista de la tabla con la clasificación de campos**.

1. **Mostrar u ocultar en la presentación**: los campos que se incluyen en las entidades nombradas se pueden ocultar simultáneamente de la presentación tabular de la entidad nombrada y, al mismo tiempo, proporcionar contexto adicional en otros componentes de la respuesta.

## Medición de agregaciones
<a name="gen-bi-data-q-and-a-measure-aggregations"></a>

Los autores tienen un control detallado sobre las medidas agregadas de los temas. En Quick Sight, las medidas están predeterminadas`SUM`, a menos que tengan agregaciones personalizadas definidas en una expresión calculada. Para cambiarlo, navegue hasta la medida en la lista de campos de datos y especifique una agregación predeterminada diferente. También puede rechazar las agregaciones, lo que impedirá que se apliquen incluso si un usuario las solicita específicamente. Por último, puede especificar que una medida no sea aditiva. Esto resulta útil para las métricas precalculadas, como los porcentajes, que no se deben volver a combinar de ninguna manera. Si lo hace, se forzará `MEDIAN` o `AVG` dependerá de su caso de uso.

# Gestione los permisos de los temas a través de paneles en Amazon Quick Sight
<a name="gen-bi-manage-topic-permissions"></a>

 Quick permite a los autores administrar los permisos de los paneles y sus temas vinculados desde una única ubicación. Al compartir paneles con las preguntas y respuestas activadas, los autores pueden controlar el acceso de los observadores de los temas directamente desde las preferencias de uso compartido del panel, lo que elimina la necesidad de administrar los permisos en varias ubicaciones. 

**Habilitación de preguntas y respuestas en un panel con un tema vinculado:**

1. Abra la [consola Quick.](https://quicksight.aws.amazon.com/)

1. Abra el análisis del panel con las preguntas y respuestas activadas y el tema vinculado que desee publicar.

1. Elija **Publicar**.

1. Active la casilla de verificación **Permitir preguntas y respuestas de datos**.

1. Elija **ADMINISTRAR PREGUNTAS Y RESPUESTAS** y seleccione **Usar un tema vinculado para un elemento visual de creación y preguntas y respuestas**.

1. Seleccione el tema vinculado que desee en el menú desplegable.

1. Elija **APLICAR LOS CAMBIOS** y, a continuación, **Publicar panel**.

**Cómo administrar el acceso a los temas desde un panel de forma conveniente:**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Abra el panel con un tema vinculado del que sea copropietario.

1. Seleccione el icono de uso compartido y elija **Compartir panel**.

1. En la fila del usuario seleccionado, activa on/off el botón **Compartir como «visor de temas»** para que los grant/revoke espectadores accedan al tema vinculado.

1. En la fila de la carpeta compartida seleccionada, coloca on/off el botón **Añadir tema a la carpeta** compartida add/remove en to/from el tema vinculado.

**Cómo compartir el panel y el tema vinculado con todos los usuarios y grupos:**

1. Abre la [consola rápida.](https://quicksight.aws.amazon.com/)

1. Abra el panel con un tema vinculado del que sea copropietario.

1. Seleccione el icono de uso compartido y elija **Compartir panel**.

1. En la parte inferior izquierda del panel, en **Compartir tema vinculado automáticamente para**, active la opción **Todos los usuarios y grupos del panel**. Esto permitirá a los espectadores acceder al tema vinculado cuando se comparta el panel. Desactive la opción para cancelar este comportamiento.

Una vez que se haya compartido el panel con un tema vinculado, los usuarios podrán formular inmediatamente preguntas sobre sus datos. Vaya a **Haga una pregunta sobre <nombre del tema>** en la parte superior del panel para comenzar a hacer preguntas.

# Activa la experiencia de preguntas y respuestas del panel de control en Amazon Quick Sight
<a name="dashboard-qa"></a>

Quick permite a cualquier autor activar las preguntas y respuestas directamente desde sus paneles de control con un solo clic sin necesidad de crear un tema en Quick Sight. Para ello, publique el panel y active la casilla **Permitir preguntas y respuestas de datos** en el menú de publicación del panel. Al activar las preguntas y respuestas del panel, puede elegir qué conjuntos de datos utilizar para las preguntas y respuestas en el panel a fin de garantizar que los usuarios finales obtengan las respuestas que necesitan.

Las preguntas y respuestas del panel consultan todas las filas y columnas de los conjuntos de datos incluidos, más allá de lo que está visible en el panel. [Para proteger los datos sensibles o confidenciales, habilite la seguridad a nivel de [fila (RLS) y la seguridad a nivel de columna (CLS).](row-level-security.md) and/or ](restrict-access-to-a-data-set-using-column-level-security.md) 

En la siguiente tabla, se compara la disponibilidad de características entre las preguntas y respuestas en el panel y las preguntas y respuestas del tema.


| Característica de preguntas y respuestas | Preguntas y respuestas en el panel | Preguntas y respuestas del tema | 
| --- | --- | --- | 
|  Permite a los usuarios de todos los roles hacer y responder preguntas sobre datos  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  Permite que los roles de autor y administrador activen las preguntas y respuestas de datos en los paneles  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No (solo para usuarios profesionales)  | 
|  Compatible con la incrustación rápida de consolas  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  Posibilidad de agregar respuestas revisadas  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  Posibilidad de personalizar metadatos específicos de las preguntas y respuestas  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 
|  Posibilidad de admitir el autocompletado para los valores de los datos  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/negative_icon.svg) No  |  ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/success_icon.svg) Sí  | 

Utilice el procedimiento que se indica a continuación para activar las preguntas y respuestas del panel en un panel de Quick Sight.

**Activación de las preguntas y respuestas en un panel**

1. Abre la consola [Quick](https://quicksight.aws.amazon.com/).

1. Abra el análisis del panel que quiera publicar con las preguntas y respuestas activadas.

1. Elija **Publicar**.

1. Active la casilla de verificación **Permitir preguntas y respuestas de datos**.

1. (Opcional) Elija **ADMINISTRAR PREGUNTAS Y RESPUESTAS** para elegir qué conjuntos de datos desea incluir en la experiencia de preguntas y respuestas en el panel. De forma predeterminada, se incluyen todos los conjuntos de datos que utiliza el panel.

1. Elija **APLICAR LOS CAMBIOS** y, a continuación, **Publicar panel**.

Después de publicar un panel con la experiencia de preguntas y respuestas activada, los usuarios pueden hacer preguntas sobre sus datos con la entrada **Hacer una pregunta sobre este panel** en la parte superior del panel.

Quick permite a cualquier usuario hacer preguntas en los paneles que tengan habilitadas las preguntas y respuestas. Sin embargo, las preguntas y respuestas del panel son una función que conlleva la cuota de activación asociada. Los administradores rápidos pueden deshabilitar esta función a nivel de cuenta en cualquier momento. Utilice el siguiente procedimiento para deshabilitar las preguntas y respuestas del panel de control en toda una cuenta de Quick.

1. Abre la consola [rápida](https://quicksight.aws.amazon.com/).

1. Selecciona el icono de usuario en la esquina superior derecha y, a continuación, selecciona **Administrar rápidamente**.

1. Elija **Seguridad y permisos**.

1. Vaya a la sección Amazon Q y, a continuación, elija **Administrar**.

1. Desactive la opción **Administrar las preguntas y respuestas en el panel**.

Al desactivar la opción **Administrar preguntas y respuestas en el panel**, las preguntas y respuestas del panel se eliminan de todos los paneles que tengan activadas las preguntas y respuestas en el panel. Si tu cuenta de Quick no tiene usuarios o temas Pro, esta acción impide que la cuota de activación de Amazon Q se facture a tu cuenta de Quick. Esta configuración no afecta a los usuarios Pro ni a los temas existentes en Quick. Para obtener más información sobre cómo excluirse de la BI generativa, consulte. [Optar por no participar en el BI generativo](generative-bi-opt-out.md)

# Soporte para valores nulos de preguntas y respuestas
<a name="gen-bi-q-and-a-null-support"></a>

Amazon Quick Sight Q&A ofrece un soporte integral para la gestión de valores nulos, lo que permite a los usuarios crear análisis más sofisticados y responder a preguntas empresariales complejas. Esta funcionalidad permite filtrar con precisión los valores nulos, hacer consultas intuitivas sobre los datos faltantes e interactuar de forma dinámica con los gráficos.

## Adición de un filtro para incluir o excluir valores nulos
<a name="add-filter-for-null"></a>

**Cómo agregar un filtro para incluir o excluir valores nulos**

1. Abre la consola [Quick](https://quicksight.aws.amazon.com/).

1. Elija **Temas** y, a continuación, abra el tema al que desee agregar un filtro.

1. Elija la pestaña **Datos**.

1. En **Campos de datos**, seleccione **Agregar filtro**.

1. En la página **Configuración de filtro** que se abre, haga lo siguiente:

   1. En **Nombre**, escriba un nombre para el filtro.

   1. En **Conjuntio de datos**, elija un conjunto de datos al que quiera aplicar el filtro.

   1. En **Campo**, elija el campo por el que desea filtrar.

   1. En **Opción nula**, elija una de las opciones desplegables:
      + **No se ha seleccionado ninguna opción nula**: no se ha seleccionado ninguna opción para filtrar los valores nulos.
      + **Incluir solo valores nulos**: se filtran solo los valores nulos del campo seleccionado.
      + **Excluir solo valores nulos**: se filtran solo los valores no nulos del campo seleccionado.

   1. (Opcional) Para especificar cuándo se aplica el filtro, elija **Aplicar el filtro cada vez que se utilice el conjunto de datos** y, a continuación, elija una de las siguientes opciones:

      1. **Aplicar siempre**: el filtro se aplica siempre que cualquier columna del conjunto de datos especificado esté vinculada a una pregunta.

      1. **Aplicar siempre, a menos que una pregunta genere un filtro explícito del conjunto de datos**: el filtro se aplica siempre que una columna del conjunto de datos especificado esté vinculada a una pregunta, a menos que la pregunta contenga su propio filtro explícito para el mismo campo.

   1. Seleccione **Save**.

 El filtro se añade a la lista de campos del tema. Puede editar su descripción o puede ajustarlo en el momento de aplicación del filtro.

## Pregunta sobre valores nulos
<a name="ask-questions-on-null-values"></a>

Puede usar las preguntas y respuestas para hacer preguntas directamente sobre los valores nulos, como las siguientes:
+ ¿Cuál es el importe total de ventas de los registros en los que el segmento es nulo?
+ Mostrar cuentas sin representantes asignados.
+ Enumerar proyectos sin fecha de finalización.
+ Mostrar productos del inventario sin asignaciones de categorías.
+ ¿Qué porcentaje del total de pedidos tiene valores no nulos en el campo de licencia por segmento?
+ ¿Qué pedidos no tienen ningún cliente asignado?

## Administración de valores nulos en visualizaciones
<a name="manage-null-values-in-visualizations"></a>

Tras generar las visualizaciones a través de la barra de preguntas y respuestas, puede interactuar con gráficos mediante varias acciones con valores nulos, como centrarse únicamente en los valores nulos o excluirlos. Estas acciones del gráfico le ayudan a analizar y filtrar los datos de forma dinámica en función de la presencia de valores nulos.

Elija **Centrarse solo en valores nulos** o **Excluir valores nulos** para filtrar los resultados de forma adecuada.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/focus-on-null.png)


## Ajuste de las interpretaciones de las consultas para la gestión de valores nulos
<a name="refine-query-interpretations-for-null-value-handling"></a>

Una vez generadas las visualizaciones basadas en la consulta, puede ajustar la forma en que se gestionan los valores nulos.

1. Localice la sección **Interpretado como** debajo de la consulta.

1. Seleccione el campo que desee modificar.

1. En el menú desplegable, elija **Opciones nulas** para ajustar la gestión de los valores nulos.

![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/interpreted-as.png)


En el caso de los campos categóricos, los valores vacíos no son lo mismo que los valores nulos. Cómo convertir valores vacíos en nulos:

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Temas** y, a continuación, abra el tema al que desee agregar un filtro.

1. Elija la pestaña **Datos**.

1. Elija **Agregar campo calculado**.

1. Ingrese un nombre en el campo **Agregar nombre**.

1. Elija un campo categórico e ingrese una expresión para convertir valores vacíos en valores nulos: `ifelse({Segment}="",NULL,{Segment})`.

1. Seleccione **Save**.

# Mejora de la precisión de las preguntas y respuestas con instrucciones personalizadas
<a name="gen-bi-improve-qa-accuracy-with-custom-instructions"></a>

Las instrucciones personalizadas permiten a los autores seleccionar las respuestas de Amazon Q a las preguntas al agregar conocimientos específicos del dominio que no se pueden capturar a través de la configuración de metadatos de un tema, como los sinónimos o los tipos semánticos. Al proporcionar estas descripciones de metadatos o instrucciones personalizadas, los autores pueden guiar a Amazon Q para alinear sus respuestas con distintas definiciones, preferencias y conocimientos especializados, lo que garantiza respuestas más precisas, pertinentes y personalizadas que se adapten mejor a sus necesidades empresariales. 

Utilice la siguiente tabla para saber cuándo y cómo aplicar diferentes tipos de metadatos para mejorar la precisión de las respuestas a las preguntas. Cada tipo de metadatos desempeña una función única al aclarar el contexto, resolver la ambigüedad y garantizar que las respuestas estén alineadas con las reglas empresariales o la terminología específica del dominio.


| Tipo de metadatos | Cuándo se debe usar | Cómo mejora la precisión de las respuestas | 
| --- | --- | --- | 
|  Descripción de campos  |  Cuando el sistema de preguntas y respuestas necesita entender nombres de columnas ambiguos o específicos del dominio (por ejemplo, `DTC Spend`).  |  Aclara la semántica de los campos para que el modelo pueda responder con mayor precisión (por ejemplo, interpretándolo `DTC Spend` como gasto de Direct-to-Consumer marketing).  | 
|  Descripción de temas  |  Cuando los usuarios pueden hacer preguntas amplias o ambiguas y Amazon Q necesita más contexto sobre el propósito general del tema (por ejemplo, rendimiento de ventas frente a datos de ensayos clínicos).  |  Ayuda a eliminar la ambigüedad de términos generales y a orientar las respuestas hacia el dominio correcto (por ejemplo, ventas o marketing).  | 
|  Descripción de conjuntos de datos  |  Cuando los usuarios tienen acceso a varios conjuntos de datos y el sistema de preguntas y respuestas necesita identificar cuál se ajusta mejor a la pregunta.  |  Habilita la lógica de selección de conjuntos de datos al proporcionar un contexto sobre el propósito y el contenido de cada conjunto de datos.  | 
|  Instrucciones personalizadas de temas  |  Cuando un tema tiene reglas empresariales, plazos o definiciones específicos (por ejemplo, año fiscal o año natural).  |  Aplica lógicas o definiciones personalizadas (por ejemplo, definir el primer trimestre como agosto-octubre) para adaptar las respuestas de forma adecuada.  | 

## Adición de descripciones de campos
<a name="adding-field-level-descriptions"></a>

**Cómo agregar descripciones de campos:**

1. Abra la consola [rápida](https://quicksight.aws.amazon.com/).

1. Elija **Temas** y, a continuación, abra el tema al que desee agregar descripciones.

1. En la página de detalles del tema, seleccione la pestaña **Datos** y, a continuación, elija la subpestaña **Campos de datos**.

1. Agrega una descripción para mejorar la precisión de las respuestas de cada campo incluido. Esto es especialmente importante para la comprensión de los nombres de campos que contienen conocimientos corporativos personalizados. 

 Si tienes varios campos de fechas, por ejemplo, las descripciones claras pueden ayudar a Amazon Q a distinguirlos y elegir el más pertinente en función de la pregunta del usuario. En el siguiente ejemplo, un autor agregó descripciones para **Creación de soluciones** y **Creación de temas**, lo que permite a Amazon Q seleccionar con mayor precisión el campo de fecha correspondiente en su contexto. 

![\[descripción de creación de soluciones\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/solution_create.png)


![\[descripción de creación de temas\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/topic_create.png)


## Adición de descripciones de temas
<a name="adding-topic-level-descriptions"></a>

**Cómo agregar descripciones de temas:**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Temas** y, a continuación, abra el tema al que desee agregar descripciones.

1. En la página de detalles del tema, seleccione la pestaña **Resumen**.

1. En **Detalles del tema**, agregue una descripción para proporcionar más contexto sobre el propósito general del tema.

## Adición de descripciones de conjuntos de datos
<a name="adding-dataset-descriptions"></a>

**Cómo agregar descripciones de conjuntos de datos:**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Temas** y, a continuación, abra el tema al que desee agregar descripciones.

1. En la página de detalles del tema, seleccione la pestaña **Datos** y, a continuación, elija la subpestaña **Conjuntos de datos**.

1. Agregue una descripción para ayudar a mejorar la lógica de selección de conjuntos de datos.

## Adición de instrucciones personalizadas de temas
<a name="adding-topic-level-custom-instructions"></a>

**Cómo agregar instrucciones personalizadas:**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Temas** y, a continuación, abra el tema al que desee agregar descripciones.

1. En la página de detalles de los temas, seleccione la pestaña **Instrucciones personalizadas**.

1. Agregue una guía a nivel de tema para ayudar al chat a comprender mejor el contexto, la terminología o la intención específicos del tema seleccionado. Esto puede incluir consejos de desambiguación, relaciones entre campos, definiciones de términos que no se pueden incluir en un campo calculado o en un filtro de temas, o instrucciones para personalizar intervalos de fechas relativos.

## Prácticas recomendadas para escribir instrucciones personalizadas
<a name="best-practices-for-writing-custom-instructions"></a>

**Coincidencia de los valores de las celdas con precisión**
+ Utilice el valor de celda exacto de la base de datos, incluidas las mayúsculas y el formato.
+ Si el valor es ambiguo, consulte la columna de origen para aclararlo.

Ejemplos:
+ En lugar de: “*AMZ son clientes de Amazon*”

  Use: “*AMZ are 'Amazon.com, Inc.'” clientes»*
+ En lugar de: «*ETPs son clientes empresariales*»

  Utilice: «*ETPs son clientes del segmento empresarial*»

**Especificidad y cantidad**

Evite usar un lenguaje impreciso: exprésese con claridad sobre los filtros, los umbrales y las columnas de origen.

Ejemplo:
+ En lugar de: “*Filtrar grandes clientes al hablar de ventas*”

  Use: «*Filtrar clientes con ingresos anuales superiores a 1 millón de USD al hablar de ventas*”

**Uso del formato para mayor claridad, no para funciones**

El espaciado y los saltos de línea no afectan al comportamiento del modelo, pero ayudan a los autores a leer y mantener las instrucciones con mayor facilidad.

**Comprensión de lo que las instrucciones personalizadas no pueden hacer**

Las instrucciones personalizadas mejoran la comprensión del contexto empresarial, pero no añaden nuevas capacidades. Estas instrucciones no permitirán lo siguiente:
+ Cambiar las selecciones de tipos de gráficos
+ Hacer cálculos o rellenar valores nulos
+ Crear nuevos campos
+ Controlar el formato, los colores o las leyendas
+ Modifique la narrativa o number/type las imágenes

## Adición de descripciones de campos en la preparación de datos para preguntas y respuestas basadas en paneles
<a name="adding-field-level-descriptions-for-dashboard-based-qa"></a>

Además de las descripciones basadas en temas, puede crear definiciones de temas para mejorar la funcionalidad de [Panel: preguntas y respuestas](dashboard-qa.md). Añadir definiciones específicas a los campos individuales durante la fase de preparación de los datos mejora la precisión de las respuestas cuando los usuarios hacen preguntas sobre determinados elementos del panel de control.

**Adición de descripciones de campos para preguntas y respuestas basadas en paneles:**

1. Abra la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Datos**, abra un conjunto de datos al que tenga acceso y seleccione **EDITAR CONJUNTO DE DATOS**.

1. Para cada campo pertinente, elija el menú de tres puntos y seleccione **Editar nombre y descripción**.

1. Agregue una descripción para mejorar las respuestas a preguntas relacionadas con paneles.

1. Elija **Aplicar** para guardar los cambios.

# Formulación y respuesta a preguntas sobre datos con BI generativa
<a name="gen-bi-data-q-and-a"></a>

**nota**  
Para ver la experiencia multivisual, el autor del tema debe hacer lo siguiente: añadir entidades con nombre y convertir un tema existente para utilizar las capacidades generativas o crear un tema generativo nuevo. Para obtener más información, consulte [Creación de preguntas y respuestas](gen-bi-author-q-and-a.md).

Acelere las decisiones basadas en datos con preguntas y respuestas humanistas que incluyan:
+ Narrativa generada por IA que destaque la información clave
+ Respuesta multivisual que proporcione la respuesta a su pregunta junto con elementos visuales de apoyo para agregar contexto
+ Página de inicio para cada tema con preguntas sugeridas generadas con IA y revisadas por el autor, junto con vistas previas de datos automatizadas para ver de qué datos puede solicitar información

Selecciona el icono brillante de la parte superior derecha. Una vez que abra el tema, aparecerá una página de inicio con una lista de preguntas sugeridas y la sección **Contenido del tema** para ver los datos sobre los que puede formular preguntas. 

Cuando haya varias fechas disponibles, elija **más...** para verlas. Por ejemplo, en este tema sobre tendencias de matriculación de estudiantes, hay datos disponibles sobre información de matriculaciones que abarcan desde 2018 hasta 2023, pero también hay datos sobre la fecha de nacimiento (DOB) de los estudiantes desde 1973 hasta 2005.

Elija una pregunta sugerida o escriba la suya propia para empezar. Al pasar el ratón sobre una frase en la narración generada mediante IA, podrá identificar claramente la visualización del origen y verificar los valores. Cada visualización es interactiva y se puede agregar a su tablón de anuncios. 

Puede obtener respuestas a una variedad de preguntas, desde vagas hasta precisas. 

Si no tiene en mente ninguna pregunta exacta, puede hacer una pregunta vaga que contenga solo una palabra o una frase corta, como *“ventas”* o *“mejores estudiantes”.* Puede incluir criterios de filtro adicionales con estas preguntas vagas, como *“mejores estudiantes del semestre pasado”.*

Los ejemplos de preguntas incluyen:
+ Nombre de la entidad: *“Detalles del pedido”*
  + 
**nota**  
Puedes encontrar las entidades en la página principal del tema y en la *topic* pestaña **Qué hay en** la parte superior de la lista. 
  + Nombre del campo: “Segmento”
  + Valores de campo: “Acme Inc.”, “Washington DC”
  + Filtros vagos (o implícitos): “mejores gestores de cuentas”, “productos de gama baja”

Para ver las preguntas precisas compatibles, consulta esta tabla de tipos de preguntas: [Tipos de preguntas compatibles con Q.](https://docs.aws.amazon.com/quicksight/latest/user/quicksight-q-ask.html#quicksight-q-ask-types) Algunos ejemplos son «el producto con el mayor porcentaje de crecimiento de WoW» o «las ventas previstas para los clientes de APAC por trimestre». Abarca una variedad de filtros, como filtros de fecha superior/inferior, relativos y absolutos period-over-period, etc. period-to-date También admite preguntas analíticas, como el porcentaje del total o «¿por qué cayeron las ventas en octubre de 2023?»

**sugerencia**  
Para ayudarle a formular preguntas, piense en *quién*, *qué*, *dónde*, *cuándo* y *por qué*.

Desglose de su respuesta:
+ **Interpretado como:** así es como Amazon Q interpretó su pregunta. Correlacionará tus palabras con los datos subyacentes para que puedas comprobar que las has entendido correctamente. Si no es así, ajuste la pregunta o deje un comentario para su autor.
+ **Narrativa generada con IA:** resumen de los elementos visuales destacan la información clave. Si su cuenta Quick está conectada a una aplicación de Amazon Q, puede recibir información adicional de fuentes de datos no estructuradas en **Insights from Q Business**. Puede ver los orígenes no estructurados que se utilizan en el menú desplegable **Orígenes**. Para obtener más información sobre cómo conectar una cuenta Quick a una aplicación de Amazon Q Business, consulte[Cómo aumentar los conocimientos de Amazon Quick Sight con Amazon Q Business](generative-bi-q-business.md).
+ **Imágenes:** — Las imágenes consisten en: una imagen central que responde directamente a la pregunta, una imagen de apoyo a la derecha que proporciona contexto y relevancia KPIs, y una tabla de detalles en la parte inferior.
**nota**  
Si el campo no está incluido en una entidad nombrada, se mostrará como un elemento visual único. 
+ **Querías decir:** — Cuando tu pregunta tenga varias interpretaciones, se mostrará una lista de respuestas alternativas que puedes seleccionar para alinearlas con la pregunta que deseas formular.
  + En el siguiente ejemplo, la pregunta “clientes principales” se puede interpretar de varias maneras, como “ventas totales”, “beneficio total” o “número de clientes”.  
![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/top-customers.png)

Otros consejos
+ Para cambiar el tamaño del panel, arrastre el lado izquierdo.
+ Agregue elementos visuales importantes a su tablón de anuncios para acceder rápidamente a ellos. Visualiza tu tablón de anuncios desde la parte superior del panel de Amazon Q.
+ Envíe comentarios al autor del tema para que los vea y realice mejoras.

# Optar por no participar en el BI generativo
<a name="generative-bi-opt-out"></a>

Las cuentas rápidas se cobran si el BI generativo está activo en la cuenta. El BI generativo se considera activo si su cuenta utiliza alguna de las siguientes capacidades:
+ Usuarios profesionales
+ Temas
+ Indexación de elementos visuales y paneles
+ Preguntas y respuestas en el panel

Para evitar que se le cobre por el BI generativo desactivándolo por completo, lleve a cabo los siguientes pasos.

**aviso**  
Al excluirse del BI generativo, se desactivarán las funciones impulsadas por la IA y se eliminarán los cargos relacionados. Este proceso implica lo siguiente:  
Eliminar o cambiar los roles de usuario profesional por roles estándar
Eliminar todos los temas de su cuenta
Desactivar la indexación del panel y las características de preguntas y respuestas
**Antes de continuar:** revise los pasos detenidamente y asegúrese de entender qué características se desactivarán.

**Para excluirse del BI generativo**

1. Asegúrese de que no haya usuarios ni grupos de usuarios profesionales asignados a roles profesionales en la cuenta. Para ello, siga estos pasos:
   + Para actualizar o eliminar usuarios Pro mediante APIs:
     + Si utilizas Quick Identity (con o sin la federación de IAM):

       1. Busca usuarios que tengan funciones profesionales mediante la [ListUsers](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListUsers.html)API.

       1. Cambia los roles de los usuarios mediante la [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html)API o elimina a los usuarios de la cuenta mediante la [DeleteUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteUser.html)API.
     + Si utiliza IAM Identity Center o Microsoft Active Directory:

       1. Busca un grupo de usuarios asignados a roles profesionales mediante la [ListRoleMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListRoleMemberships.html)API.

       1. Cree nuevos grupos de usuarios con los mismos usuarios, pero asignados a diferentes roles, mediante la [CreateRoleMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_CreateRoleMemberships.html)API.

       1. Elimine los grupos de usuarios anteriores asignados a los roles profesionales mediante la [DeleteRoleMemberships](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteRoleMemberships.html)API.
   + Para actualizar o eliminar usuarios Pro mediante la consola rápida:

     1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

     1. Selecciona el icono del perfil y, a continuación, selecciona **Administrar rápidamente**.

     1. Si es necesario, en el panel de navegación izquierdo, elija **Administrar usuarios**.
        + Si utilizas Quick Identity (con o sin la federación de IAM), actualiza las funciones de los usuarios o elimina los usuarios siguiendo los pasos que se indican en [Ver los detalles de la cuenta Amazon Quick](managing-user-access-qs-iam.md#view-user-accounts) o[Eliminar una cuenta de usuario de Amazon Quick](managing-user-access-qs-iam.md#delete-a-user-account).
        + Si utiliza IAM Identity Center o Microsoft Active Directory, actualice las asignaciones de grupos y roles o elimine los grupos de usuarios según los pasos de [Administración del acceso de los usuarios](managing-user-access-idc.md#view-user-accounts-enterprise).

1. Para asegurarse de que no haya temas en la cuenta, siga estos pasos:

   1. Usa la [ListTopics](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListTopics.html)API para enumerar todos los temas de la cuenta de cada AWS región en la que se usen los temas.

   1. Para cada tema, lleve a cabo una de las siguientes acciones:
      + Si eres propietario o copropietario de los temas, elimínalos mediante la [DeleteTopic](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteTopic.html)API.
      + Si no es propietario o copropietario de los temas:
        + Identifica a los propietarios de cada tema mediante la [DescribeTopicPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeTopicPermissions.html)API y pídeles que eliminen sus temas mediante la [DeleteTopic](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteTopic.html)API.
        + Conviértete en copropietario de los temas mediante la [UpdateTopicPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateTopicPermissions.html)API y, a continuación, elimínalos mediante la [DeleteTopic](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DeleteTopic.html)API.

1. Asegúrese de que la indexación de elementos visuales y paneles y las preguntas y respuestas en el panel estén desactivadas. Para ello, siga estos pasos:
   + Para deshabilitar la indexación visual y el panel de control y las preguntas y respuestas sobre el panel de control mediante: APIs

     1. [Deshabilite la indexación visual y del panel de control mediante la API de configuración. UpdateQuickSight QSearch](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateQuickSightQSearchConfiguration.html)

     1. Deshabilite las preguntas y respuestas del panel de control mediante la API. [UpdateDashboardsQAConfiguration](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardsQAConfiguration.html)
   + Para deshabilitar la indexación visual y del panel de control y las preguntas y respuestas del panel de control mediante la consola rápida:

     1. [Abre la consola rápida.](https://quicksight.aws.amazon.com/)

     1. Selecciona el icono del perfil y, a continuación, selecciona **Administrar rápidamente**.

     1. En la sección **Cuenta**, selecciona **Amazon Q.**

     1. Desactive cada una de las opciones.

# Cómo trabajar con Amazon Quick Sight Topics
<a name="topics"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Los *temas* son colecciones de uno o más conjuntos de datos que representan un área temática sobre la que los usuarios de su empresa pueden hacer preguntas. 

Con la preparación automática de datos de Quick Sight, dispondrá de una ayuda basada en aprendizaje automático que le ayudará a crear un tema que sea relevante para sus usuarios finales. El primer proceso comienza con la selección y clasificación automatizadas de campos, algo como esto:
+ La preparación automática de datos selecciona una pequeña cantidad de campos para incluirlos de forma predeterminada a fin de crear un espacio de datos específico para que los lectores lo exploren.
+ La preparación automática de datos selecciona los campos que se utilizan en otros activos, como informes y paneles. 
+ La preparación automática de datos también importa cualquier campo adicional de cualquier análisis relacionado en el que un tema esté activado. 
+ Identifica fechas, dimensiones y medidas para aprender cómo se pueden usar los campos en las respuestas.

Este conjunto automático de campos ayuda al autor a empezar rápidamente con el análisis del lenguaje natural. Los autores siempre pueden excluir campos o incluir campos adicionales, según sea necesario, mediante la opción **Incluir**.

A continuación, la preparación automática de datos continúa con el proceso etiquetando automáticamente los campos e identificando los sinónimos. La preparación automática de datos actualiza los nombres de los campos con nombres descriptivos y sinónimos utilizando términos comunes. Por ejemplo, se puede cambiar el nombre de un campo `SLS_PERSON` por `Sales person` y asignarle sinónimos, como `salesman`, `saleswoman`, agente y `sales representative`. Aunque puedes dejar que la preparación automática de datos se encargue de gran parte del trabajo, vale la pena revisar los campos, los nombres y los sinónimos para personalizarlos aún más para los usuarios finales. Por ejemplo, si los usuarios se refieren a un vendedor como “representante” o “distribuidor” en una conversación informal, usted apoya este término añadiendo `rep` y `dealer` a los sinónimos de `SLS_PERSON`. 

Por último, la preparación automática de datos detecta el tipo semántico de cada campo mediante un muestreo de sus datos y el examen de los formatos que el autor les ha aplicado durante el análisis. La preparación automática de datos actualiza automáticamente la configuración del campo y establece los formatos de los valores utilizados en cada campo. Por lo tanto, las respuestas a las preguntas se proporcionan en los formatos esperados para fechas, monedas, identificadores, booleanos, personas, etc. 

Para obtener más información sobre cómo trabajar con temas, continúe con las siguientes secciones de este capítulo.

**Topics**
+ [Navegación por temas](navigating-topics.md)
+ [Creación de temas de Quick Sight](topics-create.md)
+ [Espacio de trabajo de temas](topics-interface.md)
+ [Trabajar con conjuntos de datos en un tema de vista rápida](topics-data.md)
+ [Creación de temas de Quick Sight natural-language-friendly](topics-natural-language.md)
+ [Compartir temas de Quick Sight](topics-sharing.md)
+ [Administrar los permisos de temas de Amazon Quick Sight](topics-sharing-permissions.md)
+ [Revisión del rendimiento y los comentarios de los temas de Quick Sight](topics-performance.md)
+ [Actualización de los índices de temas de Quick Sight](topics-index.md)
+ [Trabaje con temas de Quick Sight con Amazon Quick Sight APIs](topics-cli.md)

# Navegación por temas
<a name="navigating-topics"></a>

En Quick Sight, hay más de una forma de crear y administrar un tema. Puedes empezar en una página de inicio o «inicio» de Amazon Quick. O bien, puede empezar dentro de un análisis.

**Topics**
+ [Desde una página de inicio de Amazon Quick](starting-from-home.md)
+ [De un análisis de Amazon Quick Sight](starting-from-sheets.md)
+ [Navegar por las preguntas en un análisis de Amazon Quick Sight](starting-from-questions-on-sheets.md)

# Desde una página de inicio de Amazon Quick
<a name="starting-from-home"></a>

Desde la página de inicio rápido, puede crear y administrar temas seleccionando **Temas** en el panel de navegación de la izquierda. Quick proporciona un flujo de trabajo guiado para crear temas. Puede salir del flujo de trabajo guiado y volver a él más tarde, sin interrumpir su trabajo. 

Al crear un tema, los usuarios de su empresa pueden hacer preguntas al respecto. En cualquier momento, puede abrir un tema para cambiarlo o revisar su rendimiento.

Para abrir un tema, elija el nombre del tema.

Si en algún momento quiere volver a la lista de todos sus temas, seleccione **Todos los temas** a la izquierda del espacio de trabajo del tema.

# De un análisis de Amazon Quick Sight
<a name="starting-from-sheets"></a>

Para empezar con un análisis de Amazon Quick Sight, abra el análisis que desee utilizar con la preparación automática de datos.

Para abrir o crear un tema, elija el icono del tema en la barra de navegación superior.

En cualquier momento, puede abrir un tema para cambiarlo o revisar su rendimiento.

Para abrir un tema desde un análisis, elija el nombre del tema en la barra de navegación superior, si aún no aparece. A continuación, seleccione el icono de puntos suspensivos verticales (` ⋮ `) en la barra de navegación superior. 

Para ver información sobre el tema, seleccione **Acerca del tema**.

Para ver los campos de datos incluidos en el tema, seleccione **Campos de datos** en la lista de pestañas.

# Navegar por las preguntas en un análisis de Amazon Quick Sight
<a name="starting-from-questions-on-sheets"></a>

Al navegar por las preguntas y respuestas de un tema de un análisis, puede aprender cómo se utiliza el tema. Esta información puede ayudarle a realizar ajustes si es necesario. 

Partiendo de un análisis que ya esté vinculado a un tema, selecciona la barra de búsqueda situada en la barra de navegación superior y, a continuación, introduce una pregunta. La respuesta aparece en una pantalla de temas que también muestra todas las opciones disponibles para trabajar con el tema en un análisis. 
+ Para cambiar el tipo de elemento visual que se muestra en la respuesta, seleccione el icono de texto (que se parece a un gráfico de barras).
+ Para ver las sugerencias de mejora, seleccione el globo de diálogo, que aparece resaltado si tiene sugerencias sin ver.
+ Para ver información relacionada con una pregunta, seleccione el icono de la bombilla.
+ Para añadir o eliminar una pregunta del tablón de anuncios, cambie el icono de **Añadir al tablón de anuncios** o **Eliminar del tablón de anuncios**. Para ver el tablón de anuncios, seleccione el icono del tablón de anuncios en la barra de navegación superior.
+ Para ver información sobre este tema, seleccione la letra *i* rodeada en un círculo (` ![\[alt text not found\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/status-info.png) `).
+ Seleccione el menú de puntos suspensivos (` … `) para realizar una de las siguientes acciones: 
  + **Exportar a CSV**: exporte los datos que se muestran en el elemento visual seleccionado.
  + **Copiar el identificador de solicitud**: capture el identificador de solicitud de este proceso para solucionar problemas. Amazon Quick Sight genera un identificador de solicitud alfanumérico para identificar de forma exclusiva cada proceso. 
  + **Compartir este elemento visual**: comparta de forma segura la URL del tema utilizado en el elemento visual.
  + **Desglose de la respuesta**: para ver una explicación detallada de la respuesta.

En la parte inferior de la pantalla del tema, puede añadir o cambiar variantes de la pregunta seleccionando **Editar variantes de la pregunta**. También en la parte inferior, cuando esté satisfecho con la pregunta y la respuesta, marque el tema como revisado seleccionando **Marcar como revisado**. O bien, si ve que un tema revisado anteriormente necesita una revisión más detallada, seleccione **Desmarcar como revisado**. 

En cualquier momento, puede abrir un tema para cambiarlo o revisar su rendimiento. Para trabajar directamente con la configuración de un tema, como los campos que se incluyen o los sinónimos que tienen, use la página **Temas**.

**Apertura de un tema vinculado a un análisis**

1. Abra la página de **temas** de Amazon Quick Sight desde la página de inicio rápido, seleccionando **Temas** en el panel de navegación de la izquierda.

   Si desea mantener abierto el análisis, puede abrir la página **Temas** en una nueva pestaña o ventana del navegador.

1. Para abrir un tema, elija el nombre del tema. Si ha abandonado recientemente la página de análisis, es probable que el nombre siga apareciendo en la barra de búsqueda situada en la parte superior de la pantalla.

1. Si en algún momento quiere volver a la lista de todos sus temas, seleccione **Todos los temas** a la izquierda del espacio de trabajo del tema.

# Creación de temas de Quick Sight
<a name="topics-create"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Para activar las preguntas en sus conjuntos de datos, debe crear un tema. Quick Sight proporciona un flujo de trabajo guiado para crear temas. Puede salir del flujo de trabajo guiado y volver a él más tarde, sin interrumpir su trabajo. 

Hay dos formas de crear un tema:
+ Cree el tema seleccionando un conjunto de datos. Al crear temas en Quick Sight, puede agregarles varios conjuntos de datos y también habilitar los temas en los análisis. 
+ Cree el tema mediante un análisis. Cuando crea un tema en un análisis o vincula un tema existente a un análisis, la preparación automática de datos aprende de la forma en que analiza los datos y la aplica automáticamente al tema. 

Cuando compartas tu tema con los lectores rápidos y estos lo usen para hacer preguntas en la barra de búsqueda, podrás ver un resumen del rendimiento del tema. También puedes ver una lista de todo lo que han preguntado los usuarios y qué tan bien se ha respondido, así como de cualquier respuesta que hayas verificado. Es importante revisar los comentarios para que los usuarios de su empresa puedan seguir recibiendo las visualizaciones y respuestas correctas a sus preguntas.

## Creación de un tema
<a name="topics-create-how"></a>

Utilice el siguiente procedimiento para crear un tema.

**Creación de un tema**

1. En la página de inicio de Quick, selecciona **Temas**.

1. En la página de **temas** que se abre, selecciona **Crear tema** en la esquina superior derecha.

1. En la página **Crear tema** que se abre, haga lo siguiente:

   1. En **Tema**, introduzca un nombre descriptivo para el tema.

      Los usuarios de su empresa identifican el tema con este nombre y lo utilizan para hacer preguntas.

   1. En **Descripción**, escriba una descripción para el tema.

      Los usuarios pueden usar esta descripción para obtener más detalles sobre el tema.

   1. Elija **Continuar**.

1. En la página **Agregar datos al tema** que se abre, elija una de las siguientes opciones:
   + Para agregar uno o más conjuntos de datos que le pertenezcan o para los que tenga permiso, elija **Conjuntos de datos** y, a continuación, seleccione el conjunto o conjuntos de datos que desee agregar.
   + Para añadir conjuntos de datos de los paneles que haya creado o que se hayan compartido con usted, elija **Conjuntos de datos de un panel** y, a continuación, seleccione un panel de la lista.

1. Elija **Añadir datos**.

   Se crea el tema y se abre la página correspondiente. El siguiente paso consiste en configurar los metadatos del tema para que estén disponibles natural-language-friendly para sus lectores. Para obtener más información, consulte [Creación de temas de Quick Sight natural-language-friendly](topics-natural-language.md). O continúe con el tema siguiente para explorar el espacio de trabajo de tema.

# Espacio de trabajo de temas
<a name="topics-interface"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Después de crear un tema, o al elegir un tema existente de la lista de la página **Temas**, el tema se abre en el espacio de trabajo de ese tema. Aquí aparecen cuatro pestañas que puede utilizar, tal y como se describe en las siguientes secciones. Quick Sight proporciona un flujo de trabajo guiado para los temas. Puede salir del flujo de trabajo guiado y volver a él más tarde, sin interrumpir su trabajo. 

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

La pestaña **Resumen** tiene tres áreas importantes:
+ **Sugerencias**: las sugerencias proporcionan step-by-step orientación sobre cómo se puede mejorar un tema. Estos pasos le ayudarán a entender cómo crear temas con mejor rendimiento.

  Para seguir una sugerencia, seleccione el botón de acción del banner de sugerencias y siga los pasos recomendados.

  Actualmente, hay ocho sugerencias predefinidas que se ofrecen en el orden que se muestra en la siguiente tabla. Después de completar un paso para una sugerencia, se le ofrecerá una nueva cuando regrese a la pestaña **Resumen**.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/topics-interface.html)
+ **Métricas e indicadores clave de rendimiento (KPIs) sobre la participación y el rendimiento de un tema**: en esta sección, puedes ver cómo interactúan tus lectores con tus temas y qué comentarios y valoraciones dan a las respuestas proporcionadas. Puede ver la interacción de todas las preguntas que hicieron los usuarios o seleccionar una pregunta específica. También puede cambiar el periodo de tiempo de las métricas de un año a una semana.

  Para obtener más información, consulte [Revisión del rendimiento y los comentarios de los temas de Quick Sight](topics-performance.md).
+ **Conjuntos de datos**: en esta sección se muestran los conjuntos de datos que se usaron para crear el tema. En esta sección, puede agregar conjuntos de datos adicionales o importar conjuntos de datos de paneles existentes. También puede editar los metadatos de un conjunto de datos de temas, establecer una programación de actualización de datos, cambiar el nombre del conjunto de datos y mucho más. Para obtener más información, consulte [Trabajar con conjuntos de datos en un tema de vista rápida](topics-data.md).

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

La pestaña **Datos** muestra todos los campos incluidos en el tema. Aquí puede configurar los metadatos de los temas para convertirlos en tema natural-language-friendly y mejorar su rendimiento. Para obtener más información, consulte [Creación de temas de Quick Sight natural-language-friendly](topics-natural-language.md).

## Actividad de los usuarios
<a name="topics-interface-user"></a>

Esta pestaña muestra todas las preguntas que recibe su tema y los comentarios generales de cada pregunta. Puede ver un resumen de cuántas preguntas se hicieron y qué porcentaje de ellas fueron positivas y negativas. Puede filtrar por valoración y por si alguien ha dejado un comentario con sus valoraciones. Para obtener más información, consulte [Revisión del rendimiento y los comentarios de los temas de Quick Sight](topics-performance.md).

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

Las *respuestas verificadas* son preguntas para las que tiene elementos visuales preconfigurados. Para crear una respuesta verificada a una pregunta, haz la pregunta en la barra de búsqueda y luego la marca como revisada. Mediante la pestaña **Respuestas verificadas**, puede revisar sus respuestas verificadas y los comentarios que reciben de sus usuarios.

# Trabajar con conjuntos de datos en un tema de vista rápida
<a name="topics-data"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Al crear un tema, puede agregarle conjuntos de datos adicionales o importarlos de los paneles existentes. En cualquier momento, puede editar los metadatos de un conjunto de datos y establecer una programación de actualización de datos. También puede añadir nuevos campos a un conjunto de datos de un tema mediante la creación de campos calculados, filtros o entidades con nombre.

**Topics**
+ [Añadir conjuntos de datos a un tema en Amazon Quick Sight](topics-data-add.md)
+ [Añadir conjuntos de datos con seguridad a nivel de fila (RLS) a un tema de Amazon Quick Sight](topics-data-rls.md)
+ [Actualización de conjuntos de datos en un tema de vista rápida](topics-data-refresh.md)
+ [Eliminar conjuntos de datos de un tema de Amazon Quick Sight](topics-data-remove.md)
+ [Añadir campos calculados a un conjunto de datos de temas de Amazon Quick Sight](topics-data-calculated-fields.md)
+ [Añadir filtros a un conjunto de datos de temas de Amazon Quick Sight](topics-data-filters.md)
+ [Añadir entidades con nombre a un conjunto de datos de temas de Amazon Quick Sight](topics-data-entities.md)

# Añadir conjuntos de datos a un tema en Amazon Quick Sight
<a name="topics-data-add"></a>

En cualquier momento, puede agregar conjuntos de datos a un tema. Utilice el siguiente procedimiento para obtener información sobre cómo hacerlo.

**Adición de conjuntos de datos a un tema**

1. Abra el tema al que desee agregar uno o más conjuntos de datos.

1. En la página de **resumen**, selecciona **Datos**. A continuación, en **Conjuntos de datos**, selecciona **Añadir conjuntos** de datos.

1. En la página **Agregar conjuntos de datos** que se abre, elija los conjuntos de datos que desee agregar y, a continuación, elija **Agregar conjuntos de datos**.

   El conjunto de datos se agrega al tema y se indexan los valores de cadena únicos del conjunto de datos. Las configuraciones de los campos se pueden editar de inmediato. Para obtener más información, consulte [Actualización de los índices de temas de Quick Sight](topics-index.md). Para obtener más información sobre la edición de las configuraciones de los campos, consulte[Creación de temas de Quick Sight natural-language-friendly](topics-natural-language.md).

# Añadir conjuntos de datos con seguridad a nivel de fila (RLS) a un tema de Amazon Quick Sight
<a name="topics-data-rls"></a>

Puede agregar conjuntos de datos que contengan seguridad a nivel de fila (RLS) a los temas. Todos los campos de un tema respetan las reglas de RLS que se aplican a su conjunto de datos. Por ejemplo, si un usuario pregunta «muéstrame las ventas por región», los datos que se devuelven se basan en el acceso del usuario a los datos subyacentes. Por lo tanto, si solo se les permite ver la región Este, en la respuesta solo aparecen los datos de la región Este.

Las reglas de RLS se aplican a las sugerencias automáticas cuando los usuarios hacen preguntas. A medida que los usuarios introducen preguntas, solo se les sugieren los valores a los que tienen acceso. Si un usuario introduce una pregunta sobre un valor dimensional al que no tiene acceso, no obtendrá una respuesta para ese valor. Por ejemplo, supongamos que el mismo usuario escribe la pregunta “muéstrame las ventas en la región Oeste”. En este caso, no reciben ninguna sugerencia ni respuesta, aunque hagan una pregunta, porque no tienen acceso a RLS a esa región.

De forma predeterminada, Quick Sight permite a los usuarios hacer preguntas sobre los campos en función de los permisos del usuario en RLS. Siga utilizando esta opción si su campo contiene datos confidenciales a los que desea restringir el acceso. Si sus campos no contienen información confidencial y desea que todos los usuarios vean la información en las sugerencias, puede optar por permitir preguntas para todos los valores del campo.

**Autorización de preguntas en todos los campos**

1. En la página de inicio de Quick, selecciona **Datos**.

1. En la pestaña **Conjuntos de datos**, elige el conjunto de datos al que has añadido RLS y, a continuación, selecciona **Editar** conjunto de datos.

   Para obtener más información sobre cómo agregar RSL a un conjunto de datos, consulte [Uso de la seguridad a nivel de fila en Amazon Quick](row-level-security.md).

1. En la página de preparación de datos, selecciona el menú de campos (los tres puntos) del campo que quieras permitir y, a continuación, selecciona Seguridad a **nivel de fila**.

1. En la página **Seguridad a nivel de fila para Quick** que se abre, elija **Permitir a los usuarios hacer preguntas sobre todos los valores de este campo**.

1. Seleccione **Aplicar**.

1. Cuando termine de editar el conjunto de datos, seleccione **Guardar y publicar** en la barra de herramientas azul de la esquina superior derecha.

1. Agrega el conjunto de datos a tu tema. Para obtener más información, consulte la sección anterior, [Añadir conjuntos de datos a un tema en Amazon Quick Sight](topics-data-add.md).

Si actualmente permite que los usuarios hagan preguntas sobre todos los valores, pero desea implementar las reglas de RLS del conjunto de datos para proteger la información confidencial, repita los pasos 1 a 4 y seleccione **Permitir a los usuarios hacer preguntas sobre este campo en función de sus permisos**. Cuando haya terminado, actualice el conjunto de datos del tema. Para obtener más información, consulte [Actualización de conjuntos de datos en un tema de vista rápida](topics-data-refresh.md).

# Actualización de conjuntos de datos en un tema de vista rápida
<a name="topics-data-refresh"></a>

Al agregar un conjunto de datos a un tema, puede especificar la frecuencia con la que desea que se actualice ese conjunto de datos. Al actualizar los conjuntos de datos de un tema, el índice de ese tema se actualiza con cualquier información nueva y actualizada. 

Los conjuntos de datos no se replican cuando los agregas a un tema. Se crea un índice de valores de cadena únicos y las métricas no se indexan. Por ejemplo, las medidas almacenadas como números enteros no se indexan. Las preguntas que se formulan siempre muestran las métricas de ventas más recientes en función de los datos de su conjunto de datos.

Para obtener más información sobre cómo actualizar el índice de un tema, consulte [Actualización de los índices de temas de Quick Sight](topics-index.md).

Puede establecer una programación de actualización para un conjunto de datos en un tema o actualizar el conjunto de datos manualmente. También puede ver cuándo se actualizaron los datos por última vez. 

**Establecimiento de una programación de actualización de un conjunto de datos de un tema**

1. Abra el tema que desee cambiar.

1. En la página de **resumen**, selecciona **Datos**. A continuación, en **Conjuntos de datos**, expande el conjunto de datos para el que deseas establecer un programa de actualización.

1. Seleccione **Agregar programación** realice una de las siguientes acciones en la página **Agregar programación de actualización** que se abre.
   + Si el conjunto de datos es un conjunto de datos de SPICE, seleccione **Actualizar tema al importar el conjunto de datos en SPICE**.

     Actualmente, no se admiten los SPICE conjuntos de datos que se actualicen por hora. SPICELos conjuntos de datos que están configurados para actualizarse cada hora se convierten automáticamente en una actualización diaria. Para obtener más información sobre cómo configurar programaciones de actualización para conjuntos de datos de SPICE, consulte [Actualización de datos en SPICE](refreshing-imported-data.md).
   + Si el conjunto de datos es un conjunto de datos de consulta directa, haga lo siguiente:

     1. En **Zona horaria**, elija una zona horaria.

     1. En **Repeticiones**, elija la frecuencia con la que desea que se realice la actualización. Puede elegir actualizar el conjunto de datos de forma diaria, semanal o mensual.

     1. En **Hora de actualización**, introduzca la hora a la que quiere que comience la actualización.

     1. En **Fecha de inicio de la primera actualización**, elija la fecha en la que desee empezar a actualizar el conjunto de datos.

1. Seleccione **Guardar**.

**Actualización manual de un conjunto de datos**

1. En la página de **resumen del** tema, selecciona **Datos**. A continuación, en **Conjuntos de datos**, elige el conjunto de datos que deseas actualizar.

1. Elija **Actualizar ahora**.

**Visualización del historial de actualizaciones de un conjunto de datos**

1. En la página de **resumen del** tema, selecciona **Datos**. A continuación, en **Conjuntos de datos**, elige el conjunto de datos del que quieres ver el historial de actualizaciones.

1. Seleccione **Ver historial**.

   Se abre la página **Historial de actualizaciones** con una lista de las veces que se actualizó el conjunto de datos.

# Eliminar conjuntos de datos de un tema de Amazon Quick Sight
<a name="topics-data-remove"></a>

Puede quitar los conjuntos de datos de un tema. Eliminar conjuntos de datos de un tema no los elimina de Quick Sight. 

Utilice el siguiente procedimiento para quitar un conjunto de datos de un tema.

**Eliminación de un conjunto de datos de un tema**

1. Abra el tema que desee cambiar.

1. En la página de **resumen**, selecciona **Datos**. A continuación, en **Conjuntos** de datos, selecciona el menú del conjunto de datos (los tres puntos) de la derecha y, a continuación, selecciona **Eliminar del tema**.

1. En la página **¿Seguro que desea eliminarlo?** que se abre, seleccione **Eliminar** para quitar el conjunto de datos del tema. Seleccione **Cancelar** si no quiere eliminar el conjunto de datos del tema.

# Añadir campos calculados a un conjunto de datos de temas de Amazon Quick Sight
<a name="topics-data-calculated-fields"></a>

Puede crear nuevos campos en un tema mediante la creación de campos calculados. Los *campos calculados* son campos que utilizan una combinación de uno o dos campos de un conjunto de datos con una función compatible para crear nuevos datos. 

Por ejemplo, si un conjunto de datos contiene columnas de ventas y gastos, puede combinarlas en un campo calculado con una función sencilla para crear una columna de beneficios. La función podría ser similar a la siguiente: `sum({Sales}) - sum({Expenses})`.

**Adición de un campo calculado a un tema**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En **Acciones**, seleccione **Añadir campo calculado**.

1. En el editor de cálculos que se abre, haga lo siguiente:

   1. Asigne un nombre descriptivo al campo calculado.

   1. En **Conjunto de datos**, a la derecha, elija un conjunto de datos que desee usar para el campo calculado.

   1. Introduzca un cálculo en el editor de cálculos de la izquierda.

      Puede ver una lista de campos del conjunto de datos en el panel **Campos** de la derecha. También puede ver una lista de funciones compatibles en el panel **Funciones** de la derecha.

      Para obtener más información sobre las funciones y los operadores que puede utilizar para crear cálculos en Quick Sight, consulte[Función de campo calculada y referencia de operador para Amazon QuickFunciones y operadores](calculated-field-reference.md).

1. Cuando termine, elija **Guardar**.

   El campo calculado se agrega a la lista de campos del tema. Puede añadirle una descripción y configurar los metadatos para adaptarlo al lenguaje natural.

# Añadir filtros a un conjunto de datos de temas de Amazon Quick Sight
<a name="topics-data-filters"></a>

A veces, los usuarios de su empresa (lectores) pueden hacer preguntas que contengan términos que se asignen a varias celdas de valores de los datos. Por ejemplo, supongamos que uno de sus lectores pregunta: «Muéstreme las tendencias de ventas semanales en el oeste». En este caso, *oeste* hace referencia a los valores `Northwest` y `Southwest` del campo `Region` y requiere que se filtren los datos para generar una respuesta. Puede agregar filtros a un tema para respaldar solicitudes como estas.

**Adición de un filtro a un tema**

1. Abra el tema al que desea agregar un filtro.

1. En el tema, seleccione la pestaña **Datos**.

1. En **Acciones**, seleccione **Añadir filtro**.

1. En la página **Configuración de filtro** que se abre, haga lo siguiente:

   1. En **Nombre**, escriba un nombre fácil de recordar para el filtro.

   1. En **Conjuntio de datos**, elija un conjunto de datos al que quiera aplicar el filtro.

   1. En **Campo**, elija el campo que quiera filtrar.

      Según el tipo de campo que elija, se le ofrecerán diferentes opciones de filtrado.
      + Si ha elegido un campo de texto (por ejemplo, `Region`), haga lo siguiente:

        1. En **Tipo de filtro**, elija el tipo de filtro que desee.

           Para obtener más información sobre cómo filtrar campos de texto, consulte [Adición de filtros de texto](add-a-text-filter-data-prep.md).

        1. En **Regla**, elija una regla.

        1. En **Valor**, introduzca uno o más valores.
      + Si ha elegido un campo de fecha (por ejemplo, `Date`), haga lo siguiente:

        1. En **Tipo de filtro**, elija el tipo de filtro que desee y, a continuación, introduzca la fecha o fechas a las que desee aplicar el filtro.

           Para obtener más información sobre cómo filtrar fechas, consulte [Adición de filtros de fecha](add-a-date-filter2.md).
      + Si ha elegido un campo numérico (por ejemplo, `Compensation`), haga lo siguiente:

        1. En **Agregación**, elija cómo desea agregar los valores filtrados.

        1. En **Regla**, elija una regla para el filtro y, a continuación, introduzca un valor para esa regla.

        Para obtener más información sobre cómo filtrar campos numéricos, consulte [Adición de filtros numéricos](add-a-numeric-filter-data-prep.md).

   1. (Opcional) Para especificar cuándo se aplica el filtro, elija **Aplicar el filtro cada vez que se utilice el conjunto de datos** y, a continuación, elija una de las siguientes opciones:
      + **Aplicar siempre**: al elegir esta opción, el filtro se aplica siempre que cualquier columna del conjunto de datos que especificó esté vinculada a una pregunta.
      + **Aplicar siempre, a menos que una pregunta genere un filtro explícito del conjunto de datos**: al elegir esta opción, el filtro se aplica siempre que cualquier columna del conjunto de datos que haya especificado esté vinculada a una pregunta. Sin embargo, si la pregunta menciona un filtro explícito en el mismo campo, el filtro no se aplica.

   1. Cuando termine, elija **Guardar**.

      El filtro se añade a la lista de campos del tema. Puede editar su descripción o puede ajustar el momento de aplicación del filtro.

# Añadir entidades con nombre a un conjunto de datos de temas de Amazon Quick Sight
<a name="topics-data-entities"></a>

Al hacer preguntas sobre su tema, es posible que los lectores hagan referencia a varias columnas de datos sin indicar cada columna de forma explícita. Por ejemplo, podrían pedir la dirección de una transacción. Lo que realmente quieren decir es que quieren el nombre de la sucursal, el estado y la ciudad donde se realizó la transacción. Para respaldar solicitudes de este tipo, puede crear una entidad con nombre.

Una *entidad con nombre* es un conjunto de campos que se muestran juntos en una respuesta. Por ejemplo, utilizando el ejemplo de dirección de transacción, puede crear una entidad con nombre denominada `Address`. A continuación, puede agregarle las columnas `Branch Name`, `State` y `City`, que ya existen en el conjunto de datos. Cuando alguien hace una pregunta sobre una dirección, la respuesta muestra la sucursal, el estado y la ciudad donde se realizó la transacción.

**Adición de una entidad con nombre a un tema**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En **Acciones**, elija **Agregar entidad con nombre**.

1. En la página **Entidad con nombre** que se abre, haga lo siguiente:

   1. En **Conjunto de datos**, elija un conjunto de datos.

   1. En **Nombre**, escriba un nombre fácil de recordar para la entidad con nombre.

   1. En **Descripción**, introduzca una descripción de la entidad con nombre.

   1. (Opcional) En **Sinónimos**, añada cualquier nombre alternativo que crea que sus lectores podrían utilizar para referirse a la entidad con nombre o a los datos que contiene.

   1. Seleccione **Agregar campo** y, a continuación, seleccione un campo de la lista.

      Vuelva a seleccionar **Agregar campo** para añadir otro campo.

      El orden de los campos que se enumeran aquí es el orden en que aparecen en las respuestas. Para mover un campo, elija los seis puntos a la izquierda del nombre del campo y arrastre y suelte el campo en el orden que desee.

   1. Cuando termine, elija **Guardar**.

   La entidad con nombre se agrega a la lista de campos del tema. Puede agregar y editar la descripción y agregarle sinónimos para adaptarla al lenguaje natural.

# Creación de temas de Quick Sight natural-language-friendly
<a name="topics-natural-language"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Al crear un tema, Quick Sight crea, almacena y mantiene un índice con las definiciones de los datos de ese tema. Este índice se utiliza para generar respuestas correctas, proporcionar sugerencias de autocompletar cuando alguien hace una pregunta y sugerir asignaciones de términos a columnas o valores de datos. Así es como los términos clave pueden interpretarse en las preguntas de sus lectores y asignarse a sus datos. 

Para poder interpretar los datos y responder mejor a las preguntas de los lectores, proporciona la mayor cantidad de información posible sobre los conjuntos de datos y los campos asociados.

Para ello, utilice los siguientes procedimientos y amplíe sus temas. natural-language-friendly

**sugerencia**  
Puede editar varios campos a la vez mediante acciones masivas. Utilice el siguiente procedimiento para editar en bloque los campos de un tema.

**Edición en bloque de los campos de un tema**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En **Campos**, seleccione dos o más campos que quiera cambiar.

1. Seleccione **Acciones por lotes** en la parte superior de la lista.

1. En la página **Acciones por lotes** que se abre, configure los campos como desee y, a continuación, seleccione **Aplicar a**.

   Las opciones de configuración se describen en los pasos siguientes.

## Paso 1: asignación de nombres descritptivos y descripciones a los conjuntos de datos
<a name="topics-natural-language-dataset-name"></a>

Los nombres de los conjuntos de datos suelen basarse en convenciones técnicas de nomenclatura que los lectores no suelen utilizar para referirse a ellos. Le recomendamos que dé a sus conjuntos de datos nombres descriptivos y descripciones para proporcionar más información sobre los datos que contienen. Estos nombres y descripciones descriptivos se utilizan para comprender el contenido del conjunto de datos y seleccionar un conjunto de datos en función de la pregunta del lector. Los nombres de los conjuntos de datos también se muestran al lector para proporcionar un contexto adicional para la respuesta.

Por ejemplo, si el conjunto de datos tiene el nombre `D_CUST_DLY_ORD_DTL`, puede cambiarle el nombre en el tema a `Customer Daily Order Details`. De esta forma, cuando los lectores lo vean en la barra de búsqueda del tema, podrán determinar rápidamente si los datos son relevantes para ellos o no.

**Definición de un nombre descriptivo y una descripción de un conjunto de datos**

1. Abra el tema que desee cambiar.

1. En la pestaña **Resumen**, selecciona **Datos**. A continuación, en **Conjuntos de datos**, selecciona la flecha hacia abajo situada en el extremo derecho del conjunto de datos para expandirlo.

1. Elija el icono del lápiz situado junto al nombre del conjunto de datos a la izquierda y, a continuación, introduzca un nombre fácil de recorar. Recomendamos usar un nombre que sus lectores entiendan.

1. En **Descripción**, introduzca una descripción para el conjunto de datos que describa los datos que contiene.

## Paso 2: Indique cómo usar los campos de fecha en sus conjuntos de datos
<a name="topics-natural-language-dataset-time-basis"></a>

Si su conjunto de datos contiene información de fecha y hora, le recomendamos que le indique cómo usar esa información al responder a las preguntas. Esto es especialmente importante si tiene varias columnas de fecha y hora en un tema.

En algunos casos, hay varias columnas de fecha válidas en un tema, como la fecha del pedido y la fecha de envío. En estos casos, puedes ayudar a los lectores especificando una fecha predeterminada para responder a sus preguntas. Los lectores pueden elegir una fecha diferente si la fecha predeterminada no responde a su pregunta.

También puede determinar qué tan detalladas deben ser las columnas de fecha y hora especificando una base horaria. La *base temporal* de un conjunto de datos es el nivel más bajo de detalle temporal que admiten todas las medidas del conjunto de datos. Esta configuración ayuda a agregar las métricas del conjunto de datos en diferentes dimensiones de tiempo y se aplica a los conjuntos de datos que admiten una granularidad única de fecha y hora. Esta opción se puede configurar para conjuntos de datos desnormalizados con un gran número de métricas. Por ejemplo, si un conjunto de datos admite varias métricas en una agregación diaria, puede establecer la base temporal de ese conjunto de datos en **Diariamente**. A continuación, se utiliza para determinar cómo agregar las métricas.

**Establecimiento de una base de fecha y hora predeterminadas para un conjunto de datos**

1. Abra el tema que desee cambiar.

1. En la pestaña **Resumen**, selecciona **Datos**. A continuación, en **Conjuntos de datos**, selecciona la flecha hacia abajo situada en el extremo derecho del conjunto de datos para expandirlo.

1. En **Fecha predeterminada**, elija un campo de fecha.

1. En **Base temporal**, elija el nivel de granularidad más bajo al que desee agregar las métricas del conjunto de datos. Puede agregar métricas de un tema a nivel diario, semanal, mensual, trimestral o anual.

## Paso 3: exclusión de los campos no utilizados
<a name="topics-natural-language-exclude-fields"></a>

Al añadir un conjunto de datos a un tema, todas las columnas (campos) del conjunto de datos se añaden de forma predeterminada. Si su conjunto de datos contiene campos que usted o sus lectores no utilizan, o que no desea incluir en las respuestas, puede excluirlos del tema. Al excluir estos campos, se eliminan de las respuestas y del índice y se mejora la precisión de las respuestas que reciben tus lectores.

**Exclusión de campos de un tema**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, en **Incluir**, desactive el icono.

## Paso 4: Cambie el nombre de los campos para que sean natural-language-friendly
<a name="topics-natural-language-rename-fields"></a>

Los campos de un conjunto de datos suelen denominarse en función de convenciones técnicas de nomenclatura. Puede hacer que los nombres de los campos sean más fáciles de usar en sus temas cambiándoles el nombre y añadiendo descripciones. 

Los nombres de los campos se utilizan para comprender los campos y vincularlos a los términos de las preguntas de los lectores. Cuando los nombres de los campos son fáciles de usar, es más fácil establecer vínculos entre los datos y la pregunta del lector. Estos nombres descriptivos también se presentan a los lectores como parte de la respuesta a su pregunta para proporcionar un contexto adicional.

**Cambio del nombre de un campo y adición de descripciones**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, seleccione la flecha hacia abajo situada en el extremo derecho del campo para expandirlo.

1. Seleccione el icono del lápiz situado junto al nombre del campo a la izquierda y, a continuación, introduzca un nombre fácil de recordar.

1. En **Descripción**, escriba una descripción del campo.

## Paso 5: adición de sinónimos a los campos y a los valores de los campos
<a name="topics-natural-language-synonyms"></a>

Incluso si actualiza los nombres de los campos para que sean fáciles de usar y proporciona una descripción de estos, es posible que sus lectores sigan utilizando nombres diferentes para referirse a ellos. Por ejemplo, un campo `Sales` podría denominarse `revenue`, `rev` o `spending` en las preguntas del lector.

Para ayudar a entender estos términos y asignarlos a los campos correctos, puede agregar uno o más sinónimos a sus campos. De este modo, se mejora la precisión.

Al igual que ocurre con los nombres de los campos, es posible que sus lectores usen nombres diferentes para referirse a valores específicos de sus campos. Por ejemplo, si tiene un campo que contiene los valores `NW`, `SE`, `NE` y `SW`, puede agregar sinónimos para esos valores. Puede agregar `Northwest` para `NW`, `Southeast` para `SE` y así sucesivamente.

**Adición de sinónimos a un campo**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, en **Sinónimos**, elija el icono del lápiz para el campo, escriba una palabra o frase y, a continuación, pulse Intro en el teclado. Para añadir otro sinónimo, seleccione el icono **\$1**.

**Adición de sinónimos a un valor de un campo**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, seleccione la flecha hacia abajo situada en el extremo derecho para ampliar la información sobre el campo.

1. En **Vista previa de valores**, a la derecha, seleccione **Configurar sinónimos de valores**.

1. En la página **Sinónimos de valores de campo** que se abre, elija **Agregar** y, a continuación, haga lo siguiente:

   1. En **Valor**, elija el valor al que desea agregar sinónimos.

   1. En **Sinónimos**, introduzca uno o más sinónimos para el valor.

1. Seleccione **Save**.

1. Para agregar sinónimos para otro valor, repita los pasos 5 a 6.

1. Cuando haya terminado, seleccione **Listo**.

## Paso 6: Explique más sobre sus campos
<a name="topics-natural-language-semantics"></a>

Para ayudarte a interpretar cómo usar tus datos para responder a las preguntas de los lectores, puedes explicar más sobre los campos de tus conjuntos de datos. 

Puedes decir si un campo de tu conjunto de datos es una dimensión o una medida y especificar cómo se debe agregar ese campo. También puede aclarar cómo se deben formatear los valores de un campo y qué tipo de datos hay en el campo. La configuración de estos ajustes adicionales ayuda a crear respuestas precisas para los lectores cuando hacen una pregunta.

Utilice los siguientes procedimientos para obtener más información sobre sus campos.

### Asignar roles de campo
<a name="topics-natural-language-semantics-role"></a>

Cada campo del conjunto de datos es una dimensión o una medida. Las *dimensiones* son datos categóricos y las *medidas* son datos cuantitativos. Saber si un campo es una dimensión o una medida determina qué operaciones se pueden realizar y qué no se pueden realizar en un campo. 

Por ejemplo, configurar los campos `Patient ID` y `Ratings` ayuda a interpretarlos como números enteros. `Employee ID` Esta configuración significa que los campos no se agregarán a medida que se midan.

**Establecimiento del rol de un campo**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, seleccione la flecha hacia abajo situada en el extremo derecho para ampliar la información sobre el campo.

1. En **Rol**, elija un rol.

   Puede elegir una medida o una dimensión.

1. (Opcional) Si la medida es inversamente proporcional (por ejemplo, cuanto más bajo sea el número, mejor), elija **Medida invertida**.

   Esto explica cómo interpretar y mostrar los valores de este campo.

### Definir agregaciones de campos
<a name="topics-natural-language-semantics-aggregation"></a>

La configuración de las agregaciones de campos ayuda a determinar qué función debe o no debe usarse cuando esos campos se agregan en varias filas. Puede establecer una agregación predeterminada para un campo y una agregación no permitida.

Una *agregación predeterminada* es la agregación que se aplica cuando no hay ninguna función de agregación explícita mencionada o identificada en la pregunta de un lector. Por ejemplo, supongamos que uno de tus lectores pregunta: «¿Cuántos productos se vendieron ayer?» En este caso, Q usa el campo `Product ID`, que tiene una agregación predeterminada de `count distinct`, para responder a la pregunta. Al hacer esto, se obtiene una imagen que muestra el número exacto de ID de producto.

Las *agregaciones no permitidas* son agregaciones que no se pueden usar en un campo para responder a una pregunta. Se excluyen incluso si la pregunta solicita específicamente una agregación no permitida. Por ejemplo, supongamos que especifica que el campo `Product ID` nunca debe agregarse según `sum`. Incluso si uno de tus lectores pregunta: «¿Cuántos productos en total se vendieron ayer?» `sum` no se usa para responder a la pregunta.

Si las funciones de agregado se aplican incorrectamente a un campo, le recomendamos que establezca las agregaciones no permitidas para el campo.

**Definición de agregaciones de campos**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, seleccione la flecha hacia abajo situada en el extremo derecho para ampliar la información sobre el campo.

1. Para la **agregación predeterminada**, elija la agregación en la que desee agregar el campo de forma predeterminada.

   Puede agregar medidas por suma, promedio, máximo y mínimo. Puede agregar dimensiones por recuento y recuento exacto.

1. (Opcional) En el caso de **las agregaciones no permitidas**, elija una agregación que no desee utilizar.

1. (Opcional) Si no desea agregar el campo a un filtro, elija No **agregar nunca a un filtro**.

### Especificar cómo dar formato a los valores de los campos
<a name="topics-natural-language-semantics-values"></a>

Si quiere explicar cómo dar formato a los valores de sus campos, puede hacerlo. Por ejemplo, supongamos que tiene el campo `Order Sales Amount`, que contiene valores a los que desea aplicar formato en dólares estadounidenses. En este caso, puedes explicar cómo dar formato a los valores del campo como moneda estadounidense cuando se utilizan en las respuestas.

**Especificación de cómo dar formato a los valores de los campos**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, seleccione la flecha hacia abajo situada en el extremo derecho para ampliar la información sobre el campo.

1. En **Formato de valor**, elija cómo desea formatear los valores del campo.

### Especificar los tipos semánticos de los campos
<a name="topics-natural-language-semantics-types"></a>

El *tipo semántico* de un campo es el tipo de información que representan los datos de un campo. Por ejemplo, puede tener un campo que contenga datos de ubicación, datos de moneda, datos de edad o datos booleanos. Puede especificar un tipo semántico y un subtipo semántico adicional para los campos. Especificarlos ayuda a entender el significado de los datos almacenados en los campos.

Utilice el siguiente procedimiento para especificar tipos y subtipos semánticos de campo.

**Especificación de los tipos semánticos de campo**

1. Abra el tema que desee cambiar.

1. En el tema, seleccione la pestaña **Datos**.

1. En la sección **Campos**, seleccione la flecha hacia abajo situada en el extremo derecho para ampliar la información sobre el campo.

1. En **Tipo semántico**, elija el tipo de información que representan los datos.

   Para las medidas, puede seleccionar los tipos de duración, parte de fecha, ubicación, valores booleanos, moneda, porcentaje, edad, distancia e identificador. Para las dimensiones, puede seleccionar los tipos de parte de fecha, ubicación, valores booleanos, persona, organización e identificador.

1. En **Subtipo semántico**, elija una opción para especificar con más detalle el tipo de información que representan los datos.

   Aquí, las opciones dependen del tipo semántico que elija y del rol asociado al campo. Para obtener una lista de los tipos semánticos y sus subtipos asociados para las medidas y dimensiones, consulte la tabla siguiente.


| Tipo semántico | Subtipo semántico | Disponible para los siguientes casos | 
| --- | --- | --- | 
|  Antigüedad  |  | Medidas | 
|  Booleano  |  | Dimensiones y medidas | 
|  Currency (Divisa)  |  USD EUR GBP  | Medidas | 
|  Parte de fecha  |  Día Semana Mes Año Trimestre  | Dimensiones y medidas | 
|  Distancia  |  Kilómetro Medidor Yarda Pie  | Medidas | 
|  Duración  |  Segundo Minuto Hora Día  | Medidas | 
|  Identificador  |  | Dimensiones y medidas | 
|  Ubicación  |  Código postal País Estado Ciudad  | Dimensiones y medidas | 
|  Organización  |  | Dimensiones | 
|  Porcentaje  |  | Medidas | 
|  Persona  |  | Dimensiones | 

# Compartir temas de Quick Sight
<a name="topics-sharing"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Después de crear un tema, puede compartirlo con otros miembros de la organización. Al compartir un tema, los usuarios pueden seleccionarlo y hacer preguntas al respecto en la barra de búsqueda. Después de compartir un tema con los usuarios, puede asignarles permisos que especifiquen quién puede cambiar el tema.

**Uso compartido de un tema**

1. En la página de inicio rápido, selecciona **Temas** a la izquierda.

1. En la página **Temas** que se abre, abra el tema que quiera compartir.

1. En la página que se abre, seleccione **Compartir** en la esquina superior derecha.

1. En la página **Compartir tema con los usuarios** que se abre, elija el usuario o los usuarios con los que quiera compartir el tema.

   Puede utilizar la barra de búsqueda para buscar usuarios por dirección de correo electrónico.

1. Seleccione **Espectador** o **Copropietario** en la columna **Permiso** para asignar permisos a los usuarios.

   Para obtener más información sobre estos permisos, consulte la sección siguiente: [Administrar los permisos de temas de Amazon Quick Sight](topics-sharing-permissions.md).

1. Cuando haya terminado de seleccionar los usuarios, elija **Compartir**.

# Administrar los permisos de temas de Amazon Quick Sight
<a name="topics-sharing-permissions"></a>

Cuando comparte sus temas con otros miembros de su organización, es posible que desee controlar quién puede cambiarlos. Para ello, especifique qué usuarios son espectadores y cuáles son copropietarios. *Los espectadores* pueden ver el tema en la barra de búsqueda cuando seleccionan un tema de la lista, pero no pueden cambiar los datos del tema. *Los copropietarios* pueden ver el tema en la barra de búsqueda y también pueden cambiarlo.

**Asignación de permisos de tema a sus usuarios**

1. En la página de inicio rápido, selecciona **Temas**.

1. En la página de **temas** que se abre, abra el tema para el que desee administrar los permisos.

1. En la página de temas que se abre, seleccione **Compartir** en la esquina superior derecha.

1. En la página **Compartir tema con los usuarios** que se abre, seleccione **Administrar el acceso al tema**.

1. En la página **Administrar los permisos del tema** que se abre, busque el usuario para el que quiere administrar el acceso y, a continuación, seleccione **Permiso** y elija una de las siguientes opciones:
   + Para permitir que un usuario vea y cambie el tema, seleccione **Copropietario**.
   + Para permitir que un usuario vea solo el tema, seleccione **Espectador**.

# Revisión del rendimiento y los comentarios de los temas de Quick Sight
<a name="topics-performance"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Después de crear un tema y compartirlo con sus usuarios, puede revisar el rendimiento de ese tema. Cuando alguien usa tu tema para hacer una pregunta o proporciona comentarios sobre qué tan acertada ha sido la respuesta, se registra en las pestañas **Resumen** y **Actividad del usuario** del tema.

En la pestaña **Resumen** del tema, puede ver los datos históricos del número de preguntas formuladas a lo largo del tiempo, en periodos que van desde siete días hasta un año. También puede ver una distribución de las preguntas que recibieron comentarios positivos, negativos o nulos, y también de las preguntas que no se pudieron responder.

En la pestaña **Actividad del usuario**, puede ver una lista de las preguntas que han hecho los usuarios y de las valoraciones y comentarios positivos o negativos que han dejado.

Revisar esta información puede ayudarle a determinar si su tema satisface las necesidades de sus usuarios. Por ejemplo, supongamos que tiene un tema que recibe una gran cantidad de comentarios negativos de sus usuarios. Cuando revisas la actividad de tus usuarios, observas que varios usuarios están dejando comentarios sobre una pregunta y muestran datos incorrectos. En la respuesta, puede examinar las preguntas que hicieron y observará que usaban un término que no esperaba. Decide añadir ese término como sinónimo al campo correcto del tema. Con el tiempo, observará un aumento en los comentarios positivos.

## Revisar el rendimiento de un tema
<a name="topics-performance-statistics"></a>

Utilice el siguiente procedimiento para ver el rendimiento de un tema.

**Visualización del rendimiento de un tema**

1. En la página de inicio rápido, selecciona **Temas** a la izquierda.

1. En la página **Temas** que se abre, abra el tema que quiera revisar.

   Se abre el tema y la sección **Estadísticas** muestra las estadísticas del tema.

1. (Opcional) Para cambiar la cantidad de datos históricos que se muestran en el gráfico, elija una de las siguientes opciones: **7 días**, **30 días**, **90 días**, **120 días** o **12 meses**.

1. (Opcional) Para eliminar de los datos las preguntas que no se pudieron responder, desactive **Incluir datos sin respuesta**.

1. (Opcional) Para eliminar de los datos las preguntas que no recibieron comentarios, desactive **Incluir datos sin comentarios**.

## Revisar las preguntas y comentarios sobre un tema
<a name="topics-performance-user-activity"></a>

Utilice los siguientes procedimientos para revisar las preguntas y comentarios de un tema.

**Revisión de las preguntas y comentarios sobre un tema**

1. En la página de inicio rápido, elija **Temas**.

1. En la página **Temas** que se abre, abra el tema sobre el que desea revisar los comentarios.

1. En la página del tema que se abre, seleccione la pestaña **Actividad del usuario**.

   Se muestra la actividad del usuario para el tema. En la parte superior, puede ver el número total de preguntas formuladas y el número de preguntas que se pudieron responder y que no se pudieron responder. También puede ver el porcentaje de preguntas que recibieron una calificación positiva y negativa. Además, puede ver el porcentaje de preguntas que se desambiguaron. Esto significa que alguien escribió una pregunta y asignó una de las palabras de la pregunta a un campo del tema.

   Puede elegir cualquiera de estas estadísticas para filtrar la lista de preguntas.

1. (Opcional) Para ver un comentario dejado por un usuario en una pregunta, seleccione la flecha hacia abajo situada a la derecha de la pregunta.

   El comentario se muestra a la izquierda.

1. (Opcional) Para ver los campos utilizados para responder a una pregunta, seleccione la flecha hacia abajo situada a la derecha de la pregunta.

   Los campos utilizados se muestran a la derecha. Elija un nombre de campo para editar sus metadatos.

1. (Opcional) Para ver una pregunta desambiguada, selecciona la flecha hacia abajo situada a la derecha de una pregunta con un término resaltado en rojo. 

   Se muestra una descripción del término y el campo que se utilizó para desambiguarlo. Para agregar sinónimos al campo, seleccione **Agregar sinónimos**.

1. (Opcional) Para ver cómo se respondió a una pregunta, selecciona **Ver** junto a la pregunta de la lista.

1. (Opcional) Para filtrar la lista de preguntas, seleccione **Filtrar por** a la derecha y, a continuación, filtre por una de las siguientes opciones.
   + **Ver todas las preguntas**: esta opción elimina todos los filtros y muestra todas las preguntas que ha recibido un tema.
   + **Con respuesta**: esta opción filtra la lista de preguntas para incluir las que se pudieron responder. Las preguntas con respuesta son preguntas a las que Q pudo responder.
   + **Sin respuesta**: esta opción filtra la lista de preguntas para incluir las que no se pudieron responder. Las preguntas sin respuesta son preguntas a las que Q no pudo responder.
   + **Desambiguadas**: esta opción filtra la lista de preguntas para incluir las que se desambiguaron, es decir, preguntas con términos a los que los usuarios asignaron manualmente un campo.
   + **Sin comentarios**: esta opción filtra la lista de preguntas para incluir las que no recibieron comentarios.
   + **Negativas**: esta opción filtra la lista de preguntas para incluir las que recibieron comentarios negativos.
   + **Positivas**: esta opción filtra la lista de preguntas para incluir las que recibieron comentarios positivos.
   + **Sin comentarios**: esta opción filtra la lista de preguntas para incluir aquellas que no recibieron comentarios de los usuarios.
   + **Tiene comentarios**: esta opción filtra la lista de preguntas para incluir las que recibieron comentarios de los usuarios.
   + **Usuario**: esta opción filtra la lista de preguntas para incluir las que formuló un usuario con un nombre de usuario específico que usted introduzca.

# Actualización de los índices de temas de Quick Sight
<a name="topics-index"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: administradores y autores de Amazon Quick  | 

Al crear un tema, Quick Sight crea, almacena y mantiene un índice con las definiciones de los datos de ese tema. Este índice no está expuesto a los autores de Quick Sight. Tampoco es una copia de los conjuntos de datos incluidos en un tema. Las métricas no están indexadas. Por ejemplo, las medidas almacenadas como números enteros no se indexan.

El índice de tema es un índice de valores de cadena únicos para los campos incluidos en un tema. Este índice se utiliza para generar respuestas correctas, proporcionar sugerencias de autocompletar cuando alguien hace una pregunta y sugerir asignaciones de términos a columnas o valores de datos.

Para actualizar el índice de un tema, actualice los conjuntos de datos del tema. Puede actualizar manualmente todos los conjuntos de datos de un tema o actualizar un conjunto de datos individual. También puede ver el historial de actualizaciones del conjunto de datos para supervisar las actualizaciones anteriores y establecer una programación de actualizaciones periódicas para cada conjunto de datos del tema. En el conjunto de datos de SPICE, puede sincronizar la programación de actualización del índice de temas con la programación de actualización de SPICE. Para obtener más información sobre cómo configurar las programaciones de actualización de SPICE, consulte [Actualización de un conjunto de datos en una programación](refreshing-imported-data.md#schedule-data-refresh).

**nota**  
Actualmente, no se admiten los programas de actualización por hora. Puedes establecer un programa de actualización para actualizar los conjuntos de datos de un tema hasta una vez al día.

Le recomendamos que actualice los índices de temas con regularidad para garantizar que se registren las definiciones y los valores más recientes. La actualización de un índice de tema tarda aproximadamente de 15 a 30 minutos, según la cantidad y el tamaño de los conjuntos de datos incluidos en el tema.

**Actualización de un índice de tema**

1. En la página de inicio rápido, selecciona **Temas**.

1. En la página **Temas** que se abre, abra el tema que quiera actualizar.

   El tema se abre en la pestaña **Resumen**, que muestra los conjuntos de datos que se incluyen en el tema en la parte inferior de la página. También muestra cuándo fue la última vez que se actualizó el tema en la esquina superior derecha.

1. Elija **Actualizado** en la esquina superior derecha para actualizar el índice del tema y, a continuación, elija **Actualizar datos**. Al hacerlo, se actualizan manualmente todos los conjuntos de datos del tema.

   Para obtener más información sobre la actualización de conjuntos de datos individuales en un tema, consulte [Actualización de conjuntos de datos en un tema de vista rápida](topics-data-refresh.md).

# Trabaje con temas de Quick Sight con Amazon Quick Sight APIs
<a name="topics-cli"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Utilice esta sección para aprender a trabajar con los temas de Quick Sight mediante la interfaz de línea de comandos (CLI) de Amazon Quick Sight.

**Requisitos previos**

Antes de empezar, asegúrese de tener una función AWS Identity and Access Management (IAM) que conceda al usuario de CLI acceso para llamar a las operaciones de la API Quick Sight. En la siguiente tabla, se muestran los permisos que se deben añadir a la política de IAM para utilizar operaciones de API específicas. Para utilizar todas las operaciones de la API del tema, añada todos los permisos que aparecen en la tabla.


| Operación de la API | Política de 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`  | 

En el siguiente ejemplo, se muestra una política de IAM que permite al usuario usar la operación `ListTopics` de la API.

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

****  

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

------

Después de configurar los permisos para crear temas de Quick Sight con Quick Sight APIs, utilice los siguientes temas para crear y trabajar con el tema Quick Sight APIs.

**Topics**
+ [Trabaje con los temas de Quick Sight mediante Quick Sight APIs](topic-cli-examples.md)
+ [Configure los programas de actualización de temas de Quick Sight con la CLI de Quick Sight](topic-refresh-apis.md)
+ [Copie y migre temas de Quick Sight dentro y entre Cuentas de AWS](topic-cli-walkthroughs.md)
+ [Cree y modifique las respuestas revisadas en los temas de Vista rápida con Vista rápida APIs](topic-reviewed-answer-apis.md)

# Trabaje con los temas de Quick Sight mediante Quick Sight APIs
<a name="topic-cli-examples"></a>

El siguiente ejemplo crea un tema nuevo.

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

También puede crear un tema nuevo mediante un archivo básico de CLI con el siguiente comando. Para obtener más información sobre los archivos de esqueleto de CLI, consulte [Uso de archivos de esqueleto de CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) en la *Guía para desarrolladores de Amazon Quick Sight*.

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

Al crear un tema nuevo, la configuración de actualización del conjunto de datos no se copia en el tema. Para establecer una programación de actualización del tema para su nuevo tema, puede realizar una llamada a la API `create-topic-refresh-schedule`. Para obtener más información acerca de la configuración de las programaciones de actualización de temas con la CLI, consulte [Configure los programas de actualización de temas de Quick Sight con la CLI de Quick Sight](topic-refresh-apis.md).

Después de crear el primer tema, puedes actualizarlo, eliminarlo, incluirlo en una lista o solicitar un resumen del tema.

En el siguiente ejemplo, se actualiza un tema.

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

También puede actualizar un tema mediante un archivo básico de CLI con el siguiente comando. Para obtener más información sobre los archivos de esqueleto de CLI, consulte [Uso de archivos de esqueleto de CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) en la *Guía para desarrolladores de Amazon Quick Sight*.

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

El siguiente ejemplo proporciona una lista de todos los temas de una cuenta Quick.

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

En el siguiente ejemplo, se elimina un tema.

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

El siguiente ejemplo proporciona información sobre cómo se configuró un tema.

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

El siguiente comando actualiza los permisos de un tema.

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

Utilice el `grant-permissions` parámetro para conceder permisos de lectura y autor a los usuarios de la cuenta Quick. Para conceder permisos de lectura a un usuario de cuenta, introduzca el siguiente valor: `"quicksight:DescribeTopic"`. Para conceder permisos a un usuario de cuenta, introduzca los siguientes valores:
+ `"quicksight:DescribeTopic"`
+ `"quicksight:DescribeTopicRefresh"`
+ `"quicksight:ListTopicRefreshSchedules"`
+ `"quicksight:DescribeTopicRefreshSchedule"`
+ `"quicksight:DeleteTopic"`
+ `"quicksight:UpdateTopic"`
+ `"quicksight:CreateTopicRefreshSchedule"`
+ `"quicksight:DeleteTopicRefreshSchedule"`
+ `"quicksight:UpdateTopicRefreshSchedule"`
+ `"quicksight:DescribeTopicPermissions"`
+ `"quicksight:UpdateTopicPermissions"`

El parámetro `RevokePermissions` revoca todos los permisos concedidos a un usuario de cuenta.

El siguiente comando describe todos los permisos de un tema.

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

Después de crear un tema de Quick Sight, puede usar Amazon Quick Sight APIs para [configurar un programa de actualización de temas](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-refresh-apis), [migrar temas de Quick Sight dentro de las cuentas o entre](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-cli-walkthroughs) ellas y [crear respuestas revisadas](https://docs.aws.amazon.com/quicksuite/latest/userguide/topic-reviewed-answer-apis).

# Configure los programas de actualización de temas de Quick Sight con la CLI de Quick Sight
<a name="topic-refresh-apis"></a>

El siguiente comando crea un programa de actualización de un tema.

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

Tras crear un programa de actualización para un tema, puede actualizar, eliminar, enumerar o solicitar un resumen del programa de actualización del tema.

El siguiente comando actualiza el programa de actualización de un tema.

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

El siguiente ejemplo proporciona una lista de todos los programas de actualización configurados para un tema.

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

En el siguiente ejemplo, se elimina una programación de actualización de un tema.

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

En el siguiente ejemplo, se proporciona información sobre cómo se configuró una programación de actualización de un tema.

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

# Copie y migre temas de Quick Sight dentro y entre Cuentas de AWS
<a name="topic-cli-walkthroughs"></a>

Puede migrar los temas de Quick Sight de una cuenta a otra con la interfaz de línea de comandos (CLI) de Quick Sight. En lugar de replicar manualmente el mismo tema en varios paneles, espacios de nombres o cuentas, puede usar la CLI de Quick Sight para reutilizar el mismo tema repetidamente. Esta función ahorra tiempo a los autores de Quick Sight y crea una experiencia temática estandarizada para los lectores de varios paneles.

Para migrar temas con la CLI de Quick Sight, utilice el siguiente procedimiento

**Para migrar un tema a otra cuenta**

1. En primer lugar, identifique el tema que desea migrar. Puedes ver una lista de todos los temas de tu cuenta Quick con un comando de `list-topics` API.

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

1. Cuando tengas una lista de temas, busca el tema que deseas migrar y realiza una `describe-topic` llamada para recibir una estructura JSON de la configuración del tema.

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

   A continuación se muestra un ejemplo de una respuesta de la API `describe-topic`.

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

1. Usa la respuesta JSON para crear un archivo básico que puedas introducir en una nueva `create-topic` llamada en tu otra cuenta de Quick. Antes de realizar una llamada a la API con tu archivo básico, asegúrate de cambiar el Cuenta de AWS ID y el ID del conjunto de datos del archivo básico para que coincidan con el Cuenta de AWS ID y el ID del conjunto de datos a los que vas a añadir el nuevo tema. Para obtener más información sobre los archivos de esqueleto de CLI, consulte [Uso de archivos de esqueleto de CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) en la *Guía para desarrolladores de Amazon Quick Sight*.

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

Tras realizar una `create-topic` llamada a la API Quick Sight, el nuevo tema aparecerá en su cuenta. Para confirmar que el tema nuevo existe, realiza una `list-topics` llamada a la API Quick Sight. Si el tema de origen que se duplicó contiene respuestas verificadas, las respuestas no se migran al tema nuevo. Para ver una lista de todas las respuestas verificadas que están configuradas para el tema original, use una llamada a la API `describe-topic`.

# Cree y modifique las respuestas revisadas en los temas de Vista rápida con Vista rápida APIs
<a name="topic-reviewed-answer-apis"></a>

Tras crear un tema de vista rápida, puede utilizarla APIs para crear, enumerar, actualizar y eliminar las respuestas revisadas de los temas.

El siguiente comando por lotes crea hasta 100 respuestas revisadas para un tema de vista rápida.

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

También puede crear respuestas revisadas a partir de un archivo de esqueleto de la CLI con el siguiente comando. Para obtener más información sobre los archivos de esqueleto de CLI, consulte [Uso de archivos de esqueleto de CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) en la *Guía para desarrolladores de Amazon Quick Sight*.

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

El siguiente comando muestra todas las respuestas revisadas en un tema de Quick Sight.

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

El siguiente ejemplo elimina por lotes hasta 100 respuestas revisadas de un tema.

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

También puede crear por lotes respuestas revisadas del tema a partir de un archivo de esqueleto de la CLI con el siguiente comando. Para obtener más información sobre los archivos de esqueleto de CLI, consulte [Uso de archivos de esqueleto de CLI](https://docs.aws.amazon.com/quicksight/latest/developerguide/cli-skeletons.html) en la *Guía para desarrolladores de Amazon Quick Sight*.

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

Para actualizar una respuesta revisada, elimine la respuesta existente del tema con la API de `batch-delete-topic-reviewed-answer`. Luego, use la API de `batch-create-topic-reviewed-answer` para agregar la respuesta revisada actualizada al tema.

# Trabajar con historias de datos en Amazon Quick Sight
<a name="working-with-stories"></a>

Con la inteligencia empresarial generativa con Quick Sight, los autores y los lectores pueden generar rápidamente un primer borrador de su historia de datos. Utilice indicaciones y elementos visuales para crear un borrador que incorpore los detalles que usted proporcione. Los borradores de historias de datos no pretenden reemplazar sus propias ideas ni realizar análisis. Las historias de datos son más bien un punto de partida que podrá personalizar y ampliar según sea necesario. Las recomendaciones y sugerencias contextuales combinan su mensaje con imágenes seleccionadas para proporcionar detalles relevantes que se adapten a su historia de datos. Para obtener más información acerca de este tema, consulte [BI generativa con Quick Sight](quicksight-gen-bi.md).

Utilice los siguientes temas para crear, modificar y compartir una historia de datos.

**Topics**
+ [Creación de una historia de datos con BI generativa](working-with-stories-create.md)
+ [Personalice las historias de datos en Amazon Quick Sight](working-with-stories-personalize.md)
+ [Visualización de una historia de datos generada en Amazon Quick Sight](working-with-stories-view.md)
+ [Edición de una historia de datos generada en Amazon Quick Sight](working-with-stories-edit.md)
+ [Añadir temas y animaciones a una historia de datos en Amazon Quick Sight](working-with-stories-themes.md)
+ [Compartir una historia de datos en Amazon Quick Sight](working-with-stories-share.md)

# Creación de una historia de datos con BI generativa
<a name="working-with-stories-create"></a>

Utilice el siguiente procedimiento para crear una historia de datos con el BI generativo.

**Creación de una historia de datos**

1. Abra la [consola rápida.](https://quicksight.aws.amazon.com/)

1. A la izquierda, selecciona **Historias**.

1. En la página **de historias de datos**, selecciona **Nueva historia de datos**.

1. En la pantalla **Historia** que aparece, navegue hasta el modal **Crear historia** e introduzca el mensaje de historia de datos que desee generar. Para obtener los mejores resultados, no redacte la petición como si fuera una pregunta. En su lugar, escriba la historia de datos que desee que cree Quick Sight. Por ejemplo, supongamos que desea crear una historia de datos sobre los procedimientos médicos que se realizan con más frecuencia por región. Una buena petición para este caso de uso sería “Cree una historia de datos sobre los procedimientos más habituales que realizan los médicos en diversas regiones. Muestra, además, las especialidades con mayor número de ingresos de pacientes. Recomiende dónde necesitemos más médicos por especialidad e incluya al menos cuatro puntos de datos de soporte”.

   Si lo desea, puede omitir este paso y crear manualmente su historia de datos. Si opta por no ingresar ninguna petición, deberá agregar un elemento visual a la historia de datos.

1. En **Seleccionar imágenes**, elija **Agregar**.

1. Elija el panel que contiene los elementos visuales que desee usar y, a continuación, elija los elementos visuales que desee. Puede agregar hasta 20 elementos visuales a una historia de datos.

   Si no puede ver el panel que quiere usar, use la barra de búsqueda **Encuentre los paneles** en la parte superior del modal.

   Puede elegir elementos visuales de cualquier número de paneles para los que tenga permisos de uso compartido. Los elementos visuales que muestran la insignia **Restringido** tienen permisos que impiden que se agreguen a una historia de datos. Los elementos visuales pueden estar restringidos por las razones siguientes:
   + El conjunto de datos está conectado a un origen de datos que usa la propagación de identidades de confianza con Amazon Redshift.
   + El conjunto de datos se encuentra dentro de una carpeta restringida.

1. (Opcional) Use la sección **Seleccionar documentos** para cargar hasta 5 documentos para usarlos en la historia basada en datos. Cada documento no puede superar los 10 MB. Estos documentos solo se utilizan para generar la historia de datos y no se almacenan en Quick Sight. La siguiente imagen muestra la sección **Seleccionar documentos** de la pantalla **Crear una historia**.

1. (Opcional) Si tu cuenta Quick está conectada a una aplicación de Amazon Q Business, marca la casilla **Usar información de Amazon Q Business** para ampliar tu historia de datos con fuentes de datos no estructuradas de Amazon Q Business. Para obtener más información sobre cómo conectar una cuenta Quick a una aplicación de Amazon Q Business, consulte[Cómo aumentar los conocimientos de Amazon Quick Sight con Amazon Q Business](generative-bi-q-business.md).

1. Elija **Compilar**.

Una vez generada la historia de datos, revísela y elija una de las siguientes opciones:
+ **Conservar**: guarda el contenido generado en el lienzo. Si elige esta opción, se cierra el modal **Crear historia** y puede empezar a editar la historia de datos.
+ **Intentar de nuevo**: permite a los usuarios editar la petición y generar una nueva historia de datos.
+ **Descartar**: elimina la historia de datos generada.

# Personalice las historias de datos en Amazon Quick Sight
<a name="working-with-stories-personalize"></a>

La ubicación del usuario y la información relacionada con el trabajo de su instancia del IAM Identity Center se utilizan para generar historias de datos personalizadas que sean más relevantes para los autores y los lectores. Por ejemplo, cuando un autor de EE. UU. publica el mensaje «Elabore una estrategia empresarial que se centre en un plan sobre cómo aumentar los ingresos en mi localidad», la descripción de la historia de datos incluye automáticamente información relacionada con los EE. UU. en la descripción de la historia de datos. Si el autor quiere que la historia de datos se centre en otro país, como Canadá, puede especificarlo en la petición.

Para que la personalización funcione, debes añadir el país y el cargo de los usuarios de la instancia del Centro de Identidad de IAM conectada a tu cuenta de Quick. Para obtener más información, consulte [Add users to your IAM Identity Center directory](https://docs.aws.amazon.com/singlesignon/latest/userguide/addusers.html) en la Guía del usuario de IAM Identity Center.

Los datos de usuario de su instancia del IAM Identity Center están conectados al entorno de su aplicación de forma predeterminada. Esto significa que todas las historias de datos están personalizadas de forma predeterminada. Puede [optar por no participar en la personalización](https://docs.aws.amazon.com/quicksuite/latest/userguide/qs-q-manage-personalization) en cualquier momento en el menú de configuración de la cuenta de la consola de QuickSight administración.

**nota**  
La personalización de las historias de datos está disponible actualmente en las AWS regiones EE.UU. Este (Norte de Virginia) y EE.UU. Oeste (Oregón).

# Visualización de una historia de datos generada en Amazon Quick Sight
<a name="working-with-stories-view"></a>

Después de generar y conservar una historia de datos, puede acceder a dicha historia de datos desde la página **Historias de datos**. Para ver una historia de datos, elija la historia de datos que desee ver para abrir el editor de historias.

Al crear y modificar una historia de datos, puede obtener una vista previa de la historia de datos para ver cómo se muestra a los lectores. Para obtener una vista previa de una historia de datos generada, seleccione el icono **Vista previa** situado en la parte superior de la página. Para salir de la vista previa, seleccione **VOLVER AL EDITOR**.

# Edición de una historia de datos generada en Amazon Quick Sight
<a name="working-with-stories-edit"></a>

Después de crear y conservar una historia de datos, podrá modificar su contenido para adaptarla mejor a sus necesidades. Puede asignar formato al texto de una historia de datos, agregar imágenes, editar elementos visuales y agregar nuevos bloques.

Las historias se componen de diferentes *bloques* que actúan como contenedores para el texto, los elementos visuales y las imágenes que desee incluir en su historia de datos. Cada bloque se puede formatear de forma independiente del resto de bloques de la historia de datos, de forma similar a las secciones de un informe con píxeles perfectos.

Para asignar formato al texto de una historia de datos, use la barra de herramientas situada en la parte superior de la página. La barra de herramientas ofrece ajustes de fuente que permiten personalizar el tipo de fuente, el estilo, el color, el tamaño, el espaciado, el resaltado del texto y la alineación. También puede usar la barra de herramientas para agregar columnas a un bloque de historias de datos.

Use una de las siguientes opciones para agregar un elemento visual a una historia de datos.
+ Utilice el panel **Elementos visuales** para arrastrar y soltar un elemento visual en una historia de datos. En el panel **Elementos visuales** solo se muestran los elementos visuales que eligió al generar la historia de datos.

  También puede seleccionar el icono **Agregar** (\$1) en el panel **Elementos visuales** para agregar nuevos elementos visuales que se pueden arrastrar y soltar en la historia de datos. Cada historia de datos puede contener hasta 20 elementos visuales.
+ Elija el bloque de historia de datos al que desea agregar una imagen. Cuando aparezca un cursor, introduzca una barra inclinada (`"/"`) para insertar una imagen o un elemento visual en ese bloque de historias de datos.

Para editar un elemento visual de una historia de datos, elija el elemento visual que desee cambiar y, a continuación, elija el icono **Propiedades**. En el panel de propiedades que aparecerá, se pueden realizar las siguientes acciones:
+ Cambiar, ocultar o mostrar el título del elemento visual. De forma predeterminada se muestra el título del elemento visual.
+ Cambiar, ocultar o mostrar el subtítulo del elemento visual. De forma predeterminada, el subtítulo del elemento visual está oculto.
+ Ocultar o mostrar las etiquetas de datos. De forma predeterminada, las etiquetas de datos están ocultas.
+ Ocultar, mostrar o cambiar la posición de la leyenda. De forma predeterminada, la leyenda está oculta.

Para agregar un bloque nuevo a una historia de datos, elija el icono con el signo más (\$1) de la parte inferior de cualquier bloque existente. A continuación, elija la opción de diseño que desee. También puede mover, duplicar o eliminar un bloque desde el icono **Opciones de bloque** (tres puntos) situado en la parte superior de cada bloque.

Para cambiar el diseño de los elementos de un bloque, puede arrastrarlos y soltarlos donde desee con el icono de seis puntos situado junto a cada elemento.

# Añadir temas y animaciones a una historia de datos en Amazon Quick Sight
<a name="working-with-stories-themes"></a>

Puede agregar temas y animaciones a las historias que genere. Para agregar un tema o una animación a una historia de datos, elija el icono **Estilo de historia**.

En el panel **Estilo de historia** que aparecerá, podrá realizar las siguientes acciones:
+ En **TEMAS**, elija el tema que considere que mejor se adapta a su historia de datos.
+ En **ANIMACIONES**, elija un estilo y una velocidad de animación. Para los tipos de animación, puede elegir las opciones **Ninguna**, **Desvanecer** o **Diapositiva**. La animación por defecto es **Ninguna**. En **Velocidad**, elija **Lenta**, **Media** o **Rápida**. La velocidad predeterminada es **Media**.

# Compartir una historia de datos en Amazon Quick Sight
<a name="working-with-stories-share"></a>

Utilice el siguiente procedimiento para compartir una historia de datos.

**Uso compartido de una historia de datos**

1. En el editor de historia de la historia de datos que desee compartir, seleccione el icono **Compartir**, que se encuentra en la parte superior derecha.

   Como alternativa, puede elegir el icono **Compartir** de la parte superior de la vista previa de una historia de datos.

1. En el modal **Compartir historia de datos** que aparecerá, especifique los usuarios o grupos con los que desee compartir la historia de datos.

1. (Opcional) Para guardar un enlace de la historia de datos publicada en el portapapeles, seleccione **Copiar enlace**.

1. Seleccione **Publicar y compartir**.

Si intenta compartir una historia y recibe un mensaje en el que se indica que la historia no se puede compartir, póngase en contacto con el propietario del panel y pídale que active la opción **Permitir el uso compartido de las historias de datos**. Para obtener más información sobre esta opción, consulte [Tutorial: Crear un panel de Amazon Quick Sight](example-create-a-dashboard.md).

Si intentas compartir una historia de datos y recibes un mensaje de error, ponte en contacto con el propietario del panel o con el administrador de tu cuenta de Quick para obtener ayuda.

Después de compartir una historia de datos, los usuarios con los que se ha compartido la historia recibirán un correo electrónico de notificación con un enlace a la historia. Puedes acceder a la historia de datos desde la página de **historias de datos** de sus cuentas de Quick. También puede compartir el enlace copiado a la historia de datos con los usuarios que puedan acceder a la historia de datos.

No podrá compartir una historia de datos que contenga datos restringidos. Si intenta compartir una historia que contiene datos restringidos, aparecerá un mensaje de error con una lista de todos los elementos visuales restringidos que forman parte de la historia. Si lo desea, elimine los elementos visuales restringidos de su historia de datos antes de compartirla con los usuarios.

Cuando edite una historia de datos publicada, vuelva a publicarla para que los cambios se propaguen a sus usuarios finales.

# Trabajar con escenarios en Amazon Quick Sight
<a name="scenarios"></a>

Los usuarios rápidos con funciones de Admin Pro, Author Pro o Reader Pro pueden utilizar escenarios para analizar problemas empresariales complejos con un lenguaje natural y sencillo.

Para empezar con los escenarios, un usuario de Quick describe un problema que quiere resolver y añade datos relevantes de Quick Sight o de su ordenador para utilizarlos en el análisis de datos. Como alternativa, los usuarios pueden dejar que Amazon Q busque todos los datos relevantes que puedan usarse para resolver el problema. Amazon Q devuelve una serie de análisis o peticiones para profundizar en los datos. Los usuarios también pueden ingresar sus propias peticiones para crear un análisis personalizado. Después de recibir una nueva petición, Amazon Q divide el análisis en pasos y los ejecuta. Los resultados incluyen información sobre datos específicos, elementos visuales interactivos y un análisis de lo que los resultado podrían significar para la empresa, junto con sugerencias sobre las próximas acciones.

Los escenarios pueden ayudar a los usuarios de Quick Pro a realizar las siguientes tareas:
+ Automatización de tareas de datos manuales tediosas, propensas a errores e ineficientes
+ Modificación, ampliación o reutilización de análisis anteriores para adaptarse rápidamente a cambios empresariales
+ Profundización en datos más allá de lo que permiten las hojas de cálculo

Utilice los siguientes temas para crear escenarios y trabajar con ellos en Amazon Quick Sight.

**Topics**
+ [Consideraciones para los escenarios de Quick Sight](#scenarios-considerations)
+ [Creación de un escenario de Amazon Quick Sight](scenarios-create.md)
+ [Trabajar con hilos en un escenario de Amazon Quick Sight](scenarios-threads.md)
+ [Trabajar con datos en un escenario de Amazon Quick Sight](scenarios-data.md)

## Consideraciones para los escenarios de Quick Sight
<a name="scenarios-considerations"></a>

Las siguientes consideraciones se aplican a los escenarios de Amazon Quick Sight.
+ Los escenarios de Amazon Quick Sight están disponibles para los usuarios que tengan funciones de Admin Pro, Author Pro o Reader Pro en Amazon Quick. Para obtener información sobre cómo actualizar un usuario a un rol de Quick Pro, consulte[Introducción a la BI generativa](generative-bi-get-started.md).
+ Los escenarios están disponibles de forma específica y Regiones de AWS se enumeran en[Regiones de AWS Compatible con Amazon Q en Quick](regions.md#regions-aqs).

Tras revisar las consideraciones sobre los escenarios de Quick Sight, consulte [Creación de un escenario de Amazon Quick Sight](scenarios-create.md) para empezar con los escenarios de Amazon Quick Sight.

# Creación de un escenario de Amazon Quick Sight
<a name="scenarios-create"></a>

Los usuarios de Amazon Quick Pro pueden crear escenarios desde los paneles de Quick Sight o desde la sección **Escenarios** de la página de inicio de Quick Sight. Los usuarios pueden crear tantos escenarios como necesiten. Cada usuario puede tener hasta 3 escenarios activos a la vez. Cada cuenta de Quick Sight admite hasta 10 escenarios activos a la vez. Utilice el siguiente procedimiento para crear un escenario en Amazon Quick Sight.

**Creación de un escenario nuevo**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Lleve a cabo una de las siguientes acciones:

   1. Abra cualquier panel y busque una de las siguientes opciones:
      + Elija **Analizar este panel en un escenario**, si está disponible, en la parte superior del panel.
      + Desde una imagen del panel de control, abre el menú desplegable y selecciona **Explorar el escenario**.
      + Elija **Crear** y, a continuación, **Escenario**.

   1. En la página de inicio rápido, elija **Escenarios**. En los **escenarios**, elija **Nuevo escenario**.

1. Aparece el nuevo escenario. En el cuadro de texto, describa el problema que desea resolver. Esta entrada es el punto de partida de todos los cambios y manipulaciones de datos que se producirán en el escenario. La descripción que proporcione puede ser tan amplia o específica como desee, por ejemplo, «analizar las tendencias de uso» o «calcular month-over-month y year-over-year cambiar el uso en función de los datos del mes pasado».

1. Agregue los datos que desee utilizar en el escenario. Puede elegir los datos de los paneles de Quick Sight o puede cargar archivos desde su ordenador. Al elegir datos de un panel de control, se genera una vista previa de los datos seleccionados para que los revise. Para obtener más información sobre la vista previa y la edición de datos en escenarios de Quick Sight, consulte. [Trabajar con datos en un escenario de Amazon Quick Sight](scenarios-data.md)

   Los siguientes límites se aplican a los datos que se utilizan en un escenario:
   + Puede agregar hasta 10 orígenes de datos a un escenario.
   + Se pueden seleccionar hasta 20 elementos visuales de un panel de control a la vez.
   + El formato de los archivos cargados debe ser `.xlsx` o `.csv` y no puede superar 1 GB.
   + Los orígenes de datos pueden tener hasta 200 columnas.

   Si no añades datos al escenario, Amazon Q busca automáticamente en los paneles de Quick Sight los datos relacionados con el planteamiento del problema del paso anterior.

1. Selecciona **Iniciar análisis**.

Al iniciar un análisis en un escenario de Quick Sight, Quick Sight prepara los datos para el análisis y devuelve un *hilo* nuevo. El hilo contiene peticiones generadas que se pueden utilizar para resolver el problema que ha descrito en el escenario. Un hilo es una conversación contextual por turnos que consiste en peticiones de usuario y respuestas de Amazon Q que puede usar para profundizar en un escenario específico. Puede usar hilos para escribir peticiones que supongan que Amazon Q recuerda lo que se discutió anteriormente en el hilo. Puede elegir una petición para continuar el hilo o puede elegir el signo más (\$1) situado encima del hilo para iniciar uno nuevo. El nuevo hilo utiliza una petición diferente al del primer hilo que creó. Para obtener más información acerca de cómo usar los hilos, consulte [Trabajar con hilos en un escenario de Amazon Quick Sight](scenarios-threads.md).

# Trabajar con hilos en un escenario de Amazon Quick Sight
<a name="scenarios-threads"></a>

Tras crear un escenario en Quick Sight, los datos que genera Amazon Q se presentan en *hilos* y *bloques*. Un hilo es una cadena vertical de peticiones y respuestas. Un bloque es un par único de petición y respuesta. Cada hilo puede contener hasta 15 bloques y cada escenario puede contener hasta 50 bloques en total en varios hilos.

Cuando se crea un hilo nuevo, aparece una lista de peticiones generadas por Amazon Q dentro de un nuevo bloque. Cuando elige una de las peticiones en la que profundizar, Amazon Q analiza los datos pertinentes para la petición elegida y devuelve un resumen de todos los resultados, pronósticos y conclusiones que se pueden extraer del análisis.

Para continuar con el hilo y profundizar en la petición, elija el signo más (**\$1**) situado debajo del bloque para crear un nuevo bloque que contenga una nueva lista de peticiones generadas que tengan en cuenta los resultados del bloque anterior. Para iniciar un hilo nuevo que analice un aspecto diferente de los datos, elija el signo más (**\$1**) situado encima de cualquier bloque del escenario para crear un hilo nuevo. 

Los bloques se pueden contraer, duplicar o eliminar de un escenario, siempre que el bloque que desee cambiar haya terminado de cargarse. Siga estos procedimientos para hacer cambios en el bloque de un escenario.

**Cómo contraer, duplicar o eliminar un bloque**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Elija **Escenarios** en el panel de opciones y, a continuación, seleccione el escenario que desea cambiar.

1. Vaya al bloque que desea cambiar y elija los puntos suspensivos (…) situados en la parte superior derecha del bloque.

1. Lleve a cabo una de las siguientes acciones:
   + Para contraer el bloque, elija **Contraer**. Para expandir un bloque contraído, elija los puntos suspensivos situados en la parte superior derecha del bloque y, a continuación, **Expandir**.
   + Para duplicar el bloque, elija **Duplicar**. El bloque se duplica y se coloca en un hilo nuevo junto al bloque original.
   + Para eliminar el bloque, elija **Eliminar**.

También puede modificar la petición de un bloque para que se adapte mejor a su caso de uso. Siga este procedimiento para modificar la petición de un bloque.

**Cómo modificar la petición de un bloque**

1. Abre la [consola rápida](https://quicksight.aws.amazon.com/).

1. Elija **Escenarios** en el panel de opciones y, a continuación, seleccione el escenario que desea cambiar.

1. Vaya al bloque que desea cambiar y elija **Modificar bloque**.

1. En la ventana emergente **Modificar bloque** que aparece, ingrese una nueva descripción para el bloque y, a continuación, elija **Aplicar**.

Tras modificar una petición, Amazon Q analiza los datos y devuelve un nuevo análisis generado que refleja los cambios hechos en la petición.

# Trabajar con datos en un escenario de Amazon Quick Sight
<a name="scenarios-data"></a>

Al crear un escenario en Amazon Quick Sight, puede obtener una vista previa y modificar los datos que el escenario utiliza para generar resúmenes. Utilice las siguientes secciones para obtener información sobre las formas en que los usuarios de Quick pueden interactuar con los datos en un escenario.

**Topics**
+ [Adición de más datos a un escenario](#scenarios-data-add-data)
+ [Edición de datos en una vista previa](#scenarios-data-edit-preview)
+ [Edición de datos en una instantánea](#scenarios-data-edit-snapshot)

## Adición de más datos a un escenario
<a name="scenarios-data-add-data"></a>

Tras crear un escenario en Amazon Quick Sight, puede añadir más datos al escenario en cualquier momento. Utilice el siguiente procedimiento para añadir datos a un escenario de Amazon Quick Sight.

**Para añadir datos a un escenario existente de Amazon Quick Sight**

1. Abra la [consola Quick](https://quicksight.aws.amazon.com/).

1. Elija **Escenarios** en el panel de opciones y, a continuación, seleccione el escenario al que desea agregar más datos.

1. Elija el icono de **Origen de datos** en la barra de acciones para abrir el panel **Datos**.

1. Lleve a cabo una de las siguientes acciones:

   1. Para añadir datos de Quick Sight al escenario, elija **Buscar datos** y, a continuación, elija el conjunto de datos o las imágenes del panel de control que desee añadir al escenario. Una vez que haya seleccionado todos los datos de Quick Sight que desee agregar al escenario, elija **Agregar**.

   1. Para cargar un archivo desde su ordenador al escenario, seleccione **Cargar archivo**.

   Los siguientes límites se aplican a los datos que se agregan a un escenario:
   + Puede agregar hasta 10 orígenes de datos a un escenario.
   + Se pueden seleccionar hasta 20 elementos visuales de un panel de control a la vez.
   + El formato de los archivos cargados debe ser `.xlsx` o `.csv` y no puede superar 1 GB.
   + Los orígenes de datos pueden tener hasta 200 columnas.

Después de agregar nuevos datos a un escenario, Amazon Q incluye los datos en todos los nuevos análisis.

## Edición de datos en una vista previa
<a name="scenarios-data-edit-preview"></a>

Al elegir datos de un panel de vista rápida para usarlos en un escenario, se genera una vista previa de los datos para revisarlos antes de añadirlos al análisis. Si es necesario, se pueden hacer los siguientes cambios en los datos del panel en el estado de vista previa:
+ **Filtros**: si solo desea analizar un subconjunto de los datos disponibles o si necesita reducir el número de filas que se incluyen en el escenario, puede aplicar filtros a los datos.
+ **Ordenar**: si los datos disponibles superan el millón de filas y desea priorizar la retención de los valores en una columna específica, puede ordenar los datos según sus necesidades.

## Edición de datos en una instantánea
<a name="scenarios-data-edit-snapshot"></a>

Al añadir datos de panel o externos a un escenario, Quick Sight crea una instantánea de las fuentes de datos que se van a revisar. Para ver una instantánea de los datos utilizados en un escenario, elija el icono de **Origen de datos** en la barra de acciones. Esto abre el panel **Datos** y, a continuación, puede elegir la instantánea de datos que desea revisar.

Puede llevar a cabo las siguientes acciones en una instantánea de datos:
+ Para actualizar el título de la instantánea de datos, elija el icono del lápiz situado junto al título e ingrese un nuevo título para la instantánea.
+ Elija el icono **Filtro** para filtrar los datos que se utilizan en el escenario. Esta opción se puede usar si desea que el escenario solo use un subconjunto de los datos que se agregan al escenario.
+ Elija el icono **Ordenar** para ordenar los datos que se utilizan en el escenario. Esta opción se puede utilizar para priorizar la retención de columnas específicas si los datos superan el millón de filas.
+ Elija el icono **Lista de campos** para elegir qué campos se incluirán en el escenario. Esta opción se puede utilizar para controlar qué columnas se utilizan en el escenario.

Cuando haya terminado de actualizar los datos del escenario, cierre el panel **Datos**.

# Solución de problemas de Amazon Quick Sight
<a name="troubleshooting"></a>

 Utilice esta información como ayuda para diagnosticar y solucionar los problemas más comunes que puede encontrar al utilizar Amazon Quick Sight. 

**nota**  
 ¿Necesita ayuda adicional? Puedes visitar la [comunidad de usuarios](https://answers.quicksight.aws.amazon.com/sn/index.html) de Amazon Quick Sight o los [AWS foros](https://forums.aws.amazon.com/). Consulte también la [biblioteca de recursos de Quick Sight](https://aws.amazon.com/quicksight/resource-library/). 

**Topics**
+ [Resolución de problemas y mensajes de error de Amazon Quick Sight](#quicksight-errors)
+ [Problemas de conectividad al usar Amazon Athena con Amazon Quick Sight](troubleshoot-athena.md)
+ [Problemas de conectividad de fuentes de datos para Amazon Quick Sight](troubleshoot-connect-to-datasources.md)
+ [Problemas de inicio de sesión con Quick Sight](troubleshoot-login.md)
+ [Problemas visuales con Quick Sight](visual-issues.md)

## Resolución de problemas y mensajes de error de Amazon Quick Sight
<a name="quicksight-errors"></a>

Si tiene dificultades o recibe un mensaje de error, existen varias maneras de resolver el problema. A continuación se presentan algunos recursos que pueden resultar útiles:
+ Para errores durante la ingesta de conjuntos de datos (importación de datos), consulte [Códigos de error de ingesta de SPICE](errors-spice-ingestion.md).
+ Para preguntas técnicas de usuarios, visite la [comunidad de usuarios](https://answers.quicksight.aws.amazon.com/sn/index.html).
+ Para preguntas sobre administración, consulte los [foros de AWS](https://forums.aws.amazon.com/). 
+ Si necesita una asistencia más personalizada, póngase en contacto con AWS Support. Para hacerlo con la sesión iniciada en su cuenta Cuenta de AWS, seleccione **Support** en la esquina superior derecha y, a continuación, **Support Center**.

# Problemas de conectividad al usar Amazon Athena con Amazon Quick Sight
<a name="troubleshoot-athena"></a>

A continuación, encontrará información sobre la solución de problemas que puedan surgir al utilizar Amazon Athena con Amazon Quick Sight.

Antes de intentar solucionar cualquier otro problema relacionado con Athena, asegúrese de que puede conectarse a Athena. Para obtener información sobre la solución de problemas de conexión de Athena, consulte [No puedo conectarme a Amazon Athena](troubleshoot-connect-athena.md). 

Si puede conectarse pero tiene otros problemas, puede resultar útil ejecutar la consulta en la consola de Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)) antes de añadirla a Amazon Quick Sight. Para obtener información adicional sobre la solución de problemas, consulte [Solución de problemas](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) en la *Guía del usuario de Athena*.

**Topics**
+ [No se encuentra la columna al usar Athena con Amazon Quick Sight](troubleshoot-athena-column-not-found.md)
+ [Datos no válidos al utilizar Athena con Amazon Quick Sight](troubleshoot-athena-invalid-data.md)
+ [Tiempo de espera de consulta al usar Athena con Amazon Quick Sight](troubleshoot-athena-query-timeout.md)
+ [El depósito de preparación ya no existe cuando se usa Athena con Amazon Quick Sight](troubleshoot-athena-missing-bucket.md)
+ [Tabla incompatible cuando se usa AWS Glue con Athena en Amazon Quick Sight](troubleshoot-athena-glue-table-not-upgraded.md)
+ [No se encontró la tabla al usar Athena con Amazon Quick Sight](troubleshoot-athena-table-not-found.md)
+ [Errores de grupo de trabajo y de salida al usar Athena con Quick Sight](troubleshoot-athena-workgroup.md)

# No se encuentra la columna al usar Athena con Amazon Quick Sight
<a name="troubleshoot-athena-column-not-found"></a>

Puede recibir un error de “`column not found`” si faltan las columnas de un análisis en el origen de datos de Athena. 

En Amazon Quick Sight, abra el análisis. En la pestaña **Visualizar**, seleccione **Elegir conjunto de datos**, **Editar conjuntos de datos de análisis**. 

En la pantalla **Conjuntos de datos de este análisis**, elija **Editar** cerca de su conjunto de datos para actualizar el conjunto de datos. Amazon Quick Sight guarda en caché el esquema durante dos minutos. Por lo tanto, pueden pasar dos minutos antes de que se muestren los últimos cambios. 

Para investigar cómo se perdió la columna en primer lugar, puedes ir a la consola de Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)) y comprobar el historial de consultas para encontrar las consultas que editaron la tabla.

Si se produjo este error cuando estaba editando una consulta SQL personalizada en la vista previa, compruebe el nombre de la columna en la consulta y compruebe si hay errores de sintaxis. Por ejemplo, compruebe que el nombre de columna no esté entre comillas simples, que son las reservadas para las cadenas.

Si el problema persiste, verifique que sus tablas, columnas y consultas cumplen los requisitos de Athena. Para más información, consulte [Nombres de tablas, bases de datos y columnas](https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html) y [Solución de problemas](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) en la *Guía del usuario de Athena*.

# Datos no válidos al utilizar Athena con Amazon Quick Sight
<a name="troubleshoot-athena-invalid-data"></a>

Se puede producir un error de datos no válidos al utilizar cualquier operador o función en un campo calculado. Para solucionarlo, compruebe que los datos de la tabla son coherentes con el formato que proporcionó a la función.

Por ejemplo, supongamos que utiliza la función `parseDate(expression, [‘format’], [‘time_zone’])` como **parseDate(date\$1column, ‘MM/dd/yyyy’)**. En este caso, todos los valores de `date_column` deben ajustarse al formato `'MM/dd/yyyy'` (`’05/12/2016’`). Un valor que no esté en este formato (**‘2016/12/05’**) puede provocar un error.

# Tiempo de espera de consulta al usar Athena con Amazon Quick Sight
<a name="troubleshoot-athena-query-timeout"></a>

Si se agota el tiempo de espera de la consulta, puede probar estas opciones para resolver el problema.

Si el error se generó mientras se trabajaba en un análisis, recuerde que el tiempo de espera de Amazon Quick Sight para generar cualquier imagen es de dos minutos. Si utiliza una consulta SQL personalizada, puede simplificarla para optimizar el tiempo de ejecución. 

Si se encuentra en el modo de consulta directa (no con SPICE), puede probar la importación de los datos en SPICE. Sin embargo, si su consulta excede el tiempo de espera de 30 minutos de Athena, podría obtener otro tiempo de espera mientras importa los datos a SPICE. Para obtener la información más actualizada sobre los límites de Athena, consulte [Amazon Athena Limits](https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#amazon-athena-limits) en la *Referencia general de AWS*.

# El depósito de preparación ya no existe cuando se usa Athena con Amazon Quick Sight
<a name="troubleshoot-athena-missing-bucket"></a>

Utilice esta sección para solucionar este error: “**The staging bucket for this query result no longer exists in the underlying data source**”.

 Al crear un conjunto de datos con Athena, Amazon Quick Sight crea un bucket de Amazon S3. De forma predeterminada, este bucket tiene un nombre similar a “`aws-athena-query-results-<REGION>-<ACCOUNTID>`”. Si elimina este bucket, es posible que la próxima consulta de Athena produzca un error que indique que el bucket de colocación ya no existe. 

 Para solucionar este error, cree un nuevo bucket con el mismo nombre en la Región de AWS correcta. 

# Tabla incompatible cuando se usa AWS Glue con Athena en Amazon Quick Sight
<a name="troubleshoot-athena-glue-table-not-upgraded"></a>

Si recibes errores al usar AWS Glue tablas en Athena con Amazon Quick Sight, es posible que se deba a que te faltan algunos metadatos. Siga estos pasos para averiguar si sus tablas no tienen el `TableType` atributo que Amazon Quick Sight necesita para que funcione el conector Athena. Por lo general, los metadatos de estas tablas no se migraron al catálogo de AWS Glue datos. Para obtener más información, consulte [Actualización al catálogo de AWS Glue datos Step-by-Step](https://docs.aws.amazon.com/athena/latest/ug/glue-upgrade.html) en la *Guía para AWS Glue desarrolladores.*

Si no desea migrar al catálogo de AWS Glue datos en este momento, tiene dos opciones. Puede volver a crear cada AWS Glue tabla a través de la consola AWS Glue de administración. O bien, puede utilizar los AWS CLI scripts que se enumeran en el siguiente procedimiento para identificar y actualizar las tablas a las que les falten `TableType` atributos.

Si prefiere usar la CLI para realizar esta tarea, realice el siguiente procedimiento para ayudarle a diseñar sus scripts.

**Uso de la CLI para diseñar scripts**

1. Utilice la CLI para saber qué AWS Glue tablas no tienen `TableType` atributos.

   ```
   aws glue get-tables --database-name <your_datebase_name>;
   ```

   Por ejemplo, puede ejecutar el comando siguiente en la CLI.

   ```
   aws glue get-table --database-name "test_database" --name "table_missing_table_type"
   ```

   Se muestra, a continuación, un ejemplo del aspecto del resultado. Puede ver que la tabla `"table_missing_table_type"` no tiene el atributo `TableType` declarado.

   ```
   {
   		"TableList": [
   			{
   				"Retention": 0,
   				"UpdateTime": 1522368588.0,
   				"PartitionKeys": [
   					{
   						"Name": "year",
   						"Type": "string"
   					},
   					{
   						"Name": "month",
   						"Type": "string"
   					},
   					{
   						"Name": "day",
   						"Type": "string"
   					}
   				],
   				"LastAccessTime": 1513804142.0,
   				"Owner": "owner",
   				"Name": "table_missing_table_type",
   				"Parameters": {
   					"delimiter": ",",
   					"compressionType": "none",
   					"skip.header.line.count": "1",
   					"sizeKey": "75",
   					"averageRecordSize": "7",
   					"classification": "csv",
   					"objectCount": "1",
   					"typeOfData": "file",
   					"CrawlerSchemaDeserializerVersion": "1.0",
   					"CrawlerSchemaSerializerVersion": "1.0",
   					"UPDATED_BY_CRAWLER": "crawl_date_table",
   					"recordCount": "9",
   					"columnsOrdered": "true"
   				},
   				"StorageDescriptor": {
   					"OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
   					"SortColumns": [],
   					"StoredAsSubDirectories": false,
   					"Columns": [
   						{
   							"Name": "col1",
   							"Type": "string"
   						},
   						{
   							"Name": "col2",
   							"Type": "bigint"
   						}
   					],
   					"Location": "s3://myAthenatest/test_dataset/",
   					"NumberOfBuckets": -1,
   					"Parameters": {
   						"delimiter": ",",
   						"compressionType": "none",
   						"skip.header.line.count": "1",
   						"columnsOrdered": "true",
   						"sizeKey": "75",
   						"averageRecordSize": "7",
   						"classification": "csv",
   						"objectCount": "1",
   						"typeOfData": "file",
   						"CrawlerSchemaDeserializerVersion": "1.0",
   						"CrawlerSchemaSerializerVersion": "1.0",
   						"UPDATED_BY_CRAWLER": "crawl_date_table",
   						"recordCount": "9"
   					},
   					"Compressed": false,
   					"BucketColumns": [],
   					"InputFormat": "org.apache.hadoop.mapred.TextInputFormat",
   					"SerdeInfo": {
   						"Parameters": {
   						"field.delim": ","
   						},
   						"SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe"
   					}
   				}
   			}
   		]
   	}
   ```

1. Edite la definición de la tabla en el editor para agregar `"TableType": "EXTERNAL_TABLE"` a la definición de la tabla, como se muestra en el siguiente ejemplo.

   ```
   {
   	"Table": {
   		"Retention": 0,
   		"TableType": "EXTERNAL_TABLE",
   		"PartitionKeys": [
   			{
   				"Name": "year",
   				"Type": "string"
   			},
   			{
   				"Name": "month",
   				"Type": "string"
   			},
   			{
   				"Name": "day",
   				"Type": "string"
   			}
   		],
   		"UpdateTime": 1522368588.0,
   		"Name": "table_missing_table_type",
   		"StorageDescriptor": {
   			"BucketColumns": [],
   			"SortColumns": [],
   			"StoredAsSubDirectories": false,
   			"OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
   			"SerdeInfo": {
   				"SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe",
   				"Parameters": {
   					"field.delim": ","
   				}
   			},
   			"Parameters": {
   				"classification": "csv",
   				"CrawlerSchemaSerializerVersion": "1.0",
   				"UPDATED_BY_CRAWLER": "crawl_date_table",
   				"columnsOrdered": "true",
   				"averageRecordSize": "7",
   				"objectCount": "1",
   				"sizeKey": "75",
   				"delimiter": ",",
   				"compressionType": "none",
   				"recordCount": "9",
   				"CrawlerSchemaDeserializerVersion": "1.0",
   				"typeOfData": "file",
   				"skip.header.line.count": "1"
   			},
   			"Columns": [
   				{
   					"Name": "col1",
   					"Type": "string"
   				},
   				{
   					"Name": "col2",
   					"Type": "bigint"
   				}
   			],
   			"Compressed": false,
   			"InputFormat": "org.apache.hadoop.mapred.TextInputFormat",
   			"NumberOfBuckets": -1,
   			"Location": "s3://myAthenatest/test_date_part/"
   		},
   		"Owner": "owner",
   		"Parameters": {
   			"classification": "csv",
   			"CrawlerSchemaSerializerVersion": "1.0",
   			"UPDATED_BY_CRAWLER": "crawl_date_table",
   			"columnsOrdered": "true",
   			"averageRecordSize": "7",
   			"objectCount": "1",
   			"sizeKey": "75",
   			"delimiter": ",",
   			"compressionType": "none",
   			"recordCount": "9",
   			"CrawlerSchemaDeserializerVersion": "1.0",
   			"typeOfData": "file",
   			"skip.header.line.count": "1"
   		},
   		"LastAccessTime": 1513804142.0
   	}
   	}
   ```

1. Puede adaptar el siguiente script para actualizar la entrada de tabla de forma que incluya el atributo `TableType`.

   ```
   aws glue update-table --database-name <your_datebase_name> --table-input <updated_table_input>
   ```

   A continuación se muestra un ejemplo. 

   ```
   aws glue update-table --database-name test_database --table-input '
   	{
   			"Retention": 0,
   			"TableType": "EXTERNAL_TABLE",
   			"PartitionKeys": [
   				{
   					"Name": "year",
   					"Type": "string"
   				},
   				{
   					"Name": "month",
   					"Type": "string"
   				},
   				{
   					"Name": "day",
   					"Type": "string"
   				}
   			],
   			"Name": "table_missing_table_type",
   			"StorageDescriptor": {
   				"BucketColumns": [],
   				"SortColumns": [],
   				"StoredAsSubDirectories": false,
   				"OutputFormat": "org.apache.hadoop.hive.ql.io.HiveIgnoreKeyTextOutputFormat",
   				"SerdeInfo": {
   					"SerializationLibrary": "org.apache.hadoop.hive.serde2.lazy.LazySimpleSerDe",
   					"Parameters": {
   						"field.delim": ","
   					}
   				},
   				"Parameters": {
   					"classification": "csv",
   					"CrawlerSchemaSerializerVersion": "1.0",
   					"UPDATED_BY_CRAWLER": "crawl_date_table",
   					"columnsOrdered": "true",
   					"averageRecordSize": "7",
   					"objectCount": "1",
   					"sizeKey": "75",
   					"delimiter": ",",
   					"compressionType": "none",
   					"recordCount": "9",
   					"CrawlerSchemaDeserializerVersion": "1.0",
   					"typeOfData": "file",
   					"skip.header.line.count": "1"
   				},
   				"Columns": [
   					{
   						"Name": "col1",
   						"Type": "string"
   					},
   					{
   						"Name": "col2",
   						"Type": "bigint"
   					}
   				],
   				"Compressed": false,
   				"InputFormat": "org.apache.hadoop.mapred.TextInputFormat",
   				"NumberOfBuckets": -1,
   				"Location": "s3://myAthenatest/test_date_part/"
   			},
   			"Owner": "owner",
   			"Parameters": {
   				"classification": "csv",
   				"CrawlerSchemaSerializerVersion": "1.0",
   				"UPDATED_BY_CRAWLER": "crawl_date_table",
   				"columnsOrdered": "true",
   				"averageRecordSize": "7",
   				"objectCount": "1",
   				"sizeKey": "75",
   				"delimiter": ",",
   				"compressionType": "none",
   				"recordCount": "9",
   				"CrawlerSchemaDeserializerVersion": "1.0",
   				"typeOfData": "file",
   				"skip.header.line.count": "1"
   			},
   			"LastAccessTime": 1513804142.0
   		}'
   ```

# No se encontró la tabla al usar Athena con Amazon Quick Sight
<a name="troubleshoot-athena-table-not-found"></a>

Puede recibir un error de “`table not found`” si faltan las tablas de un análisis en el origen de datos de Athena. 

En la consola de Athena ([https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home)), busca tu tabla en el esquema correspondiente. Puede volver a crear la tabla en Athena y, a continuación, crear un nuevo conjunto de datos en Amazon Quick Sight en esa tabla. Para investigar cómo se perdió la tabla en primer lugar, puede utilizar la consola de Athena para comprobar el historial de consultas. Esto le ayudará a encontrar las consultas implicadas en la pérdida de la tabla.

Si este error se produjo al editar una consulta SQL personalizada en la vista previa, compruebe que el nombre de la tabla en la consulta y compruebe si hay algún otro error de sintaxis. Amazon Quick Sight no puede deducir el esquema de la consulta. El esquema debe especificarse en la consulta. 

Por ejemplo, la siguiente instrucción funciona.

```
select from my_schema.my_table
```

La siguiente instrucción falla porque falta el esquema.

```
select from my_table
```

Si el problema persiste, verifique que sus tablas, columnas y consultas cumplen los requisitos de Athena. Para más información, consulte [Nombres de tablas, bases de datos y columnas](https://docs.aws.amazon.com/athena/latest/ug/tables-databases-columns-names.html) y [Solución de problemas](https://docs.aws.amazon.com/athena/latest/ug/troubleshooting.html) en la *Guía del usuario de Athena*.

# Errores de grupo de trabajo y de salida al usar Athena con Quick Sight
<a name="troubleshoot-athena-workgroup"></a>

Para comprobar que los grupos de trabajo están configurados correctamente, compruebe la siguiente configuración:
+ **El grupo de trabajo de Athena que está asociado al origen de datos debe existir.**

  Para solucionarlo, puede volver a la configuración del origen de datos de Athena y elegir un grupo de trabajo diferente. Para más información, consulte [Configuración de los grupos de trabajo](https://docs.aws.amazon.com/athena/latest/ug/workgroups-procedure.html) en la *Guía del usuario de Athena*.

  Otra solución es hacer que el Cuenta de AWS administrador vuelva a crear el grupo de trabajo en la consola de Athena. 
+ **El grupo de trabajo de Athena asociado al origen de datos debe estar habilitado.**

  Un Cuenta de AWS administrador debe habilitar el grupo de trabajo en la consola de Athena. Abra la consola Athena mediante este enlace directo:. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) A continuación, elija el grupo de trabajo adecuado en el panel **Grupo de trabajo** y vea su configuración. Seleccione **Habilitar grupo de trabajo**. 
+ **Asegúrese de que tiene acceso a la ubicación de salida de Amazon S3 asociada al grupo de trabajo de Athena.**

  Para conceder permisos a Amazon Quick Sight para acceder a la ubicación de salida de S3, el administrador de Amazon Quick Sight puede editar **Seguridad y permisos** en la QuickSight pantalla **Administrar**. 
+ **El grupo de trabajo de Athena debe tener una ubicación de salida de S3 asociada.**

  Un Cuenta de AWS administrador debe asociar un bucket de S3 al grupo de trabajo en la consola de Athena. Abra la consola Athena mediante este enlace directo:. [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) A continuación, elija el grupo de trabajo adecuado en el panel **Grupo de trabajo** y vea su configuración. Defina la **Ubicación de resultados de consulta**. 

# Problemas de conectividad de fuentes de datos para Amazon Quick Sight
<a name="troubleshoot-connect-to-datasources"></a>

Utilice la siguiente sección como ayuda para solucionar problemas de conexión a orígenes de datos. Antes de continuar, compruebe que su base de datos está disponible. Además, verifique que tiene la información de conexión correcta y las credenciales válidas. 

**Topics**
+ [No puedo conectarme aunque las opciones de conexión de mi origen de datos parecen correctas (SSL)](troubleshoot-connect-SSL.md)
+ [No puedo conectarme a Amazon Athena](troubleshoot-connect-athena.md)
+ [No puedo conectarme a Amazon S3](troubleshoot-connect-S3.md)
+ [No puedo crear o actualizar un conjunto de datos a partir de un origen de datos de Adobe Analytics existente.](troubleshoot-connect-adobe-analytics.md)
+ [Necesito validar la conexión a mi origen de datos, o cambiar la configuración del origen de datos](troubleshoot-connect-validate.md)
+ [No puedo conectarme a MySQL (problemas con SSL y autorización)](troubleshoot-connect-mysql.md)
+ [No puedo conectarme a RDS](troubleshoot-connect-RDS.md)

# No puedo conectarme aunque las opciones de conexión de mi origen de datos parecen correctas (SSL)
<a name="troubleshoot-connect-SSL"></a>

Se pueden producir problemas al conectarse si la conexión de Capa de conexión segura (SSL) está configurada de forma incorrecta. Entre los síntomas se pueden incluir los siguientes:
+ Puede conectarse a la base de datos de otras formas o desde otras ubicaciones, pero no en este caso.
+ Puede conectarse a una base de datos similar, pero no a esta.

Antes de continuar, descarte las siguientes circunstancias: 
+ Problemas con los permisos
+ Problemas de disponibilidad
+ Un certificado caducado o no válido
+ Un certificado autofirmado
+ Orden incorrecto en una cadena de certificados
+ Puertos no habilitados
+ El cortafuegos está bloqueando una dirección IP
+ Web Sockets está bloqueado
+ Una nube privada virtual (VPC) o un grupo de seguridad no configurados correctamente.

Para ayudarle a encontrar problemas con SSL, puede utilizar un comprobador SSL online o una herramienta como OpenSSL. 

 En los siguientes pasos puede ver cómo solucionar un problema de conexión en el que SSL es el elemento sospechoso. El administrador de este ejemplo ya ha instalado OpenSSL.

**Example**  

1. El usuario detecta un problema al conectarse a la base de datos. El usuario comprueba que puede conectarse a una base de datos diferente en otra Región de AWS. Comprueba otras versiones de la misma base de datos y puede conectarse fácilmente. 

1. El administrador revisa el problema y decide verificar que los certificados están funcionando correctamente. El administrador revisa el problema y decide verificar que los certificados funcionan correctamente.

1. Al usar OpenSSL, el administrador verifica la configuración de SSL en el terminal.

   ```
   echo quit
   openssl s_client –connect <host>:port
   ```

   El resultado muestra que el certificado no funciona.

   ```
   ...
   ...
   ...
   CONNECTED(00000003)
   012345678901234:error:140770FC:SSL routines:SSL23_GET_SERVER_HELLO:unknown protocol:s23_clnt.c:782:
   ---
   no peer certificate available
   ---
   No client certificate CA names sent
   ---
   SSL handshake has read 7 bytes and written 278 bytes
   ---
   New, (NONE), Cipher is (NONE)
   Secure Renegotiation IS NOT supported
   SSL-Session:
       Protocol  : TLSv1.2
       Cipher    : 0000
       Session-ID:
       Session-ID-ctx:
       Master-Key:
       Key-Arg   : None
       PSK identity: None
       PSK identity hint: None
       Start Time: 1497569068
       Timeout   : 300 (sec)
       Verify return code: 0 (ok)
   ---
   ```

1. El administrador corrige el problema instalando el certificado SSL en el servidor de base de datos del usuario. 

Para más información sobre la solución de este ejemplo, consulte [Uso de SSL para cifrar una conexión a una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) en la *Guía del usuario de Amazon RDS*.

# No puedo conectarme a Amazon Athena
<a name="troubleshoot-connect-athena"></a>


|  | 
| --- |
|    Público objetivo: administradores de Amazon Quick  | 

Utilice esta sección para solucionar problemas de conexión a Athena. 

Si no puede conectarse a Amazon Athena, es posible que obtenga un error de permisos insuficientes al ejecutar una consulta, lo que indica que los permisos no están configurados. Para comprobar que puede conectar Amazon Quick Sight a Athena, compruebe los siguientes ajustes: 
+ AWS permisos de recursos dentro de Amazon Quick Sight
+ AWS Identity and Access Management políticas (IAM)
+ Ubicación de Amazon S3
+ Ubicación de los resultados de consulta
+ AWS KMS política de claves (solo para conjuntos de datos cifrados)

Para más detalles, consulte seguidamente. Para información sobre la solución de otros problemas de Athena, consulte [Problemas de conectividad al usar Amazon Athena con Amazon Quick Sight](troubleshoot-athena.md).

## Asegúrese de haber autorizado a Amazon Quick Sight a usar Athena
<a name="troubleshoot-connect-athena-authorizing"></a>


|  | 
| --- |
|    Público objetivo: administradores de Amazon Quick  | 

Utilice el siguiente procedimiento para asegurarse de que ha autorizado correctamente a Amazon Quick Sight a utilizar Athena. Los permisos de AWS los recursos se aplican a todos los usuarios de Amazon Quick Sight.

Para realizar esta acción, debe ser administrador de Amazon Quick Sight. Para comprobar si tiene acceso, compruebe que ve la QuickSight opción **Administrar** al abrir el menú de su perfil en la parte superior derecha.

**Para autorizar a Amazon Quick Sight a acceder a Athena**

1. Elija su nombre de perfil (arriba a la derecha). Selecciona **Administrar Quick Sight** y, a continuación, desplázate hacia abajo hasta la sección de **permisos personalizados**.

1. Selecciona **AWS los recursos** y, a continuación, selecciona **Agregar o eliminar**. 

1. Busque Athena en la lista. Desactive la casilla junto a Athena y vuelva a seleccionarla para habilitar Athena. 

   A continuación, elija **Conectar ambos**. 

1. Elige los cubos a los que quieres acceder desde Amazon Quick Sight. 

   La configuración de los buckets S3 a los que accede aquí es la misma a la que accede al elegir Amazon S3 de la lista de Servicios de AWS. Tenga cuidado de no desactivar inadvertidamente un bucket que utilice otra persona.

1. Elija **Terminar** para confirmar su selección. O bien, elija **Cancelar** para salir sin guardar.

   

1. Selecciona **Actualizar** para guardar la nueva configuración y poder acceder a ella con Amazon Quick Sight Servicios de AWS. O bien, elija **Cancelar** para salir sin realizar ningún cambio.

1. Asegúrese de que está utilizando la correcta Región de AWS cuando haya terminado.

   Si tuvo que cambiarla Región de AWS como parte del primer paso de este proceso, cámbiela de nuevo por la Región de AWS que utilizaba anteriormente. 

## Asegúrese de que sus políticas de IAM conceden los permisos correctos.
<a name="troubleshoot-connect-athena-perms"></a>


|  | 
| --- |
|    Público al que va dirigido: administradores de sistemas  | 

Sus políticas AWS Identity and Access Management (de IAM) deben conceder permisos para acciones específicas. Su usuario o rol de IAM debe poder leer y escribir tanto la entrada como la salida de los buckets de S3 que Athena utiliza para su consulta.

Si el conjunto de datos está cifrado, el usuario de IAM debe ser un usuario clave en la política de la AWS KMS clave especificada.

**Para comprobar que las políticas de IAM tienen permiso para utilizar buckets de S3 para su consulta**

1. Abra la consola de IAM en [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/).

1. Localice el usuario o rol de IAM que utiliza. Elija el nombre de usuario o rol para ver las políticas asociadas.

1. Verifique que su política tenga los permisos correctos. Elija una política que quiera verificar y, a continuación, seleccione **Editar política**. Utilice el editor visual, que se abre de forma predeterminada. Si tiene abierto el editor de JSON, elija la pestaña **Editor visual**. 

1. Elija la entrada de S3 en la lista para ver su contenido. La política debe conceder permisos para enumerar, leer y escribir. Si S3 no está en la lista o no tiene los permisos correctos, puede añadirlos aquí. 

Para ver ejemplos de políticas de IAM que funcionan con Quick Sight, consulte. [Ejemplos de políticas de IAM para Quick](iam-policy-examples.md)

## Asegúrese de que el usuario de IAM tenga read/write acceso a su ubicación de S3
<a name="troubleshoot-connect-athena-read-write-access"></a>


|  | 
| --- |
|    Público objetivo: administradores de Amazon Quick  | 

**Para acceder a los datos de Athena desde Quick Sight, primero asegúrese de que Athena y su ubicación en S3 estén autorizados en la pantalla Administrar. QuickSight** Para obtener más información, consulte [Asegúrese de haber autorizado a Amazon Quick Sight a usar Athena](#troubleshoot-connect-athena-authorizing). 

A continuación, verifique los permisos de IAM pertinentes. El usuario de IAM de su conexión a Athena read/write necesita acceder a la ubicación a la que van los resultados en S3. Comience por verificar que el usuario de IAM tiene una política adjunta que [permite el acceso a Athena](https://docs.aws.amazon.com/athena/latest/ug/setting-up.html#attach-managed-policies-for-using-ate), como `AmazonAthenaFullAccess`. Deje que Athena cree el depósito con el nombre que necesite y, a continuación, añada este depósito a la lista de depósitos a los que QuickSight puede acceder. Si cambia la ubicación predeterminada del bucket de resultados (`aws-athena-query-results-*`), asegúrese de que el usuario de IAM tiene permiso para leer y escribir en la nueva ubicación.

Compruebe que no incluye el Región de AWS código en la URL de S3. Por ejemplo, use `s3://awsexamplebucket/path` y no `s3://us-east-1.amazonaws.com/awsexamplebucket/path`. El uso de una URL de S3 incorrecta provoca un error `Access Denied`. 

Compruebe también que las políticas de los depósitos y las listas de control de acceso a los objetos (ACLs) [permiten al usuario de IAM acceder a los objetos de los depósitos](https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html). Si el usuario de IAM se encuentra en otro lugar Cuenta de AWS, consulte [Acceso entre cuentas](https://docs.aws.amazon.com/athena/latest/ug/cross-account-permissions.html) en la Guía del usuario de *Amazon Athena*.

Si el conjunto de datos está cifrado, compruebe que el usuario de IAM es un usuario clave en la política de claves especificada AWS KMS . Puede hacerlo en la AWS KMS consola, en [https://console.aws.amazon.com/kms](https://console.aws.amazon.com/kms).

**Establecimiento de permisos en la ubicación de los resultados de consulta de Athena**

1. Abra la consola Athena en [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home).

1. Compruebe que seleccionó el grupo de trabajo que quiere utilizar:
   + Examine la opción **Grupo de trabajo** en la parte superior. Tiene el formato **Workgroup**:. *group-name* Si el nombre del grupo es el que quiere utilizar, vaya al paso siguiente.
   + Para elegir un grupo de trabajo diferente, seleccione **Grupo de trabajo** en la parte superior. Elija el grupo de trabajo que quiere utilizar y seleccione **Cambiar grupo de trabajo**.

1. Elija **Configuración** en la parte superior derecha. 

   (No es común) Si obtiene un error que indica que no se encuentra su grupo de trabajo, siga estos pasos para solucionarlo:

   1.  Ignore el mensaje de error por ahora y, en su lugar, busque **Workgroup: *group-name*** en la página de **configuración**. El nombre del grupo de trabajo es un hipervínculo. Ábralo.

   1. En la *<groupname>* página **Grupo de trabajo:**, selecciona **Editar grupo de trabajo** a la izquierda. Ahora cierre el mensaje de error. 

   1. Cerca de **Ubicación del resultado de la consulta**, abra el selector de ubicación de S3 mediante el botón **Seleccionar** que tiene el icono de carpeta de archivos.

   1. Seleccione la flecha pequeña al final del nombre de la ubicación de S3 para Athena. El nombre debe empezar por `aws-athena-query-results`. 

   1. (Opcional) Cifre los resultados de la consulta seleccionando la casilla **Cifrar los resultados almacenados en S3**.

   1. Seleccione **Guardar** para confirmar sus opciones.

   1. Si el error no vuelve a aparecer, vuelva a **Configuración.**

      De vez en cuando, el error puede volver a aparecer. Si es así, siga estos pasos:

      1. Seleccione el grupo de trabajo y, a continuación, **Ver detalles**. 

      1. (Opcional) Para conservar la configuración, tome notas o una captura de pantalla de la configuración del grupo de trabajo. 

      1. Elija **Crear grupo de trabajo**.

      1. Reemplace el grupo de trabajo por uno nuevo. Configure la ubicación de S3 y las opciones de cifrado correctas. Anote la ubicación de S3 porque la necesitará más adelante.

      1. Elija **Guardar** para continuar.

      1. Cuando ya no necesite el grupo de trabajo original, desactívelo. Asegúrese de leer atentamente la advertencia que aparece, porque le indica lo que pierde si decide desactivarlo. 

1. Si no lo obtuvo al solucionar el problema en el paso anterior, elija **Configuración** en la parte superior derecha y obtenga el valor de la ubicación de S3 que se muestra como **Ubicación de los resultados de la consulta**. 

1. Si **Cifrar resultados de consulta** está activado, compruebe si utiliza SSE-KMS o CSE-KMS. Anote la clave. 

1. Abra la consola S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/), abra el depósito correcto y, a continuación, seleccione la pestaña **Permisos**.

1. Compruebe que el usuario de IAM tiene acceso mediante la **Política de bucket**.

   Si administra el acceso con ACLs, asegúrese de que las listas de control de acceso (ACLs) estén configuradas consultando la **Lista de control de acceso**.

1. Si su conjunto de datos está **cifrado (la opción Cifrar los resultados de la consulta** está seleccionada en la configuración del grupo de trabajo), asegúrese de añadir el usuario o rol de IAM como usuario clave en la política de esa AWS KMS clave. [Puedes acceder a la AWS KMS configuración en /kms. https://console.aws.amazon.com](https://console.aws.amazon.com/kms)

**Concesión de acceso al bucket de S3 utilizado por Athena**

1. Abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Elija el bucket de S3 que utiliza Athena en la **ubicación del resultado de la consulta**. 

1. En la pestaña **Permisos**, verifique los permisos.

Para obtener más información, consulta el artículo de AWS Support [Cuando ejecuto una consulta de Athena, aparece el error «Acceso denegado».](https://aws.amazon.com/premiumsupport/knowledge-center/access-denied-athena/)

# No puedo conectarme a Amazon S3
<a name="troubleshoot-connect-S3"></a>

Para conectarse correctamente a Amazon S3, asegúrese de configurar la autenticación y crear un archivo de manifiesto válido dentro del bucket al que intenta acceder. Además, asegúrese de que el archivo descrito por el manifiesto está disponible.

Para verificar la autenticación, asegúrese de haber autorizado a Amazon Quick Sight a acceder a la cuenta S3. No basta con que usted, el usuario, esté autorizado. Amazon Quick Sight debe autorizarse por separado. 

**Para autorizar a Amazon Quick Sight a acceder a su bucket de Amazon S3**

1. En la Región de AWS lista de la parte superior derecha, elija la región EE.UU. Este (Virginia del Norte). La usas Región de AWS temporalmente mientras editas los permisos de tu cuenta. 

1. En Amazon Quick Sight, elige el nombre de tu perfil (arriba a la derecha). Selecciona **Administrar Quick Sight** y, a continuación, desplázate hacia abajo hasta la sección **Permisos personalizados**. 

1. Selecciona **AWS los recursos** y, a continuación, selecciona **Agregar o eliminar**. 

1. Localice Amazon S3 en la lista. Elija una de las siguientes acciones para abrir la pantalla en la que puede elegir los buckets de S3:
   + Si la casilla de verificación está desactivada, seleccione la casilla de verificación junto a Amazon S3. 
   + Si la casilla de verificación está seleccionada, elija **Detalles** y, a continuación, seleccione **Seleccionar buckets de S3**. 

1. Elige los cubos a los que quieres acceder desde Amazon Quick Sight. A continuación, elija **Seleccionar**.

1. Elija **Actualizar**.

1. Si cambiaste los tuyos Región de AWS durante el primer paso de este proceso, cámbialos de nuevo por los Región de AWS que deseas usar.

Le recomendamos encarecidamente que se asegure de que su archivo de manifiesto es válido. Si Amazon Quick Sight no puede analizar el archivo, aparecerá un mensaje de error. Puede ser parecido a “We can't parse the manifest file as valid JSON” o “We can't connect to the S3 bucket”.

**Verificación del archivo de manifiesto**

1. Abra el archivo de manifiesto. Puede hacerlo directamente desde la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/). Vaya a su archivo de manifiesto y seleccione **Abrir**.

1. Asegúrese de que el URI o los que URLs se proporcionan en el archivo de manifiesto indiquen el archivo o los archivos a los que desea conectarse.

1. Asegúrese de que su archivo de manifiesto está formado correctamente, si utiliza un enlace al archivo de manifiesto en lugar de cargar el archivo. El enlace no debería tener frases adicionales después de la palabra `.json`. Puede obtener el enlace correcto a un archivo de S3 visualizando el valor del **enlace** en los detalles en la consola de S3.

1. Asegúrese de que el contenido del archivo de manifiesto es válido utilizando un validador JSON, como el que se utiliza en [https://jsonlint.com](https://jsonlint.com). 

1. Verifique los permisos del bucket o archivo. En [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/), navegue hasta su bucket de Amazon S3, elija la pestaña **Permisos** y añada los permisos correspondientes. Asegúrese de que los permisos están en el nivel adecuado, en el bucket o en el archivo o archivos. 

1. Si usa el protocolo `s3://` en lugar de `https://`, asegúrese de que hace referencia directamente al bucket. Por ejemplo, utilice *s3://awsexamplebucket/myfile.csv* en lugar de *s3://s3-us-west-2.amazonaws.com/awsexamplebucket/myfile.csv*. La doble especificación de Amazon S3, mediante `s3://` y también `s3-us-west-2.amazonaws.com`, provoca un error.

   Para más información sobre los archivos de manifiesto y la conexión a Amazon S3, consulte [Formatos compatibles con los archivos de manifiesto de Amazon S3](supported-manifest-file-format.md).

Además, compruebe que su conjunto de datos de Amazon S3 se creó siguiendo los pasos indicados en [Creación de un conjunto de datos utilizando archivos de Amazon S3](create-a-data-set-s3.md).

Si utiliza Athena para conectarse a Amazon S3, consulte [No puedo conectarme a Amazon Athena](troubleshoot-connect-athena.md).

# No puedo crear o actualizar un conjunto de datos a partir de un origen de datos de Adobe Analytics existente.
<a name="troubleshoot-connect-adobe-analytics"></a>

A partir del 1 de mayo de 2022, Quick Sight ya no admite las operaciones de la API SOAP y las antiguas OAuth versiones 1.3 en Adobe Analytics. Si se producen errores al intentar crear o actualizar un conjunto de datos a partir de un origen de datos de Adobe Analytics existente, es posible que tenga un token de acceso obsoleto.

**Solución de problemas al crear o actualizar un conjunto de datos a partir del origen de datos existente de Adobe Analytics.**

1. Abre Quick Sight y selecciona **Datos** a la izquierda.

1. Seleccione **Nuevo** y, a continuación, **Conjunto de datos**.

1. En la página **Crear un conjunto** de datos, elija la fuente de datos de Adobe Analytics que desee actualizar de la lista de fuentes de datos existentes.

1. Elija **Editar origen de datos**.

1. En la página **Editar origen de datos de Adobe Analytics** que se abre, seleccione **Actualizar origen de datos** para volver a autorizar la conexión de Adobe Analytics.

1. Intente volver a crear o actualizar el conjunto de datos. La creación o actualización del conjunto de datos debería realizarse correctamente.

# Necesito validar la conexión a mi origen de datos, o cambiar la configuración del origen de datos
<a name="troubleshoot-connect-validate"></a>

En algunos casos, puede que necesite actualizar el origen de datos, o que reciba un error de conexión y necesite comprobar la configuración. Si es así, siga estos pasos.

**Validación de su conexión al origen de datos**

1. En la página de inicio de Quick Sight, selecciona **Datos** a la izquierda.

1. Seleccione **Nuevo** y, a continuación, **Conjunto de datos**.

1. Verá una lista de las fuentes de datos existentes.

1. Seleccione el origen de datos que quiere probar o modificar.

1. Si la opción está disponible, seleccione **Editar/obtener vista previa de los datos**.

1. Elija **Validate connection**.

1. Realice los cambios que quiera y, a continuación, seleccione **Actualizar origen de datos**.

# No puedo conectarme a MySQL (problemas con SSL y autorización)
<a name="troubleshoot-connect-mysql"></a>

Para comprobar si hay algunos problemas comunes de conexión en MySQL, siga estos pasos. Este procedimiento le ayuda a averiguar si ha habilitado SSL y ha concedido derechos de uso.

**Búsqueda de soluciones a algunos problemas comunes de conexión en MySQL**

1. Compruebe `/etc/my.cnf` para asegurarse de que SSL está habilitado para MySQL.

1. En MySQL, ejecute el siguiente comando.

   ```
   show status like 'Ssl%';
   ```

   Si SSL funciona, consulte resultados similares al siguiente.

   ```
   +--------------------------------+----------------------+
   | Variable_name                  | Value                |
   +--------------------------------+----------------------+
   | Ssl_accept_renegotiates        | 0                    |
   | Ssl_accepts                    | 1                    |
   | Ssl_callback_cache_hits        | 0                    |
   | Ssl_cipher                     |                      |
   | Ssl_cipher_list                |                      |
   | Ssl_client_connects            | 0                    |
   | Ssl_connect_renegotiates       | 0                    |
   | Ssl_ctx_verify_depth           | 18446744073709551615 |
   | Ssl_ctx_verify_mode            | 5                    |
   | Ssl_default_timeout            | 0                    |
   | Ssl_finished_accepts           | 0                    |
   | Ssl_finished_connects          | 0                    |
   | Ssl_session_cache_hits         | 0                    |
   | Ssl_session_cache_misses       | 0                    |
   | Ssl_session_cache_mode         | SERVER               |
   | Ssl_session_cache_overflows    | 0                    |
   | Ssl_session_cache_size         | 128                  |
   | Ssl_session_cache_timeouts     | 0                    |
   | Ssl_sessions_reused            | 0                    |
   | Ssl_used_session_cache_entries | 0                    |
   | Ssl_verify_depth               | 0                    |
   | Ssl_verify_mode                | 0                    |
   | Ssl_version                    |                      |
   +--------------------------------+----------------------+
   ```

   Si SSL está inhabilitado, consulte resultados similares al siguiente.

   ```
   +--------------------------------+-------+
   | Variable_name                  | Value |
   +--------------------------------+-------+
   | Ssl_accept_renegotiates        | 0     |
   | Ssl_accepts                    | 0     |
   | Ssl_callback_cache_hits        | 0     |
   | Ssl_cipher                     |       |
   | Ssl_cipher_list                |       |
   | Ssl_client_connects            | 0     |
   | Ssl_connect_renegotiates       | 0     |
   | Ssl_ctx_verify_depth           | 0     |
   | Ssl_ctx_verify_mode            | 0     |
   | Ssl_default_timeout            | 0     |
   | Ssl_finished_accepts           | 0     |
   | Ssl_finished_connects          | 0     |
   | Ssl_session_cache_hits         | 0     |
   | Ssl_session_cache_misses       | 0     |
   | Ssl_session_cache_mode         | NONE  |
   | Ssl_session_cache_overflows    | 0     |
   | Ssl_session_cache_size         | 0     |
   | Ssl_session_cache_timeouts     | 0     |
   | Ssl_sessions_reused            | 0     |
   | Ssl_used_session_cache_entries | 0     |
   | Ssl_verify_depth               | 0     |
   | Ssl_verify_mode                | 0     |
   | Ssl_version                    |       |
   +--------------------------------+-------+
   ```

1. Asegúrese de que ha instalado un certificado SSL compatible en el servidor de base de datos. 

1. Conceda los privilegios USAGE al usuario especificado para que se conecte mediante SSL.

   ```
   GRANT USAGE ON *.* TO 'encrypted_user'@'%' REQUIRE SSL;                        
   ```

**nota**  
Las conexiones TLS 1.2 para MySQL requieren la versión 5.7.28 o superior de MySQL. Si su servidor MySQL solo aplica TLS 1.2 (por ejemplo`tls_version = TLSv1.2`) y la versión del servidor es inferior a la 5.7.28, el protocolo de enlace SSL falla y se produce un error. `Communications link failure` Para solucionar este problema, actualice la base de datos MySQL o Aurora MySQL a la versión 5.7.28 o superior.

Para obtener más información sobre la solución descrita en este ejemplo, consulte la siguiente sección:
+ [Soporte SSL para instancias de base de datos MySQL](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.SSLSupport.html) en la *Guía del usuario de Amazon RDS*.
+ [Uso de SSL para cifrar una conexión a una instancia de base de datos](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html) en la *Guía del usuario de Amazon RDS*.
+ [Documentación de MySQL](https://dev.mysql.com/doc/refman/5.6/en/using-encrypted-connections.html)

# No puedo conectarme a RDS
<a name="troubleshoot-connect-RDS"></a>

Para más información sobre cómo solucionar problemas con las conexiones a Amazon RDS, consulte [Creación de un conjunto de datos a partir de una base de datos](create-a-database-data-set.md). 

También puede consultar la documentación de Amazon RDS sobre cómo solucionar problemas con las conexiones, [No puede conectarse a la instancia de base de datos de Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Troubleshooting.html#CHAP_Troubleshooting.Connecting)*.*

# Problemas de inicio de sesión con Quick Sight
<a name="troubleshoot-login"></a>

Utilice la siguiente sección como ayuda para solucionar problemas de inicio de sesión y acceso con la consola Quick Sight.

**Topics**
+ [Permisos insuficientes al usar Athena con Amazon Quick Sight](troubleshoot-athena-insufficient-permissions.md)
+ [Amazon Quick Sight no funciona en mi navegador](troubleshoot-browser.md)
+ [¿Cómo elimino mi cuenta de Amazon Quick Sight?](troubleshoot-delete-quicksight-account.md)
+ [Las personas de mi organización reciben el mensaje «El inicio de sesión externo no está autorizado» cuando intentan acceder a Quick Sight](troubleshoot-webidentity-federation.md)
+ [El inicio de sesión de mi correo electrónico ha dejado de funcionar](troubleshoot-email-login.md)

# Permisos insuficientes al usar Athena con Amazon Quick Sight
<a name="troubleshoot-athena-insufficient-permissions"></a>

Si recibe un mensaje de error que indica que los permisos son insuficientes, pruebe los siguientes pasos para resolver el problema.

Necesita permisos de administrador para solucionar este problema.

**Resolución de un error de permisos insuficientes**

1. Asegúrese de que Amazon Quick Sight pueda acceder a los buckets de Amazon S3 que utiliza Athena: 

   1. Para ello, elija su nombre de perfil (arriba a la derecha). Seleccione **Administrar Quick Sight** y, a continuación, desplácese hacia abajo hasta la sección **Permisos personalizados**.

   1. Selecciona **AWS los recursos** y, a continuación, selecciona **Agregar o eliminar**. 

   1. Ubique Athena en la lista. Desactive la casilla junto a Athena y vuelva a seleccionarla para habilitar Athena. 

      Elija **Conectar ambos**.

   1. Elige los cubos a los que quieres acceder desde Amazon Quick Sight. 

      La configuración de los buckets S3 a los que accede aquí es la misma a la que accede al elegir Amazon S3 de la lista de Servicios de AWS. Tenga cuidado de no desactivar inadvertidamente un bucket que utilice otra persona.

   1. Elija **Seleccionar** para guardar los buckets de S3.

   1. Selecciona **Actualizar** para guardar la nueva configuración y poder acceder a ella con Amazon Quick Sight Servicios de AWS. O bien, elija **Cancelar** para salir sin realizar ningún cambio. 

1. Si el archivo de datos está cifrado con una AWS KMS clave, conceda permisos al rol IAM de Amazon Quick Sight para descifrar la clave. La manera más sencilla de hacerlo es usar la AWS CLI. 

   Para ello, puede ejecutar el comando [create-grant](https://docs.aws.amazon.com/cli/latest/reference/kms/create-grant.html). AWS CLI 

   ```
   aws kms create-grant --key-id <AWS KMS key ARN> --grantee-principal <Your Amazon Quick Sight Role ARN> --operations Decrypt
   ```

   El nombre de recurso de Amazon (ARN) del rol Amazon Quick Sight tiene el formato `arn:aws:iam::<account id>:role/service-role/aws-quicksight-service-role-v<version number>` y se puede acceder a él desde la consola de IAM. Para buscar el ARN de clave de AWS KMS , utilice la consola de S3. Vaya al bucket que contiene el archivo de datos y elija la pestaña **Información general**. La clave se encuentra cerca del **ID de clave de KMS**.

Para las conexiones de Amazon Athena, Amazon S3 y Athena Query Federation, Quick Sight usa la siguiente función de IAM de forma predeterminada: 

```
arn:aws:iam::AWS-ACCOUNT-ID:role/service-role/aws-quicksight-s3-consumers-role-v0
```

Si no `aws-quicksight-s3-consumers-role-v0` está presente, Quick Sight usa:

```
arn:aws:iam::AWS-ACCOUNT-ID:role/service-role/aws-quicksight-service-role-v0
```

# Amazon Quick Sight no funciona en mi navegador
<a name="troubleshoot-browser"></a>

Si no puedes ver Amazon Quick Sight correctamente en tu navegador Google Chrome, sigue estos pasos para solucionar el problema.

**Para ver Amazon Quick Sight en el navegador Chrome**

1. Abra Chrome y vaya a `chrome://flags/#touch-events`. 

1. Si la opción está establecida en **Automático**, cámbiela a **Deshabilitado**. 

1. Cierre y vuelva a abrir Chrome.

# ¿Cómo elimino mi cuenta de Amazon Quick Sight?
<a name="troubleshoot-delete-quicksight-account"></a>

En algunos casos, es posible que tengas que eliminar tu cuenta de Amazon Quick Sight aunque no puedas acceder a Amazon Quick Sight para cancelar la suscripción. Si es así, inicie sesión AWS y utilice el siguiente enlace para abrir [la pantalla de cancelación de suscripción](https://us-east-1.quicksight.aws.amazon.com/sn/console/unsubscribe):`https://us-east-1.quicksight.aws.amazon.com/sn/console/unsubscribe`. Este enfoque funciona sin importar lo Regiones de AWS que uses. Elimina todos los datos, los análisis, los usuarios de Amazon Quick Sight y los administradores de Amazon Quick Sight. Si tiene alguna dificultad, póngase en contacto con el servicio de soporte. 

# Las personas de mi organización reciben el mensaje «El inicio de sesión externo no está autorizado» cuando intentan acceder a Quick Sight
<a name="troubleshoot-webidentity-federation"></a>


|  | 
| --- |
|    Público objetivo: administradores de Amazon Quick  | 

Cuando una persona de su organización se está federando en Quick Sight mediante Quick Sight **AssumeRoleWithWebIdentity**, Quick Sight asigna un único usuario basado en funciones a un único inicio de sesión externo. En algunos casos, esa persona puede autenticarse a través de un inicio de sesión externo (como Amazon Cognito) que es diferente del usuario asignado originalmente. Si es así, no podrá acceder a Quick Sight y recibirá el siguiente mensaje de error inesperado.

El inicio de sesión externo utilizado para la federación no está autorizado para el usuario de Quick Sight.

Para saber cómo solucionar este problema, consulte las secciones siguientes:
+ [¿Por qué ocurre esto?](#troubleshoot-webidentity-federation-why)
+ [¿Cómo puedo solucionarlo?](#troubleshoot-webidentity-federation-how)

## ¿Por qué ocurre esto?
<a name="troubleshoot-webidentity-federation-why"></a>

### Utiliza un flujo simplificado de Amazon Cognito
<a name="troubleshoot-webidentity-federation-why-Cognito-SSO-1"></a>

Si utiliza Amazon Cognito para federarse en Quick Sight, la configuración de inicio de sesión único (IAM Identity Center) podría utilizar la operación de `CognitoIdentityCredentials` API para asumir la función de Quick Sight. Este método asigna todos los usuarios del grupo de identidades de Amazon Cognito a un único usuario de Quick Sight y Quick Sight no lo admite.

Le recomendamos que utilice en su lugar la operación de API `AssumeRoleWithWebIdentity`, que especifica el nombre de sesión del rol.

### Utiliza usuarios no autenticados de Amazon Cognito
<a name="troubleshoot-webidentity-federation-why-Cognito-SSO-2"></a>

IAM Identity Center de Amazon Cognito está configurado para usuarios no autenticados en el grupo de identidades de Amazon Cognito. La política de confianza de roles de Quick Sight se configura como en el siguiente ejemplo.

Esta configuración permite a un usuario temporal de Amazon Cognito asumir una sesión de rol asignada a un usuario único de Quick Sight. Como las identidades no autenticadas son temporales, Quick Sight no las admite.

Le recomendamos que no utilice esta configuración, ya que Quick Sight no admite esta configuración. Para Quick Sight, asegúrese de que el centro de identidad de IAM de Amazon Cognito utilice usuarios autenticados.

### Eliminó y volvió a crear un usuario de Amazon Cognito con los mismos atributos de nombre de usuario.
<a name="troubleshoot-webidentity-federation-why-Cognito-user-delete"></a>

En este caso, se eliminó y se volvió a crear el usuario de Amazon Cognito asociado que estaba asignado al usuario de Quick Sight. El usuario de Amazon Cognito recién creado tiene un asunto subyacente diferente. Según cómo se asigne el nombre de la sesión del rol al usuario de Quick Sight, el nombre de la sesión puede corresponder al mismo usuario basado en el rol de Quick Sight.

Le recomendamos que reasigne el usuario de Quick Sight al asunto de usuario actualizado de Amazon Cognito mediante `UpdateUser` la operación de API. Para obtener más información, consulte el siguiente ejemplo de [UpdateUser API](#troubleshoot-webidentity-federation-solutions-updateuser).

### Está mapeando varios grupos de usuarios de Amazon Cognito en diferentes Cuentas de AWS grupos de identidades y con Quick Sight
<a name="troubleshoot-webidentity-federation-why-Cognito-multi-pools"></a>

Mapear varios grupos de usuarios de Amazon Cognito en grupos de identidades diferentes Cuentas de AWS y Quick Sight no es compatible con Quick Sight.

## ¿Cómo puedo solucionarlo?
<a name="troubleshoot-webidentity-federation-how"></a>

Puede utilizar las operaciones de la API pública de Quick Sight para actualizar la información de inicio de sesión externa de sus usuarios. Utilice las siguientes opciones para saber cómo hacerlo.

### Se utiliza RegisterUser para crear usuarios con información de inicio de sesión externa
<a name="troubleshoot-webidentity-federation-how-registeruser"></a>

Si el proveedor de inicio de sesión externo es Amazon Cognito, utilice el siguiente código de la CLI para crear usuarios.

```
aws quicksight register-user --aws-account-id account-id --namespace namespace --email user-email --user-role user-role --identity-type IAM
--iam-arn arn:aws:iam::account-id:role/cognito-associated-iam-role 
--session-name cognito-username --external-login-federation-provider-type COGNITO 
--external-login-id cognito-identity-id --region identity-region
```

El `external-login-id` debe ser el ID de identidad del usuario de Amazon Cognito. El formato es `<identity-region>:<cognito-user-sub>`, como se muestra en el siguiente ejemplo.

```
aws quicksight register-user --aws-account-id 111222333 --namespace default --email cognito-user@amazon.com --user-role ADMIN --identity-type IAM
--iam-arn arn:aws:iam::111222333:role/CognitoQuickSightRole 
--session-name cognito-user --external-login-federation-provider-type COGNITO 
--external-login-id us-east-1:12345678-1234-1234-abc1-a1b1234567 --region us-east-1
```

Si el proveedor de inicio de sesión externo es un proveedor personalizado de OpenID Connect (OIDC), utilice el siguiente código CLI para crear usuarios.

```
aws quicksight register-user --aws-account-id account-id --namespace namespace
--email user-email --user-role user-role --identity-type IAM
--iam-arn arn:aws:iam::account-id:role/identity-provider-associated-iam-role 
--session-name identity-username --external-login-federation-provider-type CUSTOM_OIDC 
--custom-federation-provider-url custom-identity-provider-url 
--external-login-id custom-provider-identity-id --region identity-region
```

A continuación se muestra un ejemplo.

```
aws quicksight register-user --aws-account-id 111222333 --namespace default 
--email identity-user@amazon.com --user-role ADMIN --identity-type IAM
--iam-arn arn:aws:iam::111222333:role/CustomIdentityQuickSightRole
--session-name identity-user --external-login-federation-provider-type CUSTOM_OIDC 
--custom-federation-provider-url idp.us-east-1.amazonaws.com/us-east-1_ABCDE 
--external-login-id 12345678-1234-1234-abc1-a1b1234567 --region us-east-1
```

Para obtener más información sobre el uso `RegisterUser` en la CLI, consulte [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)la *Amazon Quick API Reference*.

### Se utiliza DescribeUser para comprobar la información de inicio de sesión externa de los usuarios
<a name="troubleshoot-webidentity-federation-how-describeuser"></a>

Si un usuario es un usuario federado basado en roles de un proveedor de inicio de sesión externo, utilice la operación de API `DescribeUser` para comprobar la información de inicio de sesión externa para él, como se muestra en el siguiente código.

```
aws quicksight describe-user --aws-account-id account-id  --namespace namespace
--user-name identity-provider-associated-iam-role/identity-username 
--region identity-region
```

A continuación se muestra un ejemplo.

```
aws quicksight describe-user --aws-account-id 111222333 --namespace default --user-name IdentityQuickSightRole/user --region us-west-2
```

El resultado contiene los campos de información de inicio de sesión externa si los hay. A continuación se muestra un ejemplo.

```
{
    "Status": 200,
    "User": {
        "Arn": "arn:aws:quicksight:us-east-1:111222333:user-default-IdentityQuickSightRole-user",
        "UserName": "IdentityQuickSightRole-user",
        "Email": "user@amazon.com",
        "Role": "ADMIN",
        "IdentityType": "IAM",
        "Active": true,
        "PrincipalId": "federated-iam-AROAAAAAAAAAAAAAA:user",
        "ExternalLoginFederationProviderType": "COGNITO",
        "ExternalLoginFederationProviderUrl": "cognito-identity.amazonaws.com",
        "ExternalLoginId": "us-east-1:123abc-1234-123a-b123-12345678a"
    },
    "RequestId": "12345678-1234-1234-abc1-a1b1234567"
}
```

Para obtener más información sobre el uso `DescribeUser` en la CLI, consulte [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)la *Amazon Quick API Reference*.

### Se utiliza UpdateUser para actualizar la información de inicio de sesión externa de los usuarios
<a name="troubleshoot-webidentity-federation-solutions-updateuser"></a>

En algunos casos, es posible que la información de inicio de sesión externa guardada para el usuario a partir del resultado de `DescribeUser` no sea correcta o que falte la información de inicio de sesión externa. Si es así, puede utilizar la operación de API `UpdateUser` para actualizarla. Siga los siguientes ejemplos.

Para los usuarios de Amazon Cognito, utilice lo siguiente.

```
aws quicksight update-user --aws-account-id account-id --namespace namespace 
--user-name cognito-associated-iam-role/cognito-username
 --email user-email --role user-role 
--external-login-federation-provider-type COGNITO 
--external-login-id cognito-identity-id --region identity-region
```

A continuación se muestra un ejemplo.

```
aws quicksight update-user --aws-account-id 111222333 --namespace default 
--user-name CognitoQuickSightRole/cognito-user --email cognito-user@amazon.com 
--role ADMIN --external-login-federation-provider-type COGNITO 
--external-login-id us-east-1:12345678-1234-1234-abc1-a1b1234567 --region us-west-2
```

Para los usuarios proveedores de OIDC personalizados, utilice lo siguiente.

```
aws quicksight update-user --aws-account-id account-id --namespace namespace 
 --user-name identity-provider-associated-iam-role/identity-username 
--email user-email --role user-role 
--external-login-federation-provider-type CUSTOM_OIDC 
--custom-federation-provider-url custom-identity-provider-url 
--external-login-id custom-provider-identity-id --region identity-region
```

A continuación se muestra un ejemplo.

```
aws quicksight update-user --aws-account-id 111222333 --namespace default 
--user-name IdentityQuickSightRole/user --email user@amazon.com --role ADMIN 
--external-login-federation-provider-type CUSTOM_OIDC 
--custom-federation-provider-url idp.us-east-1.amazonaws.com/us-east-1_ABCDE 
 --external-login-id 123abc-1234-123a-b123-12345678a --region us-west-2
```

Si quiere eliminar la información de inicio de sesión externo del usuario, utilice `NONE` `external login federation provider type`. Utilice el siguiente comando de la CLI para eliminar la información de inicio de sesión externo.

```
aws quicksight update-user --aws-account-id account-id --namespace namespace 
 --user-name identity-provider-associated-iam-role/identity-username 
--email user-email --role user-role
--external-login-federation-provider-type NONE --region identity-region
```

A continuación se muestra un ejemplo.

```
aws quicksight update-user --aws-account-id 111222333 --namespace default 
--user-name CognitoQuickSightRole/cognito-user --email cognito-user@amazon.com --role ADMIN --external-login-federation-provider-type NONE --region us-west-2
```

Para obtener más información sobre el uso `UpdateUser` en la CLI, consulte la [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html)*Amazon Quick API Reference*.

# El inicio de sesión de mi correo electrónico ha dejado de funcionar
<a name="troubleshoot-email-login"></a>

En la actualidad, los correos electrónicos distinguen entre mayúsculas y minúsculas. Si el suyo no funciona, pídale a su administrador que busque una combinación de letras mayúsculas y minúsculas. Use el correo electrónico tal y como se escribió.

# Problemas visuales con Quick Sight
<a name="visual-issues"></a>

Utilice la siguiente sección para solucionar problemas con los elementos visuales y su formato.

**Topics**
+ [No puedo ver mis elementos visuales](troubleshoot-adding-visuals.md)
+ [En mis documentos impresos aparece una barra de comentarios](troubleshoot-printing-docs.md)
+ [¿Por qué mis gráficos de mapa no muestran ubicaciones?](troubleshoot-geocoding.md)
+ [Mi tabla dinámica deja de funcionar](troubleshoot-pivot-tables.md)
+ [Mi elemento visual no encuentra las columnas que faltan](troubleshooting-dataset-changed-columns.md)
+ [Mi elemento visual no encuentra la tabla de consultas](troubleshooting-dataset-changed-tables.md)
+ [Mi elemento visual no se actualiza después de cambiar un campo calculado](troubleshooting-visual-refresh.md)
+ [Los valores de un archivo de Microsoft Excel con notación científica no tienen el formato correcto en Quick Sight](troubleshooting-number-formatting.md)

# No puedo ver mis elementos visuales
<a name="troubleshoot-adding-visuals"></a>

Utilice la siguiente sección como ayuda para solucionar los problemas relacionados con los elementos visuales que faltan. Antes de continuar, asegúrese de que aún puede acceder a su origen de datos. Si no puede conectarse a su origen de datos, consulte [Problemas de conectividad de fuentes de datos para Amazon Quick Sight](troubleshoot-connect-to-datasources.md).
+ Si tiene problemas para agregar un elemento visual a un análisis, intente lo siguiente:
  + Compruebe la conectividad y confirme que tiene acceso a todos los dominios que Quick Sight utiliza para acceder. Para ver una lista de todos los usos de URLs Quick Sight, consulta [Dominios a los que accede Quick Sight](https://docs.aws.amazon.com//quicksight/latest/developerguide/vpc-interface-endpoints.html#vpc-interface-endpoints-restrictvpc-interface-endpoints-supported-domains).
  + Compruebe que no intenta agregar más objetos de los que permite la cuota. Amazon Quick Sight admite hasta 30 conjuntos de datos en un solo análisis, hasta 30 imágenes en una sola hoja y un límite de 20 hojas por análisis.
  + Supongamos que edita un análisis para un origen de datos seleccionado y la conexión con el origen de datos finaliza inesperadamente. El estado de error resultante puede impedir que se realicen más cambios en el análisis. En este caso, no podrá agregar más elementos visuales al análisis. Compruebe este estado.
+ Si los elementos visuales no se cargan, pruebe lo siguiente:
  + Si utiliza una red corporativa, pida ayuda al administrador de la red y compruebe que la configuración del firewall de la red permite el tráfico desde `*.aws.amazon.com`, `amazonaws.com`, `wss://*.aws.amazon.com` y `cloudfront.net`.
  + Agregue excepciones a su bloqueador de anuncios para `*.aws.amazon.com`, `amazonaws.com`, `wss://*.aws.amazon.com` y `cloudfront.net`.
  + Si utiliza un servidor proxy, compruebe que `*.quicksight.aws.amazon.com` y `cloudfront.net` se incluyen en la lista de dominios aprobados (la lista de permitidos).

# En mis documentos impresos aparece una barra de comentarios
<a name="troubleshoot-printing-docs"></a>

En ocasiones, el navegador imprime la barra de comentarios del documento en la página, bloqueando algún contenido impreso.

Para evitar este problema, utilice el icono de giro hacia abajo situado en la parte inferior izquierda de la pantalla (que se muestra a continuación) para minimizar la barra de comentarios. A continuación, imprima el documento.

![\[\]](http://docs.aws.amazon.com/es_es/quick/latest/userguide/images/printing-docs.png)


# ¿Por qué mis gráficos de mapa no muestran ubicaciones?
<a name="troubleshoot-geocoding"></a>

Para que la asignación automática, llamada geocodificación, funcione en los gráficos de mapas, asegúrese de que sus datos estén preparados siguiendo reglas específicas. Si desea ayuda sobre cuestiones geoespaciales, consulte [Solución de problemas geoespaciales](geospatial-troubleshooting.md). Si desea ayuda en la preparación de datos para gráficos geoespaciales, consulte [Adición de datos geoespaciales](geospatial-data-prep.md).

# Mi tabla dinámica deja de funcionar
<a name="troubleshoot-pivot-tables"></a>

Si la tabla dinámica supera las limitaciones de procesamiento de la base de datos subyacente, por lo general se debe a la combinación de elementos en los grupos de campos. Es decir, la causa es una combinación de filas, columnas, métricas y cálculos de la tabla. Para reducir el nivel de complejidad y el potencial de errores, simplifique la tabla dinámica. Para obtener más información, consulte [Prácticas recomendadas para tablas dinámicas](pivot-table-best-practices.md).

# Mi elemento visual no encuentra las columnas que faltan
<a name="troubleshooting-dataset-changed-columns"></a>

Los elementos visuales de mi análisis no funcionan según lo previsto. El mensaje de error dice `"The column(s) used in this visual do not exist."`

La causa más habitual de este error es que el esquema de origen de datos haya cambiado. Por ejemplo, es posible que el nombre de una columna haya cambiado de `a_column` a `b_column`.

Según cómo acceda su conjunto de datos al origen de datos, elija una de las siguientes opciones.
+ Si el conjunto de datos se basa en SQL personalizado, realice una o varias de las siguientes acciones:
  + Edite el conjunto de datos. 
  + Edite la instrucción SQL.

    Por ejemplo, si el nombre de la tabla cambió de `a_column` a `b_column`, puede actualizar la secuencia SQL para crear un alias: `SELECT b_column as a_column`. Al utilizar el alias para mantener el mismo nombre de campo en el conjunto de datos, evite tener que añadir la columna a los elementos visuales como una nueva entidad.

  Cuando termine, seleccione **Guardar y visualizar**.
+ Si el conjunto de datos no se basa en SQL personalizado, realice una o varias de las siguientes acciones:
  + Edite el conjunto de datos. 
  + Para los campos que ahora tienen nombres diferentes, cámbieles el nombre en el conjunto de datos. Puede utilizar los nombres de campo del conjunto de datos original. A continuación, abra su análisis y agregue los campos renombrados a los elementos visuales afectados.

  Cuando termine, seleccione **Guardar y visualizar**.

# Mi elemento visual no encuentra la tabla de consultas
<a name="troubleshooting-dataset-changed-tables"></a>

En este caso, los elementos visuales de su análisis no funcionan como se esperaba. El mensaje de error dice `"Amazon Quick Sight can’t find the query table."`

La causa más habitual de este error es que el esquema de origen de datos haya cambiado. Por ejemplo, es posible que el nombre de una tabla haya cambiado de `x_table` a `y_table`.

En función de cómo acceda el conjunto de datos al origen de datos, elija una de las siguientes opciones.
+ Si el conjunto de datos se basa en SQL personalizado, realice una o varias de las siguientes acciones:
  + Edite el conjunto de datos. 
  + Edite la instrucción SQL.

    Por ejemplo, si el nombre de la tabla ha cambiado de `x_table` a `y_table`, puede actualizar la cláusula FROM en la instrucción SQL para hacer referencia a la nueva tabla. 

  Cuando termine, elija **Guardar y visualizar** y, a continuación, elija cada elemento visual y lea los campos según sea necesario.
+ Si el conjunto de datos no se basa en SQL personalizado, haga lo siguiente:

  1. Cree un nuevo conjunto de datos utilizando la nueva tabla, por ejemplo, `y_table`. 

  1. Abra el análisis. 

  1. Reemplace el conjunto de datos original por el conjunto de datos recién creado. Si no hay cambios en las columnas, todos los elementos visuales deberían funcionar después de reemplazar el conjunto de datos. Para obtener más información, consulte [Sustitución de conjuntos de datos](replacing-data-sets.md). 

# Mi elemento visual no se actualiza después de cambiar un campo calculado
<a name="troubleshooting-visual-refresh"></a>

Cuando se actualiza un campo calculado del que dependen muchos otros campos, es posible que las entidades consumidoras no se actualicen como se esperaba. Por ejemplo, cuando se actualiza un campo calculado que se utiliza en un campo que se está visualizando, el elemento visual no se actualiza como se esperaba.

Para solucionar este problema, actualice el navegador de Internet.

# Los valores de un archivo de Microsoft Excel con notación científica no tienen el formato correcto en Quick Sight
<a name="troubleshooting-number-formatting"></a>

Cuando se conecta a un archivo de Microsoft Excel que tiene una columna numérica que contiene valores con notación científica, es posible que no tengan el formato correcto en Quick Sight. Por ejemplo, el valor 1,59964E\$111, que en realidad es 159964032802, tiene el formato 159964000000 en Quick Sight. Esto puede provocar un análisis incorrecto.

Para resolver este problema, formatee la columna como `Text` en Microsoft Excel y, a continuación, cargue el archivo en Quick Sight.

# Desarrollo con Amazon Quick Sight
<a name="quicksight_dev"></a>

Proporcionamos operaciones de API para Amazon Quick Sight y también kits de desarrollo de software (SDKs) AWS que le permiten acceder a Amazon Quick Sight desde su lenguaje de programación preferido. Actualmente puede administrar usuarios y grupos. En la edición Enterprise es posible también integrar paneles en una página web o en una aplicación.

Para supervisar las llamadas realizadas a la API Amazon Quick Sight de su cuenta, incluidas las llamadas realizadas por las Consola de administración de AWS herramientas de línea de comandos y otros servicios, utilice AWS CloudTrail. Para obtener más información, consulte la [Guía del usuario de AWS CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).

## Conocimientos necesarios
<a name="quicksight_dev-required_knowledge"></a>

Si planea acceder a Amazon Quick Sight a través de una API, debe estar familiarizado con lo siguiente:
+ JSON
+ Servicios web
+ Solicitudes HTTP
+ Uno o más lenguajes de programación JavaScript, como Java, Python o C\$1.

Recomendamos visitar el AWS [Centro de recursos de introducción](https://aws.amazon.com/getting-started/tools-sdks/) para ver qué ofrecen AWS SDKs los kits de herramientas. 

Aunque puede utilizar un terminal y su editor de texto favorito, podría beneficiarse de la experiencia de interfaz de usuario más visual que ofrece un entorno de desarrollo integrado (IDE). En el *Centro de recursos para AWS empezar, IDEs en la sección* [IDE y kits de herramientas del IDE](https://aws.amazon.com/getting-started/tools-sdks/#IDE_and_IDE_Toolkits), encontrará una lista de los mismos. Este sitio proporciona AWS kits de herramientas que puede descargar para el IDE que prefiera. Algunos IDEs también ofrecen tutoriales para ayudarle a aprender más sobre los lenguajes de programación. 

## Operaciones de API disponibles para Amazon Quick Sight
<a name="quicksight_dev-using_libraries"></a>

AWS proporciona bibliotecas, códigos de muestra, tutoriales y otros recursos para los desarrolladores de software que prefieren crear aplicaciones mediante operaciones de API específicas del idioma en lugar de enviar una solicitud a través de HTTPS. Estas bibliotecas proporcionan funciones básicas que automatizan tareas como la firma criptográfica de las solicitudes, el reintento de las solicitudes o el tratamiento de las respuestas de error. Estas bibliotecas le ayudan a empezar con más facilidad.

[Para obtener más información sobre la descarga de AWS SDKs, consulte Herramientas AWS SDKs .](https://aws.amazon.com/tools/) Los siguientes enlaces son una muestra de la documentación de la API disponible para cada lenguaje.

**AWS Command Line Interface**
+ [AWS CLI QuickSight Referencia de comandos](https://docs.aws.amazon.com/cli/latest/reference/quicksight/index.html)
+ [AWS CLI Guía del usuario](https://docs.aws.amazon.com/cli/latest/userguide/)
+ [AWS CLI Referencia de comandos](https://docs.aws.amazon.com/cli/latest/reference/)

**AWS SDK para .NET**
+ [Amazon.Quicksight](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSight.html)
+ [Amazon.Quicksight.Model](https://docs.aws.amazon.com/sdkfornet/v3/apidocs/index.html?page=QuickSight/NQuickSightModel.html)

**AWS SDK para C\$1\$1**
+ [AWS::QuickSight: Referencia QuickSightClient de clase](https://sdk.amazonaws.com/cpp/api/LATEST/class_aws_1_1_quick_sight_1_1_quick_sight_client.html)

**AWS SDK para Go**
+ [quicksight](https://docs.aws.amazon.com/sdk-for-go/api/service/quicksight/)

**AWS SDK para Java**
+ [com.amazonaws.services.quicksight](https://docs.aws.amazon.com/sdk-for-java/latest/reference/index.html?com/amazonaws/services/quicksight/package-summary.html)
+ [com.amazonaws.services.quicksight.model](https://docs.aws.amazon.com/sdk-for-java/latest/reference/index.html?com/amazonaws/services/quicksight/model/package-summary.html)

**AWS SDK para JavaScript**
+ [AWS. QuickSight](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/QuickSight.html)

**AWS SDK para PHP**
+ [QuickSightClient](https://docs.aws.amazon.com/aws-sdk-php/v3/api/class-Aws.QuickSight.QuickSightClient.html)

**AWS SDK para Python (Boto3)**
+ [Amazon Quick Sight](https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/quicksight.html)

**AWS SDK para Ruby**
+ [Como: QuickSight](https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/QuickSight.html)

# Terminología y conceptos
<a name="quicksight_dev-terminology"></a>

En esta sección se proporciona una lista de términos para el desarrollo en Amazon Quick Sight. 

**Usuario anónimo de Amazon Quick Sight:** una identidad de usuario temporal de Amazon Quick Sight que pertenece prácticamente a un espacio de nombres y que solo se puede utilizar con la incrustación. Puede utilizar reglas basadas en etiquetas para implementar una seguridad de nivel de fila para dichos usuarios.

**Identidad del autor de la llamada:** la identidad del usuario de AWS Identity and Access Management que realiza una solicitud a la API. Amazon Quick Sight determina la identidad de la persona que llama mediante la firma adjunta a la solicitud. Cuando se usan los clientes SDK proporcionados, no son necesarios pasos manuales para generar la firma ni adjuntarla a las solicitudes. Sin embargo, puede hacerlo manualmente si lo desea. 

**Identidad del invocador:** — Además de la identidad de la persona que llama, pero no como sustitutiva de la misma, puede asumir la identidad de la persona que llama a través de la `AssumeRole` API de IAM al realizar llamadas a Amazon Quick Sight. AWS aprueba a las personas que llaman a través de la identidad de su invocador. Esto se hace para evitar tener que añadir de forma explícita varias cuentas que pertenezcan a la misma suscripción a Amazon Quick Sight. 

**Espacio de nombres:** un contenedor lógico que le permite aislar los grupos de usuarios para poder organizar los clientes, las filiales, los equipos, etc. Para obtener más información, consulte Cómo [admitir la multitenencia con](https://docs.aws.amazon.com/quicksight/latest/user/namespaces.html) espacios de nombres aislados 

**QuickSight ARN:** — Nombre de recurso de Amazon (ARN). Los recursos de Amazon Quick Sight se identifican mediante su nombre o ARN. Por ejemplo, son los ARNs de un grupo denominado`MyGroup1`, un nombre `User1` de usuario y un panel con el ID: `1a1ac2b2-3fc3-4b44-5e5d-c6db6778df89`

```
arn:aws:quicksight:us-east-1:111122223333:group/default/MyGroup1
	arn:aws:quicksight:us-east-1:111122223333:user/default/User1
	arn:aws:quicksight:us-west-2:111122223333:dashboard/1a1ac2b2-3fc3-4b44-5e5d-c6db6778df89
```

En los siguientes ejemplos se muestran ARNs una plantilla denominada `MyTemplate` y un panel denominado`MyDashboard`.

1. Ejemplo de ARN para una plantilla

   ```
   arn:aws:quicksight:us-east-1:111122223333:template/MyTemplate
   ```

1. Ejemplo de ARN para una plantilla, que hace referencia a una versión específica de la plantilla

   ```
   arn:aws:quicksight:us-east-1:111122223333:template/MyTemplate/version/10
   ```

1. Ejemplo de ARN para un alias de plantilla

   ```
   arn:aws:quicksight:us-east-1:111122223333:template/MyTemplate/alias/STAGING
   ```

1. Ejemplo de ARN para un panel

   ```
   arn:aws:quicksight:us-east-1:111122223333:dashboard/MyDashboard
   ```

1. Ejemplo de ARN para un panel, que hace referencia a una versión específica del panel

   ```
   arn:aws:quicksight:us-east-1:111122223333:dashboard/MyDashboard/version/10
   ```

Dependiendo del caso, es posible que tenga que proporcionar el nombre, ID o ARN de la entidad. Puede recuperar el ARN si tiene el nombre mediante algunas de las operaciones de la API de Amazon Quick Sight.

**Panel de Amazon Quick Sight:** — Entidad que identifica los informes de Amazon Quick Sight, creados a partir de análisis o plantillas. Los paneles de Amazon Quick Sight se pueden compartir. Con los permisos adecuados, puede crear informes de correo electrónico programados a partir de ellos. Las operaciones de la API `CreateDashboard` y `DescribeDashboard` actúan en la entidad del panel.

**Plantilla Amazon Quick Sight:** — Una entidad que encapsula los metadatos necesarios para crear un análisis o un panel. Abstrae el conjunto de datos asociado al análisis sustituyéndolo por marcadores de posición. Las plantillas se pueden usar para crear paneles reemplazando marcadores de posición de conjuntos de datos que siguen el mismo esquema que se utilizó para crear el análisis de origen y la plantilla.

**Usuario de Amazon Quick Sight:** — Se trata de una identidad de usuario de Amazon Quick Sight sobre la que actúa su llamada a la API. Este usuario no es idéntico a la identidad de la persona que llama, pero puede ser la que se asigna al usuario en Amazon Quick Sight. 

# Desarrollo de aplicaciones con la API Amazon Quick Sight
<a name="quicksight-sdks"></a>

Puede gestionar la mayoría de los aspectos de su implementación mediante el acceso AWS SDKs a una API que se adapte al lenguaje de programación o la plataforma que utilice. Para obtener más información, consulte [AWS SDKs](https://aws.amazon.com/tools/#SDKs). 

Para obtener más información sobre las operaciones de la API, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/index.html?id=docs_gateway). 

Para poder llamar a las operaciones de la API de Amazon Quick Sight, necesita el `quicksight:operation-name` permiso de una política adjunta a su identidad de IAM. Por ejemplo, para llamar a `list-users`, necesita el permiso `quicksight:ListUsers`. Lo mismo es aplicable a todas las operaciones.

Si no está seguro de cuál es el permiso necesario, puede intentar realizar una llamada. A continuación, el cliente le indica cuál es el permiso que falta. Puede usar un asterisco (`*`) en el campo Recurso de su política de permisos en lugar de especificar recursos explícitos. Sin embargo, le recomendamos que restrinja cada permiso en la medida de lo posible. Puede restringir el acceso de los usuarios especificando o excluyendo los recursos de la política mediante su identificador Amazon Quick Sight Amazon Resource Name (ARN). 

Para obtener más información, consulte los siguientes temas:
+ [Ejemplos de políticas de IAM para Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/iam-policy-examples.html)
+ [Acciones, recursos y claves de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonquicksight.html)
+ [Elementos de política JSON de IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html)

Para obtener el ARN de un usuario o un grupo, utilice la operación `Describe` para el recurso correspondiente. También puede añadir condiciones en IAM para restringir aún más el acceso a una API en algunos casos. Por ejemplo, al añadir `User1` a`Group1`, el recurso principal es`Group1`, por lo que puedes permitir o denegar el acceso a determinados grupos, pero también puedes añadir una condición mediante la tecla Amazon Quick Sight de IAM `quicksight:UserName` para permitir o impedir que determinados usuarios se añadan a ese grupo. 

El siguiente es un ejemplo de política. Significa que el intermediario que tiene esta política asociada puede invocar la operación `CreateGroupMembership` para cualquier grupo, siempre que el nombre de usuario que se añade al grupo no sea `user1`. 

```
{
    "Effect": "Allow",
    "Action": "quicksight:CreateGroupMembership",
    "Resource": "arn:aws:quicksight:us-east-1:aws-account-id:group/default/*",
    "Condition": {
        "StringNotEquals": {
            "quicksight:UserName": "user1"
        }
    }
}
```

------
#### [ AWS CLI ]

El siguiente procedimiento explica cómo interactuar con las operaciones de la API de Amazon Quick Sight a través de la AWS CLI. Las instrucciones siguientes se han probado en Bash, pero deberían ser idénticas o similares en otros entornos de línea de comandos.

1. Instale el AWS SDK en su entorno. Encontrará instrucciones para hacerlo aquí: [Interfaz de línea de comandos de AWS](https://aws.amazon.com/cli/).

1. Configure la identidad y la región de AWS CLI mediante el siguiente comando y las instrucciones de seguimiento. Utilice las credenciales de una identidad o rol de IAM que tenga los permisos adecuados. 

   ```
   aws configure
   ```

1. Consulte la ayuda del SDK de Amazon Quick Sight emitiendo el siguiente comando: 

   ```
   aws quicksight help
   ```

1. Para obtener instrucciones detalladas sobre el uso de una API, escriba su nombre seguido de “help”, del siguiente modo: 

   ```
   aws quicksight list-users help
   ```

1. Ahora puede llamar a una operación de la API de Amazon Quick Sight. En este ejemplo, se devuelve una lista de los usuarios de Amazon Quick Sight de su cuenta. 

   ```
   aws quicksight list-users --aws-account-id aws-account-id --namespace default --region us-east-1
   ```

------
#### [ Java SDK ]

Utilice el siguiente procedimiento para configurar una aplicación Java que interactúe con Amazon Quick Sight. 

1. Para empezar, cree un proyecto de Java en el IDE.

1. Importe el SDK de Amazon Quick Sight a su nuevo proyecto, por ejemplo: `AWSQuickSightJavaClient-1.11.x.jar`

1. Una vez que su IDE indexe el SDK de Amazon Quick Sight, debería poder añadir una línea de importación de la siguiente manera: 

   ```
   import com.amazonaws.services.quicksight.AmazonQuickSight;
   ```

   Si el IDE no lo reconoce como válido, compruebe que ha importado el SDK.

1. Al igual que otros AWS SDKs, el SDK de Amazon Quick Sight requiere dependencias externas para realizar muchas de sus funciones. Es necesario descargarlas e importarlas en el mismo proyecto. Se requieren las dependencias siguientes:
   + `aws-java-sdk-1.11.402.jar`(Configuración de credenciales y SDK de AWS Java): consulte [Configurar el AWS SDK para Java](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/setup-install.html) 
   + `commons-logging-1.2.jar`— Consulte [https://commons.apache. org/proper/commons-logging/download\$1logging.cgi](https://commons.apache.org/proper/commons-logging/download_logging.cgi) 
   + `jackson-annotations-2.9.6.jar``jackson-core-2.9.6.jar`, y `jackson-databind-2.9.6.jar` — Consulte [http://repo1.maven. org/maven2/com/fasterxml/jackson/core](https://repo1.maven.org/maven2/com/fasterxml/jackson/core/)/ 
   + `httpclient-4.5.6.jar`, `httpcore-4.4.10.jar`: consulte [ https://hc.apache.org/downloads.cgi ](https://hc.apache.org/downloads.cgi) 
   + `joda-time-2.1.jar`— Véase [ https://mvnrepository.com/artifact/joda-time/joda-time/2.1](https://mvnrepository.com/artifact/joda-time/joda-time/2.1) 

1. Ahora ya está listo para crear un cliente de Amazon Quick Sight. Puede utilizar punto de enlace público predeterminado con el que el cliente pueda comunicar o indicar el punto de enlace de forma explícita. Existen varias formas de proporcionar sus AWS credenciales. En el siguiente ejemplo ofrecemos un método sencillo y directo. En el método de cliente siguiente se utiliza para realizar todas las llamadas a la API subsiguientes:

   ```
   private static AmazonQuickSight getClient() {
   	final AWSCredentialsProvider credsProvider = new AWSCredentialsProvider() {
   	@Override
   	public AWSCredentials getCredentials() {
   	// provide actual IAM access key and secret key here
   	return new BasicAWSCredentials("access-key", "secret-key");
   	}
   	
   	@Override
   	public void refresh() {}
   	};
   	
   	return AmazonQuickSightClientBuilder
   	.standard()
   	.withRegion(Regions.US_EAST_1.getName())
   	.withCredentials(credsProvider)
   	.build();
   	}
   ```

1. Ahora, podemos usar el cliente anterior para enumerar todos los usuarios de nuestra cuenta de Amazon Quick Sight. 
**nota**  
Debe proporcionar el ID de AWS cuenta que utilizó para suscribirse a Amazon Quick Sight. Debe coincidir con el ID de AWS cuenta de la identidad de la persona que llama. Actualmente no se admiten las llamadas entre cuentas. Además, el parámetro requerido siempre `namespace` debe estar establecido en. *default* 

   ```
   getClient().listUsers(new ListUsersRequest()
           .withAwsAccountId("relevant_AWS_account_ID")
           .withNamespace("default"))
           .getUserList().forEach(user -> {
               System.out.println(user.getArn());
           });
   ```

1. Para ver una lista de todas las operaciones de API posibles y los objetos de solicitud que utilizan, puede **hacer clic con la tecla Ctrl** en el objeto de cliente de su IDE para ver la interfaz de Amazon Quick Sight. Como alternativa, búsquelo dentro del `com.amazonaws.services.quicksight` paquete en el archivo JavaClient JAR de Amazon Quick Sight.

------
#### [ JavaScript (Node.js) SDK ]

Utilice el siguiente procedimiento para interactuar con Amazon Quick Sight mediante Node.js. 

1. Configure el entorno del nodo con los comandos siguientes:
   + `npm install aws-sdk`
   + `npm install aws4 `
   + `npm install request`
   + `npm install url`

1. Para obtener información sobre cómo configurar el Node.js con el AWS SDK y configurar sus credenciales, consulte --> la [Guía para AWS SDK para JavaScript desarrolladores del SDK v2](https://docs.aws.amazon.com/sdk-for-javascript/v2/developer-guide/welcome.html). 

1. Utilice el ejemplo de código siguiente para comprobar la configuración. HTTPS es obligatorio. El ejemplo muestra una lista completa de las operaciones de Amazon Quick Sight junto con sus parámetros de solicitud de URL, seguida de una lista de los usuarios de Amazon Quick Sight de su cuenta.

   ```
   const AWS = require('aws-sdk');
   const https = require('https');
   
   var quicksight = new AWS.Service({
       apiConfig: require('./quicksight-2018-04-01.min.json'),
       region: 'us-east-1',
   });
   
   console.log(quicksight.config.apiConfig.operations);
   
   quicksight.listUsers({
       // Enter your actual AWS account ID
       'AwsAccountId': 'relevant_AWS_account_ID', 
       'Namespace': 'default',
   }, function(err, data) {
       console.log('---');
       console.log('Errors: ');
       console.log(err);
       console.log('---');
       console.log('Response: ');
       console.log(data);
   });
   ```

------
#### [ Python3 SDK ]

Utilice el siguiente procedimiento para crear un `botocore` paquete personalizado para interactuar con Amazon Quick Sight. 

1. Cree un archivo de credenciales en el AWS directorio de su entorno. En un Linux/Mac-based environment, that file is called \$1/.aws/credentials y tiene este aspecto:

   ```
   [default]
   aws_access_key_id = Your_IAM_access_key
   aws_secret_access_key = Your_IAM_secret_key
   ```

1. Descomprima la carpeta `botocore-1.12.10`. Cambie el directorio a `botocore-1.12.10` y escriba el nombre del entorno del intérprete Python3.

1. Las respuestas volverán como un objeto de diccionario. Cada uno de ellos tiene una `ResponseMetadata` entrada que contiene el estado de la solicitud IDs y la respuesta. Las demás entradas dependen del tipo de operación que ejecute.

1. El ejemplo siguiente es una aplicación de muestra que primero crea, elimina y muestra grupos. A continuación muestra una lista de los usuarios de una cuenta de Quicksight:

   ```
   import botocore.session
   default_namespace = 'default'
   account_id = 'relevant_AWS_Account'
   
   session = botocore.session.get_session()
   client = session.create_client("quicksight", region_name='us-east-1')
   
   print('Creating three groups: ')
   client.create_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup1')
   client.create_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup2')
   client.create_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup3')
   
   print('Retrieving the groups and listing them: ')
   response = client.list_groups(AwsAccountId = account_id, Namespace=default_namespace)
   for group in response['GroupList']:
       print(group)
   
   print('Deleting our groups: ')
   client.delete_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup1')
   client.delete_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup2')
   client.delete_group(AwsAccountId = account_id, Namespace=default_namespace, GroupName='MyGroup3')
   
   response = client.list_users(AwsAccountId = account_id, Namespace=default_namespace)
   for user in response['UserList']:
       print(user)
   ```

------
#### [ .NET/C\$1 SDK ]

Utilice el siguiente procedimiento para interactuar con Amazon Quick Sight mediante C\$1.NET. En este ejemplo se basa en Microsoft Visual para Mac. Las instrucciones pueden variar ligeramente dependiendo del IDE y la plataforma. Sin embargo, deberían ser muy similares.



1. Descomprima el archivo `nuget.zip` en una carpeta llamada `nuget`.

1. Cree un nuevo proyecto **Aplicación de consola** en Visual Studio.

1. Dentro de la solución, busque las **Dependencias** de la aplicación y, a continuación, abra el menú contextual (clic con el botón derecho) y elija **Agregar paquetes**.

1. En la lista de orígenes, elija **Configurar orígenes**.

1. Elija **Agregar** y asigne al origen el nombre `QuickSightSDK`. Navegue hasta la carpeta `nuget` y elija **Agregar origen**.

1. Seleccione **Aceptar**. Luego, con la `QuickSightSDK` opción seleccionada, selecciona los tres paquetes de Amazon Quick Sight:
   + `AWSSDK.QuickSight`
   + `AWSSDK.Extensions.NETCore.Setup`
   + `AWSSDK.Extensions.CognitoAuthentication`

1. Haga clic en **Agregar paquete**. 

1. Copie y pegue la siguiente aplicación de ejemplo en el editor de aplicaciones de la consola.

   ```
   using System;
   using Amazon.QuickSight.Model;
   using Amazon.QuickSight;
   
   namespace DotNetQuickSightSDKTest
   {
       class Program
       {
           private static readonly string AccessKey = "insert_your_access_key";
           private static readonly string SecretAccessKey = "insert_your_secret_key";
           private static readonly string AccountID = "AWS_account_ID";
           private static readonly string Namespace = "default";  // leave this as default
   
           static void Main(string[] args)
           {
               var client = new AmazonQuickSightClient(
                   AccessKey,
                   SecretAccessKey, 
                   Amazon.RegionEndpoint.USEast1);
   
               var listUsersRequest = new ListUsersRequest
               {
                   AwsAccountId = AccountID,
                   Namespace = Namespace
               };
   
               client.ListUsersAsync(listUsersRequest).Result.UserList.ForEach(
                   user => Console.WriteLine(user.Arn)
               );
   
               var listGroupsRequest = new ListGroupsRequest
               {
                   AwsAccountId = AccountID,
                   Namespace = Namespace
               };
   
               client.ListGroupsAsync(listGroupsRequest).Result.GroupList.ForEach(
                   group => Console.WriteLine(group.Arn)
               );
           }
       }
   }
   ```

------

# Integración de eventos de Amazon Quick Sight
<a name="events-integration"></a>

Con Amazon EventBridge, puedes responder automáticamente a los eventos de Amazon Quick Sight, como la creación de un nuevo panel de control o las actualizaciones. Estos eventos se envían casi EventBridge en tiempo real. Como desarrollador, puede crear reglas sencillas para indicar qué eventos le resultan de interés, así como las acciones que deben llebarse a cabo cuando un evento cumple una de las reglas. Al utilizar los eventos, puede completar casos de uso, como la implementación y las copias de seguridad continuas.

**Topics**
+ [Eventos admitidos](#events-supported)
+ [Ejemplo de carga útil de evento](#sample-events-payload)
+ [Crear reglas para enviar eventos de Amazon Quick Sight a Amazon CloudWatch](events-send-cloudwatch.md)
+ [Crear reglas para enviar eventos de Amazon Quick Sight a AWS Lambda](events-send-lambda.md)

## Eventos admitidos
<a name="events-supported"></a>

Amazon Quick Sight admite actualmente los siguientes eventos.


| Tipo de activo | Action | Tipo de detalle del evento | Detalles del evento | 
| --- | --- | --- | --- | 
| Panel de control | Crear | La creación del Amazon Quick Sight Dashboard se ha realizado correctamente | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1<br />}</pre> | 
| Panel de control | Crear | Falló la creación del panel de Amazon Quick Sight | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1,<br />    "errors": [<br />      {<br />        "Type": "PARAMETER_NOT_FOUND",<br />        "Message": "Missing property abc"<br />      },<br />      {<br />        "Type": "DATA_SET_NOT_FOUND",<br />        "Message": "Cannot find dataset with id abc"<br />      }<br />    ]<br />}</pre> | 
| Panel de control | Crear | Se actualizaron los permisos del panel de control de Amazon Quick Sight | <pre>{"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83" }</pre> | 
| Panel de control | Actualización | La actualización del panel de Amazon Quick Sight se ha realizado correctamente | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1<br />}</pre> | 
| Panel de control | Actualización | Falló la actualización del panel de control de Amazon Quick Sight | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1,<br />    "errors": [<br />      {<br />        "Type": "PARAMETER_NOT_FOUND",<br />        "Message": "Missing property abc"<br />      },<br />      {<br />        "Type": "DATA_SET_NOT_FOUND",<br />        "Message": "Cannot find dataset with id abc"<br />      }<br />    ]<br />}</pre> | 
| Panel de control | Actualización | Se actualizaron los permisos del panel de control de Amazon Quick Sight | <pre>{"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"}</pre> | 
| Panel de control | Publish | Actualización de la versión publicada de Amazon Quick Sight Dashboard | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 2<br />}</pre> | 
| Panel de control | Eliminar | Eliminado el panel de Amazon Quick Sight | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"<br />}</pre> | 
| Análisis | Crear | La creación de Amazon Quick Sight Analysis se ha realizado correctamente | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"<br />}</pre> | 
| Análisis | Crear | Falló la creación de Amazon Quick Sight Analysis | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5",<br />    "errors": [<br />      {<br />        "Type": "PARAMETER_NOT_FOUND",<br />        "Message": "Missing property abc"<br />      },<br />      {<br />        "Type": "DATA_SET_NOT_FOUND",<br />        "Message": "Cannot find dataset with id abc"<br />      }<br />    ]<br />}</pre> | 
| Análisis | Crear | Actualización de los permisos de Amazon Quick Sight Analysis | <pre>{"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" }</pre> | 
| Análisis | Eliminar | Eliminado el análisis Quick Sight de Amazon | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"<br />}</pre> | 
| Análisis | Actualización | La actualización de Amazon Quick Sight Analysis se ha realizado correctamente | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"<br />}</pre> | 
| Análisis | Actualización | Falló la actualización de Amazon Quick Sight Analysis | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5",    <br />    "errors": [        <br />        {            <br />            "Type": "PARAMETER_NOT_FOUND",            <br />            "Message": "Missing property abc"        <br />        },        <br />        {             <br />            "Type": "DATA_SET_NOT_FOUND",            <br />            "Message": "Cannot find dataset with id abc"        <br />        }    <br />    ]<br />}</pre> | 
| Análisis | Actualización | Actualización de los permisos de Amazon Quick Sight Analysis | <pre>{"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" }</pre> | 
| Conexión a VPC | Crear | La conexión VPC de Amazon Quick Sight se ha creado correctamente | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "CREATION_SUCCESSFUL"<br />}</pre> | 
| Conexión a VPC | Crear | Falló la creación de la conexión de VPC de Amazon Quick Sight | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "CREATION_FAILED"<br />}</pre> | 
| Conexión a VPC | Actualización | La actualización de la conexión a la VPC de Amazon Quick Sight se ha realizado correctamente | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "UPDATE_SUCCESSFUL"<br />}</pre> | 
| Conexión a VPC | Actualización | Falló la actualización de la conexión a la VPC de Amazon Quick Sight | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "UPDATE_FAILED"<br />}</pre> | 
| Conexión a VPC | Eliminar | La conexión de VPC de Amazon Quick Sight se ha eliminado correctamente | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "DELETED"<br />}</pre> | 
| Conexión a VPC | Eliminar | Falló la eliminación de la conexión de VPC de Amazon Quick Sight | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "DELETION_FAILED"<br />}</pre> | 
| Folder | Crear | Se creó la carpeta Amazon Quick Sight | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",<br />    "parentFolderArn": "arn:aws:quicksight:us-east-1:123456789012:folder/098765432134"<br />}</pre> | 
| Folder | Crear | Se actualizaron los permisos de las carpetas de Amazon Quick Sight | <pre>{"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" }</pre> | 
| Folder | Actualización | Carpeta Amazon Quick Sight actualizada | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"<br />}</pre> | 
| Folder | Actualización | Se actualizaron los permisos de las carpetas de Amazon Quick Sight | <pre>{"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" }</pre> | 
| Folder | Eliminar | Carpeta Amazon Quick Sight eliminada | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"<br />}</pre> | 
| Folder | Actualización de membresía | Actualización de la membresía de Amazon Quick Sight Folder | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",<br />    "membersAdded": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],<br />    "membersRemoved": []<br />}</pre> | 
| Conjunto de datos | Crear | Se creó el conjunto de datos Amazon Quick Sight | <pre>{<br />    "datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"<br />}</pre> | 
| Conjunto de datos | Crear | Se actualizaron los permisos del conjunto de datos de Amazon Quick Sight | <pre>{"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" }</pre> | 
| Conjunto de datos | Actualización | Actualización del conjunto de datos Amazon Quick Sight | <pre>{<br />    "datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"<br />}</pre> | 
| Conjunto de datos | Actualización | Se actualizaron los permisos del conjunto de datos de Amazon Quick Sight | <pre>{"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" }</pre> | 
| Conjunto de datos | Eliminar | Se ha eliminado el conjunto de datos de Amazon Quick Sight | <pre>{<br />    "datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"<br />}</pre> | 
| DataSource | Crear | La DataSource creación de Amazon Quick Sight se ha realizado correctamente | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"<br />}</pre> | 
| DataSource | Crear | Falló la DataSource creación de Amazon Quick Sight | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824",<br />    "error": {<br />        "message": "AMAZON_ELASTICSEARCH engine version 7.4 is lower than minimum supported version 7.7",<br />        "type": "ENGINE_VERSION_NOT_SUPPORTED"<br />    }<br />}</pre> | 
| DataSource | Crear |  DataSource Permisos de Amazon Quick Sight actualizados | <pre>{"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" }</pre> | 
| DataSource | Actualización | La DataSource actualización de Amazon Quick Sight se ha realizado correctamente | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"<br />}</pre> | 
| DataSource | Actualización | Falló la DataSource actualización de Amazon Quick Sight | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824",<br />    "error": {<br />        "message": "AMAZON_ELASTICSEARCH engine version 7.4 is lower than minimum supported version 7.7",<br />        "type": "ENGINE_VERSION_NOT_SUPPORTED"<br />    }<br />}</pre> | 
| DataSource | Actualización |  DataSource Permisos de Amazon Quick Sight actualizados | <pre>{"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" }</pre> | 
| DataSource | Eliminar | Amazon Quick Sight DataSource eliminado | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"<br />}</pre> | 
| Theme | Crear | Creación exitosa del tema Amazon Quick Sight | <pre>{<br />    ""themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83", <br />    "versionNumber": 1"<br />}</pre> | 
| Theme | Crear | Falló la creación del tema Amazon Quick Sight | <pre>{ <br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83", <br />    "versionNumber": 1<br />}</pre> | 
| Theme | Crear | Se actualizaron los permisos del tema Amazon Quick Sight | <pre>{"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" }</pre> | 
| Theme | Actualización | La actualización del tema Amazon Quick Sight se ha realizado correctamente | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "versionNumber": 2<br />}</pre> | 
| Theme | Actualización | Falló la actualización del tema Amazon Quick Sight | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "versionNumber": 2<br />}</pre> | 
| Theme | Actualización | Se actualizaron los permisos del tema Amazon Quick Sight | <pre>{"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" }</pre> | 
| Theme | Eliminar | Tema Amazon Quick Sight eliminado | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83"<br />}</pre> | 
| Theme | Creación de alias | Se creó el alias del tema Amazon Quick Sight | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "aliasName": "MyThemeAlias"    <br />    "versionNumber": 2<br />}</pre> | 
| Theme | Actualización de alias | Alias de Amazon Quick Sight actualizado | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "aliasName": "MyThemeAlias"    <br />    "versionNumber": 4<br />}</pre> | 
| Theme | Eliminación de alias | Alias del tema Amazon Quick Sight eliminado | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "aliasName": "MyThemeAlias"    <br />    "versionNumber": 2<br />}</pre> | 

## Ejemplo de carga útil de evento
<a name="sample-events-payload"></a>

Todos los eventos siguen la [estructura de EventBridge objetos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) estándar. El campo de detalles es un objeto JSON que contiene más información sobre el evento.

```
{
  "version": "0",
  "id": "3acb26c8-397c-4c89-a80a-ce672a864c55",
  "detail-type": "QuickSight Dashboard Creation Successful",
  "source": "aws.quicksight",
  "account": "123456789012",
  "time": "2023-10-30T22:06:31Z",
  "region": "us-east-1",
  "resources": ["arn:aws:quicksight:us-east-1:123456789012:dashboard/6fdbc328-ebbd-457f-aa02-9780173afc83"],
  "detail": {
    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
    "versionNumber": 1
  }
}
```

# Crear reglas para enviar eventos de Amazon Quick Sight a Amazon CloudWatch
<a name="events-send-cloudwatch"></a>

Puede escribir reglas sencillas para indicar qué eventos de Amazon Quick Sight le interesan y qué acciones automatizadas debe realizar cuando un evento coincide con una regla. Por ejemplo, puede configurar Amazon Quick Sight para enviar eventos a Amazon CloudWatch siempre que se coloque un activo de Amazon Quick Sight en una carpeta. Para obtener más información, consulta la [guía del EventBridge usuario de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html).

1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).

1. En el panel de navegación, en **Events (Eventos)**, elija **Rules (Reglas)**.

1. Elija **Creación de regla**.

1. Escriba un nombre y una descripción para la regla. El nombre de la regla debe ser exclusivo dentro de esta región. Por ejemplo, escriba `QuickSightAssetChangeRuleCloudWatch`.

1. Elija el bus de eventos **predeterminado**.

1. Elija **Rule with an event pattern (Regla con un patrón de evento)** y, a continuación, elija **Next (Siguiente)**.

1. **En Origen del evento**, selecciona **AWS eventos o eventos EventBridge asociados**.

1. En la sección **Método de creación**, elija **Patrón personalizado (editor JSON)**.

1. En el cuadro de texto **Patrón de eventos**, ingrese el siguiente fragmento y elija **Siguiente**.

   ```
   {
     "source": ["aws.quicksight"]
   }
   ```

   Como alternativa, puede crear la regla que solo se suscriba a un subconjunto de tipos de eventos en Amazon Quick Sight. Por ejemplo, la siguiente regla solo se activará cuando se agregue o elimine un activo desde una carpeta con un identificador `77e307e8-b41b-472a-90e8-fe3f471537be`.

   ```
   {
     "source": ["aws.quicksight"],
     "detail-type": ["QuickSight Folder Membership Updated"],
     "detail": {
       "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
     }
   }
   ```

1. En **Targets**, selecciona **AWS servicio > grupo de CloudWatch ** **registros**.

1. Elija un grupo de registro existente o cree uno nuevo. Para ello, ingrese el nombre del nuevo grupo de registro.

1. Si lo desea, puede agregar otro destino para esta regla.

1. En **Configure tags (Configurar etiquetas)**, elija **Next (Siguiente)**.

1. Seleccione **Creación de regla**.

Para obtener más información, consulta [Cómo crear una EventBridge regla de Amazon que reaccione a los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la guía del EventBridge usuario de Amazon.

# Crear reglas para enviar eventos de Amazon Quick Sight a AWS Lambda
<a name="events-send-lambda"></a>

En este tutorial, creará una AWS Lambda función que registre los eventos de los activos en la cuenta de Amazon Quick Sight. A continuación, podrá crear una regla que ejecute la función cuando se produzca un cambio de activo. En este tutorial se da por sentado que ya te has registrado en Amazon Quick Sight.

**Paso 1: Crea una Lambda función**

Cree una función Lambda para registrar los eventos de cambio de estado. Especifique esta función cuando cree la regla.

1. Inicie sesión en Consola de administración de AWS y abra la AWS Lambda consola en [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Si es la primera vez que utiliza Lambda, aparecerá una página de bienvenida. Seleccione **Get Started Now**. De lo contrario, seleccione **Create function (Crear función)**.

1. Elija **Author from scratch**.

1. En la página Crear función, escriba un nombre y una descripción para la función de Lambda. Por ejemplo, asigne un nombre a la función `QuickSightAssetChangeFn`.

1. En **Tiempo de ejecución**, seleccione **Node.js 18x**.

1. En **Arquitectura**, elija **x86\$164**.

1. En **Rol de ejecución**, elija **Crear un nuevo rol con permisos básicos de Lambda** o **Usar un rol existente** y elija el rol que desee.

1. Seleccione **Creación de función**.

1. En la **QuickSightAssetChange**página, selecciona **index.js**.

1. En el panel de**index.js**, elimine el código existente.

1. Escriba el siguiente fragmento de código.

   ```
   console.log('Loading function');
   exports.handler = async (event, context) => {
     console.log('Received QuickSight event:', JSON.stringify(event));
   };
   ```

1. Elija **Deploy (Implementar)**.

**Paso 2: Crear una regla**

Cree una regla para ejecutar la función Lambda siempre que utilice un activo de create/update/delete Amazon Quick Sight.

1. Inicia sesión en la EventBridge consola de Amazon Consola de administración de AWS y ábrela en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. En el panel de navegación, seleccione **Reglas**.

1. Elija **Creación de regla**.

1. Escriba un nombre y una descripción de la regla. Por ejemplo, escriba `QuickSightAssetChangeRule`.

1. Seleccione el bus de eventos **predeterminado**.

1. Elija **Rule with an event pattern (Regla con un patrón de evento)** y, a continuación, elija **Next (Siguiente)**.

1. **En Origen del evento**, selecciona **AWS eventos o eventos EventBridge asociados**.

1. En la sección **Método de creación**, elija **Patrón personalizado (editor JSON)**.

1. En el cuadro de texto **Patrón de eventos**, ingrese el siguiente fragmento y elija **Siguiente**.

   ```
   {
     "source": ["aws.quicksight"]
   }
   ```

   Como alternativa, puede crear la regla que solo se suscriba a un subconjunto de tipos de eventos en Amazon Quick Sight. Por ejemplo, la siguiente regla solo se activará cuando se agregue o elimine un activo desde una carpeta con un identificador `77e307e8-b41b-472a-90e8-fe3f471537be`.

   ```
   {
     "source": ["aws.quicksight"],
     "detail-type": ["QuickSight Folder Membership Updated"],
     "detail": {
       "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
     }
   }
   ```

1. En **Tipos de destino**, elija **Servicio de AWS ** y **Función de Lambda**.

1. En **Function (Función)**, seleccione la función Lambda que ha creado. A continuación, elija **Siguiente**.

1. En **Configure tags (Configurar etiquetas)**, elija **Next (Siguiente)**.

1. Revise los pasos de la regla. A continuación, elija **Create rule (Crear regla)**.

**Paso 3: Probar la regla**

Para probar la regla, cree un análisis. Después de esperar un minuto, compruebe que se haya invocado la función de Lambda.

1. Abra la consola Amazon Quick Sight en [https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).

1. Cree un nuevo análisis.

1. En el panel de navegación, elija **Rules (Reglas)** y elija el nombre de la regla que ha creado.

1. En **Detalles de la regla**, seleccione **Monitoreo**.

1. Se te redirigirá a la CloudWatch consola de Amazon. Si no se te redirige, selecciona **Ver las métricas en CloudWatch**.

1. En **All metrics (Todas las métricas)**, elija el nombre de la regla que creó. El gráfico indica que se ha invocado la regla.

1. En el panel de navegación, seleccione **Grupos de registro**.

1. Elija el nombre del grupo de registro para la función de Lambda. Por ejemplo, `/aws/lambda/function-name`.

1. Elija el nombre del flujo de registro para ver los datos proporcionados por la función para la instancia que ha lanzado. Debería recibir un resultado similar al siguiente:

   ```
   {
     "version": "0",
     "id": "3acb26c8-397c-4c89-a80a-ce672a864c55",
     "detail-type": "QuickSight Analysis Creation Successful",
     "source": "aws.quicksight",
     "account": "123456789012",
     "time": "2023-10-30T22:06:31Z",
     "region": "us-east-1",
     "resources": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
     "detail": {
       "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
     }
   }
   ```

Para ver un ejemplo de un evento de Amazon Quick Sight en formato JSON, consulte [Descripción general de los eventos de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/events.html).

# Análisis integrados para Amazon Quick Sight
<a name="embedded-analytics"></a>

**importante**  
Amazon Quick Sight tiene nuevas operaciones de API para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando las operaciones `GetDashboardEmbedUrl` y las de la `GetSessionEmbedUrl` API para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener más información sobre la integración mediante las antiguas operaciones de la API, consulte [Integración de análisis mediante las operaciones de la API GetDashboardEmbedURL y GetSessionEmbedURL](embedded-analytics-deprecated.md).


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Con los análisis integrados de Amazon Quick Sight, puede integrar sin problemas experiencias basadas en datos en sus aplicaciones de software. Puede diseñar los componentes integrados para que se adapten a su marca. Esta capacidad lleva la potencia de Amazon Quick Sight a sus usuarios finales, donde pueden analizar los datos e interactuar con ellos sin tener que salir de la aplicación. La mejora de la experiencia del usuario mediante la reducción de la complejidad cognitiva ofrece a los usuarios una mejor oportunidad de lograr una mayor comprensión y eficacia. 

Amazon Quick Sight admite la incrustación de los siguientes elementos: 
+ Consola Amazon Quick Sight (experiencia de creación completa para usuarios registrados)
+ Imágenes y paneles de control de Amazon Quick Sight (para usuarios registrados, usuarios anónimos y usuarios finales públicos)
+ Barra de búsqueda Amazon Quick Sight Q (para usuarios registrados y usuarios anónimos)

Con una consola Amazon Quick Sight integrada, incorporas la experiencia completa de Amazon Quick Sight. De este modo, podrá utilizar las herramientas de creación de Amazon Quick Sight como parte de su aplicación, en lugar de hacerlo en el contexto del sitio web Consola de administración de AWS o de un sitio web independiente. Los usuarios de una consola Amazon Quick Sight integrada deben estar registrados como autores o administradores de Amazon Quick Sight en su Cuenta de AWS. También deben autenticarse en el mismo Cuenta de AWS, mediante cualquiera de los métodos de autenticación compatibles con Amazon Quick Sight. 

Con un panel de control o imagen de Amazon Quick Sight integrado, los lectores obtienen la misma funcionalidad e interactividad que en un panel de control o imagen publicado. Para usar un panel o un elemento visual integrado, los lectores (espectadores) pueden incluir cualquiera de los siguientes elementos:
+ Los usuarios de Amazon Quick Sight se autenticaron en usted Cuenta de AWS mediante cualquier método compatible con Amazon Quick Sight.
+ Visitantes no autenticados de un sitio web o una aplicación: esta opción requiere paquetes de sesiones con un precio por capacidad. Para obtener información sobre los tipos de suscripción, consulte [Descripción de las suscripciones y funciones de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/user-types.html#subscription-role-mapping).
+ Varios usuarios finales visualizan una pantalla en monitores o pantallas grandes mediante acceso programático.

Si tu aplicación también reside en AWS, no es necesario que resida en el mismo Cuenta de AWS lugar que la suscripción a Amazon Quick Sight. Sin embargo, la aplicación debe poder asumir la función AWS Identity and Access Management (IAM) que utilizas para las llamadas a la API. 

Antes de poder incrustar contenido, asegúrese de utilizar la edición Amazon Quick Sight Enterprise en el Cuenta de AWS lugar donde vaya a utilizar la incrustación. 

La incrustación de Amazon Quick Sight está disponible en todas las versiones compatibles Regiones de AWS. 

**Topics**
+ [Integración de los análisis de Amazon Quick Sight en sus aplicaciones](embedding-overview.md)
+ [Incrustar activos personalizados de Amazon Quick Sight en su aplicación](customize-and-personalize-embedded-analytics.md)
+ [Incrustar imágenes y paneles de Amazon Quick Sight con un código de inserción de 1 clic](1-click-embedding.md)
+ [Integración con Amazon Quick Sight APIs](embedded-analytics-api.md)

# Integración de los análisis de Amazon Quick Sight en sus aplicaciones
<a name="embedding-overview"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

Para incrustar los análisis, puede ejecutar la API de incrustación de Amazon Quick Sight para generar el código de inserción. Como alternativa, en el caso de los paneles, puede copiar un código de inserción al compartir el panel en Amazon Quick Sight. Cada opción se describe a continuación.

## Incrustación en un clic para usuarios registrados
<a name="embedding-overview-1-click"></a>

Cuando comparte un panel con usuarios registrados en su cuenta, puede copiar un código de integración para el panel y pegarlo en el HTML de su aplicación interna. 

El uso de la incrustación empresarial con 1 clic es la mejor opción si quieres incrustar un panel de Amazon Quick Sight en una aplicación interna en la que los usuarios necesitan autenticarse. Al copiar el código de integración, se obtiene un código de inserción estático que no cambia.

Para obtener más información, consulte [Incrustar imágenes y paneles de Amazon Quick Sight para usuarios registrados con un código de inserción de 1 clic](embedded-analytics-1-click.md).

## Integración con Amazon Quick Sight APIs
<a name="embedding-overview-api"></a>

La integración con la API de Amazon Quick Sight es la mejor opción si desea integrar la experiencia de Amazon Quick Sight en una aplicación interna en la que los usuarios deben autenticarse o en una aplicación externa a la que cualquiera pueda acceder. Cuando se utilizan las operaciones de la API de integración para generar un código de integraciónn, se obtiene un código de un solo uso.

Para obtener más información, consulte [Integración con Amazon Quick Sight APIs](embedded-analytics-api.md).

# Incrustar activos personalizados de Amazon Quick Sight en su aplicación
<a name="customize-and-personalize-embedded-analytics"></a>

Puede utilizar los análisis integrados de Amazon Quick Sight para integrar en su aplicación activos personalizados de Amazon Quick Sight que se adapten a las necesidades de su empresa. Para los cuadros de mando y los elementos visuales integrados, los autores de Amazon Quick Sight pueden añadir filtros y desgloses a los que los lectores pueden acceder mientras navegan por el panel o el elemento visual. Los desarrolladores de Amazon Quick Sight también pueden utilizar Amazon Quick Sight SDKs para crear integraciones más estrechas entre sus aplicaciones SaaS y sus activos integrados de Amazon Quick Sight para añadir acciones de devolución de llamadas a puntos de datos a las imágenes de un panel de control durante el tiempo de ejecución.

Para obtener más información sobre Amazon Quick Sight SDKs, consulte `amazon-quicksight-embedding-sdk` on [GitHub](https://github.com/awslabs/amazon-quicksight-embedding-sdk)o [NPM.](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk)

A continuación, encontrará descripciones sobre cómo utilizar Amazon Quick Sight SDKs para personalizar los análisis integrados de Amazon Quick Sight.

**Topics**
+ [Añadir acciones de devolución de llamada integradas en tiempo de ejecución en Amazon Quick Sight](embedding-custom-actions-callback.md)
+ [Filtrado de datos en tiempo de ejecución para paneles e imágenes integrados de Amazon Quick Sight](embedding-runtime-filtering.md)
+ [Personalice la apariencia de los paneles y elementos visuales integrados de Amazon Quick Sight](embedding-runtime-theming.md)
+ [Uso del SDK de incrustación de Amazon Quick Sight para permitir enlaces compartibles a vistas de paneles integradas](embedded-view-sharing.md)

# Añadir acciones de devolución de llamada integradas en tiempo de ejecución en Amazon Quick Sight
<a name="embedding-custom-actions-callback"></a>

Utilice acciones de devolución de llamadas de puntos de datos integradas para crear integraciones más estrechas entre su aplicación de software como servicio (SaaS) y sus paneles y elementos visuales integrados de Amazon Quick Sight. Los desarrolladores pueden registrar puntos de datos para recuperarlos con el SDK de incrustación de Amazon Quick Sight. Al registrar una acción de devolución de llamada para un elemento visual, los lectores pueden seleccionar un punto de datos del elemento visual para recibir una devolución de llamada que proporcione datos específicos del punto de datos seleccionado. Esta información se puede usar para marcar registros clave, compilar datos sin procesar específicos del punto de datos, capturar registros y compilar datos para los procesos de backend.

No se admiten las llamadas integradas en el contenido del elemento visual personalizado, los cuadros de texto o información.

Antes de empezar a registrar los puntos de datos para la devolución de llamadas, actualice el SDK de integración a la versión 2.3.0. Para obtener más información sobre el uso del SDK de incrustación de Amazon Quick Sight, consulte [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)la GitHub

Se puede registrar una devolución de llamada a un punto de datos en uno o más elementos visuales en tiempo de ejecución mediante el SDK de Amazon Quick Sight. También puede registrar una devolución de llamada a un punto de datos para cualquier interacción compatible con la estructura de la API. [VisualCustomAction](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_VisualCustomAction.html) Esto permite que la devolución de llamada a los puntos de datos se inicie cuando el usuario selecciona el punto de datos en el elemento visual o cuando el punto de datos se selecciona en el menú contextual del punto de datos. En el siguiente ejemplo, se registra una devolución de llamada a un punto de datos que el lector inicia cuando selecciona un punto de datos en el elemento visual.

```
/const MY_GET_EMBED_URL_ENDPOINT =
  "https://my.api.endpoint.domain/MyGetEmbedUrlApi"; // Sample URL

// The dashboard id to embed
const MY_DASHBOARD_ID = "my-dashboard"; // Sample ID

// The container element in your page that will have the embedded dashboard
const MY_DASHBOARD_CONTAINER = "#experience-container"; // Sample ID

// SOME HELPERS

const ActionTrigger = {
  DATA_POINT_CLICK: "DATA_POINT_CLICK",
  DATA_POINT_MENU: "DATA_POINT_MENU",
};

const ActionStatus = {
  ENABLED: "ENABLED",
  DISABLED: "DISABLED",
};

// This function makes a request to your endpoint to obtain an embed url for a given dashboard id
// The example implementation below assumes the endpoint takes dashboardId as request data
// and returns an object with EmbedUrl property
const myGetEmbedUrl = async (dashboardId) => {
  const apiOptions = {
    dashboardId,
  };
  const apiUrl = new URL(MY_GET_EMBED_URL_ENDPOINT);
  apiUrl.search = new URLSearchParams(apiOptions).toString();
  const apiResponse = await fetch(apiUrl.toString());
  const apiResponseData = await apiResponse.json();
  return apiResponseData.EmbedUrl;
};

// This function constructs a custom action object
const myConstructCustomActionModel = (
  customActionId,
  actionName,
  actionTrigger,
  actionStatus
) => {
  return {
    Name: actionName,
    CustomActionId: customActionId,
    Status: actionStatus,
    Trigger: actionTrigger,
    ActionOperations: [
      {
        CallbackOperation: {
          EmbeddingMessage: {},
        },
      },
    ],
  };
};

// This function adds a custom action on the first visual of first sheet of the embedded dashboard
const myAddVisualActionOnFirstVisualOfFirstSheet = async (
  embeddedDashboard
) => {
  // 1. List the sheets on the dashboard
  const { SheetId } = (await embeddedDashboard.getSheets())[0];
  // If you'd like to add action on the current sheet instead, you can use getSelectedSheetId method
  // const SheetId = await embeddedDashboard.getSelectedSheetId();

  // 2. List the visuals on the specified sheet
  const { VisualId } = (await embeddedDashboard.getSheetVisuals(SheetId))[0];

  // 3. Add the custom action to the visual
  try {
    const customActionId = "custom_action_id"; // Sample ID
    const actionName = "Flag record"; // Sample name
    const actionTrigger = ActionTrigger.DATA_POINT_CLICK; // or ActionTrigger.DATA_POINT_MENU
    const actionStatus = ActionStatus.ENABLED;
    const myCustomAction = myConstructCustomActionModel(
      customActionId,
      actionName,
      actionTrigger,
      actionStatus
    );
    const response = await embeddedDashboard.addVisualActions(
      SheetId,
      VisualId,
      [myCustomAction]
    );
    if (!response.success) {
      console.log("Adding visual action failed", response.errorCode);
    }
  } catch (error) {
    console.log("Adding visual action failed", error);
  }
};

const parseDatapoint = (visualId, datapoint) => {
  datapoint.Columns.forEach((Column, index) => {
    // FIELD | METRIC
    const columnType = Object.keys(Column)[0];

    // STRING | DATE | INTEGER | DECIMAL
    const valueType = Object.keys(Column[columnType])[0];
    const { Column: columnMetadata } = Column[columnType][valueType];

    const value = datapoint.RawValues[index][valueType];
    const formattedValue = datapoint.FormattedValues[index];

    console.log(
      `Column: ${columnMetadata.ColumnName} has a raw value of ${value}
           and formatted value of ${formattedValue.Value} for visual: ${visualId}`
    );
  });
};

// This function is used to start a custom workflow after the end user selects a datapoint
const myCustomDatapointCallbackWorkflow = (callbackData) => {
  const { VisualId, Datapoints } = callbackData;

  parseDatapoint(VisualId, Datapoints);
};

// EMBEDDING THE DASHBOARD

const main = async () => {
  // 1. Get embed url
  let url;
  try {
    url = await myGetEmbedUrl(MY_DASHBOARD_ID);
  } catch (error) {
    console.log("Obtaining an embed url failed");
  }

  if (!url) {
    return;
  }

  // 2. Create embedding context
  const embeddingContext = await createEmbeddingContext();

  // 3. Embed the dashboard
  const embeddedDashboard = await embeddingContext.embedDashboard(
    {
      url,
      container: MY_DASHBOARD_CONTAINER,
      width: "1200px",
      height: "300px",
      resizeHeightOnSizeChangedEvent: true,
    },
    {
      onMessage: async (messageEvent) => {
        const { eventName, message } = messageEvent;
        switch (eventName) {
          case "CONTENT_LOADED": {
            await myAddVisualActionOnFirstVisualOfFirstSheet(embeddedDashboard);
            break;
          }
          case "CALLBACK_OPERATION_INVOKED": {
            myCustomDatapointCallbackWorkflow(message);
            break;
          }
        }
      },
    }
  );
};

main().catch(console.error);
```

También puede configurar el ejemplo anterior para que inicie la devolución de llamada a los puntos de datos cuando el usuario abra el menú contextual. Para hacer esto con el ejemplo anterior, defina el valor de `actionTrigger` en `ActionTrigger.DATA_POINT_MENU`.

Una vez registrada la devolución de llamada a un punto de datos, se aplica a la mayoría de los puntos de datos de los elementos visuales especificados. Las devoluciones de llamadas no se aplican a los totales ni a los subtotales de los elementos visuales. Cuando un lector interactúa con un punto de datos, se `CALLBACK_OPERATION_INVOKED` envía un mensaje al SDK de incrustación de Amazon Quick Sight. El controlador `onMessage` captura este mensaje. El mensaje contiene los valores sin procesar y mostrar de toda la fila de datos asociada al punto de datos seleccionado. También contiene los metadatos de todas las columnas del elemento visual en la que se encuentra el punto de datos. A continuación se muestra un ejemplo de un mensaje `CALLBACK_OPERATION_INVOKED`.

```
{
   CustomActionId: "custom_action_id",
   DashboardId: "dashboard_id",
   SheetId: "sheet_id",
   VisualId: "visual_id",
   DataPoints: [
        {
            RawValues: [
                    {
                        String: "Texas" // 1st raw value in row
                    },
                    {
                        Integer: 1000 // 2nd raw value in row
                    }
            ],
            FormattedValues: [
                    {Value: "Texas"}, // 1st formatted value in row
                    {Value: "1,000"} // 2nd formatted value in row
            ],
            Columns: [
                    { // 1st column metadata
                        Dimension: {
                            String: {
                                Column: {
                                    ColumnName: "State",
                                    DatsetIdentifier: "..."
                                }
                            }
                        }
                    },
                    { // 2nd column metadata
                        Measure: {
                            Integer: {
                                Column: {
                                    ColumnName: "Cancelled",
                                    DatsetIdentifier: "..."
                                },
                                AggregationFunction: {
                                    SimpleNumericalAggregation: "SUM"
                                }
                            }
                        }
                    }
            ]
        }
   ]
}
```

# Filtrado de datos en tiempo de ejecución para paneles e imágenes integrados de Amazon Quick Sight
<a name="embedding-runtime-filtering"></a>

Puede utilizar los métodos de filtrado del SDK de incrustación de Amazon Quick Sight para aprovechar la potencia de los filtros de Amazon Quick Sight en su aplicación de software como servicio (SaaS) en tiempo de ejecución. Los filtros de tiempo de ejecución permiten a los propietarios de empresas integrar su aplicación con sus paneles y elementos visuales integrados de Amazon Quick Sight. Para ello, cree controles de filtro personalizados en su aplicación y aplique valores predeterminados de filtros en función de los datos de su aplicación. De este modo, los desarrolladores pueden personalizar las configuraciones de los filtros para los usuarios finales en tiempo de ejecución.

Los desarrolladores pueden crear, consultar, actualizar y eliminar los filtros de Amazon Quick Sight en un panel integrado o en un elemento visual de su aplicación con el SDK de incrustación de Amazon Quick Sight. Cree objetos de filtrado de Amazon Quick Sight en su aplicación con el modelo de [FilterGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_FilterGroup.html)datos y aplíquelos a cuadros de mando e imágenes integrados mediante los métodos de filtrado. Para obtener más información sobre el uso del SDK de incrustación de Amazon Quick Sight, consulte [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)la GitHub

**Requisitos previos**

Antes de empezar, asegúrese de utilizar la versión 2.5.0 o superior del SDK de incrustación de Amazon Quick Sight.

## Terminología y conceptos
<a name="runtime-filtering-terminology"></a>

La siguiente terminología puede resultar útil cuando trabaje con el filtrado de tiempo de ejecución incrustado.
+ *Grupo de filtros*: grupo de filtros individuales. Los filtros que se encuentran dentro de un `FilterGroup` están conectados entre sí mediante el operador OR. Los filtros incluidos en a [FilterGroup](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_FilterGroup.html)se aplican a las mismas hojas o imágenes.
+ *Filtro*: un filtro único. El filtro puede ser de categoría, numérico o de fecha y hora. Para obtener más información sobre filtros, consulte [Filtro](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_Filter.html).

## Configuración
<a name="runtime-filtering-setup"></a>

Antes de comenzar, asegúrese de que tiene preparados los activos y la información que se indican a continuación.
+ El identificador de la hoja a la que desea aplicar el ámbito de `FilterGroup`. Esto se puede obtener con el método `getSheets` del SDK de incrustación.
+ El identificador de columna y el conjunto de datos del conjunto de datos que desea filtrar. Esto se puede obtener mediante la operación de la [DescribeDashboardDefinition](https://docs.aws.amazon.com/APIReference/API_DescribeDashboardDefinition.html)API.

  En función del tipo de columna que use, es posible que haya restricciones en cuanto a los tipos de filtro que se pueden agregar a un activo incrustado. Para obtener más información sobre las restricciones de los filtros, consulte [Filtrar](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_Filter.html).
+ El identificador visual del elemento visual al que desea aplicar el ámbito de `FilterGroup`, si corresponde. Esto se puede obtener al usar el método `getSheetVisuals` del SDK de incrustación.

  Además del método `getSheetVisuals`, el `FilterGroup` que agregue solo puede tener como ámbito la hoja actualmente seleccionada.

Para usar esta función, ya debe tener un panel de control o un elemento visual integrado en su aplicación a través del SDK de incrustación de Amazon Quick Sight. Para obtener más información sobre el uso del SDK de incrustación de Amazon Quick Sight, consulte [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)la GitHub

## Interfaz del método del SDK
<a name="runtime-filtering-sdk-interface"></a>

**Métodos getter de incrustación del panel**

En la siguiente tabla se describen los diferentes métodos getter de incrustación de panel que pueden usar los desarrolladores.


| Método | Description (Descripción) | 
| --- | --- | 
|  `getFilterGroupsForSheet(sheetId: string) `  |  Devuelve todo lo FilterGroups que se encuentra actualmente dentro del ámbito a la hoja que se proporciona en el parámetro.  | 
|  `getFilterGroupsForVisual(sheetId: string, visualId: string)`  |  Devuelve todos los `FilterGroups` que tienen como ámbito el elemento visual que se proporciona en el parámetro.  | 

Si la hoja que se proporciona en el parámetro no es la hoja actualmente seleccionada del panel incrustado, los métodos anteriores devolverán un error.

**Métodos getter de incrustación de elemento visual**

En la siguiente tabla se describen los diferentes métodos getter de incrustación de elemento visual que pueden usar los desarrolladores.


| Método | Description (Descripción) | 
| --- | --- | 
|  `getFilterGroups()`  |  Devuelve todos los `FilterGroups` que actualmente tienen como ámbito el elemento visual incrustado.  | 

**Métodos Setter**

En la siguiente tabla se describen los diferentes métodos setter que los desarrolladores pueden usar para la incrustación de paneles o elementos visuales.


| Método | Description (Descripción) | 
| --- | --- | 
|  `addFilterGroups(filterGroups: FilterGroup[])`  |  Agrega y aplica lo suministrado **FilterGroups**al panel de control o imagen incrustado. Se devuelve un mensaje `ResponseMessage` que indica si la incorporación se realizó correctamente.  | 
|  `updateFilterGroups(filterGroups: FilterGroup[])`  |  Actualiza `FilterGroups` en la experiencia incrustada que contiene el mismo `FilterGroupId` que el `FilterGroup` que se proporciona en el parámetro. Se devuelve un mensaje `ResponseMessage` que indica si la actualización se realizó correctamente.  | 
|  `removeFilterGroups(filterGroupsOrIds: FilterGroup[] \| string[])`  |  Quita lo suministrado FilterGroups del tablero y devuelve un `ResponseMessage` que indica si el intento de extracción se ha realizado correctamente.  | 

El `FilterGroup` que se proporciona debe tener como ámbito los elementos visuales o las hojas incrustados actualmente seleccionados.

# Personalice la apariencia de los paneles y elementos visuales integrados de Amazon Quick Sight
<a name="embedding-runtime-theming"></a>

Puede utilizar el SDK de incrustación de Amazon Quick Sight (versión 2.5.0 y superior) para realizar cambios en la temática de los paneles y elementos visuales de Amazon Quick Sight integrados durante el tiempo de ejecución. La tematización en tiempo de ejecución facilita la integración de la aplicación de software como servicio (SaaS) con los activos integrados de Amazon Quick Sight. La tematización en tiempo de ejecución le permite sincronizar el tema del contenido incrustado con los temas de la aplicación principal en la que están integrados sus activos de Amazon Quick Sight. También puede utilizar la creación de temas en tiempo de ejecución para agregar opciones de personalización para los lectores. Los cambios de creación de temas se pueden aplicar a los activos incrustados al inicializarlos o durante toda la vida útil del elemento visual o el panel incrustados.

Para obtener más información sobre los temas, consulte [Uso de temas en Amazon Quick Sight](themes-in-quicksight.md). Para obtener más información sobre el uso del SDK de incrustación de Amazon Quick Sight, consulte [amazon-quicksight-embedding-sdk](https://github.com/awslabs/amazon-quicksight-embedding-sdk)la GitHub

**Requisitos previos**

Antes de empezar, asegúrese de que cumple los requisitos previos que se indican a continuación.
+ Está utilizando la versión 2.5.0 o superior del SDK de incrustación de Amazon Quick Sight.
+ Dispone de permisos para acceder al tema con el que quiere trabajar. Para conceder permisos a un tema en Amazon Quick Sight, realice una llamada a la `UpdateThemePermissions` API o utilice el icono **Compartir** situado junto al tema en el editor de análisis de la consola Amazon Quick Sight.

## Terminología y conceptos
<a name="runtime-theming-terminology"></a>

La siguiente terminología puede resultar útil cuando se trabaja con temas de tiempo de ejecución incrustados.
+ *Tema*: conjunto de ajustes que puede aplicar a varios análisis y paneles que cambian la forma en que se muestra el contenido.
+ *ThemeConfiguration*— Un objeto de configuración que contiene todas las propiedades de visualización de un tema.
+ *Anulación del tema*: objeto `ThemeConfiguration` que se aplica al tema activo para anular algunos o todos los aspectos de la visualización del contenido.
+ *ARN del tema: un* nombre de recurso de Amazon (ARN) que identifica un tema de Amazon Quick Sight. A continuación se muestra un ejemplo de ARN de tema personalizado.

  `arn:aws:quicksight:region:account-id:theme/theme-id`

  Los temas de inicio proporcionados por Amazon Quick Sight no tienen una región en su ARN de tema. A continuación, se muestra un ejemplo de ARN de tema de inicio.

  `arn:aws:quicksight::aws:theme/CLASSIC`

## Configuración
<a name="runtime-theming-setup"></a>

Asegúrese de disponer de la información que se indica a continuación para empezar a trabajar con la creación de temas en tiempo de ejecución.
+ El tema ARNs de los temas que quieres usar. Puede elegir un tema existente, o bien puede crear uno nuevo. Para obtener una lista de todos los temas y temas ARNs de tu cuenta de Amazon Quick Sight, realiza una llamada a la operación de la [ListThemes](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_ListThemes.html)API. Para obtener información sobre los temas preestablecidos de Amazon Quick Sight, consulte[Establecer un tema predeterminado para los análisis de Amazon Quick con Amazon Quick APIs](customizing-quicksight-default-theme.md).
+ Si usa la incrustación de usuarios registrados, asegúrese de que el usuario tenga acceso a los temas que desea usar.

  Si utiliza la incrustación de usuarios anónimos, pase una lista de temas ARNs al `AuthorizedResourceArns` parámetro de la `GenerateEmbedUrlForAnonymousUser` API. Los usuarios anónimos tienen acceso a cualquier tema que aparezca en el parámetro `AuthorizedResourceArns`.

## Interfaz del método del SDK
<a name="runtime-theming-sdk-interface"></a>

**Métodos setter**

En la siguiente tabla se describen los diferentes métodos setter que los desarrolladores pueden usar para la creación de temas en tiempo de ejecución.


| Método | Description (Descripción) | 
| --- | --- | 
|  `setTheme(themeArn: string)`  |  Sustituye el tema activo de un panel o elemento visual por otro tema. Si se aplica, se elimina la anulación del tema. Se devuelve un error si no tiene acceso al tema o si el tema no existe.  | 
|  `setThemeOverride(themeOverride: ThemeConfiguration)`  |  Establece una `ThemeConfiguration` dinámica para anular el tema activo actual. Esto reemplaza la anulación del tema previamente establecida. Los valores que no se proporcionen en el nuevo `ThemeConfiguration` se establecen de forma predeterminada con los valores del tema actualmente activo. Se devuelve un error si el `ThemeConfiguration` proporcionado no es válido.  | 

## Inicialización del contenido incrustado con un tema
<a name="runtime-theming-sdk-initialize"></a>

Para inicializar un elemento visual o un panel incrustado con un tema no predeterminado, defina un objeto `themeOptions` en los parámetros `DashboardContentOptions` o `VisualContentOptions` y establezca la propiedad `themeArn` de `themeOptions` con el ARN del tema deseado.

En el siguiente ejemplo, se inicializa un panel incrustado con el tema `MIDNIGHT`.

```
import { createEmbeddingContext } from 'amazon-quicksight-embedding-sdk';

const embeddingContext = await createEmbeddingContext();

const {
    embedDashboard,
} = embeddingContext;

const frameOptions = {
    url: '<YOUR_EMBED_URL>',
    container: '#experience-container',
};
const contentOptions = {
    themeOptions: {
        themeArn: "arn:aws:quicksight::aws:theme/MIDNIGHT"
    }
};

// Embedding a dashboard experience
const embeddedDashboardExperience = await embedDashboard(frameOptions, contentOptions);
```

## Inicialización del contenido incrustado con una anulación de tema
<a name="runtime-theming-runtime-initialize-override"></a>

Los desarrolladores pueden utilizar anulaciones de tema para definir el tema de un elemento visual o panel incrustado en tiempo de ejecución. Esto permite que el panel o el elemento visual hereden un tema de una aplicación de terceros sin necesidad de preconfigurar un tema en Amazon Quick Sight. Para inicializar un elemento visual o panel incrustado con una anulación de tema, establezca la propiedad `themeOverride` de `themeOptions` con los parámetros `DashboardContentOptions` o `VisualContentOptions`. En el siguiente ejemplo, se anula la fuente del tema de un panel y se pasa de la fuente predeterminada a `Amazon Ember`.

```
import { createEmbeddingContext } from 'amazon-quicksight-embedding-sdk';

const embeddingContext = await createEmbeddingContext();

const {
    embedDashboard,
} = embeddingContext;

const frameOptions = {
    url: '<YOUR_EMBED_URL>',
    container: '#experience-container',
};
const contentOptions = {
    themeOptions: {
        "themeOverride":{"Typography":{"FontFamilies":[{"FontFamily":"Comic Neue"}]}}
    }
};

// Embedding a dashboard experience
const embeddedDashboardExperience = await embedDashboard(frameOptions, contentOptions);
```

## Inicialización del contenido incrustado con temas precargados
<a name="runtime-theming-runtime-initialize-preloaded"></a>

Los desarrolladores pueden configurar un conjunto de temas de panel para que se carguen previamente en el momento de la inicialización. Esto resulta especialmente útil para cambiar rápidamente entre diferentes vistas, como, por ejemplo, entre los modos oscuro y claro. Los elementos visuales o paneles incrustados se pueden inicializar con hasta 5 temas precargados. Para usar temas precargados, establezca la propiedad `preloadThemes` en `DashboardContentOptions` o `VisualContentOptions` con una matriz de hasta 5 `themeArns`. En el siguiente ejemplo, se precargan los temas de inicio `Midnight` y `Rainier` en un panel.

```
import { createEmbeddingContext } from 'amazon-quicksight-embedding-sdk';

const embeddingContext = await createEmbeddingContext();

const {
    embedDashboard,
} = embeddingContext;

const frameOptions = {
    url: '<YOUR_EMBED_URL>',
    container: '#experience-container',
};
const contentOptions = {
    themeOptions: {
        "preloadThemes": ["arn:aws:quicksight::aws:theme/RAINIER", "arn:aws:quicksight::aws:theme/MIDNIGHT"]
    }
};

// Embedding a dashboard experience
const embeddedDashboardExperience = await embedDashboard(frameOptions, contentOptions);
```

# Uso del SDK de incrustación de Amazon Quick Sight para permitir enlaces compartibles a vistas de paneles integradas
<a name="embedded-view-sharing"></a>

Los desarrolladores de Amazon Quick Sight pueden usar el SDK de incrustación de Amazon Quick Sight (versión 2.8.0 y superior) para permitir a los lectores de los paneles integrados recibir y distribuir enlaces que se pueden compartir a su vista de un panel integrado. Los desarrolladores pueden utilizar la incrustación de paneles o consolas para generar un enlace compartible a la página de su aplicación con la referencia de Amazon Quick Sight encapsulada mediante el SDK de incrustación de Amazon Quick Sight. A continuación, los lectores de Amazon Quick Sight pueden enviar este enlace para compartir a sus compañeros. Cuando su compañero accede al enlace compartido, se le dirige a la página de la aplicación que contiene el panel de control integrado de Amazon Quick Sight. Los desarrolladores también pueden generar y guardar enlaces compartibles de vistas de paneles que se pueden usar como marcadores para los lectores anónimos de Amazon Quick Sight cuando utilizan la incrustación anónima.

**Requisitos previos**

Antes de empezar, asegúrese de utilizar la versión 2.8.0 o superior del SDK de incrustación de Amazon Quick Sight

**Topics**
+ [Habilitación de la configuración de `SharedView` funciones para el análisis integrado de Amazon Quick Sight](embedded-view-sharing-set-up.md)
+ [Creación de una vista compartida con la `createSharedView` API Amazon Quick Sight](embedded-view-sharing-sdk-create.md)
+ [Consumir una vista compartida de Amazon Quick Sight](embedded-view-sharing-sdk-consume.md)

# Habilitación de la configuración de `SharedView` funciones para el análisis integrado de Amazon Quick Sight
<a name="embedded-view-sharing-set-up"></a>

Al crear una instancia incrustada con la API Amazon Quick Sight, defina el valor de `SharedView` en la `FeatureConfigurations` carga útil en`true`, como se muestra en el siguiente ejemplo. `SharedView`anula las `StatePersistence` configuraciones de los usuarios registrados que acceden a los paneles integrados. Si un usuario del panel tiene `StatePersistence` deshabilitado y `SharedView` habilitado, su estado se mantendrá.

```
const generateNewEmbedUrl = async () => {
    const generateUrlPayload = {
        experienceConfiguration: {
            QuickSightConsole: {
            FeatureConfigurations: {
                "SharedView": { 
                    "Enabled": true
                 },
            },
        },
    }
    const result: GenerateEmbedUrlResult = await generateEmbedUrlForRegisteredUser(generateUrlPayload);
    return result.url;
};
```

# Creación de una vista compartida con la `createSharedView` API Amazon Quick Sight
<a name="embedded-view-sharing-sdk-create"></a>

Después de actualizar el SDK de incrustación a la versión 2.8.0 o superior, utilice la API `createSharedView` para crear una nueva vista compartida. Registre los datos de `sharedViewId` y `dashboardId` que devuelve la operación. El siguiente ejemplo crea una nueva vista compartida.

```
const response = await embeddingFrame.createSharedView();
const sharedViewId = response.message.sharedViewId;
const dashboardId = response.message.dashboardId;
```

Solo se puede llamar a `createSharedView` cuando un usuario visualiza un panel. Para crear una vista compartida específica para una consola, asegúrese de que los usuarios se encuentren en la página del panel antes de activar la acción `createSharedView`. Para ello, use el evento `PAGE_NAVIGATION` que se muestra en el ejemplo siguiente.

```
const contentOptions = {
    onMessage: async (messageEvent, metadata) => {
    switch (messageEvent.eventName) {
            case 'CONTENT_LOADED': {
                console.log("Do something when the embedded experience is fully loaded.");
                break;
            }
            case 'ERROR_OCCURRED': {
                console.log("Do something when the embedded experience fails loading.");
                break;
            }
            case 'PAGE_NAVIGATION': {
                setPageType(messageEvent.message.pageType); 
                if (messageEvent.message.pageType === 'DASHBOARD') {
                    setShareEnabled(true);
                    } else {
                    setShareEnabled(false);
                }
                break;
            }
        }
    }
};
```

# Consumir una vista compartida de Amazon Quick Sight
<a name="embedded-view-sharing-sdk-consume"></a>

Tras crear una nueva vista compartida, use el SDK de incrustación para que otros usuarios puedan consumir la vista compartida. Los ejemplos siguientes configuran una vista compartida consumible para un panel integrado en Amazon Quick Sight.

------
#### [ With an appended URL ]

Agregue la URL `sharedViewId` a la URL incrustada, en` /views/{viewId}`, y muestre dicha URL a sus usuarios. Los usuarios podrán usar esta URL para navegar a la vista compartida.

```
const response = await dashboardFrame.createSharedView();
const newEmbedUrl = await generateNewEmbedUrl();
const formattedUrl = new URL(newEmbedUrl);
formattedUrl.pathname = formattedUrl.pathname.concat('/views/' + response.message.sharedViewId);
const baseUrl = formattedUrl.href;
alert("Click to view this QuickSight shared view", baseUrl);
```

------
#### [ With the contentOptions SDK ]

Pase un `viewId` a `contentOptions` para abrir la experiencia con los `viewId` proporcionados.

```
const contentOptions = {
    toolbarOptions: {
        ...
    },
    viewId: sharedViewId,
};

const embeddedDashboard = await embeddingContext.embedDashboard(
    {container: containerRef.current},
    contentOptions
);
```

------
#### [ With the InitialPath property ]

```
const shareView = async() => {
    const returnValue = await consoleFrame.createSharedView();
    const {dashboardId, sharedViewId} = returnValue.message;
    const newEmbedUrl = await generateNewEmbedUrl(`/dashboards/${dashboardId}/views/${sharedViewId}`);
    setShareUrl(newEmbedUrl);
};

const generateNewEmbedUrl = async (initialPath) => {
    const generateUrlPayload = {
        experienceConfiguration: {
            QuickSightConsole: {
            InitialPath: initialPath,
            FeatureConfigurations: {
                "SharedView": { 
                    "Enabled": true
                 },
            },
        },
    }
    const result: GenerateEmbedUrlResult = await generateEmbedUrlForRegisteredUser(generateUrlPayload);
    return result.url;
};
```

------

# Incrustar imágenes y paneles de Amazon Quick Sight con un código de inserción de 1 clic
<a name="1-click-embedding"></a>

Puede integrar un elemento visual o un panel en su aplicación mediante un código de integración. Este código se obtiene al compartir el panel de control o desde el menú **visual Insertar** de Amazon Quick Sight. 

Puede insertar un elemento visual o panel en su aplicación interna para los usuarios registrados. También puedes activar la compartición pública en la consola Amazon Quick Sight. De este modo, cualquier persona que utilice Internet tendrá acceso a un elemento visual o panel de control compartido que esté integrado en una aplicación, wiki o portal públicos.

A continuación, encontrará descripciones sobre cómo integrar elementos visuales y paneles mediante el código de integración del elemento visual o del panel de control de 1 clic.

**Topics**
+ [Incrustar imágenes y paneles de Amazon Quick Sight para usuarios registrados con un código de inserción de 1 clic](embedded-analytics-1-click.md)
+ [Incrustar imágenes y paneles de Amazon Quick Sight para usuarios anónimos con un código de inserción de 1 clic](embedded-analytics-1-click-public.md)

# Incrustar imágenes y paneles de Amazon Quick Sight para usuarios registrados con un código de inserción de 1 clic
<a name="embedded-analytics-1-click"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

Puedes incrustar una imagen o un panel de control en tu aplicación interna para los usuarios registrados de tu cuenta de Amazon Quick Sight. Para ello, utiliza el código de inserción que obtiene al compartir el panel de control o desde el menú **visual Insertar** de Amazon Quick Sight. No es necesario ejecutar la API de incrustación de Amazon Quick Sight para generar el código de incrustación. Puede copiar el código de inserción de Amazon Quick Sight y pegarlo en el código HTML de la aplicación interna.

Cuando los usuarios y grupos (o todos los usuarios de su cuenta de Amazon Quick Sight) que tienen acceso al panel de control que desea insertar o que contiene la imagen que desea insertar acceden a su aplicación interna, se les pide que inicien sesión en la cuenta de Amazon Quick Sight con sus credenciales. Una vez autenticados, pueden acceder al elemento visual o al panel de su página interna. Si tiene activado el inicio de sesión único, no se les pedirá que vuelvan a iniciar sesión.

A continuación, encontrará descripciones sobre cómo integrar un elemento visual o un panel para usuarios registrados utilizando el código de integración del elemento visual o del panel.

## Antes de comenzar
<a name="embedded-analytics-1-click-prerequisites"></a>

Antes de comenzar, asegúrese de lo siguiente:
+ La configuración de su navegador de Internet contiene uno de los siguientes elementos para permitir la comunicación entre la ventana emergente y el iframe:
  + Soporte nativo para la API de Mozilla Broadcast Channel. Para obtener más información, consulte [Broadcast Channel API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API) en la documentación de Mozilla.
  + Soporte de IndexedDB.
  + LocalStorage soporte.
+ La configuración de “bloquear todas las cookies” de su navegador de Internet está desactivada.

## Paso 1: concesión de acceso al panel
<a name="embedded-analystics-1-click-share"></a>

Para que los usuarios accedan a su panel integrado, concédales acceso para verlo. Puede conceder a usuarios y grupos individuales el acceso a un panel, o a todos los usuarios de su cuenta. Los permisos visuales se determinan a nivel del panel. Para conceder acceso a las imágenes integradas, conceda acceso al panel al que pertenece el elemento visual. Para obtener más información, consulte [Concesión de acceso a un panel](share-a-dashboard.md).

## Paso 2: colocación del dominio donde desea integrar el elemento visual o panel en la lista de permitidos
<a name="embedded-analytics-1-click-allow-list"></a>

Para incrustar imágenes y paneles en tu aplicación interna, asegúrate de que el dominio en el que vas a incrustar esté incluido en la lista de permitidos en tu cuenta de Amazon Quick Sight. Para obtener más información, consulte [Permiso para la publicación de dominios estáticos](manage-domains.md#embedding-static).

## Paso 3: obtención del código integrado
<a name="embedded-analytics-1-click-code"></a>

Utilice el siguiente procedimiento para obtener el código de integración del elemento visual o del panel.

**Obtención del código de integración del panel**

1. Abre el panel publicado en Amazon Quick Sight y selecciona **Compartir** en la esquina superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, seleccione **Copiar código para insertar** en la esquina superior izquierda.

   El código integrado se copia en el portapapeles y es similar al siguiente. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

   ```
   <iframe
           width="960"
           height="720"
           src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias">
       </iframe>
   ```

**Obtención del código de integración del elemento visual**

1. Abra el panel publicado en Amazon Quick Sight y elija el elemento visual que desee incrustar. A continuación, abra el menú del elemento visual en la parte superior derecha del visual y elija **Elemento visual para insertar**.

1. En el panel **Elemento visual para insertar** que se abre, seleccione **Copiar código**.

   El código integrado se copia en el portapapeles y es similar al siguiente. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

   ```
   <iframe
           width="600"
           height="400"
           src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
       </iframe>
   ```

## Paso 4: pegado del código en la página HTML de la aplicación interna
<a name="embedded-analytics-1-click-html"></a>

Utilice el siguiente procedimiento para pegar el código de integración en la página HTML de la aplicación interna

**Pegado del código en la página HTML de la aplicación interna**
+ Abra el código HTML de cualquier página en la que desee integrar el panel y péguelo.

  En el siguiente ejemplo, se muestra el aspecto que podría tener para un panel integrado. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="960"
          height="720"
          src="https://quicksightdomain/sn/embed/share/accounts/accountid/dashboards/dashboardid?directory_alias=account_directory_alias">
      </iframe>
  
      </body>
      </html>
  ```

  En el siguiente ejemplo, se muestra el aspecto que podría tener para un elemento visual integrado. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="600"
          height="400"
          src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID?directory_alias=account_directory_alias">
      </iframe>
  
      </body>
      </html>
  ```

Por ejemplo, supongamos que desea incrustar su elemento visual o panel en una página interna de Google Sites. Puede abrir la página en Google Sites y pegar el código de integración en un widget de integración.

Si desea incrustar el elemento visual o el panel en un SharePoint sitio interno de Microsoft, puede crear una página nueva y, a continuación, pegar el código de inserción en un elemento web de inserción.

# Incrustar imágenes y paneles de Amazon Quick Sight para usuarios anónimos con un código de inserción de 1 clic
<a name="embedded-analytics-1-click-public"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 

Puede incrustar una imagen o un panel en sitios públicos mediante el código de inserción que obtiene al compartir la imagen o el panel en Amazon Quick Sight. También puedes activar la compartición pública mediante la consola Amazon Quick Sight y conceder automáticamente acceso a una imagen o panel compartido a cualquier usuario de Internet. 

A continuación, encontrará información sobre cómo activar el uso compartido en público de un elemento visual o panel e integrarlos para que cualquier usuario de Internet pueda verlo. En ambos casos, puede hacerlo mediante el código de integración de 1 clic.

## Antes de comenzar
<a name="embedded-analytics-1-click-prerequisites"></a>

Antes de comenzar, asegúrese de lo siguiente:
+ La configuración de su navegador de Internet contiene uno de los siguientes elementos para permitir la comunicación entre la ventana emergente y el iframe que utiliza compartir:
  + Soporte nativo para la API de Mozilla Broadcast Channel. Para obtener más información, consulte [Broadcast Channel API](https://developer.mozilla.org/en-US/docs/Web/API/Broadcast_Channel_API) en la documentación de Mozilla.
  + Soporte de IndexedDB.
  + LocalStorage soporte.
+ La configuración de “bloquear todas las cookies” de su navegador de Internet está desactivada.

## Paso 1: activación del acceso público al panel
<a name="embedded-analytics-1-click-step-1"></a>

Para que cualquier usuario de Internet pueda acceder a su panel o elemento visual integrado, primero active el acceso público al panel. Los permisos visuales se determinan a nivel del panel. Para conceder acceso a las imágenes integradas, conceda acceso al panel al que pertenece el elemento visual. Para obtener más información, consulte [Conceder a cualquier usuario de Internet acceso a un panel de Amazon Quick Sight](share-a-dashboard-grant-access-anyone.md).

## Paso 2: colocación del dominio donde desea integrar el elemento visual o panel en la lista de permitidos
<a name="embedded-analytics-1-click-step-2"></a>

Para incrustar imágenes y paneles en una aplicación, wiki o portal públicos, asegúrate de que el dominio en el que los vas a incrustar esté en la lista de permitidos de tu cuenta de Amazon Quick Sight. 

## Paso 3: obtención del código integrado
<a name="embedded-analytics-1-click-step-3"></a>

Utilice el siguiente procedimiento para obtener el código de integración del elemento visual o del panel.

**Obtención del código de integración del panel**

1. Abre el panel publicado en Amazon Quick Sight y selecciona **Compartir** en la esquina superior derecha. A continuación, seleccione **Compartir panel**.

1. En la página **Compartir panel** que se abre, seleccione **Copiar código para insertar** en la esquina superior izquierda.

   El código integrado se copia en el portapapeles y es similar al siguiente. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

   ```
   <iframe
           width="960"
           height="720"
           src="https://quicksightdomain/sn/
               embed/share/accounts/accountid/dashboards/dashboardid">
       </iframe>
   ```

**Obtención del código de integración del elemento visual**

1. Abra el panel publicado en Amazon Quick Sight y elija el elemento visual que desee incrustar. A continuación, abra el menú visual en la esquina superior derecha del elemento visual y seleccione **Elemento visual para insertar**.

1. En el panel **Elemento visual para insertar** que se abre, seleccione **Copiar código**.

   El código integrado se copia en el portapapeles y es similar al siguiente. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

   ```
   <iframe
           width="600"
           height="400"
           src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
       </iframe>
   ```

## Paso 4: pegado del código de integración en una página HTML, una página wiki o un portal
<a name="embedded-analytics-1-click-step-4"></a>

Utilice el siguiente procedimiento para pegar el código de ntegración en una página HTML, una página wiki o un portal.

**Pegado del código de integración**
+ Abra el código HTML de la ubicación en la que desea integrar el elemento visual o panel y pegue el código de integración.

  En el siguiente ejemplo, se muestra el aspecto que podría tener para un panel integrado. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="960"
          height="720"
          src="https://quicksightdomain/sn/
              embed/share/accounts/accountid/dashboards/dashboardid">
      </iframe>
  
      </body>
      </html>
  ```

  En el siguiente ejemplo, se muestra el aspecto que podría tener para un elemento visual integrado. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

  ```
  <!DOCTYPE html>
      <html>
      <body>
  
      <h2>Example.com - Employee Portal</h2>
      <h3>Current shipment stats</h3>
          <iframe
          width="600"
          height="400"
          src="https://quicksightdomain/sn/embed/share/accounts/111122223333/dashboards/DASHBOARDID/sheets/SHEETID>/visuals/VISUALID">
      </iframe>
  
      </body>
      </html>
  ```

Si sus aplicaciones públicas están creadas en Google Sites, abrz la página en Google Sites y, a continuación, pegue el código de integración con el widget de integración.

Asegúrese de que los siguientes dominios de Amazon Quick Sight estén en su lista de permitidos cuando los inserte en Google Sites:
+ `https://googleusercontent.com` (activa los subdominios)
+ `https://www.gstatic.com`
+ `https://sites.google.com`

Tras integrar el elemento visual o panel en la aplicación, cualquier persona que pueda acceder a ella podrá acceder al elemento visual o al panel integrados. Para actualizar un panel que se comparte con el público, consulte [Actualización de un panel compartido públicamente](share-a-dashboard-grant-access-anyone-update.md). Para desactivar el uso compartido en público, consulte [Deshabilitación de la configuración de uso compartido en público](share-a-dashboard-grant-access-anyone-no-share.md). 

Si desactiva la compartición pública, nadie desde Internet podrá acceder a uno o varios paneles que haya integrado en una aplicación pública o que haya compartido con un enlace. La próxima vez que alguien intente ver un panel de este tipo desde Internet, recibirá un mensaje en el que se le indica que no tiene acceso para verlo.

# Integración con Amazon Quick Sight APIs
<a name="embedded-analytics-api"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Solo hay unos pocos pasos involucrados en el proceso real de integración de análisis con Amazon Quick Sight APIs. 

Antes de empezar, asegúrate de tener preparados los siguientes elementos:
+ Configure los permisos de IAM necesarios para la identidad de la persona que llama utilizada por su aplicación, que utilizará el AWS SDK para realizar llamadas a la API. Por ejemplo, conceda permiso para permitir la acción `quicksight:GenerateEmbedUrlForAnonymousUser` o `quicksight:GenerateEmbedUrlForRegisteredUser`.
+ Para incrustarlos para los usuarios registrados, comparte los activos de Amazon Quick Sight con ellos de antemano. Para los nuevos usuarios que se están autenticando, infórmese sobre cómo conceder acceso a los activos. Una forma de hacerlo es añadiendo todos los activos a una carpeta de Amazon Quick Sight. Si prefiere utilizar la API de Amazon Quick Sight, utilice las operaciones `DescribeDashboardPermissions` y `UpdateDashboardPermissions` API. Para obtener más información, consulta [DescribeDashboardPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeDashboardPermissions.html)o consulta [UpdateDashboardPermissions](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateDashboardPermissions.html)la *Amazon Quick API Reference*. Si desea compartir el panel con todos los usuarios de un espacio de nombres o grupo, puede compartir el panel con `namespace` o `group`.
+ Si va a integrar paneles, asegúrese de tener el ID de los paneles que desea integrar. El ID del panel es el código en la URL del panel. También puede obtenerlo desde la URL del panel.
+ Un administrador de Amazon Quick Sight debe habilitar de forma explícita los dominios en los que planea incrustar sus análisis de Amazon Quick Sight. Para ello, utilice la opción **Gestionar Amazon Quick Sight**, **Dominios e Incrustación** del menú del perfil, o bien utilice el `AllowedDomains` parámetro de una `GenerateEmbedUrlForAnonymousUser` llamada a la `GenerateEmbedUrlForRegisteredUser` API.

  Esta opción solo está visible para los administradores de Amazon Quick Sight. También puede agregar subdominios como parte de un dominio. Para obtener más información, consulte [Permite publicar dominios en tiempo de ejecución con la Amazon Quick API](manage-domains.md#embedding-run-time).

  Todos los dominios de su lista estática de permitidos (como desarrollo, almacenamiento provisional y producción) deben estar explícitamente permitidos, y deben usar HTTPS. Puede agregar hasta 100 dominios a la lista de permitidos. Puede añadir dominios en tiempo de ejecución con las operaciones de la API de Amazon Quick Sight.

Una vez cumplidos todos los requisitos previos, la integración de Amazon Quick Sight implica los siguientes pasos, que se explican con más detalle más adelante: 

1. Para la autenticación, utilice el servidor de aplicaciones para autenticar al usuario. Tras la autenticación en el servidor, genere la URL del panel de control integrada con el AWS SDK que necesite.

1. En su aplicación o portal web, inserte Amazon Quick Sight mediante la URL generada. Para simplificar este proceso, puede utilizar el SDK de incrustación de Amazon Quick Sight, disponible en [NPMJS](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) y. [GitHub](https://github.com/awslabs/amazon-quicksight-embedding-sdk) Este JavaScript SDK personalizado está diseñado para ayudarlo a integrar Amazon Quick Sight de manera eficiente en las páginas de sus aplicaciones, establecer valores predeterminados, conectar controles, recibir llamadas y gestionar errores. 

Puede utilizar los registros de AWS CloudTrail auditoría para obtener información sobre la cantidad de paneles integrados, los usuarios de una experiencia integrada y las tasas de acceso.

**Topics**
+ [Integración de los paneles de Amazon Quick Sight con la API Amazon Quick Sight](embedding-dashboards.md)
+ [Integración de imágenes de Amazon Quick Sight con Amazon Quick Sight APIs](embedding-visuals.md)
+ [Incorporar todas las funciones de la consola Amazon Quick Sight para los usuarios registrados](embedded-analytics-full-console-for-authenticated-users.md)
+ [Integración de Amazon Q en la experiencia generativa de preguntas y respuestas de Amazon Quick Sight](embedding-gen-bi.md)
+ [Incrustar la barra de búsqueda Quick Sight Q de Amazon (clásica)](embedding-quicksight-q.md)
+ [Integración de análisis mediante las operaciones de la API GetDashboardEmbedURL y GetSessionEmbedURL](embedded-analytics-deprecated.md)

# Integración de los paneles de Amazon Quick Sight con la API Amazon Quick Sight
<a name="embedding-dashboards"></a>

Utilice los siguientes temas para obtener información sobre cómo incrustar paneles con la API Amazon Quick Sight.

**Topics**
+ [Incorporación de paneles de Amazon Quick Sight para usuarios registrados](embedded-analytics-dashboards-for-authenticated-users.md)
+ [Incorporación de paneles de Amazon Quick Sight para usuarios anónimos (no registrados)](embedded-analytics-dashboards-for-everyone.md)
+ [Activación de resúmenes ejecutivos en paneles incrustados](embedded-analytics-genbi-executive-summaries-dashboard.md)

# Incorporación de paneles de Amazon Quick Sight para usuarios registrados
<a name="embedded-analytics-dashboards-for-authenticated-users"></a>

**importante**  
Amazon Quick Sight tiene nuevas operaciones de API para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando las operaciones `GetDashboardEmbedUrl` y las de la `GetSessionEmbedUrl` API para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener más información sobre la incrustación mediante las operaciones de API antiguas, consulte [Incrustar análisis mediante las GetDashboardEmbedURL](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics-deprecated.html) operaciones de API y. GetSessionEmbedURL


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, encontrará información detallada sobre cómo configurar los paneles de Amazon Quick Sight integrados para los usuarios registrados de Amazon Quick Sight.

**Topics**
+ [Paso 1: configuración de permisos](#embedded-dashboards-for-authenticated-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-dashboards-for-authenticated-users-step-2)
+ [Paso 3 integración de la URL del panel](#embedded-dashboards-for-authenticated-users-step-3)

## Paso 1: configuración de permisos
<a name="embedded-dashboards-for-authenticated-users-step-1"></a>

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a un panel de control asume una función que le da acceso a Amazon Quick Sight y permisos para acceder al panel. Para que esto sea posible, cree un rol de IAM en su. Cuenta de AWS Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. El rol de IAM debe proporcionar permisos para recuperar la incrustación de un grupo URLs de usuarios específico. Con la ayuda del carácter comodín *\$1*, puede conceder los permisos para generar una URL para todos los usuarios de un espacio de nombres específico, o para un subconjunto de usuarios de espacios de nombres específicos. Para ello, añada `quicksight:GenerateEmbedUrlForRegisteredUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForRegisteredUser`. El parámetro `AllowedDomains` es opcional. Como desarrollador, tiene la opción de anular los dominios estáticos que están configurados en el menú **Gestionar Amazon Quick Sight**. En su lugar, puede enumerar hasta tres dominios o subdominios que pueden acceder a la URL generada. A continuación, esta URL se integra en el sitio web que cree. Solo los dominios que aparecen en el parámetro pueden acceder al elemento visual integrado. Sin esta condición, usted puede incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForRegisteredUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente se traduce en el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La siguiente política de ejemplo ofrece estos permisos.

Además, si va a crear usuarios primerizos que vayan a ser lectores de Amazon Quick Sight, asegúrese de añadir el `quicksight:RegisterUser` permiso en la política.

El siguiente ejemplo de política proporciona permiso para recuperar una URL incrustada para los usuarios primerizos que vayan a ser lectores de Amazon Quick Sight.

Finalmente, la identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. En el siguiente ejemplo, se muestra una muestra de política de confianza. 

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o SAML, consulte las siguientes secciones de la *Guía del usuario de IAM: *
+ [Creación de un rol para identidades federadas web u OpenID Connect (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-dashboards-for-authenticated-users-step-2"></a>

En la siguiente sección, puede obtener información sobre cómo autenticar el usuario y obtener la URL del panel integrable en el servidor de su aplicación. Si planea incrustar paneles para los tipos de identidad de IAM o Amazon Quick Sight, comparta el panel con los usuarios.

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar estos pasos, se garantiza que cada visor del panel de control se aprovisione de forma única en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Este código se ejecuta en el servidor de aplicaciones.

### Java
<a name="embedded-dashboards-for-authenticated-users-java"></a>

```
import com.amazonaws.auth.AWSCredentials;
    import com.amazonaws.auth.BasicAWSCredentials;
    import com.amazonaws.auth.AWSCredentialsProvider;
    import com.amazonaws.regions.Regions;
    import com.amazonaws.services.quicksight.AmazonQuickSight;
    import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
    import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserRequest;
    import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserResult;
    import com.amazonaws.services.quicksight.model.RegisteredUserEmbeddingExperienceConfiguration;
    import com.amazonaws.services.quicksight.model.RegisteredUserDashboardEmbeddingConfiguration;

    /**
    * Class to call QuickSight AWS SDK to get url for dashboard embedding.
    */
    public class GetQuicksightEmbedUrlRegisteredUserDashboardEmbedding {

        private final AmazonQuickSight quickSightClient;

        public GetQuicksightEmbedUrlRegisteredUserDashboardEmbedding() {
            this.quickSightClient = AmazonQuickSightClientBuilder
                    .standard()
                    .withRegion(Regions.US_EAST_1.getName())
                    .withCredentials(new AWSCredentialsProvider() {
                        @Override
                        public AWSCredentials getCredentials() {
                            // provide actual IAM access key and secret key here
                            return new BasicAWSCredentials("access-key", "secret-key");
                        }

                        @Override
                        public void refresh() {}
                        }
                    )
                    .build();
        }

        public String getQuicksightEmbedUrl(
                final String accountId, // AWS Account ID
                final String dashboardId, // Dashboard ID to embed
                final List<String> allowedDomains, // Runtime allowed domain for embedding
                final String userArn // Registered user arn to use for embedding. Refer to Get Embed Url section in developer portal to find out how to get user arn for a QuickSight user.
        ) throws Exception {
            final RegisteredUserEmbeddingExperienceConfiguration experienceConfiguration = new RegisteredUserEmbeddingExperienceConfiguration()
                    .withDashboard(new RegisteredUserDashboardEmbeddingConfiguration().withInitialDashboardId(dashboardId));
            final GenerateEmbedUrlForRegisteredUserRequest generateEmbedUrlForRegisteredUserRequest = new GenerateEmbedUrlForRegisteredUserRequest();
            generateEmbedUrlForRegisteredUserRequest.setAwsAccountId(accountId);
            generateEmbedUrlForRegisteredUserRequest.setUserArn(userArn);
            generateEmbedUrlForRegisteredUserRequest.setAllowedDomains(allowedDomains);
            generateEmbedUrlForRegisteredUserRequest.setExperienceConfiguration(experienceConfiguration);

            final GenerateEmbedUrlForRegisteredUserResult generateEmbedUrlForRegisteredUserResult = quickSightClient.generateEmbedUrlForRegisteredUser(generateEmbedUrlForRegisteredUserRequest);

            return generateEmbedUrlForRegisteredUserResult.getEmbedUrl();
        }
    }
```

### JavaScript
<a name="embedded-dashboards-for-authenticated-users-js"></a>

```
global.fetch = require('node-fetch');
    const AWS = require('aws-sdk');

    function generateEmbedUrlForRegisteredUser(
        accountId,
        dashboardId,
        openIdToken, // Cognito-based token
        userArn, // registered user arn
        roleArn, // IAM user role to use for embedding
        sessionName, // Session name for the roleArn assume role
        allowedDomains, // Runtime allowed domain for embedding
        getEmbedUrlCallback, // GetEmbedUrl success callback method
        errorCallback // GetEmbedUrl error callback method
        ) {
        const stsClient = new AWS.STS();
        let stsParams = {
            RoleSessionName: sessionName,
            WebIdentityToken: openIdToken,
            RoleArn: roleArn
        }

        stsClient.assumeRoleWithWebIdentity(stsParams, function(err, data) {
            if (err) {
                console.log('Error assuming role');
                console.log(err, err.stack);
                errorCallback(err);
            } else {
                const getDashboardParams = {
                    "AwsAccountId": accountId,
                    "ExperienceConfiguration": {
                        "Dashboard": {
                            "InitialDashboardId": dashboardId
                        }
                    },
                    "UserArn": userArn,
                    "AllowedDomains": allowedDomains,
                    "SessionLifetimeInMinutes": 600
                };

                const quicksightClient = new AWS.QuickSight({
                    region: process.env.AWS_REGION,
                    credentials: {
                        accessKeyId: data.Credentials.AccessKeyId,
                        secretAccessKey: data.Credentials.SecretAccessKey,
                        sessionToken: data.Credentials.SessionToken,
                        expiration: data.Credentials.Expiration
                    }
                });

                quicksightClient.generateEmbedUrlForRegisteredUser(getDashboardParams, function(err, data) {
                    if (err) {
                        console.log(err, err.stack);
                        errorCallback(err);
                    } else {
                        const result = {
                            "statusCode": 200,
                            "headers": {
                                "Access-Control-Allow-Origin": "*", // Use your website domain to secure access to GetEmbedUrl API
                                "Access-Control-Allow-Headers": "Content-Type"
                            },
                            "body": JSON.stringify(data),
                            "isBase64Encoded": false
                        }
                        getEmbedUrlCallback(result);
                    }
                });
            }
        });
    }
```

### Python3
<a name="embedded-dashboards-for-authenticated-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError

sts = boto3.client('sts')

# Function to generate embedded URL  
# accountId: AWS account ID
# dashboardId: Dashboard ID to embed
# userArn: arn of registered user
# allowedDomains: Runtime allowed domain for embedding
# roleArn: IAM user role to use for embedding
# sessionName: session name for the roleArn assume role
def getEmbeddingURL(accountId, dashboardId, userArn, allowedDomains, roleArn, sessionName):
    try:
        assumedRole = sts.assume_role(
            RoleArn = roleArn,
            RoleSessionName = sessionName,
        )
    except ClientError as e:
        return "Error assuming role: " + str(e)
    else: 
        assumedRoleSession = boto3.Session(
            aws_access_key_id = assumedRole['Credentials']['AccessKeyId'],
            aws_secret_access_key = assumedRole['Credentials']['SecretAccessKey'],
            aws_session_token = assumedRole['Credentials']['SessionToken'],
        )
        try:
            quicksightClient = assumedRoleSession.client('quicksight', region_name='us-west-2')
            response = quicksightClient.generate_embed_url_for_registered_user(
                AwsAccountId=accountId,
                ExperienceConfiguration = {
                    "Dashboard": {
                        "InitialDashboardId": dashboardId
                    }
                },
                UserArn = userArn,
                AllowedDomains = allowedDomains,
                SessionLifetimeInMinutes = 600
            )
            
            return {
                'statusCode': 200,
                'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
                'body': json.dumps(response),
                'isBase64Encoded':  bool('false')
            }
        except ClientError as e:
            return "Error generating embedding url: " + str(e)
```

### Node.js
<a name="embedded-dashboards-for-authenticated-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
    const https = require('https');

    var quicksightClient = new AWS.Service({
        apiConfig: require('./quicksight-2018-04-01.min.json'),
        region: 'us-east-1',
    });

    quicksightClient.generateEmbedUrlForRegisteredUser({
        'AwsAccountId': '111122223333',
        'ExperienceConfiguration': { 
            'Dashboard': {
                'InitialDashboardId': '1c1fe111-e2d2-3b30-44ef-a0e111111cde'
            }
        },
        'UserArn': 'REGISTERED_USER_ARN',
        'AllowedDomains': allowedDomains,
        'SessionLifetimeInMinutes': 100
    }, function(err, data) {
        console.log('Errors: ');
        console.log(err);
        console.log('Response: ');
        console.log(data);
    });
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
    //readability and added ellipsis to indicate that it's incomplete.
        { 
            Status: 200,
            EmbedUrl: 'https://quicksightdomain/embed/12345/dashboards/67890...'
            RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' 
        }
```

### .NET/C\$1
<a name="embedded-dashboards-for-authenticated-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
using System;
    using Amazon.QuickSight;
    using Amazon.QuickSight.Model;

    namespace GenerateDashboardEmbedUrlForRegisteredUser
    {
        class Program
        {
            static void Main(string[] args)
            {
                var quicksightClient = new AmazonQuickSightClient(
                    AccessKey,
                    SecretAccessKey,
                    SessionToken,
                    Amazon.RegionEndpoint.USEast1);
                try
                {
                    RegisteredUserDashboardEmbeddingConfiguration registeredUserDashboardEmbeddingConfiguration
                        = new RegisteredUserDashboardEmbeddingConfiguration
                        {
                            InitialDashboardId = "dashboardId"
                        };
                    RegisteredUserEmbeddingExperienceConfiguration registeredUserEmbeddingExperienceConfiguration
                        = new RegisteredUserEmbeddingExperienceConfiguration
                        {
                            Dashboard = registeredUserDashboardEmbeddingConfiguration
                        };
                        
                    Console.WriteLine(
                        quicksightClient.GenerateEmbedUrlForRegisteredUserAsync(new GenerateEmbedUrlForRegisteredUserRequest
                        {
                            AwsAccountId = "111122223333",
                            ExperienceConfiguration = registeredUserEmbeddingExperienceConfiguration,
                            UserArn = "REGISTERED_USER_ARN",
                            AllowedDomains = allowedDomains,
                            SessionLifetimeInMinutes = 100
                        }).Result.EmbedUrl
                    );
                } catch (Exception ex) {
                    Console.WriteLine(ex.Message);
                }
            }
        }
    }
```

### AWS CLI
<a name="embedded-dashboards-for-authenticated-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar a su usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Usa esta operación cuando utilices SAML para autenticar a tus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForRegisteredUser` habilitados. Si opta por añadir usuarios just-in-time la primera vez que abren un panel de control, el rol también necesita tener habilitados los permisos. `quicksight:RegisterUser`

```
aws sts assume-role \
        --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
        --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
    export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
    export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_dashboard_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan al panel de control. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
        --aws-account-id 111122223333 \
        --namespace default \
        --identity-type IAM \
        --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
        --user-role READER \
        --user-name jhnd \
        --session-name "john.doe@example.com" \
        --email john.doe@example.com \
        --region us-east-1 \
        --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el ARN del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puedes añadir este usuario al grupo con el que se comparte el panel. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
    --aws-account-id=111122223333 \
    --namespace=default \
    --group-name=financeusers \
    --member-name="embedding_quicksight_dashboard_role/john.doe@example.com"
```

Ahora tienes un usuario de tu aplicación que también es usuario de Amazon Quick Sight y que tiene acceso al panel de control. 

Por último, para obtener una URL firmada para el panel, llame a `generate-embed-url-for-registered-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un panel integrado mediante una llamada desde el servidor para los usuarios autenticados mediante un inicio de sesión único ( AWS Managed Microsoft AD IAM Identity Center).

```
aws quicksight generate-embed-url-for-registered-user \
        --aws-account-id 111122223333 \
        --session-lifetime-in-minutes 600 \
        --user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/embedding_quicksight_visual_role/embeddingsession \
        --allowed-domains '["domain1","domain2"]' \
        --experience-configuration Dashboard={InitialDashboardId=1a1ac2b2-3fc3-4b44-5e5d-c6db6778df89}
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html). Puede utilizar esta y otras operaciones de la API en su propio código.

## Paso 3 integración de la URL del panel
<a name="embedded-dashboards-for-authenticated-users-step-3"></a>

En la siguiente sección, encontrará información sobre cómo utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL del panel de control del paso 3 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque el panel en una página HTML.
+ Transferir los parámetros al panel.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GenerateEmbedUrlForRegisteredUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-registered-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    {
        "Status": "200",
        "EmbedUrl": "https://quicksightdomain/embed/12345/dashboards/67890..",
        "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
    }
```

Inserta este panel en tu página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Con el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros del panel de control y recibir llamadas en términos de errores o de finalización de la carga de la página. 

El dominio que va a alojar paneles integrados deben estar incluido en la *lista de permitidos*, la lista de dominios aprobados de la suscripción a Quick . Este requisito protege los datos impidiendo que dominios no aprobados alojen paneles integrados. Para obtener más información sobre cómo añadir dominios para los paneles integrados, consulte [Permitir la publicación de dominios en tiempo de ejecución con la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-run-time.html).

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-dashboards-for-authenticated-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Dashboard Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedDashboard = async() => {
                const {
                    createEmbeddingContext,
                } = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: '<YOUR_EMBED_URL>',
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    parameters: [
                        {
                            Name: 'country',
                            Values: [
                                'United States'
                            ],
                        },
                        {
                            Name: 'states',
                            Values: [
                                'California',
                                'Washington'
                            ]
                        }
                    ],
                    locale: "en-US",
                    sheetOptions: {
                        initialSheetId: '<YOUR_SHEETID>',
                        singleSheet: false,                        
                        emitSizeChangedEventOnSheetChange: false,
                    },
                    toolbarOptions: {
                        export: false,
                        undoRedo: false,
                        reset: false
                    },
                    attributionOptions: {
                        overlayContent: false,
                    },
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'CONTENT_LOADED': {
                                console.log("All visuals are loaded. The title of the document:", messageEvent.message.title);
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Error occurred while rendering the experience. Error code:", messageEvent.message.errorCode);
                                break;
                            }
                            case 'PARAMETERS_CHANGED': {
                                console.log("Parameters changed. Changed parameters:", messageEvent.message.changedParameters);
                                break;
                            }
                            case 'SELECTED_SHEET_CHANGED': {
                                console.log("Selected sheet changed. Selected sheet:", messageEvent.message.selectedSheet);
                                break;
                            }
                            case 'SIZE_CHANGED': {
                                console.log("Size changed. New dimensions:", messageEvent.message);
                                break;
                            }
                            case 'MODAL_OPENED': {
                                window.scrollTo({
                                    top: 0 // iframe top position
                                });
                                break;
                            }
                        }
                    },
                };
                const embeddedDashboardExperience = await embeddingContext.embedDashboard(frameOptions, contentOptions);

                const selectCountryElement = document.getElementById('country');
                selectCountryElement.addEventListener('change', (event) => {
                    embeddedDashboardExperience.setParameters([
                        {
                            Name: 'country',
                            Values: event.target.value
                        }
                    ]);
                });
            };
        </script>
    </head>

    <body onload="embedDashboard()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="experience-container"></div>
    </body>

</html>
```

### SDK 1.0
<a name="embedded-dashboards-for-authenticated-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Basic Embed</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@1.0.15/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            var dashboard
            function onDashboardLoad(payload) {
                console.log("Do something when the dashboard is fully loaded.");
            }

            function onError(payload) {
                console.log("Do something when the dashboard fails loading");
            }

            function embedDashboard() {
                var containerDiv = document.getElementById("embeddingContainer");
                var options = {
                    // replace this dummy url with the one generated via embedding API
                    url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode",
                    container: containerDiv,
                    parameters: {
                        country: "United States"
                    },
                    scrolling: "no",
                    height: "700px",
                    width: "1000px",
                    locale: "en-US",
                    footerPaddingEnabled: true
                };
                dashboard = QuickSightEmbedding.embedDashboard(options);
                dashboard.on("error", onError);
                dashboard.on("load", onDashboardLoad);
            }

            function onCountryChange(obj) {
                dashboard.setParameters({country: obj.value});
            }
        </script>
    </head>

    <body onload="embedDashboard()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country" onchange="onCountryChange(this)">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="embeddingContainer"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el panel integrado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Incorporación de paneles de Amazon Quick Sight para usuarios anónimos (no registrados)
<a name="embedded-analytics-dashboards-for-everyone"></a>

**importante**  
Amazon Quick Sight tiene nuevas operaciones de API para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando las operaciones `GetDashboardEmbedUrl` y las de la `GetSessionEmbedUrl` API para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener más información sobre la incrustación mediante las operaciones de API antiguas, consulte [Incrustar análisis mediante las GetDashboardEmbedURL](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics-deprecated.html) operaciones de API y. GetSessionEmbedURL


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, encontrará información detallada sobre cómo configurar los paneles de Amazon Quick Sight integrados para usuarios anónimos (no registrados).

**Topics**
+ [Paso 1: configuración de permisos](#embedded-analytics-dashboards-with-anonymous-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-analytics-dashboards-with-anonymous-users-step-2)
+ [Paso 3 integración de la URL del panel](#embedded-analytics-dashboards-with-anonymous-users-step-3)

## Paso 1: configuración de permisos
<a name="embedded-analytics-dashboards-with-anonymous-users-step-1"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a un panel de control asume un rol que le da acceso a Amazon Quick Sight y permisos para acceder al panel. Para que esto sea posible, cree un rol de IAM en su. Cuenta de AWS Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForAnonymousUser`. El parámetro `AllowedDomains` es opcional. Como desarrollador, tiene la opción de anular los dominios estáticos que están configurados en el menú **Gestionar Amazon Quick Sight**. En su lugar, puede enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web que cree. Solo los dominios que aparecen en el parámetro pueden acceder al panel integrado. Sin esta condición, usted puede incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForAnonymousUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente tiene el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La siguiente política de ejemplo ofrece estos permisos para usar con `GenerateEmbedUrlForAnonymousUser`. Para que este enfoque funcione, también necesita un paquete de sesiones, o un precio por capacidad de sesión, para su Cuenta de AWS. De lo contrario, cuando un usuario intenta acceder al panel de control, se devuelve el error `UnsupportedPricingPlanException`. 

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que, cuando un usuario accede a su aplicación, esta puede asumir el rol en nombre del usuario para abrir el panel. En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
"Version":"2012-10-17",		 	 	 
"Statement": [
    {
        "Sid": "AllowLambdaFunctionsToAssumeThisRole",
        "Effect": "Allow",
        "Principal": {
            "Service": "lambda.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
    },
    {
        "Sid": "AllowEC2InstancesToAssumeThisRole",
        "Effect": "Allow",
        "Principal": {
            "Service": "ec2.amazonaws.com"
        },
        "Action": "sts:AssumeRole"
    }
]
}
```

------

Para obtener más información sobre las políticas de confianza, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la *Guía del usuario de IAM*.

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-analytics-dashboards-with-anonymous-users-step-2"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, puede obtener información sobre cómo autenticarse en nombre del visitante anónimo y obtener la URL del panel integrable en el servidor de su aplicación. 

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Transfiere un identificador como ID de sesión de rol único. Este código se ejecuta en el servidor de aplicaciones.

### Java
<a name="embedded-analytics-dashboards-with-anonymous-users-java"></a>

```
import java.util.List;
    import com.amazonaws.auth.AWSCredentials;
    import com.amazonaws.auth.AWSCredentialsProvider;
    import com.amazonaws.auth.BasicAWSCredentials;
    import com.amazonaws.regions.Regions;
    import com.amazonaws.services.quicksight.AmazonQuickSight;
    import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
    import com.amazonaws.services.quicksight.model.RegisteredUserDashboardEmbeddingConfiguration;
    import com.amazonaws.services.quicksight.model.AnonymousUserEmbeddingExperienceConfiguration;
    import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserRequest;
    import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserResult;
    import com.amazonaws.services.quicksight.model.SessionTag;


    /**
    * Class to call QuickSight AWS SDK to generate embed url for anonymous user.
    */
    public class GenerateEmbedUrlForAnonymousUserExample {

        private final AmazonQuickSight quickSightClient;

        public GenerateEmbedUrlForAnonymousUserExample() {
            quickSightClient = AmazonQuickSightClientBuilder
                .standard()
                .withRegion(Regions.US_EAST_1.getName())
                .withCredentials(new AWSCredentialsProvider() {
                        @Override
                        public AWSCredentials getCredentials() {
                            // provide actual IAM access key and secret key here
                            return new BasicAWSCredentials("access-key", "secret-key");
                        }

                        @Override
                        public void refresh() {
                        }
                    }
                )
                .build();
        }

        public String GenerateEmbedUrlForAnonymousUser(
            final String accountId, // YOUR AWS ACCOUNT ID
            final String initialDashboardId, // DASHBOARD ID TO WHICH THE CONSTRUCTED URL POINTS.
            final String namespace, // ANONYMOUS EMBEDDING REQUIRES SPECIFYING A VALID NAMESPACE FOR WHICH YOU WANT THE EMBEDDING URL
            final List<String> authorizedResourceArns, // DASHBOARD ARN LIST TO EMBED
            final List<String> allowedDomains, // RUNTIME ALLOWED DOMAINS FOR EMBEDDING
            final List<SessionTag> sessionTags // SESSION TAGS USED FOR ROW-LEVEL SECURITY
        ) throws Exception {
            AnonymousUserEmbeddingExperienceConfiguration experienceConfiguration = new AnonymousUserEmbeddingExperienceConfiguration();
            AnonymousUserDashboardEmbeddingConfiguration dashboardConfiguration = new AnonymousUserDashboardEmbeddingConfiguration();
            dashboardConfiguration.setInitialDashboardId(initialDashboardId);
            experienceConfiguration.setDashboard(dashboardConfiguration);

            GenerateEmbedUrlForAnonymousUserRequest generateEmbedUrlForAnonymousUserRequest = new GenerateEmbedUrlForAnonymousUserRequest()
                .withAwsAccountId(accountId)
                .withNamespace(namespace)
                .withAuthorizedResourceArns(authorizedResourceArns)
                .withExperienceConfiguration(experienceConfiguration)
                .withSessionTags(sessionTags)
                .withSessionLifetimeInMinutes(600L); // OPTIONAL: VALUE CAN BE [15-600]. DEFAULT: 600
                .withAllowedDomains(allowedDomains);

            GenerateEmbedUrlForAnonymousUserResult dashboardEmbedUrl = quickSightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserRequest);

            return dashboardEmbedUrl.getEmbedUrl();
        }

    }
```

### JavaScript
<a name="embedded-analytics-dashboards-with-anonymous-users-js"></a>

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function generateEmbedUrlForAnonymousUser(
accountId, // YOUR AWS ACCOUNT ID
initialDashboardId, // DASHBOARD ID TO WHICH THE CONSTRUCTED URL POINTS
quicksightNamespace, // VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
authorizedResourceArns, // DASHBOARD ARN LIST TO EMBED
allowedDomains, // RUNTIME ALLOWED DOMAINS FOR EMBEDDING
sessionTags, // SESSION TAGS USED FOR ROW-LEVEL SECURITY
generateEmbedUrlForAnonymousUserCallback, // GENERATEEMBEDURLFORANONYMOUSUSER SUCCESS CALLBACK METHOD
errorCallback // GENERATEEMBEDURLFORANONYMOUSUSER ERROR CALLBACK METHOD
) {
const experienceConfiguration = {
    "DashboardVisual": {
        "InitialDashboardVisualId": {
            "DashboardId": "dashboard_id",
            "SheetId": "sheet_id",
            "VisualId": "visual_id"
        }
    }
};

const generateEmbedUrlForAnonymousUserParams = {
    "AwsAccountId": accountId,
    "Namespace": quicksightNamespace,
    "AuthorizedResourceArns": authorizedResourceArns,
    "AllowedDomains": allowedDomains,
    "ExperienceConfiguration": experienceConfiguration,
    "SessionTags": sessionTags,
    "SessionLifetimeInMinutes": 600
};

const quicksightClient = new AWS.QuickSight({
    region: process.env.AWS_REGION,
    credentials: {
        accessKeyId: AccessKeyId,
        secretAccessKey: SecretAccessKey,
        sessionToken: SessionToken,
        expiration: Expiration
    }
});

quicksightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserParams, function(err, data) {
    if (err) {
        console.log(err, err.stack);
        errorCallback(err);
    } else {
        const result = {
            "statusCode": 200,
            "headers": {
                "Access-Control-Allow-Origin": "*", // USE YOUR WEBSITE DOMAIN TO SECURE ACCESS TO THIS API
                "Access-Control-Allow-Headers": "Content-Type"
            },
            "body": JSON.stringify(data),
            "isBase64Encoded": false
        }
        generateEmbedUrlForAnonymousUserCallback(result);
    }
});
}
```

### Python3
<a name="embedded-analytics-dashboards-with-anonymous-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError
import time

# Create QuickSight and STS clients
quicksightClient = boto3.client('quicksight',region_name='us-west-2')
sts = boto3.client('sts')

# Function to generate embedded URL for anonymous user
# accountId: YOUR AWS ACCOUNT ID
# quicksightNamespace: VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
# authorizedResourceArns: DASHBOARD ARN LIST TO EMBED
# allowedDomains: RUNTIME ALLOWED DOMAINS FOR EMBEDDING
# dashboardId: DASHBOARD ID TO WHICH THE CONSTRUCTED URL POINTS
# sessionTags: SESSION TAGS USED FOR ROW-LEVEL SECURITY
def generateEmbedUrlForAnonymousUser(accountId, quicksightNamespace, authorizedResourceArns, allowedDomains, dashboardId, sessionTags):
try:
    response = quicksightClient.generate_embed_url_for_anonymous_user(
        AwsAccountId = accountId,
        Namespace = quicksightNamespace,
        AuthorizedResourceArns = authorizedResourceArns,
        AllowedDomains = allowedDomains,
            ExperienceConfiguration = {
                "Dashboard": {
                    "InitialDashboardId": dashboardId
                }
            },
        SessionTags = sessionTags,
        SessionLifetimeInMinutes = 600
    )
        
    return {
        'statusCode': 200,
        'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
        'body': json.dumps(response),
        'isBase64Encoded':  bool('false')
    }
except ClientError as e:
    print(e)
    return "Error generating embeddedURL: " + str(e)
```

### Node.js
<a name="embedded-analytics-dashboards-with-anonymous-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
    const https = require('https');

    var quicksightClient = new AWS.Service({
        apiConfig: require('./quicksight-2018-04-01.min.json'),
        region: 'us-east-1',
    });

    quicksightClient.generateEmbedUrlForAnonymousUser({
        'AwsAccountId': '111122223333',
        'Namespace' : 'default',
        'AuthorizedResourceArns': authorizedResourceArns,
        'AllowedDomains': allowedDomains,
        'ExperienceConfiguration': experienceConfiguration,
        'SessionTags': sessionTags,
        'SessionLifetimeInMinutes': 600

    }, function(err, data) {
        console.log('Errors: ');
        console.log(err);
        console.log('Response: ');
        console.log(data);
    });
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
    //readability and added ellipsis to indicate that it's incomplete.
        { 
            Status: 200,
            EmbedUrl: 'https://quicksightdomain/embed/12345/dashboards/67890..',
            RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' 
        }
```

### .NET/C\$1
<a name="embedded-analytics-dashboards-with-anonymous-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
using System;
    using Amazon.QuickSight;
    using Amazon.QuickSight.Model;

    var quicksightClient = new AmazonQuickSightClient(
        AccessKey,
        SecretAccessKey,
        sessionToken,
        Amazon.RegionEndpoint.USEast1);
        
    try
    {
        Console.WriteLine(
            quicksightClient.GenerateEmbedUrlForAnonymousUserAsync(new GenerateEmbedUrlForAnonymousUserRequest
            {
                AwsAccountId = "111122223333",
                Namespace = default,
                AuthorizedResourceArns = authorizedResourceArns,
                AllowedDomains = allowedDomains,
                ExperienceConfiguration = experienceConfiguration,
                SessionTags = sessionTags,
                SessionLifetimeInMinutes = 600,
            }).Result.EmbedUrl
        );
    } catch (Exception ex) {
        Console.WriteLine(ex.Message);
    }
```

### AWS CLI
<a name="embedded-analytics-dashboards-with-anonymous-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar a su usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice el lenguaje de marcado de aserciones de seguridad (SAML) para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForAnonymousUser` habilitados. 

```
aws sts assume-role \
    --role-arn "arn:aws:iam::11112222333:role/QuickSightEmbeddingAnonymousPolicy" \
    --role-session-name anonymous caller
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
    export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
    export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_dashboard_role/QuickSightEmbeddingAnonymousPolicy`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario visitante. También mantiene cada sesión separada y distinta. Si utiliza una serie de servidores web, por ejemplo, para equilibrar la carga, y una sesión se vuelve a conectar a un servidor diferente, se inicia una nueva sesión.

Para obtener una URL firmada para el panel, llame a `generate-embed-url-for-anynymous-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un panel integrado mediante una llamada desde el servidor para los usuarios que realizan visitas anónimas a su portal web o aplicación.

```
aws quicksight generate-embed-url-for-anonymous-user \
--aws-account-id 111122223333 \
--namespace default-or-something-else \
--session-lifetime-in-minutes 15 \
--authorized-resource-arns '["dashboard-arn-1","dashboard-arn-2"]' \
--allowed-domains '["domain1","domain2"]' \
--session-tags '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]' \
--experience-configuration 'DashboardVisual={InitialDashboardVisualId={DashboardId=dashboard_id,SheetId=sheet_id,VisualId=visual_id}}'
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html). Puede utilizar esta y otras operaciones de la API en su propio código. 

## Paso 3 integración de la URL del panel
<a name="embedded-analytics-dashboards-with-anonymous-users-step-3"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, encontrará información sobre cómo utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL del panel de control del paso 2 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque el panel en una página HTML.
+ Transferir los parámetros al panel.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GenerateEmbedUrlForAnynymousUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida durante 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-anynymous-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
        {
            "Status": "200",
            "EmbedUrl": "https://quicksightdomain/embed/12345/dashboards/67890..",
            "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
        }
```

Inserte este panel en su página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Con el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros del panel de control y recibir llamadas en términos de errores o de finalización de la carga de la página. 

El dominio que va a alojar paneles integrados deben estar incluido en la *lista de permitidos*, la lista de dominios aprobados de la suscripción a Quick . Este requisito protege los datos impidiendo que dominios no aprobados alojen paneles integrados. Para obtener más información sobre cómo añadir dominios para los paneles integrados, consulte [Permitir la publicación de dominios en tiempo de ejecución con la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-run-time.html).

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código reside en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-analytics-dashboards-with-anonymous-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

<head>
    <title>Dashboard Embedding Example</title>
    <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
    <script type="text/javascript">
        const embedDashboard = async() => {
            const {
                createEmbeddingContext,
            } = QuickSightEmbedding;

            const embeddingContext = await createEmbeddingContext({
                onChange: (changeEvent, metadata) => {
                    console.log('Context received a change', changeEvent, metadata);
                },
            });

            const frameOptions = {
                url: '<YOUR_EMBED_URL>',
                container: '#experience-container',
                height: "700px",
                width: "1000px",
                onChange: (changeEvent, metadata) => {
                    switch (changeEvent.eventName) {
                        case 'FRAME_MOUNTED': {
                            console.log("Do something when the experience frame is mounted.");
                            break;
                        }
                        case 'FRAME_LOADED': {
                            console.log("Do something when the experience frame is loaded.");
                            break;
                        }
                    }
                },
            };

            const contentOptions = {
                parameters: [
                    {
                        Name: 'country',
                        Values: [
                            'United States'
                        ],
                    },
                    {
                        Name: 'states',
                        Values: [
                            'California',
                            'Washington'
                        ]
                    }
                ],
                locale: "en-US",
                sheetOptions: {
                    initialSheetId: '<YOUR_SHEETID>',
                    singleSheet: false,                        
                    emitSizeChangedEventOnSheetChange: false,
                },
                toolbarOptions: {
                    export: false,
                    undoRedo: false,
                    reset: false
                },
                attributionOptions: {
                    overlayContent: false,
                },
                onMessage: async (messageEvent, experienceMetadata) => {
                    switch (messageEvent.eventName) {
                        case 'CONTENT_LOADED': {
                            console.log("All visuals are loaded. The title of the document:", messageEvent.message.title);
                            break;
                        }
                        case 'ERROR_OCCURRED': {
                            console.log("Error occurred while rendering the experience. Error code:", messageEvent.message.errorCode);
                            break;
                        }
                        case 'PARAMETERS_CHANGED': {
                            console.log("Parameters changed. Changed parameters:", messageEvent.message.changedParameters);
                            break;
                        }
                        case 'SELECTED_SHEET_CHANGED': {
                            console.log("Selected sheet changed. Selected sheet:", messageEvent.message.selectedSheet);
                            break;
                        }
                        case 'SIZE_CHANGED': {
                            console.log("Size changed. New dimensions:", messageEvent.message);
                            break;
                        }
                        case 'MODAL_OPENED': {
                            window.scrollTo({
                                top: 0 // iframe top position
                            });
                            break;
                        }
                    }
                },
            };
            const embeddedDashboardExperience = await embeddingContext.embedDashboard(frameOptions, contentOptions);

            const selectCountryElement = document.getElementById('country');
            selectCountryElement.addEventListener('change', (event) => {
                embeddedDashboardExperience.setParameters([
                    {
                        Name: 'country',
                        Values: event.target.value
                    }
                ]);
            });
        };
    </script>
</head>

<body onload="embedDashboard()">
    <span>
        <label for="country">Country</label>
        <select id="country" name="country">
            <option value="United States">United States</option>
            <option value="Mexico">Mexico</option>
            <option value="Canada">Canada</option>
        </select>
    </span>
    <div id="experience-container"></div>
</body>

</html>
```

### SDK 1.0
<a name="embedded-analytics-dashboards-with-anonymous-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

<head>
    <title>Basic Embed</title>
    <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@1.0.15/dist/quicksight-embedding-js-sdk.min.js"></script>
    <script type="text/javascript">
        var dashboard
        function onDashboardLoad(payload) {
            console.log("Do something when the dashboard is fully loaded.");
        }

        function onError(payload) {
            console.log("Do something when the dashboard fails loading");
        }

        function embedDashboard() {
            var containerDiv = document.getElementById("embeddingContainer");
            var options = {
                // replace this dummy url with the one generated via embedding API
                url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode",
                container: containerDiv,
                parameters: {
                    country: "United States"
                },
                scrolling: "no",
                height: "700px",
                width: "1000px",
                locale: "en-US",
                footerPaddingEnabled: true
            };
            dashboard = QuickSightEmbedding.embedDashboard(options);
            dashboard.on("error", onError);
            dashboard.on("load", onDashboardLoad);
        }

        function onCountryChange(obj) {
            dashboard.setParameters({country: obj.value});
        }
    </script>
</head>

<body onload="embedDashboard()">
    <span>
        <label for="country">Country</label>
        <select id="country" name="country" onchange="onCountryChange(this)">
            <option value="United States">United States</option>
            <option value="Mexico">Mexico</option>
            <option value="Canada">Canada</option>
        </select>
    </span>
    <div id="embeddingContainer"></div>
</body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el panel integrado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación de Amazon Quick Sight desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usa `npm` para JavaScript dependencias, descárguelo e instálelo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Activación de resúmenes ejecutivos en paneles incrustados
<a name="embedded-analytics-genbi-executive-summaries-dashboard"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Puede activar los resúmenes ejecutivos en los paneles incrustados. Cuando está habilitada, los usuarios registrados pueden generar resúmenes ejecutivos que proporcionan un resumen de toda la información que Amazon Quick Sight ha generado para el panel de control. Los resúmenes ejecutivos facilitan a los lectores la búsqueda de información y datos clave sobre un panel. Para obtener más información sobre cómo los usuarios generan un resumen ejecutivo de un panel, consulte [Generar un resumen ejecutivo de un panel de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/use-executive-summaries.html).

**nota**  
Los resúmenes ejecutivos solo están disponibles en los paneles incrustados para los usuarios registrados y no se pueden activar en los paneles incrustados para los usuarios anónimos o no registrados.

**Activación de los resúmenes ejecutivos en paneles incrustados para usuarios registrados**
+ Siga los pasos que se indican en [Incrustar paneles de Amazon Quick Sight para que los usuarios registrados puedan](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics-dashboards-for-authenticated-users.html) incrustar un panel con los siguientes cambios:

  1. Al generar la URL en el paso 2, defina el `ExecutiveSummary` parámetro `Enabled: true` en [GenerateEmbedUrlForRegisteredUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html)o, tal y [GenerateEmbedUrlForRegisteredUserWithIdentity](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUserWithIdentity.html)como se muestra en el siguiente ejemplo:

     ```
     ExperienceConfiguration: {
             Dashboard: {
                 InitialDashboardId: dashboard_id,
                 FeatureConfigurations: {
                     AmazonQInQuickSight: {
                         ExecutiveSummary: {
                             Enabled: true
                         }
                     }
                 }
             }
         }
     }
     ```

  1. Al incrustar la URL del panel con el SDK de incrustación de Amazon Quick Sight en el paso 3, `executiveSummary: true` configúrelo`contentOptions`, como se muestra en el siguiente ejemplo:

     ```
     const contentOptions = {
         toolbarOptions: {
             executiveSummary: true
         }
     };
     ```

# Integración de imágenes de Amazon Quick Sight con Amazon Quick Sight APIs
<a name="embedding-visuals"></a>

Puede incrustar imágenes individuales que formen parte de un panel publicado en su aplicación con la API Amazon Quick Sight.

**Topics**
+ [Incrustar imágenes de Amazon Quick Sight para usuarios registrados](embedded-analytics-visuals-for-authenticated-users.md)
+ [Incrustar imágenes de Amazon Quick Sight para usuarios anónimos (no registrados)](embedded-analytics-visuals-for-everyone.md)

# Incrustar imágenes de Amazon Quick Sight para usuarios registrados
<a name="embedded-analytics-visuals-for-authenticated-users"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, encontrará información detallada sobre cómo configurar las imágenes integradas de Amazon Quick Sight para los usuarios registrados de Amazon Quick Sight.

**Topics**
+ [Paso 1: configuración de permisos](#embedded-visuals-for-authenticated-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-visuals-for-authenticated-users-step-2)
+ [Paso 3: integración de la URL del elemento visual](#embedded-visuals-for-authenticated-users-step-3)

## Paso 1: configuración de permisos
<a name="embedded-visuals-for-authenticated-users-step-1"></a>

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a una imagen asume una función que le da acceso a Amazon Quick Sight y permisos para acceder a la imagen. Para que esto sea posible, cree un rol de IAM en su. Cuenta de AWS Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. El rol de IAM debe proporcionar permisos para recuperar la incrustación de un grupo URLs de usuarios específico. Con la ayuda del carácter comodín *\$1*, puede conceder los permisos para generar una URL para todos los usuarios de un espacio de nombres específico, o para un subconjunto de usuarios de espacios de nombres específicos. Para ello, añada `quicksight:GenerateEmbedUrlForRegisteredUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForAnonymousUser`. El parámetro `AllowedDomains` es opcional. Como desarrollador, tiene la opción de anular los dominios estáticos que están configurados en el menú **Gestionar Amazon Quick Sight**. En su lugar, puede enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web que cree. Solo los dominios que aparecen en el parámetro pueden acceder al panel integrado. Sin esta condición, usted puede incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForRegisteredUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente tiene el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La siguiente política de ejemplo ofrece estos permisos.

Además, si va a crear usuarios primerizos que vayan a ser lectores de Amazon Quick Sight, asegúrese de añadir el `quicksight:RegisterUser` permiso en la política.

El siguiente ejemplo de política proporciona permiso para recuperar una URL incrustada para los usuarios primerizos que vayan a ser lectores de Amazon Quick Sight.

Finalmente, la identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o SAML, consulte las siguientes secciones de la *Guía del usuario de IAM: *
+ [Creación de un rol para identidades federadas web u OpenID Connect (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-visuals-for-authenticated-users-step-2"></a>

En la siguiente sección, encontrarás información sobre cómo autenticar a tu usuario de Amazon Quick Sight y obtener la URL visual integrable en tu servidor de aplicaciones. Si planea incrustar imágenes para los tipos de identidad de IAM o Amazon Quick Sight, comparta las imágenes con los usuarios de Amazon Quick Sight.

Cuando un usuario de Amazon Quick Sight accede a tu aplicación, la aplicación asume la función de IAM en nombre del usuario de Amazon Quick Sight. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario de Amazon Quick Sight aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar los pasos descritos, se garantiza que cada espectador de la imagen se aprovisione de forma única en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario de Amazon Quick Sight. Este código se ejecuta en el servidor de aplicaciones.

### Java
<a name="embedded-visuals-for-authenticated-users-java"></a>

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.DashboardVisualId;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserRequest;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserResult;
import com.amazonaws.services.quicksight.model.RegisteredUserDashboardVisualEmbeddingConfiguration;
import com.amazonaws.services.quicksight.model.RegisteredUserEmbeddingExperienceConfiguration;

import java.util.List;

/**
 * Class to call QuickSight AWS SDK to get url for Visual embedding.
 */
public class GenerateEmbedUrlForRegisteredUserTest {

    private final AmazonQuickSight quickSightClient;

    public GenerateEmbedUrlForRegisteredUserTest() {
        this.quickSightClient = AmazonQuickSightClientBuilder
            .standard()
            .withRegion(Regions.US_EAST_1.getName())
            .withCredentials(new AWSCredentialsProvider() {
                    @Override
                    public AWSCredentials getCredentials() {
                        // provide actual IAM access key and secret key here
                        return new BasicAWSCredentials("access-key", "secret-key");
                    }

                    @Override
                    public void refresh() {                        
                    }
                }
            )
            .build();
    }

    public String getEmbedUrl(
            final String accountId, // AWS Account ID
            final String dashboardId, // Dashboard ID of the dashboard to embed
            final String sheetId, // Sheet ID of the sheet to embed
            final String visualId, // Visual ID of the visual to embed
            final List<String> allowedDomains, // Runtime allowed domains for embedding
            final String userArn // Registered user arn of the user that you want to provide embedded visual. Refer to Get Embed Url section in developer portal to find out how to get user arn for a QuickSight user.
    ) throws Exception {
        final DashboardVisualId dashboardVisual = new DashboardVisualId()
            .withDashboardId(dashboardId)
            .withSheetId(sheetId)
            .withVisualId(visualId);
        final RegisteredUserDashboardVisualEmbeddingConfiguration registeredUserDashboardVisualEmbeddingConfiguration
            = new RegisteredUserDashboardVisualEmbeddingConfiguration()
                .withInitialDashboardVisualId(dashboardVisual);
        final RegisteredUserEmbeddingExperienceConfiguration registeredUserEmbeddingExperienceConfiguration
            = new RegisteredUserEmbeddingExperienceConfiguration()
                .withDashboardVisual(registeredUserDashboardVisualEmbeddingConfiguration);
        final GenerateEmbedUrlForRegisteredUserRequest generateEmbedUrlForRegisteredUserRequest
            = new GenerateEmbedUrlForRegisteredUserRequest()
                .withAwsAccountId(accountId)
                .withUserArn(userArn)
                .withExperienceConfiguration(registeredUserEmbeddingExperienceConfiguration)
                .withAllowedDomains(allowedDomains);

        final GenerateEmbedUrlForRegisteredUserResult generateEmbedUrlForRegisteredUserResult = quickSightClient.generateEmbedUrlForRegisteredUser(generateEmbedUrlForRegisteredUserRequest);

        return generateEmbedUrlForRegisteredUserResult.getEmbedUrl();
    }
}
```

### JavaScript
<a name="embedded-visuals-for-authenticated-users-js"></a>

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function generateEmbedUrlForRegisteredUser(
    accountId, // Your AWS account ID
    dashboardId, // Dashboard ID to which the constructed URL points
    sheetId, // Sheet ID to which the constructed URL points
    visualId, // Visual ID to which the constructed URL points
    openIdToken, // Cognito-based token
    userArn, // registered user arn
    roleArn, // IAM user role to use for embedding
    sessionName, // Session name for the roleArn assume role
    allowedDomains, // Runtime allowed domain for embedding
    getEmbedUrlCallback, // GetEmbedUrl success callback method
    errorCallback // GetEmbedUrl error callback method
    ) {
    const stsClient = new AWS.STS();
    let stsParams = {
        RoleSessionName: sessionName,
        WebIdentityToken: openIdToken,
        RoleArn: roleArn
    }

    stsClient.assumeRoleWithWebIdentity(stsParams, function(err, data) {
        if (err) {
            console.log('Error assuming role');
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const getDashboardParams = {
                "AwsAccountId": accountId,
                "ExperienceConfiguration": {
                    "DashboardVisual": {
                        "InitialDashboardVisualId": {
                            "DashboardId": dashboardId,
                            "SheetId": sheetId,
                            "VisualId": visualId
                        }
                    }
                },
                "UserArn": userArn,
                "AllowedDomains": allowedDomains,
                "SessionLifetimeInMinutes": 600
            };

            const quicksightGetDashboard = new AWS.QuickSight({
                region: process.env.AWS_REGION,
                credentials: {
                    accessKeyId: data.Credentials.AccessKeyId,
                    secretAccessKey: data.Credentials.SecretAccessKey,
                    sessionToken: data.Credentials.SessionToken,
                    expiration: data.Credentials.Expiration
                }
            });

            quicksightGetDashboard.generateEmbedUrlForRegisteredUser(getDashboardParams, function(err, data) {
                if (err) {
                    console.log(err, err.stack);
                    errorCallback(err);
                } else {
                    const result = {
                        "statusCode": 200,
                        "headers": {
                            "Access-Control-Allow-Origin": "*", // Use your website domain to secure access to GetEmbedUrl API
                            "Access-Control-Allow-Headers": "Content-Type"
                        },
                        "body": JSON.stringify(data),
                        "isBase64Encoded": false
                    }
                    getEmbedUrlCallback(result);
                }
            });
        }
    });
}
```

### Python3
<a name="embedded-visuals-for-authenticated-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError

sts = boto3.client('sts')

# Function to generate embedded URL  
# accountId: AWS account ID
# dashboardId: Dashboard ID to embed
# sheetId: SHEET ID to embed from the dashboard 
# visualId: Id for the Visual you want to embedded from the dashboard sheet. 
# userArn: arn of registered user
# allowedDomains: Runtime allowed domain for embedding
# roleArn: IAM user role to use for embedding
# sessionName: session name for the roleArn assume role
def getEmbeddingURL(accountId, dashboardId, sheetId, visualId, userArn, allowedDomains, roleArn, sessionName):
    try:
        assumedRole = sts.assume_role(
            RoleArn = roleArn,
            RoleSessionName = sessionName,
        )
    except ClientError as e:
        return "Error assuming role: " + str(e)
    else: 
        assumedRoleSession = boto3.Session(
            aws_access_key_id = assumedRole['Credentials']['AccessKeyId'],
            aws_secret_access_key = assumedRole['Credentials']['SecretAccessKey'],
            aws_session_token = assumedRole['Credentials']['SessionToken'],
        )
        try:
            quicksightClient = assumedRoleSession.client('quicksight', region_name='us-west-2')
            response = quicksightClient.generate_embed_url_for_registered_user(
                AwsAccountId=accountId,
                ExperienceConfiguration = {
                    'DashboardVisual': {
                        'InitialDashboardVisualId': {
                            'DashboardId': dashboardId,
                            'SheetId': sheetId,
                            'VisualId': visualId
                        }
                    },
                },
                UserArn = userArn,
                AllowedDomains = allowedDomains,
                SessionLifetimeInMinutes = 600
            )
            
            return {
                'statusCode': 200,
                'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
                'body': json.dumps(response),
                'isBase64Encoded':  bool('false')
            }
        except ClientError as e:
            return "Error generating embedding url: " + str(e)
```

### Node.js
<a name="embedded-visuals-for-authenticated-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    apiConfig: require('./quicksight-2018-04-01.min.json'),
    region: 'us-east-1',
});

quicksightClient.generateEmbedUrlForRegisteredUser({
    'AwsAccountId': '111122223333',
    'ExperienceConfiguration': { 
        'DashboardVisual': {
            'InitialDashboardVisualId': {
                'DashboardId': 'dashboard_id',
                'SheetId': 'sheet_id',
                'VisualId': 'visual_id'
            }
        }
    },
    'UserArn': 'REGISTERED_USER_ARN',
    'AllowedDomains': allowedDomains,
    'SessionLifetimeInMinutes': 100
}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    {
        "Status": "200",
        "EmbedUrl": "https://quicksightdomain/embed/12345/dashboards/67890/sheets/12345/visuals/67890...",
        "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
    }
```

### .NET/C\$1
<a name="embedded-visuals-for-authenticated-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateDashboardEmbedUrlForRegisteredUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                DashboardVisualId dashboardVisual = new DashboardVisualId
                {
                    DashboardId = "dashboard_id",
                    SheetId = "sheet_id",
                    VisualId = "visual_id"
                };

                RegisteredUserDashboardVisualEmbeddingConfiguration registeredUserDashboardVisualEmbeddingConfiguration
                    = new RegisteredUserDashboardVisualEmbeddingConfiguration
                    {
                        InitialDashboardVisualId = dashboardVisual                        
                    };               
                    
                RegisteredUserEmbeddingExperienceConfiguration registeredUserEmbeddingExperienceConfiguration
                    = new RegisteredUserEmbeddingExperienceConfiguration
                    {
                        DashboardVisual = registeredUserDashboardVisualEmbeddingConfiguration
                    };
                    
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForRegisteredUserAsync(new GenerateEmbedUrlForRegisteredUserRequest
                    {
                        AwsAccountId = "111122223333",
                        ExperienceConfiguration = registeredUserEmbeddingExperienceConfiguration,
                        UserArn = "REGISTERED_USER_ARN",
                        AllowedDomains = allowedDomains,
                        SessionLifetimeInMinutes = 100
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

### AWS CLI
<a name="embedded-visuals-for-authenticated-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar a su usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Usa esta operación cuando utilices SAML para autenticar a tus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForRegisteredUser` habilitados. Si opta por añadir usuarios just-in-time la primera vez que abren un panel de control, el rol también necesita tener habilitados los permisos. `quicksight:RegisterUser`

```
aws sts assume-role \
    --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_visual_role" \
    --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
    export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
    export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_visual_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan al panel de control. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
    --aws-account-id 111122223333 \
    --namespace default \
    --identity-type IAM \
    --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_visual_role" \
    --user-role READER \
    --user-name jhnd \
    --session-name "john.doe@example.com" \
    --email john.doe@example.com \
    --region us-east-1 \
    --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el ARN del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puede añadir este usuario al grupo con el que se comparte la imagen. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
    --aws-account-id=111122223333 \
    --namespace=default \
    --group-name=financeusers \
    --member-name="embedding_quicksight_visual_role/john.doe@example.com"
```

Ahora tienes un usuario de tu aplicación que también es usuario de Amazon Quick Sight y que tiene acceso a lo visual. 

Por último, para obtener una URL firmada para el elemento visual, llame a `generate-embed-url-for-registered-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del elemento visual integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un elemento visual incrustado mediante una llamada desde el servidor para los usuarios autenticados mediante AWS Managed Microsoft AD un inicio de sesión único (IAM Identity Center).

```
aws quicksight generate-embed-url-for-registered-user \
    --aws-account-id 111122223333 \
    --session-lifetime-in-minutes 600 \
    --user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/embedding_quicksight_visual_role/embeddingsession \
    --allowed-domains '["domain1","domain2"]' \
    --experience-configuration 'DashboardVisual={InitialDashboardVisualId={DashboardId=dashboard_id,SheetId=sheet_id,VisualId=visual_id}}'
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html). Puede utilizar esta y otras operaciones de la API en su propio código.

## Paso 3: integración de la URL del elemento visual
<a name="embedded-visuals-for-authenticated-users-step-3"></a>

En la siguiente sección, encontrará información sobre cómo utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL visual del paso 3 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque el elemento visual en una página HTML.
+ Pase los parámetros al elemento visual.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GenerateEmbedUrlForRegisteredUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-registered-user`. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    {
        "Status": "200",
        "EmbedUrl": "https://quicksightdomain/embed/12345/dashboards/67890/sheets/12345/visuals/67890...",
        "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
    }
```

Inserta esta imagen en tu página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Con el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros visuales y recibir llamadas en función de la finalización de la carga de la página y de los errores. 

El dominio que alojará las imágenes y los paneles integrados debe figurar en la *lista de dominios permitidos*, es decir, los dominios aprobados para la suscripción. Quick Este requisito protege los datos impidiendo que dominios no aprobados alojen elementos visuales y paneles integrados. Para obtener más información sobre cómo añadir dominios para imágenes y paneles integrados, consulte [Permitir la publicación de dominios en tiempo de ejecución con la API Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-run-time.html).

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-visuals-for-authenticated-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Visual Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedVisual = async() => {    
                const {
                    createEmbeddingContext,
                } = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    parameters: [
                        {
                            Name: 'country',
                            Values: ['United States'],
                        },
                        {
                            Name: 'states',
                            Values: [
                                'California',
                                'Washington'
                            ]
                        }
                    ],
                    locale: "en-US",
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'CONTENT_LOADED': {
                                console.log("All visuals are loaded. The title of the document:", messageEvent.message.title);
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Error occurred while rendering the experience. Error code:", messageEvent.message.errorCode);
                                break;
                            }
                            case 'PARAMETERS_CHANGED': {
                                console.log("Parameters changed. Changed parameters:", messageEvent.message.changedParameters);
                                break;
                            }
                            case 'SIZE_CHANGED': {
                                console.log("Size changed. New dimensions:", messageEvent.message);
                                break;
                            }
                        }
                    },
                };
                const embeddedVisualExperience = await embeddingContext.embedVisual(frameOptions, contentOptions);

                const selectCountryElement = document.getElementById('country');
                selectCountryElement.addEventListener('change', (event) => {
                    embeddedVisualExperience.setParameters([
                        {
                            Name: 'country',
                            Values: event.target.value
                        }
                    ]);
                });
            };
        </script>
    </head>

    <body onload="embedVisual()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="experience-container"></div>
    </body>

</html>
```

### SDK 1.0
<a name="embedded-visuals-for-authenticated-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Visual Embedding Example</title>
        <!-- You can download the latest QuickSight embedding SDK version from https://www.npmjs.com/package/amazon-quicksight-embedding-sdk -->
        <!-- Or you can do "npm install amazon-quicksight-embedding-sdk", if you use npm for javascript dependencies -->
        <script src="./quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            let embeddedVisualExperience;
            function onVisualLoad(payload) {
                console.log("Do something when the visual is fully loaded.");
            }

            function onError(payload) {
                console.log("Do something when the visual fails loading");
            }

            function embedVisual() {
                const containerDiv = document.getElementById("embeddingContainer");
                const options = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: containerDiv,
                    parameters: {
                        country: "United States"
                    },
                    height: "700px",
                    width: "1000px",
                    locale: "en-US"
                };
                embeddedVisualExperience = QuickSightEmbedding.embedVisual(options);
                embeddedVisualExperience.on("error", onError);
                embeddedVisualExperience.on("load", onVisualLoad);
            }

            function onCountryChange(obj) {
                embeddedVisualExperience.setParameters({country: obj.value});
            }
        </script>
    </head>

    <body onload="embedVisual()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country" onchange="onCountryChange(this)">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="embeddingContainer"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el elemento visual incrustado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Incrustar imágenes de Amazon Quick Sight para usuarios anónimos (no registrados)
<a name="embedded-analytics-visuals-for-everyone"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, encontrará información detallada sobre cómo configurar las imágenes integradas de Amazon Quick Sight para usuarios anónimos (no registrados).

**Topics**
+ [Paso 1: configuración de permisos](#embedded-analytics-visuals-with-anonymous-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-analytics-visuals-with-anonymous-users-step-2)
+ [Paso 3: integración de la URL del elemento visual](#embedded-analytics-visuals-with-anonymous-users-step-3)

## Paso 1: configuración de permisos
<a name="embedded-analytics-visuals-with-anonymous-users-step-1"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a una imagen asume una función que le da acceso a Amazon Quick Sight y permisos para acceder a la imagen. Para que esto sea posible, cree un rol de IAM en su. Cuenta de AWS Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForAnonymousUser`. El parámetro `AllowedDomains` es opcional. Como desarrollador, tiene la opción de anular los dominios estáticos que están configurados en el menú **Gestionar Amazon Quick Sight**. En su lugar, puede enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web que cree. Solo los dominios que aparecen en el parámetro pueden acceder al panel integrado. Sin esta condición, usted puede incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForAnonymousUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente se traduce en el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que, cuando un usuario accede a su aplicación, esta puede asumir el rol en nombre del usuario para abrir el elemento visual. En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la *Guía del usuario de IAM*.

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-analytics-visuals-with-anonymous-users-step-2"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, puede obtener información sobre cómo autenticar el usuario y obtener la URL del elemento visual integrable en el servidor de su aplicación.

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Transfiere un identificador como ID de sesión de rol único. Este código se ejecuta en el servidor de aplicaciones.

### Java
<a name="embedded-analytics-visuals-with-anonymous-users-java"></a>

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.AnonymousUserDashboardVisualEmbeddingConfiguration;
import com.amazonaws.services.quicksight.model.AnonymousUserEmbeddingExperienceConfiguration;
import com.amazonaws.services.quicksight.model.DashboardVisualId;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserRequest;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserResult;
import com.amazonaws.services.quicksight.model.SessionTag;

import java.util.List;

/**
 * Class to call QuickSight AWS SDK to get url for Visual embedding.
 */
public class GenerateEmbedUrlForAnonymousUserTest {
    private final AmazonQuickSight quickSightClient;

    public GenerateEmbedUrlForAnonymousUserTest() {
        this.quickSightClient = AmazonQuickSightClientBuilder
            .standard()
            .withRegion(Regions.US_EAST_1.getName())
            .withCredentials(new AWSCredentialsProvider() {
                    @Override
                    public AWSCredentials getCredentials() {
                        // provide actual IAM access key and secret key here
                        return new BasicAWSCredentials("access-key", "secret-key");
                    }

                    @Override
                    public void refresh() {                           
                    }
                }
            )
            .build();
    }

    public String getEmbedUrl(
            final String accountId, // AWS Account ID
            final String namespace, // Anonymous embedding required specifying a valid namespace for which you want the enbedding URL
            final List<String> authorizedResourceArns, // Dashboard arn list of dashboard visuals to embed
            final String dashboardId, // Dashboard ID of the dashboard to embed
            final String sheetId, // Sheet ID of the sheet to embed
            final String visualId, // Visual ID of the visual to embed
            final List<String> allowedDomains, // Runtime allowed domains for embedding
            final List<SessionTag> sessionTags // Session tags used for row-level security
    ) throws Exception {
        final DashboardVisualId dashboardVisual = new DashboardVisualId()
            .withDashboardId(dashboardId)
            .withSheetId(sheetId)
            .withVisualId(visualId);
        final AnonymousUserDashboardVisualEmbeddingConfiguration anonymousUserDashboardVisualEmbeddingConfiguration
            = new AnonymousUserDashboardVisualEmbeddingConfiguration()
                .withInitialDashboardVisualId(dashboardVisual);
        final AnonymousUserEmbeddingExperienceConfiguration anonymousUserEmbeddingExperienceConfiguration
            = new AnonymousUserEmbeddingExperienceConfiguration()
                .withDashboardVisual(anonymousUserDashboardVisualEmbeddingConfiguration);
        final GenerateEmbedUrlForAnonymousUserRequest generateEmbedUrlForAnonymousUserRequest
            = new GenerateEmbedUrlForAnonymousUserRequest()
                .withAwsAccountId(accountId)
                .withNamespace(namespace)
                // authorizedResourceArns should contain ARN of dashboard used below in ExperienceConfiguration
                .withAuthorizedResourceArns(authorizedResourceArns)
                .withExperienceConfiguration(anonymousUserEmbeddingExperienceConfiguration)
                .withAllowedDomains(allowedDomains)
                .withSessionTags(sessionTags)
                .withSessionLifetimeInMinutes(600L);

        final GenerateEmbedUrlForAnonymousUserResult generateEmbedUrlForAnonymousUserResult
            = quickSightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserRequest);

        return generateEmbedUrlForAnonymousUserResult.getEmbedUrl();
    }
}
```

### JavaScript
<a name="embedded-analytics-visuals-with-anonymous-users-js"></a>

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function generateEmbedUrlForAnonymousUser(
    accountId, // Your AWS account ID
    dashboardId, // Dashboard ID to which the constructed url points
    sheetId, // Sheet ID to which the constructed url points
    visualId, // Visual ID to which the constructed url points
    quicksightNamespace, // valid namespace where you want to do embedding
    authorizedResourceArns, // dashboard arn list of dashboard visuals to embed
    allowedDomains, // runtime allowed domains for embedding
    sessionTags, // session tags used for row-level security
    generateEmbedUrlForAnonymousUserCallback, // success callback method
    errorCallback // error callback method
    ) {
    const experienceConfiguration = {
        "DashboardVisual": {
            "InitialDashboardVisualId": {
                "DashboardId": dashboardId,
                "SheetId": sheetId,
                "VisualId": visualId
            }
        }
    };
    
    const generateEmbedUrlForAnonymousUserParams = {
        "AwsAccountId": accountId,
        "Namespace": quicksightNamespace,
        // authorizedResourceArns should contain ARN of dashboard used below in ExperienceConfiguration
        "AuthorizedResourceArns": authorizedResourceArns,
        "AllowedDomains": allowedDomains,
        "ExperienceConfiguration": experienceConfiguration,
        "SessionTags": sessionTags,
        "SessionLifetimeInMinutes": 600
    };

    const quicksightClient = new AWS.QuickSight({
        region: process.env.AWS_REGION,
        credentials: {
            accessKeyId: AccessKeyId,
            secretAccessKey: SecretAccessKey,
            sessionToken: SessionToken,
            expiration: Expiration
        }
    });

    quicksightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserParams, function(err, data) {
        if (err) {
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const result = {
                "statusCode": 200,
                "headers": {
                    "Access-Control-Allow-Origin": "*", // USE YOUR WEBSITE DOMAIN TO SECURE ACCESS TO THIS API
                    "Access-Control-Allow-Headers": "Content-Type"
                },
                "body": JSON.stringify(data),
                "isBase64Encoded": false
            }
            generateEmbedUrlForAnonymousUserCallback(result);
        }
    });
}
```

### Python3
<a name="embedded-analytics-visuals-with-anonymous-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError
import time

# Create QuickSight and STS clients
quicksightClient = boto3.client('quicksight',region_name='us-west-2')
sts = boto3.client('sts')

# Function to generate embedded URL for anonymous user
# accountId: YOUR AWS ACCOUNT ID
# quicksightNamespace: VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
# authorizedResourceArns: DASHBOARD ARN LIST TO EMBED
# allowedDomains: RUNTIME ALLOWED DOMAINS FOR EMBEDDING
# experienceConfiguration: DASHBOARD ID, SHEET ID and VISUAL ID TO WHICH THE CONSTRUCTED URL POINTS
# Example experienceConfig -> 'DashboardVisual': {
#     'InitialDashboardVisualId': {
#         'DashboardId': 'dashboardId',
#         'SheetId': 'sheetId',
#         'VisualId': 'visualId'
#     }
# },
# sessionTags: SESSION TAGS USED FOR ROW-LEVEL SECURITY
def generateEmbedUrlForAnonymousUser(accountId, quicksightNamespace, authorizedResourceArns, allowedDomains, experienceConfiguration, sessionTags):
    try:
        response = quicksightClient.generate_embed_url_for_anonymous_user(
            AwsAccountId = accountId,
            Namespace = quicksightNamespace,
            AuthorizedResourceArns = authorizedResourceArns,
            AllowedDomains = allowedDomains,
            ExperienceConfiguration = experienceConfiguration,
            SessionTags = sessionTags,
            SessionLifetimeInMinutes = 600
        )
            
        return {
            'statusCode': 200,
            'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
            'body': json.dumps(response),
            'isBase64Encoded':  bool('false')
        }
    except ClientError as e:
        print(e)
        return "Error generating embeddedURL: " + str(e)
```

### Node.js
<a name="embedded-analytics-visuals-with-anonymous-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    apiConfig: require('./quicksight-2018-04-01.min.json'),
    region: 'us-east-1',
});

quicksightClient.generateEmbedUrlForAnonymousUser({
    'AwsAccountId': '111122223333',
    'Namespace' : 'default',
    // authorizedResourceArns should contain ARN of dashboard used below in ExperienceConfiguration
    'AuthorizedResourceArns': authorizedResourceArns,
    'ExperienceConfiguration': { 
        'DashboardVisual': {
            'InitialDashboardVisualId': {
                'DashboardId': 'dashboard_id',
                'SheetId': 'sheet_id',
                'VisualId': 'visual_id'
            }
        }
    },
    'AllowedDomains': allowedDomains,    
    'SessionTags': sessionTags,
    'SessionLifetimeInMinutes': 600

}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    {
        "Status": "200",
        "EmbedUrl": "https://quicksightdomain/embed/12345/dashboards/67890/sheets/12345/visuals/67890...",
        "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
    }
```

### .NET/C\$1
<a name="embedded-analytics-visuals-with-anonymous-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateDashboardEmbedUrlForAnonymousUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                DashboardVisualId dashboardVisual = new DashboardVisualId
                {
                    DashboardId = "dashboard_id",
                    SheetId = "sheet_id",
                    VisualId = "visual_id"
                };

                AnonymousUserDashboardVisualEmbeddingConfiguration anonymousUserDashboardVisualEmbeddingConfiguration
                    = new AnonymousUserDashboardVisualEmbeddingConfiguration
                    {
                        InitialDashboardVisualId = dashboardVisual                        
                    };               
                    
                AnonymousUserEmbeddingExperienceConfiguration anonymousUserEmbeddingExperienceConfiguration
                    = new AnonymousUserEmbeddingExperienceConfiguration
                    {
                        DashboardVisual = anonymousUserDashboardVisualEmbeddingConfiguration
                    }; 
                    
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForAnonymousUserAsync(new GenerateEmbedUrlForAnonymousUserRequest
                    {
                        AwsAccountId = "111222333444",
                        Namespace = default,
                        // authorizedResourceArns should contain ARN of dashboard used below in ExperienceConfiguration
                        AuthorizedResourceArns = { "dashboard_id" },
                        ExperienceConfiguration = anonymousUserEmbeddingExperienceConfiguration,
                        SessionTags = sessionTags,
                        SessionLifetimeInMinutes = 600,
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

### AWS CLI
<a name="embedded-analytics-visuals-with-anonymous-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar a su usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice el lenguaje de marcado de aserciones de seguridad (SAML) para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForAnonymousUser` habilitados. 

```
aws sts assume-role \
    --role-arn "arn:aws:iam::11112222333:role/QuickSightEmbeddingAnonymousPolicy" \
    --role-session-name anonymous caller
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
        export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
        export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_visual_role/QuickSightEmbeddingAnonymousPolicy`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario visitante. También mantiene cada sesión separada y distinta. Si utiliza una serie de servidores web, por ejemplo, para equilibrar la carga, y una sesión se vuelve a conectar a un servidor diferente, se inicia una nueva sesión.

Para obtener una URL firmada para el elemento visual, llame a `generate-embed-url-for-anynymous-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del elemento visual integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un elemento visual integrado mediante una llamada desde el servidor para los usuarios que realizan visitas anónimas a su portal web o aplicación.

```
aws quicksight generate-embed-url-for-anonymous-user \
    --aws-account-id 111122223333 \
    --namespace default-or-something-else \
    --session-lifetime-in-minutes 15 \
    --authorized-resource-arns '["dashboard-arn-1","dashboard-arn-2"]' \
    --allowed-domains '["domain1","domain2"]' \
    --session-tags '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]' \
    --experience-configuration 'DashboardVisual={InitialDashboardVisualId={DashboardId=dashboard_id,SheetId=sheet_id,VisualId=visual_id}}'
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html). Puede utilizar esta y otras operaciones de la API en su propio código. 

## Paso 3: integración de la URL del elemento visual
<a name="embedded-analytics-visuals-with-anonymous-users-step-3"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, encontrará información sobre cómo utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL visual del paso 2 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque el elemento visual en una página HTML.
+ Pase los parámetros al elemento visual.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GenerateEmbedUrlForAnonymousUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida durante 10 horas. La operación de la API proporciona la URL con un código de autorización (auth) que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-anonymous-user`. La `quicksightdomain` de este ejemplo es la URL que utilizas para acceder a tu cuenta de Amazon Quick Sight.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    {
        "Status": "200",
        "EmbedUrl": "https://quicksightdomain/embed/12345/dashboards/67890/sheets/12345/visuals/67890...",
        "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
    }
```

Inserte este elemento visual en su página web mediante el [SDK de incrustación](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) de Amazon Quick Sight o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño responsivo que se modifica a medida que cambia el tamaño de la ventana. Con el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros visuales y recibir llamadas en función de la finalización de la carga visual y de los errores. 

El dominio que va a alojar elementos visuales integrados debe estar incluido en *allowlist*, la lista de dominios aprobados de la suscripción a Quick . Este requisito protege los datos impidiendo que dominios no aprobados alojen elementos visuales y paneles integrados. Para obtener más información sobre cómo añadir dominios para imágenes y paneles integrados, consulte [Permitir la publicación de dominios en tiempo de ejecución con la API Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-run-time.html).

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código reside en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-analytics-visuals-with-anonymous-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Visual Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedVisual = async() => {    
                const {
                    createEmbeddingContext,
                } = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    parameters: [
                        {
                            Name: 'country',
                            Values: ['United States'],
                        },
                        {
                            Name: 'states',
                            Values: [
                                'California',
                                'Washington'
                            ]
                        }
                    ],
                    locale: "en-US",
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'CONTENT_LOADED': {
                                console.log("All visuals are loaded. The title of the document:", messageEvent.message.title);
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Error occurred while rendering the experience. Error code:", messageEvent.message.errorCode);
                                break;
                            }
                            case 'PARAMETERS_CHANGED': {
                                console.log("Parameters changed. Changed parameters:", messageEvent.message.changedParameters);
                                break;
                            }
                            case 'SIZE_CHANGED': {
                                console.log("Size changed. New dimensions:", messageEvent.message);
                                break;
                            }
                        }
                    },
                };
                const embeddedVisualExperience = await embeddingContext.embedVisual(frameOptions, contentOptions);

                const selectCountryElement = document.getElementById('country');
                selectCountryElement.addEventListener('change', (event) => {
                    embeddedVisualExperience.setParameters([
                        {
                            Name: 'country',
                            Values: event.target.value
                        }
                    ]);
                });
            };
        </script>
    </head>

    <body onload="embedVisual()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="experience-container"></div>
    </body>

</html>
```

### SDK 1.0
<a name="embedded-analytics-visuals-with-anonymous-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Visual Embedding Example</title>
        <!-- You can download the latest QuickSight embedding SDK version from https://www.npmjs.com/package/amazon-quicksight-embedding-sdk -->
        <!-- Or you can do "npm install amazon-quicksight-embedding-sdk", if you use npm for javascript dependencies -->
        <script src="./quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            let embeddedVisualExperience;
            function onVisualLoad(payload) {
                console.log("Do something when the visual is fully loaded.");
            }

            function onError(payload) {
                console.log("Do something when the visual fails loading");
            }

            function embedVisual() {
                const containerDiv = document.getElementById("embeddingContainer");
                const options = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: containerDiv,
                    parameters: {
                        country: "United States"
                    },
                    height: "700px",
                    width: "1000px",
                    locale: "en-US"
                };
                embeddedVisualExperience = QuickSightEmbedding.embedVisual(options);
                embeddedVisualExperience.on("error", onError);
                embeddedVisualExperience.on("load", onVisualLoad);
            }

            function onCountryChange(obj) {
                embeddedVisualExperience.setParameters({country: obj.value});
            }
        </script>
    </head>

    <body onload="embedVisual()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country" onchange="onCountryChange(this)">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="embeddingContainer"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el elemento visual incrustado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK QuickSight de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Incorporar todas las funciones de la consola Amazon Quick Sight para los usuarios registrados
<a name="embedded-analytics-full-console-for-authenticated-users"></a>

**importante**  
Amazon Quick Sight tiene nuevas operaciones de API para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando las operaciones `GetDashboardEmbedUrl` y las de la `GetSessionEmbedUrl` API para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener más información sobre la incrustación mediante las operaciones de API antiguas, consulte [Incrustar análisis mediante las GetDashboardEmbedURL](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics-deprecated.html) operaciones de API y. GetSessionEmbedURL


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Con la edición Enterprise, además de ofrecer paneles de solo lectura, también puedes ofrecer la experiencia de la consola Amazon Quick Sight en un portal de creación personalizado. Con este enfoque, permite a sus usuarios crear orígenes de datos, conjuntos de datos y análisis. En la misma interfaz, pueden crear, publicar y ver paneles. Si desea restringir algunos de esos permisos, también puede hacerlo.

Los usuarios que acceden a Amazon Quick Sight a través de una consola integrada deben pertenecer al grupo de seguridad del autor o del administrador. Los lectores no tienen acceso suficiente para utilizar la consola Amazon Quick Sight para la creación, independientemente de si está integrada o forma parte de la Consola de administración de AWS. Sin embargo, los autores y los administradores pueden seguir accediendo a los paneles integrados. Si desea restringir los permisos a algunas de las funciones de creación, puede añadir un perfil de permisos personalizado al usuario con la operación de la [UpdateUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_UpdateUser.html)API. Utilice la operación de [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)API para añadir un nuevo usuario con un perfil de permisos personalizado adjunto. Para obtener más información, consulte las siguientes secciones:
+ Para obtener información sobre la creación de funciones personalizadas mediante la definición de permisos de consola personalizados, consulte [Personalización del acceso a la consola Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/customizing-permissions-to-the-quicksight-console.html).
+ Para obtener información sobre el uso de espacios de nombres para aislar usuarios, grupos y activos de Amazon Quick Sight de varios usuarios, consulte Espacios de nombres de [Amazon](https://docs.aws.amazon.com/quicksight/latest/APIReference/controlling-access.html#namespaces.html) Quick Sight.
+ Para obtener información sobre cómo añadir su propia marca a una consola Amazon Quick Sight integrada, consulte [Uso de temas en Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/themes-in-quicksight.html) y [Operaciones de la API de QuickSight temas](https://docs.aws.amazon.com/quicksight/latest/APIReference/qs-assets.html#themes). 

En las siguientes secciones, encontrará información detallada sobre cómo configurar los paneles de Amazon Quick Sight integrados para los usuarios registrados.

**Topics**
+ [Paso 1: configuración de permisos](#embedded-analytics-full-console-for-authenticated-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-analytics-full-console-for-authenticated-users-step-2)
+ [Paso 3: integración de la URL de la sesión de consola](#embedded-analytics-full-console-for-authenticated-users-step-3)
+ [Activación de características de BI generativa en consolas incrustadas para usuarios registrados](embedding-consoles-genbi.md)

## Paso 1: configuración de permisos
<a name="embedded-analytics-full-console-for-authenticated-users-step-1"></a>

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a Amazon Quick Sight asume un rol que le otorga acceso a Amazon Quick Sight y permisos para acceder a la sesión de consola. Para que esto sea posible, cree un rol de IAM en su AWS cuenta. Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. Añada `quicksight:RegisterUser` permisos para garantizar que el lector pueda acceder a Amazon Quick Sight en modo de solo lectura y no tenga acceso a ningún otro dato o función de creación. La función de IAM también debe proporcionar permisos para recuperar la sesión de la consola. URLs Para ello, añada `quicksight:GenerateEmbedUrlForRegisteredUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForAnonymousUser`. El parámetro `AllowedDomains` es opcional. Como desarrollador, tiene la opción de anular los dominios estáticos que están configurados en el menú **Gestionar Amazon Quick Sight**. En su lugar, puede enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web que cree. Solo los dominios que aparecen en el parámetro pueden acceder al panel integrado. Sin esta condición, usted puede incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

**Práctica recomendada de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente tiene el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La siguiente política de ejemplo ofrece estos permisos. 

El siguiente ejemplo de política proporciona permiso para recuperar la URL de una sesión de consola. Puede utilizar la política sin `quicksight:RegisterUser` si va a crear usuarios antes de que accedan a una sesión integrada.

Finalmente, la identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. En el siguiente ejemplo, se muestra una muestra de política de confianza. 

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o SAML, consulte las siguientes secciones de la *Guía del usuario de IAM: *
+ [Creación de un rol para identidades federadas web u OpenID Connect (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-analytics-full-console-for-authenticated-users-step-2"></a>

En la siguiente sección, puede obtener información sobre cómo autenticar el usuario y obtener la URL del la sesión de consola integrable en el servidor de su aplicación. 

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar los pasos descritos, se garantiza que cada espectador de la sesión de consola se aprovisione de forma exclusiva en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Este código se ejecuta en el servidor de aplicaciones.

### Java
<a name="embedded-analytics-full-console-for-authenticated-users-java"></a>

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserRequest;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserResult;
import com.amazonaws.services.quicksight.model.RegisteredUserEmbeddingExperienceConfiguration;
import com.amazonaws.services.quicksight.model.RegisteredUserQuickSightConsoleEmbeddingConfiguration;

/**
 * Class to call QuickSight AWS SDK to get url for QuickSight console embedding.
 */
public class GetQuicksightEmbedUrlRegisteredUserQSConsoleEmbedding {

    private final AmazonQuickSight quickSightClient;

    public GetQuicksightEmbedUrlRegisteredUserQSConsoleEmbedding() {
        this.quickSightClient = AmazonQuickSightClientBuilder
                .standard()
                .withRegion(Regions.US_EAST_1.getName())
                .withCredentials(new AWSCredentialsProvider() {
                        @Override
                        public AWSCredentials getCredentials() {
                            // provide actual IAM access key and secret key here
                            return new BasicAWSCredentials("access-key", "secret-key");
                        }

                         @Override
                        public void refresh() {                           
                        }
                    }
                )
                .build();
    }

    public String getQuicksightEmbedUrl(
            final String accountId,
            final String userArn, // Registered user arn to use for embedding. Refer to Get Embed Url section in developer portal to find out how to get user arn for a QuickSight user.
            final List<String> allowedDomains, // Runtime allowed domain for embedding
            final String initialPath
    ) throws Exception {
        final RegisteredUserEmbeddingExperienceConfiguration experienceConfiguration = new RegisteredUserEmbeddingExperienceConfiguration()
                .withQuickSightConsole(new RegisteredUserQuickSightConsoleEmbeddingConfiguration().withInitialPath(initialPath));
        final GenerateEmbedUrlForRegisteredUserRequest generateEmbedUrlForRegisteredUserRequest = new GenerateEmbedUrlForRegisteredUserRequest();
        generateEmbedUrlForRegisteredUserRequest.setAwsAccountId(accountId);
        generateEmbedUrlForRegisteredUserRequest.setUserArn(userArn);
        generateEmbedUrlForRegisteredUserRequest.setAllowedDomains(allowedDomains);
        generateEmbedUrlForRegisteredUserRequest.setExperienceConfiguration(experienceConfiguration);

        final GenerateEmbedUrlForRegisteredUserResult generateEmbedUrlForRegisteredUserResult = quickSightClient.generateEmbedUrlForRegisteredUser(generateEmbedUrlForRegisteredUserRequest);

        return generateEmbedUrlForRegisteredUserResult.getEmbedUrl();
    }
}
```

### JavaScript
<a name="embedded-analytics-full-console-for-authenticated-users-js"></a>

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function generateEmbedUrlForRegisteredUser(
    accountId,
    dashboardId,
    openIdToken, // Cognito-based token
    userArn, // registered user arn
    roleArn, // IAM user role to use for embedding
    sessionName, // Session name for the roleArn assume role
    allowedDomains, // Runtime allowed domain for embedding
    getEmbedUrlCallback, // GetEmbedUrl success callback method
    errorCallback // GetEmbedUrl error callback method
    ) {
    const stsClient = new AWS.STS();
    let stsParams = {
        RoleSessionName: sessionName,
        WebIdentityToken: openIdToken,
        RoleArn: roleArn
    }

    stsClient.assumeRoleWithWebIdentity(stsParams, function(err, data) {
        if (err) {
            console.log('Error assuming role');
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const getDashboardParams = {
                "AwsAccountId": accountId,
                "ExperienceConfiguration": {
                    "QuickSightConsole": {
                        "InitialPath": '/start'
                    }
                },
                "UserArn": userArn,
                "AllowedDomains": allowedDomains,
                "SessionLifetimeInMinutes": 600
            };

            const quicksightGetDashboard = new AWS.QuickSight({
                region: process.env.AWS_REGION,
                credentials: {
                    accessKeyId: data.Credentials.AccessKeyId,
                    secretAccessKey: data.Credentials.SecretAccessKey,
                    sessionToken: data.Credentials.SessionToken,
                    expiration: data.Credentials.Expiration
                }
            });

            quicksightGetDashboard.generateEmbedUrlForRegisteredUser(getDashboardParams, function(err, data) {
                if (err) {
                    console.log(err, err.stack);
                    errorCallback(err);
                } else {
                    const result = {
                        "statusCode": 200,
                        "headers": {
                            "Access-Control-Allow-Origin": "*", // Use your website domain to secure access to GetEmbedUrl API
                            "Access-Control-Allow-Headers": "Content-Type"
                        },
                        "body": JSON.stringify(data),
                        "isBase64Encoded": false
                    }
                    getEmbedUrlCallback(result);
                }
            });
        }
    });
}
```

### Python3
<a name="embedded-analytics-full-console-for-authenticated-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError

# Create QuickSight and STS clients
qs = boto3.client('quicksight', region_name='us-east-1')
sts = boto3.client('sts')

# Function to generate embedded URL  
# accountId: AWS account ID
# userArn: arn of registered user
# allowedDomains: Runtime allowed domain for embedding
# roleArn: IAM user role to use for embedding
# sessionName: session name for the roleArn assume role
def generateEmbeddingURL(accountId, userArn, allowedDomains, roleArn, sessionName):
    try:
        assumedRole = sts.assume_role(
            RoleArn = roleArn,
            RoleSessionName = sessionName,
        )
    except ClientError as e:
        return "Error assuming role: " + str(e)
    else: 
        assumedRoleSession = boto3.Session(
            aws_access_key_id = assumedRole['Credentials']['AccessKeyId'],
            aws_secret_access_key = assumedRole['Credentials']['SecretAccessKey'],
            aws_session_token = assumedRole['Credentials']['SessionToken'],
        )
        try:
            quickSightClient = assumedRoleSession.client('quicksight', region_name='us-east-1')
            
            experienceConfiguration = {
                "QuickSightConsole": {
                    "InitialPath": "/start"
                }
            }
            response = quickSightClient.generate_embed_url_for_registered_user(
                 AwsAccountId = accountId,
                 ExperienceConfiguration = experienceConfiguration,
                 UserArn = userArn,
                 AllowedDomains = allowedDomains,
                 SessionLifetimeInMinutes = 600
            )
            
            return {
                'statusCode': 200,
                'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
                'body': json.dumps(response),
                'isBase64Encoded':  bool('false')
            }
        except ClientError as e:
            return "Error generating embedding url: " + str(e)
```

### Node.js
<a name="embedded-analytics-full-console-for-authenticated-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL de la sesión de consola integrada. Puede utilizar esta URL en su sitio web o aplicación para mostrar la sesión de consola. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    apiConfig: require('./quicksight-2018-04-01.min.json'),
    region: 'us-east-1',
});

quicksightClient.generateEmbedUrlForRegisteredUser({
    'AwsAccountId': '111122223333',
    'ExperienceConfiguration': {
        'QuickSightConsole': {
            'InitialPath': '/start'
        }
    },
    'UserArn': 'REGISTERED_USER_ARN',
    'AllowedDomains': allowedDomains,
    'SessionLifetimeInMinutes': 100
}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

**Example**  

```
// The URL returned is over 900 characters. For this example, we've shortened the string for
// readability and added ellipsis to indicate that it's incomplete.
    {
        Status: 200,
        EmbedUrl: 'https://quicksightdomain/embed/12345/dashboards/67890..,
        RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713'
    }
```

### .NET/C\$1
<a name="embedded-analytics-full-console-for-authenticated-users-cs"></a>

El ejemplo siguiente muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL de la sesión de consola integrada. Puede utilizar esta URL en su sitio web o aplicación para mostrar la consola. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateDashboardEmbedUrlForRegisteredUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                RegisteredUserQuickSightConsoleEmbeddingConfiguration registeredUserQuickSightConsoleEmbeddingConfiguration
                    = new RegisteredUserQuickSightConsoleEmbeddingConfiguration
                    {
                        InitialPath = "/start"
                    };
                RegisteredUserEmbeddingExperienceConfiguration registeredUserEmbeddingExperienceConfiguration
                    = new RegisteredUserEmbeddingExperienceConfiguration
                    {
                        QuickSightConsole = registeredUserQuickSightConsoleEmbeddingConfiguration
                    };
                
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForRegisteredUserAsync(new GenerateEmbedUrlForRegisteredUserRequest
                    {
                        AwsAccountId = "111122223333",
                        ExperienceConfiguration = registeredUserEmbeddingExperienceConfiguration,
                        UserArn = "REGISTERED_USER_ARN",
                        AllowedDomains = allowedDomains,
                        SessionLifetimeInMinutes = 100
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

### AWS CLI
<a name="embedded-analytics-full-console-for-authenticated-users-cli"></a>

Para asumir la función, elige una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar a su usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Usa esta operación cuando utilices SAML para autenticar a tus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForRegisteredUser` habilitados. Si opta por añadir just-in-time usuarios cuando abren Amazon Quick Sight por primera vez, el rol también necesita tener habilitados los permisos`quicksight:RegisterUser`.

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
     --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_console_session_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. La limitación es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan a una sesión de consola. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
     --aws-account-id 111122223333 \
     --namespace default \
     --identity-type IAM \
     --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
     --user-role READER \
     --user-name jhnd \
     --session-name "john.doe@example.com" \
     --email john.doe@example.com \
     --region us-east-1 \
     --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el ARN del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puede añadir este usuario al grupo correspondiente. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
     --aws-account-id=111122223333 \
     --namespace=default \
     --group-name=financeusers \
     --member-name="embedding_quicksight_dashboard_role/john.doe@example.com"
```

Ahora tiene un usuario de su aplicación que también es usuario de Amazon Quick Sight y que tiene acceso a la sesión de consola de Amazon Quick Sight. 

Por último, para obtener una URL firmada para la sesión de consola, llame a `generate-embed-url-for-registered-user` desde el servidor de aplicaciones. Esto devuelve la URL de la sesión de consola que se puede integrar. En el siguiente ejemplo, se muestra cómo generar la URL de una sesión de consola integrada mediante una llamada desde el servidor para los usuarios autenticados mediante AWS Managed Microsoft AD un inicio de sesión único (IAM Identity Center).

```
aws quicksight generate-embed-url-for-registered-user \
    --aws-account-id 111122223333 \
    --entry-point the-url-for--the-console-session \
    --session-lifetime-in-minutes 600 \
    --user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/embedding_quicksight_dashboard_role/embeddingsession
	--allowed-domains '["domain1","domain2"]' \
    --experience-configuration QuickSightConsole={InitialPath="/start"}
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html). Puede utilizar esta y otras operaciones de la API en su propio código. 

## Paso 3: integración de la URL de la sesión de consola
<a name="embedded-analytics-full-console-for-authenticated-users-step-3"></a>

En la siguiente sección, encontrará información sobre cómo utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL de la sesión de la consola del paso 3 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque la sesión de consola en una página HTML.
+ Pase los parámetros a la sesión de consola.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GenerateEmbedUrlForRegisteredUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-registered-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https://quicksightdomain/embedding/12345/start...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Inserte esta sesión de consola en su página web mediante el [SDK de incrustación](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) de Amazon Quick Sight o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Al utilizar el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros de la sesión de consola y recibir llamadas en función de la finalización de la carga de la página y de los errores. 

El dominio que alojará los paneles integrados debe estar en la lista de dominios *permitidos, la lista* de dominios aprobados para su suscripción. Quick Este requisito protege los datos impidiendo que dominios no aprobados alojen paneles integrados. Para obtener más información sobre cómo añadir dominios para una consola integrada, consulte [Permitir publicar dominios en tiempo de ejecución con la API Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-run-time.html).

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-analytics-full-console-for-authenticated-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Console Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedSession = async() => {    
                const {
                    createEmbeddingContext,
                } = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'ERROR_OCCURRED': {
                                console.log("Do something when the embedded experience fails loading.");
                                break;
                            }
                        }
                    }
                };
                const embeddedConsoleExperience = await embeddingContext.embedConsole(frameOptions, contentOptions);
            };
        </script>
    </head>

    <body onload="embedSession()">
        <div id="experience-container"></div>
    </body>

</html>
```

### SDK 1.0
<a name="embedded-analytics-full-console-for-authenticated-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>QuickSight Console Embedding</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@1.0.15/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            var session

            function onError(payload) {
                console.log("Do something when the session fails loading");
            }

            function embedSession() {
                var containerDiv = document.getElementById("embeddingContainer");
                var options = {
                    // replace this dummy url with the one generated via embedding API
                    url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode", // replace this dummy url with the one generated via embedding API
                    container: containerDiv,
                    parameters: {
                        country: "United States"
                    },
                    scrolling: "no",
                    height: "700px",
                    width: "1000px",
                    locale: "en-US",
                    footerPaddingEnabled: true,
                    defaultEmbeddingVisualType: "TABLE", // this option only applies to QuickSight console embedding and is not used for dashboard embedding
                };
                session = QuickSightEmbedding.embedSession(options);
                session.on("error", onError);
            }

            function onCountryChange(obj) {
                session.setParameters({country: obj.value});
            }
        </script>
    </head>

    <body onload="embedSession()">
        <span>
            <label for="country">Country</label>
            <select id="country" name="country" onchange="onCountryChange(this)">
                <option value="United States">United States</option>
                <option value="Mexico">Mexico</option>
                <option value="Canada">Canada</option>
            </select>
        </span>
        <div id="embeddingContainer"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar la sesión de consola integrada en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Activación de características de BI generativa en consolas incrustadas para usuarios registrados
<a name="embedding-consoles-genbi"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Puede activar las siguientes características de BI generativa en su consola incrustada:
+ Resúmenes ejecutivos: cuando están habilitados, los usuarios registrados de Author Pro y Reader Pro pueden generar resúmenes ejecutivos que proporcionan un resumen de toda la información que Amazon Quick Sight ha generado para que el panel de control pueda descubrir fácilmente la información clave.
+ Creación: al activarla, los usuarios Autor profesional pueden usar BI generativa para crear campos calculados, así como crear y perfeccionar elementos visuales.
+ Preguntas y respuestas: al activarlas, los usuarios Autor profesional y Lector profesional pueden utilizar las preguntas y respuestas basadas en IA para sugerir y responder preguntas relacionadas con sus datos.
+ Historias basadas en datos: al activarlas, los usuarios Autor profesional y Lector profesional pueden proporcionar detalles para generar rápidamente un primer borrador de su historia basada en datos.

**Cómo activar características de BI generativa en consolas incrustadas para usuarios registrados**
+ Siga los pasos que se indican en [Integrar todas las funciones de la consola Amazon Quick Sight para que los usuarios registrados puedan](https://docs.aws.amazon.com/quicksight/latest/user/embedded-analytics-full-console-for-authenticated-users.html) integrar una consola con los siguientes cambios:

  1. Al generar la URL en el paso 2, `Enabled: true` defina el `FeatureConfigurations` parámetro para cada una de las funciones que desee activar en [GenerateEmbedUrlForRegisteredUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html)o [GenerateEmbedUrlForRegisteredUserWithIdentity](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUserWithIdentity.html) APIs, como se muestra en el siguiente ejemplo. Si no se proporciona ninguna configuración, las características están desactivadas de manera predeterminada.

     ```
     ExperienceConfiguration: {
             QuickSightConsole: {
                 InitialPath: "initial_path",
                 AmazonQInQuickSight: {
                     FeatureConfigurations: { 
                         COMMENT: Enable executive summaries
                         ExecutiveSummary: {
                             Enabled: true
                         },
                         COMMENT: Enable Generative BI authoring
                         GenerativeAuthoring: {
                             Enabled: true
                         },
                         COMMENT: Enable Q&A
                         DataQnA: {
                             Enabled: true
                         },
                         COMMENT: Enable data stories
                         DataStories: {
                             Enabled: true
                         }       
                     }
                 }
             }
         }
     }
     ```

  1. Al incrustar la URL de la consola con el SDK de incrustación de Amazon Quick Sight en el paso 3, defina los valores del siguiente ejemplo como desee. Si no se proporciona ninguna configuración, las características están desactivadas de manera predeterminada.
**nota**  
No existe ninguna opción de SDK para activar las historias basadas en datos. Si las historias basadas en datos están activadas con la API como se muestra en el paso anterior, estarán disponibles para los usuarios registrados.

     ```
     const contentOptions = {
         toolbarOptions: {
             executiveSummary: true, // Enable executive summaries
             buildVisual: true, // Enable Generative BI authoring
             dataQnA: true // Enable Q&A
         }
     };
     ```

# Integración de Amazon Q en la experiencia generativa de preguntas y respuestas de Amazon Quick Sight
<a name="embedding-gen-bi"></a>


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, puede encontrar información detallada sobre cómo configurar una experiencia de preguntas y respuestas generativas integrada que utilice las capacidades de NLQ mejoradas impulsadas por. LLMs La experiencia de preguntas y respuestas generativas es el sustituto recomendado de la barra de búsqueda Q incrustada y proporciona a los usuarios una experiencia de BI actualizada.

**Topics**
+ [Integración de Amazon Q en Amazon Quick Sight: una experiencia generativa de preguntas y respuestas para usuarios registrados](#embedded-analytics-gen-bi-authenticated-users)
+ [Integración de Amazon Q en la experiencia de preguntas y respuestas de Quick Generative para usuarios anónimos (no registrados)](#embedded-analytics-gen-bi-anonymous-users)

## Integración de Amazon Q en Amazon Quick Sight: una experiencia generativa de preguntas y respuestas para usuarios registrados
<a name="embedded-analytics-gen-bi-authenticated-users"></a>

En las siguientes secciones, encontrará información detallada sobre cómo configurar una experiencia de preguntas y respuestas generativas integrada para los usuarios registrados de Amazon Quick Sight.

**Topics**
+ [Paso 1: configuración de permisos](#embedded-analytics-gen-bi-authenticated-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-analytics-gen-bi-authenticated-users-step-2)
+ [Paso 3: incrustación de la URL de la experiencia de preguntas y respuestas generativas](#embedded-analytics-gen-bi-authenticated-users-step-3)
+ [Funcionalidades opcionales de la experiencia de preguntas y respuestas generativas incrustada](#embedded-analytics-gen-bi-authenticated-users-step-4)

### Paso 1: configuración de permisos
<a name="embedded-analytics-gen-bi-authenticated-users-step-1"></a>

En la siguiente sección, encontrará información sobre cómo configurar los permisos de la aplicación de backend o del servidor web para incrustar la experiencia de preguntas y respuestas generativas. Esta tarea requiere acceso administrativo a AWS Identity and Access Management (IAM).

Cada usuario que accede a una experiencia de preguntas y respuestas generativas asume un rol que le otorga acceso y permisos a Amazon Quick Sight. Para ello, cree un rol de IAM en su Cuenta de AWS. Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. La función de IAM debe proporcionar permisos para recuperar la incrustación URLs de un grupo de usuarios específico. 

Con la ayuda del carácter comodín *\$1*, puede conceder los permisos necesarios para generar una URL para todos los usuarios de un espacio de nombres específico. También puede conceder permisos para generar una URL para un subconjunto de usuarios en espacios de nombres específicos. Para ello, añada `quicksight:GenerateEmbedUrlForRegisteredUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForRegisteredUser`. El parámetro `AllowedDomains` es opcional. Ofrece a los desarrolladores la opción de anular los dominios estáticos que están configurados en el menú **Administrar Amazon Quick Sight** y, en su lugar, enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web del desarrollador. Solo los dominios que aparecen en el parámetro pueden acceder a la experiencia de preguntas y respuestas generativas. Sin esta condición, los desarrolladores pueden incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForRegisteredUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente tiene el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La siguiente política de ejemplo ofrece estos permisos.

Además, si vas a crear usuarios primerizos que vayan a ser lectores de Amazon Quick Sight, asegúrate de añadir el `quicksight:RegisterUser` permiso en la política.

El siguiente ejemplo de política proporciona permiso para recuperar una URL incrustada para los usuarios primerizos que vayan a ser lectores de Amazon Quick Sight.

Finalmente, la identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. 

En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
        "Statement": [
            {
    "Sid": "AllowLambdaFunctionsToAssumeThisRole",
                "Effect": "Allow",
                "Principal": {
    "Service": "lambda.amazonaws.com"
                },
                "Action": "sts:AssumeRole"
            },
            {
    "Sid": "AllowEC2InstancesToAssumeThisRole",
                "Effect": "Allow",
                "Principal": {
    "Service": "ec2.amazonaws.com"
                },
                "Action": "sts:AssumeRole"
            }
        ]
    }
```

------

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o lenguaje de marcado para confirmaciones de seguridad (SAML), consulte las siguientes secciones de la *Guía de usuario de IAM:*
+ [Creación de un rol para identidades web o de OpenID Connect Federation (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

### Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-analytics-gen-bi-authenticated-users-step-2"></a>

En la siguiente sección, encontrará cómo autenticar a su usuario y obtener la URL del tema de Q integrable en su servidor de aplicaciones. Si planea integrar la experiencia de preguntas y respuestas generativas para los tipos de identidad de IAM o Amazon Quick Sight, comparta el tema Q con los usuarios.

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, la aplicación añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar los pasos descritos, se garantiza que cada espectador del tema Q se aprovisione de forma exclusiva en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros. La seguridad de filas basada en etiquetas puede utilizarse para la incrustación de usuarios anónimos en la barra de Q.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Este código se ejecuta en el servidor de aplicaciones.

#### Java
<a name="embedded-analytics-gen-bi-authenticated-users-java"></a>

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserRequest;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserResult;
import com.amazonaws.services.quicksight.model.RegisteredUserEmbeddingExperienceConfiguration;
import com.amazonaws.services.quicksight.model.RegisteredUserGenerativeQnAEmbeddingConfiguration;

/**
 * Class to call QuickSight AWS SDK to get url for embedding Generative Q&A experience.
 */
public class RegisteredUserGenerativeQnAEmbeddingSample {

    private final AmazonQuickSight quickSightClient;

    public RegisteredUserGenerativeQnAEmbeddingSample() {
        this.quickSightClient = AmazonQuickSightClientBuilder
                    .standard()
                    .withRegion(Regions.US_EAST_1.getName())
                    .withCredentials(new AWS CredentialsProvider() {
                            @Override
                            public AWSCredentials getCredentials() {
                                // provide actual IAM access key and secret key here
                                return new BasicAWSCredentials("access-key", "secret-key");
                            }

                            @Override
                            public void refresh() {
                            }
                        }
                    )
                    .build();
            }

    public String getQuicksightEmbedUrl(
            final String accountId, // AWS Account ID
            final String topicId, // Topic ID to embed
            final List<String> allowedDomains, // Runtime allowed domain for embedding
            final String userArn // Registered user arn to use for embedding. Refer to Get Embed Url section in developer portal to find how to get user arn for a QuickSight user.
            ) throws Exception {

        final RegisteredUserEmbeddingExperienceConfiguration experienceConfiguration = new RegisteredUserEmbeddingExperienceConfiguration()
                .withGenerativeQnA(new RegisteredUserGenerativeQnAEmbeddingConfiguration().withInitialTopicId(topicId));
        final GenerateEmbedUrlForRegisteredUserRequest generateEmbedUrlForRegisteredUserRequest = new GenerateEmbedUrlForRegisteredUserRequest();
        generateEmbedUrlForRegisteredUserRequest.setAwsAccountId(accountId);
        generateEmbedUrlForRegisteredUserRequest.setUserArn(userArn);
        generateEmbedUrlForRegisteredUserRequest.setAllowedDomains(allowedDomains);
        generateEmbedUrlForRegisteredUserRequest.setExperienceConfiguration(experienceConfiguration);

        final GenerateEmbedUrlForRegisteredUserResult generateEmbedUrlForRegisteredUserResult = quickSightClient.generateEmbedUrlForRegisteredUser(generateEmbedUrlForRegisteredUserRequest);

        return generateEmbedUrlForRegisteredUserResult.getEmbedUrl();
    }
}
```

#### JavaScript
<a name="embedded-analytics-gen-bi-authenticated-users-js"></a>

**nota**  
La generación de URL incrustadas APIs no se puede invocar directamente desde los navegadores. En su lugar, consulte el ejemplo de Node.JS.

#### Python3
<a name="embedded-analytics-gen-bi-authenticated-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError

sts = boto3.client('sts')

# Function to generate embedded URL  
# accountId: AWS account ID
# topicId: Topic ID to embed
# userArn: arn of registered user
# allowedDomains: Runtime allowed domain for embedding
# roleArn: IAM user role to use for embedding
# sessionName: session name for the roleArn assume role
def getEmbeddingURL(accountId, topicId, userArn, allowedDomains, roleArn, sessionName):
    try:
        assumedRole = sts.assume_role(
            RoleArn = roleArn,
            RoleSessionName = sessionName,
        )
    except ClientError as e:
        return "Error assuming role: " + str(e)
    else: 
        assumedRoleSession = boto3.Session(
            aws_access_key_id = assumedRole['Credentials']['AccessKeyId'],
            aws_secret_access_key = assumedRole['Credentials']['SecretAccessKey'],
            aws_session_token = assumedRole['Credentials']['SessionToken'],
        )
        try:
            quicksightClient = assumedRoleSession.client('quicksight', region_name='us-west-2')
            response = quicksightClient.generate_embed_url_for_registered_user(
                AwsAccountId=accountId,
                ExperienceConfiguration = {
                    'GenerativeQnA': {
                        'InitialTopicId': topicId
                    }
                },
                UserArn = userArn,
                AllowedDomains = allowedDomains,
                SessionLifetimeInMinutes = 600
            )
            
            return {
                'statusCode': 200,
                'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
                'body': json.dumps(response),
                'isBase64Encoded':  bool('false')
            }
        except ClientError as e:
            return "Error generating embedding url: " + str(e)
```

#### Node.js
<a name="embedded-analytics-gen-bi-authenticated-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    region: 'us-east-1'
});

quicksightClient.generateEmbedUrlForRegisteredUser({
    'AwsAccountId': '111122223333',
    'ExperienceConfiguration': { 
        'GenerativeQnA': {
            'InitialTopicId': 'U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f'
        }
    },
    'UserArn': 'REGISTERED_USER_ARN',
    'AllowedDomains': allowedDomains,
    'SessionLifetimeInMinutes': 100
}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

#### .NET/C\$1
<a name="embedded-analytics-gen-bi-authenticated-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL de la sesión de la barra de búsqueda de Q. Puede utilizar esta URL en su sitio web o aplicación para mostrar la barra de búsqueda de Q. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateGenerativeQnAEmbedUrlForRegisteredUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                RegisteredUserGenerativeQnAEmbeddingConfiguration registeredUserGenerativeQnAEmbeddingConfiguration
                    = new RegisteredUserGenerativeQnAEmbeddingConfiguration
                    {
                        InitialTopicId = "U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f"
                    };
                RegisteredUserEmbeddingExperienceConfiguration registeredUserEmbeddingExperienceConfiguration
                    = new RegisteredUserEmbeddingExperienceConfiguration
                    {
                        GenerativeQnA = registeredUserGenerativeQnAEmbeddingConfiguration
                    }; 
                
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForRegisteredUserAsync(new GenerateEmbedUrlForRegisteredUserRequest
                    {
                        AwsAccountId = "111122223333",
                        ExperienceConfiguration = registeredUserEmbeddingExperienceConfiguration,
                        UserArn = "REGISTERED_USER_ARN",
                        AllowedDomains = allowedDomains,
                        SessionLifetimeInMinutes = 100
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

#### AWS CLI
<a name="embedded-analytics-gen-bi-authenticated-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice SAML para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForRegisteredUser` habilitados. Si opta por añadir just-in-time usuarios cuando utilizan un tema en la barra de búsqueda de Q, el rol también necesita tener habilitados los permisos. `quicksight:RegisterUser`

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_q_generative_qna_role" \
     --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. En un ordenador con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_q_search_bar_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan a la experiencia de preguntas y respuestas generativas. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
    --aws-account-id 111122223333 \
    --namespace default \
    --identity-type IAM\
    --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_q_generative_qna_role" \
    --user-role READER \
    --user-name jhnd \
    --session-name "john.doe@example.com" \
    --email john.doe@example.com \
    --region us-east-1 \
    --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el Nombre de recurso de Amazon (ARN) del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puedes añadir este usuario al grupo con el que se comparte el panel. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
    --aws-account-id 111122223333 \
    --namespace default \
    --group-name financeusers \
    --member-name "embedding_quicksight_q_generative_qna_role/john.doe@example.com"
```

Ahora tienes un usuario de tu aplicación que también es usuario de Amazon Quick Sight y que tiene acceso al panel de control. 

Por último, para obtener una URL firmada para el panel, llame a `generate-embed-url-for-registered-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un panel integrado mediante una llamada desde el servidor para los usuarios autenticados mediante un inicio de sesión único ( AWS Managed Microsoft AD IAM Identity Center).

```
aws quicksight generate-embed-url-for-anonymous-user \
--aws-account-id 111122223333 \
--namespace default-or-something-else \
--authorized-resource-arns '["topic-arn-topicId1","topic-arn-topicId2"]' \
--allowed-domains '["domain1","domain2"]' \
--experience-configuration 'GenerativeQnA={InitialTopicId="topicId1"}' \
--session-tags '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]' \
--session-lifetime-in-minutes 15
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html). Puede utilizar esta y otras operaciones de la API en su propio código.

### Paso 3: incrustación de la URL de la experiencia de preguntas y respuestas generativas
<a name="embedded-analytics-gen-bi-authenticated-users-step-3"></a>

En la siguiente sección, encontrará información sobre cómo incrustar la URL de la experiencia de preguntas y respuestas generativas en su sitio web o página de la aplicación. Esto se hace con el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript). Con el SDK, puede hacer lo siguiente: 
+ Colocar la experiencia de preguntas y respuestas generativas en una página HTML.
+ Personalizar el diseño y la apariencia de la experiencia incrustada para adaptarla a las necesidades de su aplicación.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llame a la operación de la API `GenerateEmbedUrlForRegisteredUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un valor `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-registered-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete. 
{
 "Status": "200",
"EmbedUrl": "https://quicksightdomain/embedding/12345/q/search...",
"RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Incorpore la experiencia de preguntas y respuestas generativas en su página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. 

Asegúrese de que el dominio que alojará la experiencia de preguntas y respuestas generativas integrada esté en la lista de dominios *permitidos, la lista* de dominios aprobados para su suscripción a Amazon Quick Sight. Este requisito protege los datos impidiendo que dominios no aprobados alojen paneles integrados. Para obtener más información sobre cómo agregar dominios para la experiencia de preguntas y respuestas generativas incrustada, consulte [Administrar dominios](manage-domains.md).

Puede utilizar el SDK de incrustación Quick Sight de Amazon para personalizar el diseño y la apariencia de la experiencia de preguntas y respuestas generativas integrada para adaptarla a su aplicación. Use la propiedad `panelType` para configurar el estado inicial de la experiencia de preguntas y respuestas generativas cuando se muestre en su aplicación. Establezca la propiedad `panelType` en `'FULL'` para que represente el panel completo de la experiencia de preguntas y respuestas generativas. Este panel se parece a la experiencia que tienen los usuarios de Amazon Quick Sight en la consola Amazon Quick Sight. La altura del marco del panel no cambia en función de la interacción del usuario y respeta el valor establecido en la propiedad `frameOptions.height`. La siguiente imagen muestra el panel de la experiencia de preguntas y respuestas generativas que se representa cuando se establece el valor `panelType` en `'FULL'`.

Establezca la propiedad `panelType` en `'SEARCH_BAR'` para que represente la experiencia de preguntas y respuestas generativas como una barra de búsqueda. Esta barra de búsqueda se parece a la forma en que se representa la barra de búsqueda de Q cuando está incrustada en una aplicación. La barra de búsqueda preguntas y respuestas generativas se expande hasta convertirse en un panel más grande que muestra las opciones de selección de temas, la lista de sugerencias de preguntas, el panel de respuestas o el tablón de anuncios.

La altura mínima predeterminada de la barra de búsqueda de preguntas y respuestas generativas se representa cuando se carga el recurso incrustado. Se recomienda establecer el valor `frameOptions.height` en `"38px"` para optimizar la experiencia de la barra de búsqueda. Use la propiedad `focusedHeight` para establecer el tamaño óptimo del menú desplegable de selección de temas y de la lista de sugerencias de preguntas. Utilice la propiedad `expandedHeight` para establecer el tamaño óptimo del panel de respuestas y del tablón de anuncios. Si elige la opción `'SEARCH_BAR'`, se recomienda diseñar el contenedor principal con una posición (absoluta) para evitar que contenido no deseado se desplace en la aplicación. La siguiente imagen muestra la barra de búsqueda de la experiencia de preguntas y respuestas generativas que se representa cuando se establece el valor `panelType` en `'SEARCH_BAR'`.

Tras configurar la `panelType` propiedad, utilice el SDK de incrustación de Amazon Quick Sight para personalizar las siguientes propiedades de la experiencia de preguntas y respuestas generativas.
+ El título del panel de preguntas y respuestas generativas (solo se aplica a la opción `panelType: FULL`). 
+ El texto del marcador de posición de la barra de búsqueda.
+ Si se permite la selección de temas.
+ Si se muestran u ocultan los nombres de los temas.
+ Si se muestra u oculta el icono de Amazon Q (solo se aplica a la opción `panelType: FULL`).
+ Si muestra u oculta el tablón de anuncios.
+ Si los usuarios pueden maximizar el panel de preguntas y respuestas generativas a pantalla completa.
+ El tema del panel de preguntas y respuestas generativas. Se puede pasar un ARN de tema personalizado al SDK para cambiar la apariencia del contenido del marco. Los temas de inicio de Amazon Quick Sight no son compatibles con los paneles de BI generativa integrados. Para usar un tema de inicio de Amazon Quick Sight, guárdalo como tema personalizado en Amazon Quick Sight.

Cuando utilizas el SDK de incrustación Quick Sight de Amazon, la experiencia de preguntas y respuestas generativas de tu página cambia de tamaño de forma dinámica en función del estado. Al utilizar el SDK de incrustación Quick Sight de Amazon, también puede controlar los parámetros de la experiencia de preguntas y respuestas generativas y recibir llamadas en términos de finalización de la carga de la página, cambios de estado y errores. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

#### SDK 2.0
<a name="collapsible-gen-bi-embedding-example"></a>

```
<!DOCTYPE html>
<html>
    <head>
        <title>Generative Q&A Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.7.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedGenerativeQnA = async() => {    
                const {createEmbeddingContext} = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    // Optional panel settings. Default behavior is equivalent to {panelType: 'FULL'}
                    panelOptions: {
                        panelType: 'FULL',
                        title: 'custom title', // Optional
                        showQIcon: false, // Optional, Default: true
                    },
                    // Use SEARCH_BAR panel type for the landing state to be similar to embedQSearchBar
                    // with generative capability enabled topics
                    /*
                    panelOptions: {
                        panelType: 'SEARCH_BAR',
                        focusedHeight: '250px',
                        expandedHeight: '500px',
                    },
                    */
                    showTopicName: false, // Optional, Default: true
                    showPinboard: false, // Optional, Default: true
                    allowTopicSelection: false, // Optional, Default: true
                    allowFullscreen: false, // Optional, Default: true
                    searchPlaceholderText: "custom search placeholder", // Optional
                    themeOptions: { // Optional
                        themeArn: 'arn:aws:quicksight:<Region>:<AWS-Account-ID>:theme/<Theme-ID>'
                    }
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'Q_SEARCH_OPENED': {
                                // called when pinboard is shown / visuals are rendered
                                console.log("Do something when SEARCH_BAR type panel is expanded");
                                break;
                            }
                            case 'Q_SEARCH_FOCUSED': {
                                // called when question suggestions or topic selection dropdown are shown
                                console.log("Do something when SEARCH_BAR type panel is focused");
                                break;
                            }
                            case 'Q_SEARCH_CLOSED': {
                                // called when shrinked to initial bar height
                                console.log("Do something when SEARCH_BAR type panel is collapsed");
                                break;
                            }
                            case 'Q_PANEL_ENTERED_FULLSCREEN': {
                                console.log("Do something when panel enters full screen mode");
                                break;
                            }
                            case 'Q_PANEL_EXITED_FULLSCREEN': {
                                console.log("Do something when panel exits full screen mode");
                                break;
                            }
                            case 'CONTENT_LOADED': {
                                console.log("Do something after experience is loaded");
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Do something when experience fails to load");
                                break;
                            }
                        }
                    }
                };
                const embeddedGenerativeQnExperience = await embeddingContext.embedGenerativeQnA(frameOptions, contentOptions);
            };
        </script>
    </head>

    <body onload="embedGenerativeQnA()">
        <div id="experience-container"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrate de usar el SDK de incrustación de Amazon Quick Sight para cargar la experiencia de preguntas y respuestas generativas integrada en tu sitio web. JavaScript Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

### Funcionalidades opcionales de la experiencia de preguntas y respuestas generativas incrustada
<a name="embedded-analytics-gen-bi-authenticated-users-step-4"></a>

A continuación se detallan las funcionalidades opcionales que están disponibles para la experiencia de preguntas y respuestas generativas con el SDK de incrustación. 

#### Invocación de acciones de la barra de preguntas y respuestas generativas
<a name="w2aac35c27c21c43c29b9c21b5"></a>
+ Establecer una pregunta: esta característica envía una pregunta a la experiencia de preguntas y respuestas generativas y consulta la pregunta de inmediato.

  ```
  embeddedGenerativeQnExperience.setQuestion('show me monthly revenue');
  ```
+ Cerrar el panel de respuestas (se aplica a la opción de la barra de búsqueda preguntas y respuestas generativas): esta característica cierra el panel de respuestas y devuelve el iframe al estado original de la barra de búsqueda.

  ```
  embeddedGenerativeQnExperience.close();
  ```

Para obtener más información, consulte el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk).

## Integración de Amazon Q en la experiencia de preguntas y respuestas de Quick Generative para usuarios anónimos (no registrados)
<a name="embedded-analytics-gen-bi-anonymous-users"></a>


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las secciones siguientes, encontrará información detallada sobre cómo configurar una experiencia de preguntas y respuestas generativas incrustada para usuarios anónimos (no registrados).

**Topics**
+ [Paso 1: configuración de permisos](#embedded-analytics-gen-bi-anonymous-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-analytics-gen-bi-anonymous-users-step-2)
+ [Paso 3: incrustación de la URL de la experiencia de preguntas y respuestas generativas](#embedded-analytics-gen-bi-anonymous-users-step-3)
+ [Funcionalidades opcionales de la experiencia de preguntas y respuestas generativas incrustada](#embedded-analytics-gen-bi-anonymous-users-step-4)

### Paso 1: configuración de permisos
<a name="embedded-analytics-gen-bi-anonymous-users-step-1"></a>

En la siguiente sección, encontrará información sobre cómo configurar los permisos de la aplicación de backend o del servidor web para incrustar la experiencia de preguntas y respuestas generativas. Esta tarea requiere acceso administrativo a AWS Identity and Access Management (IAM).

Cada usuario que accede a una experiencia de preguntas y respuestas generativas asume un rol que le otorga acceso y permisos a Amazon Quick Sight. Para ello, cree un rol de IAM en su Cuenta de AWS. Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. La función de IAM debe proporcionar permisos para recuperar la incrustación URLs de un grupo de usuarios específico. 

Con la ayuda del carácter comodín *\$1*, puede conceder los permisos necesarios para generar una URL para todos los usuarios de un espacio de nombres específico. También puede conceder permisos para generar una URL para un subconjunto de usuarios en espacios de nombres específicos. Para ello, añada `quicksight:GenerateEmbedUrlForAnonymousUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForAnonymousUser`. El parámetro `AllowedDomains` es opcional. Ofrece a los desarrolladores la opción de anular los dominios estáticos que están configurados en el menú **Administrar Amazon Quick Sight** y, en su lugar, enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web del desarrollador. Solo los dominios que aparecen en el parámetro pueden acceder a la barra de búsqueda de Q. Sin esta condición, los desarrolladores pueden incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForAnonymousUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente tiene el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que, cuando un usuario accede a su aplicación, esta puede asumir el rol en nombre del usuario para cargar la experiencia de preguntas y respuestas generativas. En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
"Version":"2012-10-17",		 	 	 
    "Statement": [
        {
"Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
"Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
"Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
"Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la *Guía del usuario de IAM*

### Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-analytics-gen-bi-anonymous-users-step-2"></a>

En la siguiente sección, encontrará cómo autenticar a su usuario y obtener la URL del tema de Q integrable en su servidor de aplicaciones.

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, la aplicación añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

#### Java
<a name="embedded-analytics-gen-bi-anonymous-users-java"></a>

```
import java.util.List;
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.AnonymousUserGenerativeQnAEmbeddingConfiguration;
import com.amazonaws.services.quicksight.model.AnonymousUserEmbeddingExperienceConfiguration;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserRequest;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserResult;
import com.amazonaws.services.quicksight.model.SessionTag;

/**
* Class to call QuickSight AWS SDK to generate embed url for anonymous user.
*/
public class GenerateEmbedUrlForAnonymousUserExample {

    private final AmazonQuickSight quickSightClient;

    public GenerateEmbedUrlForAnonymousUserExample() {
        quickSightClient = AmazonQuickSightClientBuilder
            .standard()
            .withRegion(Regions.US_EAST_1.getName())
            .withCredentials(new AWSCredentialsProvider() {
                    @Override
                    public AWSCredentials getCredentials() {
                        // provide actual IAM access key and secret key here
                        return new BasicAWSCredentials("access-key", "secret-key");
                    }

                    @Override
                    public void refresh() {
                    }
                }
            )
            .build();
    }

    public String GenerateEmbedUrlForAnonymousUser(
        final String accountId, // YOUR AWS ACCOUNT ID
        final String initialTopicId, // Q TOPIC ID TO WHICH THE CONSTRUCTED URL POINTS AND EXPERIENCE PREPOPULATES INITIALLY
        final String namespace, // ANONYMOUS EMBEDDING REQUIRES SPECIFYING A VALID NAMESPACE FOR WHICH YOU WANT THE EMBEDDING URL
        final List<String> authorizedResourceArns, // Q TOPIC ARN LIST TO EMBED
        final List<String> allowedDomains, // RUNTIME ALLOWED DOMAINS FOR EMBEDDING
        final List<SessionTag> sessionTags // SESSION TAGS USED FOR ROW-LEVEL SECURITY
    ) throws Exception {
        AnonymousUserEmbeddingExperienceConfiguration experienceConfiguration = new AnonymousUserEmbeddingExperienceConfiguration();
        AnonymousUserGenerativeQnAEmbeddingConfiguration generativeQnAConfiguration = new AnonymousUserGenerativeQnAEmbeddingConfiguration();
        generativeQnAConfiguration.setInitialTopicId(initialTopicId);
        experienceConfiguration.setGenerativeQnA(generativeQnAConfiguration);

        GenerateEmbedUrlForAnonymousUserRequest generateEmbedUrlForAnonymousUserRequest = new GenerateEmbedUrlForAnonymousUserRequest()
            .withAwsAccountId(accountId)
            .withNamespace(namespace)
            .withAuthorizedResourceArns(authorizedResourceArns)
            .withExperienceConfiguration(experienceConfiguration)
            .withSessionTags(sessionTags)
            .withSessionLifetimeInMinutes(600L); // OPTIONAL: VALUE CAN BE [15-600]. DEFAULT: 600
            .withAllowedDomains(allowedDomains);

        GenerateEmbedUrlForAnonymousUserResult result = quickSightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserRequest);

        return result.getEmbedUrl();
    }

}
```

#### JavaScript
<a name="embedded-analytics-gen-bi-anonymous-users-js"></a>

**nota**  
 APIs No se puede acceder directamente a la generación de URL incrustadas desde los navegadores. En su lugar, consulte el ejemplo de Node.JS.

#### Python3
<a name="embedded-analytics-gen-bi-anonymous-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError
import time

# Create QuickSight and STS clients
quicksightClient = boto3.client('quicksight',region_name='us-west-2')
sts = boto3.client('sts')

# Function to generate embedded URL for anonymous user
# accountId: YOUR AWS ACCOUNT ID
# topicId: Topic ID to embed
# quicksightNamespace: VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
# authorizedResourceArns: TOPIC ARN LIST TO EMBED
# allowedDomains: RUNTIME ALLOWED DOMAINS FOR EMBEDDING
# sessionTags: SESSION TAGS USED FOR ROW-LEVEL SECURITY
def generateEmbedUrlForAnonymousUser(accountId, quicksightNamespace, authorizedResourceArns, allowedDomains, sessionTags):
    try:
        response = quicksightClient.generate_embed_url_for_anonymous_user(
            AwsAccountId = accountId,
            Namespace = quicksightNamespace,
            AuthorizedResourceArns = authorizedResourceArns,
            AllowedDomains = allowedDomains,
            ExperienceConfiguration = {
                'GenerativeQnA': {
                        'InitialTopicId': topicId
                    }
            },
            SessionTags = sessionTags,
            SessionLifetimeInMinutes = 600
        )
            
        return {
            'statusCode': 200,
            'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
            'body': json.dumps(response),
            'isBase64Encoded':  bool('false')
        }
    except ClientError as e:
        print(e)
        return "Error generating embeddedURL: " + str(e)
```

#### Node.js
<a name="embedded-analytics-gen-bi-anonymous-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    region: 'us-east-1',
});

quicksightClient.generateEmbedUrlForAnonymousUser({
    'AwsAccountId': '111122223333',
    'Namespace': 'DEFAULT'
    'AuthorizedResourceArns': '["topic-arn-topicId1","topic-arn-topicId2"]',
    'AllowedDomains': allowedDomains,
    'ExperienceConfiguration': { 
        'GenerativeQnA': {
            'InitialTopicId': 'U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f'
        }
    },
    'SessionTags': '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]',
    'SessionLifetimeInMinutes': 15
}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

#### .NET/C\$1
<a name="embedded-analytics-gen-bi-anonymous-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL de la sesión de la barra de búsqueda de Q. Puede utilizar esta URL en su sitio web o aplicación para mostrar la barra de búsqueda de Q. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateGenerativeQnAEmbedUrlForAnonymousUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                AnonymousUserGenerativeQnAEmbeddingConfiguration anonymousUserGenerativeQnAEmbeddingConfiguration
                    = new AnonymousUserGenerativeQnAEmbeddingConfiguration
                    {
                        InitialTopicId = "U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f"
                    };
                AnonymousUserEmbeddingExperienceConfiguration anonymousUserEmbeddingExperienceConfiguration
                    = new AnonymousUserEmbeddingExperienceConfiguration
                    {
                        GenerativeQnA = anonymousUserGenerativeQnAEmbeddingConfiguration
                    }; 
                
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForAnonymousUserAsync(new GenerateEmbedUrlForAnonymousUserRequest
                    {
                        AwsAccountId = "111122223333",
                        Namespace = "DEFAULT",
                        AuthorizedResourceArns '["topic-arn-topicId1","topic-arn-topicId2"]',
                        AllowedDomains = allowedDomains,
                        ExperienceConfiguration = anonymousUserEmbeddingExperienceConfiguration,
                        SessionTags = '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]',
                        SessionLifetimeInMinutes = 15,
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

#### AWS CLI
<a name="embedded-analytics-gen-bi-anonymous-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice SAML para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForAnonymousUser` habilitados.

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_generative_qna_role" \
     --role-session-name anonymous caller
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. En un ordenador con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_q_search_bar_role/QuickSightEmbeddingAnonymousPolicy`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. Además, mantiene cada sesión separada y distinta. Si utiliza una serie de servidores web, por ejemplo, para equilibrar la carga, y una sesión se vuelve a conectar a un servidor diferente, se inicia una nueva sesión.

Para obtener una URL firmada para el panel, llame a `generate-embed-url-for-anynymous-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un panel integrado mediante una llamada desde el servidor para los usuarios que realizan visitas anónimas a su portal web o aplicación.

```
aws quicksight generate-embed-url-for-anonymous-user \
--aws-account-id 111122223333 \
--namespace default-or-something-else \
--authorized-resource-arns '["topic-arn-topicId","topic-arn-topicId2"]' \
--allowed-domains '["domain1","domain2"]' \
--experience-configuration 'GenerativeQnA={InitialTopicId="topicId1"}' \
--session-tags '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]' \
--session-lifetime-in-minutes 15
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html). Puede utilizar esta y otras operaciones de la API en su propio código.

### Paso 3: incrustación de la URL de la experiencia de preguntas y respuestas generativas
<a name="embedded-analytics-gen-bi-anonymous-users-step-3"></a>

En la siguiente sección, encontrará información sobre cómo incrustar la URL de la experiencia de preguntas y respuestas generativas en su sitio web o página de la aplicación. Esto se hace con el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript). Con el SDK, puede hacer lo siguiente: 
+ Colocar la experiencia de preguntas y respuestas generativas en una página HTML.
+ Personalizar el diseño y la apariencia de la experiencia incrustada para adaptarla a las necesidades de su aplicación.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llame a la operación de la API `GenerateEmbedUrlForAnonymousUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un valor `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-anonymous-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.{
     "Status": "200",
     "EmbedUrl": "https://quicksightdomain/embedding/12345/q/search...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Incorpore la experiencia de preguntas y respuestas generativas en su página web con el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. 

Asegúrese de que el dominio en el que se alojará la experiencia de preguntas y respuestas generativas esté en la lista de dominios *permitidos, la lista* de dominios aprobados para su suscripción a Amazon Quick Sight. Este requisito protege los datos al impedir que dominios no aprobados alojen experiencias de preguntas y respuestas generativas incrustadas. Para obtener más información sobre cómo agregar dominios para la experiencia de preguntas y respuestas generativas incrustada, consulte [Administrar dominios](manage-domains.md).

Puede utilizar el SDK de incrustación Quick Sight de Amazon para personalizar el diseño y la apariencia de la experiencia de preguntas y respuestas generativas integrada para adaptarla a su aplicación. Use la propiedad `panelType` para configurar el estado inicial de la experiencia de preguntas y respuestas generativas cuando se muestre en su aplicación. Establezca la propiedad `panelType` en `'FULL'` para que represente el panel completo de la experiencia de preguntas y respuestas generativas. Este panel se parece a la experiencia que tienen los usuarios de Amazon Quick Sight en la consola Amazon Quick Sight. La altura del marco del panel no cambia en función de la interacción del usuario y respeta el valor establecido en la propiedad `frameOptions.height`. La siguiente imagen muestra el panel de la experiencia de preguntas y respuestas generativas que se representa cuando se establece el valor `panelType` en `'FULL'`.

Establezca la propiedad `panelType` en `'SEARCH_BAR'` para que represente la experiencia de preguntas y respuestas generativas como una barra de búsqueda. Esta barra de búsqueda se parece a la forma en que se representa la barra de búsqueda de Q cuando está incrustada en una aplicación. La barra de búsqueda preguntas y respuestas generativas se expande hasta convertirse en un panel más grande que muestra las opciones de selección de temas, la lista de sugerencias de preguntas, el panel de respuestas o el tablón de anuncios.

La altura mínima predeterminada de la barra de búsqueda de preguntas y respuestas generativas se representa cuando se carga el recurso incrustado. Se recomienda establecer el valor `frameOptions.height` en `"38px"` para optimizar la experiencia de la barra de búsqueda. Use la propiedad `focusedHeight` para establecer el tamaño óptimo del menú desplegable de selección de temas y de la lista de sugerencias de preguntas. Utilice la propiedad `expandedHeight` para establecer el tamaño óptimo del panel de respuestas y del tablón de anuncios. Si elige la opción `'SEARCH_BAR'`, se recomienda diseñar el contenedor principal con una posición (absoluta) para evitar que contenido no deseado se desplace en la aplicación. La siguiente imagen muestra la barra de búsqueda de la experiencia de preguntas y respuestas generativas que se representa cuando se establece el valor `panelType` en `'SEARCH_BAR'`.

Tras configurar la `panelType` propiedad, utilice el SDK de incrustación de Amazon Quick Sight para personalizar las siguientes propiedades de la experiencia de preguntas y respuestas generativas.
+ El título del panel de preguntas y respuestas generativas (solo se aplica a la opción `panelType: FULL`). 
+ El texto del marcador de posición de la barra de búsqueda.
+ Si se permite la selección de temas.
+ Si se muestran u ocultan los nombres de los temas.
+ Si se muestra u oculta el icono de Amazon Q (solo se aplica a la opción `panelType: FULL`).
+ Si muestra u oculta el tablón de anuncios.
+ Si los usuarios pueden maximizar el panel de preguntas y respuestas generativas a pantalla completa.
+ El tema del panel de preguntas y respuestas generativas. Se puede pasar un ARN de tema personalizado al SDK para cambiar la apariencia del contenido del marco. Los temas de inicio de Amazon Quick Sight no son compatibles con los paneles de BI generativa integrados. Para usar un tema de inicio de Amazon Quick Sight, guárdalo como tema personalizado en Amazon Quick Sight.

Cuando utilizas el SDK de incrustación Quick Sight de Amazon, la experiencia de preguntas y respuestas generativas de tu página cambia de tamaño de forma dinámica en función del estado. Con el SDK de incrustación Quick Sight de Amazon, también puede controlar los parámetros de la experiencia de preguntas y respuestas generativas y recibir llamadas en términos de finalización de la carga de la página, cambios de estado y errores. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

#### SDK 2.0
<a name="embedded-analytics-gen-bi-anonymous-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>
    <head>
        <title>Generative Q&A Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.7.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedGenerativeQnA = async() => {    
                const {createEmbeddingContext} = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    // Optional panel settings. Default behavior is equivalent to {panelType: 'FULL'}
                    panelOptions: {
                        panelType: 'FULL',
                        title: 'custom title', // Optional
                        showQIcon: false, // Optional, Default: true
                    },
                    // Use SEARCH_BAR panel type for the landing state to be similar to embedQSearchBar
                    // with generative capability enabled topics
                    /*
                    panelOptions: {
                        panelType: 'SEARCH_BAR',
                        focusedHeight: '250px',
                        expandedHeight: '500px',
                    },
                    */
                    showTopicName: false, // Optional, Default: true
                    showPinboard: false, // Optional, Default: true
                    allowTopicSelection: false, // Optional, Default: true
                    allowFullscreen: false, // Optional, Default: true
                    searchPlaceholderText: "custom search placeholder", // Optional
                    themeOptions: { // Optional
                        themeArn: 'arn:aws:quicksight:<Region>:<AWS-Account-ID>:theme/<Theme-ID>'
                    }
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'Q_SEARCH_OPENED': {
                                // called when pinboard is shown / visuals are rendered
                                console.log("Do something when SEARCH_BAR type panel is expanded");
                                break;
                            }
                            case 'Q_SEARCH_FOCUSED': {
                                // called when question suggestions or topic selection dropdown are shown
                                console.log("Do something when SEARCH_BAR type panel is focused");
                                break;
                            }
                            case 'Q_SEARCH_CLOSED': {
                                // called when shrinked to initial bar height
                                console.log("Do something when SEARCH_BAR type panel is collapsed");
                                break;
                            }
                            case 'Q_PANEL_ENTERED_FULLSCREEN': {
                                console.log("Do something when panel enters full screen mode");
                                break;
                            }
                            case 'Q_PANEL_EXITED_FULLSCREEN': {
                                console.log("Do something when panel exits full screen mode");
                                break;
                            }
                            case 'CONTENT_LOADED': {
                                console.log("Do something after experience is loaded");
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Do something when experience fails to load");
                                break;
                            }
                        }
                    }
                };
                const embeddedGenerativeQnExperience = await embeddingContext.embedGenerativeQnA(frameOptions, contentOptions);
            };
        </script>
    </head>

    <body onload="embedGenerativeQnA()">
        <div id="experience-container"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrate de usar el SDK de incrustación de Amazon Quick Sight para cargar la experiencia de preguntas y respuestas generativas integrada en tu sitio web. JavaScript Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

### Funcionalidades opcionales de la experiencia de preguntas y respuestas generativas incrustada
<a name="embedded-analytics-gen-bi-anonymous-users-step-4"></a>

A continuación se detallan las funcionalidades opcionales que están disponibles para la experiencia de preguntas y respuestas generativas con el SDK de incrustación. 

#### Invocación de acciones de la barra de preguntas y respuestas generativas
<a name="w2aac35c27c21c43c29c13c25b5"></a>
+ Establecer una pregunta: esta característica envía una pregunta a la experiencia de preguntas y respuestas generativas y consulta la pregunta de inmediato.

  ```
  embeddedGenerativeQnExperience.setQuestion('show me monthly revenue');
  ```
+ Cerrar el panel de respuestas (se aplica a la opción de la barra de búsqueda preguntas y respuestas generativas): esta característica cierra el panel de respuestas y devuelve el iframe al estado original de la barra de búsqueda.

  ```
  embeddedGenerativeQnExperience.close();
  ```

Para obtener más información, consulte el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk).

# Incrustar la barra de búsqueda Quick Sight Q de Amazon (clásica)
<a name="embedding-quicksight-q"></a>


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

Utilice los siguientes temas para obtener información sobre cómo incrustar la barra de búsqueda de Amazon Quick Sight Q en Amazon Quick Sight APIs.

**Topics**
+ [Incrustar la barra de búsqueda Quick Sight Q de Amazon para usuarios registrados](embedded-analytics-q-search-bar-for-authenticated-users.md)
+ [Incrustar la barra de búsqueda Quick Sight Q de Amazon para usuarios anónimos (no registrados)](embedded-analytics-q-search-bar-for-anonymous-users.md)

# Incrustar la barra de búsqueda Quick Sight Q de Amazon para usuarios registrados
<a name="embedded-analytics-q-search-bar-for-authenticated-users"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En las siguientes secciones, encontrará información detallada sobre cómo configurar una barra de búsqueda integrada de Amazon Quick Sight Q para los usuarios registrados de Amazon Quick Sight.

**Topics**
+ [Paso 1: configuración de permisos](#embedded-q-bar-for-authenticated-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-q-bar-for-authenticated-users-step-2)
+ [Paso 3: integración de la URL de la barra de búsqueda de Q](#embedded-q-bar-for-authenticated-users-step-3)
+ [Funcionalidades opcionales de incrustación en la barra de búsqueda Quick Sight Q de Amazon](#embedded-q-bar-for-authenticated-users-step-4)

## Paso 1: configuración de permisos
<a name="embedded-q-bar-for-authenticated-users-step-1"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En la siguiente sección, puede encontrar información sobre cómo configurar los permisos de la aplicación de backend o del servidor web para integrar la barra de búsqueda de Q. Esta tarea requiere acceso administrativo a (IAM). AWS Identity and Access Management 

Cada usuario que accede a un panel de control asume una función que le da acceso a Amazon Quick Sight y permisos para acceder al panel. Para que esto sea posible, cree un rol de IAM en su. Cuenta de AWS Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. El rol de IAM debe proporcionar permisos para recuperar la incrustación de un grupo URLs de usuarios específico. 

Con la ayuda del carácter comodín *\$1*, puede conceder los permisos necesarios para generar una URL para todos los usuarios de un espacio de nombres específico. También puede conceder permisos para generar una URL para un subconjunto de usuarios en espacios de nombres específicos. Para ello, añada `quicksight:GenerateEmbedUrlForRegisteredUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForRegisteredUser`. El parámetro `AllowedDomains` es opcional. Ofrece a los desarrolladores la opción de anular los dominios estáticos que están configurados en el menú **Administrar Amazon Quick Sight** y, en su lugar, enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web del desarrollador. Solo los dominios que aparecen en el parámetro pueden acceder a la barra de búsqueda de Q. Sin esta condición, los desarrolladores pueden incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForRegisteredUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente se traduce en el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La siguiente política de ejemplo ofrece estos permisos.

Además, si vas a crear usuarios primerizos que vayan a ser lectores de Amazon Quick Sight, asegúrate de añadir el `quicksight:RegisterUser` permiso en la política.

El siguiente ejemplo de política proporciona permiso para recuperar una URL incrustada para los usuarios primerizos que vayan a ser lectores de Amazon Quick Sight.

Finalmente, la identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. 

En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o lenguaje de marcado para confirmaciones de seguridad (SAML), consulte las siguientes secciones de la *Guía de usuario de IAM:*
+ [Creación de un rol para identidades web o de OpenID Connect Federation (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-q-bar-for-authenticated-users-step-2"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En la siguiente sección, encontrará cómo autenticar a su usuario y obtener la URL del tema de Q integrable en su servidor de aplicaciones. Si planea incrustar la barra Q para los tipos de identidad de IAM o Amazon Quick Sight, comparta el tema Q con los usuarios.

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, la aplicación añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar los pasos descritos, se garantiza que cada espectador del tema Q se aprovisione de forma exclusiva en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Este código se ejecuta en el servidor de aplicaciones.

### Java
<a name="embedded-q-bar-for-embedded-q-bar-for-authenticated-users-java"></a>

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
        import com.amazonaws.auth.AWSCredentialsProvider;
        import com.amazonaws.regions.Regions;
        import com.amazonaws.services.quicksight.AmazonQuickSight;
        import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserRequest;
import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForRegisteredUserResult;
import com.amazonaws.services.quicksight.model.RegisteredUserEmbeddingExperienceConfiguration;
import com.amazonaws.services.quicksight.model.RegisteredUserQSearchBarEmbeddingConfiguration;

        /**
 * Class to call QuickSight AWS SDK to get url for embedding the Q search bar.
        */
public class RegisteredUserQSearchBarEmbeddingConfiguration {

            private final AmazonQuickSight quickSightClient;

    public RegisteredUserQSearchBarEmbeddingConfiguration() {
        this.quickSightClient = AmazonQuickSightClientBuilder
                    .standard()
                    .withRegion(Regions.US_EAST_1.getName())
                    .withCredentials(new AWSCredentialsProvider() {
                            @Override
                            public AWSCredentials getCredentials() {
                                // provide actual IAM access key and secret key here
                                return new BasicAWSCredentials("access-key", "secret-key");
                            }

                            @Override
                            public void refresh() {
                            }
                        }
                    )
                    .build();
            }

    public String getQuicksightEmbedUrl(
            final String accountId, // AWS Account ID
            final String topicId, // Topic ID to embed
            final List<String> allowedDomains, // Runtime allowed domain for embedding
            final String userArn // Registered user arn to use for embedding. Refer to Get Embed Url section in developer portal to find how to get user arn for a QuickSight user.
            ) throws Exception {
        final RegisteredUserEmbeddingExperienceConfiguration experienceConfiguration = new RegisteredUserEmbeddingExperienceConfiguration()
                .withQSearchBar(new RegisteredUserQSearchBarEmbeddingConfiguration().withInitialTopicId(topicId));
        final GenerateEmbedUrlForRegisteredUserRequest generateEmbedUrlForRegisteredUserRequest = new GenerateEmbedUrlForRegisteredUserRequest();
        generateEmbedUrlForRegisteredUserRequest.setAwsAccountId(accountId);
        generateEmbedUrlForRegisteredUserRequest.setUserArn(userArn);
        generateEmbedUrlForRegisteredUserRequest.setAllowedDomains(allowedDomains);
        generateEmbedUrlForRegisteredUserRequest.setExperienceConfiguration(QSearchBar);

        final GenerateEmbedUrlForRegisteredUserResult generateEmbedUrlForRegisteredUserResult = quickSightClient.generateEmbedUrlForRegisteredUser(generateEmbedUrlForRegisteredUserRequest);

        return generateEmbedUrlForRegisteredUserResult.getEmbedUrl();
            }
        }
```

### JavaScript
<a name="embedded-q-bar-for-embedded-q-bar-for-authenticated-users-js"></a>

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function generateEmbedUrlForRegisteredUser(
    accountId,
    topicId, // Topic ID to embed
    openIdToken, // Cognito-based token
    userArn, // registered user arn
    roleArn, // IAM user role to use for embedding
    sessionName, // Session name for the roleArn assume role
    allowedDomains, // Runtime allowed domain for embedding
    getEmbedUrlCallback, // GetEmbedUrl success callback method
    errorCallback // GetEmbedUrl error callback method
    ) {
    const stsClient = new AWS.STS();
    let stsParams = {
        RoleSessionName: sessionName,
        WebIdentityToken: openIdToken,
        RoleArn: roleArn
        }
    
    stsClient.assumeRoleWithWebIdentity(stsParams, function(err, data) {
        if (err) {
            console.log('Error assuming role');
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const getQSearchBarParams = {
        "AwsAccountId": accountId,
                "ExperienceConfiguration": {
                    "QSearchBar": {
                        "InitialTopicId": topicId
                    }
                },
                "UserArn": userArn,
        "AllowedDomains": allowedDomains,
        "SessionLifetimeInMinutes": 600
    };

            const quicksightGetQSearchBar = new AWS.QuickSight({
        region: process.env.AWS_REGION,
                credentials: {
                    accessKeyId: data.Credentials.AccessKeyId,
                    secretAccessKey: data.Credentials.SecretAccessKey,
                    sessionToken: data.Credentials.SessionToken,
                    expiration: data.Credentials.Expiration
                }
    });

            quicksightGetQSearchBar.generateEmbedUrlForRegisteredUser(getQSearchBarParams, function(err, data) {
        if (err) {
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const result = {
                "statusCode": 200,
                "headers": {
                            "Access-Control-Allow-Origin": "*", // Use your website domain to secure access to GetEmbedUrl API
                    "Access-Control-Allow-Headers": "Content-Type"
                },
                "body": JSON.stringify(data),
                "isBase64Encoded": false
            }
                    getEmbedUrlCallback(result);
                }
            });
        }
    });
}
```

### Python3
<a name="embedded-q-bar-for-embedded-q-bar-for-authenticated-users-python"></a>

```
import json
import boto3
from botocore.exceptions import ClientError

sts = boto3.client('sts')

# Function to generate embedded URL  
# accountId: AWS account ID
# topicId: Topic ID to embed
# userArn: arn of registered user
# allowedDomains: Runtime allowed domain for embedding
# roleArn: IAM user role to use for embedding
# sessionName: session name for the roleArn assume role
def getEmbeddingURL(accountId, topicId, userArn, allowedDomains, roleArn, sessionName):
    try:
        assumedRole = sts.assume_role(
            RoleArn = roleArn,
            RoleSessionName = sessionName,
        )
    except ClientError as e:
        return "Error assuming role: " + str(e)
    else: 
        assumedRoleSession = boto3.Session(
            aws_access_key_id = assumedRole['Credentials']['AccessKeyId'],
            aws_secret_access_key = assumedRole['Credentials']['SecretAccessKey'],
            aws_session_token = assumedRole['Credentials']['SessionToken'],
        )
        try:
            quicksightClient = assumedRoleSession.client('quicksight', region_name='us-west-2')
            response = quicksightClient.generate_embed_url_for_registered_user(
                AwsAccountId=accountId,
                ExperienceConfiguration = {
                    "QSearchBar": {
                        "InitialTopicId": topicId
                    }
                },
                UserArn = userArn,
                AllowedDomains = allowedDomains,
                SessionLifetimeInMinutes = 600
            )
            
            return {
                'statusCode': 200,
                'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
                'body': json.dumps(response),
                'isBase64Encoded':  bool('false')
            }
        except ClientError as e:
            return "Error generating embedding url: " + str(e)
```

### Node.js
<a name="embedded-q-bar-for-embedded-q-bar-for-authenticated-users-node"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    apiConfig: require('./quicksight-2018-04-01.min.json'),
    region: 'us-east-1',
});

quicksightClient.generateEmbedUrlForRegisteredUser({
    'AwsAccountId': '111122223333',
    'ExperienceConfiguration': { 
        'QSearchBar': {
            'InitialTopicId': 'U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f'
        }
    },
    'UserArn': 'REGISTERED_USER_ARN',
    'AllowedDomains': allowedDomains,
    'SessionLifetimeInMinutes': 100
}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    { 
        Status: 200,
        EmbedUrl: "https://quicksightdomain/embed/12345/dashboards/67890/sheets/12345/visuals/67890...",
        RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' 
    }
```

### .NET/C\$1
<a name="embedded-q-bar-for-embedded-q-bar-for-authenticated-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL de la sesión de la barra de búsqueda de Q. Puede utilizar esta URL en su sitio web o aplicación para mostrar la barra de búsqueda de Q. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateDashboardEmbedUrlForRegisteredUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                RegisteredUserQSearchBarEmbeddingConfiguration registeredUserQSearchBarEmbeddingConfiguration
                    = new RegisteredUserQSearchBarEmbeddingConfiguration
                    {
                        InitialTopicId = "U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f"
                    };
                RegisteredUserEmbeddingExperienceConfiguration registeredUserEmbeddingExperienceConfiguration
                    = new RegisteredUserEmbeddingExperienceConfiguration
                    {
                        QSearchBar = registeredUserQSearchBarEmbeddingConfiguration
                    }; 
                
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForRegisteredUserAsync(new GenerateEmbedUrlForRegisteredUserRequest
                    {
                        AwsAccountId = "111122223333",
                        ExperienceConfiguration = registeredUserEmbeddingExperienceConfiguration,
                        UserArn = "REGISTERED_USER_ARN",
                        AllowedDomains = allowedDomains,
                        SessionLifetimeInMinutes = 100
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

### AWS CLI
<a name="embedded-q-bar-for-embedded-q-bar-for-authenticated-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice SAML para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForRegisteredUser` habilitados. Si opta por añadir just-in-time usuarios cuando utilizan un tema en la barra de búsqueda de Q, también es necesario activar los permisos para el rol. `quicksight:RegisterUser`

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_q_search_bar_role" \
     --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. En un ordenador con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_q_search_bar_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan a la barra de búsqueda Q. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
    --aws-account-id 111122223333 \
    --namespace default \
    --identity-type IAM \
    --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_q_search_bar_role" \
    --user-role READER \
    --user-name jhnd \
    --session-name "john.doe@example.com" \
    --email john.doe@example.com \
    --region us-east-1 \
    --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el Nombre de recurso de Amazon (ARN) del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puedes añadir este usuario al grupo con el que se comparte el panel. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
    --aws-account-id=111122223333 \
    --namespace=default \
    --group-name=financeusers \
    --member-name="embedding_quicksight_q_search_bar_role/john.doe@example.com"
```

Ahora tienes un usuario de tu aplicación que también es usuario de Amazon Quick Sight y que tiene acceso al panel de control. 

Por último, para obtener una URL firmada para el panel, llame a `generate-embed-url-for-registered-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un panel integrado mediante una llamada desde el servidor para los usuarios autenticados mediante un inicio de sesión único ( AWS Managed Microsoft AD IAM Identity Center).

```
aws quicksight generate-embed-url-for-registered-user \
--aws-account-id 111122223333 \
--session-lifetime-in-minutes 600 \
--user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/embedding_quicksight_q_search_bar_role/embeddingsession
--allowed-domains '["domain1","domain2"]' \
--experience-configuration QSearchBar={InitialTopicId=U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f}
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html). Puede utilizar esta y otras operaciones de la API en su propio código.

## Paso 3: integración de la URL de la barra de búsqueda de Q
<a name="embedded-q-bar-for-authenticated-users-step-3"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En la siguiente sección, puede encontrar cómo integrar la URL de la barra de búsqueda Q del paso 3 en su sitio web o página de la aplicación. Esto se hace con el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript). Con el SDK, puede hacer lo siguiente: 
+ Colocar la barra de búsqueda de Q en una página HTML.
+ Pasar los parámetros a la barra de búsqueda de Q.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llame a la operación de la API `GenerateEmbedUrlForRegisteredUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un valor `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-registered-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https://quicksightdomain/embedding/12345/q/search...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Inserta la barra de búsqueda Q en tu página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. 

Para ello, asegúrate de que el dominio que alojará la barra de búsqueda Q integrada esté en la *lista de dominios permitidos*, la lista de dominios aprobados para tu suscripción a Amazon Quick Sight. Este requisito protege los datos impidiendo que dominios no aprobados alojen paneles integrados. Para obtener más información sobre cómo añadir dominios a una barra de búsqueda Q integrada, consulte [Gestión de dominios e incrustación.](https://docs.aws.amazon.com/quicksight/latest/user/manage-qs-domains-and-embedding.html)

Cuando utilizas el SDK de incrustación Quick Sight de Amazon, la barra de búsqueda Q de tu página cambia de tamaño de forma dinámica en función del estado. Al utilizar el SDK de incrustación Quick Sight de Amazon, también puedes controlar los parámetros de la barra de búsqueda Q y recibir llamadas en función de la finalización de la carga de la página y de los errores. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-q-bar-for-authenticated-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Q Search Bar Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedQSearchBar = async() => {    
                const {
                    createEmbeddingContext,
                } = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    hideTopicName: false, 
                    theme: '<YOUR_THEME_ID>',
                    allowTopicSelection: true,
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'Q_SEARCH_OPENED': {
                                console.log("Do something when Q Search content expanded");
                                break;
                            }
                            case 'Q_SEARCH_CLOSED': {
                                console.log("Do something when Q Search content collapsed");
                                break;
                            }
                            case 'Q_SEARCH_SIZE_CHANGED': {
                                console.log("Do something when Q Search size changed");
                                break;
                            }
                            case 'CONTENT_LOADED': {
                                console.log("Do something when the Q Search is loaded.");
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Do something when the Q Search fails loading.");
                                break;
                            }
                        }
                    }
                };
                const embeddedDashboardExperience = await embeddingContext.embedQSearchBar(frameOptions, contentOptions);
            };
        </script>
    </head>

    <body onload="embedQSearchBar()">
        <div id="experience-container"></div>
    </body>

</html>
```

### SDK 1.0
<a name="embedded-q-bar-for-authenticated-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>QuickSight Q Search Bar Embedding</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@1.18.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            var session

            function onError(payload) {
                console.log("Do something when the session fails loading");
            }

            function onOpen() {
                console.log("Do something when the Q search bar opens");
            }

            function onClose() {
                console.log("Do something when the Q search bar closes");
            }

            function embedQSearchBar() {
                var containerDiv = document.getElementById("embeddingContainer");
                var options = {
                    url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode", // replace this dummy url with the one generated via embedding API
                    container: containerDiv,
                    width: "1000px",
                    locale: "en-US",
                    qSearchBarOptions: {
                        expandCallback: onOpen,
                        collapseCallback: onClose,
                        iconDisabled: false,
                        topicNameDisabled: false, 
                        themeId: 'bdb844d0-0fe9-4d9d-b520-0fe602d93639',
                        allowTopicSelection: true
                    }
                };
                session = QuickSightEmbedding.embedQSearchBar(options);
                session.on("error", onError);
            }

            function onCountryChange(obj) {
                session.setParameters({country: obj.value});
            }
        </script>
    </head>

    <body onload="embedQSearchBar()">
        <div id="embeddingContainer"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el panel integrado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

## Funcionalidades opcionales de incrustación en la barra de búsqueda Quick Sight Q de Amazon
<a name="embedded-q-bar-for-authenticated-users-step-4"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

Las siguientes funcionalidades opcionales están disponibles para la barra de búsqueda de Q integrada mediante el SDK de integración. 

### Invocación de las acciones de la barra de búsqueda de Q
<a name="w2aac35c27c21c43c31c15c21b7"></a>

Las siguientes opciones solo son compatibles con la integración de la barra de búsqueda de Q. 
+ Establecer una pregunta en la barra de búsqueda de Q: esta característica envía una pregunta a la barra de búsqueda de Q e inmediatamente la consulta. También abre automáticamente la ventana emergente de Q.

  ```
  qBar.setQBarQuestion('show me monthly revenue');
  ```
+ Cerrar la ventana emergente de Q: esta característica cierra la ventana emergente de Q y devuelve el iframe al tamaño original de la barra de búsqueda de Q.

  ```
  qBar.closeQPopover();
  ```

Para obtener más información, consulte el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk).

# Incrustar la barra de búsqueda Quick Sight Q de Amazon para usuarios anónimos (no registrados)
<a name="embedded-analytics-q-search-bar-for-anonymous-users"></a>


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En las siguientes secciones, encontrará información detallada sobre cómo configurar una barra de búsqueda integrada de Amazon Quick Sight Q para usuarios anónimos (no registrados).

**Topics**
+ [Paso 1: configuración de permisos](#embedded-q-bar-for-anonymous-users-step-1)
+ [Paso 2: generación de la URL con el código de autenticación adjunto](#embedded-q-bar-for-anonymous-users-step-2)
+ [Paso 3: integración de la URL de la barra de búsqueda de Q](#embedded-q-bar-for-anonymous-users-step-3)
+ [Funcionalidades opcionales de incrustación en la barra de búsqueda Quick Sight Q de Amazon](#embedded-q-bar-for-anonymous-users-step-4)

## Paso 1: configuración de permisos
<a name="embedded-q-bar-for-anonymous-users-step-1"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En la siguiente sección, puede encontrar información sobre cómo configurar los permisos de la aplicación de backend o del servidor web para integrar la barra de búsqueda de Q. Esta tarea requiere acceso administrativo a (IAM). AWS Identity and Access Management 

Cada usuario que accede a una barra de búsqueda Q asume un rol que le da acceso a Amazon Quick Sight y permisos para acceder a la barra de búsqueda Q. Para que esto sea posible, cree un rol de IAM en su. Cuenta de AWS Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. El rol de IAM debe proporcionar permisos para recuperar la incrustación de un grupo URLs de usuarios específico. 

Con la ayuda del carácter comodín *\$1*, puede conceder los permisos necesarios para generar una URL para todos los usuarios de un espacio de nombres específico. También puede conceder permisos para generar una URL para un subconjunto de usuarios en espacios de nombres específicos. Para ello, añada `quicksight:GenerateEmbedUrlForAnonymousUser`.

Puede crear una condición en su política de IAM que limite los dominios que los desarrolladores pueden incluir en el parámetro `AllowedDomains` de una operación de la API `GenerateEmbedUrlForAnonymousUser`. El parámetro `AllowedDomains` es opcional. Ofrece a los desarrolladores la opción de anular los dominios estáticos que están configurados en el menú **Administrar Amazon Quick Sight** y, en su lugar, enumerar hasta tres dominios o subdominios que pueden acceder a una URL generada. A continuación, esta URL se integra en el sitio web del desarrollador. Solo los dominios que aparecen en el parámetro pueden acceder a la barra de búsqueda de Q. Sin esta condición, los desarrolladores pueden incluir cualquier dominio de Internet en el parámetro `AllowedDomains`. 

Para limitar los dominios que los desarrolladores pueden usar con este parámetro, añada una condición `AllowedEmbeddingDomains` a su política de IAM. Para obtener más información sobre el `AllowedDomains` parámetro, consulte la *referencia [GenerateEmbedUrlForAnonymousUser](https://docs.aws.amazon.com//quicksight/latest/APIReference/API_GenerateEmbedUrlForAnonymousUser.html)de la API de Amazon Quick Sight*.

**Prácticas recomendadas de seguridad para los operadores de condiciones de IAM**  
Los operadores de condiciones de IAM configurados incorrectamente pueden permitir el acceso no autorizado a los recursos rápidos integrados mediante variaciones de URL. Cuando utilices la clave de `quicksight:AllowedEmbeddingDomains` condición en tus políticas de IAM, utiliza operadores de condiciones que permitan dominios específicos o denieguen todos los dominios que no estén específicamente permitidos. Para obtener más información sobre los operadores de condiciones de IAM, consulte [Elementos de la política JSON de IAM: operadores de condiciones](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html) en la Guía del usuario de IAM.  
Muchas variaciones de URL diferentes pueden apuntar al mismo recurso. Por ejemplo, URLs todo lo siguiente tiene el mismo contenido:  
`https://example.com`
`https://example.com/`
`https://Example.com`
Si su política utiliza operadores que no tienen en cuenta estas variaciones de URL, un atacante puede eludir sus restricciones proporcionando variaciones de URL equivalentes.  
Debe comprobar que su política de IAM utiliza los operadores de condiciones adecuados para evitar que se eludan las vulnerabilidades y garantizar que solo los dominios a los que va destinados puedan acceder a los recursos integrados.

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que, cuando un usuario accede a su aplicación, esta puede asumir el rol en nombre del usuario para abrir la barra de búsqueda de Q. En el siguiente ejemplo, se muestra una muestra de política de confianza.

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

****  

```
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Sid": "AllowLambdaFunctionsToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        },
        {
            "Sid": "AllowEC2InstancesToAssumeThisRole",
            "Effect": "Allow",
            "Principal": {
                "Service": "ec2.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}
```

------

Para obtener más información sobre las políticas de confianza, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la *Guía del usuario de IAM*

## Paso 2: generación de la URL con el código de autenticación adjunto
<a name="embedded-q-bar-for-anonymous-users-step-2"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En la siguiente sección, encontrará cómo autenticar a su usuario y obtener la URL del tema de Q integrable en su servidor de aplicaciones.

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, la aplicación añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Para obtener más información, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/AnonymousUserQSearchBarEmbeddingConfiguration.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/AnonymousUserQSearchBarEmbeddingConfiguration.html).

### Java
<a name="embedded-q-bar-for-anonymous-users-java"></a>

```
        import java.util.List;
        import com.amazonaws.auth.AWSCredentials;
        import com.amazonaws.auth.AWSCredentialsProvider;
        import com.amazonaws.auth.BasicAWSCredentials;
        import com.amazonaws.regions.Regions;
        import com.amazonaws.services.quicksight.AmazonQuickSight;
        import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
        import com.amazonaws.services.quicksight.model.AnonymousUserQSearchBarEmbeddingConfiguration;
        import com.amazonaws.services.quicksight.model.AnonymousUserEmbeddingExperienceConfiguration;
        import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserRequest;
        import com.amazonaws.services.quicksight.model.GenerateEmbedUrlForAnonymousUserResult;
        import com.amazonaws.services.quicksight.model.SessionTag;


        /**
        * Class to call QuickSight AWS SDK to generate embed url for anonymous user.
        */
        public class GenerateEmbedUrlForAnonymousUserExample {

            private final AmazonQuickSight quickSightClient;

            public GenerateEmbedUrlForAnonymousUserExample() {
                quickSightClient = AmazonQuickSightClientBuilder
                    .standard()
                    .withRegion(Regions.US_EAST_1.getName())
                    .withCredentials(new AWSCredentialsProvider() {
                            @Override
                            public AWSCredentials getCredentials() {
                                // provide actual IAM access key and secret key here
                                return new BasicAWSCredentials("access-key", "secret-key");
                            }

                            @Override
                            public void refresh() {
                            }
                        }
                    )
                    .build();
            }

            public String GenerateEmbedUrlForAnonymousUser(
                final String accountId, // YOUR AWS ACCOUNT ID
                final String initialTopicId, // Q TOPIC ID TO WHICH THE CONSTRUCTED URL POINTS AND SEARCHBAR PREPOPULATES INITIALLY
                final String namespace, // ANONYMOUS EMBEDDING REQUIRES SPECIFYING A VALID NAMESPACE FOR WHICH YOU WANT THE EMBEDDING URL
                final List<String> authorizedResourceArns, // Q SEARCHBAR TOPIC ARN LIST TO EMBED
                final List<String> allowedDomains, // RUNTIME ALLOWED DOMAINS FOR EMBEDDING
                final List<SessionTag> sessionTags // SESSION TAGS USED FOR ROW-LEVEL SECURITY
            ) throws Exception {
                AnonymousUserEmbeddingExperienceConfiguration experienceConfiguration = new AnonymousUserEmbeddingExperienceConfiguration();
                AnonymousUserQSearchBarEmbeddingConfiguration qSearchBarConfiguration = new AnonymousUserQSearchBarEmbeddingConfiguration();
                qSearchBarConfiguration.setInitialTopicId(initialTopicId);
                experienceConfiguration.setQSearchBar(qSearchBarConfiguration);

                GenerateEmbedUrlForAnonymousUserRequest generateEmbedUrlForAnonymousUserRequest = new GenerateEmbedUrlForAnonymousUserRequest()
                    .withAwsAccountId(accountId)
                    .withNamespace(namespace)
                    .withAuthorizedResourceArns(authorizedResourceArns)
                    .withExperienceConfiguration(experienceConfiguration)
                    .withSessionTags(sessionTags)
                    .withSessionLifetimeInMinutes(600L); // OPTIONAL: VALUE CAN BE [15-600]. DEFAULT: 600
                    .withAllowedDomains(allowedDomains);

                GenerateEmbedUrlForAnonymousUserResult qSearchBarEmbedUrl = quickSightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserRequest);

                return qSearchBarEmbedUrl.getEmbedUrl();
            }

        }
```

### JavaScript
<a name="embedded-q-bar-for-anonymous-users-js"></a>

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function generateEmbedUrlForAnonymousUser(
    accountId, // YOUR AWS ACCOUNT ID
    initialTopicId, // Q TOPIC ID TO WHICH THE CONSTRUCTED URL POINTS
    quicksightNamespace, // VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
    authorizedResourceArns, // Q SEARCHBAR TOPIC ARN LIST TO EMBED
    allowedDomains, // RUNTIME ALLOWED DOMAINS FOR EMBEDDING
    sessionTags, // SESSION TAGS USED FOR ROW-LEVEL SECURITY
    generateEmbedUrlForAnonymousUserCallback, // SUCCESS CALLBACK METHOD
    errorCallback // ERROR CALLBACK METHOD
    ) {
    const experienceConfiguration = {
        "QSearchBar": {
            "InitialTopicId": initialTopicId // TOPIC ID CAN BE FOUND IN THE URL ON THE TOPIC AUTHOR PAGE
        }
    };
    
    const generateEmbedUrlForAnonymousUserParams = {
        "AwsAccountId": accountId,
        "Namespace": quicksightNamespace,
        "AuthorizedResourceArns": authorizedResourceArns,
        "AllowedDomains": allowedDomains,
        "ExperienceConfiguration": experienceConfiguration,
        "SessionTags": sessionTags,
        "SessionLifetimeInMinutes": 600
    };

    const quicksightClient = new AWS.QuickSight({
        region: process.env.AWS_REGION,
        credentials: {
            accessKeyId: AccessKeyId,
            secretAccessKey: SecretAccessKey,
            sessionToken: SessionToken,
            expiration: Expiration
        }
    });

    quicksightClient.generateEmbedUrlForAnonymousUser(generateEmbedUrlForAnonymousUserParams, function(err, data) {
        if (err) {
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const result = {
                "statusCode": 200,
                "headers": {
                    "Access-Control-Allow-Origin": "*", // USE YOUR WEBSITE DOMAIN TO SECURE ACCESS TO THIS API
                    "Access-Control-Allow-Headers": "Content-Type"
                },
                "body": JSON.stringify(data),
                "isBase64Encoded": false
            }
            generateEmbedUrlForAnonymousUserCallback(result);
        }
    });
}
```

### Python3
<a name="embedded-q-bar-for-anonymous-users-py"></a>

```
import json
import boto3
from botocore.exceptions import ClientError
import time

# Create QuickSight and STS clients
quicksightClient = boto3.client('quicksight',region_name='us-west-2')
sts = boto3.client('sts')

# Function to generate embedded URL for anonymous user
# accountId: YOUR AWS ACCOUNT ID
# quicksightNamespace: VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
# authorizedResourceArns: TOPIC ARN LIST TO EMBED
# allowedDomains: RUNTIME ALLOWED DOMAINS FOR EMBEDDING
# experienceConfiguration: configuration which specifies the TOPIC ID to point URL to
# sessionTags: SESSION TAGS USED FOR ROW-LEVEL SECURITY
def generateEmbedUrlForAnonymousUser(accountId, quicksightNamespace, authorizedResourceArns, allowedDomains, experienceConfiguration, sessionTags):
    try:
        response = quicksightClient.generate_embed_url_for_anonymous_user(
            AwsAccountId = accountId,
            Namespace = quicksightNamespace,
            AuthorizedResourceArns = authorizedResourceArns,
            AllowedDomains = allowedDomains,
            ExperienceConfiguration = experienceConfiguration,
            SessionTags = sessionTags,
            SessionLifetimeInMinutes = 600
        )
            
        return {
            'statusCode': 200,
            'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
            'body': json.dumps(response),
            'isBase64Encoded':  bool('false')
        }
    except ClientError as e:
        print(e)
        return "Error generating embeddedURL: " + str(e)
```

### Node.js
<a name="embedded-q-bar-for-anonymous-users-nodejs"></a>

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para generar la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
const https = require('https');

var quicksightClient = new AWS.Service({
    apiConfig: require('./quicksight-2018-04-01.min.json'),
    region: 'us-east-1',
});

quicksightClient.generateEmbedUrlForAnonymousUser({
    'AwsAccountId': '111122223333',
    'Namespace': 'DEFAULT'
    'AuthorizedResourceArns': '["topic-arn-topicId1","topic-arn-topicId2"]',
    'AllowedDomains': allowedDomains,
    'ExperienceConfiguration': { 
        'QSearchBar': {
            'InitialTopicId': 'U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f'
        }
    },
    'SessionTags': '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]',
    'SessionLifetimeInMinutes': 15
}, function(err, data) {
    console.log('Errors: ');
    console.log(err);
    console.log('Response: ');
    console.log(data);
});
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
    { 
        Status: 200,
        EmbedUrl : 'https://quicksightdomain/embed/12345/dashboards/67890/sheets/12345/visuals/67890...',
        RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' 
    }
```

### .NET/C\$1
<a name="embedded-q-bar-for-anonymous-users-cs"></a>

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para generar la URL de la sesión de la barra de búsqueda de Q. Puede utilizar esta URL en su sitio web o aplicación para mostrar la barra de búsqueda de Q. 

**Example**  

```
using System;
using Amazon.QuickSight;
using Amazon.QuickSight.Model;

namespace GenerateQSearchBarEmbedUrlForAnonymousUser
{
    class Program
    {
        static void Main(string[] args)
        {
            var quicksightClient = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                SessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                AnonymousUserQSearchBarEmbeddingConfiguration anonymousUserQSearchBarEmbeddingConfiguration
                    = new AnonymousUserQSearchBarEmbeddingConfiguration
                    {
                        InitialTopicId = "U4zJMVZ2n2stZflc8Ou3iKySEb3BEV6f"
                    };
                AnonymousUserEmbeddingExperienceConfiguration anonymousUserEmbeddingExperienceConfiguration
                    = new AnonymousUserEmbeddingExperienceConfiguration
                    {
                        QSearchBar = anonymousUserQSearchBarEmbeddingConfiguration
                    }; 
                
                Console.WriteLine(
                    quicksightClient.GenerateEmbedUrlForAnonymousUserAsync(new GenerateEmbedUrlForAnonymousUserRequest
                    {
                        AwsAccountId = "111122223333",
                        Namespace = "DEFAULT",
                        AuthorizedResourceArns '["topic-arn-topicId1","topic-arn-topicId2"]',
                        AllowedDomains = allowedDomains,
                        ExperienceConfiguration = anonymousUserEmbeddingExperienceConfiguration,
                        SessionTags = '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]',
                        SessionLifetimeInMinutes = 15,
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
        }
    }
}
```

### AWS CLI
<a name="embedded-q-bar-for-anonymous-users-cli"></a>

Para asumir la función, elija una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice SAML para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GenerateEmbedUrlForAnonymousUser` habilitados.

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_q_search_bar_role" \
     --role-session-name anonymous caller
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. En un ordenador con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_q_search_bar_role/QuickSightEmbeddingAnonymousPolicy`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. Además, mantiene cada sesión separada y distinta. Si utiliza una serie de servidores web, por ejemplo, para equilibrar la carga, y una sesión se vuelve a conectar a un servidor diferente, se inicia una nueva sesión.

Para obtener una URL firmada para el panel, llame a `generate-embed-url-for-anynymous-user` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo generar la URL de un panel integrado mediante una llamada desde el servidor para los usuarios que realizan visitas anónimas a su portal web o aplicación.

```
aws quicksight generate-embed-url-for-anonymous-user \
--aws-account-id 111122223333 \
--namespace default-or-something-else \
--authorized-resource-arns '["topic-arn-topicId1","topic-arn-topicId2"]' \
--allowed-domains '["domain1","domain2"]' \
--experience-configuration 'QSearchBar={InitialTopicId="topicId1"}' \
--session-tags '["Key": tag-key-1,"Value": tag-value-1,{"Key": tag-key-1,"Value": tag-value-1}]' \
--session-lifetime-in-minutes 15
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GenerateEmbedUrlForRegisteredUser.html). Puede utilizar esta y otras operaciones de la API en su propio código.

## Paso 3: integración de la URL de la barra de búsqueda de Q
<a name="embedded-q-bar-for-anonymous-users-step-3"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

En la siguiente sección, puede encontrar cómo integrar la URL de la barra de búsqueda Q del paso 3 en su sitio web o página de la aplicación. Esto se hace con el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript). Con el SDK, puede hacer lo siguiente: 
+ Colocar la barra de búsqueda de Q en una página HTML.
+ Pasar los parámetros a la barra de búsqueda de Q.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llame a la operación de la API `GenerateEmbedUrlForAnonymousUser` para generar la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida hasta 10 horas. La operación de la API proporciona la URL con un valor `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `generate-embed-url-for-anonymous-user`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https://quicksightdomain/embedding/12345/q/search...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Inserta la barra de búsqueda Q en tu página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. 

Para ello, asegúrate de que el dominio que alojará la barra de búsqueda Q integrada esté en la *lista de dominios permitidos*, la lista de dominios aprobados para tu suscripción a Amazon Quick Sight. Este requisito protege los datos impidiendo que dominios no aprobados alojen barras de búsqueda de Q integradas. Para obtener más información sobre cómo añadir dominios a una barra de búsqueda Q integrada, consulte [Gestión de dominios e incrustación.](https://docs.aws.amazon.com/quicksight/latest/user/manage-qs-domains-and-embedding.html)

Cuando utilizas el SDK de incrustación Quick Sight de Amazon, la barra de búsqueda Q de tu página cambia de tamaño de forma dinámica en función del estado. Al utilizar el SDK de incrustación Quick Sight de Amazon, también puedes controlar los parámetros de la barra de búsqueda Q y recibir llamadas en función de la finalización de la carga de la página y de los errores. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

### SDK 2.0
<a name="embedded-q-bar-for-anonymous-users-sdkv2"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>Q Search Bar Embedding Example</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@2.0.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            const embedQSearchBar = async() => {    
                const {
                    createEmbeddingContext,
                } = QuickSightEmbedding;

                const embeddingContext = await createEmbeddingContext({
                    onChange: (changeEvent, metadata) => {
                        console.log('Context received a change', changeEvent, metadata);
                    },
                });

                const frameOptions = {
                    url: "<YOUR_EMBED_URL>", // replace this value with the url generated via embedding API
                    container: '#experience-container',
                    height: "700px",
                    width: "1000px",
                    onChange: (changeEvent, metadata) => {
                        switch (changeEvent.eventName) {
                            case 'FRAME_MOUNTED': {
                                console.log("Do something when the experience frame is mounted.");
                                break;
                            }
                            case 'FRAME_LOADED': {
                                console.log("Do something when the experience frame is loaded.");
                                break;
                            }
                        }
                    },
                };

                const contentOptions = {
                    hideTopicName: false, 
                    theme: '<YOUR_THEME_ID>',
                    allowTopicSelection: true,
                    onMessage: async (messageEvent, experienceMetadata) => {
                        switch (messageEvent.eventName) {
                            case 'Q_SEARCH_OPENED': {
                                console.log("Do something when Q Search content expanded");
                                break;
                            }
                            case 'Q_SEARCH_CLOSED': {
                                console.log("Do something when Q Search content collapsed");
                                break;
                            }
                            case 'Q_SEARCH_SIZE_CHANGED': {
                                console.log("Do something when Q Search size changed");
                                break;
                            }
                            case 'CONTENT_LOADED': {
                                console.log("Do something when the Q Search is loaded.");
                                break;
                            }
                            case 'ERROR_OCCURRED': {
                                console.log("Do something when the Q Search fails loading.");
                                break;
                            }
                        }
                    }
                };
                const embeddedDashboardExperience = await embeddingContext.embedQSearchBar(frameOptions, contentOptions);
            };
        </script>
    </head>

    <body onload="embedQSearchBar()">
        <div id="experience-container"></div>
    </body>

</html>
```

### SDK 1.0
<a name="embedded-q-bar-for-anonymous-users-sdkv1"></a>

```
<!DOCTYPE html>
<html>

    <head>
        <title>QuickSight Q Search Bar Embedding</title>
        <script src="https://unpkg.com/amazon-quicksight-embedding-sdk@1.18.0/dist/quicksight-embedding-js-sdk.min.js"></script>
        <script type="text/javascript">
            var session

            function onError(payload) {
                console.log("Do something when the session fails loading");
            }

            function onOpen() {
                console.log("Do something when the Q search bar opens");
            }

            function onClose() {
                console.log("Do something when the Q search bar closes");
            }

            function embedQSearchBar() {
                var containerDiv = document.getElementById("embeddingContainer");
                var options = {
                    url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode", // replace this dummy url with the one generated via embedding API
                    container: containerDiv,
                    width: "1000px",
                    locale: "en-US",
                    qSearchBarOptions: {
                        expandCallback: onOpen,
                        collapseCallback: onClose,
                        iconDisabled: false,
                        topicNameDisabled: false, 
                        themeId: 'bdb844d0-0fe9-4d9d-b520-0fe602d93639',
                        allowTopicSelection: true
                    }
                };
                session = QuickSightEmbedding.embedQSearchBar(options);
                session.on("error", onError);
            }

            function onCountryChange(obj) {
                session.setParameters({country: obj.value});
            }
        </script>
    </head>

    <body onload="embedQSearchBar()">
        <div id="embeddingContainer"></div>
    </body>

</html>
```

Para que este ejemplo funcione, asegúrate de usar el SDK de incrustación de Amazon Quick Sight para cargar la barra de búsqueda Q incrustada en tu sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

## Funcionalidades opcionales de incrustación en la barra de búsqueda Quick Sight Q de Amazon
<a name="embedded-q-bar-for-anonymous-users-step-4"></a>

**nota**  
La barra de búsqueda integrada de Amazon Quick Sight Q ofrece la clásica experiencia de preguntas y respuestas de Amazon Quick Sight. Amazon Quick Sight se integra con Amazon Q Business para lanzar una nueva experiencia de preguntas y respuestas generativas. Se recomienda a los desarrolladores usar la nueva experiencia de preguntas y respuestas generativas. Para obtener más información sobre la experiencia de preguntas y respuestas generativas integrada, consulte Cómo [integrar Amazon Q en la experiencia de preguntas y respuestas generativas de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/user/embedding-gen-bi.html).

Las siguientes funcionalidades opcionales están disponibles para la barra de búsqueda de Q integrada mediante el SDK de integración. 

### Invocación de las acciones de la barra de búsqueda de Q
<a name="w2aac35c27c21c43c31c17c21b7"></a>

Las siguientes opciones solo son compatibles con la integración de la barra de búsqueda de Q. 
+ Establecer una pregunta en la barra de búsqueda de Q: esta característica envía una pregunta a la barra de búsqueda de Q e inmediatamente la consulta. También abre automáticamente la ventana emergente de Q.

  ```
  qBar.setQBarQuestion('show me monthly revenue');
  ```
+ Cerrar la ventana emergente de Q: esta característica cierra la ventana emergente de Q y devuelve el iframe al tamaño original de la barra de búsqueda de Q.

  ```
  qBar.closeQPopover();
  ```

Para obtener más información, consulte el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk).

# Integración de análisis mediante las operaciones de la API GetDashboardEmbedURL y GetSessionEmbedURL
<a name="embedded-analytics-deprecated"></a>


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

Las siguientes operaciones de API para incrustar los paneles de Amazon Quick Sight y la consola de Amazon Quick Sight se han sustituido por las operaciones de GenerateEmbedUrlForRegisteredUser API GenerateEmbedUrlForAnonymousUser y. Puede seguir utilizándolos para integrar los análisis en su aplicación, pero ya no se mantienen y no contienen las características o funcionalidades de integración más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html)
+ La operación [GetDashboardEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html)de la API incorpora paneles interactivos.
+ La operación [GetSessionEmbedUrl](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetSessionEmbedUrl.html)de la API incorpora la consola Amazon Quick Sight.

**Topics**
+ [Integración de paneles para todos los usuarios mediante GetDashboardEmbedURL (API antigua)](embedded-analytics-dashboards-with-anonymous-users-get.md)
+ [Integración de paneles para usuarios registrados mediante GetDashboardEmbedUrl (API antigua)](embedded-analytics-dashboards-for-authenticated-users-get.md)
+ [Incrustar la consola Amazon Quick Sight mediante GetSessionEmbedUrl (API antigua)](embedded-analytics-full-console-for-authenticated-users-get.md)

# Integración de paneles para todos los usuarios mediante GetDashboardEmbedURL (API antigua)
<a name="embedded-analytics-dashboards-with-anonymous-users-get"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, encontrará información detallada sobre cómo configurar los paneles de Amazon Quick Sight integrados para todos los usuarios (usuarios no autenticados) que utilicen una URL. GetDashboardEmbed

**Topics**
+ [Paso 1: configuración de permisos](embedded-analytics-dashboards-with-anonymous-users-get-step-1.md)
+ [Paso 2: obtención de la URL con el código de autenticación adjunto](embedded-analytics-dashboards-with-anonymous-users-get-step-2.md)
+ [Paso 3 integración de la URL del panel](embedded-analytics-dashboards-with-anonymous-users-get-step-3.md)

# Paso 1: configuración de permisos
<a name="embedded-analytics-dashboards-with-anonymous-users-get-step-1"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a un panel de control asume un rol que le da acceso a Amazon Quick Sight y permisos para acceder al panel. Para que esto sea posible, cree un rol de IAM en su AWS cuenta. Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma.

La siguiente política de ejemplo ofrece estos permisos para usar con `IdentityType=ANONYMOUS`. Para que este enfoque funcione, también necesita un paquete de sesiones, o un precio por capacidad de sesión, en su AWS cuenta. De lo contrario, cuando un usuario intenta acceder al panel de control, se devuelve el error `UnsupportedPricingPlanException`. 

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

****  

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

------

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que, cuando un usuario accede a su aplicación, esta puede asumir el rol en nombre del usuario para abrir el panel. En el siguiente ejemplo, se muestra un rol denominado `QuickSightEmbeddingAnonymousPolicy`, que cuenta con la política de ejemplo anterior como recurso. 

Para obtener más información sobre las políticas de confianza, consulte [Credenciales de seguridad temporales en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) en la *Guía del usuario de IAM*.

# Paso 2: obtención de la URL con el código de autenticación adjunto
<a name="embedded-analytics-dashboards-with-anonymous-users-get-step-2"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, puede obtener información sobre cómo autenticarse en nombre del visitante anónimo y obtener la URL del panel integrable en el servidor de su aplicación. 

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Transfiere un identificador como ID de sesión de rol único. Este código se ejecuta en el servidor de aplicaciones.

------
#### [ Java ]

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.GetDashboardEmbedUrlRequest;
import com.amazonaws.services.quicksight.model.GetDashboardEmbedUrlResult;

/**
 * Class to call QuickSight AWS SDK to get url for dashboard embedding.
 */
public class GetQuicksightEmbedUrlNoAuth {

    private static String ANONYMOUS = "ANONYMOUS";

    private final AmazonQuickSight quickSightClient;

    public GetQuicksightEmbedUrlNoAuth() {
        this.quickSightClient = AmazonQuickSightClientBuilder
                .standard()
                .withRegion(Regions.US_EAST_1.getName())
                .withCredentials(new AWSCredentialsProvider() {
                                     @Override
                                     public AWSCredentials getCredentials() {
                                         // provide actual IAM access key and secret key here
                                         return new BasicAWSCredentials("access-key", "secret-key");
                                     }

                                     @Override
                                     public void refresh() {}
                                 }
                )
                .build();
    }

    public String getQuicksightEmbedUrl(
            final String accountId, // YOUR AWS ACCOUNT ID
            final String dashboardId, // YOUR DASHBOARD ID TO EMBED
            final String addtionalDashboardIds, // ADDITIONAL DASHBOARD-1 ADDITIONAL DASHBOARD-2
            final boolean resetDisabled, // OPTIONAL PARAMETER TO ENABLE DISABLE RESET BUTTON IN EMBEDDED DASHBAORD
            final boolean undoRedoDisabled // OPTIONAL PARAMETER TO ENABLE DISABLE UNDO REDO BUTTONS IN EMBEDDED DASHBAORD
    ) throws Exception {
        GetDashboardEmbedUrlRequest getDashboardEmbedUrlRequest = new GetDashboardEmbedUrlRequest()
                .withDashboardId(dashboardId)
                .withAdditionalDashboardIds(addtionalDashboardIds)
                .withAwsAccountId(accountId)
                .withNamespace("default") // Anonymous embedding requires specifying a valid namespace for which you want the embedding url
                .withIdentityType(ANONYMOUS)
                .withResetDisabled(resetDisabled)
                .withUndoRedoDisabled(undoRedoDisabled);

        GetDashboardEmbedUrlResult dashboardEmbedUrl = quickSightClient.getDashboardEmbedUrl(getDashboardEmbedUrlRequest);

        return dashboardEmbedUrl.getEmbedUrl();
    }
}
```

------
#### [ JavaScript ]

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function getDashboardEmbedURL(
    accountId, // YOUR AWS ACCOUNT ID
    dashboardId, // YOUR DASHBOARD ID TO EMBED
    additionalDashboardIds, // ADDITIONAL DASHBOARD-1 ADDITIONAL DASHBOARD-2
    quicksightNamespace, // VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
    resetDisabled, // OPTIONAL PARAMETER TO ENABLE DISABLE RESET BUTTON IN EMBEDDED DASHBAORD
    undoRedoDisabled, // OPTIONAL PARAMETER TO ENABLE DISABLE UNDO REDO BUTTONS IN EMBEDDED DASHBAORD
    getEmbedUrlCallback, // GETEMBEDURL SUCCESS CALLBACK METHOD
    errorCallback // GETEMBEDURL ERROR CALLBACK METHOD
    ) {
    const getDashboardParams = {
        AwsAccountId: accountId,
        DashboardId: dashboardId,
        AdditionalDashboardIds: additionalDashboardIds,
        Namespace: quicksightNamespace,
        IdentityType: 'ANONYMOUS',
        ResetDisabled: resetDisabled,
        SessionLifetimeInMinutes: 600,
        UndoRedoDisabled: undoRedoDisabled
    };

    const quicksightGetDashboard = new AWS.QuickSight({
        region: process.env.AWS_REGION,
    });

    quicksightGetDashboard.getDashboardEmbedUrl(getDashboardParams, function(err, data) {
        if (err) {
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const result = {
                "statusCode": 200,
                "headers": {
                    "Access-Control-Allow-Origin": "*", // USE YOUR WEBSITE DOMAIN TO SECURE ACCESS TO GETEMBEDURL API
                    "Access-Control-Allow-Headers": "Content-Type"
                },
                "body": JSON.stringify(data),
                "isBase64Encoded": false
            }
            getEmbedUrlCallback(result);
        }
    });
}
```

------
#### [ Python3 ]

```
import json
import boto3
from botocore.exceptions import ClientError
import time

# Create QuickSight and STS clients
qs = boto3.client('quicksight',region_name='us-east-1')
sts = boto3.client('sts')

# Function to generate embedded URL
# accountId: YOUR AWS ACCOUNT ID
# dashboardId: YOUR DASHBOARD ID TO EMBED
# additionalDashboardIds: ADDITIONAL DASHBOARD-1 ADDITIONAL DASHBOARD-2 WITHOUT COMMAS
# quicksightNamespace: VALID NAMESPACE WHERE YOU WANT TO DO NOAUTH EMBEDDING
# resetDisabled: PARAMETER TO ENABLE DISABLE RESET BUTTON IN EMBEDDED DASHBAORD
# undoRedoDisabled: OPTIONAL PARAMETER TO ENABLE DISABLE UNDO REDO BUTTONS IN EMBEDDED DASHBAORD
def getDashboardURL(accountId, dashboardId, quicksightNamespace, resetDisabled, undoRedoDisabled):
    try:
        response = qs.get_dashboard_embed_url(
            AwsAccountId = accountId,
            DashboardId = dashboardId,
            AdditionalDashboardIds = additionalDashboardIds,
            Namespace = quicksightNamespace,
            IdentityType = 'ANONYMOUS',
            SessionLifetimeInMinutes = 600,
            UndoRedoDisabled = undoRedoDisabled,
            ResetDisabled = resetDisabled
        )
            
        return {
            'statusCode': 200,
            'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
            'body': json.dumps(response),
            'isBase64Encoded':  bool('false')
        }
    except ClientError as e:
        print(e)
        return "Error generating embeddedURL: " + str(e)
```

------
#### [ Node.js ]

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para obtener la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
            const https = require('https');
            
            var quicksight = new AWS.Service({
                apiConfig: require('./quicksight-2018-04-01.min.json'),
                region: 'us-east-1',
            });
            
            quicksight.getDashboardEmbedUrl({
                'AwsAccountId': '111122223333',
                'DashboardId': 'dashboard-id',
                'AdditionalDashboardIds': 'added-dashboard-id-1 added-dashboard-id-2 added-dashboard-id-3'
                'Namespace' : 'default',
                'IdentityType': 'ANONYMOUS',
                'SessionLifetimeInMinutes': 100,
                'UndoRedoDisabled': false,
                'ResetDisabled': true
            
            }, function(err, data) {
                console.log('Errors: ');
                console.log(err);
                console.log('Response: ');
                console.log(data);
            });
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
            //readability and added ellipsis to indicate that it's incomplete.
                                { Status: 200,
              EmbedUrl: 'https://dashboards.example.com/embed/620bef10822743fab329fb3751187d2d…
              RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' }
```

------
#### [ .NET/C\$1 ]

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para obtener la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
            var client = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                sessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                Console.WriteLine(
                    client.GetDashboardEmbedUrlAsync(new GetDashboardEmbedUrlRequest
                    {
                        AwsAccountId = “111122223333”,
                        DashboardId = "dashboard-id",
                        AdditionalDashboardIds = "added-dashboard-id-1 added-dashboard-id-2 added-dashboard-id-3",
                        Namespace = default,
                        IdentityType = IdentityType.ANONYMOUS,
                        SessionLifetimeInMinutes = 600,
                        UndoRedoDisabled = false,
                        ResetDisabled = true
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
```

------
#### [ AWS CLI ]

Para asumir la función, elige una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice el lenguaje de marcado de aserciones de seguridad (SAML) para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GetDashboardEmbedURL` habilitados. 

```
aws sts assume-role \
     --role-arn "arn:aws:iam::11112222333:role/QuickSightEmbeddingAnonymousPolicy" \
     --role-session-name anonymous caller
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_dashboard_role/QuickSightEmbeddingAnonymousPolicy`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario visitante. También mantiene cada sesión separada y distinta. Si utiliza una serie de servidores web, por ejemplo, para equilibrar la carga, y una sesión se vuelve a conectar a un servidor diferente, se inicia una nueva sesión.

Para obtener una URL firmada para el panel, llame a `get-dashboard-embed-url` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo obtener la URL de un panel integrado mediante una llamada desde el servidor para los usuarios que realizan visitas anónimas a su portal web o aplicación.

```
aws quicksight get-dashboard-embed-url \
     --aws-account-id 111122223333 \
     --dashboard-id dashboard-id \
     --additional-dashboard-ids added-dashboard-id-1 added-dashboard-id-2 added-dashboard-id-3
     --namespace default-or-something-else \
     --identity-type ANONYMOUS \
     --session-lifetime-in-minutes 30 \
     --undo-redo-disabled true \
     --reset-disabled true \
     --user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/QuickSightEmbeddingAnonymousPolicy/embeddingsession
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html). Puede utilizar esta y otras operaciones de la API en su propio código. 

------

# Paso 3 integración de la URL del panel
<a name="embedded-analytics-dashboards-with-anonymous-users-get-step-3"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En la siguiente sección, encontrará información sobre cómo puede utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL del panel de control del paso 2 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque el panel en una página HTML.
+ Transferir los parámetros al panel.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GetDashboardEmbedUrl` para obtener la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida durante 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `get-dashboard-embed-url`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https: //dashboards.example.com/embed/620bef10822743fab329fb3751187d2d...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Inserte este panel en su página web mediante el [SDK de incrustación](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) de Amazon Quick Sight o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Con el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros del panel de control y recibir llamadas en términos de errores o de finalización de la carga de la página. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código reside en el servidor de aplicaciones.

```
<!DOCTYPE html>
<html>

<head>
    <title>Basic Embed</title>
    <!-- You can download the latest QuickSight embedding SDK version from https://www.npmjs.com/package/amazon-quicksight-embedding-sdk -->
    <!-- Or you can do "npm install amazon-quicksight-embedding-sdk", if you use npm for javascript dependencies -->
    <script src="./quicksight-embedding-js-sdk.min.js"></script>
    <script type="text/javascript">
        var dashboard;

        function embedDashboard() {
            var containerDiv = document.getElementById("embeddingContainer");
            var options = {
                // replace this dummy url with the one generated via embedding API
                url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode",  
                container: containerDiv,
                scrolling: "no",
                height: "700px",
                width: "1000px",
                footerPaddingEnabled: true
            };
            dashboard = QuickSightEmbedding.embedDashboard(options);
        }
    </script>
</head>

<body onload="embedDashboard()">
    <div id="embeddingContainer"></div>
</body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el panel integrado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK QuickSight de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Integración de paneles para usuarios registrados mediante GetDashboardEmbedUrl (API antigua)
<a name="embedded-analytics-dashboards-for-authenticated-users-get"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En las siguientes secciones, encontrará información detallada sobre cómo configurar los paneles de Amazon Quick Sight integrados para los usuarios registrados que los utilizan`GetDashboardEmbedUrl`.

**Topics**
+ [Paso 1: configuración de permisos](embedded-dashboards-for-authenticated-users-get-step-1.md)
+ [Paso 2: obtención de la URL con el código de autenticación adjunto](embedded-dashboards-for-authenticated-users-get-step-2.md)
+ [Paso 3 integración de la URL del panel](embedded-dashboards-for-authenticated-users-get-step-3.md)

# Paso 1: configuración de permisos
<a name="embedded-dashboards-for-authenticated-users-get-step-1"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a un panel de control asume un rol que le da acceso a Amazon Quick Sight y permisos para acceder al panel. Para que esto sea posible, cree un rol de IAM en su AWS cuenta. Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. El rol de IAM debe proporcionar permisos para recuperar el panel. URLs Para ello, añada `quicksight:GetDashboardEmbedUrl`.

La siguiente política de ejemplo ofrece estos permisos para usar con `IdentityType=IAM`. 

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

****  

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

------

El siguiente ejemplo de política proporciona permiso para recuperar la URL de un panel. Utiliza la política con `quicksight:RegisterUser` si va a crear usuarios nuevos que vayan a ser lectores de Amazon Quick Sight. 

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

****  

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

------

Si utiliza `QUICKSIGHT` como su `identityType`, y proporciona el Nombre de recurso de Amazon (ARN) del usuario, también debe permitir la acción `quicksight:GetAuthCode` en su política. La siguiente política de ejemplo proporciona este permiso.

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

****  

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

------

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. En el siguiente ejemplo, se muestra un rol denominado `embedding_quicksight_dashboard_role`, que cuenta con la política de ejemplo anterior como recurso. 

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o SAML, consulte las siguientes secciones de la *Guía del usuario de IAM: *
+ [Creación de un rol para identidades web o de OpenID Connect Federation (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

# Paso 2: obtención de la URL con el código de autenticación adjunto
<a name="embedded-dashboards-for-authenticated-users-get-step-2"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En la siguiente sección, puede obtener información sobre cómo autenticar el usuario y obtener la URL del panel integrable en el servidor de su aplicación. 

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar los pasos descritos, se garantiza que cada visor del panel se aprovisione de forma exclusiva en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Este código se ejecuta en el servidor de aplicaciones.

------
#### [ Java ]

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.AWSStaticCredentialsProvider;
import com.amazonaws.auth.BasicSessionCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.GetDashboardEmbedUrlRequest;
import com.amazonaws.services.quicksight.model.GetDashboardEmbedUrlResult;
import com.amazonaws.services.securitytoken.AWSSecurityTokenService;
import com.amazonaws.services.securitytoken.model.AssumeRoleRequest;
import com.amazonaws.services.securitytoken.model.AssumeRoleResult;

/**
 * Class to call QuickSight AWS SDK to get url for dashboard embedding.
 */
public class GetQuicksightEmbedUrlIAMAuth {

    private static String IAM = "IAM";

    private final AmazonQuickSight quickSightClient;

    private final AWSSecurityTokenService awsSecurityTokenService;

    public GetQuicksightEmbedUrlIAMAuth(final AWSSecurityTokenService awsSecurityTokenService) {
        this.quickSightClient = AmazonQuickSightClientBuilder
                .standard()
                .withRegion(Regions.US_EAST_1.getName())
                .withCredentials(new AWSCredentialsProvider() {
                                     @Override
                                     public AWSCredentials getCredentials() {
                                         // provide actual IAM access key and secret key here
                                         return new BasicAWSCredentials("access-key", "secret-key");
                                     }

                                     @Override
                                     public void refresh() {}
                                 }
                )
                .build();
        this.awsSecurityTokenService = awsSecurityTokenService;
    }

    public String getQuicksightEmbedUrl(
            final String accountId, // YOUR AWS ACCOUNT ID
            final String dashboardId, // YOUR DASHBOARD ID TO EMBED
            final String openIdToken, // TOKEN TO ASSUME ROLE WITH ROLEARN
            final String roleArn, // IAM USER ROLE TO USE FOR EMBEDDING
            final String sessionName, // SESSION NAME FOR THE ROLEARN ASSUME ROLE
            final boolean resetDisabled, // OPTIONAL PARAMETER TO ENABLE DISABLE RESET BUTTON IN EMBEDDED DASHBAORD
            final boolean undoRedoDisabled // OPTIONAL PARAMETER TO ENABLE DISABLE UNDO REDO BUTTONS IN EMBEDDED DASHBAORD
    ) throws Exception {
        AssumeRoleRequest request = new AssumeRoleRequest()
                .withRoleArn(roleArn)
                .withRoleSessionName(sessionName)
                .withTokenCode(openIdToken)
                .withDurationSeconds(3600);
        AssumeRoleResult assumeRoleResult = awsSecurityTokenService.assumeRole(request);

        AWSCredentials temporaryCredentials = new BasicSessionCredentials(
                assumeRoleResult.getCredentials().getAccessKeyId(),
                assumeRoleResult.getCredentials().getSecretAccessKey(),
                assumeRoleResult.getCredentials().getSessionToken());
        AWSStaticCredentialsProvider awsStaticCredentialsProvider = new AWSStaticCredentialsProvider(temporaryCredentials);

        GetDashboardEmbedUrlRequest getDashboardEmbedUrlRequest = new GetDashboardEmbedUrlRequest()
                .withDashboardId(dashboardId)
                .withAwsAccountId(accountId)
                .withIdentityType(IAM)
                .withResetDisabled(resetDisabled)
                .withUndoRedoDisabled(undoRedoDisabled)
                .withRequestCredentialsProvider(awsStaticCredentialsProvider);

        GetDashboardEmbedUrlResult dashboardEmbedUrl = quickSightClient.getDashboardEmbedUrl(getDashboardEmbedUrlRequest);

        return dashboardEmbedUrl.getEmbedUrl();
    }
}
```

------
#### [ JavaScript ]

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function getDashboardEmbedURL(
    accountId, // YOUR AWS ACCOUNT ID
    dashboardId, // YOUR DASHBOARD ID TO EMBED
    openIdToken, // TOKEN TO ASSUME ROLE WITH ROLEARN
    roleArn, // IAM USER ROLE TO USE FOR EMBEDDING
    sessionName, // SESSION NAME FOR THE ROLEARN ASSUME ROLE
    resetDisabled, // OPTIONAL PARAMETER TO ENABLE DISABLE RESET BUTTON IN EMBEDDED DASHBAORD
    undoRedoDisabled, // OPTIONAL PARAMETER TO ENABLE DISABLE UNDO REDO BUTTONS IN EMBEDDED DASHBAORD
    getEmbedUrlCallback, // GETEMBEDURL SUCCESS CALLBACK METHOD
    errorCallback // GETEMBEDURL ERROR CALLBACK METHOD
    ) {
    const stsClient = new AWS.STS();
    let stsParams = {
        RoleSessionName: sessionName,
        WebIdentityToken: openIdToken,
        RoleArn: roleArn
    }

    stsClient.assumeRoleWithWebIdentity(stsParams, function(err, data) {
        if (err) {
            console.log('Error assuming role');
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const getDashboardParams = {
                AwsAccountId: accountId,
                DashboardId: dashboardId,
                IdentityType: 'IAM',
                ResetDisabled: resetDisabled,
                SessionLifetimeInMinutes: 600,
                UndoRedoDisabled: undoRedoDisabled
            };

            const quicksightGetDashboard = new AWS.QuickSight({
                region: process.env.AWS_REGION,
                credentials: {
                    accessKeyId: data.Credentials.AccessKeyId,
                    secretAccessKey: data.Credentials.SecretAccessKey,
                    sessionToken: data.Credentials.SessionToken,
                    expiration: data.Credentials.Expiration
                }
            });

            quicksightGetDashboard.getDashboardEmbedUrl(getDashboardParams, function(err, data) {
                if (err) {
                    console.log(err, err.stack);
                    errorCallback(err);
                } else {
                    const result = {
                        "statusCode": 200,
                        "headers": {
                            "Access-Control-Allow-Origin": "*", // USE YOUR WEBSITE DOMAIN TO SECURE ACCESS TO GETEMBEDURL API
                            "Access-Control-Allow-Headers": "Content-Type"
                        },
                        "body": JSON.stringify(data),
                        "isBase64Encoded": false
                    }
                    getEmbedUrlCallback(result);
                }
            });
        }
    });
}
```

------
#### [ Python3 ]

```
import json
import boto3
from botocore.exceptions import ClientError

# Create QuickSight and STS clients
qs = boto3.client('quicksight',region_name='us-east-1')
sts = boto3.client('sts')

# Function to generate embedded URL  
# accountId: YOUR AWS ACCOUNT ID
# dashboardId: YOUR DASHBOARD ID TO EMBED
# openIdToken: TOKEN TO ASSUME ROLE WITH ROLEARN
# roleArn: IAM USER ROLE TO USE FOR EMBEDDING
# sessionName: SESSION NAME FOR THE ROLEARN ASSUME ROLE
# resetDisabled: PARAMETER TO ENABLE DISABLE RESET BUTTON IN EMBEDDED DASHBAORD
# undoRedoDisabled: PARAMETER TO ENABLE DISABLE UNDO REDO BUTTONS IN EMBEDDED DASHBAORD
def getDashboardURL(accountId, dashboardId, openIdToken, roleArn, sessionName, resetDisabled, undoRedoDisabled):
    try:
        assumedRole = sts.assume_role(
            RoleArn = roleArn,
            RoleSessionName = sessionName,
            WebIdentityToken = openIdToken
        )
    except ClientError as e:
        return "Error assuming role: " + str(e)
    else: 
        assumedRoleSession = boto3.Session(
            aws_access_key_id = assumedRole['Credentials']['AccessKeyId'],
            aws_secret_access_key = assumedRole['Credentials']['SecretAccessKey'],
            aws_session_token = assumedRole['Credentials']['SessionToken'],
        )
        try:
            quickSight = assumedRoleSession.client('quicksight',region_name='us-east-1')
            
            response = quickSight.get_dashboard_embed_url(
                 AwsAccountId = accountId,
                 DashboardId = dashboardId,
                 IdentityType = 'IAM',
                 SessionLifetimeInMinutes = 600,
                 UndoRedoDisabled = undoRedoDisabled,
                 ResetDisabled = resetDisabled
            )
            
            return {
                'statusCode': 200,
                'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
                'body': json.dumps(response),
                'isBase64Encoded':  bool('false')
            }
        except ClientError as e:
            return "Error generating embeddedURL: " + str(e)
```

------
#### [ Node.js ]

El siguiente ejemplo muestra el archivo JavaScript (Node.js) que puede usar en el servidor de aplicaciones para obtener la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
const AWS = require('aws-sdk');
            const https = require('https');
            
            var quicksight = new AWS.Service({
                apiConfig: require('./quicksight-2018-04-01.min.json'),
                region: 'us-east-1',
            });
            
            quicksight.getDashboardEmbedUrl({
                'AwsAccountId': '111122223333',
                'DashboardId': '1c1fe111-e2d2-3b30-44ef-a0e111111cde',
                'IdentityType': 'IAM',
                'ResetDisabled': true,
                'SessionLifetimeInMinutes': 100,
                'UndoRedoDisabled': false,
                'StatePersistenceEnabled': true
            
            }, function(err, data) {
                console.log('Errors: ');
                console.log(err);
                console.log('Response: ');
                console.log(data);
            });
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
            //readability and added ellipsis to indicate that it's incomplete.
                                { Status: 200,
              EmbedUrl: 'https://dashboards.example.com/embed/620bef10822743fab329fb3751187d2d…
              RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' }
```

------
#### [ .NET/C\$1 ]

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para obtener la URL del panel integrado. Puede utilizar esta URL en su sitio web o aplicación para mostrar el panel. 

**Example**  

```
            var client = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                sessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                Console.WriteLine(
                    client.GetDashboardEmbedUrlAsync(new GetDashboardEmbedUrlRequest
                    {
                        AwsAccountId = “111122223333”,
                        DashboardId = "1c1fe111-e2d2-3b30-44ef-a0e111111cde",
                        IdentityType = EmbeddingIdentityType.IAM,
                        ResetDisabled = true,
                        SessionLifetimeInMinutes = 100,
                        UndoRedoDisabled = false,
                        StatePersistenceEnabled = true
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
```

------
#### [ AWS CLI ]

Para asumir la función, elige una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice SAML para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GetDashboardEmbedURL` habilitados. Si opta por añadir usuarios just-in-time la primera vez que abren un panel de control, el rol también necesita tener habilitados los permisos. `quicksight:RegisterUser`

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
     --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_dashboard_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. *La limitación* es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan al panel de control. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
     --aws-account-id 111122223333 \
     --namespace default \
     --identity-type IAM \
     --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
     --user-role READER \
     --user-name jhnd \
     --session-name "john.doe@example.com" \
     --email john.doe@example.com \
     --region us-east-1 \
     --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el ARN del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puedes añadir este usuario al grupo con el que se comparte el panel. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
     --aws-account-id=111122223333 \
     --namespace=default \
     --group-name=financeusers \
     --member-name="embedding_quicksight_dashboard_role/john.doe@example.com"
```

Ahora tienes un usuario de tu aplicación que también es usuario de Amazon Quick Sight y que tiene acceso al panel de control. 

Por último, para obtener una URL firmada para el panel, llame a `get-dashboard-embed-url` desde el servidor de aplicaciones. Esta operación devuelve la URL del panel integrable. En el siguiente ejemplo, se muestra cómo obtener la URL de un panel integrado mediante una llamada desde el servidor para los usuarios autenticados a través del IAM AWS Managed Microsoft AD Identity Center.

```
aws quicksight get-dashboard-embed-url \
     --aws-account-id 111122223333 \
     --dashboard-id 1a1ac2b2-3fc3-4b44-5e5d-c6db6778df89 \
     --identity-type IAM \
     --session-lifetime-in-minutes 30 \
     --undo-redo-disabled true \
     --reset-disabled true \
     --state-persistence-enabled true \
     --user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/embedding_quicksight_dashboard_role/embeddingsession
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetDashboardEmbedUrl.html). Puede utilizar esta y otras operaciones de la API en su propio código. 

------

# Paso 3 integración de la URL del panel
<a name="embedded-dashboards-for-authenticated-users-get-step-3"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En la siguiente sección, encontrará información sobre cómo puede utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL del panel de control del paso 3 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque el panel en una página HTML.
+ Transferir los parámetros al panel.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GetDashboardEmbedUrl` para obtener la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida durante 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `get-dashboard-embed-url`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https: //dashboards.example.com/embed/620bef10822743fab329fb3751187d2d...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Inserta este panel en tu página web mediante el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Con el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros del panel de control y recibir llamadas en términos de errores o de finalización de la carga de la página. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

```
<!DOCTYPE html>
<html>

<head>
    <title>Basic Embed</title>

    <script src="./quicksight-embedding-js-sdk.min.js"></script>
    <script type="text/javascript">
        var dashboard;

        function embedDashboard() {
            var containerDiv = document.getElementById("embeddingContainer");
            var options = {
                // replace this dummy url with the one generated via embedding API
                url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode",  
                container: containerDiv,
                scrolling: "no",
                height: "700px",
                width: "1000px",
                footerPaddingEnabled: true
            };
            dashboard = QuickSightEmbedding.embedDashboard(options);
        }
    </script>
</head>

<body onload="embedDashboard()">
    <div id="embeddingContainer"></div>
</body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar el panel integrado en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```

# Incrustar la consola Amazon Quick Sight mediante GetSessionEmbedUrl (API antigua)
<a name="embedded-analytics-full-console-for-authenticated-users-get"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).


|  | 
| --- |
|  Se aplica a: Enterprise Edition  | 


|  | 
| --- |
|    Público objetivo: desarrolladores de Amazon Quick  | 

En las siguientes secciones, encontrará información detallada sobre cómo ofrecer la experiencia de la consola Amazon Quick Sight en un portal de creación con una marca personalizada para los usuarios registrados que utilizan la API. `GetSessionEmbedUrl` 

**Topics**
+ [Paso 1: configuración de permisos](embedded-analytics-full-console-for-authenticated-users-get-step-1.md)
+ [Paso 2: obtención de la URL con el código de autenticación adjunto](embedded-analytics-full-console-for-authenticated-users-get-step-2.md)
+ [Paso 3: integración de la URL de la sesión de consola](embedded-analytics-full-console-for-authenticated-users-get-step-3.md)

# Paso 1: configuración de permisos
<a name="embedded-analytics-full-console-for-authenticated-users-get-step-1"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En la siguiente sección, puede encontrar cómo configurar los permisos de la aplicación de backend o del servidor web. Esta tarea requiere acceso administrativo a IAM.

Cada usuario que accede a Amazon Quick Sight asume un rol que le otorga acceso a Amazon Quick Sight y permisos para acceder a la sesión de consola. Para que esto sea posible, cree un rol de IAM en su AWS cuenta. Asocie una política de IAM al rol para proporcionar permisos a cualquier usuario que lo asuma. Añada `quicksight:RegisterUser` permisos para garantizar que el lector pueda acceder a Amazon Quick Sight en modo de solo lectura y no tenga acceso a ningún otro dato o función de creación. La función de IAM también debe proporcionar permisos para recuperar la sesión de la consola. URLs Para ello, añada `quicksight:GetSessionEmbedUrl`.

La siguiente política de ejemplo ofrece estos permisos para usar con `IdentityType=IAM`. 

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

****  

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

------

El siguiente ejemplo de política proporciona permiso para recuperar la URL de una sesión de consola. Utilice la política sin `quicksight:RegisterUser` si va a crear usuarios antes de que accedan a una sesión integrada.

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

****  

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

------

Si utiliza `QUICKSIGHT` como su `identityType`, y proporciona el Nombre de recurso de Amazon (ARN) del usuario, también debe permitir la acción `quicksight:GetAuthCode` en su política. La siguiente política de ejemplo proporciona este permiso.

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

****  

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

------

La identidad de IAM de su aplicación debe tener asociada una política de confianza para permitir el acceso al rol que acaba de crear. Esto significa que cuando un usuario accede a su aplicación, esta puede asumir la función en nombre del usuario y aprovisionar al usuario en Amazon Quick Sight. En el siguiente ejemplo, se muestra un rol denominado `embedding_quicksight_console_session_role`, que cuenta con la política de ejemplo anterior como recurso. 

Para obtener más información sobre las políticas de confianza para la autenticación de OpenID Connect o SAML, consulte las siguientes secciones de la *Guía del usuario de IAM: *
+ [Creación de un rol para identidades web o de OpenID Connect Federation (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_oidc.html)
+ [Creación de un rol para una federación SAML 2.0 (consola)](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-idp_saml.html)

# Paso 2: obtención de la URL con el código de autenticación adjunto
<a name="embedded-analytics-full-console-for-authenticated-users-get-step-2"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En la siguiente sección, puede obtener información sobre cómo autenticar el usuario y obtener la URL del la sesión de consola integrable en el servidor de su aplicación. 

Cuando un usuario accede a su aplicación, esta asume el rol de IAM en nombre del usuario. A continuación, añade el usuario a Amazon Quick Sight, si ese usuario aún no existe. A continuación, transfiere un identificador como ID de sesión de rol único. 

Al realizar los pasos descritos, se garantiza que cada espectador de la sesión de consola se aprovisione de forma exclusiva en Amazon Quick Sight. También aplica la configuración por usuario, como la seguridad de nivel de fila y los valores predeterminados dinámicos de los parámetros.

Los siguientes ejemplos realizan la autenticación de IAM en nombre del usuario. Este código se ejecuta en el servidor de aplicaciones.

------
#### [ Java ]

```
import com.amazonaws.auth.AWSCredentials;
import com.amazonaws.auth.BasicAWSCredentials;
import com.amazonaws.auth.AWSCredentialsProvider;
import com.amazonaws.regions.Regions;
import com.amazonaws.services.quicksight.AmazonQuickSight;
import com.amazonaws.services.quicksight.AmazonQuickSightClientBuilder;
import com.amazonaws.services.quicksight.model.GetSessionEmbedUrlRequest;
import com.amazonaws.services.quicksight.model.GetSessionEmbedUrlResult;

/**
 * Class to call QuickSight AWS SDK to get url for session embedding.
 */
public class GetSessionEmbedUrlQSAuth {

    private final AmazonQuickSight quickSightClient;

    public GetSessionEmbedUrlQSAuth() {
        this.quickSightClient = AmazonQuickSightClientBuilder
                .standard()
                .withRegion(Regions.US_EAST_1.getName())
                .withCredentials(new AWSCredentialsProvider() {
                                     @Override
                                     public AWSCredentials getCredentials() {
                                         // provide actual IAM access key and secret key here
                                         return new BasicAWSCredentials("access-key", "secret-key");
                                     }

                                     @Override
                                     public void refresh() {}
                                 }
                )
                .build();
    }

    public String getQuicksightEmbedUrl(
            final String accountId, // YOUR AWS ACCOUNT ID
            final String userArn // REGISTERED USER ARN TO USE FOR EMBEDDING. REFER TO GETEMBEDURL SECTION IN DEV PORTAL TO FIND OUT HOW TO GET USER ARN FOR A QUICKSIGHT USER
    ) throws Exception {
        GetSessionEmbedUrlRequest getSessionEmbedUrlRequest = new GetSessionEmbedUrlRequest()
                .withAwsAccountId(accountId)
                .withEntryPoint("/start")
                .withUserArn(userArn);

        GetSessionEmbedUrlResult sessionEmbedUrl = quickSightClient.getSessionEmbedUrl(getSessionEmbedUrlRequest);

        return sessionEmbedUrl.getEmbedUrl();
    }
}
```

------
#### [ JavaScript ]

```
global.fetch = require('node-fetch');
const AWS = require('aws-sdk');

function getSessionEmbedURL(
    accountId, // YOUR AWS ACCOUNT ID
    userArn, // REGISTERED USER ARN TO USE FOR EMBEDDING. REFER TO GETEMBEDURL SECTION IN DEV PORTAL TO FIND OUT HOW TO GET USER ARN FOR A QUICKSIGHT USER
    getEmbedUrlCallback, // GETEMBEDURL SUCCESS CALLBACK METHOD
    errorCallback // GETEMBEDURL ERROR CALLBACK METHOD
    ) {
    const getSessionParams = {
        AwsAccountId: accountId,
        EntryPoint: "/start",
        UserArn: userArn,
        SessionLifetimeInMinutes: 600,
    };

    const quicksightGetSession = new AWS.QuickSight({
        region: process.env.AWS_REGION,
    });

    quicksightGetSession.getSessionEmbedUrl(getSessionParams, function(err, data) {
        if (err) {
            console.log(err, err.stack);
            errorCallback(err);
        } else {
            const result = {
                "statusCode": 200,
                "headers": {
                    "Access-Control-Allow-Origin": "*", // USE YOUR WEBSITE DOMAIN TO SECURE ACCESS TO GETEMBEDURL API
                    "Access-Control-Allow-Headers": "Content-Type"
                },
                "body": JSON.stringify(data),
                "isBase64Encoded": false
            }
            getEmbedUrlCallback(result);
        }
    });
}
```

------
#### [ Python3 ]

```
import json
import boto3
from botocore.exceptions import ClientError
import time

# Create QuickSight and STS clients
qs = boto3.client('quicksight',region_name='us-east-1')
sts = boto3.client('sts')

# Function to generate embedded URL
# accountId: YOUR AWS ACCOUNT ID
# userArn: REGISTERED USER ARN TO USE FOR EMBEDDING. REFER TO GETEMBEDURL SECTION IN DEV PORTAL TO FIND OUT HOW TO GET USER ARN FOR A QUICKSIGHT USER
def getSessionEmbedURL(accountId, userArn):
    try:
        response = qs.get_session_embed_url(
            AwsAccountId = accountId,
            EntryPoint = "/start",
            UserArn = userArn,
            SessionLifetimeInMinutes = 600
        )
            
        return {
            'statusCode': 200,
            'headers': {"Access-Control-Allow-Origin": "*", "Access-Control-Allow-Headers": "Content-Type"},
            'body': json.dumps(response),
            'isBase64Encoded':  bool('false')
        }
    except ClientError as e:
        print(e)
        return "Error generating embeddedURL: " + str(e)
```

------
#### [ Node.js ]

En el siguiente ejemplo, se muestra el archivo JavaScript (Node.js) que puede utilizar en el servidor de aplicaciones para obtener la URL de la sesión de consola integrada. Puede utilizar esta URL en su sitio web o aplicación para mostrar la sesión de consola. 

**Example**  

```
const AWS = require('aws-sdk');
            const https = require('https');
            
            var quicksight = new AWS.Service({
                apiConfig: require('./quicksight-2018-04-01.min.json'),
                region: 'us-east-1',
            });
            
            quicksight.GetSessionEmbedUrl({
                'AwsAccountId': '111122223333',
                'EntryPoint': 'https://url-for-console-page-to-open',
                'SessionLifetimeInMinutes': 600,
                'UserArn': 'USER_ARN'
            
            }, function(err, data) {
                console.log('Errors: ');
                console.log(err);
                console.log('Response: ');
                console.log(data);
            });
```

**Example**  

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
            //readability and added ellipsis to indicate that it's incomplete.
                                { Status: 200,
              EmbedUrl: 'https://dashboards.example.com/embed/620bef10822743fab329fb3751187d2d…
              RequestId: '7bee030e-f191-45c4-97fe-d9faf0e03713' }
```

------
#### [ .NET/C\$1 ]

En el siguiente ejemplo, se muestra el código .NET/C\$1 que puede usar en el servidor de aplicaciones para obtener la URL de la sesión de consola. Puede utilizar esta URL en su sitio web o aplicación para mostrar la consola. 

**Example**  

```
            var client = new AmazonQuickSightClient(
                AccessKey,
                SecretAccessKey,
                sessionToken,
                Amazon.RegionEndpoint.USEast1);
            try
            {
                Console.WriteLine(
                    client.GetSessionEmbedUrlAsync(new GetSessionEmbedUrlRequest
                    {
                'AwsAccountId': '111122223333',
                'EntryPoint': 'https://url-for-console-page-to-open',
                'SessionLifetimeInMinutes': 600,
                'UserArn': 'USER_ARN'
                        AwsAccountId = 111122223333,
                        EntryPoint = https://url-for-console-page-to-open,
                        SessionLifetimeInMinutes = 600,
                        UserArn = 'USER_ARN'
                    }).Result.EmbedUrl
                );
            } catch (Exception ex) {
                Console.WriteLine(ex.Message);
            }
```

------
#### [ AWS CLI ]

Para asumir la función, elige una de las siguientes AWS Security Token Service (AWS STS) operaciones de API:
+ [AssumeRole](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRole.html)— Utilice esta operación cuando utilice una identidad de IAM para asumir la función.
+ [AssumeRoleWithWebIdentity](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithWebIdentity.html)— Utilice esta operación cuando utilice un proveedor de identidad web para autenticar al usuario. 
+ [AssumeRoleWithSaml](https://docs.aws.amazon.com/STS/latest/APIReference/API_AssumeRoleWithSAML.html)— Utilice esta operación cuando utilice SAML para autenticar a sus usuarios.

En el siguiente ejemplo, se muestra el comando de la CLI para definir el rol de IAM. El rol debe tener los permisos de `quicksight:GetSessionEmbedUrl` habilitados. Si opta por añadir just-in-time usuarios cuando abren Amazon Quick Sight por primera vez, el rol también necesita tener habilitados los permisos`quicksight:RegisterUser`.

```
aws sts assume-role \
     --role-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
     --role-session-name john.doe@example.com
```

La operación `assume-role` devuelve tres parámetros de salida: la clave de acceso, la clave secreta y el token de sesión. 

**nota**  
Si se produce un error `ExpiredToken` al llamar a la operación `AssumeRole`, probablemente se debe a que el `SESSION TOKEN` anterior aún se encuentra en las variables de entorno. Para retirarlo, establezca las variables siguientes:  
*AWS\$1ACCESS\$1KEY\$1ID* 
*AWS\$1SECRET\$1ACCESS\$1KEY* 
*AWS\$1SESSION\$1TOKEN* 

En el siguiente ejemplo, se muestra cómo definir estos tres parámetros en la CLI. Si utiliza un equipo con Microsoft Windows, utilice `set` en lugar de `export`.

```
export AWS_ACCESS_KEY_ID     = "access_key_from_assume_role"
export AWS_SECRET_ACCESS_KEY = "secret_key_from_assume_role"
export AWS_SESSION_TOKEN     = "session_token_from_assume_role"
```

Al ejecutar estos comandos, se define el ID de sesión del rol del usuario que visita su sitio web como `embedding_quicksight_console_session_role/john.doe@example.com`. El ID de sesión del rol está compuesto por el nombre del rol de `role-arn` y el valor de `role-session-name`. Al utilizar el ID de sesión del rol único para cada usuario, se garantiza que se definan los permisos correspondientes para cada usuario. También evitará la limitación del acceso de los usuarios. La limitación es una función de seguridad que impide que el mismo usuario acceda a Amazon Quick Sight desde varios lugares. 

El ID de sesión del rol también se convierte en el nombre de usuario en Amazon Quick Sight. Puede utilizar este patrón para aprovisionar a sus usuarios en Amazon Quick Sight con antelación o para aprovisionarlos la primera vez que accedan a una sesión de consola. 

En el siguiente ejemplo, se muestra el comando de la CLI que puede utilizar para incluir a un usuario. Para obtener más información sobre [RegisterUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_RegisterUser.html)y otras operaciones de la API de Amazon Quick Sight, consulte la [referencia de la API de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/APIReference/Welcome.html). [DescribeUser](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_DescribeUser.html)

```
aws quicksight register-user \
     --aws-account-id 111122223333 \
     --namespace default \
     --identity-type IAM \
     --iam-arn "arn:aws:iam::111122223333:role/embedding_quicksight_dashboard_role" \
     --user-role READER \
     --user-name jhnd \
     --session-name "john.doe@example.com" \
     --email john.doe@example.com \
     --region us-east-1 \
     --custom-permissions-name TeamA1
```

Si el usuario se ha autenticado a través de Microsoft AD, no es necesario utilizar `RegisterUser` para configurarlo. En su lugar, deberían suscribirse automáticamente la primera vez que accedan a Amazon Quick Sight. En el caso de los usuarios de Microsoft AD, puede utilizar `DescribeUser` para obtener el ARN del usuario.

La primera vez que un usuario accede a Amazon Quick Sight, también puede añadir este usuario al grupo correspondiente. En el siguiente ejemplo, se muestra el comando de la CLI para añadir un usuario a un grupo.

```
aws quicksight create-group-membership \
     --aws-account-id=111122223333 \
     --namespace=default \
     --group-name=financeusers \
     --member-name="embedding_quicksight_dashboard_role/john.doe@example.com"
```

Ahora tiene un usuario de su aplicación que también es usuario de Amazon Quick Sight y que tiene acceso a la sesión de consola de Amazon Quick Sight. 

Por último, para obtener una URL firmada para la sesión de consola, llame a `get-session-embed-url` desde el servidor de aplicaciones. Esto devuelve la URL de la sesión de consola que se puede integrar. En el siguiente ejemplo, se muestra cómo obtener la URL de una sesión de consola integrada mediante una llamada desde el servidor para los usuarios autenticados mediante AWS Managed Microsoft AD un inicio de sesión único (IAM Identity Center).

```
aws quicksight get-dashboard-embed-url \
     --aws-account-id 111122223333 \
     --entry-point the-url-for--the-console-session \
     --session-lifetime-in-minutes 600 \
     --user-arn arn:aws:quicksight:us-east-1:111122223333:user/default/embedding_quicksight_dashboard_role/embeddingsession
```

Para obtener más información sobre cómo usar esta operación, consulte [https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetSessionEmbedUrl.html](https://docs.aws.amazon.com/quicksight/latest/APIReference/API_GetSessionEmbedUrl.html). Puede utilizar esta y otras operaciones de la API en su propio código. 

------

# Paso 3: integración de la URL de la sesión de consola
<a name="embedded-analytics-full-console-for-authenticated-users-get-step-3"></a>

**importante**  
Amazon Quick Sight tiene novedades APIs para incorporar análisis: `GenerateEmbedUrlForAnonymousUser` y`GenerateEmbedUrlForRegisteredUser`.  
Puede seguir utilizando `GetDashboardEmbedUrl` y `GetSessionEmbedUrl` APIs para incrustar paneles y la consola Amazon Quick Sight, pero no incluyen las capacidades de incrustación más recientes. Para obtener la experiencia de up-to-date incrustación más reciente, consulte [Incrustar los análisis de Amazon Quick Sight en sus aplicaciones](https://docs.aws.amazon.com/quicksight/latest/user/embedding-overview.html).

En la siguiente sección, encontrará información sobre cómo puede utilizar el [SDK de incrustación de Amazon Quick Sight](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) (JavaScript) para incrustar la URL de la sesión de la consola del paso 3 en su sitio web o página de aplicación. Con el SDK, puede hacer lo siguiente: 
+ Coloque la sesión de consola en una página HTML.
+ Pase los parámetros a la sesión de consola.
+ Resolver los estados de error con mensajes que se personalizan en su aplicación.

Llamar a la operación de la API `GetSessionEmbedUrl` para obtener la dirección URL que puede integrar en la aplicación. Esta URL es válida durante 5 minutos, y la sesión resultante es válida durante 10 horas. La operación de la API proporciona la URL con un `auth_code` que permite una sesión con inicio único. 

El siguiente es un ejemplo de respuesta de `get-dashboard-embed-url`.

```
//The URL returned is over 900 characters. For this example, we've shortened the string for
//readability and added ellipsis to indicate that it's incomplete.
{
     "Status": "200",
     "EmbedUrl": "https: //dashboards.example.com/embed/620bef10822743fab329fb3751187d2d...",
     "RequestId": "7bee030e-f191-45c4-97fe-d9faf0e03713"
}
```

Inserte esta sesión de consola en su página web mediante el [SDK de incrustación](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk) de Amazon Quick Sight o añadiendo esta URL a un iframe. Si estableces un número fijo de altura y anchura (en píxeles), Amazon Quick Sight los usará y no cambiará la imagen a medida que la ventana cambie de tamaño. Si establece un porcentaje relativo de altura y anchura, Amazon Quick Sight proporciona un diseño adaptable que se modifica a medida que cambia el tamaño de la ventana. Al utilizar el SDK de incrustación de Amazon Quick Sight, también puede controlar los parámetros de la sesión de consola y recibir llamadas en función de la finalización de la carga de la página y de los errores. 

En el siguiente ejemplo, se muestra cómo utilizar la URL generada. Este código se genera en el servidor de aplicaciones.

```
<!DOCTYPE html>
<html>

<head>
    <title>Basic Embed</title>

    <script src="./quicksight-embedding-js-sdk.min.js"></script>
    <script type="text/javascript">
        var dashboard;

        function embedDashboard() {
            var containerDiv = document.getElementById("embeddingContainer");
            var options = {
                // replace this dummy url with the one generated via embedding API
                url: "https://us-east-1.quicksight.aws.amazon.com/sn/dashboards/dashboardId?isauthcode=true&identityprovider=quicksight&code=authcode",  
                container: containerDiv,
                scrolling: "no",
                height: "700px",
                width: "1000px",
                footerPaddingEnabled: true
            };
            dashboard = QuickSightEmbedding.embedDashboard(options);
        }
    </script>
</head>

<body onload="embedDashboard()">
    <div id="embeddingContainer"></div>
</body>

</html>
```

Para que este ejemplo funcione, asegúrese de utilizar el SDK de incrustación de Amazon Quick Sight para cargar la sesión de consola integrada en su sitio web utilizando JavaScript. Para obtener su copia, siga uno de estos pasos:
+ Descargue el [SDK de incrustación de Amazon Quick Sight](https://github.com/awslabs/amazon-quicksight-embedding-sdk#step-3-create-the-quicksight-session-object) desde GitHub. Este repositorio lo mantiene un grupo de desarrolladores de Amazon Quick Sight.
+ Descargue la última versión del SDK de incrustación desde [https://www.npmjs.com/package/amazon-quicksight-embedding-sdk](https://www.npmjs.com/package/amazon-quicksight-embedding-sdk).
+ Si lo usas `npm` para JavaScript dependencias, descárgalo e instálalo ejecutando el siguiente comando.

  ```
  npm install amazon-quicksight-embedding-sdk
  ```