Usa el controlador ODBC para BigQuery

El controlador de conectividad abierta de bases de datos (ODBC) para BigQuery conecta tus aplicaciones que no son de Java a BigQuery, lo que te permite usar las funciones de BigQuery con la infraestructura y las herramientas que prefieras. Para conectar aplicaciones Java a BigQuery, usa el controlador JDBC para BigQuery.

El controlador ODBC para BigQuery está disponible bajo la licencia Apache 2.0.

Antes de comenzar

1. Asegúrate de conocer los controladores ODBC y los administradores de controladores.

2. Asegúrate de que tu sistema operativo cumpla con los siguientes requisitos:

   Sistema operativo	Arquitecturas admitidas	Versión y dependencias mínimas
   Windows	32 bits (x86) y 64 bits (x64)	Versión: Windows 10, Windows Server 2016 o posterior Dependencia: Microsoft Visual C++ Redistributable para Visual Studio 2019 o 2022
   macOS	64 bits (x86_64), ARM64 (Apple Silicon)	Versión: macOS 12 (Monterey) o posterior Dependencia: Un administrador de controladores ODBC (por ejemplo, unixODBC). Asegúrate de agregar el directorio de instalación a tu DYLD_LIBRARY_PATH.
   Linux	64 bits (x86_64)	Versión: Cualquier distribución con glibc 2.27 o posterior (por ejemplo, Ubuntu 20.04 LTS+, Debian 11+) Dependencia: Un administrador de controladores ODBC (por ejemplo, unixODBC). Asegúrate de agregar el directorio de instalación a tu LD_LIBRARY_PATH.

3. Autentícate en BigQuery y toma nota de la siguiente información, que se usará más adelante cuando establezcas una conexión con el controlador ODBC para BigQuery. Solo debes anotar la información que corresponde al método de autenticación que usas.

   Método de autenticación	Información de autenticación	Ejemplo	Propiedad de conexión (para configurar más adelante)
   Cuenta de servicio estándar	Clave de la cuenta de servicio (objeto JSON)	my-sa-key.json	KeyFilePath
   Identidad temporal como cuenta de servicio	Dirección de correo electrónico de la cuenta de servicio de destino	service-account@project.s3ns.iam.gserviceaccount.com	ServiceAccountImpersonationEmail, KeyFilePath
   Federación de identidades para cargas de trabajo o federación de identidades de personal	Propiedad de público del archivo de configuración de la cuenta externa	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	Recuperación de tokens y archivo de información del entorno	{"file":"/path/to/file"}	BYOID_CredentialSource
   	Proyecto del usuario (solo para el grupo de personal)	my_project	BYOID_PoolUserProject
   	Tipo de token de STS	id_token	BYOID_SubjectTokenType
   	Extremo de intercambio de tokens de STS	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   Credencial predeterminada de la aplicación	Ninguno	N/A	N/A

Instala y configura el controlador ODBC

Puedes instalar y configurar el controlador ODBC para BigQuery con un sistema operativo Windows o que no sea de Windows.

Establece la conexión

Para establecer una conexión entre tu aplicación y BigQuery con el controlador ODBC para BigQuery, identifica tu cadena de conexión. Puedes omitir este paso si ya configuraste las propiedades de conexión a través de tu DSN.

La cadena de conexión tiene el siguiente formato:

Driver=ODBC Driver for BigQuery;Catalog=PROJECT_ID;OAuthMechanism=AUTH_TYPE;AUTH_PROPS;OTHER_PROPS

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID de tu proyecto de BigQuery.
• AUTH_TYPE: Es un número que especifica el tipo de autenticación que usaste. Selecciona una de las siguientes opciones:
  • 0: Para la autenticación de la cuenta de servicio
  • 3: Para la autenticación con credenciales predeterminadas de la aplicación
  • 4: Para la autenticación de la federación de identidades para cargas de trabajo o la federación de identidades de personal
