Wie Sie eine Verbindung zur Reporting-Datenbank herstellen

Aktualisiert

Beta-Funktion. Die Reporting-Datenbank befindet sich derzeit in Beta und kann sich noch weiterentwickeln. Diese Funktion ist derzeit nur per Opt-in verfügbar. Kontaktieren Sie Ihren Azumuta-Ansprechpartner, um an der Beta teilzunehmen und sie auszuprobieren.

Was Sie benötigen

Nachdem Sie die Reporting-Datenbank aktiviert haben, stellt Azumuta die folgenden Verbindungsdaten zur Verfügung:

  • Host — die Adresse Ihrer Reporting-Datenbank.
  • Port — der Port, über den die Verbindung hergestellt wird.
  • Datenbankname — die Datenbank, mit der Sie sich verbinden.
  • Benutzername und Passwort — schreibgeschützte Zugangsdaten für Ihren Arbeitsbereich.
  • Schema-Name — der Bereich in der Datenbank, der die Daten Ihres Arbeitsbereichs enthält. Er sieht aus wie company_<your-workspace-id>.

Behandeln Sie diese Zugangsdaten wie ein Passwort. Jeder, der sie besitzt, kann Ihre Reporting-Daten lesen. Geben Sie sie nur an Personen weiter, die sie benötigen, und speichern Sie sie in einem Secrets-Manager statt in gemeinsam genutzten Dokumenten oder im Quellcode.

Sichere Verbindungen (SSL) sind erforderlich

Die Reporting-Datenbank akzeptiert nur verschlüsselte Verbindungen. Stellen Sie bei der Verbindung sicher, dass SSL/TLS aktiviert ist. In den meisten Tools bedeutet das, den SSL-Modus auf require zu setzen (oder das Kontrollkästchen "Use SSL" zu aktivieren).

Mit einem SQL-Client verbinden

Sie können jeden PostgreSQL-kompatiblen Client verwenden, z. B. psql, DBeaver, TablePlus oder pgAdmin. Eine Verbindungszeichenfolge sieht so aus:

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

Nach dem Verbinden richten Sie Ihre Sitzung auf das Schema Ihres Arbeitsbereichs aus, damit Sie Tabellen mit ihren Kurznamen ansprechen können:

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

Um zu bestätigen, dass alles funktioniert, listen Sie die verfügbaren Tabellen auf:

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

Mit einem BI-Tool verbinden

Tools wie Power BI, Tableau, Metabase, Looker und Grafana unterstützen PostgreSQL. Allgemein gilt:

  1. Fügen Sie eine neue Datenquelle hinzu und wählen Sie den PostgreSQL-Connector.
  2. Geben Sie Host, Port, Datenbankname, Benutzername und Passwort ein, die Sie von Azumuta erhalten haben.
  3. Aktivieren Sie SSL (setzen Sie den SSL-Modus auf require).
  4. Wenn nach einem Schema gefragt wird, wählen Sie das Schema Ihres Arbeitsbereichs (company_<your-workspace-id>).

Nach der Verbindung erscheinen Ihre Tabellen im Tool und Sie können mit dem Erstellen von Dashboards beginnen. Siehe Beispiel-Analytics-Abfragen für Anregungen zum Einstieg.

Ein Hinweis zur Performance

Die Reporting-Datenbank ist eine Kopie, daher verlangsamen aufwändige Abfragen nicht Ihren produktiven Azumuta-Arbeitsbereich. Dennoch ist es gute Praxis, in SQL zu filtern und zu aggregieren, statt vollständige Tabellen in Ihr BI-Tool zu ziehen.