DROP STAGE
DROP STAGE
현재/지정된 스키마에서 지정한 명명된 내부 또는 외부 스테이지(stage)를 제거하는 명령이에요. 스테이지의 파일 상태는 스테이지 유형에 따라 달라져요.
출처: 문서
본문
구문 (Syntax)
DROP STAGE [ IF EXISTS ] <name>
파라미터
- name — 삭제할 스테이지의 식별자를 지정해요. 식별자에 공백, 특수 문자, 또는 대소문자 혼합 문자가 포함되면 전체 문자열을 큰따옴표로 묶어야 해요. 큰따옴표로 묶은 식별자는 대소문자를 구분해요.
사용 메모 (Usage notes)
- 삭제된 스테이지는 복구할 수 없으므로 다시 만들어야 해요.
- 내부 스테이지의 경우 로딩 상태와 관계없이 스테이지의 모든 파일이 Snowflake에서 제거(purge)돼요. 이는 파일이 계속 스토리지를 사용하여 스토리지 요금이 발생하는 것을 방지해요. 하지만 동시에 스테이지가 삭제된 후에는 스테이징된 파일을 복구할 수 없다는 뜻이기도 해요.
- 외부 스테이지의 경우 스테이지 자체만 삭제돼요. 참조된 외부 위치(Amazon S3, Google Cloud Storage, Microsoft Azure)의 데이터 파일은 제거되지 않아요.
- 이 명령으로 테이블이나 사용자와 연결된 스테이지는 삭제할 수 없어요. 명명된 스테이지(내부 또는 외부)만 삭제할 수 있어요.
IF EXISTS절을 지정했을 때 대상 객체가 존재하지 않으면, 명령은 오류를 반환하지 않고 성공적으로 완료돼요.
예시 (Examples)
DROP STAGE my_stage;
--------------------------------+
status |
--------------------------------+
MY_STAGE successfully dropped. |
--------------------------------+