Partilhar via

Consulta a partir do Editor SQL no Lakehouse

Importante

A Lakebase Autoscaling está em Beta nas seguintes regiões: eastus2, westeurope, westus.

O Autoscaling do Lakebase é a versão mais recente do Lakebase com computação automática, escala até zero, ramificação e restauração instantânea. Para comparação de funcionalidades com o Lakebase Provisioned, veja a escolha entre versões.

Esta página descreve como consultar bases de dados no seu projeto Lakebase a partir do editor SQL no Lakehouse usando dois métodos de ligação diferentes.

O editor SQL no Lakehouse é um espaço de trabalho SQL colaborativo onde pode criar consultas, navegar por catálogos de dados, criar visualizações e partilhar resultados com colegas. Oferece funcionalidades avançadas para análise, colaboração e automação.

Observação

Para funcionalidades nativas do Postgres como EXPLAIN/ANALYZE e meta-comandos (\dt, \d, \l), use o Lakebase SQL Editor. Consulte o Editor de SQL Lakebase para consultas.

Para informações completas sobre as capacidades do editor SQL, consulte Escrever consultas e explorar dados no editor SQL.

Métodos de ligação

Pode ligar-se à sua base de dados Lakebase a partir do editor SQL usando dois métodos:

  1. Ligação direta de computação: Ligue-se diretamente ao seu computador Lakebase para acesso imediato a consultas a um projeto e ramo específicos.
  2. Registo do Catálogo Unity: Registe a sua base de dados no Catálogo Unity para permitir consultas federadas, governação unificada e análises entre fontes.

Escolha o seu método de ligação

Característica Ligação direta de computação Registo do Catálogo Unity
Acesso aos dados Acesso total de leitura e escrita à sua base de dados Lakebase Acesso apenas de leitura através do Unity Catalog
Melhor para Trabalhar principalmente com dados do Lakebase sem os combinar com outras fontes de dados Combinar dados do Lakebase com outras tabelas do Unity Catalog em consultas federadas
Complexidade da configuração Acesso imediato para consultar uma base de dados específica sem registo Requer registo de catálogo e privilégios do Catálogo Unity
Governação Sem funcionalidades de governação do Catálogo Unity Controlos unificados de governação (permissões, linhagem, registos de auditoria)
Controlo de acesso Apenas permissões baseadas em funções no Postgres Descoberta centralizada e controlo de acessos em múltiplas fontes de dados
Casos de utilização Operações diretas da base de dados e modificações Dashboards e aplicações que integram dados transacionais e analíticos

Método 1: Conectar-se diretamente ao cálculo Lakebase

Use este método para se ligar diretamente ao seu computador Lakebase para acesso imediato à consulta.

Antes de começar

Se não for o proprietário do projeto, verifique se tem:

Se não tiver o papel ou permissões necessárias, contacte o proprietário do projeto para solicitar acesso.

Observação

O cálculo Lakebase deve estar num estado ativo para se ligar a ele. Se a computação estiver inativa, não podes anexar. Os cálculos normalmente tornam-se inativos quando a escala para zero é ativada e não há atividade na base de dados.

Para ativar um cálculo inativo, execute uma consulta no Lakebase SQL Editor ou desative a escala até zero para garantir que o seu cálculo permanece ativo. Veja Escala para zero.

Para se ligar diretamente ao seu computador Lakebase:

  1. Usa o seletor de aplicações para navegar até Lakehouse.
  2. Abra o editor SQL clicando em Ícone do Editor SQLna barra lateral.
  3. No menu suspenso 'Conectar', selecione 'Mais...'

Menu de conexão

  1. No diálogo Anexar a um recurso de computação existente , selecione Lakebase Postgres, escolha a opção Autoscaling e depois selecione o seu Projeto e Ramo.

Anexar ao projeto LKB e ao ramo

  1. Clique em Anexar para ligar.

Exemplos de consultas com ligação direta

Depois de te ligares, podes executar consultas SQL padrão do Postgres na tua base de dados Lakebase.

Crie uma tabela, insira dados e consulte-os:

