DESCRIBE PIPE

파이프에 대해 지정된 속성과 속성의 기본값을 설명합니다.

DESCRIBE는 DESC로 축약할 수 있습니다.

참고 항목:

DROP PIPE , ALTER PIPE , CREATE PIPE , SHOW PIPES

구문

DESC[RIBE] PIPE <name>
Copy

매개 변수

name

설명할 파이프의 식별자를 지정합니다. 식별자에 공백이나 특수 문자가 포함된 경우 전체 문자열을 큰따옴표로 묶어야 합니다. 큰따옴표로 묶인 식별자도 대/소문자를 구분합니다.

사용법 노트

  • 파이프 소유자(즉, 파이프에 대한 OWNERSHIP 권한을 가진 역할), 파이프에 대한 MONITOR 또는 OPERATE 권한을 가진 역할 또는 전역 MONITOR EXECUTION 권한을 가진 역할에 대한 결과만 반환합니다.

  • 파이프의 현재 상태를 확인하려면 SYSTEM$PIPE_STATUS 함수를 쿼리하십시오.

  • 이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.

출력

명령 출력은 다음 열에 파이프 속성 및 메타데이터를 제공합니다.

| created_on | name | database_name | schema_name | definition | owner | notification_channel | comment | integration | pattern | error_integration |
Copy

설명

created_on

파이프가 만들어진 날짜 및 시간입니다.

name

파이프의 이름입니다.

database_name

파이프가 저장된 데이터베이스입니다.

schema_name

파이프가 저장된 스키마입니다.

definition

큐에 대기 중인 파일에서 Snowflake 테이블로 데이터를 로딩하는 데 사용되는 COPY 문입니다.

owner

파이프를 소유한(즉, 파이프에 대한 OWNERSHIP 권한을 가진) 역할의 이름입니다.

notification_channel

DEFINITION 열에 명명된 스테이지에 대한 Amazon SQS 큐의 Amazon 리소스 이름입니다.

comment

이 파이프에 대한 설명입니다.

integration

알림 이벤트를 사용하여 Google Cloud Storage 또는 Microsoft Azure 클라우드 저장소에서 데이터 로딩을 트리거하는 파이프에 대한 알림 통합의 이름입니다.

pattern

복사 옵션이 지정된 경우, 파이프 정의의 COPY INTO <테이블> 문의 PATTERN 복사 옵션 값입니다.

error_integration

알림을 트리거하기 위해 Amazon S3 클라우드 저장소의 오류 이벤트에 의존하는 파이프의 알림 통합 이름입니다.

invalid_reason

문제가 있을 수 있는 파이프에 대한 자세한 정보를 표시합니다. SYSTEM$PIPE_STATUS 와 함께 제공된 정보를 사용하여 파이프 문제를 보다 효과적으로 해결할 수 있습니다. 파이프에 문제가 없으면 값은 NULL입니다.

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 |         |
+-------------------------------+--------+---------------+-------------+---------------------------------+----------+---------+
Copy