Está en la página 1de 6

CURSO DE MODELAMIENTO DE BASES DE DATOS

NORMAS DE DOCUMENTACIN

ASIGNATURA: DISEO DE BASE DE DATOS


DOCUMENTO: NORMAS DE DOCUMENTACION
ACTUALIZACION: CRE: 14/12/2000. MOD: 15/12/2000 - MOD: 28/05/2004
RESPONSABLE: MIGUEL ANGEL NIO ZAMBRANO
REVIZADO: CARLOS ALBERTO COBOS LOZADA
MARTHA ELINA MENDOZA BECERRA

1 OBJETIVO

El objetivo de este documento es establecer los estndares que se utilizaran en el


diseo, documentacin e implementacin de los modelos de bases de datos
relacinales.

2 DOCUMENTACION DE LAS BASES DE DATOS

Teniendo en cuenta que una base de datos puede ser consultada, modificada y
actualizada por una persona que no necesariamente es su autor, stas deben
contemplar ciertas caractersticas que la hagan legible, comprensible y fcilmente
modificable.

Segn la metodologa general de desarrollo de las bases de datos se puede


establecer la documentacin en los siguientes niveles:

1. Diseo Conceptual: El diseo conceptual debe incluir:


 Descripcin: Es el establecimiento de las caractersticas y procesos
generales del sistema que se esta analizando. En esta deben aparecer
claramente los objetivos de la elaboracin de la base de datos y el
problema que resuelve, las reglas de negocio detectadas inicialmente y
los alcances de la misma.
 Etapa de anlisis de requisitos: Para detectar requerimientos se puede
utilizar una metodologa como casos de usos de UML u otra que permita
documentar los mismos. Como sugerencia se pueden hacer las
siguientes preguntas sobre los procesos de la empresa: Qu es lo que
hace?, Cmo se hace?, CON CUANTA FRECUENCIA se hace?,
Quin lo hace?, Dnde se hace?, CON QUE se hace? Y Qu
PASA si no se hace?, tambin se debe tener en cuenta las polticas y
restricciones de la organizacin, stos procesos se deben almacenar en
el diccionario de datos del sistema.

Base de Datos 1
 Esquema Conceptual: Debe presentar el modelo escogido (enfoque
lingstico, el enfoque de categorizacin de objetos o una combinacin
de los dos) para obtener el esquema conceptual y su aplicacin paso a
paso. La fase de modelacin conceptual cumple los siguientes objetivos:
o Captar y almacenar el universo del discurso mediante una
descripcin rigurosa, representando la informacin que describe
a la organizacin y que es necesaria para su funcionamiento.
o Aislar la representacin de la informacin de los requisitos de la
mquina y el software, adems de las exigencias de cada usuario
en particular unificando criterios.
o Independizar la definicin de la informacin de los sistemas de
gestin de bases de datos - SGBD en concreto.
Los esquemas conceptuales se caracterizan por:
o Claridad, que no sea ambigua.
o Coherencia, sin contradicciones o confusiones
o Plenitud, representa lo esencial sin ser exhaustivo.
o Fidelidad, la representacin del universo del discurso ha de
hacerse sin desviaciones ni deformaciones.
o Simplicidad, mxima sencillez (Nmero reducido de
componentes, conceptos separados, redundancia controlada).
Adems como se pueden encontrar varias vistas de la realidad se debe
seleccionar otro modelo (Modelo Particular general, general
particular, teora general de sistemas - TGS o una combinacin de ellos).
Debe presentar de una forma clara cada uno de los pasos seguidos y los
productos obtenidos en la aplicacin del modelo.
 Modelo ER: Es la transformacin del anlisis conceptual al modelo
Entidad Interrelacin - ER (la convencin de representacin escogida ya
sea diamantes, flechas u otra debe mantenerse en todos los procesos
de desarrollo de las bases de datos y ser ampliamente conocidos por
todos los desarrolladores). Este sigue siendo independiente del SGDB.
Debe presentar dos subproductos: Tabla de Dominios (tabla, atributos,
evaluacin1, tipo de dato, tamao, descripcin) y el Esquema ER (dnde
solo se presentan entidades y relaciones). Se puede decir que el ER
bien definido cumple con las tres primeras formas normales como
mnimo.

