Refactor old BigQuery samples and add new ones.

bigquery/README.md

@@ -12,9 +12,8 @@ analytics data warehouse.
 * [Setup](#setup)
 * [Samples](#samples)
  * [Create A Simple Application With the API](#create-a-simple-application-with-the-api)
- * [Calculate size of dataset](#calculate-size-of-dataset)
- * [Loading Data with a POST Request](#loading-data-with-a-post-request)
- * [Loading Data from Cloud Storage](#loading-data-from-cloud-storage)
+ * [Datasets](#datasets)
+ * [Tables](#tables)
 
 ## Setup
 
@@ -39,46 +38,72 @@ __Run the sample:__
 [basics_docs]: https://cloud.google.com/bigquery/create-simple-app-api
 [basics_code]: getting_started.js
 
-### Calculate size of dataset
-
-View the [source code][size_code].
-
-__Run the sample:__
-
-Usage: `node dataset_size <projectId> <datasetId>`
-
-Example:
-
- node dataset_size bigquery-public-data hacker_news
-
-[size_code]: dataset_size.js
-
-### Loading Data with a POST Request
-
-View the [documentation][file_docs] or the [source code][file_code].
-
-__Run the sample:__
-
-Usage: `node load_data_from_csv <path-to-file> <dataset-id> <table-name>`
-
-Example:
-
- node load_data_from_csv resources/data.csv my-dataset my-table
-
-[file_docs]: https://cloud.google.com/bigquery/loading-data-post-request
-[file_code]: load_data_from_csv.js
-
-### Loading Data from Cloud Storage
-
-View the [documentation][gcs_docs] or the [source code][gcs_code].
-
-__Run the sample:__
-
-Usage: `node load_data_from_gcs <bucket-name> <filename> <dataset-id> <table-name>`
-
-Example:
-
- node load_data_from_gcs my-bucket data.csv my-dataset my-table
-
-[gcs_docs]: https://cloud.google.com/bigquery/docs/loading-data-cloud-storage
-[gcs_code]: load_data_from_gcs.js
+### Datasets
+
+View the [documentation][datasets_docs] or the [source code][datasets_code].
+
+__Usage:__ `node datasets --help`
+
+```
+Commands:
+ create <name> Create a new dataset.
+ delete <datasetId> Delete the specified dataset.
+ list List datasets in the authenticated project.
+ size <datasetId> Calculate the size of the specified dataset.
+
+Options:
+ --projectId, -p Optionally specify the project ID to use.
+ [string]
+ --help Show help [boolean]
+
+Examples:
+ node datasets create my_dataset Create a new dataset named "my_dataset".
+ node datasets delete my_dataset Delete "my_dataset".
+ node datasets list List datasets.
+ node datasets list -p bigquery-public-data List datasets in a project other than the
+ authenticated project.
+ node datasets size my_dataset Calculate the size of "my_dataset".
+ node datasets size hacker_news -p Calculate the size of
+ bigquery-public-data "bigquery-public-data:hacker_news".
+
+For more information, see https://cloud.google.com/bigquery/docs
+```
+
+[datasets_docs]: https://cloud.google.com/bigquery/docs
+[datasets_code]: datasets.js
+
+### Tables
+
+View the [documentation][tables_docs] or the [source code][tables_code].
+
+__Usage:__ `node tables --help`
+
+```
+Commands:
+ create <dataset> <table> Create a new table in the specified dataset.
+ list <dataset> List tables in the specified dataset.
+ delete <dataset> <table> Delete a table in the specified dataset.
+ import <dataset> <table> <file> Import data from a local file or a Google Cloud Storage
+ file into BigQuery.
+ export <dataset> <table> <bucket> <file> Export a table from BigQuery to Google Cloud Storage.
+
+Options:
+ --help Show help [boolean]
+
+Examples:
+ node tables create my_dataset my_table Create table "my_table" in "my_dataset".
+ node tables list my_dataset List tables in "my_dataset".
+ node tables delete my_dataset my_table Delete "my_table" from "my_dataset".
+ node tables import my_dataset my_table ./data.csv Import a local file into a table.
+ node tables import my_dataset my_table data.csv Import a GCS file into a table.
+ --bucket my-bucket
+ node tables export my_dataset my_table my-bucket Export my_dataset:my_table to
+ my-file gcs://my-bucket/my-file as raw CSV
+ node tables export my_dataset my_table my-bucket Export my_dataset:my_table to
+ my-file -f JSON --gzip gcs://my-bucket/my-file as gzipped JSON
+
+For more information, see https://cloud.google.com/bigquery/docs
+```
+
+[tables_docs]: https://cloud.google.com/bigquery/docs
+[tables_code]: tables.js