Información ampliada de los parámetros con el IBM Data Server Driver for JDBC and SQLJ
IBM Data Server Driver for JDBC and SQLJ -solo los métodos y las constantes le permiten asignar el valor predeterminado o ningún valor a las columnas de la tabla o a las columnas de la clase " ResultSet ".
El servidor de datos debe admitir indicadores extendidos antes de que pueda utilizar los métodos que proporcionan información de indicadores extendidos en sus aplicaciones Java. Si invoca uno de estos métodos para un servidor de datos que no ofrece soporte para los indicadores ampliados, se generará una excepción. Db2 for z/OS®, versión 10 o posterior, o Db2 en sistemas Linux®, UNIX y Windows, versión 9.7 o posterior, admiten información de parámetros ampliada.
En la tabla siguiente se enumeran los métodos que proporcionan información sobre parámetros ampliados.
| Métodos de información sobre parámetros ampliados | Finalidad |
|---|---|
| DB2PreparedStatement.setDBDefault, DB2PreparedStatement.setJccDBDefaultAtName | Establece un parámetro de entrada en el valor por omisión. |
| DB2PreparedStatement.setDBUnassigned, DB2PreparedStatement.setJccDBUnassignedAtName | Indica que un parámetro de entrada es UNASSIGNED. Esta acción produce el mismo comportamiento que tendría lugar si el parámetro de entrada no apareciese en el texto de la sentencia de SQL. |
| DB2ResultSet.updateDBDefault | Establece un valor de columna de la fila ResultSet actual en el valor por omisión. |
Estos métodos son aplicables solamente para los marcadores de parámetro que aparecen en uno de los lugares siguientes:
- La lista SET de una sentencia UPDATE
- La lista SET de una sentencia MERGE
- La lista VALUES de una sentencia INSERT
- La lista VALUES de una sentencia MERGE
- La tabla fuente de una sentencia MERGE
- La lista SELECT de una operación INSERT de una sentencia SELECT
Se generará una excepción SQLException si se utilizan estos métodos en cualquier otro contexto.
Alternativamente, puede utilizar los métodos estándar PreparedStatement.setObject o ResultSet.updateObject con IBM Data Server Driver for JDBC and SQLJ -solo constantes DB2PreparedStatement.DB_PARAMETER_DEFAULT o DB2PreparedStatement.DB_PARAMETER_UNASSIGNED para asignar el valor predeterminado o ningún valor a los parámetros.
La información sobre parámetros ampliados puede simplificar los programas de aplicación que tienen diversas variables de entrada, cada una de las cuales puede enviar un valor o el valor por omisión al servidor de datos o no es necesario que aparezca en la sentencia de SQL. En lugar de preparar series de sentencia independientes para todas las combinaciones de valores de variables, puede preparar una sola serie de sentencia. El objeto PreparedStatement resultante puede utilizarse en un lote homogéneo, pero varios objetos PreparedStatement distintos no pueden utilizarse en un lote homogéneo.