COLUMNS

적용 대상: 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입니다.
FULL_DATA_TYPE	STRING	아니요	아니요	열 정의에 지정된 데이터 형식입니다.
DATA_TYPE	STRING	예	예	열의 단순 데이터 형식 이름 또는 STRUCT 또는 ARRAY입니다.
CHARACTER_MAXIMUM_LENGTH	INTEGER	예	예	NULL은 항상 나중에 사용하도록 예약되었습니다.
CHARACTER_OCTET_LENGTH	STRING	예	예	NULL은 항상 나중에 사용하도록 예약되었습니다.
NUMERIC_PRECISION	INTEGER	예	예	base-2 정수 숫자 형식인 FLOAT 및 DOUBLE의 경우 지원되는 비트 수입니다. DECIMAL의 경우 자릿수, 그렇지 않으면 NULL입니다.
NUMERIC_PRECISION_RADIX	INTEGER	예	예	DECIMAL 10의 경우 다른 모든 숫자 형식 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 관계에 다음과 같은 제한 사항이 적용됩니다.

클래스	속성	열 목록	설명
기본 키	COLUMNS_PK	TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAMECOLUMN_NAME	열의 고유 식별자입니다.
고유 키	COLUMNS_UK	TABLE_CATALOG, TABLE_SCHEMA, TABLE_NAMEORDINAL_POSITION)	열의 고유 식별자입니다.
외래 키	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

관련

• DESCRIBE TABLE
• 정보 스키마
• INFORMATION_SCHEMA.TABLES
• 열 표시
• SHOW TABLE
• 테이블 표시