Preparar y ejecutar una instrucción (ODBC)
Se aplica a:
SQL Server Azure SQL Database Azure SQL Instancia administrada Azure Synapse Analytics Analytics Platform System (PDW)
Para preparar una instrucción una sola vez y ejecutarla varias veces
Llame a SQLPrepare Function para preparar la instrucción.
Puede llamar a SQLNumParams para determinar el número de parámetros de la instrucción preparada.
Para cada uno de los parámetros de la instrucción preparada, puede hacer lo siguiente:
Llamar a SQLDescribeParam para obtener información sobre los parámetros.
Enlazar cada parámetro a una variable de programa utilizando SQLBindParameter. Configurar cualquier parámetro de datos en ejecución.
Para cada ejecución de una instrucción preparada:
Si la instrucción incluye marcadores de parámetros, coloque los valores de datos en el búfer de parámetros enlazados.
Llame a SQLExecute para ejecutar la instrucción preparada.
Si se usan parámetros de entrada de datos en ejecución, SQLExecute devuelve SQL_NEED_DATA. Envíe los datos en fragmentos utilizyo SQLParamData y SQLPutData.
Para preparar una instrucción con enlace de parámetros de modo de columna
Llame a SQLSetStmtAttr para establecer los atributos siguientes:
Establezca SQL_ATTR_PARAMSET_SIZE en el número de conjuntos (S) de parámetros.
Establezca SQL_ATTR_PARAM_BIND_TYPE en SQL_PARAMETER_BIND_BY_COLUMN.
Establezca el atributo SQL_ATTR_PARAMS_PROCESSED_PTR para que señale a una variable SQLUINTEGER que incluya el número de parámetros procesados.
Establezca SQL_ATTR_PARAMS_STATUS_PTR para que señale a una matriz[S] de variables SQLUSSMALLINT que incluya indicadores de estado de parámetros.
Llame a SQLPrepare para preparar la instrucción .
Puede llamar a SQLNumParams para determinar el número de parámetros de la instrucción preparada.
Opcionalmente, para cada parámetro de la instrucción preparada, llame a SQLDescribeParam para obtener información de parámetros.
Para cada marcador de parámetro:
Asigne una matriz de S búferes de parámetros donde almacenar los valores de datos.
Asigne una matriz de S búferes de parámetros donde almacenar las longitudes de datos.
Llame a SQLBindParameter para enlazar el valor de datos de parámetro y las matrices de longitud de datos al parámetro de instrucción.
Si el parámetro es un parámetro de imagen o texto de datos en ejecución, configúrelo.
Si se utiliza algún parámetro de datos en ejecución, configúrelo.
Para cada ejecución de una instrucción preparada:
Coloque los S valores de datos y S longitudes de datos en las matrices de parámetros enlazadas.
Llame a SQLExecute para ejecutar la instrucción preparada.
Si se usan parámetros de entrada de datos en ejecución, SQLExecute devuelve SQL_NEED_DATA. Envíe los datos en fragmentos utilizyo SQLParamData y SQLPutData.
Para preparar una instrucción con parámetros enlazados de modo de fila
Asigne una matriz[S] de estructuras, donde S es el número de conjuntos de parámetros. La estructura tiene un elemento para cada parámetro y cada elemento tiene dos partes:
La primera parte es una variable del tipo de datos adecuado donde almacenar los datos de parámetros.
La segunda parte es una variable SQLINTEGER donde almacenar el indicador de estado.
Llame a SQLSetStmtAttr para establecer los atributos siguientes:
Establezca SQL_ATTR_PARAMSET_SIZE en el número de conjuntos (S) de parámetros.
Establezca SQL_ATTR_PARAM_BIND_TYPE en el tamaño de la estructura asignada en el paso 1.
Establezca el atributo SQL_ATTR_PARAMS_PROCESSED_PTR para que señale a una variable SQLUINTEGER que incluya el número de parámetros procesados.
Establezca SQL_ATTR_PARAMS_STATUS_PTR para que señale a una matriz[S] de variables SQLUSSMALLINT que incluya indicadores de estado de parámetros.
Llame a SQLPrepare para preparar la instrucción .
Para cada marcador de parámetro, llame a SQLBindParameter para apuntar el valor de datos del parámetro y el puntero de longitud de datos a sus variables en el primer elemento de la matriz de estructuras asignadas en el paso 1. Si el parámetro es un parámetro de datos en ejecución, configúrelo.
Para cada ejecución de una instrucción preparada:
Rellene la matriz de búferes de parámetros enlazados con valores de datos.
Llame a SQLExecute para ejecutar la instrucción preparada. El controlador ejecuta eficazmente la instrucción SQL S veces, una vez para cada conjunto de parámetros.
Si se usan parámetros de entrada de datos en ejecución, SQLExecute devuelve SQL_NEED_DATA. Envíe los datos en fragmentos utilizyo SQLParamData y SQLPutData.