- スキーマ:
 
TABLES ビュー¶
重要
この表示は組織アカウントでのみ利用可能です。詳細については、 組織アカウントのプレミアムビュー をご参照ください。
このOrganization Usageビューは、アカウント内の各テーブルとビューの行を表示します。
- こちらもご参照ください。
 COLUMNS ビュー 、 VIEWS ビュー、 TABLES ビュー (Information Schema)
列¶
組織レベルの列
列名  | 
データ型  | 
説明  | 
|---|---|---|
ORGANIZATION_NAME  | 
VARCHAR  | 
組織の名前。  | 
ACCOUNT_LOCATOR  | 
VARCHAR  | 
システムが生成したアカウントの識別子。  | 
ACCOUNT_NAME  | 
VARCHAR  | 
ユーザー定義のアカウント識別子。  | 
追加列
列名  | 
データ型  | 
説明  | 
|---|---|---|
TABLE_ID  | 
NUMBER  | 
Snowflakeが生成するテーブルの内部識別子。  | 
TABLE_NAME  | 
VARCHAR  | 
テーブルの名前。  | 
TABLE_SCHEMA_ID  | 
NUMBER  | 
Snowflakeが生成するテーブルのスキーマの内部識別子。  | 
TABLE_SCHEMA  | 
VARCHAR  | 
テーブルが属するスキーマ。  | 
TABLE_CATALOG_ID  | 
NUMBER  | 
Snowflakeが生成するテーブルのデータベースの内部識別子。  | 
TABLE_CATALOG  | 
VARCHAR  | 
テーブルが属するデータベース。  | 
TABLE_OWNER  | 
VARCHAR  | 
テーブルを所有するロールの名前。  | 
TABLE_TYPE  | 
VARCHAR  | 
テーブル型を示します。有効な値は、   | 
IS_TRANSIENT  | 
VARCHAR  | 
テーブルが一時的かどうか。  | 
CLUSTERING_KEY  | 
VARCHAR  | 
テーブルのクラスタリングキーを構成する列および/または式。  | 
ROW_COUNT  | 
NUMBER  | 
テーブル内の行数。  | 
BYTES  | 
NUMBER  | 
テーブルのスキャンによってアクセスされたバイト数。  | 
RETENTION_TIME  | 
NUMBER  | 
Time Travelの履歴データが保持される日数。  | 
SELF_REFERENCING_COLUMN_NAME  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
REFERENCE_GENERATION  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
USER_DEFINED_TYPE_CATALOG  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
USER_DEFINED_TYPE_SCHEMA  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
USER_DEFINED_TYPE_NAME  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
IS_INSERTABLE_INTO  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
IS_TYPED  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
COMMIT_ACTION  | 
VARCHAR  | 
Snowflakeには適用されません。  | 
CREATED  | 
TIMESTAMP_LTZ  | 
テーブルが作成された日時。  | 
LAST_ALTERED  | 
TIMESTAMP_LTZ  | 
オブジェクトが DML、 DDL、 またはバックグラウンドでのメタデータ処理によって最後に変更された日時。使用上の注意 をご参照ください。  | 
LAST_DDL  | 
TIMESTAMP_LTZ  | 
テーブルまたはビューに対して最後に実行された DDL 操作のタイムスタンプ。 サポートされているすべてのテーブル/ビュー DDL 操作は、このフィールドを更新します。 
 テーブルパラメーターの設定解除(例: COMMENT、 DATA_RETENTION_TIME など)、テーブル例の変更(ADD / MODIFY / RENAME / DROP)など、 ALTER TABLE の操作はすべてこのフィールドを更新します。 詳細については、 使用上の注意 をご参照ください。  | 
