SHOW <오브젝트>

지정된 오브젝트 유형의 기존 오브젝트를 나열합니다. 출력에는 다음을 비롯한 오브젝트의 메타데이터가 포함됩니다.

  • 공통 속성(이름, 생성 타임스탬프, 소유 역할, 설명 등)

  • 개체별 속성

참고 항목:

CREATE <오브젝트> , DESCRIBE <오브젝트>

구문

SHOW <object_type_plural> [ LIKE '<pattern>' ] [ IN <scope_object_type> [ <scope_object_name> ] ]
Copy

특정 구문, 사용법 노트, 예제는 다음을 참조하십시오.

계정 작업

세션/사용자 작업:

계정 오브젝트:

데이터베이스 오브젝트:

클래스:

일반적인 사용법 노트

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

  • SHOW 명령은 현재 사용자의 현재 역할에 필요한 액세스 권한이 부여된 오브젝트만 반환합니다. 예:

    • SHOW DATABASES 출력은 사용자의 역할이 OWNERSHIP 또는 USAGE 권한을 가진 데이터베이스를 포함합니다.

    • SHOW SCHEMAS 출력은 사용자의 역할이 OWNERSHIP 또는 USAGE 권한을 가진 스키마를 포함합니다.

    • SHOW TABLES 출력은 사용자의 역할이 임의의 권한을 가진 테이블을 포함합니다. 또한, 이 역할은 부모 데이터베이스와 스키마에 대한 USAGE 권한도 있어야 합니다.

    • MANAGE GRANTS 액세스 권한은 그 권한을 보유한 자가 계정에 있는 모든 오브젝트를 볼 수 있도록 암시적으로 허용합니다. 기본적으로, 계정 관리자(ACCOUNTADMIN 역할 이 있는 사용자)와 보안 관리자(SECURITYADMIN 역할이 있는 사용자)만 MANAGE GRANTS 권한을 가집니다.

  • SHOW 명령 대부분의 출력은 다음 절을 사용해 제어할 수 있습니다.

    • 선택적 LIKE 절을 사용해 이름을 기준으로 반환된 오브젝트의 목록을 필터링할 수 있습니다.

    • 데이터베이스 오브젝트 유형은 명령의 범위를 특정 스키마나 데이터베이스 또는 전체 계정으로 설정하는 데 사용할 수 있는 선택적 IN 절을 추가로 제공합니다.

    참고

    데이터베이스 컨텍스트에서 IN 절 없이 SHOW 명령을 사용하면 예상보다 적은 결과를 얻을 수 있습니다.

    IN 절이 사용되지 않는 경우 같은 이름을 가진 오브젝트는 한 번만 표시됩니다. 예를 들어, schema1t1, schema2t1 테이블이 있고 두 테이블이 모두 지정한 데이터베이스 컨텍스트의 범위에 있는 경우(즉, 선택한 데이터베이스가 schema1schema2 의 부모인 경우), SHOW TABLES는 t1 테이블 중 하나만 표시합니다.

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

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

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

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

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