2. Diseo Lgico: El diseo lgico debe incluir:


 Modelo Relacional: Es la transformacin del esquema ER en el
Esquema Relacional (Normalizacin completa, solucin de las
relaciones). Se presenta nuevamente dos subproductos: Tabla de
Dominios (actualizada con las nuevas entidades resultantes de la
normalizacin) y el Esquema Relacional (con la convencin de
diamantes o flechas).

3. Diseo Fsico: El diseo fsico debe incluir:

1
La evaluacin incluye si es Llave Candidata (lc), Llave Primaria (lp), Atributo normal (a),
Multievaluado (M), Compuesto (C).

Base de Datos 2
 Autodocumentacin: Como en el diseo fsico es el paso del diseo
lgico a una SGBD escogido, la documentacin se establece sobre la
implementacin de la base de datos. Esta autodocumentacin debe
estar incluida desde la elaboracin de los modelos ER y Relacional. La
informacin detallada la puede encontrar en el siguiente apartado.
 Programacin: Con frecuencia los SGBD incluyen algn tipo de
programacin como en los procedimientos almacenados o SQL
programable. En estos casos se procede a autodocumentar de la
misma forma como se explica en el documento de documentacin de
programas.

3 AUTODOCUMENTACION DEL MODELO ER Y RELACIONAL

La autodocumentacin se hace a nivel de nombre de tablas, atributos, relaciones e


ndices, es decir a nivel del diccionario de datos de la base de datos. Es importante
aclarar que los nombres escogidos deben cumplir con las siguientes caractersticas.

3.1 Nombramiento de las Tablas

 Tomar una longitud mxima de 18 caracteres.


 Los nombres no deben tener espacios, y caracteres especiales de SQL.
 Si el contenido de la tabla esta representado por un solo sustantivo se debe
escribir completamente.
 Si el nombre de la tabla presenta ms de un sustantivo se debe escoger los
dos (2) ms significativos y de la siguiente forma:
o Del primero se debe tomar la totalidad de las letras
o Del segundo se debe tomar las primeras letras de la palabra, segn
convenga teniendo en cuenta como mnimo tres (3) y como mximo
cinco (5) de ellas
 No se deben incluir artculos, adverbios, adjetivos, preposiciones,
pronombres, conjunciones ni underscores.
 Los nombres deben ir representados con mayscula para la primera letra de
cada sustantivo y en minscula para las dems, Ej. MateriasEqui para las
Materias Equivalentes.
 Los nombres deben ir en plural, como por ejemplo Profesores, a menos
que sea una contrariedad claramente identificable, como por ejemplo tomar
HojasVida para las Hojas de Vida en lugar de HojasVidas.
 Para distinguir el objeto tabla de todos los dems posibles objetos en una
base de datos debe anteponrsele el prefijo Tbl.
 No se debe utilizar tildes.

Ejemplos. TblMaterias, TblCuentas, TblVentasProp.

3.2 Nombramiento de los Atributos

Para la nomenclatura de los campos se dividi en dos bloques as:

Base de Datos 3
XXX_NombreCampo

 Las primeras letras (XXX) representan el identificador de la tabla, el cual


debe ser nico en el modelo y en lo posible se deben utilizar las letras ms
significativas.
 Un underscore para diferenciar el bloque de la tabla origen del nombre del
campo.
 El Nombre del Campo que sigue las mismas reglas establecidas
anteriormente para los nombres de las tablas, a excepcin de que slo
cuenta con 14 caracteres de longitud.
 Existe un campo especial en la mayora de las tablas y es la llave primaria.
Esta debe estar precedida por el prefijo ID y underscore de las siguiente
forma: XXX_ID_NombreCampo

Ej. Tenemos la siguiente base de datos:

EDITORIALES (E#, NOMBRE, CIUDAD)


LIBROS (L#, TITULO, AUTOR, AO)
PAPELERIAS (P#, NOMBRE, CIUDAD)
EDITORIALES_LIBROS_PAPELERIAS (E#, L#, P#, CANTIDAD)

Con la nomenclatura adecuada debe quedar as:

TblEditoriales (EDT_ID_Codigo, EDT_Nombre, EDT_Ciudad)


TblLibros (LIB_ID_Codigo, LIB_Titulo, LIB_Autor, LIB_Ao)
TblPapelerias (PAP_ID_Codigo, PAP_Nombre, PAPCiudad)
TblEditorialesLib (EDT_ID_Codigo, LIB_ID_Codigo, PAP_ID_Codigo, ELP_Cantidad)

3.3 Nombramiento de Relaciones entre tablas

Cuando dos tablas se encuentran relacionadas se antepone el prefijo Rel


underscore indicando que es una relacin y luego los nombres de las tablas
involucradas. Del ejemplo anterior la tabla de editoriales libros es una relacin
que se llamaba: RelEditorialesLibros y en su transformacin a tabla se llamar
TblRelEditorialesLib. Otro ejemplo es una relacin de libros y autores, entonces el
nombre de la misma ser RelLibrosAutores y su transformacin a tabla ser
TblRelLibrosAut.

3.4 Nombramiento de Otros Objetos de la Base de Datos

Dependiendo del SGBD que se utilice, se pueden manejar objetos diferentes a las
tablas y sus relaciones, como son: los triggers, procedimientos almacenados,
ndices, secuencias, clusters, vistas, sinnimos, links, dominios. Adems algunos
SGBD almacenan datos de aplicacin como formularios, mdulos de cdigo y
reportes.

Base de Datos 4
La forma correcta de autodocumentar estos elementos es genrica y de la siguiente
forma:

 El prefijo del nombre del objeto se establece con tres caracteres


significativos del tipo de objeto, y el nombre tiene el mismo manejo que en
los nombres de las tablas. A continuacin se presentan los prefijos de los
objetos ms utilizados:

Objeto Prefijo Ejemplo


Triggers Trg TrgActualizarCuenta
Procedimientos Almacenados Pra ParaTotalizar
ndices Ind IndCodigoCliente
Secuencias Sec SecCodigoCli
Vistas Vis VisAutoresLibros
Sinnimos Sin SinVentas
Links Lnk LnkClientes
Dominios Dom DomTipoNombre
Formularios Frm FrmPedidos
Reportes Rpt RptVentasMes
Mdulos Mdl MdlLogica

4 LINEAMIENTOS ESPECIALES EN LA IMPLEMENTACIN DE LA BASES


DE DATOS

 El manejo de la base de datos debe realizarse en forma transaccional, sobre


todo en las operaciones crticas de escritura a la Base de Datos.
 La definicin a nivel fsico de:
o La integridad referencial de las tablas en los casos donde sea
adecuado y/o necesario.
o La integridad de entidad como los chequeos y las restricciones en los
casos donde sea adecuado y/o necesario.
o El tamao inicial de las tablas con una proyeccin de un mnimo de
tres(3) aos y el siguiente tamao asignado para cada tabla despus
de usarse completamente el tamao inicial definido.
o El tipo de acceso a cada una de las tablas, para la asignacin de los
candados.
 La utilizacin de los triggers y procedimientos almacenados con el objetivo
de eliminar cdigo redundante dentro de los programas de aplicacin lo cual
hace ms eficiente la realizacin de algunas tareas de mantenimiento y la
sincronizacin de grupos de desarrolladores. Adems en el modelo cliente /
servidor reduce el trfico de la red.
 Establecer el rango de valores recomendables para cada uno de los
parmetros del sistema que garanticen un buen funcionamiento ante las
diferentes variables involucradas, como el nmero de usuarios concurrentes,
el manejo de la memoria compartida y la distribucin de las tablas en los
discos del sistema, entre otras.

Base de Datos 5
5 BIBLIOGRAFA

1. Bases de Datos, Claudia Jimnez, Marcela Varas, DIICC, Facultad de Ingeniera,


Universidad de Concepcin

2. Curso de Bases de Datos I, Segundo semestre de 2000. UNIVERSIDAD DEL


CAUCA. Docente: Miguel Angel Nio Zambrano.

Base de Datos 6