INFORMATION_SCHEMA (または information_schema) は、データベースオブジェクトのメタデータに対する、ある程度標準化されたDBMS 非依存のビューを提供するシステムデータベースです。INFORMATION_SCHEMA のビューは、通常のシステムテーブルと比べると一般に機能が限定的ですが、ツールはこれらを利用して、DBMS をまたいで基本的な情報を取得できます。INFORMATION_SCHEMA のビューの構造と内容は、後方互換性を維持しながら発展していくことが想定されています。つまり、新しい機能のみが追加され、既存の機能は変更または削除されません。内部実装の観点では、INFORMATION_SCHEMA のビューは通常、system.columns、system.databases、system.tables などの通常のシステムテーブルに対応付けられています。
INFORMATION_SCHEMA には、次のビューが含まれます。
- CHARACTER_SETS
- COLUMNS
- COLUMN_PRIVILEGES
- COLLATIONS
- ENGINES
- KEY_COLUMN_USAGE
- REFERENTIAL_CONSTRAINTS
- SCHEMATA
- SCHEMA_PRIVILEGES
- STATISTICS
- TABLES
- TABLE_PRIVILEGES
- USER_PRIVILEGES
- VIEWS
INFORMATION_SCHEMA.columns のような大文字と小文字を区別しない同等のビューも提供されています。同様に、これらのビュー内のすべてのカラムについても、小文字 (たとえば table_name) と大文字 (TABLE_NAME) の両方のバリアントが提供されています。
COLUMNS
system.columns システムテーブルから読み取られたカラムと、ClickHouse ではサポートされていない、または意味を持たない (常にNULL) ものの、標準上は必要とされるカラムが含まれます。
カラム:
table_catalog(String) — 現在のところ未使用です。table_schema(String) — 現在のところ未使用です。table_name(String) — 現在のところ未使用です。non_unique(Int32) — 現在のところ未使用です。index_schema(String) — 現在のところ未使用です。index_name(Nullable(String)) — 現在のところ未使用です。seq_in_index(UInt32) — 現在のところ未使用です。column_name(Nullable(String)) — 現在のところ未使用です。collation(Nullable(String)) — 現在のところ未使用です。cardinality(Nullable(Int64)) — 現在のところ未使用です。sub_part(Nullable(Int64)) — 現在のところ未使用です。packed(Nullable(String)) — 現在のところ未使用です。nullable(String) — 現在のところ未使用です。index_type(String) — 現在のところ未使用です。comment(String) — 現在のところ未使用です。index_comment(String) — 現在のところ未使用です。is_visible(String) — 現在のところ未使用です。expression(Nullable(String)) — 現在のところ未使用です。
Query
Response
SCHEMATA
system.databases システムテーブルから読み取られるカラムと、ClickHouse ではサポートされていない、または意味をなさない (常にNULL) ものの、標準上必要なカラムが含まれます。
カラム:
catalog_name(String) — データベース名。schema_name(String) — データベース名。schema_owner(String) — スキーマ所有者の名前。常に'default'。default_character_set_catalog(Nullable(String)) —NULL。未サポートです。default_character_set_schema(Nullable(String)) —NULL。未サポートです。default_character_set_name(Nullable(String)) —NULL。未サポートです。sql_path(Nullable(String)) —NULL。未サポートです。
Query
Response
TABLES
system.tables システムテーブルから読み取られるカラムが含まれます。 カラム:table_catalog(String) — テーブルが存在するデータベースの名前。table_schema(String) — テーブルが存在するデータベースの名前。table_name(String) — テーブル名。table_type(String) — テーブルの種類。設定可能な値:BASE TABLEVIEWFOREIGN TABLELOCAL TEMPORARYSYSTEM VIEW
table_rows(Nullable(UInt64)) — 行の総数。判定できない場合は NULL。data_length(Nullable(UInt64)) — ディスク上のデータのサイズ。判定できない場合は NULL。index_length(Nullable(UInt64)) — 主キー、セカンダリ索引、およびすべてのマークの合計サイズ。table_collation(Nullable(String)) — テーブルのデフォルトの照合順序。常にutf8mb4_0900_ai_ciです。table_comment(Nullable(String)) — テーブル作成時に使用されるコメント。
Query
Response
VIEWS
テーブルエンジン View を使用している場合、system.tables システムテーブルから読み取られるカラムが含まれます。 カラム:table_catalog(String) — テーブルが存在するデータベースの名前。table_schema(String) — テーブルが存在するデータベースの名前。table_name(String) — テーブル名。view_definition(String) — ビューのSELECTクエリ。check_option(String) —NONE、チェックは行われません。is_updatable(Enum8) —NO、ビューは更新されません。is_insertable_into(Enum8) — 作成されたビューがマテリアライズドかどうかを示します。設定可能な値:NO— 作成されたビューはマテリアライズドではありません。YES— 作成されたビューはマテリアライズドです。
is_trigger_updatable(Enum8) —NO、トリガーは更新されません。is_trigger_deletable(Enum8) —NO、トリガーは削除されません。is_trigger_insertable_into(Enum8) —NO、トリガーにはデータは挿入されません。
Query
Response
KEY_COLUMN_USAGE
制約が適用されている system.tables システムテーブルのカラムが含まれます。 カラム:constraint_catalog(String) — 現在は未使用です。常にdefです。constraint_schema(String) — 制約が属するスキーマ (データベース) の名前です。constraint_name(Nullable(String)) — 制約の名前です。table_catalog(String) — 現在は未使用です。常にdefです。table_schema(String) — テーブルが属するスキーマ (データベース) の名前です。table_name(String) — 制約が設定されているテーブルの名前です。column_name(Nullable(String)) — 制約が設定されているカラムの名前です。ordinal_position(UInt32) — 現在は未使用です。常に1です。position_in_unique_constraint(Nullable(UInt32)) — 現在は未使用です。常にNULLです。referenced_table_schema(Nullable(String)) — 現在は未使用です。常に NULL です。referenced_table_name(Nullable(String)) — 現在は未使用です。常に NULL です。referenced_column_name(Nullable(String)) — 現在は未使用です。常に NULL です。
Query
Response
REFERENTIAL_CONSTRAINTS
外部キーに関する情報が含まれます。現在は空の結果 (行は返されません) を返しますが、これは Tableau Online のようなサードパーティ製ツールとの互換性を確保するのに最低限十分です。 カラム:constraint_catalog(String) — 現在は使用されていません。constraint_schema(String) — 現在は使用されていません。constraint_name(Nullable(String)) — 現在は使用されていません。unique_constraint_catalog(String) — 現在は使用されていません。unique_constraint_schema(String) — 現在は使用されていません。unique_constraint_name(Nullable(String)) — 現在は使用されていません。match_option(String) — 現在は使用されていません。update_rule(String) — 現在は使用されていません。delete_rule(String) — 現在は使用されていません。table_name(String) — 現在は使用されていません。referenced_table_name(String) — 現在は使用されていません。
STATISTICS
テーブルの索引に関する情報を提供します。現在は空の結果 (行は返されません) を返しますが、これは Tableau Online のようなサードパーティ製ツールとの互換性を確保するには十分です。COLLATIONS
使用可能な照合順序に関する情報を提供します。system.collations の照合順序に加え、MySQL 互換性のための 2 行が含まれます。utf8mb4_0900_ai_ci は、MySQL プロトコルがハンドシェイク時、SCHEMATA.DEFAULT_COLLATION_NAME、および TABLES.TABLE_COLLATION で通知する照合順序です。binary は、MySQL プロトコルが結果セットのメタデータ内の数値カラムやその他の非文字列カラムに設定する疑似照合順序です。これにより、通知された照合順序に従ってこのビューを参照する MySQL 対応クライアントは、これらの照合順序を見つけられます。
カラム:
collation_name(String) — 照合順序の名前。character_set_name(Nullable(String)) — 関連付けられた文字セット (utf8mb4_0900_ai_ciではutf8mb4、binaryではbinary、それ以外はNULL) 。MySQL 互換性のために提供されます。id(Nullable(UInt64)) — MySQL の照合順序 ID (utf8mb4_0900_ai_ciでは255、binaryでは63、それ以外はNULL) 。MySQL 互換性のために提供されます。is_default(Nullable(String)) — 照合順序がその文字セットのデフォルトかどうか (両方の MySQL 互換性行ではYes、それ以外はNULL) 。MySQL 互換性のために提供されます。is_compiled(Nullable(String)) — 照合順序がサーバーにコンパイルされているかどうか (両方の MySQL 互換性行ではYes、それ以外はNULL) 。MySQL 互換性のために提供されます。sortlen(Nullable(UInt64)) — 最小ソート長 (utf8mb4_0900_ai_ciでは0、binaryでは1、それ以外はNULL) 。MySQL 互換性のために提供されます。pad_attribute(Nullable(String)) — パディング属性 (NO PADまたはPAD SPACE) 。両方の MySQL 互換性行ではNO PAD、それ以外はNULLです。MySQL 互換性のために提供されます。
CHARACTER_SETS
MySQL ツールとの互換性を保つため、文字セット (utf8、utf8mb4、ascii、binary) の静的な一覧を提供します。ClickHouse 自体は UTF-8 を使用します。
カラム:
character_set_name(String) — 文字セット名。
ENGINES
利用可能なテーブルエンジンに関する情報を提供します。この情報は system.table_engines システムテーブルから取得されます。MySQL との互換性のために提供されています。 カラム:engine(String) — テーブルエンジン名。support(String) — default_table_engine に設定されているエンジンの場合はDEFAULT、それ以外はYES。
USER_PRIVILEGES
グローバル権限に関する情報を提供します。この情報は system.grants システムテーブル(データベースが指定されていない行)から読み取られます。*_PRIVILEGES ビューには、ワイルドカードを含まない通常の(取り消しではない)権限のみが表示されます。部分的な取り消し、ワイルドカードによる権限付与(例: GRANT SELECT ON db_prefix*.*)、およびパラメータ化された権限種別における特定の名前付きオブジェクトへの権限(例: GRANT TABLE ENGINE ON TinyLog)は、MySQL 互換のフォーマットでは表現できないため表示されません。そのため、部分的な取り消しによって制限されている被付与者であっても、制限のない権限が付与されているものとして表示されます。パラメータ化された種別の ON * 権限は、通常のグローバル権限として表示されます。正確な情報は system.grants を参照してください。MySQL とは異なり、これらのビューにはすべてのユーザーとロールの権限が表示され、参照するには system.grants へのアクセス権が必要です。アクセス権がない場合、クエリは ACCESS_DENIED 例外で失敗します。ClickHouse は権限を付与したユーザーを記録しないため、GRANTOR カラムは存在しません。
カラム:
grantee(String) — 権限が付与されたユーザーまたはロール。MySQL フォーマット'name'@'%'で表されます。MySQL にはロールに相当するものがないため、ロールもユーザーと同じ形式で表示されます。table_catalog(String) — 常にdef。privilege_type(String) — 権限の名前(例:SELECT、ALTER UPDATE)。完全な一覧は system.privileges を参照してください。is_grantable(String) — 権限がWITH GRANT OPTION付きで付与されている場合はYES、それ以外の場合はNO。grantee_type(String) —USERまたはROLE。非標準のカラムです。ClickHouse ではユーザーとロールに同じ名前を付けられるため、このカラムでそうした被付与者を区別します。
SCHEMA_PRIVILEGES
データベースレベルの権限に関する情報を提供します。この情報は system.grants システムテーブルのうち、データベースが指定されテーブルが指定されていない行から読み取られます。すべての*_PRIVILEGES ビューに共通する制限事項については、USER_PRIVILEGES を参照してください。
カラム:
grantee(String) — 権限が付与されているユーザーまたはロール。MySQL フォーマット'name'@'%'で表されます。table_catalog(String) — 常にdef。table_schema(String) — データベース名。privilege_type(String) — 権限名。is_grantable(String) — 権限がWITH GRANT OPTION付きで付与されている場合はYES、それ以外の場合はNO。grantee_type(String) —USERまたはROLE。標準外のカラムです。ClickHouse ではユーザーとロールに同じ名前を付けられるため、このカラムでそうした被付与者を区別します。
TABLE_PRIVILEGES
テーブルレベルの権限に関する情報を提供します。この情報は system.grants システムテーブルのうち、テーブルが指定され、カラムが指定されていない行から読み取られます。すべての*_PRIVILEGES ビューに共通する制限事項については、USER_PRIVILEGES を参照してください。
カラム:
grantee(String) — 権限が付与されているユーザーまたはロール。MySQL フォーマット ('name'@'%') で表されます。table_catalog(String) — 常にdefです。table_schema(String) — データベース名。table_name(String) — テーブル名。privilege_type(String) — 権限名。is_grantable(String) — 権限がWITH GRANT OPTION付きで付与されている場合はYES、それ以外の場合はNO。grantee_type(String) —USERまたはROLE。非標準のカラムです。ClickHouse ではユーザーとロールに同じ名前を付けられるため、このカラムを使って両者を区別します。
COLUMN_PRIVILEGES
column-level の権限に関する情報を提供します。この情報は system.grants システムテーブル (カラムが指定されている行。カラムごとに 1 行) から読み取られます。すべての*_PRIVILEGES ビューに共通する制限事項については、USER_PRIVILEGES を参照してください。
カラム:
grantee(String) — 権限が付与されているユーザーまたはロール。MySQL フォーマット ('name'@'%') で表されます。table_catalog(String) — 常にdef。table_schema(String) — データベース名。table_name(String) — テーブル名。column_name(String) — カラム名。privilege_type(String) — 権限名。is_grantable(String) — 権限がWITH GRANT OPTION付きで付与されている場合はYES、それ以外の場合はNO。grantee_type(String) —USERまたはROLE。非標準のカラムです。ClickHouse ではユーザーとロールに同じ名前を付けられるため、このカラムを使って両者を区別します。