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.

Para definir um dataset:

1. Clique em Data tab no canto superior esquerdo de seu painel.

2. Escolha uma das seguintes opções:

   • Criar a partir de SQL: Use essa opção para escrever uma nova consulta SQL em qualquer fonte de dados.
   • Adicionar fonte de dados: Use essa opção para escolher uma tabela Unity Catalog ou view na qual basear seu dataset. Para a maioria das tabelas e visualizações, o conjunto de dados é definido por uma consulta default SELECT * , que o senhor pode modificar para refinar o dataset. Modifique a consulta para remover ou transformar os campos disponíveis no painel dataset. Quando o senhor escolhe uma métrica view (Public Preview) como fonte de dados, o site dataset mostra a tabela de resultados e o esquema conforme definido na métrica view. Não há suporte para a edição de visualizações métricas diretamente do painel. Para saber como usar a visualização de métricas com seu painel, consulte Usar a visualização de métricas.
   • carregar um arquivo: Use essa opção para upload um novo ativo para Unity Catalog. Use a caixa de diálogo de upload de arquivos para selecionar o nome do catálogo , do esquema e da tabela. O senhor pode definir um SQL warehouse específico para lidar com o compute associado a esse upload. Você também pode escolher Criar uma nova tabela ou Substituir a tabela existente . Você deve ter privilégios MANAGE no esquema selecionado para substituir uma tabela existente.

nota

As consultas do painel são somente para leitura. comandos como DESCRIBE, EXPLAIN, CREATE TABLE, INSERT, ou DELETE não são compatíveis com a definição do conjunto de dados. Somente as consultas que podem ser agrupadas em SQL adicional são válidas.

Use métricas view

O senhor pode usar a visualização de métricas em painéis selecionando uma métrica view como uma fonte de dados ou fazendo referência a ela em uma consulta SQL.

• Selecione uma métrica view como fonte de dados: Quando o senhor escolhe uma métricas view diretamente, a dataset inclui todas as dimensões e medidas definidas. O senhor não pode modificar a consulta dataset para excluir colunas ou aplicar filtros. Você pode adicionar cálculos personalizados para criar medidas ou dimensões adicionais para visualização. Consulte O que são cálculos personalizados?.

• Fazer referência a métricas view em uma consulta: O senhor pode fazer referência a uma métricas view em uma consulta SQL como qualquer outra view. Use esse método se o senhor quiser filtrar ou remodelar o site dataset. Todas as medidas métricas view devem ser acessadas usando a função agregada MEASURE. Veja a função agregadameasure.

Para criar uma nova métrica view enquanto o senhor cria seu painel, consulte Criar uma métrica view.

gerenciar conjunto de dados

Depois de definir um dataset, use o 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.

  

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 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 Assistant na barra lateral esquerda do editor dataset.

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.