SHOW MATERIALIZED VIEWS¶
액세스 권한이 있는 구체화된 뷰를 나열합니다.
구체화된 뷰에 대한 자세한 내용은 구체화된 뷰 작업하기 를 참조하십시오.
- 참고 항목:
CREATE MATERIALIZED VIEW , ALTER MATERIALIZED VIEW , DROP MATERIALIZED VIEW , DESCRIBE MATERIALIZED VIEW
구문¶
SHOW MATERIALIZED VIEWS [ LIKE '<pattern>' ]
[ IN
{
ACCOUNT |
DATABASE |
DATABASE <database_name> |
SCHEMA |
SCHEMA <schema_name> |
<schema_name>
}
]
매개 변수¶
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
가 기본값입니다(즉, 이 명령은 계정에서 볼 권한이 있는 오브젝트를 반환함).
사용법 노트¶
접두사
is_
로 시작하는 열은Y
(예) 또는N
(아니요)을 반환합니다.이 명령을 실행하기 위해 실행 중인 웨어하우스가 꼭 필요하지는 않습니다.
이 명령은 명령을 실행하는 데 사용되는 역할에 대한 액세스 권한에 따라 지정된 오브젝트 유형에 대해 최대 10,000개의 레코드를 반환합니다. 필터가 적용된 경우에도 10,000개의 제한을 초과하는 레코드는 반환되지 않습니다.
10,000개 이상의 레코드가 존재하는 결과를 보려면 Snowflake Information Schema 에서 해당 뷰(있는 경우)를 쿼리하십시오.
이 명령의 출력을 사후 처리하려면 출력을 쿼리할 수 있는 테이블로 처리하는 RESULT_SCAN 함수를 사용하면 됩니다.
출력 열은 SHOW TABLES 의 출력 열과 유사하지만, 다음과 같은 추가 열을 포함합니다.
refreshed_on: 기본 테이블에서 “새로 고침” 작업 으로 처리된 마지막 DML 작업 시간입니다.
compacted_on: 기본 테이블에서 “압축” 작업 으로 처리된 마지막 DML 작업 시간입니다.
behind_by: 기본 테이블의 변경 사항으로 구체화된 뷰를 업데이트하는 백그라운드 프로세스가 아직 구체화된 뷰를 최신 상태로 만들지 않은 경우, 이 열은 구체화된 뷰가 기본 테이블 “뒤에” 있는 대략적인 시간(초)을 보여줍니다. 이것이 구체화된 뷰가 최신 상태가 아님을 보여주더라도, 구체화된 뷰에 대한 모든 쿼리는 여전히 최신 결과를 반환합니다(단, 기본 테이블에서 추가 정보가 검색되므로 시간이 조금 더 걸릴 수 있음).
SHOW VIEWS
명령을 실행하면 구체화된 뷰에 대한 정보도 표시됩니다.
출력¶
명령 출력은 다음 열에 구체화된 뷰 속성 및 메타데이터를 제공합니다.
열 |
설명 |
---|---|
created_on |
구체화된 뷰가 생성된 타임스탬프입니다. |
이름 |
구체화된 뷰의 이름입니다. |
reserved |
향후 사용을 위해 예약되어 있습니다. |
데이터베이스_이름 |
구체화된 뷰가 있는 데이터베이스의 이름입니다. |
스키마_이름 |
구체화된 뷰가 있는 스키마의 이름입니다. |
cluster_by |
클러스터링 열에 대한 정보입니다(구체화된 뷰가 클러스터링된 경우). |
rows |
구체화된 뷰의 행 수입니다. |
bytes |
구체화된 뷰의 데이터 바이트 수입니다. |
source_database_name |
구체화된 뷰의 기본 테이블이 있는 데이터베이스의 이름입니다. |
source_schema_name |
구체화된 뷰의 기본 테이블이 있는 스키마의 이름입니다. |
source_table_name |
구체화된 뷰의 기본 테이블 이름입니다. |
refreshed_on |
기본 테이블에서 “새로 고침” 작업 으로 처리된 마지막 DML 작업의 타임스탬프입니다. |
compacted_on |
기본 테이블에서 “압축” 작업 으로 처리된 마지막 DML 작업의 타임스탬프입니다. |
owner |
구체화된 뷰의 소유자입니다. |
invalid |
구체화된 뷰가 현재 유효하지 않은 경우(예: 기본 테이블이 뷰가 사용한 열을 삭제한 경우) True이고, 그렇지 않으면 False입니다. |
invalid_reason |
구체화된 뷰가 현재 유효하지 않은 이유(있는 경우)입니다. |
behind_by |
구체화된 뷰의 업데이트가 기본 테이블의 업데이트보다 얼마나 뒤에 있는지 나타냅니다. |
comment |
선택적 설명입니다. |
text |
이 구체화된 뷰를 만든 명령의 텍스트입니다(예: CREATE MATERIALIZED VIEW …). |
is_secure |
구체화된 뷰가 보안 뷰이면 True이고, 그렇지 않으면 False입니다. |
automatic_clustering |
뷰가 클러스터링된 동시에 클러스터링이 자동이면 True입니다. |
owner_role_type |
오브젝트를 소유하는 역할 유형( |
예산 |
오브젝트가 예산으로 모니터링되는 경우 예산 의 이름입니다. 그렇지 않으면 NULL입니다. |
owner_role_type |
오브젝트를 소유하는 역할 유형( |
예¶
구체화된 뷰를 전부 표시합니다.
SHOW MATERIALIZED VIEWS;
지정된 정규식과 이름이 일치하는 구체화된 뷰만 표시합니다.
SHOW MATERIALIZED VIEWS LIKE 'mv1%'; +-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------+----------------------+-----------------+----------+ | created_on | name | reserved | database_name | schema_name | cluster_by | rows | bytes | source_database_name | source_schema_name | source_table_name | refreshed_on | compacted_on | owner | invalid | invalid_reason | behind_by | comment | text | is_secure | automatic_clustering | owner_role_type | budget | |-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------|----------------------+-----------------+----------| | 2018-10-05 17:13:17.579 -0700 | MV1 | | TEST_DB1 | PUBLIC | | 0 | 0 | TEST_DB1 | PUBLIC | INVENTORY | 2018-10-05 17:13:50.373 -0700 | NULL | SYSADMIN | false | NULL | 0s | | CREATE OR REPLACE MATERIALIZED VIEW mv1 AS | false | OFF | ROLE | MYBUDGET | | | | | | | | | | | | | | | | | | | | SELECT ID, price FROM inventory; | | | | | +-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------+----------------------+-----------------+----------+