Abfragen schreiben
Erstellen Sie nutzerdefinierte Abfragen in ANSI Standard-SQL für die Verwendung in einer breiten Palette von Berichtsfunktionen.
Jede Person in Ihrem Konto mit der Berechtigung zum Anzeigen von Berichten kann den Sigma-Abfrage-Editor zum Verfassen neuer oder zum Ändern bestehender Abfragen verwenden. Unser auf dem Large Language Model (LLM) basierender Abfrageassistent kann Ihnen sogar dabei helfen, das SQL zu generieren, das Sie bei einer Eingabeaufforderung in natürlicher Sprache benötigen.
Ressourcen abfragen
Das Navigationsfenster links neben dem Editor enthält eine Reihe von Tools, die Sie beim Erstellen Ihrer Abfrage unterstützen. Sie sehen:
- Ihre zuvor gespeicherten Abfragen
- Von Ihrem Team gespeicherte Abfragen
- Das Tabellenschema zur Suche nach Datenquellen
- Abfragevorlagen für Stripe
Gespeicherte Abfragen und Vorlagen
Auf der Registerkarte Abfragen werden die Listen der zuvor von Ihnen und Ihrem Team gespeicherten Abfragen angezeigt. Die Registerkarte Vorlagen enthält eine Reihe von Beispielabfragen, die die häufigsten Metriken und Berichte darstellen.
Wenn Sie eine gespeicherte Abfrage oder Vorlage auswählen, wird sie in den Abfrage-Editor geladen. Dort können Sie auf Ausführen klicken, um die Ergebnisse neu zu generieren und anzuzeigen.
Um eine gespeicherte Abfrage oder Vorlage als Ausgangspunkt für Ihren eigenen nutzerdefinierten Bericht zu verwenden, klicken Sie entweder auf das Überlaufmenü () und wählen Kopie erstellen aus, oder Sie laden sie in den Editor und klicken auf Kopie erstellen. So können Sie den Inhalt im Editor ändern und Ihre Änderungen als neue Abfrage speichern.
Eine Abfrage verfassen
Wenn Sie den Abfrage-Editor öffnen, können Sie Folgendes tun:
- ANSI Standard-SQL direkt in den Editor schreiben.
- Wählen Sie eine vorhandene Abfrage aus Ihren zuvor gespeicherten Abfragen oder den Vorlagen von Stripe aus und ändern Sie sie im Editor, um die zurückgegebenen Daten zu optimieren.
In der folgenden Abfrage wird die Tabelle balance_
verwendet, um Informationen zu den letzten fünf Saldo-Transaktionen im Zusammenhang mit Rückerstattungen abzurufen.
select date_format(created, '%Y-%m-%d') as day, id, amount, currency, source_id from balance_transactions where type = 'refund' order by day desc limit 5
Klicken Sie auf Ausführen, um die Abfrage auszuführen und die Ergebnisse in einer Tabelle unter dem Editor anzuzeigen. Bei komplexeren Abfragen kann es etwas länger dauern, bis die Abfrage abgeschlossen ist und Ergebnisse angezeigt werden. Beim Ausführen einer ungültigen Abfrage wird eine Fehlermeldung mit der Zeilennummer und Position des Fehlers angezeigt.
Die Ergebnisse unserer Beispielabfrage geben 5 Zeilen zurück, wobei jede Zeile einer bestimmten Saldo-Transaktionsposition entspricht, zusammen mit den dazu angeforderten Informationen.
Tag | ID | Betrag | Währung | source_id |
---|---|---|---|---|
txn_MkR8Q6ISNiaUJbc | -1.000 | USD | re_gTRvkBN57p5udqL | |
txn_bFzAMRdAmGJlDpS | -1.000 | USD | re_bU3tLPSL0J2OhyX | |
txn_jhhd2brEPZniNNY | -1.000 | USD | re_eiJAqt10YWR0t6S | |
txn_YQer4JOG7etvRL2 | -1.000 | EUR | re_6BgFWDHwjBd5EWQ | |
txn_TLEErisyHl6yt5J | -1.000 | USD | re_JdFtrnfPvMPKkhD |
Tabellen verbinden
Sie können Spalten vom Typ Primärschlüssel oder Fremdschlüssel mit ähnlichen Spalten in anderen Tabellen zusammenführen:
- Der Primärschlüssel ist die eindeutige Kennung (ID) für jeden Datensatz in einer Tabelle.
- Der Fremdschlüssel beinhaltet Daten, die auf den Primärschlüssel einer anderen Tabelle verweisen.
Sie können beispielsweise die Spalte charge_
der Tabelle disputes
(ein Fremdschlüssel) mit der Spalte id
der Tabelle charges
(einem Primärschlüssel) verbinden.
Durch die Verbindung von Tabellen können Sie in Ihren Datensätzen umfangreichere Ergebnisse zurückgeben. Sie können beispielsweise unser Beispiel für eine Saldotransaktion so ändern, dass diese mit der Tabelle refunds
verknüpft wird, um weitere Informationen bereitzustellen.
select date_format(date_trunc('day', balance_transactions.created), '%Y-%m-%d') as day, balance_transactions.amount, balance_transactions.currency, balance_transactions.source_id, refunds.charge_id from balance_transactions inner join refunds -- Joining these tables to retrieve additional information on balance_transactions.source_id=refunds.id where balance_transactions.type = 'refund' order by day desc limit 5
Diese erweiterte Abfrage gibt nun die ursprüngliche Zahlungs-ID zurück, auf die sich die Rückerstattung bezieht.
Tag | Betrag | Währung | source_id | charge.id |
---|---|---|---|---|
-1.000 | USD | re_L1F7XpXW4HMeYMg | ch_cVVGdu3JBs0svgY | |
-1.000 | USD | re_TOvNCrhnfCAN6wo | ch_iwGWWnrgInKVBqA | |
-1.000 | USD | re_lOFyOtpFnbnWdxH | ch_igjPSfEsLMsX5qn | |
-1.000 | EUR | re_eqlRhwcQ0zWGPO4 | ch_6wuiVzZPVoMfOD7 | |
-1.000 | USD | re_vpH3PIOpDzBlA1U | ch_HN1yZ7YpPe2SbUT |
Assistenten verwenden
Der Abfrage-Editor von Stripe verfügt über einen integrierten LLM-Assistenten, der Standard-AnSI-SQL über eine Eingabeaufforderung in natürlicher Sprache ausgibt. Der Editor kann die folgenden Modi ausführen:
- Im Modus Generieren wird die Eingabeaufforderungsfrage verwendet, um eine neue Abfrage zu schreiben, wobei alle SQL-Abfragen überschrieben werden, die bereits im Editor-Fenster geladen sind.
- Im Modus Bearbeiten wird die Eingabeaufforderungsfrage verwendet, um die SQL-Abfrage im Abfrage-Editor zu ändern.
Ihren Modus prüfen
Um den genauesten Vorschlag zu erhalten, vergewissern Sie sich, dass Sie den richtigen Modus für Ihre Eingabeaufforderung auswählen. Wenn der Editor Inhalte enthält, wechselt der Modus automatisch zu Bearbeiten. Wenn Sie dann eine neue Abfrage durchführen, ohne den Modus zu ändern, kann der resultierende Vorschlag auf der Grundlage dessen, was sich bereits im Editor befindet, unerwartet eingeschränkt sein.
Aufforderung an den Assistenten
- Rufen Sie im Dashboard den Sigma-Abfrage-Editor auf.
- Wählen Sie den Modus Generieren aus und geben Sie eine Frage in das Eingabeaufforderungsfeld ein. Der Assistent:
- Lädt den Abfragevorschlag in den Editor.
- Zeigt eine Zusammenfassung an, in der der Vorschlag beschrieben wird.
- Führt die vorgeschlagene Abfrage aus und gibt die Ergebnisse in einer Tabelle unterhalb des Editors zurück.
- Wechseln in den Modus Bearbeiten, sodass Sie eine weitere Frage stellen können, um die Abfrage nach Bedarf zu verfeinern.
- Fahren Sie fort, den Assistenten aufzufordern und die sich ergebenden Daten anzuzeigen, bis Sie die gewünschten Informationen erhalten.
Der folgende Screenshot zeigt, wie eine Eingabeaufforderung dieselbe SQL-Abfrage generiert wie die am Anfang dieses Dokuments gezeigte Beispielabfrage.
Mögliche weitere Fragen zur Änderung der Vorschläge:
- Sortieren Sie diese Ergebnisse nach Betrag.
- Fügen Sie die Spalten automatic_transfer oder reporting_category nicht ein.
- Kann ich den Kunden/die Kundin für jede Transaktion sehen?
Connect-Daten explizit anfordern
Wenn Sie nach Daten über verbundene Konten fragen, erwähnen Sie explizit „verbundene Konten“ in Ihrer Abfrage. Zum Beispiel: Wie viele neue Abonnements habe ich im letzten Monat von verbundenen Konten erhalten?
Chatverlauf anzeigen
Sigma speichert jede Ihrer Interaktionen mit dem Assistenten im Chatverlauf für diese Abfrage. Klicken Sie oben rechts im Editor auf die Schaltfläche , um den Schieberegler für den Chatverlauf zu öffnen.
Innerhalb des Chat-Verlaufs können Sie jede Eingabeaufforderung für die Dauer der Abfrage (nicht nur für die aktuelle Sitzung) und die Antwort des Assistenten sehen. Klicken Sie auf SQL anzeigen, um den SQL-Vorschlag anzuzeigen, der mit einer beliebigen Eingabeaufforderung verknüpft ist. Klicken Sie auf Im Editor anzeigen, um diesen Vorschlag erneut in das Hauptfenster des Editors zu laden.
Einschränkungen
- Der Assistent des Abfrage-Editors beantwortet nur Fragen auf Englisch.
- Der Assistent des Abfrage-Editors beantwortet nur Fragen in Bezug auf das Stripe-Schema. Es kann keine allgemeinen Fragen beantworten, wie zum Beispiel Welche Farbe hat das Logo von Stripe? oder Wie ist das Wetter heute in San Francisco?
Feedback
Helfen Sie uns, den Assistenten weiter zu verbessern, indem Sie auf die Frage War diese Antwort hilfreich? zwischen dem Editor und der Ergebnistabelle antworten:
- Klicken Sie auf Ja oder Nein.
- Geben Sie bestimmte Details dazu ein, wie der Assistent für Sie gearbeitet hat und was wir tun können, um ihn zu verbessern. Wir freuen uns über jede Meinung, gleich ob es um die Genauigkeit des Vorschlags, die Nutzeroberfläche oder einen anderen Aspekt Ihrer Erfahrung mit dem Assistenten geht.
Zustimmung zu den Schulungsdaten
Durch die Verwendung von Sigma Assistant erklären Sie sich damit einverstanden, dass Stripe Ihre Chat-Einträge protokolliert und verwendet, um die Sigma Assistant-Funktionen zu trainieren und zu verbessern. Wenn Sie nicht möchten, dass Ihre Chat-Einträge für diesen Zweck verwendet werden, können Sie sich in Ihren Einstellungen abmelden.
Abfrageergebnisse anzeigen und herunterladen
Die Abfrageergebnisse werden in einer Tabelle unterhalb des Editors angezeigt. Sie können:
- Maximal 1.000 Ergebnisse anzeigen.
- Sortieren Sie die Ergebnisse, indem Sie auf die Spaltenüberschriften klicken.
- Ändern Sie die Größe jeder Spalte, damit die Ergebnisse leichter abgelesen werden können.
- Passen Sie die Höhe der Ergebnisausgabe an.
Sie können auch eine Tabellenvisualisierung für Abfragen mit weniger als 10.000 Ergebnissen erstellen. Sie können:
- Linien- oder Balkendiagramme mit benutzerdefinierten y-Achsen und x-Achsen erstellen.
- Nach einer beliebigen Tabellenspalte gruppieren
Wenn Sie ein Diagramm in einer Abfrage speichern, wird das Diagramm jedes Mal mit den ausgewählten Einstellungen angezeigt, wenn Sie die Abfrage ausführen. Diagramme können nur vom Autor der Abfrage bearbeitet werden.
Beträge werden in der niedrigsten verfügbaren Währungseinheit angegeben, z. B. Cent bei USD oder Yen bei JPY. Zum Beispiel entspricht 1,000
mit der Währung usd
dem Betrag 10 USD.
Klicken Sie auf CSV herunterladen, um Ihre Ergebnisse für die Verwendung in Tabellenkalkulationsprogrammen oder anderen Berichtstools zu exportieren. Die heruntergeladene CSV-Datei umfasst alle Abfrageergebnisse, sodass Sie nicht auf die 1.000 sichtbaren Ergebnisse beschränkt sind.
Abfragen speichern
Um eine Abfrage zu speichern, klicken Sie auf den Titel (mit der Bezeichnung Neuer Bericht, wenn es sich um eine neue Abfrage handelt) und geben Sie Ihren Ersatz ein. Klicken Sie dann auf Speichern.
Abfragen teilen
Die von Ihnen gespeicherten Abfragen werden zum Abschnitt Alle hinzugefügt und für jedes Teammitglied in Ihrem Konto verfügbar gemacht. Jede gespeicherte Abfrage erhält eine eindeutige URL, die Sie durch Klicken auf Link kopieren teilen können. Sie können diesen Link als Verknüpfung zu einem bestimmten Bericht verwenden, den Sie regelmäßig verwenden, oder ihn direkt mit anderen Teammitgliedern im Stripe-Konto teilen.
Sie können Abfragen nur für Teammitglieder freigeben. Freigegebene Abfragen sind außerdem schreibgeschützt, sodass andere Teammitglieder die von Ihnen erstellten Abfragen nicht ändern können. Wenn ein Teammitglied Änderungen an Ihrer Abfrage vornehmen möchte, kann es eine Kopie erstellen und diese entsprechend bearbeiten.