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

> サーバーがサポートするディスクタイプの一覧と、それぞれに埋め込まれたドキュメントを含むシステムテーブル。

# system.disk_types

<div id="description">
  ## 説明
</div>

サーバーでサポートされているディスクタイプの一覧と、各タイプの埋め込みドキュメントが含まれています。ディスクタイプはディスク設定の `type` で指定し、ディスクがどこにどのようにデータを保存するか (ローカルファイルシステム、オブジェクトストレージ、別のディスク上の cache など) を決定します。

このテーブルには利用可能なディスク*タイプ*が一覧表示されます。一方、[`system.disks`](/ja/reference/system-tables/disks) にはサーバー上で設定されたディスクインスタンスが一覧表示されます。

<div id="columns">
  ## カラム
</div>

* `name` ([String](/ja/reference/data-types/index)) — ディスク設定の `type` で指定するディスクタイプの名前。
* `description` ([String](/ja/reference/data-types/index)) — そのディスクタイプの概要説明。
* `syntax` ([String](/ja/reference/data-types/index)) — ディスク設定でそのディスクタイプを指定する方法。
* `examples` ([String](/ja/reference/data-types/index)) — 使用例。
* `introduced_in` ([String](/ja/reference/data-types/index)) — そのディスクタイプが最初に導入された ClickHouse のバージョン。形式は major.minor です。
* `related` ([Array(String)](/ja/reference/data-types/index)) — 関連するディスクタイプの名前。

<div id="configuration-examples">
  ## 設定例
</div>

ディスクは 2 つの方法で設定できます。**静的**にはサーバー設定ファイル (XML または YAML) で、**動的**には `disk` 関数を使用した `CREATE`/`ATTACH` クエリの設定で行います。どちらの場合も、同じディスクタイプとパラメーターを使用できます。

<div id="static-configuration">
  ### 静的設定
</div>

ディスクはサーバー設定の `storage_configuration` 配下で定義します。次の例では、`s3` ディスクと、それを使用するストレージポリシーを定義しています。

```xml title="config.xml" theme={null}
<clickhouse>
    <storage_configuration>
        <disks>
            <s3_disk>
                <type>s3</type>
                <endpoint>https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/</endpoint>
                <use_environment_credentials>1</use_environment_credentials>
            </s3_disk>
        </disks>
        <policies>
            <s3_policy>
                <volumes>
                    <main>
                        <disk>s3_disk</disk>
                    </main>
                </volumes>
            </s3_policy>
        </policies>
    </storage_configuration>
</clickhouse>
```

同じ設定をYAMLで表すと、次のようになります：

```yaml title="config.yaml" theme={null}
storage_configuration:
  disks:
    s3_disk:
      type: s3
      endpoint: https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/
      use_environment_credentials: 1
  policies:
    s3_policy:
      volumes:
        main:
          disk: s3_disk
```

これで、テーブルはストレージポリシーを通じてこのディスクを使用できます:

```sql title="Query" theme={null}
CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS storage_policy = 's3_policy';
```

<div id="dynamic-configuration">
  ### 動的設定
</div>

`disk` 関数を使うと、設定ファイルでディスクを事前に定義していなくても、`CREATE`/`ATTACH` クエリの設定内でディスクを直接定義できます。

```sql title="Query" theme={null}
CREATE TABLE test (a Int32, b String)
ENGINE = MergeTree() ORDER BY a
SETTINGS disk = disk(
    type = s3,
    endpoint = 'https://s3.eu-west-1.amazonaws.com/clickhouse-eu-west-1.clickhouse.com/data/',
    use_environment_credentials = 1
);
```

各ディスクタイプの全パラメータ一覧については、[外部ストレージの設定](/ja/concepts/features/configuration/server-config/storing-data)を参照してください。

<div id="example">
  ## 例
</div>

```sql title="Query" theme={null}
SELECT name, description
FROM system.disk_types
WHERE name IN ('local', 'object_storage')
ORDER BY name
```

<div id="see-also">
  ## 関連項目
</div>

* [`system.disks`](/ja/reference/system-tables/disks) — サーバーに設定されているディスクのインスタンス。
* [`system.storage_policies`](/ja/reference/system-tables/storage_policies) — ストレージポリシーとボリューム。
