カテゴリ：

テーブル、ビュー、シーケンス DDL

SHOW MATERIALIZED VIEWS

Snowflake logo in black (no text) Enterprise Editionの機能

マテリアライズドビューにはEnterprise Editionが必要です。アップグレードについては、 Snowflakeサポート にお問い合わせください。

アクセスする権限があるマテリアライズドビューをリストします。

マテリアライズドビューの詳細については、 マテリアライズドビューの使用 をご参照ください。

こちらもご参照ください。

CREATE MATERIALIZED VIEW、 ALTER MATERIALIZED VIEW、 DROP MATERIALIZED VIEW、 DESCRIBE MATERIALIZED VIEW

構文

SHOW MATERIALIZED VIEWS [ LIKE '<pattern>' ]
                [ IN { ACCOUNT | DATABASE [ <db_name> ] | [ SCHEMA ] [ <schema_name> ] } ]

パラメーター

LIKE 'パターン'

オブジェクト名でコマンド出力をフィルタリングします。フィルターは、 SQL ワイルドカード文字（% および _）をサポートする、 大文字と小文字を区別しない パターンマッチングを使用します。

たとえば、次のパターンは同じ結果を返します。

... LIKE '%testing%' ...
... LIKE '%TESTING%' ...
IN ACCOUNT | [ DATABASE ] データベース名 | [ SCHEMA ] スキーマ名

コマンドのスコープを指定します。これは、コマンドが現在/指定されたデータベースまたはスキーマのレコードのみを一覧表示するか、アカウント全体に表示するかを決定します。

DATABASE または SCHEMA キーワードは必須ではありません。データベースまたはスキーマ名のみを指定して、スコープを設定できます。同様に、セッションで現在使用中のデータベースがある場合、データベース名またはスキーマ名は必要ありません。

  • DATABASE または SCHEMA が名前なしで指定され、セッションで現在使用中のデータベースがない場合、パラメーターは出力に影響しません。

  • SCHEMA が名前で指定され、セッションで現在使用中のデータベースがない場合、スキーマ名はデータベース名で完全修飾する 必要があります （例： testdb.testschema）。

デフォルト: セッションで現在使用中のデータベースがあるかどうかによって異なります。

  • データベース： DATABASE はデフォルトです（つまり、コマンドは、データベースで表示する権限を持つオブジェクトを返す）。

  • データベースなし： ACCOUNT はデフォルトです（つまり、コマンドは、アカウントで表示する権限を持つオブジェクトを返す）。

使用上の注意

  • このコマンドは、実行中のウェアハウスを必要としません。

  • コマンドは、コマンドを実行するために使用されるロールのアクセス権によって決定された通り、指定されたオブジェクトタイプに対して 最大 10Kのレコードを返します。フィルタが適用されていても、10Kの制限を超えるレコードは返されません。

    10Kを超えるレコードが存在する結果を表示するには、 Snowflake Information Schema で対応するビュー（存在する場合）をクエリします。

  • このコマンドの出力を後処理するには、 RESULT_SCAN 関数を使用できます。この関数は、出力をクエリ可能なテーブルとして扱います。

  • 出力列は SHOW TABLES の出力列に似ていますが、次の追加の列が含まれています。

    • refreshed_on：最終更新時間。

    • compacted_on：最終圧縮時間。

    • behind_by：ベーステーブルからの変更でマテリアライズドビューを更新するバックグラウンドプロセスがまだマテリアライズドビューを最新にしていない場合、この列は、マテリアライズドビューがベーステーブルの「背後」にあるおよその秒数を示します。マテリアライズドビューが最新ではないと表示されている場合でも、マテリアライズドビューに対するクエリは最新の結果を返します（ベーステーブルから追加情報を取得するために多少時間がかかる場合あり）。

  • コマンド SHOW VIEWS は、マテリアライズドビューに関する情報も表示します。

出力

コマンド出力は、次の列の列プロパティとメタデータを提供します。

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

列

説明

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

マテリアライズドビューが現在無効である場合（たとえば、ビューが使用する列をベーステーブルが削除した場合）はTrue。それ以外の場合はfalse。

invalid_reason

マテリアライズドビューが現在無効である理由（存在する場合）。

behind_by

ベーステーブルの更新に対して、マテリアライズドビューの更新が遅れる度合い。

comment

オプションのコメント。

text

このマテリアライズドビューを作成したコマンドのテキスト（例： CREATE MATERIALIZED VIEW ...）。

is_secure

マテリアライズドビューがセキュアビューである場合はtrue。それ以外の場合はfalse。

automatic_clustering

ビューがクラスター化済み かつ クラスタリングが自動の場合はTrue。

例

マテリアライズドビューをすべて表示します。

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 |
|-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------|----------------------+
| 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;     |           |                      |
+-------------------------------+------+----------+---------------+-------------+------------+------+-------+----------------------+--------------------+-------------------+-------------------------------+--------------+----------+---------+----------------+-----------+---------+--------------------------------------------+-----------+----------------------+
⇧
最上部に戻る