feat(go/adbc/driver): add support for Google BigQuery

c/CMakeLists.txt

@@ -68,6 +68,10 @@ if(ADBC_DRIVER_SNOWFLAKE)
   add_subdirectory(driver/snowflake)
 endif()
 
+if(ADBC_DRIVER_BIGQUERY)
+  add_subdirectory(driver/bigquery)
+endif()
+
 if(ADBC_INTEGRATION_DUCKDB)
   add_subdirectory(integration/duckdb)
 endif()
@@ -118,6 +122,10 @@ LIBRARY=$<TARGET_FILE:adbc_driver_${TARGET}_shared>" ${Python3_EXECUTABLE} -m pi
   if(ADBC_DRIVER_SNOWFLAKE)
     adbc_install_python_package(snowflake)
   endif()
+
+  if(ADBC_DRIVER_BIGQUERY)
+    adbc_install_python_package(bigquery)
+  endif()
 endif()
 
 validate_config()

c/cmake_modules/DefineOptions.cmake

@@ -236,6 +236,7 @@ if("${CMAKE_SOURCE_DIR}" STREQUAL "${CMAKE_CURRENT_SOURCE_DIR}")
   define_option(ADBC_DRIVER_POSTGRESQL "Build the PostgreSQL driver" OFF)
   define_option(ADBC_DRIVER_SQLITE "Build the SQLite driver" OFF)
   define_option(ADBC_DRIVER_SNOWFLAKE "Build the Snowflake driver" OFF)
+  define_option(ADBC_DRIVER_BIGQUERY "Build the BigQuery driver" OFF)
 
   define_option(ADBC_INTEGRATION_DUCKDB "Build the test suite for DuckDB" OFF)
 endif()

c/driver/bigquery/CMakeLists.txt

@@ -0,0 +1,70 @@
+# 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.
+
+include(GoUtils)
+
+set(LDFLAGS "$<$<CONFIG:Release>:-s> $<$<CONFIG:Release>:-w>")
+add_go_lib("${REPOSITORY_ROOT}/go/adbc/pkg/bigquery/"
+           adbc_driver_bigquery
+           SOURCES
+           driver.go
+           utils.h
+           utils.c
+           BUILD_TAGS
+           driverlib
+           PKG_CONFIG_NAME
+           adbc-driver-bigquery
+           SHARED_LINK_FLAGS
+           ${LDFLAGS}
+           OUTPUTS
+           ADBC_LIBRARIES)
+
+foreach(LIB_TARGET ${ADBC_LIBRARIES})
+  target_include_directories(${LIB_TARGET} SYSTEM
+                             INTERFACE ${REPOSITORY_ROOT} ${REPOSITORY_ROOT}/c/
+                                       ${REPOSITORY_ROOT}/c/vendor
+                                       ${REPOSITORY_ROOT}/c/driver)
+endforeach()
+
+if(ADBC_TEST_LINKAGE STREQUAL "shared")
+  set(TEST_LINK_LIBS adbc_driver_bigquery_shared)
+else()
+  set(TEST_LINK_LIBS adbc_driver_bigquery_static)
+endif()
+
+if(ADBC_BUILD_TESTS)
+  add_test_case(driver_bigquery_test
+                PREFIX
+                adbc
+                EXTRA_LABELS
+                driver-bigquery
+                SOURCES
+                bigquery_test.cc
+                EXTRA_LINK_LIBS
+                adbc_driver_common
+                adbc_validation
+                nanoarrow
+                ${TEST_LINK_LIBS})
+  target_compile_features(adbc-driver-bigquery-test PRIVATE cxx_std_17)
+  target_include_directories(adbc-driver-bigquery-test SYSTEM
+                             PRIVATE ${REPOSITORY_ROOT}
+                                     ${REPOSITORY_ROOT}/c/
+                                     ${REPOSITORY_ROOT}/c/vendor
+                                     ${REPOSITORY_ROOT}/c/driver
+                                     ${REPOSITORY_ROOT}/c/driver/common)
+  adbc_configure_target(adbc-driver-bigquery-test)
+endif()

c/driver/bigquery/README.md

@@ -0,0 +1,65 @@
+<!---
+  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.
+-->
+
+# ADBC Snowflake Driver
+
+This driver provides an interface to
+[BigQuery](https://cloud.google.com/bigquery) using ADBC.
+
+## Building
+
+See [CONTRIBUTING.md](../../CONTRIBUTING.md) for details.
+
+## Testing
+
+BigQuery credentials and project ID are required.
+
+### Environment Variables
+#### Project ID
+Set `BIGQUERY_PROJECT_ID` to the project ID.
+
+#### Authentication
+Set either one following environment variables for authentication:
+
+##### BIGQUERY_JSON_CREDENTIAL_FILE
+Path to the JSON credential file. This file can be generated using `gcloud`:
+
+```sh
+gcloud auth application-default login
+```
+
+And the default location of the generated JSON credential file is located at
+
+```sh
+$HOME/.config/gcloud/application_default_credentials.json
+```
+
+##### BIGQUERY_JSON_CREDENTIAL_STRING
+Store the whole JSON credential content, something like
+
+```json
+{
+  "account": "",
+  "client_id": "123456789012-1234567890abcdefabcdefabcdefabcd.apps.googleusercontent.com",
+  "client_secret": "d-SECRETSECRETSECRETSECR",
+  "refresh_token": "1//1234567890abcdefabcdefabcdef-abcdefabcd-abcdefabcdefabcdefabcdefab-abcdefabcdefabcdefabcdefabcdef-ab",
+  "type": "authorized_user",
+  "universe_domain": "googleapis.com"
+}
+```

c/driver/bigquery/adbc-driver-bigquery.pc.in

@@ -0,0 +1,25 @@
+# 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.
+
+prefix=@CMAKE_INSTALL_PREFIX@
+libdir=@ADBC_PKG_CONFIG_LIBDIR@
+
+Name: Apache Arrow Database Connectivity (ADBC) BigQuery driver
+Description: The ADBC BigQuery driver provides an ADBC driver for BigQuery.
+URL: https://github.com/apache/arrow-adbc
+Version: @ADBC_VERSION@
+Libs: -L${libdir} -ladbc_driver_bigquery