Criar e gerenciar conjuntos de dados do painel

Este artigo explica como criar e gerenciar conjuntos de dados de painel usando o editor de conjunto de dados em um painel de IA/BI.

Definir conjuntos de dados

Para definir ou aceder a conjuntos de dados existentes, clique na guia Dados no canto superior esquerdo do seu painel. Você pode definir até 100 conjuntos de dados por painel.

Você pode definir conjuntos de dados como:

• Uma nova consulta em relação a uma ou mais tabelas ou visões.
• Uma tabela ou exibição existente do Catálogo Unity.

Observação

Todos os conjuntos de dados são definidos por uma consulta. Quando você escolhe uma tabela ou exibição existente do Catálogo Unity, a consulta para esse conjunto de dados é uma instrução SELECT * nessa tabela ou exibição. Você pode modificar a consulta para refinar o conjunto de dados.

Depois de definir um conjunto de dados, use o menu menu kebab à direita do nome do conjunto de dados para acessar as seguintes opções:

• Renomear: Dê ao seu conjunto de dados um nome descritivo para que você e sua equipe possam identificar rapidamente as consultas que deseja editar ou revisar.

• Sugerir nome: Gere automaticamente um nome sugerido com base na consulta. Você pode editar esse nome depois que ele for gerado.

• Clone: Crie uma cópia no local da sua consulta. Você pode editar a consulta depois que ela for clonada.

• Excluir: Excluir um conjunto de dados. Essa opção não estará disponível se o conjunto de dados estiver sendo usado na tela.

• Download: Você pode baixar o conjunto de dados como um arquivo CSV, TSV ou Excel.

  

Observação

Os conjuntos de dados atualmente em uso na tela aparecem em negrito com um ícone azul, enquanto os conjuntos de dados não utilizados têm um ícone cinza e nomes sem negrito.

Ver a tabela de resultados

Quando você cria um conjunto de dados, a consulta é executada automaticamente e os resultados aparecem como uma tabela no painel abaixo do editor. Cada coluna inclui um ícone indicando seu tipo de dados.

Para classificar valores de coluna:

• Passe o cursor sobre cada coluna para mostrar o ícone Classificar ícone de classificação.
• Clique no ícone para classificar os valores em ordem crescente ou decrescente.

Exibir o esquema de resultado da consulta

Para exibir o esquema do conjunto de dados definido, clique em Esquema à direita de Tabela de Resultados. A guia Esquema lista todos os campos do conjunto de dados definido. Cada campo é rotulado com um ícone indicando o tipo de dados da coluna. Se as tabelas ou vistas subjacentes incluírem comentários, eles aparecerão na guia Esquema.

Medidas calculadas

As medidas calculadas oferecem uma maneira de aplicar cálculos a um conjunto de dados existente sem modificar o SQL que cria o conjunto de dados. Para saber mais sobre como criar e usar medidas calculadas, consulte O que são medidas calculadas?

Escrever consultas com várias instruções

Em alguns casos, talvez você queira construir um conjunto de dados usando várias instruções SQL. Para executar várias instruções, termine cada instrução com um ponto-e-vírgula (;). Quando você executa esses comandos para criar o conjunto de dados, a saída mostra os resultados da última instrução no editor. Esse conjunto de dados é usado para quaisquer visualizações relacionadas na tela.

As declarações são específicas do conjunto de dados no qual são emitidas. Por exemplo, se você criar um conjunto de dados com uma instrução USE para definir o catálogo ou esquema, essa configuração se aplicará somente a esse conjunto de dados.

Exemplos

Os exemplos a seguir demonstram usos comuns para consultas com várias instruções.

Definir o catálogo e o esquema

Você pode escrever uma instrução USE para declarar o catálogo e o esquema da tabela em sua consulta. A consulta a seguir contém três declarações. O primeiro define o nome do catálogo. O segundo define o esquema. A instrução SELECT faz referência apenas ao nome da tabela porque o catálogo e o esquema foram definidos. Ver USE CATALOG.

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

Definir modo ANSI

Você pode definir uma consulta para ser executada com ANSI_MODE definida como TRUE ou FALSE. Para Databricks SQL, o valor padrão do sistema para ANSI_MODE é TRUE. Ver ANSI_MODE.

A consulta a seguir define ANSI_MODE como FALSE para que entradas de tipo de dados inválidas retornem NULL em vez de lançar um erro.

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

Parametrizar consultas complexas

Você pode usar várias instruções para parametrizar o nome do modo de exibição para uma expressão de tabela comum ou outra consulta complexa.

A consulta a seguir cria dois modos de exibição temporários. A instrução SELECT usa a cláusula IDENTIFIER para interpretar a cadeia de caracteres de entrada como um nome de tabela. Ver IDENTIFIER cláusula.

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

Definir variáveis

A consulta a seguir declara na primeira instrução uma variável e um valor. A segunda instrução altera o valor da variável. A terceira instrução mostra que o valor final para a variável é 5. Consulte SET VARIABLE para obter detalhes e sintaxe completa para usar variáveis temporárias.

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

Limitar o acesso a dados com SQL

Os visualizadores do painel podem acessar todos os dados em um conjunto de dados, mesmo que eles não sejam mostrados em visualizações. Para evitar que dados confidenciais sejam expostos no navegador, restrinja as colunas na consulta SQL que define o conjunto de dados. Por exemplo, em vez de selecionar todas as colunas de uma tabela, inclua apenas os campos específicos necessários para visualizações.