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

# Probar una conexión de Data Source

> Verifica que las credenciales y los ajustes de red de un Data Source son correctos antes de depender de él para generar informes en el módulo Reporter.

Usa esta página para confirmar que Reporter puede alcanzar un Data Source y cargar su schema. El Data Source puede ser una conexión interna ya configurada para un producto Lerian o una conexión externa añadida desde la Console.

## Objetivo

***

Validar la conectividad antes de que los operadores dependan del Data Source en Templates o Reports.

Por ejemplo, prueba tras crear `production-postgres`, tras una rotación de contraseña o antes de generar un informe mensual que dependa de un schema recientemente cambiado.

## Cuándo usarlo

***

Usa esta tarea:

* inmediatamente después de añadir un Data Source externo;
* al revisar un Data Source interno existente antes de usarlo en un Template o filtro;
* tras editar host, credenciales, schema o ajustes SSL;
* antes de generar Reports que dependan de la conexión;
* cuando no aparecen tablas en el explorador de schemas;
* cuando la generación de Reports falla por errores de conexión o de schema.

## Antes de empezar

***

Confirma:

* el Data Source existe en la página **Data Sources**;
* el host, puerto, nombre de base de datos, usuario, schema y ajustes SSL esperados están configurados;
* la base de datos debe ser alcanzable desde Reporter;
* el usuario de base de datos tiene permiso para leer las tablas requeridas.

<Note>
  Una prueba exitosa confirma el acceso en ese momento. No garantiza que los Reports futuros tendrán éxito si las credenciales, las reglas de red o los permisos de la base de datos cambian más tarde.
</Note>

## Paso a paso

***

<Steps>
  <Step title="Abre Data Sources">
    Ve a **Data Sources**.
  </Step>

  <Step title="Localiza la conexión">
    Encuentra la tarjeta del Data Source que necesitas probar.
  </Step>

  <Step title="Ejecuta la prueba">
    Haz clic en **Test Connection**.
  </Step>

  <Step title="Espera el resultado">
    El estado cambia a **Connecting** mientras Reporter prueba la conexión.
  </Step>

  <Step title="Lee el resultado">
    Si la prueba tiene éxito, el estado cambia a **Connected** y se muestra la latencia, como `Latency: 45ms`. Si falla, el estado cambia a **Disconnected** y aparece un mensaje de error.
  </Step>

  <Step title="Revisa el schema cuando esté conectado">
    Expande la tarjeta de conexión para ver los schemas, tablas y campos devueltos por la conexión.
  </Step>
</Steps>

## Guía de campos

***

### Acción de prueba y campos de resultado

| Campo o estado      | Qué significa                                                                                                                      | Ejemplo                                        |
| ------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------- |
| **Test Connection** | Acción en la tarjeta del Data Source. La Console usa el `connectionId` seleccionado para llamar al endpoint de prueba.             | Probar `production-postgres`.                  |
| **Connecting**      | Estado local mientras la solicitud de prueba está pendiente. Espera el resultado final antes de editar o generar un Report.        | **Connecting**                                 |
| **Connected**       | Resultado exitoso. Reporter devolvió `connected` o `success`, y el Data Source es usable en ese momento.                           | **Connected** con `Latency: 45ms`.             |
| **Disconnected**    | Resultado fallido o error de solicitud. Revisa host, puerto, credenciales, acceso de red, schema y ajustes SSL.                    | **Disconnected** tras `authentication failed`. |
| Latencia            | `latencyMs`, devuelto en milisegundos tras una prueba exitosa. Es una señal, no una garantía de la velocidad futura de generación. | `45`                                           |
| Mensaje de prueba   | `message` devuelto por Reporter, usualmente más útil en caso de fallo. Úsalo como primera pista de qué corregir.                   | `authentication failed`                        |

### Campos de schema mostrados tras la prueba

| Elemento de schema | Qué muestra                                                                                                                                                 | Ejemplo                    |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------- |
| Tablas             | `tables[].name` devuelto por la validación de schema. Estas son las tablas que los operadores pueden usar en Template Builder y en filtros de informes.     | `transactions`             |
| Campos             | `tables[].fields[]` dentro de cada tabla. Estos campos pueden insertarse como variables de Template o usarse como filtros de Report.                        | `amount`, `created_at`     |
| Sin schema cargado | Array `tables` vacío o error al cargar el schema. La conexión puede funcionar, pero los permisos de tabla o los nombres de schema aún necesitan corrección. | No se descubrieron tablas. |

## Resultado esperado

***

El estado del Data Source es **Connected**, la información de schema está disponible y los operadores pueden usar con seguridad sus campos en Template Builder y en filtros de informes.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="La conexión tiene éxito pero no aparecen tablas">
    Revisa los nombres de schema y los permisos de la base de datos. El usuario de la base de datos puede conectar pero no tener acceso a las tablas necesarias para el reporting.
  </Accordion>

  <Accordion title="La conexión falla tras editar credenciales">
    Reabre el Data Source y confirma usuario, contraseña, host, puerto y ajustes SSL.
  </Accordion>

  <Accordion title="Probar una vez y asumir que sigue siendo válido">
    Las reglas de red, las contraseñas rotadas y los permisos de base de datos pueden cambiar. Vuelve a probar cuando aparezcan errores de generación.
  </Accordion>
</AccordionGroup>

## Pasos siguientes

***

* Usa el [Template Builder](/es/reporter/console/template-builder) tras ver schemas y campos visibles.
* Usa [Generar un Report](/es/reporter/console/generating-a-report) cuando el Data Source esté saludable.
* Usa [Editar un Data Source](/es/reporter/console/editing-a-data-source) si la prueba falla por ajustes incorrectos.

<CardGroup cols={2}>
  <Card title="Test connection" icon="code" href="/es/reference/reporter/connections/test-connection">
    Prueba una conexión de Data Source de forma programática.
  </Card>

  <Card title="Validate schema" icon="code" href="/es/reference/reporter/connections/validate-schema">
    Valida el acceso de schema a tablas y campos.
  </Card>
</CardGroup>