CREATE TABLE IF NOT EXISTS playing_with_lakebase(id SERIAL PRIMARY KEY, name TEXT NOT NULL, value REAL);
INSERT INTO playing_with_lakebase(name, value)
SELECT LEFT(md5(i::TEXT), 10), random() FROM generate_series(1, 10) s(i);
SELECT * FROM playing_with_lakebase;

Consulta uma tabela específica:

SELECT * FROM public.playing_with_lakebase;

Importante

Limitações da ligação direta:

  • Consultas federadas não suportadas: Só pode consultar o projeto Lakebase ao qual está ligado e o ramo. Não podes combinar dados do Lakebase com outras tabelas do Unity Catalog numa única consulta.
  • Meta-comandos Postgres não suportados: Os meta-comandos Postgres (como \dt, \d, \l) que funcionam no Lakebase SQL Editor não funcionam no editor SQL (Lakehouse).

Método 2: Registar a base de dados no Catálogo Unity

Use este método para registar a sua base de dados Lakebase no Unity Catalog, permitindo consultas federadas e governação unificada entre as suas fontes de dados.

Antes de começar

Verifique se você tem:

  • Função de Postgres: Uma função correspondente de Postgres para aceder à base de dados. Consulte Gerenciar funções do Postgres.
  • Permissões de base de dados: As permissões necessárias para aceder à base de dados, esquema ou tabela. Veja a gestão de permissões.
  • Privilégios do Unity Catalog: CREATE CATALOG privilégios na metastore do Unity Catalog para registar a base de dados
  • Armazenamento SQL: Um armazenamento SQL serverless para consultar o catálogo registado

Se não tiver o papel ou permissões necessárias, contacte o proprietário do projeto para solicitar acesso.

Registe a tua base de dados

Para registar uma base de dados Lakebase no Unity Catalog:

  1. Usa o seletor de aplicações para navegar até Lakehouse.
  2. No Explorador de Catálogos, clique no ícone mais e crie um catálogo.
  3. Insira um nome de catálogo (por exemplo, lakebase_catalog).
  4. Selecione Lakebase Postgres como tipo de catálogo, depois escolha a opção Autoscaling .
  5. Selecione o seu projeto, filial e base de dados Postgres.
  6. Clique em Criar.

O catálogo aparece no Explorador de Catálogos, onde pode navegar por esquemas, tabelas e vistas.

Consulta através do Catálogo Unity

Após o registo, consulte a sua base de dados Lakebase usando SQL warehouses ou qualquer ferramenta que se ligue ao Unity Catalog.

Consultar uma base de dados registada:

-- Query a registered :re[LKB] database
SELECT * FROM chatbot_catalog.public.conversations
WHERE created_at >= current_date - INTERVAL 7 DAYS;

Combine dados do Lakebase e do Lakehouse:

-- Join :re[LKB] and Unity Catalog data
SELECT
  c.conversation_id,
  c.user_id,
  c.agent_response,
  u.user_name,
  u.subscription_tier
FROM chatbot_catalog.public.conversations c
JOIN main.user_analytics.users u
  ON c.user_id = u.user_id;

Para informações sobre permissões do Catálogo Unity e concessão de acesso a outros utilizadores, consulte Permissões e controlo de acesso.

Importante

Limitações no registo do Catálogo Unity:

  • Acesso apenas de leitura: Os catálogos registados nas bases de dados Lakebase são apenas de leitura através do Unity Catalog. Para modificar dados, utilize o Lakebase SQL Editor ou ligue-se diretamente à sua base de dados.
  • Base de dados única por catálogo: Cada catálogo do Catálogo Unity representa uma base de dados Lakebase. Para expor múltiplas bases de dados, regista cada uma separadamente.
  • Sincronização de metadados: O Unity Catalog armazena metadados em cache para reduzir pedidos Postgres. Novos objetos podem não aparecer imediatamente. Clique em Atualizar Ícone de Esquema para ativar uma atualização completa.

Para informações completas sobre o registo de bases de dados no Unity Catalogue, consulte Registar uma base de dados Lakebase no Unity Catalog.

Próximos passos

  • Last updated on