Controladores ODBC e JDBC para o BigQuery

Introdução

Para permitir que os utilizadores tirem partido das capacidades do BigQuery e do GoogleSQL, a Google colabora com a Simba para fornecer controladores Java Database Connectivity (JDBC) e Open Database Connectivity (ODBC) dedicados.

Os controladores JDBC e ODBC permitem-lhe usar o BigQuery com as ferramentas e a infraestrutura da sua preferência. Estes controladores permitem-lhe aceder a funcionalidades do BigQuery, como a integração de armazenamento de alto desempenho e a gestão de reservas, que, de outra forma, só estão disponíveis através das APIs BigQuery. Estes controladores especializados foram concebidos especificamente para o BigQuery e não podem ser usados com outros produtos ou serviços. Não precisa de licenças adicionais para usar estes controladores.

Controladores ODBC atuais

Os seguintes controladores são os lançamentos estáveis mais recentes do controlador ODBC.

Versão 3.1.4.1020 do ODBC

Versão 2.5.2.1004 do ODBC

Recomendamos que atualize para a versão 3.x. A versão 2.5.x é suportada para correções de erros e atualizações de segurança críticas, mas as novas funcionalidades do BigQuery só são adicionadas à versão 3.x.

Controladores JDBC atuais

Os seguintes controladores são os lançamentos estáveis mais recentes do controlador JDBC.

Versão 1.6.3.1004 do JDBC

Autorizações necessárias para a HTAPI ODBC

A API de elevado débito (HTAPI) é uma API opcional para ODBC. Para mais informações sobre a HTAPI, consulte o guia de instalação e configuração.

Para obter as autorizações de que precisa para usar a API de elevado débito, peça ao seu administrador para lhe conceder a função Utilizador da sessão de leitura do BigQuery (roles/bigquery.readSessionUser) do IAM no seu projeto do BigQuery. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Esta função predefinida contém as autorizações necessárias para usar a API de elevado débito. Para ver as autorizações exatas que são necessárias, expanda a secção Autorizações necessárias:

Autorizações necessárias

São necessárias as seguintes autorizações para usar a API de elevado débito:

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

Também pode conseguir estas autorizações com funções personalizadas ou outras funções predefinidas.

Limitações

  • Os controladores JDBC e ODBC não suportam as funcionalidades de carregamento de alto desempenho nem de exportação do BigQuery. Para JDBC, o limite de resultados por página é de 10 000. Este limite é configurável. Pode fazer inserções de dados com declarações da linguagem de manipulação de dados (DML), mas estas declarações estão sujeitas aos limites das declarações da DML.
  • Os controladores JDBC e ODBC não suportam os tipos de dados ARRAY e STRUCT do GoogleSQL. Se for pedida a saída destes tipos de dados aos controladores, os controladores renderizam os tipos de dados num formato JSON. Para evitar a saída JSON, considere reduzir os valores repetidos ou selecionar campos específicos de um registo.
  • Os controladores JDBC e ODBC não suportam prefixos de consultas.
  • Os controladores JDBC e ODBC suportam consultas parametrizadas, mas a preparação de uma consulta com parâmetros apenas fornece a validação da consulta. As consultas parametrizadas com os controladores JDBC e ODBC não afetam o desempenho das consultas.

Apoio técnico

O apoio técnico para os controladores JDBC e ODBC está disponível através do Cloud Customer Care.

Preços

Os controladores estão disponíveis para transferência sem custo financeiro. No entanto, os custos de execução de consultas através dos controladores variam consoante a sua configuração:

  • A consulta de preços aplica-se por predefinição a todas as consultas do condutor. Este é o único modelo de preços usado, a menos que o controlador esteja configurado para suportar grandes conjuntos de resultados.
  • A determinação de preços de armazenamento aplica-se além da determinação de preços de consultas quando o controlador está configurado para escrever grandes conjuntos de resultados numa tabela de destino. Estes dados são armazenados durante 24 horas e incorre em custos de armazenamento durante esse período.
  • Os preços da API Storage aplicam-se apenas quando usa o controlador para invocar a API Storage. Este modelo de preços abrange os dados lidos diretamente dos resultados da consulta e não os dados analisados durante a execução da consulta. É importante ter em atenção que os preços da API Storage só se aplicam a grandes conjuntos de resultados.