Kategorien:

Datenmetrikfunktionen

NULL_PERCENT (System-Datenmetrikfunktion)

Gibt den Prozentsatz der Spaltenwerte zurück, die für die angegebene Spalte in einer Tabelle NULL sind.

In diesem Thema wird die Syntax für den direkten Aufruf der Funktion bereitgestellt. Wie Sie die Funktion mit einer Tabelle oder Ansicht verknüpfen, sodass sie in regelmäßigen Abständen ausgeführt wird, erfahren Sie unter Eine DMF verknüpfen, um Datenqualitätsprüfungen zu automatisieren.

Syntax

SNOWFLAKE.CORE.NULL_PERCENT(<query>)
Copy

Argumente

query

Gibt eine SQL-Abfrage an, die eine einzelne Spalte projiziert.

Zulässige Datentypen

Die Spalte, die von der query projiziert wird, muss einen der folgenden Datentypen haben:

  • DATE

  • FLOAT

  • NUMBER

  • TIMESTAMP_LTZ

  • TIMESTAMP_NTZ

  • TIMESTAMP_TZ

  • VARCHAR

Rückgabewerte

Die Funktion gibt einen NUMBER-Wert zurück.

Anforderungen an die Zugriffssteuerung

Das Zuordnen und Ausführen einer System-DMF erfordert die USAGE-Berechtigung für die System-DMF. Sie können die SNOWFLAKE.DATA_METRIC_USER-Datenbankrolle gewähren, um Benutzenden die die USAGE-Berechtigung für alle System-DMFs zu geben. Weitere Informationen dazu finden Sie unter Gewähren der USAGE-Berechtigung für System-DMFs.

Eine Anleitung zum Erstellen einer kundenspezifischen Rolle mit einer bestimmten Gruppe von Berechtigungen finden Sie unter Erstellen von kundenspezifischen Rollen.

Allgemeine Informationen zu Rollen und Berechtigungen zur Durchführung von SQL-Aktionen auf sicherungsfähigen Objekten finden Sie unter Übersicht zur Zugriffssteuerung.

Beispiel

Messen des Prozentsatzes der NULL-Werte für die Spalte SSN (d. h. US Sozialversicherungsnummer):

SELECT SNOWFLAKE.CORE.NULL_PERCENT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);
Copy
+----------------------------------------------------------------+
| SNOWFLAKE.CORE.NULL_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+----------------------------------------------------------------+
| 1                                                              |
+----------------------------------------------------------------+
Sprache: Deutsch