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

> Table système contenant la liste des types de disque pris en charge par le serveur, ainsi que leur documentation intégrée.

# system.disk_types

<div id="description">
  ## Description
</div>

Contient la liste des types de disque pris en charge par le serveur, ainsi que la documentation intégrée de chaque type. Un type de disque est spécifié dans le `type` d’une configuration de disque et détermine où et comment un disque stocke ses données (système de fichiers local, object storage, cache sur un autre disque, etc.).

Notez que cette table répertorie les *types* de disque disponibles, tandis que [`system.disks`](/fr/reference/system-tables/disks) répertorie les instances de disque configurées sur le serveur.

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

* `name` ([String](/fr/reference/data-types/index)) — Le nom du type de disque, tel qu’il est indiqué dans le champ `type` d’une configuration de disque.
* `description` ([String](/fr/reference/data-types/index)) — Une description générale du rôle du type de disque.
* `syntax` ([String](/fr/reference/data-types/index)) — La manière dont le type de disque est spécifié dans une configuration de disque.
* `examples` ([String](/fr/reference/data-types/index)) — Exemples d’utilisation.
* `introduced_in` ([String](/fr/reference/data-types/index)) — La version de ClickHouse dans laquelle le type de disque a été introduit pour la première fois, sous la forme major.minor.
* `related` ([Array(String)](/fr/reference/data-types/index)) — Les noms des types de disque associés.

<div id="configuration-examples">
  ## Exemples de configuration
</div>

Un disque peut être configuré de deux manières : **statiquement**, dans les fichiers de configuration du serveur (XML ou YAML), ou **dynamiquement**, dans les paramètres d’une requête `CREATE`/`ATTACH` à l’aide de la fonction `disk`. Le même type de disque et les mêmes paramètres sont pris en charge dans les deux cas.

<div id="static-configuration">
  ### Configuration statique
</div>

Les disques sont définis dans `storage_configuration` de la configuration du serveur. L'exemple suivant définit un disque `s3` et une stratégie de stockage qui l'utilise.

```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>
```

La même configuration au format 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
```

Une table peut ensuite utiliser le disque grâce à sa stratégie de stockage :

```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">
  ### Configuration dynamique
</div>

Un disque peut également être défini directement dans les paramètres d’une requête `CREATE`/`ATTACH`, sans disque prédéfini dans les fichiers de configuration, à l’aide de la fonction `disk` :

```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
);
```

Consultez [Configurer le stockage externe](/fr/concepts/features/configuration/server-config/storing-data) pour obtenir la liste complète des paramètres de chaque type de disque.

<div id="example">
  ## Exemple
</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">
  ## Voir aussi
</div>

* [`system.disks`](/fr/reference/system-tables/disks) — Les disques configurés sur le serveur.
* [`system.storage_policies`](/fr/reference/system-tables/storage_policies) — Les stratégies de stockage et les volumes.
