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

> Permite conectarse a bases de datos en un servidor PostgreSQL remoto.

# PostgreSQL

Permite conectarse a bases de datos en un servidor [PostgreSQL](https://www.postgresql.org) remoto. Admite operaciones de lectura y escritura (consultas `SELECT` e `INSERT`) para intercambiar datos entre ClickHouse y PostgreSQL.

Proporciona acceso en tiempo real a la lista y a la estructura de las tablas del PostgreSQL remoto mediante las consultas `SHOW TABLES` y `DESCRIBE TABLE`.

Admite modificaciones en la estructura de la tabla (`ALTER TABLE ... ADD|DROP COLUMN`). Si el parámetro `use_table_cache` (consulte Parámetros del motor más abajo) está configurado en `1`, la estructura de la tabla se almacena en caché y no se comprueba si se ha modificado, pero puede actualizarse con las consultas `DETACH` y `ATTACH`.

<div id="creating-a-database">
  ## Crear una base de datos
</div>

```sql theme={null}
CREATE DATABASE test_database
ENGINE = PostgreSQL('host:port', 'database', 'user', 'password'[, `schema`, `use_table_cache`]);
```

**Parámetros del motor**

* `host:port` — Dirección del servidor PostgreSQL.
* `database` — Nombre de la base de datos remota.
* `user` — Usuario de PostgreSQL.
* `password` — Contraseña del usuario.
* `schema` — Esquema de PostgreSQL.
* `use_table_cache` —  Indica si la estructura de la tabla de la base de datos se almacena en caché. Opcional. Valor predeterminado: `0`.

<div id="data_types-support">
  ## Compatibilidad con tipos de datos
</div>

| PostgreSQL       | ClickHouse                                           |
| ---------------- | ---------------------------------------------------- |
| DATE             | [Date](/es/reference/data-types/date)                |
| TIMESTAMP        | [DateTime](/es/reference/data-types/datetime)        |
| REAL             | [Float32](/es/reference/data-types/float)            |
| DOUBLE           | [Float64](/es/reference/data-types/float)            |
| DECIMAL, NUMERIC | [Decimal](/es/reference/data-types/decimal)          |
| SMALLINT         | [Int16](/es/reference/data-types/int-uint)           |
| INTEGER          | [Int32](/es/reference/data-types/int-uint)           |
| BIGINT           | [Int64](/es/reference/data-types/int-uint)           |
| SERIAL           | [UInt32](/es/reference/data-types/int-uint)          |
| BIGSERIAL        | [UInt64](/es/reference/data-types/int-uint)          |
| TEXT, CHAR       | [String](/es/reference/data-types/string)            |
| INTEGER          | Nullable([Int32](/es/reference/data-types/int-uint)) |
| ARRAY            | [Array](/es/reference/data-types/array)              |

<div id="examples-of-use">
  ## Ejemplos de uso
</div>

Base de datos en ClickHouse que intercambia datos con el servidor PostgreSQL:

```sql theme={null}
CREATE DATABASE test_database
ENGINE = PostgreSQL('postgres1:5432', 'test_database', 'postgres', 'mysecretpassword', 'schema_name',1);
```

```sql theme={null}
SHOW DATABASES;
```

```text theme={null}
┌─name──────────┐
│ default       │
│ test_database │
│ system        │
└───────────────┘
```

```sql theme={null}
SHOW TABLES FROM test_database;
```

```text theme={null}
┌─name───────┐
│ test_table │
└────────────┘
```

Lectura de datos de la tabla de PostgreSQL:

```sql theme={null}
SELECT * FROM test_database.test_table;
```

```text theme={null}
┌─id─┬─value─┐
│  1 │     2 │
└────┴───────┘
```

Escritura de datos en la tabla de PostgreSQL:

```sql theme={null}
INSERT INTO test_database.test_table VALUES (3,4);
SELECT * FROM test_database.test_table;
```

```text theme={null}
┌─int_id─┬─value─┐
│      1 │     2 │
│      3 │     4 │
└────────┴───────┘
```

Supongamos que se modificó la estructura de la tabla en PostgreSQL:

```sql theme={null}
postgre> ALTER TABLE test_table ADD COLUMN data Text
```

Como el parámetro `use_table_cache` se estableció en `1` cuando se creó la base de datos, la estructura de la tabla en ClickHouse se almacenó en caché y, por lo tanto, no se modificó:

```sql theme={null}
DESCRIBE TABLE test_database.test_table;
```

```text theme={null}
┌─name───┬─type──────────────┐
│ id     │ Nullable(Integer) │
│ value  │ Nullable(Integer) │
└────────┴───────────────────┘
```

Después de desvincular la tabla y volver a adjuntarla, la estructura se actualizó:

```sql theme={null}
DETACH TABLE test_database.test_table;
ATTACH TABLE test_database.test_table;
DESCRIBE TABLE test_database.test_table;
```

```text theme={null}
┌─name───┬─type──────────────┐
│ id     │ Nullable(Integer) │
│ value  │ Nullable(Integer) │
│ data   │ Nullable(String)  │
└────────┴───────────────────┘
```

<div id="related-content">
  ## Contenido relacionado
</div>

* Blog: [ClickHouse y PostgreSQL: la combinación perfecta para los datos - parte 1](https://clickhouse.com/blog/migrating-data-between-clickhouse-postgres)
* Blog: [ClickHouse y PostgreSQL: la combinación perfecta para los datos - parte 2](https://clickhouse.com/blog/migrating-data-between-clickhouse-postgres-part-2)