Driver ODBC di Google BigQuery

Abbiamo rilasciato un driver ODBC per Google BigQuery. Il driver ti consente di interrogare e aggiornare i dati di BigQuery in applicazioni diverse dalla console di Google BigQuery. Abbiamo pensato di condividere alcune delle cose che puoi fare in queste applicazioni di terze parti (ad esempio, Perl, PHP, Excel e Oracle).

Installazione del driver ODBC BigQuery

1. Installa e concede in licenza il driver ODBC di Google BigQuery sulla macchina in cui è installata l'applicazione client.

   Ad esempio, se desideri utilizzare i dati BigQuery in Excel, installa il driver ODBC BigQuery sul computer in cui è installato Excel.

   Per fare ciò, esegui la distribuzione del file e segui le istruzioni sullo schermo.

   Il programma di installazione avvia Easysoft License Manager, perché non è possibile utilizzare il driver ODBC BigQuery finché non viene ottenuta una licenza.

   Sono disponibili i seguenti tipi di licenza:

   • Licenza di prova gratuita a tempo limitato che ti offre l'uso gratuito e illimitato del prodotto per un periodo limitato (di solito 14 giorni).
   • Licenza completa se hai acquistato il prodotto. All'acquisto del prodotto ti viene fornito un codice di autorizzazione, che utilizzi per ottenere una licenza
2. In Easysoft License Manager, inserisci i tuoi dati.

   DEVI inserire i campi Nome, Indirizzo E-Mail e Azienda.

   L'indirizzo e-mail DEVE essere lo stesso utilizzato per la registrazione e il download dal sito Web di Easysoft, altrimenti non sarà possibile ottenere le licenze di prova.

3. Scegli Richiedi licenza.

   Ti viene chiesto un tipo di licenza.

4. Esegui una delle seguenti operazioni:
   • Per una licenza di prova, fare clic su Prova a tempo limitato e quindi su Avanti.

     Il License Manager chiede quale software stai concedendo in licenza. Selezionare Easysoft BigQuery ODBC Driver dall'elenco a discesa e quindi fare clic su Avanti.

   • Se hai ottenuto un codice di autorizzazione per una licenza acquistata, seleziona Licenza non in scadenza e quindi fai clic su Avanti.

     Il gestore delle licenze richiede il tuo codice di autorizzazione.

     Immettere il codice di autorizzazione e quindi fare clic su Avanti.

5. Il Gestore delle licenze mostra un riepilogo delle informazioni che hai inserito e ti consente di scegliere il metodo per richiedere la tua licenza.
6. Esegui una delle seguenti operazioni:
   • Scegli Richiesta in linea se la tua macchina è connessa a Internet e può effettuare connessioni in uscita alla porta 8884.

     Il License Manager invia quindi una richiesta al server delle licenze Easysoft per attivare automaticamente la chiave di licenza. Questo è il metodo più rapido e fa sì che i tuoi dati vengano inseriti immediatamente nel nostro database di supporto.

   • Le restanti tre opzioni (Richiesta e-mail, Richiesta di stampa e Visualizza richiesta) sono tutti modi per ottenere una licenza se la tua macchina è offline (cioè non ha una connessione a Internet).

     Ciascuno di questi metodi prevede di fornire a Easysoft informazioni incluso il numero della macchina (un numero univoco per la macchina) e quindi attendere di ricevere la chiave di licenza.

     Invece di inviare i tuoi dati via e-mail a Easysoft, puoi inserirli direttamente sul sito Web di Easysoft e la tua chiave di licenza ti verrà inviata automaticamente via e-mail.

     Per utilizzare questo metodo, fai clic su Visualizza richiesta, quindi visita:

     • Pagina della licenza di prova
     • Pagina della licenza completa

     Nella pagina Licenza, inserisci il numero della tua macchina (e il codice di autorizzazione per la licenza acquistata), fai clic su Invia e la tua chiave di licenza ti verrà inviata via email.

     Quando ricevi la chiave di licenza, puoi attivarla facendo doppio clic sull'allegato e-mail o facendo clic su Immetti licenza nella schermata principale di License Manager e incollando la chiave di licenza nella finestra di dialogo.

   • Scegli Fine per uscire da License Manager.

     L'installazione è completa.

Configurazione di un'origine dati ODBC

Prima che il driver ODBC BigQuery possa essere utilizzato per connettere un'applicazione a BigQuery, è necessario configurare un'origine dati ODBC. Un'origine dati ODBC memorizza i dettagli di connessione per il database di destinazione (ad es. BigQuery) e il driver ODBC necessario per connettersi ad esso (ad es. il driver ODBC BigQuery).

