Cargar capas del Mapa Regional Andino en la BD en PostgreSQL

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: Cargar capas del
Mapa Regional Andino en la BD en PostgreSQL
Versión 1.0
Geoportal IDECAN
Especificacion de Casos de Uso: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
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: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
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
4
2.1
2.2
4
7
7
7
7
7
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 Errores en la carga de archivos a la base de datos
2.2.4 Automatización del proceso de carga de archivos
3.
Requerimientos especiales
7
4.
Precondiciones
7
4.1.
4.2.
7
7
5.
6.
Tener los archivos geográficos .shp
Instalación y configuración previa de PostgreSQL+PostGIS
Postcondiciones
8
5.1
8
Conexión exitosa con la base de datos
Puntos de Extensión
8
<IGAC – CIAF – ICDE>, 2008
3
Geoportal IDECAN
Especificacion de Casos de Uso: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
Versión:
<1.0>
Fecha: <15/04/08>
Especificación de Casos de Uso: Cargar capas del
Mapa Regional Andino en la BD
1.
Nombre del Caso de Uso
1.1 Descripción Breve
El Administrador desea cargar los archivos geográficos en formato shape (.shp) a la base de datos
previamente configurada en PostgreSQL+PostGIS, como base para poder visualizar el Mapa Regional
Andino según el Modelo de Homologación acordado por los países 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.
2.
Flujo de Eventos
2.1 Flujo Básico
1.
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).
2.
Se asume que PostgreSQL+PostGIS ha sido instalado y configurado, ya que este caso de uso solo explica la
forma específica del cargue de los archivos.
3.
La variable de entorno para PostgreSQL debe haberse establecido previamente.
4.
El Administrador sigue los pasos descritos en el flujo de eventos del caso de uso Configurar base de
datos, desde el punto 6 hasta el punto 13.
5.
El resto del proceso de carga de datos se realizará por comandos en la consola de Windows. Sin embargo,
se recomienda dejar abierto pgAdminIII.
6.
El Administrador se dirige al menú de Accesorios, y luego Símbolo del Sistema. También puede acceder a
la consola de comandos mediante la herramienta Ejecutar, con el comando cmd.
7.
Una vez dentro de la consola de comandos, se tendrá una pantalla como esta:
Allí se escribe el comando shp2pgsql y se da enter. La consola debe mostrar las diferentes opciones para
este comando. Esto sólo es posible si se ha configurado previamente la variable de entorno para
PostgreSQL, como se mencionó en el numeral 3 de este flujo de eventos. Esto permite que el sistema
reconozca este comando sin necesidad de ubicarse en el directorio donde se encuentran los archivos
binarios de PostgreSQL. Se procede entonces a ejecutar la sentencia de código que permitirá cargar un
archivo geográfico.
<IGAC – CIAF – ICDE>, 2008
4
Geoportal IDECAN
Especificacion de Casos de Uso: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
8.
Versión:
<1.0>
Fecha: <15/04/08>
La sentencia es mostrada en la siguiente pantalla:
Los parámetros de la anterior sentencia son los siguientes:
8.1. shp2pgsql: Comando que me permite leer el contenido del archivo .shp especificado y escribirlo luego
en lenguaje pgsql.
8.2.
“C:\...archivo.shp”
(Para
este
caso:
“C:\Luis\Idecan\Datos
CAN\COLOMBIA\transporte\vias\roadl.shp”): Ruta hacia el directorio donde se encuentra el archivo
.shp que será cargado a la base de datos.
8.3. nombre_tabla (Para este caso: via): Nombre que tendrá el archivo como tabla, en la base de datos.
8.4. -I: Crea un índice GiST en la columna que contiene la geometría.
8.5. -s: Define el atributo identificador del Sistema de Referencia Espacial. Para este caso, todos los
archivos se trabajan con el sistema de referencia 4326.
8.6. |: Separador para indicar que termina la instrucción del comando shp2pgsql, y dar paso a la instrucción
en psql.
8.7. psql: Comando que permite opciones de lenguaje estructurado sobre la base de datos. En este caso
permitirá especificar ciertos parámetros de la base de datos.
8.8. -d: Especifica el nombre de la base de datos a la cual se va a conectar, y en donde se crearán las nuevas
tablas a partir de los archivos .shp.
8.9. -U: Especifica el nombre del usuario propietario de la base de datos. Solicita la contraseña para este
usuario, si la tiene.
9.
Al ejecutar la sentencia, se tiene el siguiente resultado:
<IGAC – CIAF – ICDE>, 2008
5
Geoportal IDECAN
Especificacion de Casos de Uso: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
Versión:
<1.0>
Fecha: <15/04/08>
Esto muestra la inserción de los datos alfanuméricos en la base de datos idecan.
10. El Administrador puede verificar que el archivo .shp ha sido cargado exitosamente, revisando en
pgAdminIII el contenido de la base de datos.
11. El Administrador repite estas instrucciones desde el numeral 15 de este flujo de eventos, para cargar a la
base de datos los archivos .shp que necesite mostrar luego en el Mapa Regional Andino.
<IGAC – CIAF – ICDE>, 2008
6
Geoportal IDECAN
Especificacion de Casos de Uso: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
Versión:
<1.0>
Fecha: <15/04/08>
12. De esta forma se ha realizado el cargue exitoso de capas de información del Mapa Regional Andino en la
base de datos de PostgreSQL.
2.2 Flujos Alternativos
2.2.1 PostgreSQL+PostGIS no han sido configurados
2.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
3.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
Errores en la carga de archivos a la base de datos
8.2.a. La ruta no ha sido especificada correctamente: El Administrador debe verificar que la ruta al archivo
.shp es correcta, admitiendo espacios y mayúsculas. Esta ruta debe ir hasta el nombre del archivo,
inculyendo la extensión “.shp”.
8.3.a. Si ya se ha ingresado un archivo con determinado nombre, y se desea ingresar un nuevo archivo, el
nombre de la tabla debe cambiar; sino, se producirá un error, dado que la tabla ya existe.
8.4.a. El comando debe ser -I y no -i, ya que el comando -i tiene una funcionalidad distinta.
8.5.a. El comando debe ser -s y no -S, ya que el comando -S tiene una funcionalidad distinta.
8.8.a. El comando debe ser -d y no -D, ya que el comando -D tiene una funcionalidad distinta. Además, la
base de datos especificada debe existir.
8.9.a. El comando debe ser -U y no -u, ya que el comando -u tiene una funcionalidad distinta. Además, el
rol de usuario debe existir, y ser el propietario de la base de datos especificada.
2.2.4
Automatización del proceso de carga de archivos
9.a. Este proceso puede automatizarse mediante la creación de un archivo .bat, si al Administrador le
resulta muy dispendioso cargar una gran cantidad de archivos .shp.
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
<IGAC – CIAF – ICDE>, 2008
7
Geoportal IDECAN
Especificacion de Casos de Uso: Cargar capas del Mapa Regional Andino en
la BD en PostgreSQL
Versión:
<1.0>
Fecha: <15/04/08>
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
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
Este caso de uso tiene puntos de extensión.
<IGAC – CIAF – ICDE>, 2008
8