Pular para o conteúdo principal

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.

Todos os conjuntos de dados são definidos por uma consulta. Para a maioria das tabelas e visualizações, a consulta default para essa dataset é uma declaração SELECT * na tabela ou view. O senhor pode modificar a consulta para refinar o dataset. O senhor não pode editar a definição de view para a visualização de métricas (Public Preview). No entanto, você pode adicionar cálculos personalizados para visualizar novas medidas e dimensões para o painel. Consulte O que são cálculos personalizados?.

Uma consulta deve produzir um dataset que possa ser envolvido em SQL adicional. As saídas do comando, como DESCRIBE ou EXPLAIN, não são válidas como conjunto de dados. Além disso, as consultas do painel são somente para leitura, portanto, declarações que modificam dados, como CREATE TABLE, INSERT ou DELETE, não são suportadas.

Depois de definir um dataset, use o menu kebab Ícone do 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 acessar download o dataset como um arquivo CSV, TSV ou Excel.

    O menu mostra as opções do site dataset

nota

O conjunto de dados atualmente em uso na tela aparece em negrito com um ícone azul, enquanto o conjunto de dados não utilizado tem um ícone cinza e nomes sem negrito.

visualizar 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.

Criar uma métrica view​

info

Visualização

Esse recurso está em Public Preview.

A visão métrica abstrai a lógica empresarial complexa em uma definição centralizada, permitindo que as organizações definam os indicadores de key desempenho uma vez e os utilizem de forma consistente em várias superfícies de relatórios. Consulte Unity Catalog métricas view. Se quiser criar uma métrica view a partir do editor do painel dataset, o senhor pode usar o Assistente para ajudá-lo a começar.

Para começar a criar uma métrica view:

  1. Clique no ícone Ícone do assistente de ajuda do produto - cor Assistant na barra lateral esquerda do editor dataset.

O ícone Assistente é destacado no editor do conjunto de dados.

  1. Digite uma descrição das métricas view que o senhor deseja criar.
  2. O Assistente retorna um exemplo de definição de métricas view e explica brevemente as dimensões e medidas definidas nela.
  3. Clique em Open métricas view editor para editar e salvar as métricas view.

Consulte Criar uma métrica view para obter mais detalhes sobre como criar uma métrica view.

Cálculos personalizados​

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

Escreva consultas com várias declarações​

Às vezes, 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.

SQL

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.

SQL
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.

SQL
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.

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

Limitar o acesso aos dados com o SQL​

Os visualizadores de 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.

Última atualização em