Parámetros con valores de tabla (ODBC)

Se aplica a:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

La compatibilidad con ODBC para parámetros con valores de tabla permite a una aplicación cliente enviar datos parametrizados al servidor más eficazmente, enviando varias filas al servidor con una llamada.

Para obtener información sobre los parámetros con valores de tabla en el servidor, vea Usar parámetros de Table-Valued (motor de base de datos).

En ODBC, hay dos formas de enviar parámetros con valores de tabla al servidor:

• Todos los datos de parámetros con valores de tabla pueden estar en memoria en el momento en que se llama a SQLExecDirect o SQLExecute. Estos datos se almacenan en matrices si hay varias filas en el valor de tabla.

• Una aplicación puede especificar datos en ejecución para un parámetro con valores de tabla cuando se llama a SQLExecDirect o SQLExecute. En este caso, las filas de datos para el valor de tabla se pueden proporcionar en lotes o de uno en uno para reducir los requerimientos de memoria.

La primera opción habilita los procedimientos almacenados para encapsular más lógica de negocios. Por ejemplo, un procedimiento almacenado único podría encapsular una transacción de entrada de pedido entera cuando los elementos del pedido se pasan como un parámetro con valores de tabla. Esta opción es muy eficaz, porque se requiere solo un único ciclo de ida y vuelta al servidor. Alternativamente, podría utilizar diferentes procedimientos para administrar por separado el encabezado y los elementos del pedido, lo que requeriría más código y un contrato más complejo entre el cliente y servidor.

El segundo método proporciona un mecanismo eficaz para las operaciones masivas con cantidades muy grandes de datos. Esto habilita a una aplicación para transmitir en secuencias filas de datos al servidor sin tener que almacenar primero todos en memoria.

Puede crear restricciones y claves principales al crear la variable de tabla. Las restricciones constituyen un buen medio de asegurarse de que los datos de una tabla cumplan requisitos concretos.

En esta sección

Usos de parámetros con valores de tabla de ODBC
Describe los escenarios de usuario principales para parámetros con valores de tabla y ODBC.

Tipo SQL de ODBC para parámetros con valores de tabla
Describe el tipo SQL_SS_TABLE. Se trata de un nuevo tipo SQL de ODBC que admite parámetros con valores de tabla.

Campos de descriptor de parámetros con valores de tabla
Describe campos de descriptor que admiten parámetros con valores de tabla.

Campos de descriptor para columnas de parámetros con valores de tabla
Describe campos de descriptor que tienen significado para parámetros con valores de tabla.

Campos de registros de diagnóstico para parámetros con valores de tabla
Describe dos campos de diagnóstico agregados a los registros de diagnóstico para admitir los parámetros con valores de tabla.

Atributos de instrucción que afectan a parámetros con valores de tabla
Describe un nuevo campo de encabezado de descriptor que habilita la manipulación de columnas de parámetros con valores de tabla.

Enlace y transferencia de datos de valores de columnas y parámetros con valores de tabla
Describe el enlace de parámetros y cómo pasar un parámetro con valores de tabla al servidor.

Metadatos de parámetros con valores de tabla para instrucciones preparadas
Describe cómo una aplicación puede obtener metadatos para una llamada a procedimiento preparada.

Metadatos de parámetros con valores de tabla adicionales
Describe cómo usar SQLProcedureColumns, SQLTables y SQLColumns para recuperar metadatos de un parámetro con valores de tabla.

Conversión de datos de parámetros con valores de tabla y otros errores y advertencias
Describe cómo procesar los errores en valores de columna de parámetro con valores de tabla.

Compatibilidad entre versiones
Describe los conflictos que pueden producirse cuando un cliente o servidor de una versión anterior a SQL Server 2008 (10.0.x) usan los parámetros con valores de tabla.

Resumen de la API de parámetros con valores de tabla de ODBC
Muestra la lista de funciones ODBC que admiten parámetros con valores de tabla.

Consulte también

SQL Server Native Client (ODBC)
Parámetros con valores de tabla (SQL Server Native Client)