> ## 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.
> Crea una tabla a partir de archivos de HDFS. Esta función de tabla es similar a las funciones de tabla url y file.
# hdfs
export const CloudNotSupportedBadge = () => {
return
No es compatible con ClickHouse Cloud
;
};
export const ExperimentalBadge = () => {
return ;
};
# Función de tabla hdfs
Crea una tabla a partir de archivos de HDFS. Esta función de tabla es similar a las funciones de tabla [url](/es/reference/functions/table-functions/url) y [file](/es/reference/functions/table-functions/file).
## Sintaxis
```sql theme={null}
hdfs(URI, format, structure)
```
## Argumentos
| Argumento | Descripción |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `URI` | La URI relativa del archivo en HDFS. La ruta del archivo admite los siguientes globs en modo de solo lectura: `*`, `?`, `{abc,def}` y `{N..M}`, donde `N` y `M` son números, y `'abc'` y `'def'` son cadenas. |
| `format` | El [formato](/es/reference/formats/index) del archivo. |
| `structure` | Estructura de la tabla. Formato: `'column1_name column1_type, column2_name column2_type, ...'`. |
## Valor devuelto
Una tabla con la estructura especificada para leer o escribir datos en el archivo indicado.
**ejemplo**
Tabla de `hdfs://hdfs1:9000/test` y selección de sus dos primeras filas:
```sql theme={null}
SELECT *
FROM hdfs('hdfs://hdfs1:9000/test', 'TSV', 'column1 UInt32, column2 UInt32, column3 UInt32')
LIMIT 2
```
```text theme={null}
┌─column1─┬─column2─┬─column3─┐
│ 1 │ 2 │ 3 │
│ 3 │ 2 │ 1 │
└─────────┴─────────┴─────────┘
```
## Globs en la ruta
Las rutas pueden usar globs. Los archivos deben coincidir con el patrón de la ruta completa, no solo con el sufijo o el prefijo.
* `*` — Representa una cantidad arbitraria de caracteres, excepto `/`, incluida la cadena vacía.
* `**` — Representa todos los archivos dentro de una carpeta de forma recursiva.
* `?` — Representa un único carácter cualquiera.
* `{some_string,another_string,yet_another_one}` — Sustituye cualquiera de las cadenas `'some_string', 'another_string', 'yet_another_one'`. Las cadenas pueden contener el símbolo `/`.
* `{N..M}` — Representa cualquier número `>= N` y `<= M`.
Las construcciones con `{}` son similares a las funciones de tabla [remote](/es/reference/functions/table-functions/remote) y [file](/es/reference/functions/table-functions/file).
**Ejemplo**
1. Supongamos que tenemos varios archivos con los siguientes URI en HDFS:
* 'hdfs\://hdfs1:9000/some\_dir/some\_file\_1'
* 'hdfs\://hdfs1:9000/some\_dir/some\_file\_2'
* 'hdfs\://hdfs1:9000/some\_dir/some\_file\_3'
* 'hdfs\://hdfs1:9000/another\_dir/some\_file\_1'
* 'hdfs\://hdfs1:9000/another\_dir/some\_file\_2'
* 'hdfs\://hdfs1:9000/another\_dir/some\_file\_3'
2. Consulta la cantidad de filas de estos archivos:
```sql theme={null}
SELECT count(*)
FROM hdfs('hdfs://hdfs1:9000/{some,another}_dir/some_file_{1..3}', 'TSV', 'name String, value UInt32')
```
3. Consulta cuántas filas hay en todos los archivos de estos dos directorios:
```sql theme={null}
SELECT count(*)
FROM hdfs('hdfs://hdfs1:9000/{some,another}_dir/*', 'TSV', 'name String, value UInt32')
```
Si la lista de archivos contiene rangos numéricos con ceros a la izquierda, use la construcción con llaves para cada dígito por separado o `?`.
**Ejemplo**
Consulte los datos de los archivos llamados `file000`, `file001`, ... , `file999`:
```sql theme={null}
SELECT count(*)
FROM hdfs('hdfs://hdfs1:9000/big_dir/file{0..9}{0..9}{0..9}', 'CSV', 'name String, value UInt32')
```
## Columnas virtuales
* `_path` — Ruta del archivo. Tipo: `LowCardinality(String)`.
* `_file` — Nombre del archivo. Tipo: `LowCardinality(String)`.
* `_size` — Tamaño del archivo en bytes. Tipo: `Nullable(UInt64)`. Si se desconoce el tamaño, el valor es `NULL`.
* `_time` — Hora de la última modificación del archivo. Tipo: `Nullable(DateTime)`. Si se desconoce la hora, el valor es `NULL`.
## configuración use\_hive\_partitioning
Cuando `use_hive_partitioning` se establece en 1, ClickHouse detecta el particionado al estilo Hive en la ruta (`/name=value/`) y permite usar las columnas de partición como columnas virtuales en la consulta. Estas columnas virtuales tendrán los mismos nombres que en la ruta particionada.
**Ejemplo**
Usar una columna virtual creada con particionado al estilo Hive
```sql theme={null}
SELECT * FROM HDFS('hdfs://hdfs1:9000/data/path/date=*/country=*/code=*/*.parquet') WHERE date > '2020-01-01' AND country = 'Netherlands' AND code = 42;
```
## Configuración de almacenamiento
* [hdfs\_truncate\_on\_insert](/es/reference/settings/session-settings#hdfs_truncate_on_insert) - permite truncar el archivo antes de insertar datos en él. Deshabilitado de forma predeterminada.
* [hdfs\_create\_new\_file\_on\_insert](/es/reference/settings/session-settings#hdfs_create_new_file_on_insert) - permite crear un archivo nuevo en cada inserción si el formato incluye un sufijo. Deshabilitado de forma predeterminada.
* [hdfs\_skip\_empty\_files](/es/reference/settings/session-settings#hdfs_skip_empty_files) - permite omitir archivos vacíos durante la lectura. Deshabilitado de forma predeterminada.
## Relacionado
* [Columnas virtuales](/es/reference/engines/table-engines/index#table_engines-virtual_columns)