Conjunto de registros: Parametrizar un conjunto de registros (ODBC)

Artículo
10/07/2008

Actualización: noviembre 2007

Este tema se aplica a las clases ODBC de MFC.

A veces es conveniente poder seleccionar registros en tiempo de ejecución, usando información calculada u obtenida del usuario final. Los parámetros de conjunto de registros permiten alcanzar este objetivo.

En este tema se explica:

El propósito de un conjunto de registros parametrizado.
Cuándo y por qué es conveniente parametrizar un conjunto de registros.
Cómo declarar miembros de datos de parámetro en un conjunto de registros.
Cómo pasar información de parámetros a un objeto de conjunto de registros en tiempo de ejecución.

Conjuntos de registros parametrizados

Los conjuntos de registros parametrizados permiten pasar información de parámetros en tiempo de ejecución. De esta forma, se obtienen dos efectos de gran valor:

Se puede conseguir una mayor velocidad de ejecución.
Permite generar una consulta en tiempo de ejecución, basada en información no disponible en tiempo de diseño, como la información obtenida del usuario o calculada en tiempo de ejecución.

Al llamar a Open para ejecutar la consulta, el conjunto de registros usa la información de parámetros para completar su instrucción SQL SELECT. Se puede parametrizar cualquier conjunto de registros.

Cuándo utilizar parámetros

Los usos más habituales para los parámetros son:

Pasar argumentos en tiempo de ejecución a una consulta predefinida.

Para pasar parámetros a un procedimiento almacenado, se debe especificar una instrucción ODBC CALL completa y personalizada (con marcadores de posición de parámetro) al llamar a Open, reemplazando la instrucción SQL predeterminada del conjunto de registros. Para obtener más información, vea CRecordset::Open en la Referencia de la biblioteca de clases y SQL: Personalizar la instrucción SQL del conjunto de registros (ODBC) y Conjunto de registros: Declarar una clase para una consulta predefinida (ODBC).

Realizar de manera eficiente nuevas consultas con diferentes parámetros.

Por ejemplo, cada vez que un usuario final busca información acerca de un estudiante concreto en la base de datos de registro de estudiantes, se puede especificar el nombre o identificador del estudiante como parámetro obtenido del usuario. Así pues, al llamar a la función miembro Requery del conjunto de registros, la consulta selecciona sólo el registro de ese estudiante.

La cadena de filtro del conjunto de registros, almacenada en m_strFilter, podría tener este aspecto:

"StudentID = ?"

Suponga que obtiene el identificador de estudiante en la variable strInputID. Al establecer un parámetro para strInputID (por ejemplo, el identificador de estudiante 100), el valor de la variable queda enlazado con el marcador de posición del parámetro representado por "?" en la cadena de filtro.

Asigne el valor de parámetro del siguiente modo:

strInputID = "100";
...
m_strParam = strInputID;

No es conveniente que prepare ninguna cadena de filtro de esta manera:

m_strFilter = "StudentID = 100";   // 100 is incorrectly quoted
                                   // for some drivers

Para consultar el uso correcto de las comillas en las cadenas de filtro, vea Conjunto de registros: Filtrar registros (ODBC).

El valor de parámetro es diferente cada vez que se realiza una nueva consulta al conjunto de registros con un nuevo identificador de estudiante.

Sugerencia:
Usar un parámetro es más eficaz que usar solamente un filtro. En un conjunto de registros parametrizado, la base de datos debe procesar la instrucción SQL SELECT sólo una vez. En un conjunto de registros filtrado sin parámetros, la instrucción SELECT debe procesarse cada vez que se llame a Requery utilizando un nuevo valor de filtro.

Para obtener más información acerca de los filtros, vea Conjunto de registros: Filtrar registros (ODBC).

Parametrizar la clase de conjunto de registros

Nota:
Esta sección se aplica a los objetos derivados de CRecordset donde no se haya implementado la obtención masiva de filas. Si se está usando la obtención masiva de filas, implementar los parámetros es un proceso similar. Para obtener más información, vea Conjunto de registros: Obtener registros de forma masiva (ODBC).

Antes de crear la clase de conjunto de registros, determine qué parámetros necesita, sus tipos de datos y cómo los utiliza el conjunto de registros.

Para parametrizar una clase de conjunto de registros

