Abfrageergebnisse in Dashboards und Arbeitsblättern filtern¶

Berechtigung zum Erstellen kundenspezifischer Filter erteilen¶

Damit ein Benutzer kundenspezifische Filter erstellen kann, muss ein Benutzer mit der Rolle ACCOUNTADMIN die entsprechenden Berechtigungen einer Rolle zuweisen, die diesem Benutzer zugewiesen ist. Sie können nur Snowsight verwenden, wenn Sie Rollen die Berechtigung zum Erstellen kundenspezifischer Filter zuweisen möchten.

Wenn Sie einer Rolle die Berechtigung zum Erstellen kundenspezifischer Filter in Ihrem Konto zuweisen möchten, gehen Sie wie folgt vor:

1. Melden Sie sich bei Snowsight an.

2. Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen und ein Arbeitsblatt zu öffnen, oder wählen Sie Projects » Dashboards aus, um die Liste der Dashboards zu öffnen und ein Dashboard zu öffnen.

3. Wählen Sie aus, und wählen Sie, wenn Sie sich in einem Arbeitsblatt befinden, Manage Filters aus.

4. Wählen Sie im angezeigten Dialogfeld Edit Permission aus.

5. Wählen Sie im Dialogfeld Filter Permissions die Rollen aus, denen Sie die Berechtigung zum Erstellen von Filtern zuweisen möchten.

6. Wählen Sie Save aus.

Kundenspezifischen Filter erstellen¶

Sie müssen Snowsight verwenden, um einen Filter zu erstellen, und Sie müssen eine Rolle mit Berechtigungen zum Erstellen kundenspezifischer Filter verwenden.

Um einen kundenspezifischen Filter zu erstellen, gehen Sie wie folgt vor:

1. Melden Sie sich bei Snowsight an.

2. Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen und ein Arbeitsblatt zu öffnen, oder wählen Sie Projects » Dashboards aus, um die Liste der Dashboards zu öffnen und ein Dashboard zu öffnen.

3. Wählen Sie aus, und wählen Sie, wenn Sie sich in einem Arbeitsblatt befinden, Manage Filters aus.

4. Wählen Sie im Dialogfeld Filters die Option + Filter aus.

5. Um einen Filter hinzuzufügen, gehen Sie wie folgt vor:

   1. Geben Sie unter Display Name einen Namen für den Filter ein. Dieser Name wird für den Filter angezeigt, wenn Sie den Filter in einem Arbeitsblatt oder Dashboard auswählen.

   2. Geben Sie unter SQL Keyword ein eindeutiges Schlüsselwort für das Einfügen in Abfragen ein. Verwenden Sie das Format :<Zeichenfolge> ohne Leerzeichen. Beispiel: :page_path.

   3. Geben Sie unter Description eine Beschreibung des Filters ein.

   4. Wählen Sie unter Role eine Rolle aus, die Sie mit dem Filter verknüpfen möchten, und führen Sie die Abfrage aus, die zum Auffüllen der Filterwerte verwendet wird, wenn der Filter auf einer Abfrage basiert. Nur Rollen mit der Berechtigung, kundenspezifische Filter zu erstellen, werden in der Dropdown-Liste angezeigt. Weitere Details dazu finden Sie unter Eigentümerschaft eines kundenspezifischen Filters verwalten.

   5. Wählen Sie unter Warehouse ein Warehouse aus, das zum Aktualisieren der Filterwerte verwendet werden soll, wenn der Filter auf einer Abfrage basiert. Die Eigentümerrolle für den Filter muss die Berechtigung USAGE für das von Ihnen ausgewählte Warehouse haben. Wenn Sie Ihre Abfrage im Rahmen dieser Anleitung ausführen und validieren möchten, muss das Warehouse aktiv sein.

   6. Wählen Sie unter Options via aus, ob die Filterwerte durch eine Abfrage oder eine Liste gefüllt werden sollen:

      • Wenn Sie Query und dann Write Query auswählen, finden Sie unter Abfrage zum Befüllen eines Filters schreiben Hinweise zum Schreiben einer Filterabfrage.

      • Wenn Sie List auswählen, gehen Sie wie folgt vor:

        1. Wählen Sie Edit List aus.

        2. Optional können Sie unter Name einen Namen für das Listenelement eingeben. Der Name wird in der Dropdown-Liste für den Filter angezeigt. Wenn Sie keinen Namen angeben, wird der Wert von Value verwendet.

        3. Geben Sie unter Value den Wert des Spaltennamens ein, der im Filter verwendet werden soll.

        4. Fahren Sie mit dem Hinzufügen von Name/Wert-Paaren fort, bis Ihre Liste vollständig ist, und wählen Sie dann Save aus.

