> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8a08bda2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Proporciona una interfaz similar a una tabla de solo lectura para tablas de Apache Paimon en Amazon S3, Azure, HDFS o almacenadas localmente.
# Función de tabla paimon
export const ExperimentalBadge = () => {
return ;
};
Proporciona una interfaz similar a una tabla de solo lectura para tablas de Apache [Paimon](https://paimon.apache.org/) en Amazon S3, Azure, HDFS o almacenadas localmente.
## Sintaxis
```sql theme={null}
paimon(url [,access_key_id, secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])
paimonS3(url [,access_key_id, secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])
paimonAzure(connection_string|storage_account_url, container_name, blobpath, [,account_name], [,account_key] [,format] [,compression_method])
paimonHDFS(path_to_table, [,format] [,compression_method])
paimonLocal(path_to_table, [,format] [,compression_method])
```
## Argumentos
La descripción de estos argumentos coincide con la de las funciones de tabla `s3`, `azureBlobStorage`, `HDFS` y `file`, respectivamente.
`format` indica el formato de los archivos de datos de la tabla Paimon.
Para `paimonS3`, puede usarse un parámetro opcional, `extra_credentials`, para pasar un `role_arn` y habilitar el acceso basado en roles en ClickHouse Cloud. Consulta [Secure S3](/es/products/cloud/guides/data-sources/accessing-s3-data-securely) para ver los pasos de configuración.
### Valor de retorno
Una tabla con la estructura especificada para leer datos de la tabla de Paimon indicada.
## Definir una colección con nombre
A continuación se muestra un ejemplo de cómo configurar una colección con nombre para almacenar la URL y las credenciales:
```xml theme={null}
http://test.s3.amazonaws.com/clickhouse-bucket/
test
test
auto
auto
```
```sql theme={null}
SELECT * FROM paimonS3(paimon_conf, filename = 'test_table')
DESCRIBE paimonS3(paimon_conf, filename = 'test_table')
```
## Alias
La función de tabla `paimon` ahora es un alias de `paimonS3`.
## 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 del archivo, 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`.
* `_etag` — El etag del archivo. Tipo: `LowCardinality(String)`. Si se desconoce el etag, el valor es `NULL`.
## Tipos de datos admitidos
| Tipo de dato de Paimon | Tipo de dato de ClickHouse |
| --------------------------------- | -------------------------- |
| BOOLEAN | Int8 |
| TINYINT | Int8 |
| SMALLINT | Int16 |
| INTEGER | Int32 |
| BIGINT | Int64 |
| FLOAT | Float32 |
| DOUBLE | Float64 |
| STRING,VARCHAR,BYTES,VARBINARY | String |
| DATE | Date |
| TIME(p),TIME | Time('UTC') |
| TIMESTAMP(p) WITH LOCAL TIME ZONE | DateTime64 |
| TIMESTAMP(p) | DateTime64('UTC') |
| CHAR | FixedString(1) |
| BINARY(n) | FixedString(n) |
| DECIMAL(P,S) | Decimal(P,S) |
| ARRAY | Array |
| MAP | Map |
## Particiones admitidas
Tipos de datos admitidos en las claves de partición de Paimon:
* `CHAR`
* `VARCHAR`
* `BOOLEAN`
* `DECIMAL`
* `TINYINT`
* `SMALLINT`
* `INTEGER`
* `DATE`
* `TIME`
* `TIMESTAMP`
* `TIMESTAMP WITH LOCAL TIME ZONE`
* `BIGINT`
* `FLOAT`
* `DOUBLE`
## Véase también
* [Función de tabla de clúster de Paimon](/es/reference/functions/table-functions/paimonCluster)