Skip to content

Commit

Permalink
docs: update samples README.md (#667)
Browse files Browse the repository at this point in the history
* docs: update samples README.md and refactor SimpleQuery

* fix typos

* revert back changes to SimpleQuery
  • Loading branch information
stephaniewang526 authored Aug 12, 2020
1 parent 813584e commit 60d904b
Showing 1 changed file with 15 additions and 6 deletions.
21 changes: 15 additions & 6 deletions samples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,16 +2,25 @@

## Running a sample using Cloud Shell

The Google Cloud Shell has application default credentials from its compute instance which will allow you to run an integration test without having to obtain `GOOGLE_APPLICATION_CREDENTIANS`.
The Google Cloud Shell has application default credentials from its compute instance which will allow you to run an integration test without having to obtain `GOOGLE_APPLICATION_CREDENTIALS`. Go to [BigQuery Client Readme](https://github.com/googleapis/java-bigquery#samples) to run each sample in the Cloud Shell.

However, certain samples require environment variables to be set. For instance, in `CreateDatasetIT.java`:
## Running a sample using command line

First set up `GOOGLE_APPLICATION_CREDENTIALS` and `GOOGLE_CLOUD_PROJECT` environment variables before running any samples.

To run a sample:
1. `cd samples/snippets` - all samples are located in `java-bigquery/samples/snippets` directory.
2. `mvn compile exec:java -Dexec.mainClass=com.example.bigquery.SimpleQuery` - this runs the [SimpleQuery sample](https://github.com/googleapis/java-bigquery/blob/master/samples/snippets/src/main/java/com/example/bigquery/SimpleQuery.java) which runs the BigQuery query method. You can update the developer's `TODO` section in the snippet if you wish to run a different query.

## Running a sample integration test using command line

Note that some samples require environment variables to be set. For instance, in `CreateDatasetIT.java`:

`private static final String GOOGLE_CLOUD_PROJECT = System.getenv("GOOGLE_CLOUD_PROJECT");` - this sample integration test requires you to specific the [Google Cloud Project](https://cloud.google.com/resource-manager/docs/creating-managing-projects) you would like to run the test in.

Make sure to set environment variables, if necessary, before running the sample, or else you will get an error asking you to set it.

To run a samples integration tests in the cloud shell, simply run the following commands:

`cd samples/snippets` - all samples are located in `java-bigquery/samples/snippets` directory.
To run a samples integration tests:

`mvn -Dtest=GetTableIT test` - this runs the integration test of `GetTable.java` sample.
1. `cd samples/snippets` - all samples are located in `java-bigquery/samples/snippets` directory.
2. `mvn -Dtest=GetTableIT test` - this runs the integration test of `GetTable.java` sample.

0 comments on commit 60d904b

Please sign in to comment.