Hoe u verbinding maakt met de rapportagedatabase

Bijgewerkt

Bèta-functie. De rapportagedatabase bevindt zich momenteel in bèta en kan nog veranderen. Deze functie is momenteel alleen beschikbaar op basis van opt-in. Neem contact op met uw Azumuta-contactpersoon om deel te nemen aan de bèta en deze uit te proberen.

Wat u nodig heeft

Nadat u de rapportagedatabase hebt ingeschakeld, verstrekt Azumuta de volgende verbindingsgegevens:

  • Host — het adres van uw rapportagedatabase.
  • Port — de poort om op te verbinden.
  • Database name — de database om verbinding mee te maken.
  • Username and password — alleen-lezen referenties voor uw werkruimte.
  • Schema name — het gedeelte binnen de database dat de gegevens van uw werkruimte bevat. Het ziet er zo uit: company_<your-workspace-id>.

Behandel deze referenties als een wachtwoord. Iedereen die ze heeft, kan uw rapportagegegevens lezen. Deel ze alleen met de personen die ze nodig hebben en sla ze op in een secrets manager in plaats van in gedeelde documenten of broncode.

Beveiligde verbindingen (SSL) zijn verplicht

De rapportagedatabase accepteert alleen versleutelde verbindingen. Zorg dat SSL/TLS is ingeschakeld wanneer u verbinding maakt. In de meeste tools betekent dit dat u de SSL-modus op require zet (of het selectievakje 'Use SSL' inschakelt).

Verbinden met een SQL-client

U kunt elke PostgreSQL-compatibele client gebruiken, zoals psql, DBeaver, TablePlus of pgAdmin. Een verbindingsreeks ziet er als volgt uit:

postgresql://<username>:<password>@<host>:<port>/<database>?sslmode=require

Na het verbinden richt u uw sessie op het schema van uw werkruimte zodat u naar tabellen kunt verwijzen met hun korte namen:

set search_path to "company_<your-workspace-id>";

Om te bevestigen dat alles werkt, geef de beschikbare tabellen weer:

select table_name
from information_schema.tables
where table_schema = 'company_<your-workspace-id>'
order by table_name;

Verbinden met een BI-tool

Tools zoals Power BI, Tableau, Metabase, Looker en Grafana ondersteunen allemaal PostgreSQL. In het algemeen:

  1. Voeg een nieuwe gegevensbron toe en kies de PostgreSQL-connector.
  2. Voer het hostadres, de poort, de databasenaam, de gebruikersnaam en het wachtwoord van Azumuta in.
  3. Schakel SSL in (stel de SSL-modus in op require).
  4. Wanneer om een schema wordt gevraagd, selecteert u het schema van uw werkruimte (company_<your-workspace-id>).

Na verbinding verschijnen uw tabellen in de tool en kunt u beginnen met het maken van dashboards. Zie Example Analytics Queries voor voorbeelden om mee te beginnen.

Opmerking over prestaties

De rapportagedatabase is een kopie, dus zware queries vertragen uw live Azumuta-werkruimte niet. Desondanks is het aan te raden om te filteren en te aggregeren in SQL in plaats van volledige tabellen naar uw BI-tool te importeren.