LAST_DDL_BY  | 
VARCHAR  | 
最後に DDL 操作を実行したユーザーの現在のユーザー名。ユーザーがドロップされた場合は、  削除されたユーザーの場合、 ACCOUNT_USAGE または ORGANIZATION_USAGE スキーマの USERS ビューで、   | 
DELETED  | 
TIMESTAMP_LTZ  | 
テーブルがドロップされた日時。  | 
AUTO_CLUSTERING_ON  | 
VARCHAR  | 
テーブルの自動クラスタリングのステータス。詳細については、 テーブルの自動クラスタリングステータスの表示 をご参照ください。  | 
COMMENT  | 
VARCHAR  | 
テーブルのコメント。  | 
OWNER_ROLE_TYPE  | 
VARCHAR  | 
オブジェクトを所有するロールのタイプ。例えば   | 
INSTANCE_ID  | 
NUMBER  | 
オブジェクトが属するインスタンスの内部/システム生成識別子。  | 
IS_ICEBERG  | 
VARCHAR  | 
テーブルが Icebergテーブル かどうかを示します。有効な値は   | 
IS_DYNAMIC  | 
VARCHAR  | 
テーブルが 動的テーブル かどうかを示します。有効な値は   | 
IS_HYBRID  | 
VARCHAR  | 
テーブルが ハイブリッドテーブル であるかどうかを示します。有効な値は   | 
使用上の注意¶
ビューの遅延は最大24時間です。
ビューは MANAGE GRANTS 権限を尊重しないため、 MANAGE GRANTS 権限を持つユーザーが両方を実行する場合、 SHOW コマンドよりも表示される情報が少なくなる場合があります。
テーブルの
SUM(BYTES)をクエリしても、合計ストレージ使用量は示されません。これは、量にTime TravelとFail-safeの使用量が含まれていないためです。LAST_ALTERED 列の値をTime Travelに使用することは 推奨されておらず、以下の理由により予期せぬ結果を返す可能性があります。
Time Travelは、 DML の操作 によって変更された履歴データをクエリするためにのみ使用できます。
LAST_ALTERED 列には、 DML と DDL の両方の操作が含まれます(次の使用上の注意を参照)。
DML 操作の場合、 LAST_ALTERED 列の値は、このステートメントを含むトランザクションのコミット時刻ではなく、ステートメント実行開始時のタイムスタンプになります。
LAST_ALTERED 列は、オブジェクトに対して以下の操作を実行したときに更新されます。
DDL 操作 。
DML 操作(テーブル用のみ)。この列は、 DML ステートメントによって影響を受ける行がない場合でも更新されます。
Snowflakeが実行するメタデータのバックグラウンド保守作業。
ビューとテーブルの場合、オブジェクトの最終更新時刻には LAST_DDL 列を使用します。
LAST_DDL 列の値は以下のように更新されます。
テーブルやビューが作成されると、 LAST_DDL のタイムスタンプは CREATED のタイムスタンプと同じになります。
テーブルやビューがドロップされると、 LAST_DDL のタイムスタンプは DELETED のタイムスタンプと同じになります。
最後の DDL データは、列が 追加 される前に発生した操作については利用できません。新しい DDL フィールドは、 DDL 操作が実行されるまで
nullを含みます。複製されたデータベースの場合、 LAST_DDL と LAST_DDL_BY フィールドはプライマリデータベース内のオブジェクトに対してのみ更新されます。フェールオーバー後、 LAST_DDL および LAST_DDL_BY フィールドは、新しく昇格したプライマリデータベースのテーブルおよびビューの DDL 操作用に更新されます。これらのフィールドは、セカンダリデータベース内のオブジェクトについては変更されません。
セカンダリデータベース内のオブジェクトで、リフレッシュ操作中に新しく作成されたオブジェクトの場合、これらのフィールドは
nullになります。
LAST_ALTERED 列は、外部テーブルの最終更新時刻を必ずしも示すものではありません。自動更新された外部テーブルの最終更新時刻を取得するには、 SYSTEM$EXTERNAL_TABLE_PIPE_STATUS 関数を使用します。この関数は、Snowflake が最後に登録したファイルのタイムスタンプなどの情報を返します。
例¶
アカウントにある全スキーマのアクティブなテーブルすべての合計サイズ(バイト単位)を取得します。
SELECT account_name, table_schema, SUM(bytes) FROM SNOWFLAKE.ORGANIZATION_USAGE.TABLES WHERE deleted IS NULL GROUP BY table_schema;