カテゴリ：: データメトリック関数

NULL_PERCENT （システムデータメトリック関数）¶

テーブル内にある指定された列が NULL である列値の割合を返します。

このトピックでは、関数を直接呼び出すための構文を提供します。関数をテーブルまたはビューに関連付け、一定の間隔で実行する方法については、DMF と関連付けて、データ品質チェックを自動化します。をご参照ください。

構文¶

SNOWFLAKE.CORE.NULL_PERCENT(<query>)

Copy

引数¶

query: 単一の列を投影する SQL クエリを指定します。

許可されるデータ型¶

query によって投影された列には、以下のデータ型のいずれかが必要です。

DATE
FLOAT
NUMBER
TIMESTAMP_LTZ
TIMESTAMP_NTZ
TIMESTAMP_TZ
VARCHAR

戻り値¶

関数は NUMBER を返します。

アクセス制御の要件¶

システム DMF の関連付けと実行には、システム DMF に対する USAGE 権限が必要です。SNOWFLAKE.DATA_METRIC_USER データベースロールを付与すると、ユーザーにすべてのシステム DMFs に対する USAGE 権限を付与できます。詳細については、システム DMFs に対する USAGE 権限を付与するをご参照ください。

指定された権限のセットを使用してカスタムロールを作成する手順については、カスタムロールの作成をご参照ください。

セキュリティ保護可能なオブジェクトに対して SQL アクションを実行するためのロールと権限付与に関する一般的な情報については、アクセス制御の概要をご参照ください。

例¶

SSN 列（つまり、 US 社会保障番号）の NULL 値の割合を測定します。

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                                                              |
+----------------------------------------------------------------+