> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> データベースオブジェクトのメタデータに対して、ほぼ標準化された DBMS 非依存のビューを提供するシステムデータベース。

# INFORMATION_SCHEMA

`INFORMATION_SCHEMA` (または `information_schema`) は、データベースオブジェクトのメタデータに対する、ある程度標準化された[DBMS 非依存のビュー](https://en.wikipedia.org/wiki/Information_schema)を提供するシステムデータベースです。`INFORMATION_SCHEMA` のビューは、通常のシステムテーブルと比べると一般に機能が限定的ですが、ツールはこれらを利用して、DBMS をまたいで基本的な情報を取得できます。`INFORMATION_SCHEMA` のビューの構造と内容は、後方互換性を維持しながら発展していくことが想定されています。つまり、新しい機能のみが追加され、既存の機能は変更または削除されません。内部実装の観点では、`INFORMATION_SCHEMA` のビューは通常、[system.columns](/ja/reference/system-tables/columns)、[system.databases](/ja/reference/system-tables/databases)、[system.tables](/ja/reference/system-tables/tables) などの通常のシステムテーブルに対応付けられています。

```sql theme={null}
SHOW TABLES FROM INFORMATION_SCHEMA;

-- または:
SHOW TABLES FROM information_schema;
```

```text theme={null}
┌─name────────────────────┐
│ COLUMNS                 │
│ KEY_COLUMN_USAGE        │
│ REFERENTIAL_CONSTRAINTS │
│ SCHEMATA                │
| STATISTICS              |
│ TABLES                  │
│ VIEWS                   │
│ columns                 │
│ key_column_usage        │
│ referential_constraints │
│ schemata                │
| statistics              |
│ tables                  │
│ views                   │
└─────────────────────────┘
```

`INFORMATION_SCHEMA` には、次のビューが含まれます。

* [COLUMNS](#columns)
* [KEY\_COLUMN\_USAGE](#key_column_usage)
* [REFERENTIAL\_CONSTRAINTS](#referential_constraints)
* [SCHEMATA](#schemata)
* [STATISTICS](#statistics)
* [TABLES](#tables)
* [VIEWS](#views)

他のデータベースとの互換性のため、`INFORMATION_SCHEMA.columns` のような大文字と小文字を区別しない同等のビューも提供されています。同様に、これらのビュー内のすべてのカラムについても、小文字 (たとえば `table_name`) と大文字 (`TABLE_NAME`) の両方のバリアントが提供されています。

<div id="columns">
  ## COLUMNS
</div>

[system.columns](/ja/reference/system-tables/columns) システムテーブルから読み取られたカラムと、ClickHouse ではサポートされていない、または意味を持たない (常に `NULL`) ものの、標準上は必要とされるカラムが含まれます。

カラム:

* `table_catalog` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `table_schema` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `table_name` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `non_unique` ([Int32](/ja/reference/data-types/int-uint)) — 現在のところ未使用です。
* `index_schema` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `index_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在のところ未使用です。
* `seq_in_index` ([UInt32](/ja/reference/data-types/int-uint)) — 現在のところ未使用です。
* `column_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在のところ未使用です。
* `collation` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在のところ未使用です。
* `cardinality` ([Nullable](/ja/reference/data-types/nullable)([Int64](/ja/reference/data-types/int-uint))) — 現在のところ未使用です。
* `sub_part` ([Nullable](/ja/reference/data-types/nullable)([Int64](/ja/reference/data-types/int-uint))) — 現在のところ未使用です。
* `packed` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在のところ未使用です。
* `nullable` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `index_type` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `comment` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `index_comment` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `is_visible` ([String](/ja/reference/data-types/string)) — 現在のところ未使用です。
* `expression` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在のところ未使用です。

**例**

```sql title="Query" theme={null}
SELECT table_catalog,
       table_schema,
       table_name,
       column_name,
       ordinal_position,
       column_default,
       is_nullable,
       data_type,
       character_maximum_length,
       character_octet_length,
       numeric_precision,
       numeric_precision_radix,
       numeric_scale,
       datetime_precision,
       character_set_catalog,
       character_set_schema,
       character_set_name,
       collation_catalog,
       collation_schema,
       collation_name,
       domain_catalog,
       domain_schema,
       domain_name,
       column_comment,
       column_type
FROM INFORMATION_SCHEMA.COLUMNS
WHERE (table_schema = currentDatabase() OR table_schema = '')
  AND table_name NOT LIKE '%inner%' 
LIMIT 1 
FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
table_catalog:            default
table_schema:             default
table_name:               describe_example
column_name:              id
ordinal_position:         1
column_default:
is_nullable:              0
data_type:                UInt64
character_maximum_length: ᴺᵁᴸᴸ
character_octet_length:   ᴺᵁᴸᴸ
numeric_precision:        64
numeric_precision_radix:  2
numeric_scale:            0
datetime_precision:       ᴺᵁᴸᴸ
character_set_catalog:    ᴺᵁᴸᴸ
character_set_schema:     ᴺᵁᴸᴸ
character_set_name:       ᴺᵁᴸᴸ
collation_catalog:        ᴺᵁᴸᴸ
collation_schema:         ᴺᵁᴸᴸ
collation_name:           ᴺᵁᴸᴸ
domain_catalog:           ᴺᵁᴸᴸ
domain_schema:            ᴺᵁᴸᴸ
domain_name:              ᴺᵁᴸᴸ
```

<div id="schemata">
  ## SCHEMATA
</div>

[system.databases](/ja/reference/system-tables/databases) システムテーブルから読み取られるカラムと、ClickHouse ではサポートされていない、または意味をなさない (常に `NULL`) ものの、標準上必要なカラムが含まれます。

カラム:

* `catalog_name` ([String](/ja/reference/data-types/string)) — データベース名。
* `schema_name` ([String](/ja/reference/data-types/string)) — データベース名。
* `schema_owner` ([String](/ja/reference/data-types/string)) — スキーマ所有者の名前。常に `'default'`。
* `default_character_set_catalog` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — `NULL`。未サポートです。
* `default_character_set_schema` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — `NULL`。未サポートです。
* `default_character_set_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — `NULL`。未サポートです。
* `sql_path` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — `NULL`。未サポートです。

**例**

```sql title="Query" theme={null}
SELECT catalog_name,
       schema_name,
       schema_owner,
       default_character_set_catalog,
       default_character_set_schema,
       default_character_set_name,
       sql_path
FROM information_schema.schemata
WHERE schema_name ILIKE 'information_schema' 
LIMIT 1 
FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
catalog_name:                  INFORMATION_SCHEMA
schema_name:                   INFORMATION_SCHEMA
schema_owner:                  default
default_character_set_catalog: ᴺᵁᴸᴸ
default_character_set_schema:  ᴺᵁᴸᴸ
default_character_set_name:    ᴺᵁᴸᴸ
sql_path:                      ᴺᵁᴸᴸ
```

<div id="tables">
  ## TABLES
</div>

[system.tables](/ja/reference/system-tables/tables) システムテーブルから読み取られるカラムが含まれます。

カラム:

* `table_catalog` ([String](/ja/reference/data-types/string)) — テーブルが存在するデータベースの名前。
* `table_schema` ([String](/ja/reference/data-types/string)) — テーブルが存在するデータベースの名前。
* `table_name` ([String](/ja/reference/data-types/string)) — テーブル名。
* `table_type` ([String](/ja/reference/data-types/string)) — テーブルの種類。設定可能な値:
  * `BASE TABLE`
  * `VIEW`
  * `FOREIGN TABLE`
  * `LOCAL TEMPORARY`
  * `SYSTEM VIEW`
* `table_rows` ([Nullable](/ja/reference/data-types/nullable)([UInt64](/ja/reference/data-types/int-uint))) — 行の総数。判定できない場合は NULL。
* `data_length` ([Nullable](/ja/reference/data-types/nullable)([UInt64](/ja/reference/data-types/int-uint))) — ディスク上のデータのサイズ。判定できない場合は NULL。
* `index_length` ([Nullable](/ja/reference/data-types/nullable)([UInt64](/ja/reference/data-types/int-uint))) — 主キー、セカンダリ索引、およびすべてのマークの合計サイズ。
* `table_collation` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — テーブルのデフォルトの照合順序。常に `utf8mb4_0900_ai_ci` です。
* `table_comment` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — テーブル作成時に使用されるコメント。

**例**

```sql title="Query" theme={null}
SELECT table_catalog, 
       table_schema, 
       table_name, 
       table_type, 
       table_collation, 
       table_comment
FROM INFORMATION_SCHEMA.TABLES
WHERE (table_schema = currentDatabase() OR table_schema = '')
  AND table_name NOT LIKE '%inner%'
LIMIT 1 
FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
table_catalog:   default
table_schema:    default
table_name:      describe_example
table_type:      BASE TABLE
table_collation: utf8mb4_0900_ai_ci
table_comment:   
```

<div id="views">
  ## VIEWS
</div>

テーブルエンジン [View](/ja/reference/engines/table-engines/special/view) を使用している場合、[system.tables](/ja/reference/system-tables/tables) システムテーブルから読み取られるカラムが含まれます。

カラム:

* `table_catalog` ([String](/ja/reference/data-types/string)) — テーブルが存在するデータベースの名前。
* `table_schema` ([String](/ja/reference/data-types/string)) — テーブルが存在するデータベースの名前。
* `table_name` ([String](/ja/reference/data-types/string)) — テーブル名。
* `view_definition` ([String](/ja/reference/data-types/string)) — ビューの `SELECT` クエリ。
* `check_option` ([String](/ja/reference/data-types/string)) — `NONE`、チェックは行われません。
* `is_updatable` ([Enum8](/ja/reference/data-types/enum)) — `NO`、ビューは更新されません。
* `is_insertable_into` ([Enum8](/ja/reference/data-types/enum)) — 作成されたビューが[マテリアライズド](/ja/reference/statements/create/view#materialized-view)かどうかを示します。設定可能な値:
  * `NO` — 作成されたビューはマテリアライズドではありません。
  * `YES` — 作成されたビューはマテリアライズドです。
* `is_trigger_updatable` ([Enum8](/ja/reference/data-types/enum)) — `NO`、トリガーは更新されません。
* `is_trigger_deletable` ([Enum8](/ja/reference/data-types/enum)) — `NO`、トリガーは削除されません。
* `is_trigger_insertable_into` ([Enum8](/ja/reference/data-types/enum)) — `NO`、トリガーにはデータは挿入されません。

**例**

```sql title="Query" theme={null}
CREATE VIEW v (n Nullable(Int32), f Float64) AS SELECT n, f FROM t;
CREATE MATERIALIZED VIEW mv ENGINE = Null AS SELECT * FROM system.one;
SELECT table_catalog,
       table_schema,
       table_name,
       view_definition,
       check_option,
       is_updatable,
       is_insertable_into,
       is_trigger_updatable,
       is_trigger_deletable,
       is_trigger_insertable_into
FROM information_schema.views
WHERE table_schema = currentDatabase() 
LIMIT 1
FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
table_catalog:              default
table_schema:               default
table_name:                 mv
view_definition:            SELECT * FROM system.one
check_option:               NONE
is_updatable:               NO
is_insertable_into:         YES
is_trigger_updatable:       NO
is_trigger_deletable:       NO
is_trigger_insertable_into: NO
```

<div id="key_column_usage">
  ## KEY\_COLUMN\_USAGE
</div>

制約が適用されている [system.tables](/ja/reference/system-tables/tables) システムテーブルのカラムが含まれます。

カラム:

* `constraint_catalog` ([String](/ja/reference/data-types/string)) — 現在は未使用です。常に `def` です。
* `constraint_schema` ([String](/ja/reference/data-types/string)) — 制約が属するスキーマ (データベース) の名前です。
* `constraint_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 制約の名前です。
* `table_catalog` ([String](/ja/reference/data-types/string)) — 現在は未使用です。常に `def` です。
* `table_schema` ([String](/ja/reference/data-types/string)) — テーブルが属するスキーマ (データベース) の名前です。
* `table_name` ([String](/ja/reference/data-types/string)) — 制約が設定されているテーブルの名前です。
* `column_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 制約が設定されているカラムの名前です。
* `ordinal_position` ([UInt32](/ja/reference/data-types/int-uint)) — 現在は未使用です。常に `1` です。
* `position_in_unique_constraint` ([Nullable](/ja/reference/data-types/nullable)([UInt32](/ja/reference/data-types/int-uint))) — 現在は未使用です。常に `NULL` です。
* `referenced_table_schema` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在は未使用です。常に NULL です。
* `referenced_table_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在は未使用です。常に NULL です。
* `referenced_column_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在は未使用です。常に NULL です。

**例**

```sql title="Query" theme={null}
CREATE TABLE test (i UInt32, s String) ENGINE MergeTree ORDER BY i;
SELECT constraint_catalog,
       constraint_schema,
       constraint_name,
       table_catalog,
       table_schema,
       table_name,
       column_name,
       ordinal_position,
       position_in_unique_constraint,
       referenced_table_schema,
       referenced_table_name,
       referenced_column_name
FROM information_schema.key_column_usage 
WHERE table_name = 'test' 
FORMAT Vertical;
```

```response title="Response" theme={null}
Row 1:
──────
constraint_catalog:            def
constraint_schema:             default
constraint_name:               PRIMARY
table_catalog:                 def
table_schema:                  default
table_name:                    test
column_name:                   i
ordinal_position:              1
position_in_unique_constraint: ᴺᵁᴸᴸ
referenced_table_schema:       ᴺᵁᴸᴸ
referenced_table_name:         ᴺᵁᴸᴸ
referenced_column_name:        ᴺᵁᴸᴸ
```

<div id="referential_constraints">
  ## REFERENTIAL\_CONSTRAINTS
</div>

外部キーに関する情報が含まれます。現在は空の結果 (行は返されません) を返しますが、これは Tableau Online のようなサードパーティ製ツールとの互換性を確保するのに最低限十分です。

カラム:

* `constraint_catalog` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `constraint_schema` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `constraint_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在は使用されていません。
* `unique_constraint_catalog` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `unique_constraint_schema` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `unique_constraint_name` ([Nullable](/ja/reference/data-types/nullable)([String](/ja/reference/data-types/string))) — 現在は使用されていません。
* `match_option` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `update_rule` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `delete_rule` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `table_name` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。
* `referenced_table_name` ([String](/ja/reference/data-types/string)) — 現在は使用されていません。

<div id="statistics">
  ## STATISTICS
</div>

テーブルの索引に関する情報を提供します。現在は空の結果 (行は返されません) を返しますが、これは Tableau Online のようなサードパーティ製ツールとの互換性を確保するには十分です。