6. Wählen Sie im Dialog Add Filter unter Value Type aus, ob es sich bei den Listenelementen um die Datentypen Text oder Number handelt.

7. Wenn Sie möchten, dass Benutzer mehrere Elemente in der Dropdown-Liste der Filteroptionen auswählen können, aktivieren Sie den Umschalter Multiple values can be selected.

8. Wenn Sie möchten, dass die Benutzer die Ergebnisse für alle Elemente in der Spalte sehen können, aktivieren Sie den Umschalter für Include an „All“ option, und wählen Sie dann aus, wie die Option All funktionieren soll:

   • Wählen Sie Any value aus, damit All im Filter bedeutet, dass die Spalte, für die der Filter gilt, einen beliebigen Wert in den Ergebnissen haben kann, unabhängig davon, ob der Wert in der Filterliste vorhanden ist oder nicht.

   • Wählen Sie Any value in list of options aus, damit All im Filter bedeutet, dass die Spalte, für die der Filter gilt, ein beliebiges Element in der Filterliste enthält.

9. Wenn Sie möchten, dass Benutzer Ergebnisse für Elemente sehen können, die nicht im Filter angegeben sind, aktivieren Sie den Umschalter Include an „Other“ option.

10. Wählen Sie Save aus.

11. Wählen Sie Done aus, um das Dialogfeld Filters zu schließen.

Eigentümerschaft eines kundenspezifischen Filters verwalten¶

Jeder kundenspezifische Filter hat eine zugehörige Rolle. Jeder Benutzer mit dieser Rolle kann den Filter bearbeiten oder löschen. Benutzer mit der Rolle ACCOUNTADMIN können jeden Filter im Konto einsehen und bearbeiten.

Wenn die mit einem Filter verknüpfte Rolle gelöscht wird, erbt die Rolle, die die Filterrolle löscht, nicht die Eigentümerschaft an dem kundenspezifischen Filter. Stattdessen kann ein Benutzer mit der Rolle ACCOUNTADMIN den Filter bearbeiten und die mit dem Filter verbundene Rolle ändern.

Aktualisierungshäufigkeit eines kundenspezifischen Filters verwalten¶

Ein kundenspezifischer Filter, der durch eine SQL-Abfrage gefüllt wird, hat auch eine Aktualisierungshäufigkeit. Die Aktualisierungshäufigkeit kann stündlich, täglich oder nie sein.

Der Filter wird abhängig davon ausgeführt, wann er gespeichert wurde und wie lange es gedauert hat, die Abfrage auszuführen, die die Filteroptionen aktualisiert.

Wenn Sie beispielsweise einen Filter mit einer stündlichen Aktualisierungshäufigkeit um 10:07 Uhr speichern, wird die erste Abfrage zur Aktualisierung um oder nach 11:07 Uhr ausgeführt. Wenn sehr viele Filteraktualisierungsabfragen so geplant sind, dass sie zur gleichen Zeit ausgeführt werden, werden die Abfragen in eine Warteschlange gestellt, um die Anzahl der gleichzeitig ausgeführten Filteraktualisierungsabfragen zu begrenzen. Die nächste Filteraktualisierung basiert darauf, wann die letzte Aktualisierung abgeschlossen wurde. Wenn in diesem Beispiel die Aktualisierung der Abfrage um 11:07 Uhr 20 Minuten dauert, würde die nächste Aktualisierungsabfrage um oder nach 12:27 Uhr erfolgen.

Filteraktualisierungen werden als der Benutzer ausgeführt, der den Filter erstellt oder zuletzt geändert hat, und sind unter Query History als einer der Typen von Queries executed by user tasks sichtbar. Weitere Informationen zur Verwendung von Query History finden Sie unter Abfrageaktivität mit Abfrageverlauf überwachen.

Um festzustellen, welcher Filter für die Filterabfrageaktualisierung verantwortlich ist, müssen Sie die Filterliste öffnen und dann die einzelnen Filter öffnen, um die Details zu sehen.

SELECT * FROM SNOWFLAKE.ACCOUNT_USAGE.LOGIN_HISTORY
WHERE
    FIRST_AUTHENTICATION_FACTOR = 'OAUTH_ACCESS_TOKEN'
    AND
    REPORTED_CLIENT_TYPE = 'SNOWFLAKE_UI'
    AND
    EVENT_TIMESTAMP > DATEADD('DAY', -2, CURRENT_DATE());
ORDER BY
    EVENT_TIMESTAMP DESC;

Anwenden und Speichern von Filtern¶

