SGME Documento Adjunto. Manual de introducción al acceso a la base de datos. Andrés Moschini

Transcripción

1 SGME Documento Adjunto Manual de introducción al acceso a la base de datos Andrés Moschini Índice Introducción...2 Aclaración sobre tipos...2 Operaciones del servidor y permisos...3 Creación de Usuario...3 Eliminación de Usuario...3 Conexión a la base de datos...4 Desconexión de la base de datos...4 Modificación de Clave de usuario...4 Asignación de rol a usuario...4 Desvincular rol y usuario...5 Validación de una persona como configurador...5 Validación de una persona como usuario...5 Invocación de las operaciones principales...6

2 Introducción El presente documento se incluye con el objetivo de generar un nivel de abstracción, que en los demas documentos del proyecto SGME permitirá hacer referencia a la base de datos como si se tratase de un subsistema con una iterface bien definida y delimitada o API. Dicha API estará conformada por un conjunto de operaciones, en general stored procedures. Son la excepción aquellas relacionadas mas directamente con el servidor Firebird mismo, cuyos comandos están fuera del lenguaje PSQL, por ejemplo: creación de usuarios y login. La arquitectura de nuestra aplicación se basa en el modelo cliente/servidor, con clientes mas o menos livianos que solo implementan la interfase con el usuario. Las capas de negocio y de datos están integradas en en el servidor: los datos organizados en tablas y la lógica de negocio distribuida en triggers, permisos, restricciones y stored procedures. La intención de esta API es ocultar al sistema cliente la organización interna del servidor, simplificando y ordenando el diseño de ambas partes. La definición de esta API escapa al alcanze del presente documento e irá creciendo a medida que se avance en las iteraciones. Aclaración sobre tipos Firebird no soporta de forma nativa el tipo booleano, por lo cual se ha definido un dominio D_BOOL CHAR(1) que reprenta Verdadero con el carácter 'T' y Falso con el carácter 'F'. Tampoco soporta tipos de datos variables en una misma columna, eso se resolvio guardando los datos que podrían tomar valores de diferentes tipos como VARCHAR(255) cuyo primer carácter indicaría el tipo al que corresponde el contenido. 2

3 Operaciones del servidor y permisos Algunas de las operaciones del servidor no pertenecen al standard SQL o al lenguaje PSQL, por ello, a continuación se explicara como realizar dichas operaciones de dos diferentes formas: Utilizando las herramientas de línea de comandos de Firebird y utilizando la interfase ADO.NET. Previamente se presentarán algunas conceptos comunes para todas estas operaciones. Inicialización del objeto encargado de agregar, eliminar y modificar usuarios del servidor de base de datos: FirebirdSql.Data.Firebird.Services.FbSecurity FBSecurity = new FbSecurity(); FBSecurity.ConnectionString = <<string de la forma "User=nombreUsr; Password=claveUsr; Server=Server; >> Selección de un usuario por su nombre: FbUserData buscarusuario(fbsecurity _fbsecurity, String nombreusuario) { } FbUserData[] datosdeusuarios = _fbsecurity.displayusers(); FbUserData datosusuario = null ; foreach (FbUserData DatosUsuario in datosdeusuarios) { } if (DatosUsuario.UserName == nombreusuario) datosusuario = DatosUsuario; Ejecución de la herramienta gsec para un servidor local: gsec user nombreusr password claveusr Ejecución de la herramienta gsec para un servidor remoto: gsec user nombreusr password claveusr database DirecciónServer:RutaBaseDatosSecurity Creación de Usuario SERV_FIREBIRD.NUEVOUSR(NOMBRE : string, CLAVE : int) <<Inicializacion de FBSecurity>> FbUserData UsuarioModificar = new FbUserData(); UsuarioModificar.UserName = NOMBRE; UsuarioModificar.UserPassword = CLAVE; FBSecurity.AddUser(UsuarioModificar); <<Ejecución de GSEC>> GSEC> add NOMBRE pw CLAVE Eliminación de Usuario SERV_FIREBIRD.QUITARUSR(NOMBRE : string) <<Inicializacion de FBSecurity>> FbUserData UsuarioModificar = buscarusuario(fbsecurity, NOMBRE); FBSecurity.DeleteUser(UsuarioModificar); <<Ejecución de GSEC>> GSEC> delete NOMBRE 3

