IBM Support

IBM Cognos Analytics - How to setup Google BigQuery JDBC data server connection (with SSL)

Question & Answer


Question

Does Cognos Analytics support Google BigQuery with SSL?
What drivers should I use?
What type of authentication is supported in Cognos?
What is the proper JDBC url format?

Answer

Google BigQuery is supported in Cognos Analytics 11.0.6 and newer versions.
Steps to setup the data server connection:
  1. Download the Google BigQuery JDBC 4.1 drivers:
    https://cloud.google.com/bigquery/providers/simba-drivers/
     
  2. Place the JDBC driver files (all jar files within the downloaded version) in the following path: <cognos_install>/analytics/drivers
     
  3. Export the Google BigQuery certificates to enable SSL connection:
    https://cloud.google.com/load-balancing/docs/ssl-certificates
     
  4. Import the Google BigQuery certificates in Cognos
     ./keytool -import -noprompt -alias GoogleInternetAuthorityG3.crt -file /tmp/GoogleInternetAuthorityG3.crt -keystore <cognos_install_location>/jre/lib/security/cacerts
    ./keytool -import -noprompt -alias GlobalSignRootCA-R2.crt -file /tmp/GlobalSignRootCA-R2.crt -keystore <cognos_install_location>/jre/lib/security/cacerts
  5. Setup the JSON authentication file (Cognos supports OAuthType = 0):
    https://www.simba.com/products/BigQuery/doc/JDBC_InstallGuide/content/jdbc/bq/authenticating/serviceaccount.htm
     
  6. Place the JSON file on a convenient folder accessible by the browser. In this example we placed the .json file in D:\temp.
     
  7. Create the data server connection. Go to Manage > Data server connections.
     
  8. Select "Google BigQuery" as the data server type.
     
  9. Use the following JDBC url format:
    jdbc:bigquery://https://www.googleapis.com/bigquery/v2:443;ProjectId=your-project-123456;OAuthType=0;OAuthPvtKeyPath=D:\\temp\\yourproject-0d6a8d80b220.json;OAuthServiceAcctEmail=yourproject-111@yourproject-project-123456.iam.gserviceaccount.com
Troubleshooting tip:
If issues occur, you can enable logging by adding the following to the end of the JDBC url:
LogLevel=6;LogPath=D:\;

[{"Business Unit":{"code":"BU059","label":"IBM Software w\/o TPS"},"Product":{"code":"SSTSF6","label":"IBM Cognos Analytics"},"Component":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"11.0.6+","Edition":"","Line of Business":{"code":"LOB10","label":"Data and AI"}}]

Document Information

Modified date:
12 September 2019

UID

ibm10958629