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. Para obter informações sobre o número de conjuntos de dados que cada painel pode incluir, consulte os limites do painel.

Para definir um conjunto de dados:

1. Clique na guia Dados no canto superior esquerdo do painel.

2. Escolha uma das seguintes opções:

   • Crie a partir do SQL: Use essa opção para gravar uma nova consulta SQL em qualquer fonte de dados.
   • Adicionar fonte de dados: Use essa opção para escolher uma tabela ou exibição do Catálogo do Unity na qual basear seu conjunto de dados. Para a maioria das tabelas e exibições, os conjuntos de dados são definidos por uma consulta padrão SELECT * , que você pode modificar para refinar o conjunto de dados. Modifique a consulta para remover ou transformar campos disponíveis no conjunto de dados do painel. Quando você escolhe uma visualização de métrica (Visualização Pública) como uma fonte de dados, o conjunto de dados mostra a tabela de resultados e o esquema conforme definido na visualização de métrica. Veja Usar exibições de métrica e Exportar como exibição de métrica.
   • Carregue um arquivo: Use essa opção para carregar um novo ativo no Catálogo do Unity. Use a caixa de diálogo de upload de arquivo para selecionar o catálogo, o esquema e o nome da tabela. Você pode definir um sql warehouse específico para lidar com a computação associada a esse upload. Você também pode optar por criar uma nova tabela ou substituir a tabela existente. Você deve ter MANAGE privilégios no esquema selecionado para sobrescrever uma tabela existente.

Criar um conjunto de dados do SQL

Você pode definir um conjunto de dados que é extraído de qualquer fonte de dados disponível. Na consulta, identifique uma fonte de dados usando um nome de tabela totalmente qualificado na própria consulta ou selecionando uma combinação de catálogo e esquema dos seletores suspensos, juntamente com o nome da tabela na consulta. Um nome de tabela totalmente qualificado na consulta substitui os seletores de catálogo e esquema no editor. Se um nome de tabela ou coluna incluir espaços, encapsule esses identificadores em backticks em suas consultas SQL.

Restringir os resultados do conjunto de dados usando o 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.

O Databricks recomenda que você:

• Evite SELECT *. Em vez disso, selecione explicitamente apenas as colunas necessárias.
• Use WHERE cláusulas ou outra lógica de consulta para garantir que somente as linhas necessárias sejam incluídas.
• Lembre-se de como os parâmetros podem expandir o acesso ao conjunto de dados ao construir consultas.
• Examine o esquema na Tabela de Resultados para confirmar se apenas os campos pretendidos estão disponíveis.

Usar exibições de métrica

Você pode usar exibições de métrica em painéis selecionando uma exibição de métrica como fonte de dados ou fazendo referência a ela em uma consulta SQL.

• Selecione uma exibição de métrica como uma fonte de dados: Quando você escolhe uma exibição de métrica diretamente, o conjunto de dados inclui todas as dimensões e medidas definidas. Não é possível modificar a consulta do conjunto de dados para excluir colunas ou aplicar filtros. Você pode adicionar cálculos personalizados para criar medidas ou dimensões adicionais para visualização. Veja o que são cálculos personalizados?.

• Faça referência a uma exibição de métrica em uma consulta: Você pode referenciar uma exibição de métrica em uma consulta SQL como qualquer outra exibição. Use esse método se você quiser filtrar ou remodelar o conjunto de dados. Todas as medidas de visualização de métricas devem ser acessadas usando a função de agregação MEASURE. Consulte measure a função de agregação.

Para criar uma nova exibição de métrica ao criar seu painel, consulte Exportar como uma exibição de métrica.

Gerenciar conjuntos de dados

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

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.

Gerar exibições de conjuntos de dados

Você pode gerar visões materializadas e visões de métricas de seus conjuntos de dados para manter a consistência em seu espaço de trabalho.

Exportar um conjunto de dados como uma exibição materializada

Você pode exportar qualquer conjunto de dados como uma exibição materializada. Visões materializadas armazenam resultados de consulta em cache e os atualizam em um agendamento especificado, o que pode reduzir o tempo de execução da consulta quando dados idênticos são acessados repetidamente. Confira Exibições materializadas.

Para exportar um conjunto de dados como uma exibição materializada:

1. Clique no à direita do conjunto de dados que você deseja exportar.
2. Selecione Exportar para Exibição Materializada.
3. No painel Exportar para Visão Materializada, use os seletores suspensos de catálogo e esquema para escolher onde a visão materializada é armazenada. Isso afeta quem pode acessar e usar a exibição materializada. Confira Privilégios e objetos protegíveis do Catálogo do Unity.
4. (Opcional) Insira um nome para a exibição materializada. Por padrão, o título do conjunto de dados é convertido em um nome de exibição materializado válido.
5. (Opcional) Defina o agendamento de atualização e outras configurações de exibição materializadas.
6. Clique em Criar.

A exibição materializada é criada no local especificado do Catálogo Unity e pode ser usada por outros painéis e consultas em seu espaço de trabalho.

Exportar como uma visualização de métrica

As exibições de métrica abstraem a lógica de negócios complexa em uma definição centralizada, permitindo que as organizações definam indicadores de desempenho importantes uma vez e os usem consistentemente em várias superfícies de relatórios. Veja as visões métricas do Catálogo Unity. Você pode exportar um conjunto de dados como uma exibição de métrica ou usar o Assistente para ajudar a criar uma exibição de métrica. Se medidas e dimensões tiverem sido definidas para o conjunto de dados existente, elas aparecerão automaticamente na definição de exibição de métrica gerada.

Exportar um conjunto de dados como uma exibição de métrica

Para exportar um conjunto de dados como uma exibição de métrica:

1. Clique no à direita do conjunto de dados que você deseja exportar como uma exibição de métrica.
2. No painel Criar Exibição de Métricas, use os seletores suspensos de catálogo e esquema para escolher o catálogo e o esquema onde a exibição de métricas está armazenada. Isso afeta quem pode acessar e usar a visualização de métricas. Confira Privilégios e objetos protegíveis do Catálogo do Unity.
3. (Opcional) Insira um nome para a exibição de métrica. Por padrão, o título do conjunto de dados é convertido em um nome de exibição de métrica válido com base nos requisitos de nomenclatura.
4. (Opcional) Edite a exibição de métrica ajustando o conteúdo gerado na seção de definição do YAML .
5. Clique em Salvar.

Criar uma exibição de métrica usando o Assistente do Databricks

Crie uma exibição de métrica de um conjunto de dados usando o Assistente do Databricks:

1. Clique no ícone do Assistente do na barra lateral esquerda do editor de conjunto de dados. Em seguida, clique em Exportar para a Exibição de Métricas.

1. Insira uma descrição da exibição de métrica que você deseja criar.
2. O Assistente retorna uma definição de exibição de métrica de exemplo e explica brevemente as dimensões e medidas definidas nela.
3. Clique em Abrir editor de exibição de métrica para editar e salvar o modo de exibição de métrica.

Consulte Criar uma exibição de métrica para obter mais detalhes sobre como criar uma exibição de métrica.

Cálculos personalizados

Cálculos personalizados 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 cálculos personalizados, confira O que são cálculos personalizados?.

Gravar consultas com várias instruções

Às vezes, 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. Consulte 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. Consulte 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. 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 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. Consulte SET a variável para obter detalhes e sintaxe completa para usar variáveis temporárias.

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