Pilotes ODBC et JDBC pour BigQuery

Présentation

Pour permettre aux utilisateurs d'exploiter les fonctionnalités de BigQuery et de GoogleSQL, les partenaires Google s'associent à Simba afin de fournir des pilotes JDBC (Java Database Connectivity) et ODBC (Open Database Connectivity) dédiés.

Les pilotes JDBC et ODBC vous permettent d'utiliser BigQuery avec vos outils et votre infrastructure préférés. Ces pilotes vous permettent d'accéder aux fonctionnalités de BigQuery telles que l'intégration du stockage hautes performances et la gestion des réservations, qui ne sont disponibles que via les API BigQuery. Ces pilotes spécialisés sont conçus spécifiquement pour BigQuery et ne peuvent pas être utilisés avec d'autres produits ou services. Vous n'avez besoin d'aucune licence supplémentaire pour les utiliser.

Pilotes ODBC actuels

Les pilotes suivants correspondent aux dernières versions stables du pilote ODBC.

ODBC version 3.0.7.1016

ODBC version 2.5.2.1004

Nous vous recommandons de passer à la version 3.x. La version 2.5.x est compatible avec les corrections de bugs et les mises à jour de sécurité critiques, mais les nouvelles fonctionnalités de BigQuery ne sont ajoutées qu'à la version 3.x.

Pilotes JDBC actuels

Les pilotes suivants correspondent aux dernières versions stables du pilote JDBC.

JDBC version 1.6.1.1002

Autorisations requises pour l'API à haut débit ODBC

L'API à haut débit (HTAPI) est une API facultative pour ODBC. Pour en savoir plus sur HTAPI, consultez le guide d'installation et de configuration.

Pour obtenir les autorisations nécessaires pour utiliser l'API à haut débit, demandez à votre administrateur de vous accorder le rôle IAM Utilisateur de session de lecture BigQuery (roles/bigquery.readSessionUser) sur votre projet BigQuery. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient les autorisations requises pour utiliser l'API à haut débit. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :

Autorisations requises

Les autorisations suivantes sont requises pour utiliser l'API à haut débit :

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

Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.

Limites

  • Les pilotes JDBC et ODBC ne sont pas compatibles avec les fonctionnalités d'exportation ou de charge hautes performances de BigQuery. Vous pouvez effectuer des insertions de données avec des instructions du langage de manipulation de données (LMD), mais ces instructions sont soumises aux limites des instructions LMD.
  • Les pilotes JDBC et ODBC ne sont pas compatibles avec les types de données ARRAY et STRUCT de GoogleSQL. Si la sortie de ces types de données est demandée aux pilotes, ceux-ci affichent les types de données au format JSON. Pour éviter la sortie JSON, envisagez d'aplatir les valeurs répétées ou de sélectionner des champs spécifiques à partir d'un enregistrement.
  • Les pilotes JDBC et ODBC ne sont pas compatibles avec les préfixes de requête.
  • Les pilotes JDBC et ODBC acceptent les requêtes paramétrées, mais la préparation d'une requête avec des paramètres ne fournit que la validation de la requête. Les requêtes paramétrées avec les pilotes JDBC et ODBC n'ont pas d'incidence sur les performances des requêtes.

Assistance

La compatibilité avec les pilotes JDBC et ODBC est disponible auprès de Cloud Customer Care.

Tarifs

Les pilotes sont disponibles en téléchargement sans frais supplémentaires. Toutefois, les coûts d'exécution des requêtes à l'aide des pilotes varient en fonction de votre configuration :

  • Les tarifs des requêtes s'appliquent par défaut à toutes les requêtes issues du pilote. Il s'agit du seul modèle de tarification utilisé, sauf si le pilote est configuré pour accepter des ensembles de résultats volumineux.
  • Les tarifs de stockage s'ajoutent aux tarifs des requêtes lorsque le pilote est configuré pour écrire des ensembles de résultats volumineux dans une table de destination. Ces données sont stockées pendant 24 heures, et des frais de stockage s'appliquent pendant cette période.
  • Les tarifs de l'API Storage ne s'appliquent que lorsque vous utilisez un pilote pour appeler l'API Storage. Ce modèle de tarification couvre les données lues directement à partir des résultats de la requête, et non les données analysées lors de l'exécution de la requête. Notez que les tarifs de l'API Storage ne s'appliquent qu'aux ensembles de résultats volumineux.