共用方式為


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或 STRUCTARRAY的簡單數據類型名稱。
CHARACTER_MAXIMUM_LENGTH INTEGER Yes Yes 一律為 NULL,保留供未來使用。
CHARACTER_OCTET_LENGTH STRING Yes Yes 一律為 NULL,保留供未來使用。
NUMERIC_PRECISION INTEGER Yes Yes 對於base-2整數數值類型、 FLOATDOUBLE,則為支援的位數。 若 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,針對 DATETIMESTAMPINTERVAL ... 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_SCHEMATABLE_NAMECOLUMN_NAME 適用於 column的獨特 identifier。
唯一索引鍵 COLUMNS_UK TABLE_CATALOG、、TABLE_SCHEMATABLE_NAMEORDINAL_POSITION 唯一的 identifiercolumn。
外部索引鍵 COLUMN_TABLES_FK TABLE_CATALOG、 、 TABLE_SCHEMATABLE_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