Creación y administración de conjuntos de datos de panel

En este artículo se explica cómo crear y administrar conjuntos de datos de panel mediante el editor de conjuntos de datos en un panel de AI/BI.

Definición de conjuntos de datos

Para definir o acceder a los conjuntos de datos existentes, haga clic en la pestaña Datos cerca de la esquina superior izquierda del panel. Para obtener información sobre el número de conjuntos de datos que puede incluir cada panel, consulte Límites del panel.

Para definir un conjunto de datos:

1. Haga clic en la pestaña Datos de la esquina superior izquierda del panel.

2. Elija una de las siguientes opciones:

   • Crear a partir de SQL: Use esta opción para escribir una nueva consulta SQL en cualquier origen de datos.
   • Agregar origen de datos: Use esta opción para elegir una tabla o vista de catálogo de Unity en la que basar el conjunto de datos. Para la mayoría de las tablas y vistas, los conjuntos de datos se definen mediante una consulta predeterminada SELECT * , que puede modificar para refinar el conjunto de datos. Modifique la consulta para quitar o transformar campos disponibles en el conjunto de datos del panel. Al elegir una vista de métricas (versión preliminar pública) como origen de datos, el conjunto de datos muestra la tabla de resultados y el esquema tal como se define en la vista de métricas. Ver Usar vistas de métricas y Exportar como vista de métrica.
   • Cargue un archivo: Use esta opción para cargar un nuevo recurso en el catálogo de Unity. Use el cuadro de diálogo de carga de archivos para seleccionar el nombre de catálogo, esquema y tabla. Puede establecer un almacenamiento SQL específico para controlar el proceso asociado a esta carga. También puede elegir Crear una nueva tabla o Sobrescribir una tabla existente. Debe tener MANAGE privilegios en el esquema seleccionado para sobrescribir una tabla existente.

Creación de un conjunto de datos a partir de SQL

Puede definir un conjunto de datos que extraiga de cualquier origen de datos disponible. En la consulta, identifique un origen de datos con un nombre de tabla completo en la propia consulta o seleccione una combinación de catálogo y esquema en los selectores desplegables junto con el nombre de tabla de la consulta. Un nombre de tabla completamente cualificado en la consulta anula los selectores de catálogo y esquema en el editor. Si un nombre de tabla o columna incluye espacios, pon esos identificadores entre comillas invertidas en tus consultas SQL.

Restricción de los resultados del conjunto de datos mediante SQL

Los visores de paneles pueden acceder a todos los datos de un conjunto de datos, incluso si no se muestran en las visualizaciones. Para evitar que los datos confidenciales se expongan en el navegador, restrinja las columnas de la consulta SQL que define el conjunto de datos. Por ejemplo, en lugar de seleccionar todas las columnas de una tabla, incluya solo los campos específicos necesarios para las visualizaciones.

Databricks recomienda:

• Evite SELECT *. En su lugar, seleccione explícitamente solo las columnas necesarias.
• Use WHERE cláusulas u otra lógica de consulta para asegurarse de que solo se incluyen las filas necesarias.
• Tenga en cuenta cómo los parámetros pueden expandir el acceso al conjunto de datos al construir consultas.
• Revise el esquema de la tabla de resultados para confirmar que solo están disponibles los campos previstos.

Utilice vistas de métricas

Puede usar vistas de métricas en paneles seleccionando una vista de métrica como origen de datos o haciendo referencia a ella en una consulta SQL.

• Seleccione una vista de métrica como origen de datos: Al elegir una vista de métrica directamente, el conjunto de datos incluye todas las dimensiones y medidas definidas. No se puede modificar la consulta del conjunto de datos para excluir columnas ni aplicar filtros. Puede agregar cálculos personalizados para crear medidas o dimensiones adicionales para la visualización. Consulte ¿Qué son los cálculos personalizados?.

• Haga referencia a una vista de métricas en una consulta: Puede hacer referencia a una vista de métricas en una consulta SQL como cualquier otra vista. Use este método si desea filtrar o volver a dar forma al conjunto de datos. Se debe acceder a todas las medidas de vistas métricas mediante la función de agregado MEASURE. Consulte la measure función de agregación.

