Anfragen im Abfrage-Builder erstellen

Erfahren Sie, wie Sie den Abfrage-Builder verwenden, um Berichte mit Braze-Daten in Snowflake zu erstellen. Der Abfrage-Builder enthält vorgefertigte SQL-Anfragen-Templates, die Ihnen den Einstieg erleichtern. Sie können aber auch Ihre eigenen angepassten SQL-Anfragen schreiben, um noch mehr Insights zu gewinnen.

Voraussetzungen

Um den Abfrage-Builder zu verwenden, benötigen Sie die folgenden Berechtigungen auf Workspace-Ebene:

Den Abfrage-Builder verwenden

Schritt 1: Eine SQL-Abfrage erstellen

Um eine neue Abfrage zu erstellen, gehen Sie zu Analytics > Abfrage-Builder und wählen Sie dann SQL-Abfrage erstellen aus.

Wenn Sie Inspiration oder Hilfe beim Erstellen Ihrer Abfrage benötigen, wählen Sie Abfrage-Template und dann ein vorgefertigtes Template aus. Um mit einer leeren Abfrage zu beginnen, wählen Sie SQL-Editor aus.

Ihr Bericht erhält automatisch einen Namen mit dem aktuellen Datum und der aktuellen Uhrzeit. Bewegen Sie den Mauszeiger über den Namen und wählen Sie aus, um Ihrer SQL-Abfrage einen aussagekräftigen Namen zu geben.

Schritt 2: Ihre Abfrage erstellen

Beim Erstellen Ihrer Abfrage können Sie sich von KI unterstützen lassen oder die Abfrage selbst schreiben.

• mit operator
• eigenständig

Hinweis

Dieses Feature ist jetzt Teil von BrazeAI^TM Operator, dem einheitlichen KI-Assistenten von Braze. KI-Funktionen, die zuvor als eigenständige Assistenten verfügbar waren, sind jetzt alle über Operator zugänglich – direkt dort, wo Sie bereits im Dashboard arbeiten.

Wählen Sie im Seitenpanel des Abfrage-Builders Operator fragen aus und beschreiben Sie die gewünschten Daten. Operator schreibt SQL für die verfügbaren Snowflake-Datentabellen. Sie können das SQL überprüfen und eine Vorschau der Ergebnisse anzeigen, bevor Sie Ihren Bericht ausführen. Um Operator im Abfrage-Builder zu verwenden, benötigen Sie die Berechtigung „Dashboard-Berichte bearbeiten“.

Generiertes SQL muss denselben Regeln für das Schreiben von SQL entsprechen wie Abfragen, die Sie selbst schreiben. Weitere Informationen finden Sie unter Was Sie mit Operator tun können. Wie Operator mit Ihren Daten umgeht, erfahren Sie unter Datenschutz und Sicherheit bei Operator.

Schreiben Sie Ihre SQL-Abfrage mit der Snowflake-Syntax. In der Tabellenreferenz finden Sie eine vollständige Liste der Tabellen und Spalten, die abgefragt werden können.

So zeigen Sie Tabellendetails im Abfrage-Builder an:

1. Öffnen Sie auf der Seite Abfrage-Builder das Panel Referenz und wählen Sie Verfügbare Datentabellen aus, um die verfügbaren Datentabellen und deren Namen anzuzeigen.
2. Wählen Sie Details anzeigen aus, um die Tabellenbeschreibung und Informationen zu den Tabellenspalten, wie etwa Datentypen, anzuzeigen.
3. Um den Tabellennamen in Ihr SQL einzufügen, wählen Sie aus.

Wenn Sie Ihre Abfrage auf einen bestimmten Zeitraum beschränken, erhalten Sie schneller Ergebnisse. Die folgende Beispielabfrage ermittelt die Anzahl der Käufe und den generierten Umsatz der letzten Stunde.

1
2
3

SELECT COUNT(*) as Purchases, SUM(price) as Revenue
FROM USERS_BEHAVIORS_PURCHASE_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('hour', -1, date_trunc('day',CURRENT_DATE()));

Diese Abfrage ermittelt die Anzahl der E-Mail-Sendungen im letzten Monat:

1
2
3

SELECT COUNT(*) as Sends
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('month', -1, date_trunc('day',CURRENT_DATE()));

Wenn Sie CANVAS_ID, CANVAS_VARIATION_API_ID oder CAMPAIGN_ID abfragen, werden die zugehörigen Namensspalten automatisch in die Ergebnistabelle aufgenommen. Sie müssen diese nicht in die SELECT-Abfrage selbst aufnehmen.

ID-Name	Zugehörige Namensspalte
CANVAS_ID	Canvas-Name
CANVAS_VARIATION_API_ID	Name der Canvas-Variante
CAMPAIGN_ID	Campaign-Name

Diese Abfrage ermittelt alle drei IDs und die zugehörigen Namensspalten mit maximal 100 Zeilen:

1
2
3

SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100

Fehlerbehebung

