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:
- PII anzeigen: Der Abfrage-Builder ermöglicht direkten Zugriff auf einige Kundendaten.
- Dashboard-Berichte anzeigen: Diese Berechtigung ist erforderlich, damit Nutzer:innen ohne Administratorrechte den Abfrage-Builder im Dashboard sehen können.
Verwendung des Abfrage-Builders
Schritt 1: Eine SQL-Anfrage erstellen
Um eine neue Anfrage zu erstellen, gehen Sie zu Analytics > Abfrage-Builder und wählen Sie dann SQL-Anfrage erstellen aus.
Wenn Sie Inspiration oder Hilfe beim Erstellen Ihrer Anfrage benötigen, wählen Sie Anfrage-Template und dann ein vorgefertigtes Template. Um mit einer leeren Anfrage zu beginnen, wählen Sie SQL-Editor.
Ihr Bericht erhält automatisch einen Namen mit dem aktuellen Datum und der Uhrzeit. Bewegen Sie den Mauszeiger über den Namen und wählen Sie , um Ihrer SQL-Anfrage einen aussagekräftigen Namen zu geben.
Schritt 2: Ihre Anfrage erstellen
Beim Erstellen Ihrer Anfrage können Sie sich von der KI unterstützen lassen oder die Anfrage selbst formulieren.
Der KI-Abfrage-Builder nutzt GPT, betrieben von OpenAI, um SQL für Ihre Anfrage vorzuschlagen. So generieren Sie SQL mit dem KI-Abfrage-Builder:
- Nachdem Sie einen Bericht im Abfrage-Builder erstellt haben, wählen Sie den Tab KI-Abfrage-Builder aus.
- Geben Sie Ihren Prompt ein oder wählen Sie einen Beispiel-Prompt und dann Generieren, um Ihren Prompt in SQL zu übersetzen.
- Überprüfen Sie das generierte SQL, um sicherzustellen, dass es korrekt aussieht, und wählen Sie dann In Editor einfügen.
Tipps
- Machen Sie sich mit den verfügbaren Snowflake-Datentabellen vertraut. Wenn Sie nach Daten fragen, die in diesen Tabellen nicht vorhanden sind, kann es vorkommen, dass ChatGPT eine fiktive Tabelle erfindet.
- Machen Sie sich mit den SQL-Schreibregeln für dieses Feature vertraut. Die Nichteinhaltung dieser Regeln führt zu einem Fehler.
- Sie können mit dem KI-Abfrage-Builder bis zu 20 Prompts pro Minute senden.
Wie werden meine Daten verwendet und an OpenAI gesendet?
Um KI-Ausgaben über BrazeAI-Features zu generieren, die OpenAI nutzen („Output“), sendet Braze bestimmte Informationen („Input“) an OpenAI. Der Input besteht aus Ihren Eingabeaufforderungen und kann die im Dashboard angezeigten Inhalte sowie andere für Ihre Anfragen relevante Workspace-Daten umfassen. Gemäß den Verpflichtungen der API-Plattform von OpenAI werden Daten, die über Braze an die API von OpenAI gesendet werden, nicht zum Trainieren oder Verbessern von OpenAI-Modellen verwendet. OpenAI kann Daten für 30 Tage zur Missbrauchsüberwachung aufbewahren, danach werden sie gelöscht. Zwischen Ihnen und Braze ist der Output Ihr geistiges Eigentum. Braze erhebt keine Urheberrechtsansprüche auf solchen Output. Braze übernimmt keinerlei Garantie in Bezug auf KI-generierte Inhalte, einschließlich Output.
Schreiben Sie Ihre SQL-Anfrage mit der Snowflake-Syntax. In der Tabellenreferenz finden Sie eine vollständige Liste der verfügbaren Tabellen und Spalten, die abgefragt werden können.
So zeigen Sie Tabellendetails im Abfrage-Builder an:
- Öffnen Sie auf der Seite Abfrage-Builder das Panel Referenz und wählen Sie Verfügbare Datentabellen, um die verfügbaren Datentabellen und ihre Namen anzuzeigen.
- Wählen Sie Details anzeigen, um die Tabellenbeschreibung und Informationen zu den Tabellenspalten wie Datentypen anzuzeigen.
- Um den Tabellennamen in Ihr SQL einzufügen, wählen Sie .
Wenn Sie Ihre Anfrage auf einen bestimmten Zeitraum beschränken, werden die Ergebnisse schneller generiert. Das folgende Beispiel zeigt eine Anfrage, die die Anzahl der Käufe und den generierten Umsatz der letzten Stunde abruft.
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 Anfrage ruft die Anzahl der E-Mail-Sendungen im letzten Monat ab:
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 nach CANVAS_ID, CANVAS_VARIATION_API_ID oder CAMPAIGN_ID abfragen, werden die zugehörigen Namensspalten automatisch in die Ergebnistabelle aufgenommen. Sie müssen sie nicht in die SELECT-Anfrage selbst einbeziehen.
| ID-Name | Zugehörige Namensspalte |
|---|---|
CANVAS_ID |
Canvas Name |
CANVAS_VARIATION_API_ID |
Canvas Variant Name |
CAMPAIGN_ID |
Campaign Name |
Diese Anfrage ruft alle drei IDs und ihre zugehörigen Namensspalten mit maximal 100 Zeilen ab:
SELECT CANVAS_ID, CANVAS_VARIATION_API_ID, CAMPAIGN_ID
FROM USERS_MESSAGES_EMAIL_SEND_SHARED
LIMIT 100
Fehlerbehebung
Ihre Anfrage kann aus einem der folgenden Gründe fehlschlagen:
- Syntaxfehler in Ihrer SQL-Anfrage
- Verarbeitungs-Timeout (nach 6 Minuten)
- Berichte, deren Ausführung länger als 6 Minuten dauert, erreichen ein Timeout.
- Wenn ein Bericht ein Timeout erreicht, versuchen Sie, den Zeitraum Ihrer Datenabfrage einzugrenzen oder einen spezifischeren Datensatz abzufragen.
Schritt 3: Ihren Bericht generieren
Wenn Sie Ihre Anfrage fertig erstellt haben, wählen Sie Anfrage ausführen. Wenn keine Fehler oder Berichts-Timeouts auftreten, wird aus der Anfrage eine CSV-Datei generiert.
Um den CSV-Bericht herunterzuladen, wählen Sie Exportieren.
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, werden wegen Zeitüberschreitung abgebrochen. Wenn Sie zum ersten Mal seit längerer Zeit eine Anfrage ausführen, kann die Verarbeitung länger dauern, wodurch die Wahrscheinlichkeit einer Zeitüberschreitung steigt. 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 USERS_MESSAGES_*_ABORT_SHARED-Tabelle abfragen, um zu analysieren, warum Nachrichten nicht gesendet wurden. Das Feld ABORT_TYPE enthält einen String-Wert, der den spezifischen Grund für den Abbruch beschreibt, und das zugehörige Feld ABORT_LOG enthält zusätzliche Details (z. B. die ausgelöste Frequency-Capping-Regel).
Um beispielsweise E-Mail-Abbrüche nach Typ in den letzten 30 Tagen zu zählen:
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 deren Beschreibungen finden Sie unter Abbruchtypen.
Daten und Ergebnisse
Alle Anfragen liefern Daten aus den letzten 60 Tagen. Wenn Sie Ihre Ergebnisse exportieren, sind maximal 1.000 Zeilen enthalten. Für Berichte, die größere Datenmengen erfordern, können Sie Tools wie Currents oder den Export-API-Endpunkt verwenden.
Snowflake-Credits
Jedes Unternehmen verfügt über 5 Snowflake-Credits pro Monat, die über alle Workspaces hinweg geteilt werden. Bei jeder Ausführung einer Anfrage oder Vorschau einer Tabelle wird ein kleiner Teil eines Snowflake-Credits verbraucht.
Snowflake-Credits werden nicht zwischen Features geteilt. Beispielsweise sind die Credits für Segmenterweiterungen und den Abfrage-Builder unabhängig voneinander.
Der Credit-Verbrauch korreliert mit der Laufzeit Ihrer SQL-Anfrage. Je länger die Laufzeit, desto höher der Anteil eines Snowflake-Credits, den eine Anfrage kostet. Die Laufzeit kann je nach Komplexität und Umfang Ihrer Anfragen variieren. Je komplexer und häufiger die Anfragen sind, die Sie ausführen, 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 00:00 Uhr UTC auf 5 zurückgesetzt. Sie können Ihren monatlichen Credit-Verbrauch oben auf der Seite des Abfrage-Builders überwachen.
Wenn Sie das Credit-Limit erreichen, können Sie keine Anfragen mehr ausführen, aber Sie können SQL-Berichte erstellen, bearbeiten und speichern. Wenn Sie zusätzliche Credits für den Abfrage-Builder erwerben möchten, wenden Sie sich bitte an Ihren Account Manager.