COLUMNS

  • [アーティクル]

適用対象:check marked yes Databricks SQL Databricks Runtime 10.4 LTS 以降 「はい」のチェック マーク Unity Catalog のみ

INFORMATION_SCHEMA.COLUMNS を使用して、カタログ内のテーブルとビュー (リレーション) の列について説明します。

返される行は、ユーザーが対話する権限を持つリレーションに限定されます。

定義

COLUMNS リレーションには次の列が含まれています。

名前 データ型 Nullable Standard 説明
TABLE_CATALOG STRING いいえ はい リレーションを含むカタログ。
TABLE_SCHEMA STRING いいえ はい リレーションを含むスキーマ。
TABLE_NAME STRING いいえ はい 列が属するリレーションの名前。
COLUMN_NAME STRING いいえ はい 列の名前です。
ORDINAL_POSITION INTEGER いいえ はい リレーション内の列の位置 (1 から採番)。
COLUMN_DEFAULT STRING いいえ はい INSERT で列が指定されない場合に使われる既定値 (未定義の場合は NULL)。
IS_NULLABLE STRING いいえ はい 列が null 値を許容する場合は YES、それ以外の場合は NO。
DATA_TYPE STRING いいえ はい 列の単純なデータ型名、または STRUCT あるいは ARRAY。
FULL_DATA_TYPE STRING いいえ いいえ 列定義で指定されたデータ型。
CHARACTER_MAXIMUM_LENGTH INTEGER はい はい 常に NULL。将来の使用に備えて予約されています。
CHARACTER_OCTET_LENGTH STRING はい はい 常に NULL。将来の使用に備えて予約されています。
NUMERIC_PRECISION INTEGER はい はい 2 を底とする整数の数値型、FLOAT、および DOUBLE の場合はサポートされているビットの数。 DECIMAL の場合は桁数、それ以外の場合は NULL。
NUMERIC_PRECISION_RADIX INTEGER はい はい 10 の場合は DECIMAL、他のすべての数値型の場合は 2、それ以外の場合は NULL。
NUMERIC_SCALE INTEGER はい はい 整数数値型の場合は 0、DECIMAL の場合は小数点の右側の桁数。それ以外の場合は NULL。
DATETIME_PRECISION INTEGER はい はい DATE の場合は 0、TIMESTAMP、および INTERVAL … SECOND の場合は 3、それ以外の INTERVAL の場合は 0、それ以外の場合は, NULL。
INTERVAL_TYPE STRING はい はい INTERVAL の場合は間隔の単位部分 (例えば'YEAR TO MONTH')、それ以外の場合は NULL。
INTERVAL_PRECISION INTERAL はい はい 常に NULL。将来の使用に備えて予約されています。
MAXIMUM_CARDINALITY INTEGER はい はい 常に NULL。将来の使用に備えて予約されています。
IS_IDENTITY STRING いいえ はい 常に「NO」。将来の使用に備えて予約されています。
IDENTITY_GENERATION STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IDENTITY_START STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IDENTITY_INCREMENT STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IDENTITY_MAXIMUM STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IDENTITY_MINIMUM STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IDENTITY_CYCLE STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IS_GENERATED STRING はい はい 常に NULL。将来の使用に備えて予約されています。
GENERATION_EXPRESSION STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IS_SYSTEM_TIME_PERIOD_START STRING いいえ はい 常に NO。将来の使用に備えて予約されています。
IS_SYSTEM_TIME_PERIOD_END STRING いいえ はい 常に NO。将来の使用に備えて予約されています。
SYSTEM_TIME_PERIOD_TIMESTAMP_GENERATION STRING はい はい 常に NULL。将来の使用に備えて予約されています。
IS_UPDATABLE STRING いいえ はい 列が更新可能な場合は YES、それ以外の場合は NO。
PARTITION_ORDINAL_POSITION INTEGER はい いいえ パーティション内の列の位置 (1 から採番)。パーティション分割列ではない場合は NULL。
COMMENT STRING はい いいえ 列の説明 (省略可能)。

制約

COLUMNS リレーションには、次の制約が適用されます。

クラス 名前 [列一覧] 説明
Primary key (プライマリ キー) COLUMNS_PK TABLE_CATALOG、TABLE_SCHEMA、TABLE_NAME, COLUMN_NAME 列の一意識別子。
一意キー COLUMNS_UK TABLE_CATALOG、TABLE_SCHEMA、TABLE_NAME、ORDINAL_POSITION) 列の一意識別子。
外部キー 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.tables
    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