​
Install

Run the following command to install the connector from the root of your project:

npm install --save @latitude-data/bigquery-connector

​
How to configure sources

The sources files must be inside the queries/ folder.

To know how the source hierarchy works, please, visit How to configure sources.

​
Configuration

To configure the connection with your Bigquery database follow these steps:

1

Create the source `.yaml` file within the `queries` folder if you haven't already

/queries/source.yml

2

Add the following code for your Bigquery connection

type: bigquery
details:
  projectId: string
  token: string
  credentials: 
    client_email: string
    private_key: string
3

Replace the details section with your info and save

4

Done, now you can test your connection

​
Attributes

  • project_id → The unique identifier for your Google Cloud project. It’s like the address for where all your BigQuery activities live, helping Google know which project your data and queries belong to.
  • credentials → (Optional) To connect via service account authentication
    • clientEmail -> Your service account email
    • privateKey -> Your service account private key
  • token → (Optional) To connect with Oauth client ID authentication. This is Oauth’s access token, which can be generated with gcloud’s cli: gcloud auth print-access-token

For authentication, you’ll either have to choose the Credentials or Token approach. In case both are defined, Credentials approach takes preference.

​
Test connection

To test the connection you can:

  1. Create a query .sql in the queries directory that points to a table of your new connection in the FROM clause. See the section SQL Syntax Basics to learn more.
  2. Use the command line to run latitude run query_file_name where query_file_name is the name of your .sql file. This will display the results in your terminal. See the section Running queries to learn more about how to query your data.
AthenaClickhouse