jsClient: El objeto SQL ($execute(), $selecttables(), $selectcolumns() y $selectindexes())

$execute()

Do oSQL.$execute(cSQL) Returns id
 

Permite la ejecución de una sentencia SQL de la que no se espera la devolución de un conjunto de resultados, deberá usarse únicamente para la ejecución de comandos administrativos DDL, tales como CREATE, DROP y ALTER.

• cSQL es la sentencia SQL a ejecutar. No está soportado el uso de notación “bind”.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $execute()).

 
Los siguientes pueden ser utilizados para obtener “meta-datos” de la base de datos:

$selecttables()

Do oSQL.$selecttables() Returns id

Devuelve los nombres de tablas definidas en la base de datos local.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $selecttables()).
• Lista de una columna, conteniendo el TableName de cada tabla en la base de datos local.

$selectcolumns()

Do oSQL.$selectcolumns(NombreTabla) Returns id

Devuelve el nombre y tipo de las columnas en la tabla especificada.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $selectcolumns()).

• Una lista que describe la definición de columnas en la tabla, con las siguiente columnas:

ColumnName  Nombre de la columna en la tabla.
SqlType     Nombre que corresponde al tipo de datos SQL en la columna.
ColumnSize  Tamaño definido en variables de tipo CHAR y BINARY.
Precision   Precisión numérica en columnas de tipo numérico.

            Será 0 para los demás tipos.
Scale       Escala numérica en columnas de tipo numérico.

            Cero para los demás tipos.
Default     Valor predeterminado asignado a la columna, cuando se creó la tabla.

$selectindexes()

Do oSQL.$selectindexes(NombreTabla) Returns id

Devuelve, información sobre las columnas de tipo índice en la tabla especificada.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $selectindexes()).

• Una lista que describe la definición de índices para la tabla especificada, con las siguientes columnas:

IndexName     Nombre del índice.
ColumnNames   Lista separada por comas, con los nombres de las columnas 

              utilizadas por el índice.
PrimaryKey    KTrue si el índice ha sido creado con la cláusula PRIMARY KEY
Unique        KTrue si el índice ha sido creado con la cláusula UNIQUE.

jsClient: El objeto SQL ($delete() y $update())

$delete() 

 

Do oSQL.$delete(cSQL,row) Returns id
Elimina cero o más filas de una tabla de la base de datos.

• cSQL es la instrucción delete. La cual puede ser escrita a mano, u obtenida como resultado de la ejecución de un $delete() sobre una clase “schema”. cSQL puede referenciar variables en la forma @[nombre_columna], donde nombre_columna es el nombre de una columna incluida en row.

• row, contiene los valores que podrán ser referenciados mediante notación “bind”.

Al concluir, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $delete()). 

 

$update() 

 

Do oSQL.$update(cSQL,newRow,oldRow) Returns id
Actualiza cero o más filas de una tabla de la base de datos.

• cSQL es la instrucción de actualización. Podrá ser escrita a mano, u obtenida como resultado de la ejecución de un $update sobre una clase “schema”. cSQL permite referenciar variables en la forma @[$nombre_columna], donde nombre_columna es el nombre de una columna contenida en newRow o en oldRow. Si la variable es referenciada en la cláusula SET, se esperará que la columna esté incluida en newRow, pero si se está usando en la cláusula WHERE, deberá estar incluida en oldRow.

• newRow, es la row que contiene los nuevos valores y que podrán ser referenciados mediante notación “bind”, es decir, los que se especifican en la cláusula SET.

• oldRow, es la row que contiene los valores anteriores y que pueden ser referenciados mediante notación “bind”, es decir, los que pueden ser usados en la cláusula WHERE.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $update()).

jsClient: El objeto SQL ($fetch() y $insert())

$fetch()

Do oSQL.$fetch(selectfetchid,iFetchCap) Returns id

Obtiene cero o más filas del conjunto de resultados generado mediante un $selectfetch() anterior.

• selectfetchid es el id retornado por el $selectfetch().
• iFetchCap es el número de filas devueltas.

En este caso, el ID devuelto será el mismo. Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retorno el $selectfetch)
• Una lista conteniendo cero o más filas del conjunto de resultados.

$insert()

Do oSQL.$insert(cSQL,listorrow) Returns id

Inserta una o más filas en una tabla de la base de datos.

• cSQL es la instrucción de inserción. Puede ser escrita a mano, u obtenida como resultado de la ejecución de un $insert sobre una clase “schema”. cSQL puede contener referencias a variables mediante la notación @[$nombre_columna], donde nombre_columna es el nombre de una columna incluida en listorrow.

• listorrow, es una variable de tipo “list” o “row” que contiene los datos a insertar.

Al finalizar, se invocará el método $sqldone() pasando los siguientes parámetros:

• El ID de la solicitud (el mismo que retornó el $insert()).

Ejemplo:
Do oSQL.$insert("INSERT INTO producto (nombre,cantidad) VALUES (@[colNomb],@[colCant])”,lBindVars) Returns IDinsert