INSTITUTO GEOGRÁFICO AGUSTÍN CODAZZI S E D E C E N T R A L Centro de Investigación y Desarrollo en Información Geográfica - Oficina CIAF Infraestructura Colombiana de Datos Espaciales - ICDE Grupo Geoportales y Geoservicios Geoportal de la IDECAN Especificación de Casos de Uso: Configurar base de datos Versión 1.0 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> Historial de Revisiones Fecha 15/Abr/2008 Versión 1.0 Descripción Creación del Documento <IGAC – CIAF – ICDE>, 2008 Autor Luis Fernando Ortiz Reyes 2 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> Tabla de Contenido 1. 2. Nombre del Caso de Uso 4 1.1 4 Descripción Breve Flujo de Eventos 2.1 2.2 4 Flujo Básico Flujos Alternativos 2.2.1 PostgreSQL+PostGIS no han sido configurados 2.2.2 No ha sido configurada la variable de entorno para PostgreSQL 2.2.3 Acceso a los servidores de bases de datos 2.2.4 Parámetros de la base de datos 2.2.5 Errores en la carga de archivos a la base de datos 2.2.6 Automatización del proceso de carga de archivos 4 8 8 8 8 8 Error! Bookmark not defined. Error! Bookmark not defined. 3. Requerimientos especiales 8 4. Precondiciones 8 4.1. 4.2. 8 8 5. 6. Tener los archivos geográficos .shp Instalación y configuración previa de PostgreSQL+PostGIS Postcondiciones 9 5.1 9 Conexión exitosa con la base de datos Puntos de Extensión 9 6.1 6.2 9 9 Generar Mapa Regional Andino Cargar capas del Mapa Andino en la base de datos de PostgreSQL <IGAC – CIAF – ICDE>, 2008 3 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> Especificación de Casos de Uso: Configurar base de datos 1. Nombre del Caso de Uso 1.1 Descripción Breve El Administrador desea configurar la base de datos para que tenga soporte geográfico. Esta base de datos será configurada en PostgreSQL, con ayuda de PostGIS para brindar dicho soporte geográfico. Esto también incluye tener claro y muy presente el Modelo de Datos. 2. Flujo de Eventos 2.1 Flujo Básico 1. El Administrador recibe el modelo de datos unificado, proveniente de la Homologación del Catálogo de Objetos llevada a cabo en el Taller Desarrollo del Mapa integrado escala 1:1’000,000 de los Países Miembros de la Comunidad Andina, en el marco de desarrollo de la IDECAN. Este modelo es un archivo en Excel, que contiene los objetos de información, es decir, las capas obligatorias y opcionales que mostrará el Mapa Regional Andino a escala 1:1’000,000, y los atributos de cada uno de estos objetos. 2. El Administrador recibe los datos pertinentes al modelo acordado, enunciado en el caso de uso Generar el Mapa Regional Andino, en el formato acordado para archivos de información geográfica (formato shape, archivos .shp). 3. Se asume que PostgreSQL+PostGIS ha sido instalado y configurado, ya que este caso de uso solo explica la forma específica de configuración de la base de datos. 4. La variable de entorno para PostgreSQL debe haberse establecido previamente. 5. El Administrador debe tener en cuenta entonces los siguientes parámetros del Modelo de Datos de una base de datos geográfica; este modelo está basado en estándares OGC y tiene soporte en PostgreSQL+PostGIS: La tabla GEOMETRY_COLUMNS, describe las tablas espaciales que están disponibles y sus propiedades geométricas. La tabla SPATIAL_REF_SYS describe los sistemas de coordenadas y las transformaciones geométricas. La tabla FEATURES guarda el conjunto de fenómenos espaciales. Las columnas de esta tabla representan los atributos de interés, significa que cada tupla hace referencia a una característica geográfica. Cada Geometry Column en la base de datos tiene un registro en la tabla GEOMETRY_COLUMNS. Los datos almacenados para cada Geometry Column, son los siguientes: o Identificación de la tabla FEATURE a la cual la Geometry Column pertenece. o Nombre de la Geometry Column. o ID del sistema de referencia espacial de la Geometry Column. o Dimensión de coordenadas para la Geometry Column. Cada Geometry Column está asociada a un Sistema de Referencia Espacial. El Sistema de Referencia Espacial identifica el sistema de coordenadas para todos los objetos geométricos almacenados en la columna, y dan sentido a los valores numéricos de las coordenadas para cualquier objeto geométrico almacenado en la columna. La tabla SPATIAL_REF_SYS almacena la información de cada Sistema de Referencia Espacial en la base de datos. Las columnas de esta tabla son Spatial Reference System Identifier (SRID), Spatial Reference System Authority Name (AUTH_NAME), Authority Specific Spatial Reference System Identifier (AUTH_SRID) y la descripción de Spatial Reference System (SRTEXT). El SRID constituye una llave <IGAC – CIAF – ICDE>, 2008 4 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> entera única para los sistemas de referencia espacial dentro de la base de datos, cuya codificación se hace siguiendo la base de datos de la EPSG. La interoperabilidad entre clientes se logra a través de columna SRTEXT en donde se almacena la información tipo texto de los sistemas de referencia espacial. 6. Teniendo en cuenta estos parámetros del Modelo de Datos (para más información ver el artefacto Modelo de Datos), el Administrador accede al Sistema Manejador de Bases de Datos PostgreSQL, mediante la utilidad pgAdminIII – PostgreSQL tools. 7. Luego de ver la sugerencia del día, esta es la primera pantalla que verá el Administrador: 8. En la parte izquierda se encuentra el acceso a los servidores, que contienen las bases de datos. Dependiendo de la configuración de instalación de PostgreSQL, el acceso al servidor puede o no tener clave de acceso. 9. Una vez en el servidor, tendremos acceso a los siguientes servicios: <IGAC – CIAF – ICDE>, 2008 5 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> 7.1. Databases (Bases de Datos): Muestra las bases de datos existentes. También brinda la opción de crear una nueva base de datos, de actualizar y de hacer reportes de estadísticas y objetos. 7.2.1. Tablespaces (Espacios de Tablas): Un tablespace es un espacio que se asigna a una base de datos para que allí se alojen todos los datos correspondientes a la configuración de tablas de la misma. Existen dos espacios de tablas por defecto: pg_default y pg_global. No es indispensable que el Administrador cree un nuevo espacio de tablas para la base de datos idecan, pero es recomendable. Este servicio brinda las opciones de crear un nuevo espacio de tablas, de actualizar y de hacer reportes de estadísticas y objetos. Si el Administrador desea crear un nuevo espacio de tablas, debe hacer clic en esta opción, y llenar los datos del directorio que será el nuevo espacio: Nombre, Ubicación, Propietario, Comentarios. La carpeta de destino del nuevo espacio de tablas debe tener todos los permisos para el usuario que va a ser el propietario. Este espacio de tablas será un parámetro más a tener en cuenta en la creación de una nueva base de datos. 7.2.2. Group Roles (Roles de Grupo): Esta opción brinda la posibilidad de crear roles de usuario para un grupo de usuarios que quieran acceder como grupo y no de manera individual. Para este caso es irrelevante. 7.3. Login Roles (Roles de Usuario): Esta opción nos brinda la posibilidad de ver los roles de usuarios existentes en PostgreSQL, que pueden ser propietarios de una base de datos o de un tablespace. Por defecto, PostgreSQL se configura con un superusuario definido en la instalación, llamado postgres. Si el Administrador desea crear un nuevo rol, puede hacerlo llenando los campos esenciales: Nombre del Rol, contraseña, confirmación de contraseña, expiración de la cuenta, privilegios de rol. Para este caso, lo más importante es que el nuevo rol pueda crear objetos de base de datos. Sin embargo, no es necesario crear un nuevo rol. 10. Ya que el Administrador ha identificado y configurado los anteriores elementos según sus necesidades, puede proceder a crear la base de datos idecan. El Administrador hace clic derecho en la opción Databases; esta acción muestra las opciones de Actualizar, Crear nueva base de datos, y Reportes. 11. El Administrador hace clic en la opción Crear nueva base de datos. 12. El Administrador debe llenar los parámetros solicitados que se ven en la siguiente figura (se llenarán sólo los datos esenciales): <IGAC – CIAF – ICDE>, 2008 6 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> 12.1. Nombre (Name): Nombre de la base de datos. Para este caso, el nombre de la base de datos será idecan. 12.2. OID: Owner Id: Este campo es un número que llena PostgreSQL por defecto cuando se asigna un propietario a la base de datos, y que identifica a dicho propietario. 12.3. Propietario (Owner): PostgreSQL muestra en una lista desplegable los roles de usuario que pueden ser propietarios o “creadores” de la base de datos. En este caso, el Administrador selecciona un rol con permisos de creación de objetos de base de datos creado previamente, y llamado igac. 12.4. Codificación (Encoding): El sistema de codificación de la base de datos es importante, ya que no todos los sistemas son compatibles con objetos geográficos. Para este caso, el Administrador selecciona de la lista desplegable la codificación LATIN1. 12.5. Plantilla (Template): Para hacer la base de datos compatible con el modelo de datos para objetos geográficos, el Administrador debe seleccionar la plantilla template_postgis, que proporciona PostGIS, para que por defecto se establezcan unas tablas que darán soporte a los archivos geográficos que se cargarán. 12.6. Espacio de tablas (Tablespace): Como se ha mencionado en el numeral 7.2.1. de este flujo de eventos, el Administrador puede escoger un espacio de tablas para que la información de configuración de la base de datos quede guardada en ese directorio. Si se ha creado un espacio de tablas previamente, éste se mostrará en la lista desplegable. Si no, podemos tomar el espacio de tablas por defecto llamado pg_default. 12.7. Restricción de Esquema (Schema restriction): PostgreSQL asocia la nueva base de datos con un esquema por defecto público llamado public. No es necesario ingresar una restricción al respecto, por lo que este campo no se modifica. 12.8. Comentarios (Comment): Pueden escribirse comentarios sobre la configuración de la base de datos. No es indispensable. 13. El Administrador hace clic en el botón OK. <IGAC – CIAF – ICDE>, 2008 7 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> 14. El Administrador sigue los pasos del flujo de eventos descrito en el caso de uso Cargar capas del Mapa Regional Andino en la Base de Datos, desde el punto 5 hasta el punto 12. 15. Luego de haber cargado las capas geográficas a la base de datos, esta queda preparada para poder ser accedida, como se menciona en el punto 4 del flujo de eventos del caso de uso Generar Mapa Regional Andino, o por cualquier cliente de escritorio. Además, la base de datos idecan quedará configurada para ser utilizada por el Visor de Mapas del Geoportal de la IDECAN. 2.2 Flujos Alternativos 2.2.1 PostgreSQL+PostGIS no han sido configurados 3.a. Este caso de uso sólo especifica la forma de cargar archivos .shp a la base de datos. El Administrador cuenta con que el sistema manejador de bases de datos PostreSQL y el complemento para soporte de objetos geográficos PostGIS han sido instalados y configurados previamente, por él mismo o por otro miembro del equipo, que generalmente es un Desarrollador. En caso de no encontrarlos configurados, el Administrador debe ponerse en contacto con el encargado de dicho proceso. 2.2.2 No ha sido configurada la variable de entorno para PostgreSQL 4.a. Si la variable de entorno no ha sido configurada, esto no es impedimento para la carga de los archivos a la base de datos. Simplemente el Administrador debe ubicarse por medio de la consola de comandos en el directorio de los binarios de PostgreSQL, y desde allí ejecutar la sentencia descrita en el numeral 15 del flujo de eventos. Esta ruta es por lo general: “C:\Archivos de Programa\PostgreSQL\8.2\bin”. 2.2.3 Acceso a los servidores de bases de datos 8.a. En la configuración de PostgreSQL, puede haberse configurado una contraseña para proteger los servidores de bases de datos. Si el Administrador hace clic en los servidores, PostgreSQL puede solicitarle dicha contraseña, que ha sido asignada por la persona que ha instalado y configurado PostgreSQL. El Administrador debe ponerse en contacto con esta persona para adquirir dicha contraseña. 2.2.4 Parámetros de la base de datos 12.3.a. El Administrador debe seleccionar un rol de usuario existente como propietario. 12.5.a. Existen otras plantillas, pero el Administrador debe seleccionar la plantilla template_postgis, ya que es la única que brinda el soporte de objetos geográficos. 3. Requerimientos especiales Ninguno 4. Precondiciones 4.1. Tener los archivos geográficos .shp Estos archivos deben ser proporcionados por cada país miembro de la CAN, y deben estar acordes con el Modelo de Datos homologado, planteado en el caso de uso Generar Mapa Regional Andino, basado en la Especificación Global Map versión 2.3. 4.2. Instalación y configuración previa de PostgreSQL+PostGIS La instalación y configuración previa de estos componentes es fundamental para la creación de la base de datos y la carga de archivos. PostgreSQL permite instalar PostGIS desde su configuración de instalación, como un paquete adicional. Sin embargo, PostGIS también puede ser instalado así no se haya especificado en la instalación de PostgreSQL, ya que posee un <IGAC – CIAF – ICDE>, 2008 8 Geoportal IDECAN Especificacion de Casos de Uso: Configurar base de datos Versión: <1.0> Fecha: <15/04/08> instalador propio. Es importante tener en cuenta información como nombres de usuario y contraseñas empleadas en la configuración. 5. Postcondiciones 5.1 Conexión exitosa con la base de datos Una vez el Administrador ha escogido un cliente, y si se han seguido los pasos descritos en el flujo de eventos, la conexión a la base de datos para visualizar el Mapa Regional Andino será exitosa. 6. Puntos de Extensión Existe dos puntos de extensión asociados a este caso de uso: Generar Mapa Regional Andino y Cargar capas del Mapa Andino en la base de datos de PostgreSQL. 6.1 Generar Mapa Regional Andino 6.2 Cargar capas del Mapa Andino en la base de datos de PostgreSQL <IGAC – CIAF – ICDE>, 2008 9