Query's uitvoeren vanuit SQL Editor in Lakehouse

Belangrijk

nl-NL: Lakebase Autoscaling is beschikbaar in de volgende regio's: eastus, eastus2, centralus, southcentralus, westus, westus2, canadacentral, brazilsouth, northeurope, uksouth, westeurope, australiaeast, centralindia, southeastasia.

Lakebase Autoscaling is de nieuwste versie van Lakebase, met automatisch schalen van rekenkracht, schaal-tot-nul, branching-functionaliteit en direct herstellen. Als u een door Lakebase ingericht gebruiker bent, raadpleegt u Lakebase Ingericht.

Op deze pagina wordt beschreven hoe u query's uitvoert op databases in uw Lakebase-project vanuit de SQL-editor in Lakehouse met behulp van twee verschillende verbindingsmethoden.

De SQL-editor in Lakehouse is een gezamenlijke SQL-werkruimte waar u query's kunt maken, door gegevenscatalogussen kunt bladeren, visualisaties kunt maken en resultaten kunt delen met collega's. Het biedt geavanceerde functies voor analyses, samenwerking en automatisering.

Opmerking

Gebruik de Lakebase SQL-editor voor systeemeigen functies zoals EXPLAIN/ANALYZE en meta-opdrachten (\dt, \d, \l). Zie Query van Lakebase SQL Editor.

Zie Query's schrijven en gegevens verkennen in de SQL-editor voor volledige informatie over de mogelijkheden van DE SQL-editor.

Verbindingsmethoden

U kunt verbinding maken met uw Lakebase-database vanuit de SQL-editor met behulp van twee methoden:

1. Directe rekenverbinding: maak rechtstreeks verbinding met uw Lakebase-rekenproces voor directe querytoegang tot een specifiek project en een specifieke vertakking.
2. Registratie van Unity Catalog: Registreer uw database in Unity Catalog om federatieve query's, geïntegreerde governance en analyse tussen bronnen mogelijk te maken.

Kies uw verbindingsmethode

Feature	Directe rekenverbinding	Registratie van Unity Catalog
Gegevenstoegang	Volledige lees-schrijftoegang tot uw Lakebase-database	Alleen-lezen toegang via Unity Catalog
Het beste voor	Voornamelijk werken met Lakebase-gegevens zonder deze te combineren met andere gegevensbronnen	Lakebase-gegevens combineren met andere Unity Catalog-tabellen in federatieve query's
Complexiteit van installatie	Directe toegang om een query uit te voeren op een specifieke database zonder registratie	Vereist catalogusregistratie en Unity Catalog-bevoegdheden
Governance	Geen governancefuncties voor Unity Catalog	Geünificeerde governancecontroles (machtigingen, herkomst, auditlogboeken)
Toegangsbeheer	Alleen postgres-machtigingen op basis van rollen	Gecentraliseerd detectie- en toegangsbeheer voor meerdere gegevensbronnen
Toepassingsgevallen	Directe databasebewerkingen en -wijzigingen	Dashboards en toepassingen die transactionele en analytische gegevens integreren

Methode 1: Rechtstreeks verbinding maken met Lakebase Compute

Gebruik deze methode om rechtstreeks verbinding te maken met uw Lakebase-rekenproces voor directe toegang tot query's.

Voordat u begint

Als u niet de projecteigenaar bent, controleert u of u het volgende hebt:

• Postgres-rol: een bijbehorende Postgres-rol voor toegang tot de database. Zie Postgres-rollen beheren.
• Databasemachtigingen: de benodigde machtigingen voor toegang tot de database, het schema of de tabel. Zie Machtigingen beheren.

Als u niet over de benodigde rol of machtigingen beschikt, neemt u contact op met de projecteigenaar om toegang aan te vragen.

Opmerking

De Lakebase-rekenkracht moet een actieve status hebben om eraan te koppelen. Als de berekening niet actief is, kunt u deze niet koppelen. Computers worden doorgaans gedeactiveerd wanneer schalen naar nul is ingeschakeld en er geen databaseactiviteit plaatsvindt.

Als u een niet-actieve berekening wilt activeren, voert u een query uit in de Lakebase SQL-editor of schakelt u schaal naar nul uit om ervoor te zorgen dat uw berekening actief blijft. Zie Tot nul schalen.

Rechtstreeks verbinding maken met uw Lakebase-rekenproces:

