UNDROP SCHEMA

UNDROP SCHEMA

드롭된 스키마(schema)의 가장 최근 버전을 복원하는 명령이에요.

출처: 문서

본문

드롭된 스키마의 가장 최근 버전을 복원해요.

구문

UNDROP SCHEMA <name>

매개변수

name

복원할 스키마의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요.

사용 메모

  • 스키마는 삭제 시점에 스키마를 포함하고 있던 데이터베이스에만 복원할 수 있어요. 예를 들어 데이터베이스 db1에서 스키마 s1을 만들고 드롭한 후, 현재 데이터베이스를 db2로 변경하고 스키마 s1을 ID(또는 정규화된 이름 db1.s1)로 복원하려 하면, 스키마 s1은 현재 데이터베이스 db2가 아니라 데이터베이스 db1에 복원돼요.
  • 같은 이름의 스키마가 이미 존재하면 오류가 반환돼요.
  • UNDROP은 Snowflake Time Travel 기능에 의존해요. 객체는 데이터 보존 기간 안에 삭제된 경우에만 복원할 수 있어요. 기본값은 24시간이에요.
  • 지정된 스키마에 속한 하이브리드 테이블은 언드롭되지 않아요.
  • 같은 이름의 드롭된 스키마가 여러 개 있으면 SCHEMATA 뷰의 시스템 생성 식별자와 함께 IDENTIFIER 키워드를 사용해 복원할 스키마를 지정할 수 있어요. 복원된 스키마의 이름은 동일하게 유지돼요. 예제 참고.
  • 노트북, 테이블, 블록 스토리지 스냅샷, 스키마, 데이터베이스에 대한 UNDROP 명령을 실행할 때만 시스템 생성 식별자를 IDENTIFIER() 키워드와 함께 사용할 수 있어요.

예제

기본 예제

드롭된 스키마의 가장 최근 버전 복원(DROP SCHEMA 예제를 기반으로 함):

UNDROP SCHEMA myschema;

+----------------------------------------+
| status                                 |
|----------------------------------------|
| Schema MYSCHEMA successfully restored. |
+----------------------------------------+

SHOW SCHEMAS HISTORY;

+---------------------------------+--------------------+------------+------------+---------------+--------+-----------------------------------------------------------+---------+----------------+------------+
| created_on                      | name               | is_default | is_current | database_name | owner  | comment                                                   | options | retention_time | dropped_on |
|---------------------------------+--------------------+------------+------------+---------------+--------+-----------------------------------------------------------+---------+----------------+------------|
| Fri, 13 May 2016 17:26:07 -0700 | INFORMATION_SCHEMA | N          | N          | MYTESTDB      |        | Views describing the contents of schemas in this database |         |              1 | [NULL]     |
| Tue, 17 Mar 2015 17:18:42 -0700 | MYSCHEMA           | N          | N          | MYTESTDB      | PUBLIC |                                                           |         |              1 | [NULL]     |
| Tue, 17 Mar 2015 16:57:04 -0700 | PUBLIC             | N          | Y          | MYTESTDB      | PUBLIC |                                                           |         |              1 | [NULL]     |
+---------------------------------+--------------------+------------+------------+---------------+--------+-----------------------------------------------------------+---------+----------------+------------+

스키마 ID를 사용한 UNDROP schema

IDENTIFIER()를 사용해 ID로 드롭된 스키마를 복원해요. 언드롭할 특정 스키마의 스키마 ID는 SCHEMATA 뷰의 schema_id 컬럼에서 찾을 수 있어요. 예를 들어 s1이라는 드롭된 스키마가 여러 개 있고, 두 번째로 마지막에 드롭된 스키마 s1을 복원하려면 다음 단계를 따르세요:

Account Usage SCHEMATA 뷰에서 드롭된 스키마의 스키마 ID를 찾아요:

SELECT schema_id,
  schema_name,
  catalog_name,
  created,
  deleted,
  comment
FROM SNOWFLAKE.ACCOUNT_USAGE.SCHEMATA
WHERE schema_name = 'S1'
AND catalog_name = 'DB1'
AND deleted IS NOT NULL
ORDER BY deleted;

+-----------+-------------+---------------+-------------------------------+-------------------------------+---------+
| SCHEMA_ID | SCHEMA_NAME | CATALOG_NAME  | CREATED                       | DELETED                       | COMMENT |
|-----------+-------------+---------------+-------------------------------+-------------------------------+---------|
|       797 | S1          | DB1           | 2024-07-01 17:53:01.955 -0700 | 2024-07-01 17:53:11.889 -0700 | NULL    |
|       798 | S1          | DB1           | 2024-07-01 17:53:11.889 -0700 | 2024-07-01 17:53:16.327 -0700 | NULL    |
|       799 | S1          | DB1           | 2024-07-01 17:53:16.327 -0700 | 2024-07-01 17:53:25.066 -0700 | NULL    |
+-----------+-------------+---------------+-------------------------------+-------------------------------+---------+

스키마 ID로 스키마 s1을 언드롭해요. 두 번째로 마지막에 삭제된 스키마를 복원하려면 이전 문 출력의 스키마 ID 798을 사용해요. 다음 문을 실행하면 스키마가 원래 이름 s1으로 복원돼요:

UNDROP SCHEMA IDENTIFIER(798);

더 알아보기 (Learn more)