Criar e gerenciar conjuntos de dados do painel

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

Definir conjuntos de dados

Para definir ou acessar conjuntos de dados existentes, clique na guia Dados próximo ao canto superior esquerdo do painel. Você pode definir até 100 conjuntos de dados por painel.

Você pode definir conjuntos de dados como:

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

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

Um conjunto de dados deve ser produzido por uma consulta que pode ser encapsulada em SQL adicional. Saídas de comandos como DESCRIBE ou EXPLAIN não são válidas como conjuntos de dados. Além disso, as consultas de painel são somente leitura, portanto, não há suporte para as instruções que modificam dados, como CREATE TABLE, INSERT ou DELETE.

Depois de definir um conjunto de dados, use o 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 você deseja editar ou revisar.

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

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

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

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

  Menu

Observação

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

Exibir 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 que indica seu tipo de dados.

Para classificar valores de coluna:

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

Exibir o esquema de resultados da consulta

Para exibir o esquema do conjunto de dados definido, clique em Esquema à direita da Tabela de Resultados. A guia Esquema lista todos os campos do conjunto de dados definido. Cada campo é rotulado com um ícone que indica o tipo de dados da coluna. Se as tabelas ou exibições subjacentes incluírem comentários, elas 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, confira O que são as 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, encerre cada uma delas com 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 locais para o conjunto de dados em que 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 vai se aplicar somente a esse conjunto de dados.

Exemplos

Os exemplos a seguir demonstram usos comuns para consultas com múltiplas 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 na sua consulta. A seguinte consulta 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. Confira USE CATALOG.

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

Definir o modo ANSI

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

A consulta a seguir define ANSI_MODE como FALSE para que as entradas de tipo de dados inválidas retornem NULL em vez de gerar 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 da visão para uma expressão de tabela comum ou outra consulta complexa.

A consulta a seguir cria duas exibições temporárias. A instrução SELECT usa a cláusula IDENTIFIER para interpretar a cadeia de caracteres de entrada como um nome de tabela. Confira a cláusula IDENTIFIER.

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 define uma variável e um valor na primeira instrução. A segunda instrução altera o valor da variável. A terceira instrução mostra que o valor final da variável é 5. Confira SET VARIABLE para obter detalhes e a 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 de painel podem acessar todos os dados em um conjunto de dados, mesmo que não sejam mostrados em visualizações. Para impedir 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.