Resumen de la API de parámetros con valores de tabla ODBC

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

ODBC soporta parámetros con valores de tabla (parámetros con valores de tabla) mediante mejoras en varias funciones existentes de la API. Estas funciones trabajan juntas para describir esquemas de parámetros con valores en tabla, vincular y transmitir conjuntos de filas, obtener metadatos y gestionar registros de descriptores.
Las siguientes secciones organizan las funciones ODBC relevantes en grupos lógicos para ayudarte a entender cómo funciona cada parte de la tubería de parámetros con valores de tabla.

Descubrimiento de esquemas de parámetros con valores en tabla y funciones de metadatos

Estas funciones ayudan a una aplicación a detectar la estructura de parámetros con valores de tabla, incluidos los metadatos de columna, las definiciones de parámetros y los tipos de datos SQL disponibles.

Función Propósito
SQLColumns Recupera metadatos de columna para un parámetro o tipo de tabla
SQLDescribeParam Devuelve metadatos de un parámetro con valores en tabla, incluyendo tipo, precisión y escala
SQLGetTypeInfo Recupera los tipos de datos SQL soportados por el controlador para columnas de parámetros con valores de tabla
SQLPrimaryKeys Proporciona información sobre columnas clave en tipos de tabla usados con parámetros de tabla
SQLProcedureColumns Recupera metadatos para parámetros de procedimientos almacenados relacionados con parámetros de tabla
SQLTables Lista tablas y tipos de tablas disponibles como fuentes para declaraciones de parámetros con valores en tablas

Vinculación de parámetros con valores de tabla y transmisión de datos

Estas funciones controlan el enlace de datos estructurados a parámetros, pasando los datos al servidor o transmitiendo filas durante la ejecución.

Función Propósito
SQLBindParameter Enlaza un parámetro con valores de tabla a un búfer de aplicación o conjunto de filas.
SQLParamData Recupera la siguiente parte de un parámetro con valores de tabla transmitidos al usar datos en ejecución
SQLPutData Envía datos de parámetros con valores de tabla en bloques durante las operaciones de ejecución de datos

Ejecución de sentencias para parámetros de valores de tabla

Estas funciones ejecutan sentencias SQL que hacen referencia a parámetros de tabla y gestionan el ciclo de vida de la ejecución.

Función Propósito
SQLExecDirect Ejecuta una sentencia SQL que utiliza parámetros de tabla sin prepararla antes
SQLExecute Ejecuta una instrucción SQL previamente preparada que incluye parámetros de parámetro con valores en tabla

Gestión de descriptores y atributos para parámetros con valores en tabla

Use estas funciones para administrar los campos de descriptor y los atributos de instrucción necesarios para describir correctamente los conjuntos de filas y los parámetros estructurados.

Función Propósito
SQLGetDescField Recupera metadatos de descriptores para columnas de parámetros con valores en tablas o conjuntos de filas
SQLSetDescField Metadatos de descriptores de conjuntos para columnas de parámetros con valores en tablas o conjuntos de filas
SQLSetDescRec Establece un registro descriptor completo para datos de parámetros estructurados con valores en tabla
SQLGetStmtAttr Recupera atributos de la sentencia que afectan al comportamiento de ejecución de parámetros con valores de tabla
SQLSetStmtAttr Establece atributos de sentencias como tamaños de filas o banderas de streaming para operaciones de parámetros con valores en tablas

Diagnóstico y gestión de errores para parámetros de tabla

Utiliza estas funciones para ayudar a tus aplicaciones a detectar errores, advertencias o mensajes de estado durante la vinculación y ejecución de parámetros con valores de tabla.

Función Propósito
SQLGetDiagField Recupera información diagnóstica generada durante el procesamiento de parámetros con valores en tablas

Contenido relacionado

  • Last updated on