1. Gebruik de switcher voor apps om naar Lakehouse te navigeren.
2. Open de SQL-editor door op SQL Editor in de zijbalk te klikken.
3. Selecteer in het vervolgkeuzemenu Verbinden de optie Meer....

4. In het dialoogvenster Koppelen aan een bestaande rekenresource selecteert u Lakebase Postgres, kiest u de optie Voor automatisch schalen en selecteert u vervolgens uw project en vertakking.

5. Klik op Bijvoegen om verbinding te maken.

Voorbeelden van queries met directe verbinding

Nadat u verbinding hebt gemaakt, kunt u standaard Postgres SQL-query's uitvoeren op uw Lakebase-database.

Een tabel maken, gegevens invoegen en er query's op uitvoeren:

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;

Een query uitvoeren op een specifieke tabel:

SELECT * FROM public.playing_with_lakebase;

Belangrijk

Beperkingen met directe verbinding:

• Federatieve query's worden niet ondersteund: u kunt alleen query's uitvoeren op het verbonden Lakebase-project en -vertakking. U kunt Lakebase-gegevens niet combineren met andere Unity Catalog-tabellen in één query.
• Postgres-metaopdrachten worden niet ondersteund: De Postgres-metaopdrachten (zoals \dt, \d\l) die in de Lakebase SQL-editor werken, werken niet in de SQL-editor (Lakehouse).

Methode 2: Database registreren in Unity Catalog

Gebruik deze methode om uw Lakebase-database te registreren in Unity Catalog, zodat federatieve query's en geïntegreerde governance in uw gegevensbronnen mogelijk zijn.

Voordat u begint

Controleer of u het volgende hebt:

• Postgres-rol: een bijbehorende Postgres-rol voor toegang tot de database. Zie Postgres-rollen beheren.
• Databasemachtigingen: de benodigde machtigingen voor toegang tot de database, het schema of de tabel. Zie Machtigingen beheren.
• Unity Catalog-bevoegdheden: CREATE CATALOG bevoegdheden voor de Unity Catalog-metastore om de database te registreren
• SQL Warehouse: een serverloze SQL Warehouse om een query uit te voeren op de geregistreerde catalogus

Als u niet over de benodigde rol of machtigingen beschikt, neemt u contact op met de projecteigenaar om toegang aan te vragen.

Uw database registreren

Een Lakebase-database registreren in Unity Catalog:

1. Gebruik de switcher voor apps om naar Lakehouse te navigeren.
2. Klik in Catalog Explorer op het pluspictogram en maak een catalogus.
3. Voer een catalogusnaam in (bijvoorbeeld lakebase_catalog).
4. Selecteer Lakebase Postgres als catalogustype en kies vervolgens de optie Voor automatisch schalen .
5. Selecteer uw project, vertakking en Postgres-database.
6. Klik op Create.

De catalogus wordt weergegeven in Catalog Explorer, waar u door schema's, tabellen en weergaven kunt bladeren.

Query's uitvoeren via Unity Catalog

Voer na de registratie een query uit op uw Lakebase-database met behulp van SQL Warehouses of een hulpprogramma dat verbinding maakt met Unity Catalog.

Een query uitvoeren op een geregistreerde database:

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

Gegevens van Lakebase en Lakehouse combineren:

-- 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;

Zie Machtigingen en toegangsbeheer voor meer informatie over Unity Catalog-machtigingen en het verlenen van toegang aan andere gebruikers.

Belangrijk

Beperkingen met registratie van Unity Catalog:

• Alleen-lezentoegang: Catalogi die zijn geregistreerd bij Lakebase-databases zijn alleen-lezen via Unity Catalog. Als u gegevens wilt wijzigen, gebruikt u de Lakebase SQL Editor of maakt u rechtstreeks verbinding met uw database.
• Individuele database per catalogus: Elke Unity Catalog-catalogus vertegenwoordigt één Lakebase-database. Als u meerdere databases beschikbaar wilt maken, moet u deze afzonderlijk registreren.
• Synchronisatie van metagegevens: Unity Catalog slaat metagegevens in de cache op om Postgres-aanvragen te verminderen. Nieuwe objecten worden mogelijk niet onmiddellijk weergegeven. Klik op om een volledige vernieuwing te activeren.

Zie Een Lakebase-database registreren in Unity Catalog voor volledige informatie over het registreren van databases in Unity Catalog.

Volgende stappen

• De Lakebase SQL-editor gebruiken
• Postgres-rollen beheren
• Schaal naar nul configureren