Criar e gerenciar conjuntos de dados do painel

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

Definir conjuntos de dados

Para definir ou aceder a conjuntos de dados existentes, clique na guia Dados no canto superior esquerdo do seu painel. Para obter informações sobre o número de conjuntos de dados que cada painel pode incluir, consulte Limites do painel.

Para definir um conjunto de dados:

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

2. Escolha uma das seguintes opções:

   • Criar a partir de SQL: Use esta opção para escrever uma nova consulta SQL em qualquer fonte de dados.
   • Adicionar fonte de dados: Use esta opção para escolher uma tabela ou exibição do Catálogo 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 pode ser modificada 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 exibição de métrica (Visualização Pública) como fonte de dados, o conjunto de dados mostra a tabela de resultados e o esquema conforme definido na exibição de métrica. Consulte Utilizar vistas métricas e Exportar como uma vista métrica.
   • Carregue um ficheiro: Use esta opção para carregar um novo ativo no Unity Catalog. Use a caixa de diálogo de upload de arquivo para selecionar o nome do catálogo, esquema e tabela. Você pode definir um SQL warehouse específico para lidar com a computação associada a esse carregamento. Você também pode optar por Criar uma nova tabela ou Substituir tabela existente. Você deve ter MANAGE privilégios no esquema de dados selecionado para sobrescrever uma tabela existente.

Criar um conjunto de dados a partir do SQL

Você pode definir um conjunto de dados que extrai 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 nos seletores suspensos junto 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 o nome de uma tabela ou de uma coluna incluir espaços, envolva esses identificadores em backticks nas suas consultas SQL.

Restringir resultados de conjuntos de dados usando SQL

Os visualizadores do painel podem acessar todos os dados em um conjunto de dados, mesmo que eles 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 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.

A 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 apenas as linhas necessárias sejam incluídas.
• Esteja ciente de como os parâmetros podem expandir o acesso ao conjunto de dados ao construir consultas.
• Analise o esquema na Tabela de Resultados para confirmar que apenas os campos pretendidos estão disponíveis.

Usar visualizações métricas

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

• Selecione uma exibição de métrica como 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. Consulte O que são cálculos personalizados?.

• Fazer referência a uma vista de métrica numa consulta: Pode referenciar uma vista de métrica numa consulta SQL como qualquer outra vista. Use esse método se quiser filtrar ou remodelar o conjunto de dados. Todas as medidas de visualização métrica devem ser acessadas usando a MEASURE função de agregação. Consulte a função agregada measure.

Para criar uma nova exibição de métrica à medida que crias o teu dashboard, consulte Exportar como uma exibição de métrica.

Gerenciar conjuntos de dados

Depois de definir um conjunto de dados, use o à direita do nome do conjunto de dados para aceder às 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 deseja editar ou revisar.

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

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

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

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

  

Ver 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 indicando seu tipo de dados.

Para classificar valores de coluna:

• Passe o cursor 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 resultado da consulta

Para exibir o esquema do conjunto de dados definido, clique em Esquema à direita de Tabela de Resultados. A guia Esquema lista todos os campos do conjunto de dados definido. Cada campo é rotulado com um ícone indicando o tipo de dados da coluna. Se as tabelas ou vistas subjacentes incluírem comentários, eles aparecerão na guia Esquema.

Gerar visualizações a partir de conjuntos de dados

Você pode gerar exibições materializadas e 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. As exibições materializadas armazenam em cache os resultados da consulta e os atualizam em um cronograma especificado, o que pode reduzir o tempo de execução da consulta quando os mesmos dados são acessados repetidamente. Ver Vistas materializadas.

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

1. Clique no à direita do conjunto de dados que desejas exportar.
2. Selecione Exportar para visualização materializada.
3. No painel Exportar para vista materializada, use os seletores suspensos de catálogo e esquema para escolher onde a vista materializada será armazenada. Isso afeta quem pode acessar e usar a visão materializada. Consulte privilégios do Catálogo Unity e objetos securitizáveis.
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) Configure a agenda 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 métrica

As visualizações métricas abstraem a lógica de negócios complexa em uma definição centralizada, permitindo que as organizações definam indicadores-chave de desempenho uma vez e os usem de forma consistente em várias superfícies de relatórios. Consulte Visualizaçõ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 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 métrica:

1. Clique no à direita do conjunto de dados que pretende exportar como uma visualização métrica.
2. No painel Criar exibição de métrica , use os seletores suspensos de catálogo e esquema para escolher o esquema e o catálogo onde a exibição de métrica está armazenada. Isso afeta quem pode acessar e usar a exibição métrica. Consulte privilégios do Catálogo Unity e objetos securitizáveis.
3. (Opcional) Insira um nome para a visualização 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 visualização métrica ajustando o conteúdo gerado na seção de definição de YAML .
5. Clique em Salvar.

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

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

1. Clique no na barra lateral esquerda do editor do conjunto de dados. Em seguida, clique em Exportar para Visualização de Métrica.

1. Introduza uma descrição da vista métrica que pretende criar.
2. O Assistente retorna uma definição de exibição métrica de amostra e explica brevemente as dimensões e medidas definidas nela.
3. Clique em Abrir editor de visualização métrica para editar e salvar a visualização métrica.

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

Cálculos personalizados

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

Escrever consultas com várias instruções

Às vezes, você pode querer construir um conjunto de dados usando várias instruções SQL. Para executar várias instruções, termine cada instrução com um 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 específicas do conjunto de dados no qual 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 se aplicará somente a esse conjunto de dados.

Examples

Os exemplos a seguir demonstram usos comuns para interrogações 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 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 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 modo ANSI

Você pode definir uma consulta para ser executada com ANSI_MODE definida como TRUE ou FALSE. Para 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 entradas de tipo de dados inválidas retornem NULL em vez de lançar 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 do modo de exibição para uma expressão de tabela comum ou outra consulta complexa.

A consulta a seguir cria dois modos de exibição temporários. 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 declara na primeira instrução uma variável e um valor. A segunda instrução altera o valor da variável. A terceira instrução mostra que o valor final para a variável é 5. Consulte SET 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);