SHOW PIPES

액세스 권한이 있는 파이프를 나열합니다. 이 명령을 사용해 지정된 데이터베이스 또는 스키마(또는 세션의 현재 데이터베이스/스키마) 또는 전체 계정에 대한 파이프를 나열할 수 있습니다.

참고 항목:

ALTER PIPE , CREATE PIPE , DESCRIBE PIPE , DROP PIPE

구문

SHOW PIPES [ LIKE '<pattern>' ]
           [ IN
                {
                  ACCOUNT                  |

                  DATABASE                 |
                  DATABASE <database_name> |

                  SCHEMA                   |
                  SCHEMA <schema_name>     |
                  <schema_name>
                }
           ]
Copy

매개 변수

LIKE 'pattern'

오브젝트 이름으로 명령 출력을 선택적으로 필터링합니다. 이 필터는 SQL 와일드카드 문자(% 및 _) 지원과 함께 대/소문자를 구분하지 않는 패턴 일치를 사용합니다.

예를 들어, 다음 패턴은 같은 결과를 반환합니다.

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...

. 기본값: 값 없음(출력에 필터링이 적용되지 않음).

[ IN ... ]

선택적으로 명령의 범위를 지정합니다. 다음 중 하나를 지정합니다.

ACCOUNT

전체 계정의 레코드를 반환합니다.

DATABASE, . DATABASE db_name

현재 사용 중인 데이터베이스 또는 지정된 데이터베이스(db_name)의 레코드를 반환합니다.

db_name 없이 DATABASE 를 지정하고 사용 중인 데이터베이스가 없는 경우 키워드는 출력에 아무런 영향도 주지 않습니다.

SCHEMA, . SCHEMA schema_name, . schema_name

현재 사용 중인 스키마 또는 지정된 스키마(schema_name)의 레코드를 반환합니다.

데이터베이스가 사용 중이거나 정규화된 schema_name (예: db.schema)을 지정하는 경우 SCHEMA 는 선택 사항입니다.

사용 중인 데이터베이스가 없으면 SCHEMA 를 지정해도 출력에 아무런 영향도 주지 않습니다.

기본값: 세션에 현재 사용 중인 데이터베이스가 있는지 여부에 따라 다릅니다.

  • 데이터베이스: DATABASE 가 기본값입니다(즉, 이 명령은 데이터베이스에서 볼 권한이 있는 오브젝트를 반환함).

  • 데이터베이스 없음: ACCOUNT 가 기본값입니다(즉, 이 명령은 계정에서 볼 권한이 있는 오브젝트를 반환함).

사용법 노트

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

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

  • 접두사 is_ 로 시작하는 열은 Y (예) 또는 N (아니요)을 반환합니다.

  • 이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.

  • 이 명령은 명령을 실행하는 데 사용되는 역할에 대한 액세스 권한에 따라 지정된 오브젝트 유형에 대해 최대 10,000개의 레코드를 반환합니다. 필터가 적용된 경우에도 10,000개의 제한을 초과하는 레코드는 반환되지 않습니다.

    10,000개 이상의 레코드가 존재하는 결과를 보려면 Snowflake Information Schema 에서 해당 뷰(있는 경우)를 쿼리하십시오.

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

출력

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

열

설명

created_on

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

이름

파이프의 이름입니다.

데이터베이스_이름

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

스키마_이름

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

definition

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

owner

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

notification_channel

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

comment

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

integration

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

패턴

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

error_integration

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

owner_role_type

오브젝트를 소유하는 역할 유형(ROLE 또는 DATABASE_ROLE)입니다. . Snowflake Native App 이 오브젝트를 소유한 경우 값은 APPLICATION 입니다. . 삭제된 오브젝트에 소유자 역할이 없으므로 오브젝트를 삭제하는 경우 Snowflake는 NULL을 반환합니다.

invalid_reason

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

예산

오브젝트가 예산으로 모니터링되는 경우 예산 의 이름입니다. 그렇지 않으면 NULL입니다.

예

mydb 데이터베이스의 public 스키마에서 볼 권한이 있는 모든 파이프를 표시합니다.

use database mydb;

show pipes;
Copy
언어: 한국어