Criar e gerenciar o conjunto de dados do painel

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

Definir conjunto de dados

Para definir ou acessar o conjunto de dados existente, clique em Data tab próximo ao canto superior esquerdo do painel. O senhor pode definir até 100 conjuntos de dados por painel.

O senhor pode definir o conjunto de dados como:

  • Uma nova consulta em uma ou mais tabelas ou exibições.

  • Uma tabela existente no site Unity Catalog ou view.

Observação

Todos os conjuntos de dados são definidos por uma consulta. Quando o senhor escolhe uma tabela Unity Catalog ou view existente, a consulta para essa dataset é uma instrução SELECT * nessa tabela ou view. O senhor pode modificar a consulta para refinar o dataset.

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

  • Renomear: Dê ao seu dataset um nome descritivo para que o senhor e sua equipe possam identificar rapidamente as consultas que desejam editar ou revisar.

  • Nome sugerido: gere 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: Excluir um dataset. Essa opção não estará disponível se o dataset estiver sendo usado na tela.

  • download: O senhor pode download o dataset como um arquivo CSV, TSV, ou Excel.

    O menu mostra as opções do site dataset

Veja a tabela de resultados

Quando o senhor cria um dataset, 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 os valores das colunas:

  • Passe o mouse sobre cada coluna para mostrar o ícone Ícone de classificação de classificação.

  • Clique no ícone para classificar os valores em ordem crescente ou decrescente.

Visualizar o esquema de resultados da consulta

Para view o esquema de sua definição dataset, clique em Schema (Esquema ) à direita de Result Table (Tabela de resultados). O Schema tab lista todos os campos do site definido dataset. Cada campo tem um rótulo com um ícone que indica o tipo de dados da coluna. Se as tabelas ou visualizações subjacentes incluírem comentários, eles aparecerão no Schema tab.

Escreva consultas com várias declarações

Em alguns casos, o senhor pode querer construir um dataset usando várias declarações SQL. Para executar várias declarações, termine cada declaração com um ponto e vírgula (;). Quando o senhor executa esses comandos para criar o dataset, a saída mostra os resultados da última declaração no editor. Esse dataset é usado para todas as visualizações relacionadas na tela.

As declarações são locais para o site dataset no qual são emitidas. Por exemplo, se o senhor criar um dataset com uma instrução USE para definir o catálogo ou o esquema, essa configuração se aplicará somente a esse dataset.

Exemplos

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

Defina 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 somente ao nome da tabela porque o catálogo e o esquema foram definidos. Veja USE CATALOG.

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

Definir o modo ANSI

O senhor pode definir uma consulta para execução com ANSI_MODE definido como TRUE ou FALSE. Para Databricks SQL, o sistema default valor para ANSI_MODE é TRUE. Consulte 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 gerar um erro.

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

Parametrize consultas complexas

O senhor pode usar vários comandos para parametrizar o nome view 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 as cadeias de caracteres de entrada como um nome de tabela. Consulte 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 declara uma variável e um valor na primeira instrução. A segunda declaração altera o valor da variável. A terceira instrução mostra que o valor final da variável é 5. Consulte SET VARIABLE para obter detalhes e a sintaxe completa do uso de variáveis temporárias.

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

Limitar o acesso aos dados com o SQL

Os visualizadores do painel podem acessar todos os dados em um dataset, mesmo que 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 dataset. Por exemplo, em vez de selecionar todas as colunas de uma tabela, inclua somente os campos específicos necessários para visualizações.