Drivers ODBC e JDBC para BigQuery

Introdução

Para que os usuários possam aproveitar os recursos do BigQuery e do GoogleSQL, o Google fez uma parceria com a Simba para oferecer drivers dedicados de conectividade de banco de dados Java (JDBC) e de conectividade de banco de dados aberto (ODBC).

Os drivers JDBC e ODBC permitem usar o BigQuery com suas ferramentas e infraestruturas preferidas. Esses drivers permitem acessar recursos do BigQuery, como integração de armazenamento de alto desempenho e gerenciamento de reservas, que só estão disponíveis nas APIs do BigQuery. Esses drivers especializados foram criados especificamente para o BigQuery e não podem ser usados com outros produtos ou serviços. Não é necessário ter licenças adicionais para usar esses drivers.

Drivers ODBC atuais

Os drivers a seguir são as versões estáveis mais recentes do driver ODBC.

ODBC versão 3.0.7.1016

• Windows 32 bits (msi)
• Windows 64 bits (msi)
• Linux 32 bits e 64 bits (tar.gz)
• macOS (dmg)
• Notas de lançamento
• Guia de instalação e configuração

ODBC versão 2.5.2.1004

Recomendamos que você faça upgrade para a versão 3.x. A versão 2.5.x tem suporte para correções de bugs e atualizações de segurança essenciais, mas novos recursos do BigQuery só serão adicionados à versão 3.x.

• Windows 32 bits (msi)
• Windows 64 bits (msi)
• Linux 32 bits e 64 bits (tar.gz)
• macOS (dmg)
• Notas de lançamento
• Guia de instalação e configuração

Atenção:para obedecer à descontinuação do fluxo de autorização fora de banda (OOB) do Google, o ODBC versão 2.5.2 e posteriores apresenta mudanças que podem exigir que você refaca sua autenticação e/ou recrie suas strings de conexão. Isso ocorre porque o fluxo da conta de usuário mudou e não é mais compatível com o fluxo fora de banda descontinuado. A caixa de diálogo de conexão agora recupera automaticamente um token de atualização, eliminando a necessidade de copiar e colar manualmente o código de confirmação. O script do token de atualização do Linux e do Mac foi atualizado para Python. Consulte o guia de instalação e configuração para mais detalhes.

Versões ODBC anteriores

3.0.5.1011

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

3.0.4.1008

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

3.0.3.1006

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

3.0.2.1005

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

3.0.0.1001

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

2.5.0.1001

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

2.4.6.1015

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

2.4.5.1014

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

2.4.3.1012

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

2.4.1.1009

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

2.4.0.1002

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

2.3.5.1009

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

2.3.3.1005

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

2.3.2.1003

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

Drivers JDBC atuais

Os drivers a seguir são as versões estáveis mais recentes do driver JDBC.

JDBC versão 1.6.1.1002

• Compatível com JDBC 4.2
• Notas de lançamento
• Guia de instalação e configuração

Atenção:para obedecer à descontinuação do fluxo de autorização fora de banda (OOB), o JDBC versão 1.3.2 apresenta mudanças que podem exigir que você refaça sua autenticação e/ou recrie suas strings de conexão. Isso ocorre porque o fluxo da conta de usuário mudou e não é mais compatível com o fluxo fora de banda descontinuado. Consulte o guia de instalação e configuração para mais detalhes.

Versões JDBC anteriores

1.5.4.1008

• Compatível com JDBC 4.2

1.5.0.1001

• Compatível com JDBC 4.2

1.3.3.1004

• Compatível com JDBC 4.2

1.3.2.1003

• Compatível com JDBC 4.2

1.3.0.1001

• Compatível com JDBC 4.2

1.2.25.1029

• Compatível com JDBC 4.2

1.2.23.1027

• Compatível com JDBC 4.2

1.2.22.1026

• Compatível com JDBC 4.2

1.2.21.1025

• Compatível com JDBC 4.2

1.2.19.1023

• Compatível com JDBC 4.2

1.2.18.1022

• Compatível com JDBC 4.2

1.2.16.1020

• Compatível com JDBC 4.2

1.2.14.1017

• Compatível com JDBC 4.2

1.2.1.1001

• Compatível com JDBC 4.2
• Compatível com JDBC 4.1

Permissões necessárias para a ODBC HTAPI

A API de alta capacidade (HTAPI, na sigla em inglês) é opcional para ODBC. Para mais informações sobre a HTAPI, consulte o Guia de instalação e configuração.

Para receber as permissões necessárias para usar a API de alta taxa de transferência, peça ao administrador para conceder a você o papel do IAM de Usuário de sessão de leitura do BigQuery (roles/bigquery.readSessionUser) no projeto do BigQuery. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para usar a API de alta taxa de transferência. Para conferir as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para usar a API de alta taxa de transferência:

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

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Limitações

• Os drivers JDBC e ODBC não oferecem suporte ao carregamento de alto desempenho ou aos recursos de exportação do BigQuery. É possível realizar inserções de dados com instruções de linguagem de manipulação de dados (DML), mas elas estão sujeitas aos limites de instruções DML.
• Os drivers JDBC e ODBC não são compatíveis com os tipos de dados ARRAY e STRUCT do GoogleSQL. Se a saída desses tipos de dados for solicitada pelos drivers, eles renderizarão os tipos de dados em um formato JSON. Para evitar a saída de JSON, considere nivelar valores repetidos ou selecionar campos específicos de um registro.
• Os drivers JDBC e ODBC não são compatíveis com prefixos de consulta.
• Os drivers JDBC e ODBC são compatíveis com consultas parametrizadas, mas preparar uma consulta com parâmetros fornece apenas a validação da consulta. As consultas parametrizadas com os drivers JDBC e ODBC não afetam o desempenho da consulta.

Suporte

O suporte para os drivers JDBC e ODBC está disponível no Cloud Customer Care.

Preços

Os drivers estão disponíveis para download sem nenhum custo. No entanto, os custos para executar consultas usando os drivers variam de acordo com a configuração:

• O preço da consulta se aplica por padrão a todas as consultas do driver. Esse é o único modelo de precificação usado, a menos que o driver esteja configurado para oferecer suporte a grandes conjuntos de resultados.
• O preço de armazenamento se aplica além do preço da consulta quando o driver está configurado para gravar grandes conjuntos de resultados em uma tabela de destino. Esses dados são armazenados por 24 horas, e você incorre em cobranças de armazenamento durante esse período.
• O preço da API Storage se aplica apenas quando você usa o driver para invocar a API Storage. Esse modelo de preços abrange os dados lidos diretamente dos resultados da consulta, não os dados verificados durante a execução da consulta. É importante observar que o preço da API Storage se aplica apenas a grandes conjuntos de resultados.