Snowflake Information Schema¶

INFORMATION_SCHEMA とは何ですか？¶

アカウントで作成された各データベースには、 INFORMATION_SCHEMA という名前の組み込み、読み取り専用スキーマが自動的に含まれます。スキーマには次のオブジェクトが含まれます。

• データベースに含まれるすべてのオブジェクトのビュー、およびアカウントレベルのオブジェクト（ロール、ウェアハウス、データベースなどの非データベースオブジェクト）のビュー

• アカウント全体の履歴データと使用データのテーブル関数。

情報スキーマビューのリスト¶

INFORMATION_SCHEMA のビューには、データベースで定義されたオブジェクトに関するメタデータと、すべてのデータベースで共通の非データベースアカウントレベルオブジェクトのメタデータが表示されます。INFORMATION_SCHEMA の各インスタンスには次が含まれます。

• Snowflakeに関連するデータベースおよびアカウントレベルのオブジェクトのANSI標準ビュー。

• Snowflakeがサポートする非標準オブジェクト（ステージ、ファイル形式など）のSnowflake固有のビュー。

特に断りのない限り、Snowflake情報スキーマビューは ANSI標準です。

情報スキーマテーブル関数のリスト¶

INFORMATION_SCHEMA のテーブル関数を使用して、ストレージ、ウェアハウス、ユーザーログイン、クエリのアカウントレベルの使用状況と履歴情報を返すことができます。

_{[1] ロールに MONITOR USAGE グローバル権限が割り当てられている場合に結果を返します。それ以外の場合は、 ACCOUNTADMIN ロールのみの結果を返します。}

一般的な使用上の注意¶

• 各 INFORMATION_SCHEMA スキーマは読み取り専用です（スキーマ、およびスキーマ内のすべてのビューとテーブル関数は変更または削除できません）。

• INFORMATION_SCHEMA ビューでのクエリは、同時 DDL に関する一貫性を保証しません。例えば、長時間実行される INFORMATION_SCHEMA クエリの実行中にテーブルのセットが作成された場合、クエリの結果には、作成されたテーブルの一部、またはすべてが含まれる場合とテーブルが含まれない場合があります。

• ビューまたはテーブル関数の出力は、ユーザーの現在のロールに付与されている権限に依存します。INFORMATION_SCHEMA ビューまたはテーブル関数をクエリすると、現在のロールにアクセス権限が付与されているオブジェクトのみが返されます。

• パフォーマンスの問題を防ぐため、 INFORMATION_SCHEMA クエリで指定されたフィルターが十分に選択的でない場合、次のエラーが返されます。

  Information schema query returned too much data. Please repeat query with more selective predicates.

• Snowflake固有のビューは変更される可能性があります。これらのビューからすべての列を選択することは避けてください。代わりに、必要な列を選択します。たとえば、 name 列が必要な場合は、 SELECT * ではなく SELECT name を使用します。

SHOW コマンドをInformation Schemaビューに置き換えるための考慮事項¶

INFORMATION_SCHEMA ビューは、 SHOW <オブジェクト> コマンドによって提供されるのと同じ情報への SQL インターフェイスを提供します。ビューを使用して、これらのコマンドを置き換えることができます。ただし、切り替える前に考慮すべき重要な違いがいくつかあります。

クエリのInformation Schemaビューとテーブル関数の名前の修飾¶

INFORMATION_SCHEMA ビューまたはテーブル関数をクエリする場合、ビュー/テーブル関数 または の修飾名を使用する必要があります。INFORMATION_SCHEMA スキーマはセッションで使用する必要があります。

例:

• ビューとテーブル関数の完全修飾名を database.information_schema.name の形式で使用してクエリするには、

  SELECT table_name, comment FROM testdb.INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(testdb.INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• ビューとテーブル関数の修飾名を information_schema.name の形式で使用してクエリするには、

  USE DATABASE testdb;
  
  SELECT table_name, comment FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(INFORMATION_SCHEMA.LOGIN_HISTORY( ... ));
  

  Copy

• セッションで使用中の INFORMATION_SCHEMA スキーマでクエリするには、

  USE SCHEMA testdb.INFORMATION_SCHEMA;
  
  SELECT table_name, comment FROM TABLES WHERE TABLE_SCHEMA = 'PUBLIC' ... ;
  
  SELECT event_timestamp, user_name FROM TABLE(LOGIN_HISTORY( ... ));
  

  Copy

  注釈

  共有から作成されたデータベースを使用中に、セッションの現在のスキーマとして INFORMATION_SCHEMA を選択した場合、 SELECT ステートメントは次のエラーにより失敗する可能性があります。

  INFORMATION_SCHEMA does not exist or is not authorized

  これが発生した場合は、セッションの現在のスキーマに別のスキーマを選択してください。

より詳細な例については、各ビュー/テーブル関数の参照ドキュメントをご参照ください。