DESCRIBE PIPE
DESCRIBE PIPE
DESCRIBE PIPE 명령은 파이프(pipe)에 대해 지정된 속성과 속성의 기본값을 설명하는 명령이에요. DESCRIBE는 DESC로 줄여 쓸 수 있습니다.
출처: DESCRIBE PIPE
본문
파이프에 대해 지정된 속성과 속성의 기본값을 설명하는 명령입니다. DESCRIBE는 DESC로 줄여 쓸 수 있어요.
관련 명령: DROP PIPE, ALTER PIPE, CREATE PIPE, SHOW PIPES
Syntax
DESC[RIBE] PIPE <name>
Parameters
name— 설명할 파이프의 식별자를 지정해요. 식별자에 공백이나 특수 문자가 포함되면 전체 문자열을 큰따옴표로 감싸야 합니다. 큰따옴표로 감싼 식별자는 대소문자를 구분해요.
Output (출력)
명령 출력은 다음 컬럼으로 파이프 속성과 메타데이터를 제공해요.
| created_on | name | database_name | schema_name | definition | owner | notification_channel | comment | integration | pattern | error_integration | invalid_reason | kind |
| 컬럼 | 설명 |
|---|---|
created_on |
파이프가 생성된 날짜와 시간. |
name |
파이프 객체의 이름. 수동 생성 파이프: CREATE PIPE 문에 정의된 이름. 기본 파이프(Snowpipe Streaming 고성능): 대상 테이블 이름에서 파생됨. 예: MY_TABLE-STREAMING. |
database_name |
Snowpipe 객체를 포함하는 데이터베이스의 이름. |
schema_name |
Snowpipe 객체를 포함하는 스키마의 이름. |
owner |
파이프 객체에 대한 OWNERSHIP 권한을 가진 역할의 이름. 명명된 파이프: 파이프를 소유한 역할의 이름. 기본 파이프(Snowpipe Streaming 고성능): 이 컬럼은 NULL을 표시. |
comment |
파이프 객체를 설명하는 사용자 제공 또는 시스템 생성 텍스트 문자열. 명명된 파이프: CREATE PIPE 문에서 제공된 사용자 정의 주석. 기본 파이프(Snowpipe Streaming High-Performance): 항상 "Default pipe for Snowpipe Streaming High Performance ingestion to a table. Created and managed by Snowflake."라는 시스템 생성 문자열. |
invalid_reason |
문제가 있을 수 있는 파이프에 대한 일부 상세 정보를 표시. 제공된 정보로 SYSTEM$PIPE_STATUS와 함께 파이프를 더 효과적으로 문제 해결할 수 있습니다. 파이프에 문제가 없으면 값은 NULL. |
Kafka 관련 컬럼 또한 출력에 포함될 수 있어요.
Examples (예제)
CREATE PIPE의 예제에서 만든 mypipe 파이프를 설명해 봅시다.
desc pipe mypipe;
+-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------+
| created_on | name | database_name | schema_name | definition | owner | comment |
|-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------|
| 2017-08-15 06:11:05.703 -0700 | MYPIPE | MYDATABASE | PUBLIC | copy into mytable from @mystage | SYSADMIN | |
+-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------+