

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 konfigurierter Tabellen mit dem SQL-Code-Editor
<a name="use-sql-editor"></a>

Als Mitglied, das Abfragen durchführen kann, können Sie eine Abfrage manuell erstellen, indem Sie SQL-Code in den SQL-Code-Editor schreiben. **Der SQL-Code-Editor befindet sich in der AWS Clean Rooms Konsole auf der Registerkarte **Analyse** im Abschnitt Analyse.** 

Der SQL-Code-Editor wird standardmäßig angezeigt. Wenn Sie den Analysis Builder zum Erstellen von Abfragen verwenden möchten, finden Sie weitere Informationen unter[Abfragen mit dem Analysis Builder](query-data-analysis-builder.md). 

**Wichtig**  
Wenn Sie mit dem Schreiben einer SQL-Abfrage im Code-Editor beginnen und dann die **Analysis Builder-Benutzeroberfläche** einschalten, wird Ihre Abfrage nicht gespeichert.

AWS Clean Rooms unterstützt viele SQL-Befehle, Funktionen und Bedingungen. Weitere Informationen finden Sie in der [AWS Clean Rooms SQL-Referenz](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html). 

**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. 

**Um konfigurierte Tabellen mit dem SQL-Code-Editor abzufragen**

1. 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 Liste der Tabellen und den zugehörigen Analyseregeltyp an (**Aggregationsanalyseregel**, **Listenanalyseregel** oder **Benutzerdefinierte Analyseregel**).
**Anmerkung**  
Wenn Sie die erwarteten Tabellen in der Liste nicht 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. (Optional) Um das Schema und die Analyseregelsteuerelemente der Tabelle anzuzeigen, erweitern Sie die Tabelle, indem Sie das Pluszeichen (**\$1**) auswählen.

1. Wählen Sie im Abschnitt **Analyse** für den **Analysemodus** die Option **SQL-Code schreiben** aus.
**Anmerkung**  
Im Abschnitt **Analyse** wird nur angezeigt, ob das Mitglied, das Ergebnisse erhalten kann, und das Mitglied, das für die Bezahlung der Abfrage-Rechenkosten verantwortlich ist, der Kollaboration als aktives Mitglied beigetreten sind.

1. Erstellen Sie die Abfrage, indem Sie die Abfrage in den SQL-Code-Editor eingeben.

   Weitere Informationen zu unterstützten SQL-Befehlen und -Funktionen finden Sie in der [AWS Clean Rooms SQL-Referenz.](https://docs.aws.amazon.com/clean-rooms/latest/sql-reference/sql-reference.html) 

   Sie können auch die folgenden Optionen verwenden, um Ihre Abfrage zu erstellen.

------
#### [ Use an example query ]

   Um eine Beispielabfrage zu verwenden

   1. Wählen Sie die drei vertikalen Punkte neben der Tabelle aus.

   1. Wählen **Sie unter In Editor einfügen** die Option **Beispielabfrage** aus.
**Anmerkung**  
Wenn Sie eine **Beispielabfrage einfügen, wird sie an die Abfrage** angehängt, die sich bereits im Editor befindet.

      Das Abfragebeispiel wird angezeigt. Alle unter Tabellen aufgeführten **Tabellen** sind in der Abfrage enthalten. 

   1. Bearbeiten Sie die Platzhalterwerte in der Abfrage.

------
#### [ Insert column names or functions ]

   Um einen Spaltennamen oder eine Funktion einzufügen

   1. Wählen Sie die drei vertikalen Punkte neben einer Spalte aus.

   1. Wählen **Sie unter In Editor einfügen** die Option **Spaltenname** aus.

   1. Um eine Funktion, die für eine Spalte zulässig ist, manuell einzufügen, 

      1. Wählen Sie die drei vertikalen Punkte neben einer Spalte aus.

      1. Wählen Sie **In Editor einfügen** aus.

      1. Wählen Sie den Namen der zulässigen Funktion aus (z. B. INNER JOINSUM,SUM DISTINCT, oderCOUNT).

   1. Drücken Sie **Strg** \$1 **Leertaste**, um die Tabellenschemas im Code-Editor anzuzeigen.
**Anmerkung**  
Mitglieder, die Abfragen durchführen können, können die Partitionsspalten in jeder konfigurierten Tabellenverknüpfung anzeigen und verwenden. Stellen Sie sicher, dass die Partitionsspalte in der AWS Glue Tabelle, die der konfigurierten Tabelle zugrunde liegt, als Partitionsspalte gekennzeichnet ist.

   1. Bearbeiten Sie die Platzhalterwerte in der Abfrage.

------

1. Geben Sie den unterstützten **Arbeitertyp** und die **Anzahl der Mitarbeiter an**. 

   Sie können den Instanztyp und die Anzahl der Instanzen (Worker) wählen, um Ihre SQL-Abfragen auszuführen. 

   Für CR.1X können Sie bis zu 128 Worker oder mindestens 4 Worker auswählen. 

   Für CR.4X können Sie bis zu 32 Arbeiter oder mindestens 4 Arbeiter auswählen. 

   Ermitteln Sie anhand der folgenden Tabelle den Typ und die Anzahl der Mitarbeiter, die Sie für Ihren Anwendungsfall benötigen.    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/clean-rooms/latest/userguide/use-sql-editor.html)
