다음을 통해 공유

SHOW TABLES DROPPED

  • 아티클

적용 대상:예로 표시된 확인 Databricks SQL 예로 표시된 확인 Databricks Runtime 12.2 LTS 이상

Important

이 기능은 공개 미리 보기 상태입니다.

이 명령은 Unity 카탈로그의 스키마 내에서 삭제되었지만 여전히 삭제할 수 있는 모든 테이블을 나열합니다. 특히 보존 기간(기본값은 7일) 내에 삭제된 모든 테이블을 나열합니다. 스키마 또는 카탈로그가 삭제된 경우 오류가 발생합니다. 스키마를 지정하지 않으면 현재 스키마에서 테이블이 반환됩니다.

이 명령은 요청자가 UNDROP할 수 있는 테이블만 나열합니다. 따라서 메타스토어/카탈로그/스키마 소유자는 해당 보안 개체 소유권 내에서 삭제된 모든 테이블을 나열할 수 있는 권한을 갖습니다. 테이블 수준 소유권이 있는 사용자는 부모 카탈로그에 대한 권한과 USE CATALOG 부모 스키마에 대한 권한이 있는 한 USE SCHEMA 입력 카탈로그/스키마 내에서 소유한 테이블만 볼 수 있습니다.

구문

SHOW TABLES DROPPED [ { FROM | IN } schema_name ] [ LIMIT maxResults ]

매개 변수

  • schema_name

    테이블이 나열될 스키마 이름을 지정합니다. 제공되지 않으면 현재 스키마를 사용합니다. 스키마 또는 카탈로그가 없거나 삭제된 경우 SCHEMA_NOT_FOUND 오류가 발생합니다.

  • maxResult

    반환되는 테이블 수를 제한하는 정수 리터럴입니다.

반품

이 명령은 다음 열이 있는 테이블 목록의 보고서를 생성합니다.

속성 데이터 형식 Nullable 설명"
catalogName STRING 아니요 나열된 테이블의 카탈로그 이름입니다.
schemaName STRING 아니요 나열된 테이블의 스키마 이름입니다.
tableName STRING 아니요 삭제된 테이블의 이름입니다.
tableId STRING 아니요 삭제된 테이블의 특정 버전을 식별하고 삭제하지 않는 데 사용할 수 있는 테이블 ID입니다.
tableType STRING 아니요 Unity 카탈로그에서 삭제된 테이블의 형식입니다.
deletedAt STRING 아니요 테이블이 삭제된 시간입니다.
createdAt STRING 아니요 테이블을 만든 시간입니다.
updatedAt STRING 아니요 테이블이 마지막으로 업데이트된 시간입니다.
createdBy STRING 아니요 테이블을 만든 보안 주체입니다.
owner STRING 아니요 테이블을 소유하는 보안 주체입니다.
comment STRING 예 선택적 테이블 주석입니다.

예제

— List dropped tables from an existing schema + catalog.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> CREATE TABLE my_table_2;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

-- Create a new table with name `my_table_1` since other was dropped.
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
> SHOW TABLES DROPPED IN default.my_schema;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner         comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------- -------
  default     my_schema  my_table_1 <uuid>  managed   2023-05-03 AD at 18:17:56 UTC 2023-05-03 AD at 18:17:00 UTC 2023-05-03 AD at 18:17:00 UTC alf@melmak.et alf@melmak.et

— List dropped tables when some are past the retention period.
> USE CATALOG default;
> USE SCHEMA my_schema;
> CREATE TABLE my_table_1;
> DROP TABLE my_table_1;
-- Wait 8 days (1 more than 7 day retention period)
> SHOW TABLES DROPPED;
  catalogname schemaname tablename  tableid tabletype deletedat                     createdat                     updatedat                     createdby     owner        comment
  ----------- ---------- ---------- ------- --------- ----------------------------- ----------------------------- ----------------------------- ------------- ------------ -------