////
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements.  See the NOTICE file
distributed with this work for additional information
regarding copyright ownership.  The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License.  You may obtain a copy of the License at
  http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied.  See the License for the
specific language governing permissions and limitations
under the License.
////
[[database-plugins-googlebigquery]]
:documentationPath: /database/databases/
:language: en_US
:openvar: ${
:closevar: }

= Google BigQuery

[cols="2*",options="header"]
|===
| Option | Info
|Type | Relational
|Driver | https://cloud.google.com/bigquery/docs/reference/odbc-jdbc-drivers[Driver Link]
|Version Included | None
|Hop Dependencies | None
|Documentation | https://www.simba.com/products/BigQuery/doc/JDBC_InstallGuide/content/jdbc/d-intro.htm[Documentation Link]
|JDBC Url | jdbc:bigquery://[Host]:[Port];ProjectId=[Project];OAuthType=[AuthValue]
|Driver folder | <Hop Installation>/lib/jdbc
|===

The Simba driver is packaged as a .zip containing many jars. Only a subset of the jars included with the Driver are necessary to use Bigquery JDBC with Apache Hop. Furthermore, some of the jars may conflict with those packaged with Hop and *must* be excluded.

**SIMBA DRIVER JARS TO EXCLUDE (THESE JARS ARE INCLUDED IN THE SIMBA DRIVER, BUT CONFLICT WITH HOP LIBRARIES AND MUST BE EXCLUDED**

 grpc-alts-<VERSION>.jar
 grpc-api-<VERSION>.jar  
 grpc-core-<VERSION>.jar
 grpc-netty-shaded-<VERSION>.jar

**SIMBA DRIVER JARS TO INCLUDE** (Include only these jars for a minimal Bigquery driver install):

 api-common-<VERSION>.jar
 gax-<VERSION>.jar
 gax-grpc-<VERSION>.jar
 google-api-services-bigquery-v2-<VERSION>.jar
 GoogleBigQueryJDBC42.jar
 google-cloud-bigquerystorage-<VERSION>.jar
 grpc-google-cloud-bigquerystorage-v1-<VERSION>.jar
 grpc-google-cloud-bigquerystorage-v1beta1-<VERSION>.jar
 grpc-google-cloud-bigquerystorage-v1beta2-<VERSION>.jar
 json-<VERSION>.jar
 proto-google-cloud-bigquerystorage-v1-<VERSION>.jar
 proto-google-cloud-bigquerystorage-v1beta1-<VERSION>.jar
 proto-google-cloud-bigquerystorage-v1beta2-<VERSION>.jar
 threetenbp-<VERSION>.jar

pass:[*] Tested with Hop 2.5.0 and Simba 1.3.3.1004. Not all authentication methods tested either, so this list may not be exhaustive
