[BC Break] Switch to standard SQL by default

src/BigQuery/BigQueryClient.php

@@ -114,7 +114,7 @@ public function __construct(array $config = [])
      *
      * Queries constructed using
      * [standard SQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/)
-     * can take advantage of parametriziation.
+     * can take advantage of parameterization.
      *
      * Refer to the table below for a guide on how parameter types are mapped to
      * their BigQuery equivalents.
@@ -194,8 +194,8 @@ public function __construct(array $config = [])
      *     @type bool $useQueryCache Whether to look for the result in the query
      *           cache.
      *     @type bool $useLegacySql Specifies whether to use BigQuery's legacy
-     *           SQL dialect for this query. **Defaults to** `true`. If set to
-     *           false, the query will use
+     *           SQL dialect for this query. **Defaults to** `false`. Unless set to
+     *           true, the query will use
      *           [BigQuery's standard SQL](https://cloud.google.com/bigquery/sql-reference).
      *     @type array $parameters Only available for standard SQL queries.
      *           When providing a non-associative array positional parameters
@@ -209,7 +209,8 @@ public function __construct(array $config = [])
     public function runQuery($query, array $options = [])
     {
         $options += [
-            'maxRetries' => 100
+            'maxRetries' => 100,
+            'useLegacySql' => false
         ];
 
         if (isset($options['parameters'])) {
@@ -257,7 +258,7 @@ public function runQuery($query, array $options = [])
      *
      * Queries constructed using
      * [standard SQL](https://cloud.google.com/bigquery/docs/reference/standard-sql/)
-     * can take advantage of parametriziation. For more details and examples
+     * can take advantage of parameterization. For more details and examples
      * please see {@see Google\Cloud\BigQuery\BigQueryClient::runQuery()}.
      *
      * Example:
@@ -290,21 +291,28 @@ public function runQuery($query, array $options = [])
      *           named parameters will be used (`@name`).
      *     @type array $jobConfig Configuration settings for a query job are
      *           outlined in the [API Docs for `configuration.query`](https://goo.gl/PuRa3I).
-     *           If not provided default settings will be used.
+     *           If not provided default settings will be used, with the exception
+     *           of `configuration.query.useLegacySql`, which defaults to `false`
+     *           in this client.
      * }
      * @return Job
      */
     public function runQueryAsJob($query, array $options = [])
     {
-        if (isset($options['parameters'])) {
-            if (!isset($options['jobConfig'])) {
-                $options['jobConfig'] = [];
-            }
+        $options += [
+            'jobConfig' => []
+        ];
 
+        if (isset($options['parameters'])) {
             $options['jobConfig'] += $this->formatQueryParameters($options['parameters']);
+
             unset($options['parameters']);
         }
 
+        $options['jobConfig'] += [
+            'useLegacySql' => false
+        ];
+
         $config = $this->buildJobConfig(
             'query',
             $this->projectId,

tests/unit/BigQuery/BigQueryClientTest.php

@@ -130,7 +130,8 @@ public function queryDataProvider()
                 [],
                 [
                     'projectId' => $this->projectId,
-                    'query' => $query
+                    'query' => $query,
+                    'useLegacySql' => false
                 ]
             ],
             [