Utiliser le pilote ODBC pour BigQuery

Le pilote Open Database Connectivity (ODBC) pour BigQuery connecte vos applications non Java à BigQuery, ce qui vous permet d'utiliser les fonctionnalités de BigQuery avec vos outils et votre infrastructure préférés. Pour connecter des applications Java à BigQuery, utilisez le pilote JDBC pour BigQuery.

Le pilote ODBC pour BigQuery est disponible sous la licence Apache 2.0.

Avant de commencer

1. Assurez-vous de bien maîtriser les pilotes ODBC et les gestionnaires de pilotes.

2. Assurez-vous que votre système d'exploitation répond aux exigences suivantes :

   Système d'exploitation	Architectures compatibles	Version minimale et dépendances
   Windows	32 bits (x86), 64 bits (x64)	Version : Windows 10, Windows Server 2016 ou version ultérieure Dépendance : Microsoft Visual C++ Redistributable pour Visual Studio 2019 ou 2022
   macOS	64 bits (x86_64), ARM64 (Apple Silicon)	Version : macOS 12 (Monterey) ou version ultérieure Dépendance : un gestionnaire de pilotes ODBC (par exemple, unixODBC). Assurez-vous d'ajouter le répertoire d'installation à votre DYLD_LIBRARY_PATH.
   Linux	64 bits (x86_64)	Version : toute distribution avec glibc 2.27 ou version ultérieure (par exemple, Ubuntu 20.04 LTS+, Debian 11+) Dépendance : un gestionnaire de pilotes ODBC (par exemple, unixODBC). Assurez-vous d'ajouter le répertoire d'installation à votre LD_LIBRARY_PATH.

3. Authentifiez-vous auprès de BigQuery et notez les informations suivantes, qui seront utilisées ultérieurement lorsque vous établirez une connexion avec le pilote ODBC pour BigQuery. Vous n'avez besoin de noter que les informations correspondant à la méthode d'authentification que vous utilisez.

   Méthode d'authentification	Informations d'authentification	Exemple	Propriété de connexion (à définir ultérieurement)
   Compte de service standard	Clé de compte de service (objet JSON)	my-sa-key	KeyFilePath
   Fédération d'identité de charge de travail ou fédération des identités des employés	Propriété "audience" du fichier de configuration du compte externe	//iam.googleapis.com/locations/global/...	BYOID_AudienceUrl
   	Fichier d'informations sur l'environnement et récupération du jeton	{"file":"/path/to/file"}	BYOID_CredentialSource
   	Projet utilisateur (uniquement pour le pool d'employés)	my_project	BYOID_PoolUserProject
   	Type de jeton STS	id_token	BYOID_SubjectTokenType
   	Point de terminaison d'échange de jetons STS	https://sts.googleapis.com/v1/token	BYOID_TokenUrl
   Identifiants par défaut de l'application	Aucun	N/A	N/A

Installer et configurer le pilote ODBC

Vous pouvez installer et configurer le pilote ODBC pour BigQuery à l'aide d'un système d'exploitation Windows ou non.

Établir une connexion

Pour établir une connexion entre votre application et BigQuery avec le pilote ODBC pour BigQuery, identifiez votre chaîne de connexion. Vous pouvez ignorer cette étape si vous avez déjà configuré les propriétés de connexion via votre DSN.

La chaîne de connexion se présente au format suivant :

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

Remplacez les éléments suivants :

• PROJECT_ID : ID de votre projet BigQuery.
• AUTH_TYPE : nombre spécifiant le type d'authentification que vous avez utilisé. Sélectionnez l'une des options suivantes :
  • 0 : pour l'authentification du compte de service
  • 3 : pour l'authentification avec les identifiants par défaut de l'application
  • 4 : pour l'authentification par fédération d'identité de charge de travail ou fédération des identités des employés
• AUTH_PROPS : informations d'authentification que vous avez notées lorsque vous vous êtes authentifié auprès de BigQuery, listées au format property_1=value_1; property_2=value_2;..., par exemple KeyFilePath=my-sa-key si vous vous êtes authentifié avec un compte de service.
• OTHER_PROPS (facultatif) : propriétés de connexion supplémentaires pour le pilote ODBC, listées au format property_1=value_1; property_2=value_2;.... Pour obtenir la liste complète des propriétés de connexion, consultez Propriétés de connexion.

Propriétés de connexion

Les propriétés de connexion du pilote ODBC sont des paramètres de configuration que vous incluez dans la chaîne de connexion lorsque vous établissez une connexion à une base de données. Le pilote ODBC pour BigQuery est compatible avec les propriétés de connexion suivantes.

Mappage des types de données

Lorsque vous exécutez des requêtes via le pilote ODBC pour BigQuery, le mappage des types de données suivant se produit :

Exemples

Les exemples suivants montrent comment utiliser des requêtes paramétrées et des scripts à plusieurs instructions avec le pilote ODBC.

Requêtes paramétrées

// 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 à plusieurs instructions

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

Tarifs

Vous pouvez télécharger sans frais le pilote ODBC pour BigQuery. Toutefois, lorsque vous utilisez le pilote, les tarifs standards d'analyse BigQuery s'appliquent.

Étapes suivantes

• En savoir plus sur le pilote JDBC pour BigQuery
• Découvrez d'autres outils pour les développeurs BigQuery.