

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Abfragen mit dem Analysis Builder
<a name="query-data-analysis-builder"></a>

Sie können den Analysis Builder verwenden, um Abfragen zu erstellen, ohne SQL-Code schreiben zu müssen. Mit dem Analysis Builder können Sie eine Abfrage für eine Kollaboration erstellen, die Folgendes bietet:
+ Eine einzelne Tabelle, die die [Aggregationsanalyseregel](analysis-rules-aggregation.md) verwendet, ohne dass JOIN erforderlich ist
+ Zwei Tabellen (eine von jedem Mitglied), die beide die [Aggregationsanalyseregel](glossary.md#glossary-agg-analysis-rule) verwenden
+ Zwei Tabellen (eine für jedes Mitglied), die beide die [Listenanalyseregel](glossary.md#glossary-list-analysis-rule) verwenden
+ Zwei Tabellen (eine für jedes Mitglied), die beide die Aggregationsanalyseregel verwenden, und zwei Tabellen (eine für jedes Mitglied), die beide die Listenanalyseregel verwenden

Wenn Sie SQL-Abfragen manuell schreiben möchten, finden Sie weitere Informationen unter[Abfragen konfigurierter Tabellen mit dem SQL-Code-Editor](use-sql-editor.md).

Der Analysis Builder wird in der AWS Clean Rooms Konsole auf der Registerkarte **Analyse im Abschnitt Analyse** als **Benutzeroberflächenoption für **Analysis** Builder** angezeigt. 

**Wichtig**  
Wenn Sie die **Analysis Builder-Benutzeroberfläche** aktivieren, mit der Erstellung einer Abfrage im Analysis Builder beginnen und dann die **Analysis Builder-Benutzeroberfläche** ausschalten, wird Ihre Abfrage nicht gespeichert.

**Tipp**  
Wenn während der Ausführung einer Abfrage eine geplante Wartung stattfindet, wird die Abfrage beendet und ein Rollback durchgeführt. Sie müssen die Abfrage neu starten. 

In den folgenden Themen wird die Verwendung des Analysis Builder erläutert.

**Topics**
+ [Verwenden Sie den Analysis Builder, um eine einzelne Tabelle abzufragen (Aggregation)](#use-analysis-builder-one-table)
+ [Verwenden Sie den Analysis Builder, um zwei Tabellen (Aggregation oder Liste) abzufragen](#use-analysis-builder-two-tables)

## Verwenden Sie den Analysis Builder, um eine einzelne Tabelle abzufragen (Aggregation)
<a name="use-analysis-builder-one-table"></a>

Dieses Verfahren zeigt, wie Sie die **Analysis Builder-Benutzeroberfläche** in der AWS Clean Rooms Konsole verwenden, um eine Abfrage zu erstellen. Die Abfrage ist für eine Kollaboration vorgesehen, die über eine einzelne Tabelle verfügt, die die [Aggregationsanalyseregel](analysis-rules-aggregation.md) verwendet, ohne dass JOIN dies erforderlich ist.

**Um den Analysis Builder für die Abfrage einer einzelnen Tabelle zu verwenden**

Melden Sie sich bei [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) an AWS-Managementkonsole und öffnen Sie die AWS Clean Rooms Konsole.

1. **Wählen Sie im linken Navigationsbereich Collaborations aus.**

1. Wählen Sie die Kollaboration aus, für die der Status **Ihrer Mitgliederfähigkeiten** den Status **Abfragen ausführen lautet**.

1. Sehen Sie sich auf der Registerkarte **Analyse** unter **Tabellen** die Tabelle und den zugehörigen Analyseregeltyp an. (Der Analyseregeltyp sollte die **Aggregationsanalyseregel** sein.)
**Anmerkung**  
Wenn Sie die erwartete Tabelle nicht sehen, kann das folgende Gründe haben:  
Die Tabelle wurde nicht [verknüpft](associate-configured-table.md).
Für die Tabelle ist keine [Analyseregel konfiguriert](add-analysis-rule.md).

1. Aktivieren Sie im Abschnitt **Analyse** die **Benutzeroberfläche von Analysis Builder**.

1. Erstellen Sie eine Abfrage.

   Wenn Sie alle Aggregationsmetriken sehen möchten, fahren Sie mit Schritt 9 fort.

   1. Überprüfen Sie unter **Metriken auswählen** die aggregierten Metriken, die standardmäßig vorausgewählt wurden, und entfernen Sie bei Bedarf alle Metriken.

   1. (Optional) Wählen **Sie unter Segmente hinzufügen — optional** einen oder mehrere Parameter aus.
**Anmerkung**  
**Segmente hinzufügen — optional** wird nur angezeigt, wenn Dimensionen für die Tabelle angegeben sind.

   1. (Optional) Wählen **Sie unter Filter hinzufügen — optional** die Option **Filter hinzufügen** und wählen Sie dann einen **Parameter**, einen Operator und einen **Wert** aus. 

      Um weitere Filter hinzuzufügen, wählen Sie „**Weiteren Filter hinzufügen**“. 

      Um einen Filter zu entfernen, wählen Sie **Entfernen**.
**Anmerkung**  
ORDER BYwird für Aggregationsabfragen nicht unterstützt.  
Nur der AND Operator wird in Filtern unterstützt.

   1. (Optional) Geben **Sie unter Beschreibung hinzufügen — optional** eine Beschreibung ein, um die Abfrage in der Abfrageliste leichter identifizieren zu können.

1. Erweitern Sie **Vorschau-SQL-Code**.

   1. Zeigen Sie den SQL-Code an, der mit dem Analysis Builder generiert wurde.

   1. Um den SQL-Code zu kopieren, wählen Sie **Kopieren**.

   1. Um den SQL-Code zu bearbeiten, wählen Sie **Im SQL-Code-Editor bearbeiten**.

1. Klicken Sie auf **Ausführen**.
**Anmerkung**  
Sie können die Abfrage nicht ausführen, wenn das Mitglied, das Ergebnisse empfangen kann, die Einstellungen für die Abfrageergebnisse nicht konfiguriert hat.

1. Passen Sie die Parameter weiter an und führen Sie Ihre Abfrage erneut aus, oder klicken Sie auf die Schaltfläche **\$1**, um eine neue Abfrage auf einer neuen Registerkarte zu starten.

**Anmerkung**  
AWS Clean Rooms zielt darauf ab, klare Fehlermeldungen bereitzustellen. Wenn eine Fehlermeldung nicht genügend Details enthält, um Ihnen bei der Fehlerbehebung zu helfen, wenden Sie sich an das Account-Team. Geben Sie ihnen eine Beschreibung, wie der Fehler aufgetreten ist, und geben Sie ihnen die Fehlermeldung (einschließlich aller Identifikatoren). Weitere Informationen finden Sie unter [Problembehebung AWS Clean Rooms](troubleshooting.md).

## Verwenden Sie den Analysis Builder, um zwei Tabellen (Aggregation oder Liste) abzufragen
<a name="use-analysis-builder-two-tables"></a>

In diesem Verfahren wird beschrieben, wie Sie den Analysis Builder in der AWS Clean Rooms Konsole verwenden, um eine Abfrage für eine Kollaboration zu erstellen, die:
+ Zwei Tabellen (eine für jedes Mitglied), die beide die [Aggregationsanalyseregel](analysis-rules-aggregation.md) verwenden
+ Zwei Tabellen (eine für jedes Mitglied), die beide die [Listenanalyseregel](analysis-rules-list.md) verwenden
+ Zwei Tabellen (eine für jedes Mitglied), die beide die Aggregationsanalyseregel verwenden, und zwei Tabellen (eine für jedes Mitglied), die beide die Listenanalyseregel verwenden

**So verwenden Sie den Analysis Builder, um zwei Tabellen abzufragen**

Melden Sie sich bei [https://console.aws.amazon.com/cleanrooms](https://console.aws.amazon.com/cleanrooms/home) an AWS-Managementkonsole und öffnen Sie die AWS Clean Rooms Konsole.

1. **Wählen Sie im linken Navigationsbereich Collaborations aus.**

1. Wählen Sie die Kollaboration aus, deren Status **Ihre Mitgliederfähigkeiten** den Status **Abfragen ausführen lautet**.

1. Sehen Sie sich auf der Registerkarte **Analyse** unter **Tabellen** die beiden Tabellen und den zugehörigen Analyseregeltyp an (**Aggregationsanalyseregel oder **Listenanalyseregel****).
**Anmerkung**  
Wenn Sie die erwarteten Tabellen nicht in der Liste sehen, kann das folgende Gründe haben:  
Die Tabellen wurden nicht [verknüpft](associate-configured-table.md).
Für die Tabellen ist keine [Analyseregel konfiguriert](add-analysis-rule.md).

1. Aktivieren Sie im Abschnitt **Analyse** die **Benutzeroberfläche von Analysis Builder**.

1. Erstellen Sie eine Abfrage.

   Wenn die Kollaboration zwei Tabellen enthält, die die **Aggregationsanalyseregel** verwenden, und zwei Tabellen, die die **Analyseregel „Liste**“ verwenden, wählen Sie zuerst **Aggregation** oder **Liste** aus, und folgen Sie dann den Anweisungen, die auf der ausgewählten Analyseregel basieren.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/clean-rooms/latest/userguide/query-data-analysis-builder.html)

1. Erweitern Sie **Vorschau-SQL-Code**.

   1. Zeigen Sie den SQL-Code an, der mit dem Analysis Builder generiert wurde.

   1. Um den SQL-Code zu kopieren, wählen Sie **Kopieren**.

   1. Um den SQL-Code zu bearbeiten, wählen Sie **Im SQL-Code-Editor bearbeiten**.

1. Klicken Sie auf **Ausführen**.
**Anmerkung**  
Sie können die Abfrage nicht ausführen, wenn das Mitglied, das Ergebnisse empfangen kann, die Einstellungen für die Abfrageergebnisse nicht konfiguriert hat

1. Passen Sie die Parameter weiter an und führen Sie Ihre Abfrage erneut aus, oder klicken Sie auf die Schaltfläche **\$1**, um eine neue Abfrage auf einer neuen Registerkarte zu starten.

**Anmerkung**  
AWS Clean Rooms zielt darauf ab, klare Fehlermeldungen bereitzustellen. Wenn eine Fehlermeldung nicht genügend Details enthält, um Ihnen bei der Fehlerbehebung zu helfen, wenden Sie sich an das Account-Team. Geben Sie ihnen eine Beschreibung, wie der Fehler aufgetreten ist, und geben Sie ihnen die Fehlermeldung (einschließlich aller Identifikatoren). Weitere Informationen finden Sie unter [Problembehebung AWS Clean Rooms](troubleshooting.md).