Ihre Abfrage kann aus einem der folgenden Gründe fehlschlagen:

• Syntaxfehler in Ihrer SQL-Abfrage
• Zeitüberschreitung bei der Verarbeitung (nach 6 Minuten)
  • Bei Berichten, deren Ausführung länger als 6 Minuten dauert, tritt eine Zeitüberschreitung auf.
  • Wenn bei einem Bericht eine Zeitüberschreitung auftritt, versuchen Sie, den Zeitraum der abgefragten Daten einzuschränken oder einen spezifischeren Datensatz abzufragen.

Schritt 3: Ihren Bericht generieren

Wenn Sie mit dem Erstellen Ihrer Abfrage fertig sind, wählen Sie Abfrage ausführen aus. Wenn keine Fehler oder Zeitüberschreitungen beim Bericht auftreten, wird aus der Abfrage eine CSV-Datei generiert.

Um den CSV-Bericht herunterzuladen, wählen Sie Exportieren aus.

Wichtig

Jeder Bericht kann nur einmal pro Tag Ergebnisse generieren. Wenn Sie denselben Bericht mehrmals an einem Kalendertag ausführen, sehen Sie in jedem Bericht dieselben Ergebnisse.

Zeitüberschreitungen bei Berichten

Berichte, deren Ausführung länger als sechs Minuten dauert, führen zu einer Zeitüberschreitung. Wenn Sie zum ersten Mal seit längerer Zeit eine Abfrage ausführen, kann die Verarbeitung länger dauern, sodass eine Zeitüberschreitung wahrscheinlicher ist. Versuchen Sie in diesem Fall, den Bericht erneut auszuführen.

Wenn bei Ihrem Bericht auch nach mehreren Versuchen weiterhin eine Zeitüberschreitung auftritt, wenden Sie sich an den Support.

Abbruchgründe abfragen

Sie können die Spalte ABORT_TYPE in jeder Tabelle USERS_MESSAGES_*_ABORT_SHARED abfragen, um zu analysieren, warum Nachrichten nicht gesendet wurden. Das Feld ABORT_TYPE enthält einen String-Wert, der den konkreten Grund für den Abbruch beschreibt. Das zugehörige Feld ABORT_LOG enthält zusätzliche Details, etwa die Frequency-Capping-Regel, die ausgelöst wurde.

So zählen Sie beispielsweise E-Mail-Abbrüche der letzten 30 Tage nach Typ:

1
2
3
4
5

SELECT ABORT_TYPE, COUNT(*) as abort_count
FROM USERS_MESSAGES_EMAIL_ABORT_SHARED
WHERE to_date(to_timestamp_ntz(time)) >= DATEADD('day', -30, CURRENT_DATE())
GROUP BY ABORT_TYPE
ORDER BY abort_count DESC

Die vollständige Liste der ABORT_TYPE-Werte und ihrer Beschreibungen finden Sie unter Abbruchtypen.

Daten und Ergebnisse

Alle Anfragen zeigen Daten aus den letzten 60 Tagen an. Wenn Sie Ihre Ergebnisse exportieren, enthält der Export maximal 1.000 Zeilen. Für Berichte, die größere Datenmengen erfordern, können Sie Tools wie Currents oder den Export-API-Endpunkt verwenden.

Snowflake-Credits

Jedes Unternehmen hat pro Monat 5 Snowflake-Credits zur Verfügung, die für alle Workspaces gemeinsam gelten. Jedes Mal, wenn Sie eine Abfrage ausführen oder eine Vorschau einer Tabelle anzeigen, wird ein kleiner Teil eines Snowflake-Credits verbraucht.

Hinweis

Snowflake-Credits werden nicht zwischen Features geteilt. So sind beispielsweise die Credits für SQL-Segmenterweiterungen und den Abfrage-Builder unabhängig voneinander.

Der Credit-Verbrauch hängt von der Laufzeit Ihrer SQL-Abfrage ab. Je länger die Laufzeit, desto größer ist der Anteil eines Snowflake-Credits, den eine Abfrage kostet. Die Laufzeit kann je nach Komplexität und Umfang Ihrer Abfragen im Laufe der Zeit variieren. Je komplexer und häufiger Ihre Abfragen sind, desto größer wird Ihre Ressourcenzuweisung und desto schneller wird Ihre Laufzeit.

Beim Schreiben, Bearbeiten oder Speichern von Berichten im Braze SQL-Editor werden keine Credits verbraucht. Ihre Credits werden am Ersten jedes Monats um 0:00 Uhr UTC auf 5 zurückgesetzt. Ihren monatlichen Credit-Verbrauch können Sie oben auf der Seite des Abfrage-Builders überwachen.

Wenn Sie das Credit-Limit erreicht haben, können Sie keine Abfragen mehr ausführen, aber weiterhin SQL-Berichte erstellen, bearbeiten und speichern. Wenn Sie weitere Credits für den Abfrage-Builder erwerben möchten, wenden Sie sich bitte an Ihren Account Manager.