DESCRIBE STAGE¶
스테이지의 속성에 대해 지정된 값(파일 형식, 복사본, 위치)과 각 속성의 기본값을 설명합니다.
DESCRIBE는 DESC로 축약할 수 있습니다.
- 참고 항목:
구문¶
DESC[RIBE] STAGE <name>
매개 변수¶
name설명할 스테이지의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.
사용법 노트¶
이 명령의 출력을 후처리하기 위해 파이프 연산자 (
->>) 또는 RESULT_SCAN 함수를 사용할 수 있습니다. 두 구문 모두 출력을 쿼리할 수 있는 결과 세트로 간주합니다.For example, you can use the pipe operator or RESULT_SCAN function to select specific columns from the SHOW command output or filter the rows.
When you refer to the output columns, use double-quoted identifiers for the column names. For example, to select the output column
type, specifySELECT "type".You must use double-quoted identifiers because the output column names for SHOW commands are in lowercase. The double quotes ensure that the column names in the SELECT list or WHERE clause match the column names in the SHOW command output that was scanned.
출력¶
명령 출력은 다음 열에 스테이지 속성 및 메타데이터를 제공합니다.
열 |
설명 |
|---|---|
|
각 스테이지 속성이 속한 상위 속성입니다. 가능한 값으로는 STAGE_FILE_FORMAT, STAGE_COPY_OPTIONS, STAGE_LOCATION, STAGE_CREDENTIALS, DIRECTORY가 포함됩니다. |
|
속성의 이름입니다. 속성 설명은 CREATE STAGE 섹션을 참조하십시오. |
|
속성 유형입니다. |
|
속성에 할당된 값입니다. |
|
기본 속성 값입니다. |
참고
디렉터리 테이블이 있는 스테이지의 경우 출력에 TIMESTAMP 유형의 LAST_REFRESHED_ON이라는 속성이 포함됩니다. LAST_REFRESHED_ON은 디렉터리 테이블의 메타데이터가 수동 또는 자동으로 스테이지의 연결된 파일과 마지막으로 동기화된 시간을 나타냅니다.
예¶
이름이 my_s3_stage 인 내부 스테이지 설명하기:
DESC STAGE my_s3_stage; +--------------------+--------------------------------+---------------+-------------------------------------------------------+------------------+ | parent_property | property | property_type | property_value | property_default | |--------------------+--------------------------------+---------------+-------------------------------------------------------+------------------| | STAGE_FILE_FORMAT | TYPE | String | CSV | CSV | | STAGE_FILE_FORMAT | RECORD_DELIMITER | String | \n | \n | | STAGE_FILE_FORMAT | FIELD_DELIMITER | String | , | , | | STAGE_FILE_FORMAT | FILE_EXTENSION | String | | | | STAGE_FILE_FORMAT | SKIP_HEADER | Integer | 0 | 0 | | STAGE_FILE_FORMAT | DATE_FORMAT | String | AUTO | AUTO | | STAGE_FILE_FORMAT | TIME_FORMAT | String | AUTO | AUTO | | STAGE_FILE_FORMAT | TIMESTAMP_FORMAT | String | AUTO | AUTO | | STAGE_FILE_FORMAT | BINARY_FORMAT | String | HEX | HEX | | STAGE_FILE_FORMAT | ESCAPE | String | NONE | NONE | | STAGE_FILE_FORMAT | ESCAPE_UNENCLOSED_FIELD | String | \\ | \\ | | STAGE_FILE_FORMAT | TRIM_SPACE | Boolean | false | false | | STAGE_FILE_FORMAT | FIELD_OPTIONALLY_ENCLOSED_BY | String | NONE | NONE | | STAGE_FILE_FORMAT | NULL_IF | List | [\\N] | [\\N] | | STAGE_FILE_FORMAT | COMPRESSION | String | AUTO | AUTO | | STAGE_FILE_FORMAT | ERROR_ON_COLUMN_COUNT_MISMATCH | Boolean | true | true | | STAGE_FILE_FORMAT | VALIDATE_UTF8 | Boolean | true | true | | STAGE_FILE_FORMAT | SKIP_BLANK_LINES | Boolean | false | false | | STAGE_FILE_FORMAT | REPLACE_INVALID_CHARACTERS | Boolean | false | false | | STAGE_FILE_FORMAT | EMPTY_FIELD_AS_NULL | Boolean | true | true | | STAGE_FILE_FORMAT | SKIP_BYTE_ORDER_MARK | Boolean | true | true | | STAGE_FILE_FORMAT | ENCODING | String | UTF8 | UTF8 | | STAGE_COPY_OPTIONS | ON_ERROR | String | ABORT_STATEMENT | ABORT_STATEMENT | | STAGE_COPY_OPTIONS | SIZE_LIMIT | Long | | | | STAGE_COPY_OPTIONS | PURGE | Boolean | false | false | | STAGE_COPY_OPTIONS | RETURN_FAILED_ONLY | Boolean | false | false | | STAGE_COPY_OPTIONS | ENFORCE_LENGTH | Boolean | true | true | | STAGE_COPY_OPTIONS | TRUNCATECOLUMNS | Boolean | false | false | | STAGE_COPY_OPTIONS | FORCE | Boolean | false | false | | STAGE_LOCATION | URL | String | ["s3://EXAMPLE-S3-PATH/my-csvfiles/"] | | | STAGE_CREDENTIALS | AWS_KEY_ID | String | | | | DIRECTORY | LAST_REFRESHED_ON | Timestamp | 2023-05-03 12:50:28.000 -0700 | | | DIRECTORY | ENABLE | Boolean | true | false | | DIRECTORY | AUTO_REFRESH | Boolean | false | false | +--------------------+--------------------------------+---------------+-------------------------------------------------------+------------------+