Estos procedimientos almacenados se utilizan para tareas administrativas, tales como habilitar o inhabilitar una columna o colección XML. Se invocan mediante el asistente de administración del XML Extender y el mandato de administración dxxadm.
Finalidad
Habilita la base de datos. Cuando se habilita la base de datos, el XML Extender crea los objetos siguientes:
dxxEnableDB(char(UDB_SIZE) nombreBd, /* entrada */ long códigoRetorno, /* salida */ varchar(1024) mensRetorno) /* salida */
Parámetros
Tabla 40. Parámetros de dxxEnableDB()
Parámetro | Descripción | Parámetro de E/S |
---|---|---|
nombreBd | Es el nombre de la base de datos. | ENTRADA |
códigoRetorno | Es el código de retorno que emite el procedimiento almacenado. | SALIDA |
mensRetorno | Es el texto del mensaje que se devuelve en caso de error. | SALIDA |
Finalidad
Inhabilita la base de datos. Cuando el XML Extender inhabilita la base de datos, elimina los objetos siguientes:
dxxDisableDB(char(UDB_SIZE) nombreBd, /* entrada */ long códigoRetorno, /* salida */ varchar(1024) mensRetorno) /* salida */
Parámetros
Tabla 41. Parámetros de dxxDisableDB()
Parámetro | Descripción | Parámetro de E/S |
---|---|---|
nombreBd | Es el nombre de la base de datos. | ENTRADA |
códigoRetorno | Es el código de retorno que emite el procedimiento almacenado. | SALIDA |
mensRetorno | Es el texto del mensaje que se devuelve en caso de error. | SALIDA |
Finalidad
Habilita una columna XML. Cuando habilita una columna, el XML Extender realiza estas tareas:
dxxEnableColumn(char(UDB_SIZE) nombreBd, /* entrada */ char(UDB_SIZE) nombreTb, /* entrada */ char(UDB_SIZE) nombreCol, /* entrada */ CLOB(100K) DAD, /* entrada */ char(UDB_SIZE) espaciotablas, /* entrada */ char(UDB_SIZE) vistaPredefinida,/* entrada */ char(UDB_SIZE) ID_raíz, /* entrada */ long códigoRetorno, /* salida */ varchar(1024) mensRetorno) /* salida */
Parámetros
Tabla 42. Parámetros de dxxEnableColumn()
Parámetro | Descripción | Parámetro de E/S |
---|---|---|
nombreBd | Es el nombre de la base de datos. | ENTRADA |
nombreTb | Es el nombre de la tabla donde reside la columna XML. | ENTRADA |
nombreCol | Es el nombre de la columna XML. | ENTRADA |
DAD | Es un CLOB donde reside el archivo DAD. | ENTRADA |
espaciotablas | Es el espacio de tablas, distinto del espacio de tablas predefinido, que contiene las tablas secundarias. Si no se especifica este parámetro, se utiliza el espacio de tablas predefinido. | ENTRADA |
vistaPredefinida | Es el nombre de la vista predefinida que asocia la tabla de aplicación y las tablas secundarias. | ENTRADA |
ID_raíz | Es el nombre de la clave primaria, contenida en la tabla de aplicación, que se utilizará como id_raíz para la tabla secundaria. | ENTRADA |
códigoRetorno | Es el código de retorno que emite el procedimiento almacenado. | SALIDA |
mensRetorno | Es el texto del mensaje que se devuelve en caso de error. | SALIDA |
Finalidad
Inhabilita la columna habilitada para XML. Cuando la columna XML está inhabilitada, ya no puede contener tipos de datos XML.
dxxDisableColumn(char(UDB_SIZE) nombreBd, /* entrada */ char(UDB_SIZE) nombreTb, /* entrada */ char(UDB_SIZE) nombreCol, /* entrada */ long códigoRetorno, /* salida */ varchar(1024) mensRetorno) /* salida */
Parámetros
Tabla 43. Parámetros de dxxDisableColumn()
Parámetro | Descripción | Parámetro de E/S |
---|---|---|
nombreBd | Es el nombre de la base de datos. | ENTRADA |
nombreTb | Es el nombre de la tabla donde reside la columna XML. | ENTRADA |
nombreCol | Es el nombre de la columna XML. | ENTRADA |
códigoRetorno | Es el código de retorno que emite el procedimiento almacenado. | SALIDA |
mensRetorno | Es el texto del mensaje que se devuelve en caso de error. | SALIDA |
Finalidad
Habilita una colección XML que está asociada a una tabla de aplicación.
dxxEnableCollection(char(UDB_SIZE) nombreBd, /* entrada */ char(UDB_SIZE) nombreCol, /* entrada */ CLOB(100K) DAD, /* entrada */ char(UDB_SIZE) espaciotablas, /* entrada */ long códigoRetorno, /* salida */ varchar(1024) mensRetorno) /* salida */
Parámetros
Tabla 44. Parámetros de dxxEnableCollection()
Parámetro | Descripción | Parámetro de E/S |
---|---|---|
nombreBd | Es el nombre de la base de datos. | ENTRADA |
nombreCol | Es el nombre de la colección XML. | ENTRADA |
DAD | Es un CLOB donde reside el archivo DAD. | ENTRADA |
espaciotablas | Es el espacio de tablas, distinto del espacio de tablas predefinido, que contiene las tablas secundarias. Si no se especifica este parámetro, se utiliza el espacio de tablas predefinido. | ENTRADA |
códigoRetorno | Es el código de retorno que emite el procedimiento almacenado. | SALIDA |
mensRetorno | Es el texto del mensaje que se devuelve en caso de error. | SALIDA |
Finalidad
Inhabilita una colección habilitada para XML, eliminando los marcadores que identifican tablas y columnas como integrantes de una colección.
dxxDisableCollection(char(UDB_SIZE) nombreBd /* entrada */ char(UDB_SIZE) nombreCol, /* entrada */ long códigoRetorno, /* salida */ varchar(1024) mensRetorno) /* salida */
Parámetros
Tabla 45. Parámetros de dxxDisableCollection()
Parámetro | Descripción | Parámetro de E/S |
---|---|---|
nombreBd | Es el nombre de la base de datos. | ENTRADA |
nombreCol | Es el nombre de la colección XML. | ENTRADA |
códigoRetorno | Es el código de retorno que emite el procedimiento almacenado. | SALIDA |
mensRetorno | Es el texto del mensaje que se devuelve en caso de error. | SALIDA |