Para crear una nueva vista de métricas mientras diseña su panel, consulte Exportar como una vista de métricas.

Administración de conjuntos de datos

Después de definir un conjunto de datos, use el situado a la derecha del nombre del conjunto de datos para acceder a las siguientes opciones:

• Cambiar nombre: asigne un nombre descriptivo al conjunto de datos para que usted y el equipo puedan identificar rápidamente las consultas que quieran editar o revisar.

• Sugerir nombre: genera automáticamente un nombre sugerido en función de la consulta. Puede editar este nombre después de que se genere.

• Clonar: crea una copia local de la consulta. Puede editar la consulta una vez clonada.

• Eliminar: elimina un conjunto de datos. Esta opción no está disponible si el conjunto de datos se usa en el lienzo.

• Descargar: puede descargar el conjunto de datos como un archivo CSV, TSV o Excel.

  

Visualización de la tabla de resultados

Al crear un conjunto de datos, la consulta se ejecuta automáticamente y los resultados aparecen como una tabla en el panel debajo del editor. Cada columna incluye un icono que indica su tipo de datos.

Para ordenar los valores de columna:

• Pase el cursor sobre cada columna para mostrar el icono de orden .
• Haga clic en el icono para ordenar los valores en orden ascendente o descendente.

Ver el esquema de resultados de la consulta

Para ver el esquema del conjunto de datos definido, haga clic en Esquema a la derecha de la Tabla de resultados. En la pestaña Esquema se enumeran todos los campos del conjunto de datos definido. Cada campo se etiqueta con un icono que indica el tipo de datos de la columna. Si las tablas o vistas subyacentes incluyen comentarios, aparecen en la pestaña Esquema.

Generación de vistas a partir de conjuntos de datos

Puede generar vistas materializadas y vistas de métricas a partir de los conjuntos de datos para mantener la coherencia en el área de trabajo.

Exportación de un conjunto de datos como una vista materializada

Puede exportar cualquier conjunto de datos como una vista materializada. Las vistas materializadas almacenan en caché los resultados de la consulta y los actualizan según una programación especificada, lo que puede reducir el tiempo de ejecución de consultas cuando se accede repetidamente a los mismos datos. Consulte Vistas materializadas.

Para exportar un conjunto de datos como una vista materializada:

1. Haga clic en el icono de que se encuentra a la derecha del conjunto de datos que desea exportar.
2. Seleccione Exportar a vista materializada.
3. En el panel Exportar a la vista materializada, use los selectores desplegables de catálogo y esquema para elegir dónde se almacena la vista materializada. Esto afecta a quién puede acceder y usar la vista materializada. Consulte Privilegios de Unity Catalog y objetos protegibles.
4. (Opcional) Escriba un nombre para la vista materializada. De forma predeterminada, el título del conjunto de datos se convierte en un nombre de vista materializado válido.
5. (Opcional) Configure la programación de actualización y otros valores de vista materializada.
6. Haga clic en Crear.

La vista materializada se crea en la ubicación de Unity Catalog especificada y se puede usar en otros paneles y consultas dentro de tu espacio de trabajo.

Exportar como una vista de métricas

Las vistas de métricas abstraen lógica de negocios compleja en una definición centralizada, lo que permite a las organizaciones definir indicadores clave de rendimiento una vez y usarlos de forma coherente en varias superficies de informes. Consulte Vistas de métricas del catálogo de Unity. Puede exportar un conjunto de datos como una vista de métricas o usar el Asistente para ayudar a crear una vista de métrica. Si se han definido medidas y dimensiones para el conjunto de datos existente, aparecen automáticamente en la definición de vista de métrica generada.

Exportación de un conjunto de datos como una vista de métricas

Para exportar un conjunto de datos como una vista de métrica:

