Controladores ODBC y JDBC para BigQuery

Introducción

Para permitir que los usuarios aprovechen las capacidades de BigQuery y GoogleSQL, Google se asoció con Simba para proporcionar controladores dedicados de conectividad a bases de datos de Java (JDBC) y conectividad a bases de datos abiertas (ODBC).

Los controladores JDBC y ODBC te permiten usar BigQuery con la infraestructura y las herramientas que prefieras. Estos controladores te permiten acceder a funciones de BigQuery, como la integración de almacenamiento de alto rendimiento y la administración de reservas, que de otro modo solo están disponibles a través de las APIs de BigQuery. Estos controladores especializados están diseñados específicamente para BigQuery y no se pueden usar con otros productos o servicios. No necesitas licencias adicionales para usar estos controladores.

Controladores ODBC actuales

Los siguientes controladores son las versiones estables más recientes del controlador ODBC.

ODBC versión 3.0.5.1011

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)
• Notas de la versión
• Guía de instalación y configuración

ODBC versión 2.5.2.1004

Le recomendamos que actualice a la versión 3.x. La versión 2.5.x es compatible con correcciones de errores y actualizaciones de seguridad críticas, pero las nuevas funciones de BigQuery solo se agregan a la versión 3.x.

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)
• Notas de la versión
• Guía de instalación y configuración

Precaución: Para cumplir con la baja de Google del flujo de autorización fuera de banda (OOB), la versión 2.5.2 y versiones posteriores de ODBC presentan cambios que pueden requerir que vuelvas a autenticarte o a crear tus cadenas de conexión. Esto se debe a que cambió el flujo de la cuenta de usuario y ya no es compatible con el flujo fuera de banda obsoleto. El diálogo de conexión ahora recupera automáticamente un token de actualización, lo que elimina la necesidad de copiar y pegar de forma manual el código de confirmación. La secuencia de comandos del token de actualización de Linux y Mac se actualizó a Python. Consulta la guía de instalación y configuración para obtener más detalles.

Versiones anteriores de ODBC

3.0.4.1008

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

3.0.3.1006

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

3.0.2.1005

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

3.0.0.1001

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.5.0.1001

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.4.6.1015

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.4.5.1014

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.4.3.1012

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.4.1.1009

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.4.0.1002

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.3.5.1009

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.3.3.1005

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

2.3.2.1003

• Windows de 32 bits (msi)
• Windows de 64 bits (msi)
• Linux de 32 bits y 64 bits (tar.gz)
• macOS (dmg)

Controladores de JDBC actuales

Los siguientes controladores son las versiones estables más recientes del controlador JDBC.

JDBC release 1.6.1.1002

• JDBC compatible con la versión 4.2
• Notas de la versión
• Guía de instalación y configuración

Precaución: Para cumplir con la baja de Google del flujo de autorización fuera de banda (OOB), la versión 1.3.2 de JDBC presenta cambios que pueden requerir que vuelvas a autenticarte o a crear tus cadenas de conexión. Esto se debe a que cambió el flujo de la cuenta de usuario y ya no es compatible con el flujo fuera de banda obsoleto. Consulta la guía de instalación y configuración para obtener más detalles.

Versiones anteriores de JDBC

1.5.4.1008

• JDBC compatible con la versión 4.2

1.5.0.1001

• JDBC compatible con la versión 4.2

1.3.3.1004

• JDBC compatible con la versión 4.2

1.3.2.1003

• JDBC compatible con la versión 4.2

1.3.0.1001

• JDBC compatible con la versión 4.2

1.2.25.1029

• JDBC compatible con la versión 4.2

1.2.23.1027

• JDBC compatible con la versión 4.2

1.2.22.1026

• JDBC compatible con la versión 4.2

1.2.21.1025

• JDBC compatible con la versión 4.2

1.2.19.1023

• JDBC compatible con la versión 4.2

1.2.18.1022

• JDBC compatible con la versión 4.2

1.2.16.1020

• JDBC compatible con la versión 4.2

1.2.14.1017

• JDBC compatible con la versión 4.2

1.2.1.1001

• JDBC compatible con la versión 4.2
• JDBC compatible con la versión 4.1

Permisos necesarios para la HTAPI de ODBC

La API de alta capacidad de procesamiento (HTAPI) es una API opcional para ODBC. Para obtener más información sobre HTAPI, consulta la guía de instalación y configuración.

Para obtener los permisos que necesitas para usar la API de High-Throughput, pídele a tu administrador que te otorgue el rol de IAM de Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser) en tu proyecto de BigQuery. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para usar la API de alta capacidad de procesamiento. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para usar la API de alta capacidad de procesamiento:

• resourcemanager.projects.get
• resourcemanager.projects.list
• bigquery.readsessions.create
• bigquery.readsessions.getData
• bigquery.readsessions.update

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Limitaciones

• Los controladores JDBC y ODBC no admiten la carga de alto rendimiento ni las funciones de exportación de BigQuery. Puedes realizar inserciones de datos con sentencias del lenguaje de manipulación de datos (DML), pero estas están sujetas a los límites de las sentencias DML.
• Los controladores JDBC y ODBC no son compatibles con los tipos de datos ARRAY y STRUCT de GoogleSQL. Si se solicita el resultado de estos tipos de datos a los controladores, estos renderizan los tipos de datos en un formato JSON. Para evitar el resultado JSON, considera aplanar los valores repetidos o seleccionar campos específicos de un registro.
• Los controladores JDBC y ODBC no admiten prefijos de consulta.
• Los controladores de JDBC y ODBC admiten consultas parametrizadas, pero preparar una consulta con parámetros solo proporciona validación de la consulta. Las consultas parametrizadas con los controladores JDBC y ODBC no afectan el rendimiento de las consultas.

Asistencia

La asistencia para los controladores de JDBC y ODBC está disponible en Atención al cliente de Cloud.

Precios

Los controladores se pueden descargar sin costo. Sin embargo, los costos de ejecutar consultas con los controladores varían según tu configuración:

• Los precios de consulta se aplican de forma predeterminada a todas las consultas del controlador. Este es el único modelo de precios que se usa, a menos que el controlador esté configurado para admitir conjuntos de resultados grandes.
• Los precios de almacenamiento se aplican, además de los precios de consulta, si el controlador se configuró para escribir conjuntos de resultados grandes en una tabla de destino. Estos datos se almacenan durante 24 horas y se generan cargos de almacenamiento durante ese período.
• Los precios de la API de Storage se aplican solo cuando usas el controlador para invocar la API de Storage. Este modelo de precios abarca los datos leídos directamente de los resultados de la consulta, no los datos analizados durante la ejecución de la consulta. Es importante tener en cuenta que los precios de la API de Storage solo se aplican a los conjuntos de resultados grandes.