COLUMN_MASKS

打勾标记 Databricks Runtime 12.2 LTS 及更高版本 打勾标记 仅限 Unity Catalog。

重要

此功能目前以公共预览版提供。

INFORMATION_SCHEMA.COLUMN_MASKS 包含目录中表列的列掩码元数据;如果包含在 SYSTEM 目录中,则包含所有目录中表列的列掩码元数据。

仅显示用户有权与之交互的列的信息。

此关系是 SQL 标准信息架构的扩展。

定义

COLUMN_MASKS 关系包含以下内容。

名称 数据类型 可为 Null 说明
CATALOG_NAME STRING 包含表的目录。
SCHEMA_NAME STRING 包含表的架构。
TABLE_NAME STRING 列所属的表的名称。
COLUMN_NAME STRING 应用掩码的列。
MASK_CATALOG STRING 包含掩码函数的目录。
MASK_SCHEMA STRING 包含掩码函数的架构。
MASK_NAME STRING 实现掩码的函数的特定名称。
MASK_COL_USAGE STRING 传递给掩码函数的额外列的逗号分隔列表。 如果没有,则为 NULL

约束

以下约束应用于 COLUMN_TAGS 关系:

名称 列列表 说明
主密钥 COLUMN_MASKS_PK CATALOG_NAMESCHEMA_NAMETABLE_NAMECOLUMN_NAME 列掩码的唯一标识符。
外键 COLUMN_MASKS_COLUMNS_FK CATALOG_NAMESCHEMA_NAMETABLE_NAMECOLUMN_NAME 引用 COLUMNS
外键 COLUMN_MASKS_ROUTINES_FK MASK_CATALOGMASK_SCHEMAMASK_NAME 引用 ROUTINES

示例

-- Return the names of all functions used as column masks in the current catalog.
> SELECT mask_catalog, mask_schema, mask_name, count(1)
    FROM information_schema.column_masks
    GROUP BY ALL
    ORDER BY ALL;