COLUMNS
適用於: Databricks SQL Databricks Runtime 10.4 LTS 和更新版本, Unity Catalog
INFORMATION_SCHEMA。COLUMNS 描述 catalog中 tables 和 views(關係)的 columns。
傳回的數據列受限於使用者有權與其互動的關係。
定義
COLUMNS
關聯包含下列 columns:
名稱 | 資料類型 | Nullable | 標準 | 描述 |
---|---|---|---|---|
TABLE_CATALOG |
STRING |
No | Yes | 包含 Catalog 的關聯。 |
TABLE_SCHEMA |
STRING |
No | Yes | 包含關聯 Schema。 |
TABLE_NAME |
STRING |
No | Yes | column 所屬關聯性的名稱。 |
COLUMN_NAME |
STRING |
No | Yes | column的名稱。 |
ORDINAL_POSITION |
INTEGER |
No | Yes | 關聯內 column 的位置(從 1 編號)。 |
COLUMN_DEFAULT |
STRING |
No | Yes | 當 column 未在 INSERT中指定時,若 NULL 未定義,則使用的預設值。 |
IS_NULLABLE |
STRING |
No | Yes | 如果 column 可為 Null,則使用 YES ,否則使用 NO 。 |
FULL_DATA_TYPE |
STRING |
No | No | column 定義中所指定的數據類型。 |
DATA_TYPE |
STRING |
No | Yes |
column或 STRUCT 或 ARRAY 的簡單數據類型名稱。 |
CHARACTER_MAXIMUM_LENGTH |
INTEGER |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
CHARACTER_OCTET_LENGTH |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
NUMERIC_PRECISION |
INTEGER |
Yes | Yes | 對於base-2整數數值類型、 FLOAT 和 DOUBLE ,則為支援的位數。 若 DECIMAL 為數字數,則為 , NULL 否則為 。 |
NUMERIC_PRECISION_RADIX |
INTEGER |
Yes | Yes | 若為 DECIMAL 10,則為所有其他數值類型 2, NULL 否則為 。 |
NUMERIC_SCALE |
INTEGER |
Yes | Yes | 若為整數數值類型 0,則為 DECIMAL 小數點右邊的數位數, NULL 否則為 。 |
DATETIME_PRECISION |
INTEGER |
Yes | Yes | 針對 0,針對 DATE TIMESTAMP 和 INTERVAL ...
SECOND 3、任何其他 INTERVAL 0, NULL 否則為 。 |
INTERVAL_TYPE |
STRING |
Yes | Yes | 若為 INTERVAL 間隔的單位部分,例如 'YEAR TO MONTH' , NULL 否則為 。 |
INTERVAL_PRECISION |
INTERAL |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
MAXIMUM_CARDINALITY |
INTEGER |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IS_IDENTITY |
STRING |
No | Yes | 永遠是 'NO',保留供日後使用。 |
IDENTITY_GENERATION |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IDENTITY_START |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IDENTITY_INCREMENT |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IDENTITY_MAXIMUM |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IDENTITY_MINIMUM |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IDENTITY_CYCLE |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IS_GENERATED |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
GENERATION_EXPRESSION |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IS_SYSTEM_TIME_PERIOD_START |
STRING |
No | Yes | 一律為 NO ,保留供未來使用。 |
IS_SYSTEM_TIME_PERIOD_END |
STRING |
No | Yes | 一律為 NO ,保留供未來使用。 |
SYSTEM_TIME_PERIOD_TIMESTAMP_GENERATION |
STRING |
Yes | Yes | 一律為 NULL ,保留供未來使用。 |
IS_UPDATABLE |
STRING |
No | Yes | 如果 column 可更新,則為 YES ,否則為 NO 。 |
PARTITION_ORDINAL_POSITION |
INTEGER |
Yes | No |
column 在 partition中的位置(從 1 開始編號),如果不是分割 column,則為 NULL 。 |
COMMENT |
STRING |
Yes | No | column的選擇性描述。 |
限制
以下限制式適用於 COLUMNS
關聯:
類別 | 名稱 | Column List | 描述 |
---|---|---|---|
主要金鑰 | COLUMNS_PK |
TABLE_CATALOG 、 、 TABLE_SCHEMA 、 TABLE_NAME COLUMN_NAME |
適用於 column的獨特 identifier。 |
唯一索引鍵 | COLUMNS_UK |
TABLE_CATALOG 、、TABLE_SCHEMA TABLE_NAME 、ORDINAL_POSITION 、 |
唯一的 identifiercolumn。 |
外部索引鍵 | COLUMN_TABLES_FK |
TABLE_CATALOG 、 、 TABLE_SCHEMA TABLE_NAME |
參考 TABLES。 |
範例
-- Show the columns of the CATALOG_PRIVILEGES relation in the main.information_schema schema.
> SELECT ordinal_position, column_name, data_type
FROM main.information_schema.columns
WHERE table_schema = 'information_schema'
AND table_name = 'catalog_privileges'
ORDER BY ordinal_position;
1 grantor STRING
2 grantee STRING
3 catalog_name STRING
4 privilege_type STRING
5 is_grantable STRING