Wie Sie eine Verbindung zur Reporting-Datenbank herstellen

Aktualisiert

Beta. Die Reporting-Datenbank befindet sich derzeit in der Beta‑Phase; die Angaben auf dieser Seite können sich noch ändern.

Was Sie benötigen

Nachdem Sie die Reporting‑Datenbank aktiviert haben, stellt Azumuta die folgenden Verbindungsdaten bereit:

  • Host — die Adresse Ihrer Reporting‑Datenbank.
  • Port — der Port, zu dem verbunden wird.
  • Database name — die Datenbank, mit der verbunden werden soll.
  • Username und password — Nur‑Lese‑Zugangsdaten für Ihren Workspace.
  • Schema name — der Bereich innerhalb der Datenbank, der die Daten Ihres Workspaces 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 einsehen. Teilen Sie sie nur mit den Personen, die sie benötigen, und speichern Sie sie in einem Secrets Manager statt in gemeinsamen Dokumenten oder im Quellcode.

Sichere Verbindungen (SSL) sind erforderlich

Die Reporting‑Datenbank akzeptiert nur verschlüsselte Verbindungen. Stellen Sie 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 der Verbindung richten Sie Ihre Session auf das Schema Ihres Workspaces ein, damit Sie die Tabellen mit ihren Kurznamen ansprechen können:

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

Um zu prüfen, ob 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 alle PostgreSQL. Allgemein gilt:

  1. Fügen Sie eine neue Datenquelle hinzu und wählen Sie den PostgreSQL‑Connector.
  2. Geben Sie Host, Port, Datenbanknamen, Benutzername und Passwort aus Azumuta ein.
  3. Aktivieren Sie SSL (setzen Sie den SSL‑Modus auf require).
  4. Wenn nach einem Schema gefragt wird, wählen Sie Ihr Workspace‑Schema (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 erste Ideen.

Hinweis zur Performance

Die Reporting‑Datenbank ist eine Kopie; aufwändige Abfragen verlangsamen Ihren Live‑Azumuta‑Workspace daher nicht. Dennoch ist es gute Praxis, in SQL zu filtern und zu aggregieren, statt komplette Tabellen in Ihr BI‑Tool zu laden.