Wenn Sie die in einem Filter ausgewählten Optionen ändern, wird die Option zur Übernahme Ihrer Änderungen angezeigt. Wenn Sie Apply wählen, wird das Arbeitsblatt oder das Dashboard ausgeführt, und es werden aktualisierte gefilterte Ergebnisse angezeigt, sodass Sie die Änderungen ohne Speichern überprüfen können.

Nachdem Sie Änderungen an einem Filter in einem Dashboard vorgenommen haben, wird die Option zum Speichern Ihrer Änderungen angezeigt. Wenn Sie Save wählen, werden die Änderungen, die Sie am Dashboard vorgenommen haben, gespeichert und sind für andere Benutzer des Dashboards verfügbar.

Sie könnten z. B. Apply auswählen wollen, um einen Filter zu ändern, weil Sie die Ergebnisse von All Time sehen möchten, aber Sie möchten nicht, dass das Dashboard beim nächsten Öffnen des Dashboards über eine so große Datenmenge ausgeführt wird, also wählen Sie nicht Save aus. Nachdem Sie Ihr Dashboard über die gesamte Zeit ausgeführt haben, ändern Sie den Datumsbereichsfilter auf Last 7 days, wählen Apply aus, um das Dashboard auszuführen, und wählen dann Save aus, um diesen Standard-Filterwert für Benutzer des Dashboards zu speichern.

Beispiel: Verwenden von Datumsfiltern¶

Wenn Sie z. B. eine Tabelle mit Bestelldaten haben, wie die Tabelle ORDERS in der Datenbank SNOWFLAKE_SAMPLE_DATA und dem Schema TPCH_SF1, können Sie die Tabelle abfragen und die Ergebnisse nach einem bestimmten Bucket gruppieren, z. B. nach Tag oder Woche, und einen bestimmten Datumsbereich angeben, für den die Ergebnisse abgerufen werden sollen.

Dazu können Sie eine Abfrage wie die folgende schreiben:

SELECT
    COUNT(O_ORDERDATE) as orders,
    :datebucket(O_ORDERDATE) as bucket
FROM
    SNOWFLAKE_SAMPLE_DATA.TPCH_SF1.ORDERS
WHERE
    O_ORDERDATE = :daterange
GROUP BY
    :datebucket(O_ORDERDATE)
ORDER BY
    bucket;

Weiteres Beispiel:

• Ermitteln der Anzahl der Bestellungen und Abrufen von Details zum Bestelldatum aus der Tabelle ORDERS.

• Filtern der Ergebnisse nach einem bestimmten Datumsbereich, indem der Systemfilter :daterange in die WHERE-Klausel aufgenommen wird.

• Gruppieren der Ergebnisse nach einem bestimmten Zeitraum, indem der Systemfilter :datebucket in die GROUP BY-Klausel aufgenommen wird.

• Sortieren der Ergebnisse vom frühesten zum spätesten Zeitraum, indem die ORDER BY-Klausel aufgenommen wird.

Wenn Sie Filter zu Ihrer Abfrage hinzufügen, werden oben in Ihrem Arbeitsblatt oder Dashboard die entsprechenden Schaltflächen angezeigt:

Um die Ergebnisse Ihrer Abfrage zu bearbeiten, verwenden Sie die Filter zur Auswahl der spezifischen Werte.

Setzen Sie in diesem Beispiel den Filter Group by, der dem Filter für den Datums-Bucket entspricht, auf die Gruppierung nach Day. Setzen Sie den anderen Filter, der dem Datumsbereichsfilter entspricht, auf All time.

Wenn Sie Apply auswählen und den Filter auf Ihre Ergebnisse anwenden, werden die Ergebnisse nach Tagen gruppiert, und die Ergebnisse werden ähnlich wie in der folgende Ausgabe angezeigt:

+--------+------------+
| orders |  buckets   |
+--------+------------+
|    621 | 1992-01-01 |
|    612 | 1992-01-02 |
|    598 | 1992-01-03 |
|    670 | 1992-01-04 |
+--------+------------+

Sie können einen anderen Datums-Bucket auswählen, um eine andere Gruppierung der Daten anzuzeigen. Um beispielsweise wöchentliche Auftragsdaten anzuzeigen, setzen Sie den Filter Group by auf Week und wählen Apply aus. Es erscheinen Ergebnisse wie die folgende Ausgabe:

+--------+------------+
| orders |  buckets   |
+--------+------------+
|   3142 | 1991-12-30 |
|   4404 | 1992-01-06 |
|   4306 | 1992-01-13 |
|   4284 | 1992-01-20 |
+--------+------------+