From 60d904b1fc4625f490f9357c486bfe5ef4f36f2c Mon Sep 17 00:00:00 2001 From: Stephanie Wang Date: Wed, 12 Aug 2020 12:56:46 -0400 Subject: [PATCH] docs: update samples README.md (#667) * docs: update samples README.md and refactor SimpleQuery * fix typos * revert back changes to SimpleQuery --- samples/README.md | 21 +++++++++++++++------ 1 file changed, 15 insertions(+), 6 deletions(-) diff --git a/samples/README.md b/samples/README.md index 0b7ed99dd..ab3f812dc 100644 --- a/samples/README.md +++ b/samples/README.md @@ -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. \ No newline at end of file +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. \ No newline at end of file