Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
15 changes: 15 additions & 0 deletions docs/interpreter/bigquery.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,6 +44,21 @@ Zeppelin is built against BigQuery API version v2-rev265-1.21.0 - [API Javadocs]

In a notebook, to enable the **BigQuery** interpreter, click the **Gear** icon and select **bigquery**.

### Setup service account credentials

In order to run BigQuery interpreter outside of Google Cloud Engine you need to provide authentication credentials,
by [following this instructions](https://developers.google.com/identity/protocols/application-default-credentials):

- Go to the [API Console Credentials page](https://console.developers.google.com/project/_/apis/credentials)
- From the project drop-down, select your project.
- On the `Credentials` page, select the `Create credentials` drop-down, then select `Service account key`.
- From the Service account drop-down, select an existing service account or create a new one.
- For `Key type`, select the `JSON` key option, then select `Create`. The file automatically downloads to your computer.
- Put the `*.json` file you just downloaded in a directory of your choosing. This directory must be private (you can't let anyone get access to this), but accessible to your Zeppelin instance.
- Set the environment variable `GOOGLE_APPLICATION_CREDENTIALS` to the path of the JSON file downloaded.
* either though GUI: in interpreter configuration page property names in CAPITAL_CASE set up env vars
* or though `zeppelin-env.sh`: just add it to the end of the file.

## Using the BigQuery Interpreter

In a paragraph, use `%bigquery.sql` to select the **BigQuery** interpreter and then input SQL statements against your datasets stored in BigQuery.
Expand Down