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