다음을 통해 공유

SHOW TBLPROPERTIES

  • 아티클

적용 대상:확인 표시된 예 Databricks SQL 확인 표시된 예 Databricks Runtime

속성 키에 대한 선택적 값이 제공된 테이블 속성의 값을 반환합니다. 키를 지정하지 않으면 모든 속성과 옵션이 반환됩니다. 테이블 옵션에는 접두사 option이 붙습니다.

구문

SHOW TBLPROPERTIES table_name
   [ ( [unquoted_property_key | property_key_as_string_literal] ) ]

unquoted_property_key
  key_part1 [. ...]

매개 변수

  • table_name

    테이블을 식별합니다. 이름에는 임시 사양 또는 옵션 사양이 포함되어서는 안됩니다.

  • unquoted_property_key

    따옴표로 묶이지 않은 형식의 속성 키입니다. 키는 점으로 구분된 여러 부분으로 구성될 수 있습니다.

  • 프로퍼티_키_문자열_리터럴

    문자열 리터럴로서의 속성 키 값입니다.

참고

이 문에서 반환하는 속성 값에는 spark 및 hive 내부에 있는 일부 속성이 제외됩니다. 제외되는 속성은 다음과 같습니다.

  • spark.sql 접두사로 시작하는 모든 속성
  • EXTERNAL, comment 등과 같은 속성 키
  • 통계를 저장하기 위해 hive에서 내부적으로 생성한 모든 속성. 이러한 속성 중 일부는 numFiles, numPartitions, numRows입니다.

예제

-- create a table `customer` in schema `salessc`
> USE salessc;
> CREATE TABLE customer(cust_code INT, name VARCHAR(100), cust_addr STRING)
    TBLPROPERTIES ('created.by.user' = 'John', 'created.date' = '01-01-2001');

-- show all the user specified properties for table `customer`
> SHOW TBLPROPERTIES customer;
                   key      value
 --------------------- ----------
       created.by.user       John
          created.date 01-01-2001
 transient_lastDdlTime 1567554931

-- show all the user specified properties for a qualified table `customer`
-- in schema `salessc`
> SHOW TBLPROPERTIES salessc.customer;
                   key      value
 --------------------- ----------
       created.by.user       John
          created.date 01-01-2001
 transient_lastDdlTime 1567554931

-- show value for unquoted property key `created.by.user`
> SHOW TBLPROPERTIES customer (created.by.user);
 value
 -----
  John

-- show value for property `created.date`` specified as string literal
> SHOW TBLPROPERTIES customer ('created.date');
      value
 ----------
 01-01-2001