Ejecute el Asistente para consumidores ODBC de MFC utilizando Agregar clase para crear la clase.
Especifique los miembros de datos de campo para las columnas del conjunto de registros.
Después de que el asistente escriba la clase en un archivo del proyecto, vaya al archivo .h y agregue manualmente uno o más miembros de datos de parámetro a la declaración de clase. Esta acción puede tener el siguiente aspecto, como parte de una clase de instantánea diseñada para responder a la consulta "¿Qué estudiantes hay inscritos en el último curso?".
```
class CStudentSet : public CRecordset
{
// Field/Param Data
    CString m_strFirstName;
    CString m_strLastName;
    CString m_strStudentID;
    CString m_strGradYear;

    CString m_strGradYrParam;
};
```
Agregue los miembros de datos de parámetro después de que el asistente genere los miembros de datos de campo. La convención es anexar la palabra "Param" a cada nombre de parámetro definido por el usuario.
Modifique la definición de la función miembro DoFieldExchange en el archivo .cpp. Agregue una llamada de función RFX para cada miembro de datos de parámetro agregado a la clase. Para obtener información sobre cómo escribir sus propias funciones RFX, vea Intercambio de campos de registros: Funcionamiento de RFX. Anteponga a las llamadas RFX correspondientes a los parámetros una única llamada a:
```
pFX->SetFieldType( CFieldExchange::param );
// RFX calls for parameter data members
```
En el constructor de la clase de conjunto de registros, aumente el número de parámetros, m_nParams.

Para obtener información, vea Intercambio de campos de registros: trabajar con el código de asistente.
Cuando escriba el código que crea un objeto de conjunto de registros de esta clase, coloque un símbolo "?" (signo de interrogación) en cada lugar de las cadenas de instrucciones SQL donde se vaya a reemplazar un parámetro.

En tiempo de ejecución, los marcadores de posición "?" se reemplazan, en orden, por los valores de parámetro pasados. El primer miembro de datos de parámetro establecido después de la llamada a SetFieldType reemplaza al primer símbolo "?" de la cadena SQL, el segundo miembro de datos de parámetro reemplaza al segundo "?", etc.

Nota:
El orden de parámetros es importante: el orden de las llamadas RFX en los parámetros de la función DoFieldExchange debe coincidir con el orden de los marcadores de posición de parámetro en la cadena SQL.

Sugerencia:
La cadena con la que es probable que trabaje es la especificada (si la hay) para el miembro de datos m_strFilter de la clase, pero puede que algunos controladores ODBC permitan parámetros en otras cláusulas SQL.

Pasar valores de parámetro en tiempo de ejecución

Se deben especificar valores de parámetro antes de llamar a Open (para un nuevo objeto de conjunto de registros) o a Requery (para uno existente).

Para pasar valores de parámetro a un objeto de conjunto de registros en tiempo de ejecución

Cree el objeto de conjunto de registros.
Prepare una cadena o varias, como la cadena m_strFilter, que contengan la instrucción SQL, o parte de ella. Coloque marcadores de posición "?" donde vaya a ir la información de parámetros.
Asigne un valor de parámetro en tiempo de ejecución a todos los miembros de datos de parámetro del objeto.
Llame a la función miembro Open (o a Requery, para un conjunto de registros existente).

Por ejemplo, supongamos que desea especificar una cadena de filtro para el conjunto de registros usando información obtenida en tiempo de ejecución. Supongamos, igualmente, que se creó anteriormente un conjunto de registros de la clase CStudentSet, denominado rsStudents, y que ahora desea volver a consultarlo para obtener un tipo determinado de información de estudiantes.

// Set up a filter string with 
// parameter placeholders
rsStudents.m_strFilter = "GradYear <= ?";

// Obtain or calculate parameter values 
// to pass--simply assigned here 
CString strGradYear = GetCurrentAcademicYear( );

// Assign the values to parameter data members
rsStudents.m_strGradYrParam = strGradYear;

// Run the query
if( !rsStudents.Requery( ) )
    return FALSE;

El conjunto de registros contiene registros para aquellos estudiantes cuyos registros cumplen las condiciones especificadas por el filtro que se creó a partir de parámetros en tiempo de ejecución. En este caso, el conjunto de registros contiene registros para todos los estudiantes matriculados en el último año de estudios.

Nota:
Si es necesario, se puede establecer el valor de un miembro de datos de parámetro en Null mediante SetParamNull. También se puede comprobar si un miembro de datos de parámetro es Null mediante IsFieldNull.

Vea también

Conceptos

Conjunto de registros (ODBC)

Conjunto de registros: Agregar, actualizar y eliminar registros (ODBC)

Conjunto de registros: Cómo se seleccionan los registros (ODBC)

Share via