カテゴリ:

データメトリック関数

BLANK_COUNT (システムデータメトリック関数)

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

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

構文

SNOWFLAKE.CORE.BLANK_COUNT(<query>)
Copy

引数

query

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

許可されるデータ型

query によって投影された列には、VARCHAR データ型が必要です。

戻り値

関数は NUMBER を返します。

アクセス制御の要件

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

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

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

SSN 列(US 社会保障番号)の空白フィールドの割合を測定します。

SELECT SNOWFLAKE.CORE.BLANK_COUNT(
  SELECT
    ssn
  FROM hr.tables.empl_info
);
Copy
+-----------------------------------------------------------------+
| SNOWFLAKE.CORE.BLANK_COUNT(SELECT ssn FROM hr.tables.empl_info) |
+-----------------------------------------------------------------+
| 1                                                               |
+-----------------------------------------------------------------+