Las instrucciones que se enumeran a continuación han de ejecutarse a través del método «SqlExec» de la clase «SqlServer» predefinida en MultiBase. Por ejemplo:
tsql "create multibase catalogs"
CREATE MULTIBASE CATALOGS
Esta instrucción crea el catálogo de MultiWay para la
base de datos en curso. Como ya se ha indicado anteriormente, MultiWay
utiliza un catálogo propio, compuesto por una serie de tablas
cuyos nombres comienzan por «mb» («mbtables», «mbcolumns», «mbindexes»,
etc.). Estas tablas guardan total simetría con las tablas de
catálogo del CTSQL de MultiBase («systables», «syscolumns», «sysindexes»,
etc.).
DROP MULTIBASE CATALOGS
Al contrario que la anterior, esta instrucción se encarga de
borrar el catálogo de la base de datos en curso. Como ya se
ha indicado, estas tablas en los «gateways» se identifican
porque su nombre comienza por «mb».
BEGIN MAINTENANCE MODE
A partir de la ejecución de esta directiva, las instrucciones
SQL que se ejecuten a continuación no tendrán ningún
efecto sobre la base de datos, salvo el que respecta a los catálogos
de MultiWay.
Esta directiva es obligatoria para actualizar el catálogo de
MultiWay cuando se han ejecutado instrucciones que afectan a la definición
de la base de datos, utilizando el servidor directamente y no desde
MultiBase.
END MAINTENANCE MODE
Esta instrucción finaliza el modo de mantenimiento abierto mediante
la instrucción «BEGIN MAINTENANCE MODE».
NOTA: «BEGIN MAINTENANCE MODE» y «END MAINTENANCE
MODE» se utilizarán para «alimentar» las tablas
del catálogo de MultiWay (tablas «mb») con la información
de las tablas creadas anteriormente con el propio servidor de la base
de datos. Por ejemplo, si ya existe una base de datos en cualquiera
de los gestores de base de datos y se instala el módulo MultiWay,
habrá que alimentar las tablas del catálogo para que éste
pueda manejar dicha base de datos. Más adelante se exponen unos
ejemplos prácticos sobre esta operación.
EXECSQL "instrucción_sql_servidor"
Esta instrucción ejecuta en modo transparente la frase SQL especificada
en «instrucción_sql_servidor». Esto significa que
dicha instrucción es enviada sin analizar ni traducir al servidor
de la base de datos correspondiente. Es muy necesaria cuando se quiere
ejecutar desde MultiBase alguna instrucción específica
del servidor, y por lo tanto no perteneciente al CTSQL (la «instrucción_sql_servidor» nunca
puede ser una sentencia SELECT).
Además de las variables de entorno generales, la instalación en cliente-servidor con el gestor CTSQL de MultiBase precisa, además, la configuración de las siguientes variables en las máquinas «clientes»:
DBHOST: Nombre del servidor donde se encuentra la base de datos.
DBUSER: Nombre de usuario para la base de datos que será utilizado para otorgar o revocar privilegios de acceso a la misma.
XDBTEMP: Directorio en el servidor para la creación de ficheros temporales.
DBPATH: Directorio en el servidor para la localización de la base de datos.
DBPASSWD: Palabra clave («password») del usuario del servidor indicado en la variable de entorno DBUSER.
DBSERVICE: (Opcional). Nombre del gestor de base de datos en el servidor. Su valor por defecto es CTSQL.
1. Configuración de las máquinas «clientes»:
Ejemplo de entorno:
DBSERVICE=ctsql
DBHOST=nombre_host
DBUSER=user1
DBPATH=/usr/almacen
XDBTEMP=/tmp
DBPASSWD=clave
Este fichero indica las siguientes características:
2. Configuración del servidor:
Para trabajar con el CTSQL sólo será necesario configurar
los ficheros de comunicaciones «inetd.conf» y «/etc/services».
La forma de configurar estos ficheros se explica en el capítulo «Procedimiento
de Instalación» del Manual del Administrador de MultiBase.