Abfragen mit dem Analysis Builder

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 verwendet, ohne dass JOIN erforderlich ist

• Zwei Tabellen (eine von jedem Mitglied), die beide die Aggregationsanalyseregel verwenden

• Zwei Tabellen (eine für jedes Mitglied), die beide die Listenanalyseregel 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 unterAbfragen konfigurierter Tabellen mit dem SQL-Code-Editor.

Der Analysis Builder wird als Benutzeroberflächenoption für Analysis Builder im Abschnitt Analyse auf der Registerkarte Abfragen in der AWS Clean Rooms Konsole 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.

Verwenden Sie den Analysis Builder, um eine einzelne Tabelle abzufragen (Aggregation)

Dieses Verfahren zeigt, wie Sie die Analysis Builder-Benutzeroberfläche in der AWS Clean Rooms Konsole verwenden, um eine Abfrage zu erstellen. Die Abfrage bezieht sich auf eine Kollaboration mit einer einzelnen Tabelle, die die Aggregationsanalyseregel ohne JOIN erforderlich.

Um den Analysis Builder zum Abfragen einer einzelnen Tabelle zu verwenden

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

   • Für die Tabelle ist keine Analyseregel konfiguriert.

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

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

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

   3. (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 BY wird für Aggregationsabfragen nicht unterstützt.

      Nur der AND Operator wird in Filtern unterstützt.

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

7. Erweitern Sie Vorschau-SQL-Code.

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

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

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

8. Wählen Sie Ausführen aus.

   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.

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

Verwenden Sie den Analysis Builder, um zwei Tabellen (Aggregation oder Liste) abzufragen

Dieses Verfahren beschreibt, 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 verwenden

• Zwei Tabellen (eine für jedes Mitglied), die beide die Listenanalyseregel 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

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

   • Für die Tabellen ist keine Analyseregel konfiguriert.

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

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

   Wenn die beiden Tabellen die Aggregationsanalyseregel verwenden

   Wenn die beiden Tabellen die Listenanalyseregel verwenden

   Überprüfen Sie unter Metriken auswählen die aggregierten Metriken, die standardmäßig vorausgewählt wurden, und entfernen Sie bei Bedarf alle Metriken. Wählen Sie für Datensätze zuordnen einen oder mehrere Datensätze aus. Anmerkung Wenn Sie den Analysegenerator verwenden, können Sie nur für ein einzelnes Spaltenpaar einen Abgleich durchführen. (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. (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 aus. Um einen Filter zu entfernen, wählen Sie Entfernen. Anmerkung ORDER BY wird für Aggregationsabfragen nicht unterstützt. Nur der AND Operator wird in Filtern unterstützt. (Optional) Geben Sie unter Beschreibung hinzufügen — optional eine Beschreibung ein, um die Abfrage in der Liste der letzten Abfragen leichter identifizieren zu können.

   Überprüfen Sie unter Attribute auswählen die Listenattribute, die standardmäßig vorausgewählt wurden, und entfernen Sie bei Bedarf alle Metriken. Wählen Sie für Datensätze zuordnen einen oder mehrere Datensätze aus. Anmerkung Wenn Sie den Analysegenerator verwenden, können Sie nur für ein einzelnes Spaltenpaar einen Abgleich durchführen. (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 aus. Um einen Filter zu entfernen, wählen Sie Entfernen. Anmerkung LIMIT wird für Listenabfragen nicht unterstützt. Nur der AND Operator wird in Filtern unterstützt. (Optional) Geben Sie unter Beschreibung hinzufügen — optional eine Beschreibung ein, um die Abfrage in der Liste der letzten Abfragen leichter identifizieren zu können.

7. Erweitern Sie Vorschau-SQL-Code.

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

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

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

8. Wählen Sie Ausführen aus.

   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

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