メインコンテンツへスキップ
INFORMATION_SCHEMA (または information_schema) は、データベースオブジェクトのメタデータに対する、ある程度標準化されたDBMS 非依存のビューを提供するシステムデータベースです。INFORMATION_SCHEMA のビューは、通常のシステムテーブルと比べると一般に機能が限定的ですが、ツールはこれらを利用して、DBMS をまたいで基本的な情報を取得できます。INFORMATION_SCHEMA のビューの構造と内容は、後方互換性を維持しながら発展していくことが想定されています。つまり、新しい機能のみが追加され、既存の機能は変更または削除されません。内部実装の観点では、INFORMATION_SCHEMA のビューは通常、system.columns、system.databases、system.tables などの通常のシステムテーブルに対応付けられています。
INFORMATION_SCHEMA には、次のビューが含まれます。 他のデータベースとの互換性のため、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 TABLE
    • VIEW
    • FOREIGN TABLE
    • LOCAL TEMPORARY
    • SYSTEM 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 ではユーザーとロールに同じ名前を付けられるため、このカラムを使って両者を区別します。