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

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/lerian-console/reporter-console/template-builder) tras ver schemas y campos visibles.
* Usa [Generar un Report](/es/lerian-console/reporter-console/generating-a-report) cuando el Data Source esté saludable.
* Usa [Editar un Data Source](/es/lerian-console/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>