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_NAME,SCHEMA_NAME,TABLE_NAME,COLUMN_NAME |
列掩码的唯一标识符。 |
| 外键 | COLUMN_MASKS_COLUMNS_FK |
CATALOG_NAME,SCHEMA_NAME,TABLE_NAME,COLUMN_NAME |
引用 COLUMNS |
| 外键 | COLUMN_MASKS_ROUTINES_FK |
MASK_CATALOG,MASK_SCHEMA,MASK_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;