El formato ODBCDriver2 es un formato binario de solo salida que se utiliza para transferir resultados de consultas a través de HTTP al
controlador ODBC de ClickHouse. El controlador lo solicita estableciendo default_format en
ODBCDriver2; los usuarios normalmente no lo seleccionan directamente.
Todos los enteros del flujo son valores con signo de 32 bits codificados en orden de bytes little-endian. Una cadena se codifica como su
longitud en bytes, seguida de sus bytes. La salida tiene la siguiente estructura:
- El valor
2, que indica que le siguen dos filas de encabezado.
- Un encabezado de nombres que contiene el valor
number_of_columns + 1, la cadena name y el nombre de cada columna.
- Un encabezado de tipos que contiene el valor
number_of_columns + 1, la cadena type y el nombre de cada tipo de datos de ClickHouse.
Los envoltorios LowCardinality se eliminan de estos nombres de tipo.
- Las filas de datos. Cada fila contiene un valor serializado como texto, con prefijo de longitud, para cada columna del resultado. Las filas de datos no
incluyen su propio recuento de filas ni de columnas, y el flujo termina en
EOF.
Un valor NULL se codifica con la longitud -1; una cadena vacía no nula tiene una longitud de 0. Los totales, cuando están presentes, usan la
misma codificación de filas y siguen a las filas ordinarias.
La siguiente consulta representa los valores que abarcan las pruebas del formato:
Como el resultado es binario, redirígelo a un archivo en lugar de mostrarlo en la terminal:
En condiciones normales, el controlador añade default_format=ODBCDriver2 a sus solicitudes HTTP y decodifica la respuesta.
ODBCDriver2 utiliza la configuración estándar de serialización de texto para valores individuales. No tiene ninguna configuración específica del formato en sí. Última modificación el 14 de agosto de 2026
