graphql-engine/server/documentation/data-sources/bigquery.md

• Introduction to BigQuery
• Getting started
• Getting started with BigQuery on Hasura

Introduction to BigQuery

BigQuery is a fully-managed, serverless data warehouse that enables high-performance, scalable analysis over petabytes of data. It is a Platform as a Service that supports querying using SQL.

• Google Cloud product page
• BigQuery vs Postgres comparison

Getting started

BigQuery setup and usage is atypical compared to other relational database backends Hasura currently supports, such as Postgres & SQL Server. You may find these guides useful to familiarise yourself with BigQuery before contributing a PR.

• Google Cloud Quickstart Guide

Google Cloud projects form the basis for creating, enabling, and using all Google Cloud services, including BigQuery datasets.

• Creating and managing projects
• Working with the resource hierarchy
• Identity Access Management policy
• gcloud, a set of command line tools to create and manage Google Cloud resources
• Google Cloud Console: Resource Manager

Once you have a project set up, you can work with datasets via the:

• Google Cloud Console
• REST API
• bq, a command line tool to run queries and load data into BigQuery

Getting started with BigQuery on Hasura

See the hasura.io: BigQuery getting started guide for general information about connecting to a BigQuery data source.

Integration tests are run against short-lived projects. The following prerequisites are expected:

• A Google Cloud Console service account
• HASURA_BIGQUERY_PROJECT_ID environment variable
• HASURA_BIGQUERY_SERVICE_KEY environment variable

See these docs for more guidance on testing against a BigQuery data source.