> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.

# Conexiones de Discovery

> Conecta Matcher a bases de datos externas y a API de adquirentes, prueba cada conexión, explora las tablas que expone y extrae registros hacia Matcher.

La pantalla **Discovery** del módulo Matcher de Lerian Console gestiona tus conexiones de Discovery. Una conexión de Discovery vincula Matcher a una base de datos externa o a una API REST de un adquirente. Matcher lee las tablas y las columnas de la conexión. Luego, una extracción trae registros de las tablas que eliges, y Matcher los ingiere.

Para el flujo por API, consulta [Discovery](/es/products/matcher/integrations/matcher-discovery).

## Cómo acceder a la página Discovery

***

Navega a **Settings → Discovery**.

El encabezado de la página tiene dos botones:

* **New connection** abre el panel lateral para crear una conexión.
* **Refresh discovery** sincroniza de nuevo todas las conexiones. Un mensaje muestra la cantidad de conexiones sincronizadas.

Los chips encima de la tabla muestran la cantidad de conexiones y el estado del motor de extracción.

## Tabla de conexiones

***

| Columna | Descripción |
| - | - |
| **Name** | El nombre de la conexión |
| **Type** | El tipo de conector, como `POSTGRESQL` o `STRIPE` |
| **Status** | **Available**, **Unreachable** o **Unknown**. El resultado de una prueba que ejecutas en esta página también aparece aquí |
| **Schema** | **Discovered** cuando Matcher ya leyó las tablas de la conexión, o **Pending** |
| **Actions** | El menú de acciones de la conexión |

## Cómo crear una conexión

***

1. Haz clic en **New connection**. Se abre el panel lateral **New connection**.
2. Ingresa el **Connection name**.
3. Selecciona el **Connector type**. Los campos debajo del selector cambian según el tipo.
4. Completa los campos del tipo.
5. Haz clic en **Save**.

### Tipos de conector de base de datos

Los tipos de base de datos son **PostgreSQL**, **MySQL**, **Oracle**, **SQL Server** y **MongoDB**.

| Campo | Descripción |
| - | - |
| **Host** | El nombre de host o la dirección del servidor de base de datos |
| **Port** | El puerto del servidor de base de datos |
| **Database name** | El nombre de la base de datos |
| **User name** | El usuario de la base de datos |
| **Password** | La contraseña del usuario de la base de datos (opcional) |
| **Schema** | El esquema de la base de datos (opcional) |

### Tipos de conector REST

Cada tipo REST muestra sus propios campos. Todos los tipos REST también muestran un campo opcional **Base URL**, que define la dirección de la API para esta conexión.

| Tipo de conector | Campos |
| - | - |
| `PAGBANK` | **Establishment ID** y **EDI token** |
| `STRIPE` | **API key** |
| `PIX_BCB` | **Client ID**, **Client secret**, **Client certificate (PEM)** y **Client private key (PEM)** |

## Cómo editar una conexión

***

Abre el menú **Actions** de una fila y haz clic en **Edit**. Se abre el panel lateral **Edit connection**.

* Para un tipo de base de datos, puedes cambiar el nombre y los campos de la base de datos.
* Para un tipo REST, solo puedes cambiar el **Connection name**. Para cambiar otros valores, elimina la conexión y créala de nuevo.

Haz clic en **Save** para aplicar el cambio.

## Cómo probar una conexión

***

Abre el menú **Actions** de una fila y haz clic en **Test connection**. La columna **Status** muestra el resultado:

* **Connection healthy** con el tiempo de respuesta en milisegundos.
* **Connection failed**, con el motivo cuando Matcher devuelve uno.

## Cómo ver el esquema

***

Abre el menú **Actions** de una fila y haz clic en **View schema**. El panel lateral **Connection schema** enumera cada tabla de la conexión. Para cada tabla, muestra los valores **Column**, **Type** y **Nullable**.

Si el panel muestra **No schema discovered yet**, haz clic en **Refresh discovery** cuando la conexión esté accesible.

El panel también puede mostrar estos marcadores:

| Marcador | Significado |
| - | - |
| **Last known map** | La conexión no está accesible, o las tablas son una versión archivada. El panel muestra las tablas que Matcher leyó por última vez, con la fecha de lectura |
| **Not extractable yet** | Matcher no tiene columnas confirmadas para las tablas. Todavía no puedes extraer de ellas. La alerta describe las causas posibles |
| **Columns may be stale** | Las columnas de la tabla pueden estar desactualizadas |
| **Fewer columns than last read** | La última lectura devolvió menos columnas para la tabla que la lectura anterior |

La sección **Earlier versions** enumera las versiones archivadas del esquema. Cada versión muestra la causa, la fecha de archivado y la cantidad de tablas. Haz clic en una versión para ver sus tablas.

## Cómo iniciar una extracción

***

1. Abre el menú **Actions** de una fila y haz clic en **Start extraction**. Se abre el panel lateral **Start extraction**.
2. En **Tables JSON**, ingresa un objeto JSON. Cada clave es un nombre de tabla, exactamente como lo enumera el esquema. Usa `{}` como valor para extraer todas las columnas. Para extraer solo algunas columnas, usa `{"columns": ["id", "amount"]}`.
3. Haz clic en **Start extraction**.

Luego el panel muestra el estado de la extracción, como **Extracting** o **Complete**. Cuando Matcher envía los registros a la ingesta, el panel también muestra el **Ingestion job**. Si la extracción falla, el panel muestra el error.

Haz clic en **Run in background** para cerrar el panel mientras se ejecuta la extracción.

Una fuente también puede traer datos de forma programada desde una conexión de Discovery. Consulta [Fuentes del contexto](/es/products/matcher/ui/context-sources).

## Cómo eliminar una conexión

***

Abre el menú **Actions** de una fila y haz clic en **Delete**. En el diálogo **Delete discovery connection?**, haz clic en **Delete connection**. Las lecturas de esquema y las extracciones que dependen de la conexión pueden detenerse.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.