Adds bigquery import, query, datasets, and schema commands (GoogleCloudPlatform#143)

* adds bigquery import, query, dataset, and schema commands
* removes old bq examples
* updates google/cloud to 0.6 tag

Author: bshaffer

bigquery/api/README.md

@@ -20,24 +20,121 @@ This simple command-line application demonstrates how to invoke Google BigQuery
 4.  **Install dependencies** via [Composer](http://getcomposer.org/doc/00-intro.md).
     Run `php composer.phar install` (if composer is installed locally) or `composer install`
     (if composer is installed globally).
-5.  Run `php main.php YOUR_PROJECT_NAME` where YOUR_PROJECT_NAME is the
-    project associated with the credentials from **step 2**.
+5.  Run `php bigquery.php`. The following commands are available:
 
     ```sh
-    $ php main.php my-project-name
-
-    Query Results:
-    ------------
-    hamlet                        5318
-    kinghenryv                    5104
-    cymbeline                     4875
-    troilusandcressida            4795
-    kinglear                      4784
-    kingrichardiii                4713
-    2kinghenryvi                  4683
-    coriolanus                    4653
-    2kinghenryiv                  4605
-    antonyandcleopatra            4582
+    datasets  List BigQuery datasets for a project
+    import    Import data into a BigQuery table
+    query     Run a BigQuery query
+    schema    Create or delete a table schema in BigQuery
+```
+
+## The commands
+
+### datasets
+
+List the datasets for your BigQuery project.
+
+```sh
+$ php bigquery.php datasets
+test_dataset1
+test_dataset2
+test_dataset3
+```
+
+### import
+
+Import data into a BigQuery table. You can import from several sources.
+
+1.  Import from a local JSON or CSV file. Make sure your files are
+    [formatted correctly](https://cloud.google.com/bigquery/loading-data#specifying_the_source_format)
+
+    ```sh
+    $ php bigquery.php import test_dataset.test_table /path/to/your_data.csv
+    $ php bigquery.php import test_dataset.test_table /path/to/your_data.json
+```
+1.  Import from [a JSON or CSV file in Google Cloud Storage](https://cloud.google.com/bigquery/docs/loading-data-cloud-storage)
+
+    ```sh
+    $ php bigquery.php import test_dataset.test_table gs://your-storage-bucket/your_data.csv
+    $ php bigquery.php import test_dataset.test_table gs://your-storage-bucket/your_data.json
+```
+1.  Import from a [Datastore Backup](https://cloud.google.com/bigquery/loading-data-cloud-datastore)
+
+    ```sh
+    $ php bigquery.php import test_dataset.test_table gs://your-storage-bucket/your_data.backup_info
+```
+
+You can also [stream data into bigquery](https://cloud.google.com/bigquery/streaming-data-into-bigquery)
+one record at a time. This approach enables querying data without the delay of running a load job:
+
+```sh
+$ php bigquery.php import test_dataset.test_table
+Import data for project cloud-samples-tests-php? [y/n]: y
+name (required): Brent Shaffer
+title (required): PHP Developer
+Data streamed into BigQuery successfully
+```
+
+### query
+
+Run a BigQuery query
+
+```sh
+$ php bigquery.php query "SELECT TOP(corpus, 3) as title, COUNT(*) as unique_words FROM [publicdata:samples.shakespeare]"
+--- Row 1 ---
+title: hamlet
+unique_words: 5318
+--- Row 2 ---
+title: kinghenryv
+unique_words: 5104
+--- Row 3 ---
+title: cymbeline
+unique_words: 4875
+```
+
+### schema
+
+Create a table schema in BigQuery. If a schema file is not supplied, you can
+create a schema interactively.
+
+```sh
+$ php bigquery.php schema my_dataset.my_table --project your-project-id
+Using project your-project-id
+1st column name: name
+1st column type (default: string):
+  [0] string
+  [1] bytes
+  [2] integer
+  [3] float
+  [4] boolean
+  [5] timestamp
+  [6] date
+  [7] record
+ > 0
+1st column mode (default: nullable):
+  [0] nullable
+  [1] required
+  [2] repeated
+ > 1
+add another field? [y/n]: n
+[
+    {
+        "name": "name",
+        "type": "string",
+        "mode": "required"
+    }
+]
+Does this schema look correct? [y/n]: y
+Table created successfully
+```
+
+The schema command also allows the deletion of tables
+```sh
+$ php bigquery.php schema my_dataset.my_table --project your-project-id --delete
+Using project your-project-id
+Are you sure you want to delete the BigQuery table "my_table"? [y/n]: y
+Table deleted successfully
 ```
 
 ## Contributing changes
@@ -47,5 +144,3 @@ This simple command-line application demonstrates how to invoke Google BigQuery
 ## Licensing
 
 * See [LICENSE](../../LICENSE)
-
-

bigquery/api/bigquery.php

@@ -0,0 +1,20 @@
+<?php
+
+require __DIR__ . '/vendor/autoload.php';
+
+use Google\Cloud\Samples\BigQuery\DatasetsCommand;
+use Google\Cloud\Samples\BigQuery\ImportCommand;
+use Google\Cloud\Samples\BigQuery\QueryCommand;
+use Google\Cloud\Samples\BigQuery\SchemaCommand;
+use Symfony\Component\Console\Application;
+
+$datasets = new DatasetsCommand();
+$import = new ImportCommand();
+$query = new QueryCommand();
+$schema = new SchemaCommand();
+$application = new Application();
+$application->add($datasets);
+$application->add($import);
+$application->add($query);
+$application->add($schema);
+$application->run();

bigquery/api/composer.json

@@ -1,5 +1,15 @@
 {
     "require": {
-        "google/apiclient": "^2.0"
+        "google/apiclient": "^2.0",
+        "google/cloud": "0.6",
+        "symfony/console": "^3.0"
+    },
+    "autoload": {
+        "psr-4": {
+            "Google\\Cloud\\Samples\\BigQuery\\": "src/"
+        },
+        "files": [
+            "src/functions.php"
+        ]
     }
 }