JMap Admin ofrece una consola SQL genérica que permite ver la estructura de las bases de datos, ejecutar peticiones SQL, inspeccionar el contenido de las tablas, probar la velocidad de ejecución de las peticiones, etc. A través de esta consola se accede a todas las bases de datos configuradas en JMap.
Cuando usted escribe una expresión SQL, la ejecución de la misma depende de los permisos de seguridad concedidos al usuario que se conecta a la base de datos. La sección Creación de bases de datos ofrece más detalles sobre las especificaciones de los usuarios para las conexiones a bases de datos.
Los resultados de las consultas se visualizan en una nueva ventana. Los resultados de las expresiones de tipo INSERT, UPDATE y DELETE se agrupan en la misma pestaña. Los resultados de las expresiones de tipo SELECT se visualizan en pestañas separadas.
Consola SQL
Base de datos
Seleccione la base de datos que utilizará.
Mostrar la estructura
Haga clic en para abrir una ventana que le permite navegar en la estructura de la base de datos. Puede visualizar los esquemas, las tablas y las vistas así como la información sobre cada campo de una tabla o de una vista.
Nro. máximo de registros
Cuando ejecuta una expresión SQL de tipo SELECT, puede ingresar un valor para limitar el número de registros devueltos.
Commit automático
Si efectúa transacciones SQL (ej.: INSERT, UPDATE), seleccione esta opción para validar automáticamente las transacciones (operación commit en SQL). De lo contrario deberá validar las modificaciones manualmente.
Probar la velocidad solamente
Cuando ejecuta una expresión SQL, seleccione esta opción para repetir la acción una serie de veces y visualizar el tiempo de ejecución.
Expresión SQL
Ingrese la expresión SQL que desea ejecutar. El resultado se mostrará en una tabla.
JMap posee una base de datos llamada System que contiene tablas de geometrías y de configuración de JMap Server. Esta base de datos es esencial y, por regla general, no debe modificarse. La base de datos System no puede suprimirse y sólo debería ser manipulada por administradores expertos. La sección Base de datos System de JMap ofrece más detalles al respecto.
Cuando usted hace clic en el nombre de una base de datos en la sección Base de datos, se abre la interfaz Configuración de la base de datos.
Esta interfaz contiene botones para Editar, Reinicializar, Desactivar o Suprimir la base de datos. El botón permite el acceso a las secciones Consola SQL y Gestión de los permisos.
Las subsecciones presentan información sobre la base de datos. Los valores de los parámetros han sido definidos durante la creación de la conexión a la base de datos. La sección Creación de bases de datos ofrece más detalles sobre los parámetros. Éstos pueden ser modificados presionando Editar.
Esta subsección presenta el nombre, el id (identificador interno de JMap), la descripción y el propietario de la base de datos.
Esta subsección presenta los detalles de la reserva de conexiones. Los parámetros indicados son: tamaño inicial, tamaño máximo, uso de la reserva, pico de uso de la reserva, plazo de conexión, tiempo de espera de la conexión.
Esta subsección presenta los detalles de la conexión de JMap a la base de datos. Se indican los parámetros: estado, base de datos (indica el tipo), controlador, cadena de conexión, nombre de usuario, consulta de validación y tipo de conexión.
Esta subsección presenta todos los recursos en los que se utilizan los datos de la base de datos. De manera jerárquica se presentan las fuentes de datos espaciales, los proyectos con sus capas, reportes y formularios, cada uno con los atributos utilizados. Esta información resulta útil para visualizar los recursos que serán afectados por las modificaciones en la base de datos.
La reinicialización de una base de datos cierra todas las conexiones abiertas y crea nuevas conexiones. Esta acción puede ser útil para forzar el restablecimiento de la conexión a un sistema de base de datos.
La desactivación de una base de datos cierra las conexiones hacia ella sin suprimir la configuración de la conexión. JMap Server no puede interrogar la base de datos. La desactivación resulta útil cuando la base de datos no responde y genera retrasos en el servidor local.
La supresión de una base de datos elimina la configuración de la conexión para ese sistema de base de datos. En ningún caso se afectan los datos incluidos en la base de datos.
Cada base de datos posee un estado que indica la condición de la conexión a la misma. El cuadro siguiente los describe:
Estados
Error
Las conexiones a la base de datos están interrumpidas. La base de datos no puede utilizarse hasta tanto no se corrija el error y se abran nuevamente las conexiones. La reinicialización de la base de datos corrige a veces este problema. Puede obtener una descripción del error haciendo clic en la palabra Error en rojo.
Inactiva
Las conexiones a la base de datos están cerradas pero están configuradas. JMap no puede interrogar la base de datos.
Conectado
Las conexiones a la base de datos fueron creadas con éxito y están listas para ser utilizadas.
Identificación
Nombre
Ingrese un nombre para la nueva base de datos. El nombre elegido debe ser único.
Descripción
(Opcional) Ingrese una descripción de la nueva base de datos. Sólo los administradores JMap pueden ver la descripción.
Parámetros de conexión
Controlador
Seleccione el controlador (driver) que corresponde al sistema de base de datos al cual debe acceder. Puede añadir nuevos controladores creando nuevos archivos de configuración en el directorio JMAP_HOME/conf/db en el servidor.
Host
(Según el controlador seleccionado) El nombre o la dirección TCP/IP del servidor de base de datos.
Puerto
(Según el controlador seleccionado) El puerto TCP/IP del servidor de base de datos.
Base de datos
(Según el controlador seleccionado) El nombre de la base de datos a la que se accede, tal como está definido en el servidor de base de datos.
Archivo
(Según el controlador seleccionado) El camino de acceso al archivo de la base de datos.
Cadena de conexión - Advanced
(Sólo para el controlador Oracle) La configuración avanzada le permite escribir directamente la cadena de conexión. Es una forma más flexible de configurar la cadena de conexión en determinadas circunstancias.
Parámetros suplementarios
En ciertas situaciones excepcionales, los sistemas de bases de datos pueden exigir parámetros suplementarios. Pueden ser ingresados en este campo.
Nombre de usuario
Ingrese el nombre de usuario para la conexión a la base de datos. La autenticación de usuarios de dominio no es soportada. Asegúrese que la base de datos permite la autenticación a ese nivel.
Contraseña
Ingrese la contraseña para la conexión a la base de datos.
Conexiones
Número de conexiones
Ingrese el tamaño inicial de la reserva de conexiones para determinar el número de conexiones a la base de datos que permanecerá abierto.
Máximo de conexiones
Ingrese el número máximo de conexiones permitido para esta reserva. El número ingresado debe ser igual o superior a la cantidad inicial de conexiones. Si resulta necesario aumentar la reserva, se crearán automáticamente nuevas conexiones hasta alcanzar el valor máximo indicado. Luego de un cierto plazo, las conexiones suplementarias se cierran automáticamente y la reserva recupera su tamaño inicial. El valor máximo puede desactivarse desmarcando la casilla correspondiente, para poder aumentar la reserva sin restricciones.
Parámetros
Parámetros adicionales
En algunas situaciones excepcionales, los sistemas de bases de datos pueden exigir parámetros suplementarios. Pueden ser ingresados en esta sección.
Consulta de validación
JMap utiliza un mecanismo de validación de las peticiones para garantizar que las conexiones a la base de datos son válidas. Esta consulta se utiliza para probar la conexión cada vez que una petición debe ejecutarse. Si la consulta de validación falla, lo que significa generalmente que la conexión a la base de datos está interrumpida, JMap Server intentará automáticamente establecer una nueva conexión. Este mecanismo garantiza que las conexiones a la base de datos nunca dejan de funcionar. La consulta debe ser válida y debe realizarse muy rápidamente. Para reducir el impacto en el resultado, asegúrese de minimizar el número de registros devueltos (el valor cero es ideal) y utilice campos indexados en la cláusula WHERE. Se proporcionan algunas consultas por defecto. En general no necesitan ser modificadas.
Plazo de la conexión
El plazo de inactividad se utiliza para cerrar y reabrir las conexiones que permanecen inactivas durante un período prolongado. Este mecanismo permite garantizar que el sistema de base de datos no cierra las conexiones inactivas. Asegúrese que este valor es inferior al plazo de espera de conexión de su sistema de base de datos. El valor por defecto de 2 horas es adecuado en la mayor parte de los casos.
Tiempo de espera de la conexión
Este parámetro establece el valor del tiempo de espera para las operaciones de la base de datos. Este parámetro puede reducirse para evitar ralentizaciones o interbloqueos en situaciones en las que el servidor de la base de datos tarda demasiado en responder, o puede aumentarse para permitir períodos de espera más prolongados para que las consultas con un tiempo de procesamiento prolongado se puedan ejecutar correctamente. El valor por defecto es 60 segundos. Active esta opción para especificar un valor diferente para la conexión.
Tipo de conexión
Indique el tipo de conexión que debe crearse. Las conexiones genéricas utilizan todas la misma información de usuario (nombre de usuario y contraseña) definida previamente. Desde el punto de vista del sistema de base de datos, es como si el mismo usuario efectuara todas las peticiones. Es el tipo de conexión que se utiliza la mayor parte del tiempo. Las conexiones identificadas se crean sobre la marcha para cada usuario conectado a JMap Server. La misma conexión se reutiliza durante la sesión de cada usuario. Desde el punto de vista del sistema de gestión de bases de datos, cada consulta es efectuada por el usuario que se conecta a JMap Server. Este método de conexión es útil en los entornos donde la seguridad se administra a nivel de la base de datos. Para garantizar el funcionamiento del método de conexión identificada, JMap y el sistema de base de datos deben compartir la misma lista de usuarios, lo que puede ser el caso cuando el módulo de gestión de los usuarios de Oracle se utiliza para administrar los usuarios.
JMap Server administra las conexiones a las bases de datos colocándolas en reservas. Las reservas consisten en un cierto número de conexiones abiertas hacia las bases de datos. Las conexiones se comparten en todo el sistema y se utilizan según las necesidades de acceso a las bases de datos.
Todas las reservas de conexiones a las bases de datos (en adelante denominadas bases de datos para simplificar el texto) se administran de manera centralizada mediante JMap Admin. De manera general, las bases de datos son utilizadas por JMap Server para leer los datos espaciales almacenados en las tablas y para acceder a los datos descriptivos asociados a los datos espaciales. Cuando las bases de datos se configuran en JMap Admin, pueden ser utilizadas a partir de otras secciones y con distintos fines durante el proceso de administración.
La sección Bases de datos de JMap Admin muestra una tabla con las bases de datos existentes y con sus estatus respectivos.