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

# Prueba la conexión de una fuente de datos

> Verifica que las credenciales y la configuración de red de una fuente de datos sean correctas antes de depender de ella para la generación de informes regulatorios en el módulo Reporter.

Usa esta página para confirmar que Reporter puede alcanzar una fuente de datos. El descubrimiento del esquema es una operación separada. La fuente de datos puede ser una conexión interna ya configurada para un producto de Lerian o una conexión de base de datos externa agregada desde la Console.

## Objetivo

***

Valida la conectividad antes de que los operadores dependan de la fuente de datos en plantillas o informes.

Por ejemplo, prueba la conexión después de crear `production-postgres`, después de una rotación de contraseña, o antes de generar un informe mensual que depende de un esquema modificado recientemente.

## Cuándo usarlo

***

Usa esta tarea:

* inmediatamente después de agregar una fuente de datos externa.
* al revisar una fuente de datos interna existente antes de usarla en una plantilla o un filtro.
* después de editar el host, las credenciales, el esquema o la configuración SSL.
* antes de generar informes que dependen de la conexión.
* cuando no aparecen tablas en el explorador de esquemas.
* cuando la generación de informes falla por errores de conexión o de esquema.

## Antes de empezar

***

Confirma:

* que la fuente de datos existe en la página **Data Sources**.
* que el host, el puerto, el nombre de la base de datos, el usuario, el esquema y la configuración SSL esperados están configurados.
* que se recomienda que la base de datos sea alcanzable desde Reporter.
* que el usuario de la base de datos tiene permiso para leer las tablas requeridas.

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

## Paso a paso

***

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

  <Step title="Encuentra la conexión">
    Localiza la tarjeta de la fuente de datos 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">
    Reporter devuelve el resultado de la conexión, un mensaje seguro para mostrar al cliente y la latencia medida. Una prueba exitosa devuelve `connected`. Una prueba fallida devuelve `failed`.
  </Step>

  <Step title="Recupera el esquema por separado">
    Después de una prueba exitosa, usa la operación de esquema separada para obtener esquemas, tablas y campos.
  </Step>
</Steps>

## Guía de campos

***

### Campos de la acción y del resultado de la prueba

| Campo o estado                                     | Qué significa                                                                                                                                                                                                        | Ejemplo                                              |
| -------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| **Test Connection**                                | Acción en la tarjeta de la fuente de datos. El endpoint de prueba identifica la conexión seleccionada mediante `dataSourceId`.                                                                                       | Prueba `production-postgres`.                        |
| **Connecting**                                     | Estado local mientras la solicitud de prueba está pendiente. Espera el resultado final antes de editar o generar un informe.                                                                                         | **Connecting**                                       |
| **Connected** (etiqueta que muestra la Console)    | Resultado exitoso, mapeado desde el valor de transmisión `connected`; la fuente de datos es utilizable en ese momento.                                                                                               | **Connected** con `Latency: 45ms`.                   |
| **Disconnected** (etiqueta que muestra la Console) | Resultado fallido o error de solicitud. Una prueba fallida mapea el valor de transmisión `failed` a esta etiqueta. Revisa el host, el puerto, las credenciales, el acceso de red, el esquema y la configuración SSL. | **Disconnected** después de `authentication failed`. |
| Latencia                                           | `latencyMs`, devuelto en milisegundos para la prueba. Es una señal, no una garantía de la velocidad futura de generación de informes.                                                                                | `45`                                                 |
| Mensaje de la prueba                               | `message` que devuelve Reporter, normalmente más útil en caso de fallo. Úsalo como la primera pista de qué corregir.                                                                                                 | `authentication failed`                              |

### Campos de esquema disponibles por separado

| Elemento del esquema | Qué muestra                                                                                                                                                                       | Ejemplo                  |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------ |
| Tablas               | `tables[].name` que devuelve la operación de esquema separada. Son las tablas que los operadores pueden usar en Template Builder y en los filtros de informes.                    | `transactions`           |
| Campos               | `tables[].fields[]` dentro de cada tabla. Estos campos se pueden insertar como variables de plantilla o usar como filtros de informes.                                            | `amount`, `created_at`   |
| Sin esquema cargado  | Un array `tables` vacío o un error al cargar el esquema. La conexión puede funcionar, pero los permisos de las tablas o los nombres de los esquemas todavía necesitan corrección. | No se detectaron tablas. |

## Resultado esperado

***

Reporter devolvió `connected` para la prueba. Obtén el esquema por separado antes de usar sus campos en Template Builder y en los filtros de informes.

## Errores comunes y puntos de atención

***

<AccordionGroup>
  <Accordion title="La conexión funciona pero no aparecen tablas">
    Revisa los nombres de los esquemas y los permisos de la base de datos. El usuario de la base de datos puede conectarse pero no tener acceso a las tablas necesarias para la generación de informes.
  </Accordion>

  <Accordion title="La conexión falla después de editar las credenciales">
    Vuelve a abrir la fuente de datos y confirma el usuario, la contraseña, el host, el puerto y la configuración SSL.
  </Accordion>

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

## Próximos pasos

***

* Usa [Template Builder](/es/products/reporter/console/template-builder) después de que los esquemas y los campos sean visibles.
* Usa [Generar un informe](/es/products/reporter/console/generating-a-report) después de que la fuente de datos esté en buen estado.
* Usa [Editar una fuente de datos](/es/products/reporter/console/editing-a-data-source) si la prueba falla porque la configuración es incorrecta.
