# Repositorios de conexiones en base de datos Además de `connections.xml`, Devkron puede leer los datos de conexión de una **base de datos** que sirve de repositorio. Es lo que usan los servicios multiempresa para no tener un `connections.xml` por cliente: el archivo local solo tiene la conexión al repositorio, y en el repositorio se registran las de cada cliente. Esta página explica cómo crear un repositorio, cómo registrar aplicaciones y conexiones, cómo usarlo desde DKL y cómo se comporta en un servidor FastCGI. Requiere Devkron **2.0.2** o posterior. ## Cómo funciona El nombre cualificado lleva dos partes separadas por `/`: ```dkl ref db = dbr.open("conexiones@miempresa/sucursal1@ventas") ``` - `conexiones@miempresa` es una conexión **de `connections.xml`** que apunta a la base del repositorio. - `sucursal1@ventas` es la conexión **registrada en el repositorio**: Devkron lee sus datos (motor, servidor, usuario, contraseña cifrada, base) de las tablas del repositorio y la abre. Un nombre sin `/` (`sucursal1@ventas`) se sigue buscando en `connections.xml`. Un mismo programa puede usar los dos tipos de nombre y varios repositorios a la vez. El repositorio son tres tablas: `AppDB` (aplicaciones), `CnnDB` (conexiones, con sus datos cifrados) y `DicDB` (diccionarios de consultas opcionales). Para leerlas, Devkron usa un **diccionario de consultas** del motor del repositorio; la distribución los trae en `SQLDic/` (`MY_SQL.xml`, `SQL_SERVER.xml`, `POSTGRE_SQL.xml`) y los usa solos si la conexión del repositorio no indica otro en ``. Probado de punta a punta en MySQL 8. ## 1. Definir la conexión del repositorio En `connections.xml`, agregue una conexión normal a la base que será el repositorio (puede ser una base vacía que ya exista, o el nombre de una base nueva que creará en el paso 2): ```xml miempresa conexiones MY_SQL MY_SQL 10.0.0.5 repo contraseña conexiones 3306 ]]> false ``` Deje `` vacío para usar el diccionario de la distribución. Vea [Conexiones a bases de datos](/es/devkron/2.0/instalacion/conexiones.md) para los datos de cada motor y [Cifrar conexiones](/es/devkron/2.0/instalacion/cifrar-conexiones.md) para no dejar la contraseña en claro. ## 2. Crear el repositorio La distribución trae la herramienta `tools/dbrepo/dbrepo.dkl`. Ejecútela desde la carpeta de `connections.xml` (normalmente la de la instalación): ```bash cd /opt/devkron ./dkl tools/dbrepo/dbrepo.dkl crear repo=conexiones@miempresa ``` Crea las tablas `AppDB`, `CnnDB` y `DicDB` en la base de `conexiones@miempresa` (la base debe existir; las tablas que ya existan no se tocan). Para crear además la base en el mismo servidor: ```bash ./dkl tools/dbrepo/dbrepo.dkl crear repo=conexiones@miempresa base=conexiones ``` Con `base=` la base nueva lleva también las tablas de sistema de Devkron. Si el nombre no coincide con `` de la conexión del repositorio, cámbielo en `connections.xml` para usarla. El usuario necesita permiso para crear tablas (y bases, con `base=`). ## 3. Registrar aplicaciones y conexiones ```bash ./dkl tools/dbrepo/dbrepo.dkl conexion repo=conexiones@miempresa qname=sucursal1@ventas \ host=10.0.0.8 user=ventas password=secreto schema=ventas_suc1 port=3306 ./dkl tools/dbrepo/dbrepo.dkl lista repo=conexiones@miempresa ./dkl tools/dbrepo/dbrepo.dkl probar repo=conexiones@miempresa qname=sucursal1@ventas ``` | Acción | Parámetros | Qué hace | |---|---|---| | `crear` | `repo=`, opcional `base=` | Crea las tablas del repositorio (y la base, con `base=`) | | `app` | `repo=`, `app=` | Registra una aplicación vacía | | `conexion` | `repo=`, `qname=`, `host=`, `user=`, `password=`, `schema=`; opcionales `engine=` (`MY_SQL`), `port=` (3306), `crearbase=1` | Registra la conexión (y la aplicación si no existe); con `crearbase=1` crea también la base destino. Los datos se guardan cifrados | | `lista` | `repo=`, opcional `app=` | Aplicaciones y conexiones del repositorio | | `borrar` | `repo=`, `qname=` | Elimina el registro de la conexión (no borra la base) | | `probar` | `repo=`, `qname=` | Abre la conexión y muestra la base a la que llegó | La contraseña que escribe en la línea de órdenes queda en el historial del intérprete de comandos: bórrelo o use un programa DKL con las funciones de abajo. ## Desde DKL Las funciones `dba.*` de `dbr.dkh` aceptan la forma `repositorio/conexión` ([dba.*](/es/devkron/2.0/bibliotecas/motor/dbr/dba.md)): ```dkl #include "dkli.dkh" #! program "alta_cliente" { #include "functions.dkh" #include "dbr.dkh" repo = "conexiones@miempresa" do dba.createrepo(repo, "") // tablas del repositorio (una sola vez) new info { @"Engine": "MY_SQL" @"Host": "10.0.0.8" @"UserName": "ventas" @"Password": "secreto" @"DefaultSchema": "ventas_suc2" @"Port": "3306" } do dba.addapp(repo + "/ventas") do dba.createconnection(repo + "/sucursal2@ventas", info, @false, "") ref db = dbr.open(repo + "/sucursal2@ventas") do print(dbr.str(db, "select database()", @null)) do dbr.close(db) } ``` | Función | Qué hace | |---|---| | `dba.createrepo(repo, base)` | Crea las tablas del repositorio en la base de `repo` (conexión de `connections.xml`), o en la base nueva `base` si no es `""` | | `dba.repoinfo()` | Estado de la caché de repositorios del proceso: `cached`, `open`, `max`, `idle_sec`, `sqldic` (carpeta de diccionarios), `local_reads` (relecturas de `connections.xml`) | ## En un servidor FastCGI Cada proceso guarda una **caché de repositorios**: una conexión abierta por repositorio, con su propio candado, de modo que muchas peticiones simultáneas pueden usar el mismo repositorio, varios repositorios y nombres locales a la vez sin mezclarse. La conexión a la base destino (la del cliente) se abre fuera de ese candado. | Qué | Valor | Variable de entorno | |---|---|---| | Repositorios en caché; al pasar del tope se descarta el de uso más antiguo | 32 | `DEVKRON_DBR_MAX_REPOS` | | Segundos sin uso tras los que se cierra la conexión de un repositorio (se reabre al pedirlo) | 600 | `DEVKRON_DBR_REPO_IDLE_SEC` | Si la conexión al repositorio se cae (reinicio del servidor de base de datos, `KILL` de la sesión, corte de red), la siguiente apertura **reconecta y reintenta una vez**; si vuelve a fallar, sale el mismo error de siempre. Las conexiones nuevas que registre en el repositorio se ven de inmediato, sin reiniciar: cada apertura consulta el repositorio. ### Antes de 2.0.2 Hasta 2.0.1 (y en Devkron 1.x) el proceso guardaba un único "modo" global (local o en base) y un único repositorio, que cada `dbr.open` reescribía. En un servidor FastCGI con peticiones simultáneas eso causaba: - consultas que leían la base de **otro** repositorio (misma conexión registrada en dos repositorios), - errores `Object reference not set to an instance of an object` y procesos bloqueados, - una conexión nueva al repositorio cada vez que se alternaba entre un nombre local y uno de repositorio, sin cerrar la anterior, hasta agotar el grupo de conexiones (`Connect Timeout expired. All pooled connections are in use`), - tras caerse la conexión al repositorio, `El nombre de la aplicación no se encuentra en el repositorio` en todas las aperturas siguientes. Si usa repositorios en base de datos, actualice a 2.0.2. ## Errores típicos | Mensaje | Causa | Solución | |---|---|---| | `Imposible continuar, no ha definido el diccionario de consultas necesario` | La conexión del repositorio no indica `` y falta `SQLDic/.xml` junto a `dkl` (o el motor no tiene diccionario, como Firebird) | Revise que la carpeta `SQLDic/` de la distribución esté junto a `dkl` | | `El nombre de la aplicación no se encuentra en el repositorio` | La aplicación no está registrada, o la base del repositorio no tiene las tablas | `dbrepo.dkl lista`; `dbrepo.dkl crear` | | `No se pudo obtener una referencia a las conexiones` | La conexión no está registrada en esa aplicación | `dbrepo.dkl lista`; `dbrepo.dkl conexion` | | `El nombre cualificado del repositorio debe ser una conexión de connections.xml` | `dba.createrepo` con un nombre que lleva `/` o sin `@` | Use el nombre de la conexión local del repositorio | [Regresar a Instalación](/es/devkron/2.0/instalacion/)