Le origini dati ODBC sono configurate in Amministratore ODBC, incluso in Windows. La modalità di esecuzione di ODBC Administrator dipende dal fatto che l'applicazione sia a 32 o 64 bit:

• La mia applicazione è a 32 bit

  Nella finestra di dialogo Esegui di Windows, digita:

  %windir%\syswow64\odbcad32.exe

• La mia applicazione è a 64 bit

  Apri Sistema e sicurezza> Strumenti di amministrazione nel Pannello di controllo, quindi apri Origini dati ODBC (64 bit). (Su Windows Server 2003 e versioni precedenti, l'applet del Pannello di controllo che avvia ODBC Administrator è denominata Origini dati.)

Come capire se un'applicazione è a 32 o 64 bit?

select SERVERPROPERTY('edition')

Nell'amministratore ODBC:

1. Scegli la scheda DSN di sistema, quindi scegli Aggiungi.
2. Nella finestra di dialogo Crea nuova origine dati, scegli Easysoft ODBC-BigQuery Driver, quindi scegli Fine.
3. Compila questi campi nella finestra di dialogo Easysoft ODBC-BigQuery Driver DSN Setup:

   Setting	Valore
   DSN	BigQuery
   Aggiorna token	Scegli Autentica e ottieni token e concedi al driver BigQuery ODBC l'autorizzazione ad accedere ai tuoi dati BigQuery per compilare questo campo.

4. Nell'applicazione, connettiti all'origine dati appena configurata ed esegui una query di esempio. Ad esempio:

   select * from MyTable limit 10

Utilizza i dati BigQuery in Perl

Strawberry Perl è una distribuzione Perl per Windows che include i livelli middleware necessari (Perl DBI e Perl DBD::ODBC) per consentire al driver BigQuery ODBC di connettere le tue applicazioni Perl a BigQuery.

1. Ecco uno script Perl che recupera alcuni dati BiqQuery:

   #!/usr/bin/perl -w
   use strict;
   use DBI;
   my $dbh = DBI-> connect('dbi:ODBC:MyBigQueryDataSource');
   
   my $sql = "SELECT residential_ratio  FROM `bigquery-public-data.hud_zipcode_crosswalk.census_tracts_to_zipcode` LIMIT 10";
   
   # Prepare the statement.
   my $sth = $dbh->prepare($sql)
       or die "Can't prepare statement: $DBI::errstr";
   
   # Execute the statement.
   $sth->execute();
   
   my($BigQueryCol);
   
   # Fetch and display the result set value.
   while(($BigQueryCol) = $sth->fetchrow()){
      print("$BigQueryCol\n");                   
   }
   
   $dbh->disconnect if ($dbh);

2. Ecco uno script Perl che inserisce alcuni dati BigQuery:

   #!/usr/bin/perl -w
   use strict;
   use warnings;
   use DBI;
   
   my $data_source = q/dbi:ODBC:MyBigQueryDataSource/;
   
   my $h = DBI-"connect($data_source)
       or die "Can't connect to $data_source: $DBI::errstr";
   $h->{RaiseError} = 1;
   
   my $s = $h->prepare(q/insert into MyTable(MyStringCol, MyIntegerCol, MyFloatCol, MyNumericCol, MyBooleanCol,MyDateCol,MyTimeCol,MyDateTimeCol,MyTimeStampCol) values(?,?,?,?,?,?,?,?,?)/);
   my $string='MyValue';
   my $int=46683;
   my $float=8.3;
   my $numeric=0.00333;
   my $bool=0;
   my $date='2021-01-23';
   my $time='00:00:20';
   my $datetime='2021-02-05 00:00:00';
   my $timestamp='2019-01-27 00:00:00';
   
   $s->bind_param(1, $string, DBI::SQL_WVARCHAR);
   $s->bind_param(2, $int, DBI::SQL_INTEGER);
   $s->bind_param(3, $float, DBI::SQL_FLOAT);
   $s->bind_param(4, $numeric, DBI::SQL_NUMERIC);
   #$s->bind_param(5, $bignumeric, DBI::SQL_WVARCHAR);
   $s->bind_param(5, $bool, DBI::SQL_TINYINT);
   $s->bind_param(6, $date, DBI::SQL_DATE);
   $s->bind_param(7, $time, DBI::SQL_TIME);
   $s->bind_param(8, $datetime, DBI::SQL_DATETIME);
   $s->bind_param(9, $timestamp, DBI::SQL_TIMESTAMP);
   $s->execute($string,$int,$float,$numeric,$bool,$date,$time,$datetime,$timestamp);
   $h->disconnect;
   	  

3. Ecco uno script Perl che aggiorna un record BigQuery:

   #!/usr/bin/perl -w
   use strict;
   use warnings;
   use DBI;
   
   my $data_source = q/dbi:ODBC:MyBigQueryDataSource/;
   
   my $h = DBI->connect($data_source)
       or die "Can't connect to $data_source: $DBI::errstr";
   $h->{RaiseError} = 1;
   
   my $s = $h->prepare(q/UPDATE MyTestTable SET MyStringCol = ? WHERE MyStringCol = 'MyValue' /);
   my $string='MyNewValue';
   
   $s->bind_param(1, $string, DBI::SQL_WVARCHAR);
   
   $s->execute($string);
   $h->disconnect;

Utilizza i dati BigQuery in PHP

1. Ecco uno script PHP che recupera alcuni dati BiqQuery:

   <?php
     $con = odbc_connect("MyBigQueryDataSource", "", "");
     $err = odbc_errormsg();
     if (strlen($err) <> 0) {
       echo odbc_errormsg();
     } else {
       $rs2 = odbc_exec($con, "select MyCol from MyTable");
       odbc_result_all($rs2);
       odbc_close($con);
     }
   ?>

Collegamento di Excel a BigQuery

Segui questi passaggi per restituire i dati da BigQuery a Microsoft Excel utilizzando Microsoft Query:

1. Sui Dati scheda, scegli Nuova query> Da altra fonte> Da ODBC .
2. Scegli l'origine dati BigQuery ODBC quando richiesto.
3. Scegli una tabella dai set di dati disponibili.
4. Scegli Carica per restituire i dati BiqQuery al foglio di lavoro.

   Tieni presente che per set di risultati di grandi dimensioni, potrebbe essere necessario filtrare i dati utilizzando Excel prima che i dati possano essere restituiti al foglio di lavoro.

Connettiti a BigQuery da Oracle

1. Crea un file init DG4ODBC sulla tua macchina Oracle. Per fare ciò, cambia in %ORACLE_HOME%\hs\admin directory. Crea una copia del file initdg4odbc.ora . Assegna un nome al nuovo file initbq.ora .

   Nota In queste istruzioni, sostituisci %ORACLE_HOME% con il percorso della tua directory Oracle HOME. Ad esempio, C:\oraclexe\app\oracle\product\11.2.0\server .

2. Assicurati che questi parametri e valori siano presenti nel tuo file init:

   HS_FDS_CONNECT_INFO = MyBigQueryDataSource

3. Commenta la riga che abilita il tracciamento DG4ODBC. Ad esempio:

   #HS_FDS_TRACE_LEVEL = <trace_level>
   

4. Aggiungi una voce a %ORACLE_HOME%\network\admin\listener.ora che crea un SID_NAME per DG4ODBC. Ad esempio:

   SID_LIST_LISTENER =
    (SID_LIST =
      (SID_DESC=
        (SID_NAME=bq)
        (ORACLE_HOME=%ORACLE_HOME%)
        (PROGRAM=dg4odbc)
      )
    )
   

5. Aggiungi una voce DG4ODBC a %ORACLE_HOME%\network\admin\tnsnames.ora che specifica il SID_NAME creato nel passaggio precedente. Ad esempio:

   BQ =
     (DESCRIPTION =
       (ADDRESS = (PROTOCOL = TCP)(HOST = oracle_host)(PORT = 1521))
       (CONNECT_DATA =
         (SID = bq)
       )
       (HS = OK)
     )
   

   Sostituisci oracle_host con il nome host della tua macchina Oracle.

6. Avvia (o riavvia) Oracle Listener:

   cd %ORACLE_HOME%\bin
   lsnrctl stop
   lsnrctl start
   

7. Connettiti al tuo database Oracle in SQL*Plus.
8. In SQL*Plus, crea un collegamento al database per l'istanza BigQuery di destinazione. Ad esempio:

   CREATE PUBLIC DATABASE LINK bqlink CONNECT TO "mydummyuser" IDENTIFIED BY "mydummypassword" USING 'bq';
   

9. Prova a interrogare i tuoi dati BigQuery. Ad esempio:

   SELECT * FROM "MyTable"@BQLINK;
   

Note

• Se hai problemi di connessione a BigQuery da Oracle, abilita la traccia DG4ODBC e controlla i file di traccia scritti in %ORACLE_HOME%\hs\trace directory. Per abilitare il tracciamento DG4ODBC, aggiungi la riga HS_FDS_TRACE_LEVEL = DEBUG su initbq.ora e quindi avviare/riavviare il listener Oracle. Se il trace la directory non esiste, creala.
• Se si abilita la traccia di ODBC Driver Manager, ma non si ottiene un file di traccia o un file di traccia vuoto (cercare C:\SQL.log), modificare il percorso del file di traccia nella directory TEMP di Windows. Ad esempio, C:\Windows\Temp\SQL.log .