> ## 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.

> Tabla del sistema que contiene una lista de los tipos de disco compatibles con el servidor junto con su documentación integrada.

# system.disk_types

<div id="description">
  ## Descripción
</div>

Contiene la lista de tipos de disco admitidos por el servidor, junto con documentación integrada para cada tipo. Un tipo de disco se especifica en el `type` de una configuración de disco y determina dónde y cómo un disco almacena sus datos (sistema de archivos local, almacenamiento de objetos, una caché sobre otro disco, etc.).

Tenga en cuenta que esta tabla enumera los *tipos* de disco disponibles, mientras que [`system.disks`](/es/reference/system-tables/disks) enumera las instancias de disco configuradas en el servidor.

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

* `name` ([String](/es/reference/data-types/index)) — El nombre del tipo de disco, tal como se especifica en el campo `type` de una configuración de disco.
* `description` ([String](/es/reference/data-types/index)) — Una descripción general de la función del tipo de disco.
* `syntax` ([String](/es/reference/data-types/index)) — Cómo se especifica el tipo de disco en una configuración de disco.
* `examples` ([String](/es/reference/data-types/index)) — Ejemplos de uso.
* `introduced_in` ([String](/es/reference/data-types/index)) — La versión de ClickHouse en la que se introdujo por primera vez el tipo de disco, con el formato major.minor.
* `related` ([Array(String)](/es/reference/data-types/index)) — Los nombres de los tipos de disco relacionados.

<div id="configuration-examples">
  ## Ejemplos de configuración
</div>

Un disco puede configurarse de dos maneras: **estáticamente**, en los archivos de configuración del servidor (XML o YAML), o **dinámicamente**, en la configuración de una consulta `CREATE`/`ATTACH` mediante la función `disk`. En ambos casos, se admiten el mismo tipo de disco y los mismos parámetros.

<div id="static-configuration">
  ### Configuración estática
</div>

Los discos se definen en `storage_configuration`, dentro de la configuración del servidor. El siguiente ejemplo define un disco `s3` y una política de almacenamiento que lo utiliza.

```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 misma configuración en 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
```

Una tabla puede usar entonces el disco mediante su política de almacenamiento:

```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">
  ### Configuración dinámica
</div>

También se puede definir un disco directamente en la configuración de una consulta `CREATE`/`ATTACH`, sin necesidad de tener un disco predefinido en los archivos de configuración, mediante la función `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
);
```

Consulta [Configuración del almacenamiento externo](/es/concepts/features/configuration/server-config/storing-data) para obtener la lista completa de parámetros de cada tipo de disco.

<div id="example">
  ## Ejemplo
</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">
  ## Ver también
</div>

* [`system.disks`](/es/reference/system-tables/disks) — Las instancias de disco configuradas en el servidor.
* [`system.storage_policies`](/es/reference/system-tables/storage_policies) — Políticas y volúmenes de almacenamiento.