**Anmerkung**  
Verschiedene Arten von Arbeitnehmern und die Anzahl der Arbeitnehmer sind mit Kosten verbunden. Weitere Informationen zu den Preisen finden Sie unter [AWS Clean Rooms Preisgestaltung](https://aws.amazon.com/clean-rooms/pricing/).

1. Geben **Sie unter Ergebnisse senden** an an an, wer Ergebnisse erhalten kann. 
**Anmerkung**  
Um Ergebnisse zu erhalten, muss das Kollaborationsmitglied als Empfänger von Ergebnissen konfiguriert sein und ein aktiver Teilnehmer an der Kollaboration sein (**Status: Aktiv**)

1. (Mitglied, das nur Abfragen durchführen kann) Das Kontrollkästchen **Verwenden Sie Ihre Standardergebniseinstellungen** ist standardmäßig aktiviert. Lassen Sie dieses Kontrollkästchen aktiviert, wenn Sie Ihre Standardergebniseinstellungen beibehalten möchten.

   Wenn Sie andere Ergebniseinstellungen für diese Abfrage angeben möchten, deaktivieren Sie das Kontrollkästchen **Verwenden Sie Ihre Standardergebniseinstellungen**, und wählen Sie dann Folgendes aus. 

   1. **Ergebnisformat** (**CSV** oder **PARQUET**)

   1. **Ergebnisdateien** (**einzeln** oder **mehrfach**)

   1. **Ziel der Ergebnisse in Amazon S3**

   Jedes Mitglied, das Ergebnisse erhalten kann, kann **in Amazon S3 ein anderes **Ergebnisformat****, andere Ergebnisdateien** und ein anderes Ergebnisziel** angeben.

1. So geben Sie **Spark-Eigenschaften** an:

   1. Erweitern Sie **Spark-Eigenschaften**.

   1. Wählen Sie **Spark-Eigenschaften hinzufügen**.

   1. Wählen Sie im Dialogfeld „**Spark-Eigenschaften**“ einen **Eigenschaftsnamen** aus der Dropdownliste aus und geben Sie einen **Wert** ein.

   Die folgende Tabelle enthält eine Definition für jede Eigenschaft.

   Weitere Informationen zu Spark-Eigenschaften finden Sie unter [Spark-Eigenschaften](https://spark.apache.org/docs/latest/configuration.html#spark-properties) in der Apache Spark-Dokumentation.     
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/clean-rooms/latest/userguide/use-sql-editor.html)

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. Die **Ergebnisse** anzeigen. 

   Weitere Informationen finden Sie unter [Empfangen und Verwenden von Analyseergebnissen](receive-query-results.md).

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).