SHOW MATERIALIZED VIEWS¶
Lista as exibições materializadas para as quais você tem privilégios de acesso.
Para obter mais informações sobre exibições materializadas, consulte Como trabalhar com exibições materializadas.
- Consulte também:
CREATE MATERIALIZED VIEW , ALTER MATERIALIZED VIEW , DROP MATERIALIZED VIEW , DESCRIBE MATERIALIZED VIEW
Sintaxe¶
SHOW MATERIALIZED VIEWS [ LIKE '<pattern>' ]
[ IN
{
ACCOUNT |
DATABASE |
DATABASE <database_name> |
SCHEMA |
SCHEMA <schema_name> |
<schema_name>
}
]
Parâmetros¶
LIKE 'pattern'
Filtra a saída do comando pelo nome do objeto. O filtro utiliza correspondência de padrão que não diferencia maiúsculas e minúsculas, com suporte para caracteres curinga SQL (
%
e_
).Por exemplo, os seguintes padrões retornam os mesmos resultados:
... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
[ IN ... ]
Opcionalmente, especifica o escopo do comando. Especifique um dos seguintes:
ACCOUNT
Retorna registros para toda a conta.
DATABASE
, .DATABASE db_name
Retorna registros do banco de dados atual em uso ou de um banco de dados especificado (
db_name
).Se você especificar
DATABASE
semdb_name
e nenhum banco de dados estiver em uso, a palavra-chave não terá efeito sobre a saída.SCHEMA
, .SCHEMA schema_name
, .schema_name
Retorna registros do esquema atual em uso ou de um esquema especificado (
schema_name
).SCHEMA
é opcional se um banco de dados estiver em uso ou se você especificar oschema_name
totalmente qualificado (por exemplo,db.schema
).Se nenhum banco de dados estiver em uso, a especificação
SCHEMA
não terá efeito sobre a saída.
Padrão: depende se a sessão tem ou não um banco de dados em uso no momento:
Banco de dados:
DATABASE
é o padrão (ou seja, o comando retorna os objetos nos quais você tem privilégios para visualizar no banco de dados).Sem banco de dados:
ACCOUNT
é o padrão (ou seja, o comando retorna os objetos que você tem privilégios de visualização em sua conta).
Notas de uso¶
O comando não precisa de um warehouse em funcionamento para ser executado.
O comando retorna um máximo de 10 mil registros para o tipo de objeto especificado, como ditado pelos privilégios de acesso para a função usada para executar o comando; quaisquer registros acima do limite 10 mil não são retornados, mesmo com um filtro aplicado.
Para visualizar resultados para os quais existem mais de 10.000 registros, consulte a visualização correspondente (se houver) em Snowflake Information Schema.
Para pós-processar a saída deste comando, você pode usar a função RESULT_SCAN, que trata a saída como uma tabela que pode ser consultada.
As colunas de saída são semelhantes às colunas de saída para SHOW TABLES, mas incluem as seguintes colunas adicionais:
refreshed_on: hora da última atualização.
compacted_on: hora da última compactação.
behind_by: se o processo em segundo plano que atualiza a exibição materializada com mudanças da tabela base ainda não atualizou a exibição materializada, então esta coluna mostra aproximadamente quantos segundos a exibição materializada está “atrás” da tabela base. Observe que mesmo que isto mostre que a exibição materializada não esteja atualizada, quaisquer consultas na exibição materializada ainda retornarão resultados atualizados (eles podem demorar um pouco mais, pois informações extras são recuperadas da tabela base).
O comando
SHOW VIEWS
também mostra informações sobre exibições materializadas.
Saída¶
A saída do comando fornece as propriedades das colunas e metadados nas seguintes colunas:
| 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 |
Coluna |
Descrição |
---|---|
|
O carimbo de data/hora em que a exibição materializada foi criada. |
|
O nome da exibição materializada. |
|
(Reservado para uso futuro). |
|
O nome do banco de dados no qual existe a exibição materializada. |
|
O nome do esquema em que a exibição materializada existe. |
|
Informações sobre as colunas de clustering (se a exibição materializada for clusterizada). |
|
O número de linhas na exibição materializada. |
|
O número de bytes de dados na exibição materializada. |
|
O nome do banco de dados no qual existe a tabela base da exibição materializada. |
|
O nome do esquema no qual existe a tabela base da exibição materializada. |
|
O nome da tabela base da exibição materializada. |
|
O carimbo de data/hora em que a exibição materializada foi atualizada pela última vez. |
|
O carimbo de data/hora em que a exibição materializada foi compactada pela última vez. |
|
O proprietário da exibição materializada. |
|
Verdadeiro se a exibição materializada for atualmente inválida (por exemplo, se a tabela base descartou uma coluna que a exibição usou); caso contrário, falso. |
|
A razão (se houver) pela qual a exibição materializada é atualmente inválida. |
|
Até que ponto as atualizações da exibição materializada estão atrasadas em relação às atualizações da tabela base. |
|
Comentário opcional. |
|
O texto do comando que criou esta exibição materializada (por exemplo, |
|
Verdadeiro se a exibição materializada for uma exibição segura; falso caso contrário. |
|
Verdade se a exibição for clusterizada e o clustering for automático. |
Exemplos¶
Mostrar todas as exibições materializadas:
SHOW MATERIALIZED VIEWS;
Mostrar apenas exibições materializadas com nomes que correspondam à expressão regular especificada:
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 | |-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------|----------------------+ | 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 | | | | | | | | | | | | | | | | | | | | SELECT ID, price FROM inventory; | | | +-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------+----------------------+