Usar o driver ODBC para BigQuery

O driver Open Database Connectivity (ODBC) para BigQuery conecta seus aplicativos não Java ao BigQuery, permitindo que você use os recursos do BigQuery com suas ferramentas e infraestrutura preferidas. Para conectar aplicativos Java ao BigQuery, use o driver JDBC para BigQuery.

O driver ODBC para BigQuery está disponível sob a licença Apache 2.0.

Antes de começar

1. Familiarize-se com os drivers ODBC e os gerenciadores de drivers.

2. Verifique se o sistema operacional atende aos seguintes requisitos:

   Sistema operacional	Arquiteturas compatíveis	Versão mínima e dependências
   Windows	32 bits (x86), 64 bits (x64)	Versão: Windows 10, Windows Server 2016 ou posterior Dependência: Microsoft Visual C++ Redistribuível para Visual Studio 2019 ou 2022
   macOS	64 bits (x86_64), ARM64 (Apple Silicon)	Versão: macOS 12 (Monterey) ou mais recente Dependência: um gerenciador de drivers ODBC (por exemplo, unixODBC). Adicione o diretório de instalação ao seu DYLD_LIBRARY_PATH.
   Linux	64 bits (x86_64)	Versão: qualquer distribuição com glibc 2.27 ou mais recente (por exemplo, Ubuntu 20.04 LTS+, Debian 11+) Dependência: um gerenciador de drivers ODBC (por exemplo, unixODBC). Adicione o diretório de instalação ao seu LD_LIBRARY_PATH.

3. Autentique-se no BigQuery e anote as seguintes informações, que serão usadas mais tarde quando você estabelecer uma conexão com o driver ODBC para BigQuery. Você só precisa anotar as informações correspondentes ao método de autenticação que você usa.

   Método de autenticação	Informações de autenticação	Exemplo	Propriedade de conexão (para definir mais tarde)
   Conta de serviço padrão	Chave da conta de serviço (objeto JSON)	my-sa-key	KeyFilePath
   Federação de identidade da carga de trabalho ou federação de identidade de colaboradores	Propriedade de público-alvo do arquivo de configuração da conta externa	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	Recuperação de token e arquivo de informações ambientais	{"file":"/path/to/file"}	BYOID_CredentialSource
   	Projeto do usuário (somente para pool de força de trabalho)	my_project	BYOID_PoolUserProject
   	Tipo de token STS	id_token	BYOID_SubjectTokenType
   	Endpoint de troca de token do STS	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   Application Default Credentials	Nenhum	N/A	N/A

Instalar e configurar o driver ODBC

É possível instalar e configurar o driver ODBC para BigQuery usando um sistema operacional Windows ou não Windows.

Estabelecer uma conexão

Para estabelecer uma conexão entre seu aplicativo e o BigQuery com o driver ODBC para BigQuery, identifique sua string de conexão. Você pode pular esta etapa se já tiver configurado as propriedades de conexão pelo DSN.

A string de conexão tem o seguinte formato:

Driver=ODBC Driver for BigQuery;ProjectId=PROJECT_ID;OAuthType=AUTH_TYPE;AUTH_PROPS;OTHER_PROPS

Substitua:

• PROJECT_ID: o ID do seu projeto do BigQuery.
• AUTH_TYPE: um número que especifica o tipo de autenticação usado. Selecione uma destas opções:
  • 0: para autenticação de conta de serviço
  • 3: para autenticação de Application Default Credentials
  • 4: para autenticação da federação de identidade da carga de trabalho ou da federação de identidade de colaboradores
• AUTH_PROPS: as informações de autenticação que você anotou ao autenticar no BigQuery, listadas no formato property_1=value_1; property_2=value_2;.... Por exemplo, KeyFilePath=my-sa-key, se você fez a autenticação com uma conta de serviço.
• OTHER_PROPS (opcional): propriedades de conexão adicionais para o driver ODBC, listadas no formato property_1=value_1; property_2=value_2;.... Para uma lista completa de propriedades de conexão, consulte Propriedades de conexão.

Propriedades da conexão

As propriedades de conexão do driver ODBC são parâmetros de configuração incluídos na string de conexão ao estabelecer uma conexão com um banco de dados. O driver ODBC para BigQuery é compatível com as seguintes propriedades de conexão.

Mapeamento de tipo de dados

Quando você executa consultas pelo driver ODBC para BigQuery, ocorre o seguinte mapeamento de tipos de dados:

Exemplos

Os exemplos a seguir demonstram como usar consultas parametrizadas e scripts com várias instruções com o driver ODBC.

Consultas parametrizadas

// 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);

Scripts de várias instruções

// 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);

Preços

Você pode baixar o driver ODBC para BigQuery sem custos financeiros. No entanto, ao usar o driver, os preços padrão de análise do BigQuery são aplicados.

A seguir

• Saiba mais sobre o driver JDBC para BigQuery.
• Conheça outras ferramentas para desenvolvedores do BigQuery.