# BI-Werkzeug per SQL anbinden (https://docs.akollo.com/de/connections/bi-sql-access)



Ein Business-Intelligence-Werkzeug wie Power BI, Tableau oder Excel kann die vom Reporting freigegebenen Datensätze auch direkt aus der Datenbank lesen. Das Werkzeug meldet sich mit einer eigenen Anmeldung an, sieht nur die für es geöffneten Views und kann nichts ändern. Dieser Weg ist für Power BI DirectQuery und Live-Verbindungen in Tableau gedacht.

<Mermaid
  title="Vom BI-Zugang zur funktionierenden Verbindung"
  chart="`flowchart LR
A[Reporting-Admin legt BI-Zugang an] --> B[Anderer Admin gibt frei]
B --> C[Set up login]
C --> D[Waiting to be applied]
D --> E[Active]
E --> F[BI-Werkzeug verbindet sich]`"
/>

## 1. Zugang im Reporting einrichten [#1-zugang-im-reporting-einrichten]

Eine Reporting-Administratorin oder ein Reporting-Administrator legt unter **Settings → Reports → Datasets** (Einstellungen → Berichte → Datensätze) einen BI-Zugang an, der „über SQL liest“, und wählt die Datensätze und Organisationseinheiten, die er sehen darf. Ein anderer Administrator gibt ihn frei. Ein freigegebener Zugang erhält einen Benutzernamen, der mit `akollo_bi_` beginnt.

## 2. Anmeldung einrichten [#2-anmeldung-einrichten]

<Steps>
  <Step>
    ### Analytics SQL access öffnen [#analytics-sql-access-öffnen]

    Öffnen Sie **Integrations → Analytics SQL access**. Jeder freigegebene SQL-Zugang erscheint dort als Karte.
  </Step>

  <Step>
    ### Anmeldung einrichten [#anmeldung-einrichten]

    Klicken Sie auf der Karte auf **Set up login** (Anmeldung einrichten). Das Passwort wird direkt darunter einmal angezeigt. Übernehmen Sie es in Ihr BI-Werkzeug; es wird nicht erneut angezeigt.
  </Step>

  <Step>
    ### Warten, bis sie aktiv ist [#warten-bis-sie-aktiv-ist]

    Die Karte zeigt zunächst **Waiting to be applied** (wartet auf Anwendung) und wechselt innerhalb weniger Minuten auf **Active**. Ab dann kann sich das Werkzeug verbinden.
  </Step>
</Steps>

| Aktion                         | Wirkung                                                                                                                                     |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------- |
| **Rotate password**            | Wenn Sie das Passwort verloren haben oder regelmäßig wechseln möchten. Das alte Passwort funktioniert ab der nächsten Anwendung nicht mehr. |
| **Close**                      | Schaltet die Anmeldung ab und beendet ihre offenen Verbindungen.                                                                            |
| Zugang im Reporting widerrufen | Die Anmeldung wird automatisch geschlossen.                                                                                                 |

<Callout type="info" title="Hinweis">
  Diese Seite sehen Eigentümer und Administratoren der Organisation. Für alle anderen ist sie gesperrt.
</Callout>

## 3. Verbindungsdaten [#3-verbindungsdaten]

Das Feld **Connection details** (Verbindungsdaten) neben den Karten zeigt Host und Port.

| Feld          | Wert                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------- |
| Host und Port | Die auf der Seite angezeigte Adresse                                                                    |
| Datenbank     | Der auf der Seite angezeigte Datenbankname                                                              |
| Benutzer      | Der `akollo_bi_…`-Name auf der Karte                                                                    |
| Passwort      | Das bei der Einrichtung einmal angezeigte Passwort                                                      |
| SSL           | Erforderlich, `sslmode=verify-full`; hinterlegen Sie im Werkzeug das Stammzertifikat Ihrer Organisation |

Die Views liegen im Schema `bi`. `bi.catalog` listet die für den Zugang geöffneten Datensätze, und jeder Datensatz ist als `bi.<dataset>_v<version>` lesbar (zum Beispiel `bi.time_team_daily_v1`). Eine Abfrage darf höchstens einige Minuten laufen, und es können nur wenige Verbindungen gleichzeitig offen sein. Wird eine lange Abfrage abgebrochen, grenzen Sie ihren Filter ein.

## 4. Power BI DirectQuery [#4-power-bi-directquery]

<Steps>
  <Step>
    ### Datenquelle wählen [#datenquelle-wählen]

    Wählen Sie in Power BI Desktop **Get data → PostgreSQL database**.
  </Step>

  <Step>
    ### Server und Datenbank eingeben [#server-und-datenbank-eingeben]

    **Server**: Host und Port von der Seite (`host:port`). **Database**: der auf der Seite angezeigte Datenbankname.
  </Step>

  <Step>
    ### DirectQuery wählen [#directquery-wählen]

    Setzen Sie **Data connectivity mode** auf **DirectQuery**. Power BI fragt dann bei jedem Visual die Datenbank ab, statt eine Kopie zu importieren.
  </Step>

  <Step>
    ### Anmelden [#anmelden]

    Wählen Sie bei der Abfrage der Anmeldeinformationen **Database** und geben Sie den `akollo_bi_…`-Benutzer und das Passwort ein. Die Verschlüsselung muss eingeschaltet bleiben. Installieren Sie das Stammzertifikat Ihrer Organisation auf dem Rechner und, falls der Bericht im Power-BI-Dienst veröffentlicht wird, auch auf dem lokalen Datengateway.
  </Step>

  <Step>
    ### Views auswählen [#views-auswählen]

    Öffnen Sie im Navigator das Schema `bi` und wählen Sie die benötigten `<dataset>_v<version>`-Views. `bi.catalog` listet sie auf.
  </Step>
</Steps>

<Callout type="idea" title="Tipp">
  Halten Sie Visuals verdichtet, etwa nach Monat oder Team. Jedes Visual ist eine Abfrage, und eine Abfrage, die länger als das Limit läuft, wird gestoppt.
</Callout>

## 5. Tableau [#5-tableau]

<Steps>
  <Step>
    ### PostgreSQL wählen [#postgresql-wählen]

    Wählen Sie **Connect → To a Server → PostgreSQL**.
  </Step>

  <Step>
    ### Verbindungsdaten eingeben [#verbindungsdaten-eingeben]

    Tragen Sie **Server** und **Port** von der Seite ein und als **Database** den auf der Seite angezeigten Datenbanknamen. Setzen Sie **Authentication** auf Benutzername und Passwort und schalten Sie **Require SSL** ein.
  </Step>

  <Step>
    ### Live oder Extrakt wählen [#live-oder-extrakt-wählen]

    Wählen Sie eine **Live**-Verbindung, um bei jeder Ansicht die Datenbank zu lesen, oder **Extract** für eine geplante Kopie.
  </Step>

  <Step>
    ### Views hinzufügen [#views-hinzufügen]

    Wählen Sie unter **Schema** den Eintrag `bi` und ziehen Sie die `<dataset>_v<version>`-Views auf die Arbeitsfläche.
  </Step>
</Steps>

Erhält ein Datensatz eine neue Version (`_v2`), stellen Sie den Bericht auf die neue View um. Die alte funktioniert weiter, bis das Reporting sie zurückzieht.

## 6. Für Systemadministratoren [#6-für-systemadministratoren]

* Zugelassen werden nur die von der Installation erlaubten Netze, nur über TLS und nur BI-Anmeldungen. Jede andere BI-Verbindung wird abgewiesen.
* Den Datenbankport für die BI-Netze zu öffnen, ist Aufgabe Ihres Netzwerkteams.

## Häufige Fragen [#häufige-fragen]

<Accordions type="single">
  <Accordion title="Ich habe das Passwort verloren. Was tun?">
    Klicken Sie auf der Karte auf **Rotate password**. Das neue Passwort wird einmal angezeigt; das alte funktioniert ab der nächsten Anwendung nicht mehr.
  </Accordion>

  <Accordion title="Warum kann sich mein Werkzeug direkt nach der Einrichtung nicht verbinden?">
    Die Karte zeigt zunächst **Waiting to be applied**. Innerhalb weniger Minuten wechselt sie auf **Active**; ab dann kann sich das Werkzeug verbinden.
  </Accordion>

  <Accordion title="Kann das BI-Werkzeug Daten ändern?">
    Nein. Die Anmeldung sieht nur die für sie geöffneten Views und kann nichts ändern.
  </Accordion>

  <Accordion title="Warum wurde meine Abfrage gestoppt?">
    Eine Abfrage darf höchstens einige Minuten laufen. Grenzen Sie den Filter ein oder verdichten Sie das Visual, etwa nach Monat oder Team.
  </Accordion>

  <Accordion title="Was passiert, wenn ein Datensatz eine neue Version erhält?">
    Eine neue View wie `_v2` erscheint. Stellen Sie den Bericht darauf um; die alte View funktioniert weiter, bis das Reporting sie zurückzieht.
  </Accordion>
</Accordions>

## Verwandte Seiten [#verwandte-seiten]

* [BI-Datensätze](/de/connections/bi-datasets)
* [Berichte](/de/product-guide/reports)