Hoe u verbinding maakt met de rapportagedatabase

Bijgewerkt

Bèta. De rapportagedatabase bevindt zich momenteel in bèta; de details op deze pagina kunnen nog wijzigen.

Wat u nodig heeft

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

  • Host — het adres van uw rapportagedatabase.
  • Port — de poort om verbinding mee te maken.
  • Database name — de database om verbinding mee te maken.
  • Username en password — referenties met alleen-leesrechten voor uw werkruimte.
  • Schema name — het gedeelte in de database waar de gegevens van uw werkruimte staan. Het heeft de vorm company_<your-workspace-id>.

Behandel deze referenties als een wachtwoord. Iedereen die erover beschikt kan uw rapportagegegevens lezen. Deel ze alleen met personen die ze nodig hebben en bewaar ze in een secrets manager of wachtwoordkluis in plaats van in gedeelde documenten of broncode.

Beveiligde verbindingen (SSL) zijn vereist

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 connectiestring ziet er als volgt uit:

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

Na het verbinden, wijs uw sessie naar het schema van uw werkruimte zodat u tabellen bij hun korte namen kunt noemen:

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

Om te controleren of alles werkt, maak een lijst van de beschikbare tabellen:

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 de host, poort, databasenaam, gebruikersnaam en het wachtwoord in die Azumuta geeft.
  3. Schakel SSL in (stel de SSL-modus in op require).
  4. Wanneer om een schema wordt gevraagd, selecteer uw werkruimte-schema (company_<your-workspace-id>).

Zodra u verbonden bent, verschijnen uw tabellen in de tool en kunt u dashboards gaan bouwen. Zie Example Analytics Queries voor voorbeelden om mee te beginnen.

Een opmerking over prestaties

De rapportagedatabase is een kopie, dus zware queries vertragen uw live Azumuta-werkruimte niet. Het is echter verstandig om te filteren en te aggregeren in SQL in plaats van hele tabellen in uw BI-tool te laden.