> For the complete documentation index, see [llms.txt](https://docs.polyteia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.polyteia.com/web/auswertungen/verknuepfungen/verknuepfen-in-auswertungen.md).

# Verknüpfen in Auswertungen

Datensätze im Auswertungs-Editor Schritt für Schritt verknüpfen.

Beim Verknüpfen verbinden Sie zwei Datensätze über eine gemeinsame Spalte, den **Verknüpfungsschlüssel**. Das ist typischerweise eine Spalte wie ein Name, eine ID oder ein Bezirksschlüssel.

Wenn Sie mit dem Konzept noch nicht vertraut sind, lesen Sie zuerst die [Grundlagen](/web/auswertungen/verknuepfungen/grundlagen.md).

## Wie der Abgleich funktioniert

Standardmäßig gleicht die Plattform Spalten mit **gleichem Namen** automatisch ab (ein natürlicher Abgleich):

* Spalten, die in beiden Datensätzen gleich heißen, werden als Verknüpfungsschlüssel verwendet.
* Gibt es mehrere gleichnamige Spalten, dienen sie alle gemeinsam als Schlüssel.
* Heißen die Schlüsselspalten unterschiedlich, legen Sie die Zuordnung über eine **Bedingung** selbst fest.

## Die fünf Verknüpfungstypen

Den Verknüpfungstyp wählen Sie im Editor über ein Auswahlfeld neben dem verknüpften Datensatz:

* **Innere Verknüpfung** – behält nur Zeilen, die in beiden Datensätzen übereinstimmen (Standard)
* **Linke Verknüpfung** – behält alle Zeilen des linken Datensatzes und die passenden aus dem rechten
* **Rechte Verknüpfung** – behält alle Zeilen des rechten Datensatzes und die passenden aus dem linken
* **Vollständige Verknüpfung** – behält alle Zeilen aus beiden Datensätzen
* **Erweitern** – legt die Spalten beider Datensätze nebeneinander, ohne die Werte abzugleichen

Jeder Typ ist mit Beispieltabellen in den [Grundlagen](/web/auswertungen/verknuepfungen/grundlagen.md) erklärt.

{% hint style="info" %}
**Erweitern** nutzt keinen Verknüpfungsschlüssel. Deshalb entfällt hier der Schritt mit den Bedingungen. Verwenden Sie es nur, wenn beide Datensätze dieselbe Zeilenreihenfolge haben.
{% endhint %}

## Wo finde ich das Verknüpfen?

Datensätze verknüpfen Sie im **Auswertungs-Editor**, im Baukasten des Reiters **Daten**. Ganz oben im rechten Bereich liegt der Abschnitt **Datensatz**. Dort wählen Sie zuerst Ihren Hauptdatensatz und fügen anschließend weitere hinzu.

Die Schaltfläche ist dieselbe und ändert nur ihre Beschriftung:

* Noch kein Datensatz gewählt → sie heißt **+ Datensatz auswählen**.
* Sobald ein Datensatz gewählt ist → sie heißt **+ Datensatz verknüpfen** und erscheint direkt darunter.

## Schritt für Schritt

Die folgenden Schritte setzen voraus, dass Sie bereits im **Auswertungs-Editor** sind. Falls nicht, zeigt [Auswertung erstellen](/web/auswertungen/auswertung-erstellen.md), wie Sie dorthin kommen.

Als Beispiel kombinieren wir zwei Datensätze: **Schulen** (mit Bezirk und Schülerzahl) und **Ausstattung** (mit Bezirk und Anzahl barrierefreier Standorte). Ziel ist eine gemeinsame Tabelle je Bezirk.

{% hint style="info" %}
Sie brauchen Zugriff auf alle Datensätze, die Sie verknüpfen möchten. Als **Mitbearbeiter** oder **Administrator** einer Lösung ist das bei allen Datensätzen der Lösung der Fall.
{% endhint %}

{% stepper %}
{% step %}
**Basisdatensatz wählen**

Klicken Sie im Reiter **Daten** im Abschnitt **Datensatz** auf **+ Datensatz auswählen** und wählen Sie **Schulen**. In der Verknüpfungslogik ist das der „linke" Datensatz.
{% endstep %}

{% step %}
**Datensatz verknüpfen**

Klicken Sie nun auf **+ Datensatz verknüpfen** (direkt unter dem gewählten Datensatz) und wählen Sie **Ausstattung**. Dieser Datensatz ist der „rechte" Datensatz.
{% endstep %}

{% step %}
**Verknüpfungstyp festlegen**

Wählen Sie im Auswahlfeld neben dem Datensatz den Typ. Standard ist die **Innere Verknüpfung**. Für eine vollständige Bezirksliste wählen Sie zum Beispiel **Linke Verknüpfung**, um alle Schulen zu behalten, auch wenn zu einem Bezirk keine Ausstattungsdaten vorliegen.
{% endstep %}

{% step %}
**Verknüpfungsschlüssel prüfen**

Heißt die Spalte in beiden Datensätzen **Bezirk**, wird sie automatisch abgeglichen. Sie müssen nichts weiter tun.

Heißen die Spalten unterschiedlich (zum Beispiel **Bezirk** und **Bezirksname**), klicken Sie auf die **···**-Schaltfläche am verknüpften Datensatz. Es öffnet sich ein Fenster mit dem Abschnitt **Bedingungen**. Klicken Sie dort auf **Bedingung hinzufügen** und ordnen Sie die beiden Spalten einander zu.
{% endstep %}

{% step %}
**Ergebnis in der Vorschau prüfen**

Klicken Sie auf **Ausführen**. Sie sehen eine gemeinsame Tabelle mit den Spalten aus beiden Datensätzen. Wo es keine Übereinstimmung gab, stehen leere Felder (**null**).
{% endstep %}

{% step %}
**Auswertung fortsetzen**

Jetzt können Sie die verknüpften Daten wie gewohnt weiterverarbeiten: Spalten auswählen, aggregieren, filtern oder als Diagramm darstellen.
{% endstep %}
{% endstepper %}

## Tipps für die Arbeit mit Verknüpfungen

* **Gleiche Spaltennamen erleichtern den Abgleich**: Heißen die Schlüsselspalten in beiden Datensätzen gleich, verknüpft die Plattform sie automatisch. Bei unterschiedlichen Namen legen Sie eine **Bedingung** an.
* **Null-Werte lesen**: Ein leeres Feld im Ergebnis bedeutet, dass es im anderen Datensatz keine passende Zeile gab.
* **Mehr als zwei Datensätze**: Sie können nacheinander mehrere Datensätze verknüpfen, nicht nur zwei.
* **Erweitern mit Bedacht einsetzen**: Erweitern gleicht die Werte nicht ab, sondern legt die Zeilen nur nebeneinander. Nutzen Sie es nur bei gleicher Zeilenreihenfolge.

So reichern Sie mit wenigen Klicks einen Datensatz um Daten aus einem anderen an, ganz ohne SQL.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.polyteia.com/web/auswertungen/verknuepfungen/verknuepfen-in-auswertungen.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