4 Conexión a la base de datos SERV_FIREBIRD.CONECTAR(NOMBRE : string, CLAVE : string, ROL : string) Permitido a: Persona. FbConnection FBConnection = new FbConnection(<<string de la forma "User=nombreUsr; Password=claveUsr; Database=RutaBaseDatosMANTMMGR; DataSource=DireccionServer; Role=ROL; >>); FBConnection.Open(); <<Ejecución de herramienta ISQL>> SQL>CONNECT RutaBaseDatos user nombreusr password claveusr ; Desconexión de la base de datos SERV_FIREBIRD.Desconectar() Permitido a: Persona. FBConnection.Close(); SQL> EXIT; Modificación de Clave de usuario SERV_FIREBIRD.CAMBIARCLAVE(NOMBRE : string, CLAVE : string) Permitido a: Persona (solo cambiar su propia clave); AdminClaves (Cambiar cualquier clave). <<Inicializacion de FBSecurity>> FbUserData UsuarioModificar = buscarusuario(fbsecurity, NOMBRE); UsuarioModificar.UserPassword = clavenueva; fbsecurity.modifyuser(usuariomodificar); <<Ejecución de GSEC>> GSEC> modify NOMBRE pw CLAVE Asignación de rol a usuario DB_MANTMMGR.ASIGNARROL(USR : string, ROL : string) FbCommand command = new FbCommand("GRANT + ROL + TO " + USR + ";", FBConnection); command.executenonquery(); SQL> GRANT ROL TO USR; 4

5 Desvincular rol y usuario DB_MANTMMGR.QUITARROL(USR : string, ROL : string) FbCommand command = new FbCommand("REVOKE + ROL + FROM " + USR + ";", FBConnection); command.executenonquery(); SQL> REVOKE ROL FROM USR; Validación de una persona como configurador APIDB.VALIDARCONFIGURADOR() Permitido a: Configurador. Sintaxis SQL: EXECUTE PROCEDURE VALIDARCONFIGURADOR; Validación de una persona como usuario APIDB.VALIDARUSUARIO() Permitido a: Usuario. Sintaxis SQL: EXECUTE PROCEDURE VALIDARUSUARIO; 5

6 Invocación de las operaciones principales Las operaciones principales a realizar sobre los datos del sistema se implementan como stored procedures de manera que pueden ser invocados como cualquier orden SQL standard. Dichas operaciones se describirán en un documento acerca de la API de la base de datos. Ejemplos desde ADO.NET Llamada a un SP ejecutable que no devuelve nada: FbCommand command = new FbCommand( EXECUTE PROCEDURE <<NOMBRE DEL SP Y SUS PARAMETROS>>;, FBConnection); command.executenonquery(); Llamada a un SP ejecutable que devuelve un valor: FbCommand command = new FbCommand( EXECUTE PROCEDURE <<NOMBRE DEL SP Y SUS PARAMETROS>>;, FBConnection); object Variable = command.executescalar(); Llamada a un SP seleccionable que devuelve varias filas: FbCommand command = new FbCommand( SELECT <<COLUMNAS>> FROM <<NOMBRE DEL SP Y SUS PARAMETROS>>;, FBConnection); FbDataReader reader = command.executereader(); Ejemplos desde Línea de Comandos Llamada a un SP ejecutable : SQL> EXECUTE PROCEDURE <<NOMBRE DEL SP Y SUS PARAMETROS>>; Llamada a un SP seleccionable : SQL> SELECT <<COLUMNAS>> FROM PROCEDURE <<NOMBRE DEL SP Y SUS PARAMETROS>>; 6