Controladores ODBC y JDBC para BigQuery

Introducción

Para que los usuarios puedan aprovechar las funciones de BigQuery y GoogleSQL, Google colabora con Simba para proporcionar controladores específicos de Java Database Connectivity (JDBC) y Open Database Connectivity (ODBC).

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

Controladores ODBC actuales

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

Versión 3.1.4.1020 de ODBC

Versión 2.5.2.1004 de ODBC

Te recomendamos que actualices a la versión 3.x. La versión 2.5.x se admite para correcciones de errores y actualizaciones de seguridad críticas, pero las nuevas funciones de BigQuery solo se añadirán a la versión 3.x.

Controladores JDBC actuales

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

Versión 1.6.3.1004 de JDBC

Permisos necesarios para la API HTAPI de ODBC

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

Para obtener los permisos que necesitas para usar la API de alto rendimiento, pide a tu administrador que te asigne el rol de gestión de identidades y accesos Usuario con acceso a sesiones de lectura de BigQuery (roles/bigquery.readSessionUser) en tu proyecto de BigQuery. Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para usar la API de alto rendimiento. Para ver los permisos exactos que se necesitan, despliega la sección Permisos necesarios:

Permisos obligatorios

Para usar la API de alto rendimiento, se necesitan los siguientes permisos:

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

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

Limitaciones

  • Los controladores JDBC y ODBC no admiten las funciones de carga de alto rendimiento ni de exportación de BigQuery. En el caso de JDBC, el límite de resultados por página es de 10.000. Este límite se puede configurar. Puedes insertar datos con declaraciones del lenguaje de manipulación de datos (DML), pero estas declaraciones están sujetas a los límites de las declaraciones de DML.
  • Los controladores JDBC y ODBC no admiten los tipos de datos ARRAY y STRUCT de GoogleSQL. Si los controladores solicitan la salida de estos tipos de datos, los controladores renderizan los tipos de datos en formato JSON. Para evitar que se produzca una salida JSON, considera la posibilidad de acoplar los valores repetidos o seleccionar campos específicos de un registro.
  • Los controladores JDBC y ODBC no admiten prefijos de consulta.
  • Los controladores JDBC y ODBC admiten consultas parametrizadas, pero preparar una consulta con parámetros solo proporciona la validación de la consulta. Las consultas parametrizadas con los controladores JDBC y ODBC no afectan al rendimiento de las consultas.

Asistencia

La asistencia para los controladores JDBC y ODBC está disponible en Cloud Customer Care.

Precios

Los controladores se pueden descargar sin coste económico. Sin embargo, los costes de ejecutar consultas con los controladores varían en función de tu configuración:

  • Los precios de las consultas 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 de gran tamaño.
  • Los precios del almacenamiento se aplican además de los precios de las consultas cuando el controlador está configurado para escribir grandes conjuntos de resultados en una tabla de destino. Estos datos se almacenan durante 24 horas y se te cobrará por el almacenamiento durante ese periodo.
  • Los precios de la API Storage solo se aplican cuando usas el controlador para invocar la API Storage. Este modelo de precios cubre los datos leídos directamente de los resultados de las consultas, no los datos analizados durante la ejecución de las consultas. Es importante tener en cuenta que los precios de la API Storage solo se aplican a los conjuntos de resultados de gran tamaño.