• AUTH_PROPS: La información de autenticación que anotaste cuando te autenticaste en BigQuery, que se muestra en el formato property_1=value_1; property_2=value_2;..., por ejemplo, KeyFilePath=my-sa-key.json, si te autenticaste con una cuenta de servicio.
• OTHER_PROPS (opcional): Propiedades de conexión adicionales para el controlador ODBC, que se indican en el formato property_1=value_1; property_2=value_2;.... Para obtener una lista completa de las propiedades de conexión, consulta Propiedades de conexión.

Propiedades de la conexión

Las propiedades de conexión del controlador ODBC son parámetros de configuración que se incluyen en la cadena de conexión cuando estableces una conexión a una base de datos. El controlador ODBC para BigQuery admite las siguientes propiedades de conexión.

Asignación de tipos de datos

Cuando ejecutas consultas a través del controlador ODBC para BigQuery, se produce la siguiente asignación de tipos de datos:

Configuración de registros y controladores

Para configurar opciones en todo el controlador (como el registro y la codificación de caracteres), haz lo siguiente:

Niveles de registro del controlador

El controlador admite niveles de registro del 0 al 3. Te recomendamos que comiences con LogLevel=3 (INFO) para solucionar problemas.

Propiedades de configuración de todo el controlador (no para Windows)

Las siguientes propiedades se pueden configurar en la sección [Driver] de googlebigqueryodbc.ini:

Ejemplos

En los siguientes ejemplos, se muestra cómo usar consultas con parámetros y secuencias de comandos de varias instrucciones con el controlador ODBC.

Consultas con parámetros

// 1. Prepare statement
std::string insert_stmt = "INSERT INTO MyTable VALUES (?, ?, ?)";
status = SQLPrepare(hstmt, (SQLCHAR*)insert_stmt.c_str(), SQL_NTS);

// 2. Bind parameters
std::string str_val = "example_string";
long long int_val = 12345;
double float_val = 1.2345;

// Bind string field
status = SQLBindParameter(
    hstmt, 1, SQL_PARAM_INPUT, SQL_C_CHAR, SQL_VARCHAR, 50, 0,
    (SQLPOINTER)str_val.c_str(), str_val.size(), NULL);

// Bind integer field
status = SQLBindParameter(
    hstmt, 2, SQL_PARAM_INPUT, SQL_C_UBIGINT, SQL_BIGINT, 0, 0,
    &int_val, 0, NULL);

// Bind float field
status = SQLBindParameter(
    hstmt, 3, SQL_PARAM_INPUT, SQL_C_DOUBLE, SQL_DOUBLE, 0, 0,
    &float_val, 0, NULL);

// 3. Execute statement
status = SQLExecute(hstmt);

Secuencias de comandos de varias instrucciones

// 1. Prepare and execute the multi-statement script
std::string query =
    "CREATE OR REPLACE TABLE MyTable (StringField STRING, IntegerField INTEGER); "
    "INSERT INTO MyTable VALUES ('example', 123); "
    "SELECT * FROM MyTable;";

status = SQLExecDirect(hstmt, (SQLCHAR*)query.c_str(), SQL_NTS);

// 2. Process results for each statement using SQLMoreResults
do {
    SQLSMALLINT num_cols;
    status = SQLNumResultCols(hstmt, &num_cols);

    if (num_cols > 0) {
        // This is a result-returning statement (e.g., SELECT)
        while (SQLFetch(hstmt) == SQL_SUCCESS) {
            // Process rows...
        }
    } else {
        // This is a non-result statement (e.g., CREATE, INSERT)
        SQLLEN row_count;
        SQLRowCount(hstmt, &row_count);
        // Process affected rows...
    }
} while (SQLMoreResults(hstmt) == SQL_SUCCESS);

Precios

Puedes descargar el controlador ODBC para BigQuery sin costo. Sin embargo, cuando usas el controlador, se aplican los precios estándar de análisis de BigQuery.

¿Qué sigue?

• Obtén más información sobre el controlador JDBC para BigQuery.
• Explora otras herramientas para desarrolladores de BigQuery.