1. Haga clic en el icono de , a la derecha del conjunto de datos que desea exportar como vista de métricas.
2. En el panel Crear vista métrica , use los selectores desplegables de catálogo y esquema para elegir el esquema y el catálogo donde se almacena la vista de métricas. Esto afecta a quién puede acceder y usar la vista de métricas. Consulte Privilegios de Unity Catalog y objetos protegibles.
3. (Opcional) Escriba un nombre para la vista de métricas. De forma predeterminada, el título del conjunto de datos se convierte en un nombre de vista de métrica válido en función de los requisitos de nomenclatura.
4. (Opcional) Edite la vista de métrica ajustando el contenido generado en la sección definición de YAML .
5. Haz clic en Guardar.

Creación de una vista de métrica mediante Databricks Assistant

Cree una vista de métricas a partir de un conjunto de datos mediante Databricks Assistant:

1. Haga clic en el en la barra lateral izquierda del editor de conjuntos de datos. A continuación, haga clic en Exportar a la vista métrica.

1. Escriba una descripción de la vista de métrica que desea crear.
2. El Asistente devuelve una definición de vista de métrica de ejemplo y explica brevemente las dimensiones y medidas definidas en ella.
3. Haga clic en Abrir editor de vistas de métricas para editar y guardar la vista de métricas.

Consulte Creación de una vista de métricas para obtener más detalles sobre cómo crear una vista de métricas.

Cálculos personalizados

Los cálculos personalizados ofrecen una manera de aplicar cálculos a un conjunto de datos existente sin modificar el SQL que crea el conjunto de datos. Para más información sobre cómo crear y usar cálculos personalizados, consulte ¿Qué son los cálculos personalizados?.

Escritura de consultas de varias instrucciones

A veces, es posible que desee construir un conjunto de datos mediante varias instrucciones SQL. Para ejecutar varias instrucciones, finalice cada instrucción con un punto y coma (;). Al ejecutar esos comandos para crear el conjunto de datos, la salida muestra los resultados de la última instrucción en el editor. Este conjunto de datos se usa para las visualizaciones relacionadas en el lienzo.

Las declaraciones son locales al conjunto de datos en el que se emiten. Por ejemplo, si crea un conjunto de datos con una instrucción USE para establecer el catálogo o el esquema, esa configuración solo se aplica a ese conjunto de datos.

Examples

En los siguientes ejemplos se muestran usos comunes para consultas de varias instrucciones.

Establecer el catálogo y el esquema

Puede escribir una instrucción USE para declarar el catálogo y el esquema de la tabla en la consulta. La siguiente consulta contiene tres declaraciones. La primera establece el nombre del catálogo. La segunda establece el esquema. La instrucción SELECT hace referencia solo al nombre de la tabla porque se han establecido el catálogo y el esquema. Consulte USE CATALOG.

USE CATALOG samples;
USE SCHEMA tpch;
SELECT * FROM customer;

Establecer el modo ANSI

Puede establecer una consulta para que se ejecute con ANSI_MODE establecido en TRUE o FALSE. Para Databricks SQL, el valor predeterminado del sistema para ANSI_MODE es TRUE. Consulte ANSI_MODE.

La consulta siguiente establece ANSI_MODE en FALSE para que las entradas de tipo de datos no válidas devuelvan NULL en lugar de producir un error.

SET ANSI_MODE = FALSE;
SELECT cast('a' AS INTEGER);

Parametrizar consultas complejas

Puede usar varias instrucciones para parametrizar el nombre de vista de una expresión de tabla común u otra consulta compleja.

La consulta siguiente crea dos vistas temporales. La instrucción SELECT usa la cláusula IDENTIFIER para interpretar la cadena de entrada como un nombre de tabla. Consulte la cláusula IDENTIFIER.

CREATE TEMPORARY VIEW v1 AS SELECT 1;
CREATE TEMPORARY VIEW v2 AS SELECT 2;
SELECT * FROM IDENTIFIER(:view_name)

Configuración de variables

La consulta que sigue declara una variable y un valor en la primera instrucción. La segunda instrucción cambia el valor de la variable. La tercera instrucción muestra que el valor final de la variable es 5. Consulte SET variable para más información y sintaxis completa para usar variables temporales.

DECLARE VARIABLE myvar1 INT DEFAULT 7;
SET VAR myvar1 = 5;
VALUES (myvar1);