Abfragen konfigurierter Tabellen mit dem SQL Code-Editor

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 Abfragen 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 unterAbfragen mit dem Analysis Builder.

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 im AWS Clean Rooms SQL-Leitfaden.

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 der an AWS Management Console und öffnen Sie die AWS Clean Rooms Konsole mit Ihrem AWS-Konto (falls Sie dies noch nicht getan haben).

2. Wählen Sie im linken Navigationsbereich Collaborations aus.

3. Wählen Sie die Kollaboration aus, deren Status „Ihre Mitgliederfähigkeiten“ auf „Anfrage“ gesetzt ist.

4. Gehen Sie auf der Registerkarte Abfragen zum Abschnitt Analyse.

   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.

5. Sehen Sie sich auf der Registerkarte Abfragen 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.

   • Für die Tabellen ist keine Analyseregel konfiguriert.

6. (Optional) Um das Schema und die Analyseregelsteuerelemente der Tabelle anzuzeigen, erweitern Sie die Tabelle, indem Sie das Pluszeichen (+) auswählen.

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

   Weitere Informationen zu den unterstützten SQL Befehlen und Funktionen finden Sie in der AWS Clean Rooms SQLReferenz.

   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.

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

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

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

   3. Um eine Funktion, die für eine Spalte zulässig ist, manuell einzufügen, wählen Sie die drei vertikalen Punkte neben einer Spalte aus, wählen Sie In Editor einfügen und wählen Sie dann den Namen der zulässigen Funktion aus (z. B. INNER JOIN, SUM, SUM DISTINCT, oder COUNT).

   4. Drücken Sie Strg + 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.

   5. Bearbeiten Sie die Platzhalterwerte in der Abfrage.

8. (Nur Spark Analytics Engine) Geben Sie den unterstützten Worker-Typ und die Anzahl der Worker an.

   Verwenden Sie die folgende Tabelle, um den Typ und die Anzahl der Mitarbeiter zu ermitteln, die Sie für Ihren Anwendungsfall benötigen.

   Anmerkung

   Verschiedene Arten von Arbeitskräften und deren Anzahl sind mit Kosten verbunden. Weitere Informationen zu den Preisen finden Sie unter AWS Clean Rooms Preisgestaltung.

   Worker type (Worker-Typ)	v CPU	Speicher (GB)	Speicher (GB)	Number of workers (Anzahl der Worker)	Gesamtzahl der Verarbeitungseinheiten für Reinräume (CRPU)
   CR.1X (Standard)	4	30	100	2	4
   				16 (Standard)	32
   CR.4X	16	120	400	8	64
   				32	256

9. Geben Sie unter Ergebnisse senden an an an, wer Ergebnisse erhalten kann.

10. (Nur Query Runner) Wenn Sie andere Ergebniseinstellungen für diese Abfrage angeben möchten, wählen Sie unter Ergebnisse senden an in der Dropdownliste die Option Ergebniseinstellungen überschreiben aus. Wählen Sie dann das Ergebnisformat, die Ergebnisdateien und das Ergebnisziel in Amazon S3 aus.

11. Wählen Sie Ausführen aus.

    Anmerkung

    Sie können die Abfrage nicht ausführen, wenn das Mitglied, das Ergebnisse erhalten kann, die Einstellungen für die Abfrageergebnisse nicht konfiguriert hat.

12. Die Ergebnisse anzeigen.

    Weitere Informationen finden Sie unter Empfangen und Verwenden von Abfrageergebnissen.

13. Passen Sie die Parameter weiter an und führen Sie Ihre Abfrage erneut aus, oder klicken Sie auf die Schaltfläche +, 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.