Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gebruik PostgreSQL SQL om de operationele gegevens in Fabric HorizonDB op te vragen. Dit artikel gebruikt het horizon_sample schema dat is aangemaakt door de sample-data quickstart.
Important
Fabric HorizonDB is in publieke preview. Mogelijkheden, limieten en gedrag kunnen veranderen voordat deze algemeen beschikbaar is. Voor meer informatie, zie Microsoft Fabric-previewfuncties.
Prerequisites
- Een HorizonDB-database.
- De gegevens komen uit Load sample data, of uit gelijkwaardige tabellen van uzelf.
- Log in als de maker van de database, de enige identiteit die in de huidige preview verbinding kan maken met PostgreSQL.
Rijen inspecteren
Begin met een begrensd, geordend resultaat:
SELECT
order_reference,
order_date,
status,
total
FROM horizon_sample.orders
ORDER BY order_date DESC, order_reference
LIMIT 100;
PostgreSQL garandeert geen rijvolgorde zonder ORDER BY.
Voeg customers en orders samen
SELECT
order_row.order_reference,
customer.customer_name,
customer.segment,
order_row.order_date,
order_row.status,
order_row.total
FROM horizon_sample.orders AS order_row
JOIN horizon_sample.customers AS customer
ON customer.customer_id = order_row.customer_id
ORDER BY order_row.order_reference;
Schema-kwalificatie maakt het doelelement ondubbelzinnig en voorkomt dat u hoeft te vertrouwen op search_path.
Filter met parameters
Applicaties moeten waarden doorgeven als driverparameters. In een interactieve query kunt u een prepared statement gebruiken:
PREPARE orders_by_status (text) AS
SELECT
order_reference,
order_date,
total
FROM horizon_sample.orders
WHERE status = $1
ORDER BY order_date DESC;
EXECUTE orders_by_status ('open');
DEALLOCATE orders_by_status;
De levensduur van de prepared statement is gekoppeld aan de sessie. Ga er niet vanuit dat het een pauze of een verstorende overgang overleeft.
Geaggregeerde gegevens
SELECT
customer.segment,
count(order_row.order_id) AS order_count,
coalesce(sum(order_row.total), 0) AS order_total,
coalesce(avg(order_row.total), 0) AS average_order_total
FROM horizon_sample.customers AS customer
LEFT JOIN horizon_sample.orders AS order_row
ON order_row.customer_id = customer.customer_id
GROUP BY customer.segment
ORDER BY customer.segment;
De linker join behoudt een segment in het resultaat, zelfs als een klant geen bestellingen heeft.
Analyseer een queryplan
Gebruik EXPLAIN om de geplande bewerkingen te inspecteren zonder de query uit te voeren:
EXPLAIN (COSTS, VERBOSE)
SELECT
order_reference,
order_date,
total
FROM horizon_sample.orders
WHERE customer_id = 1
ORDER BY order_date DESC;
Gebruik EXPLAIN (ANALYZE, BUFFERS) zorgvuldig, want het voert de instructie uit. Gebruik ANALYZE niet bij een gegevenswijzigende instructie, tenzij je die wijziging bewust wilt en de instructie binnen een passende transactie uitvoert.
Gegevens bijwerken in een transactie
BEGIN;
UPDATE horizon_sample.orders
SET status = 'processing'
WHERE order_reference = 'ORD-1001'
AND status = 'open'
RETURNING order_reference, status;
COMMIT;
Het statuspredicaat maakt de overgang voorwaardelijk. Als het commando geen rijen teruggeeft, kan een andere sessie of een eerdere run de bestelling al hebben gewijzigd.
Voor opnieuw uitvoerbare applicatieworkflows gebruik stabiele business keys en idempotente statusovergangen. Speel een transactie niet blindelings opnieuw af nadat je de verbinding tijdens commit hebt verloren.
Metagegevens opvragen
Zoek klanttabellen:
SELECT
schemaname AS schema_name,
tablename AS table_name,
tableowner AS table_owner
FROM pg_catalog.pg_tables
WHERE schemaname NOT IN ('pg_catalog', 'information_schema')
ORDER BY schemaname, tablename;
Vind de grootste klanttabellen:
SELECT
statistics.schemaname AS schema_name,
statistics.relname AS table_name,
pg_total_relation_size(statistics.relid) AS total_bytes,
pg_size_pretty(pg_total_relation_size(statistics.relid)) AS total_size
FROM pg_catalog.pg_statio_user_tables AS statistics
ORDER BY total_bytes DESC
LIMIT 20;
Problemen oplossen bij queryresultaten
| Symptom | Cheque |
|---|---|
| Geen rijen | Controleer filters, transactiezichtbaarheid en dat voorbeeldgegevens zijn gecommitted. |
| Tabel bestaat niet | Controleer de database en het schema, de naam en het hoofdlettergebruik van de identifier tussen aanhalingstekens. |
| Machtiging geweigerd | Bevestig dat jij de databasemaker bent, controleer het eigendom van het object en controleer of de bewerking wordt ondersteund. |
| Query is geblokkeerd | Inspecteer pg_stat_activity en pg_blocking_pids() indien toegestaan. |
| Data verschilt van het SQL Analytics-endpoint | Mirroring is asynchroon; vergelijk tijdstempels en mirrorstatus. |
| Verbinding mislukt na een periode van inactiviteit | Maak opnieuw verbinding met een beperkt aantal nieuwe pogingen terwijl de database weer beschikbaar komt. |
Volgende stap
Maak verbinding vanuit Python.