adds sample for large query results

google-cloud-examples/src/main/java/com/google/cloud/examples/bigquery/snippets/BigQuerySnippets.java

@@ -767,12 +767,38 @@ public void runQueryPermanentTable(String destinationDataset, String destination
     QueryJobConfiguration queryConfig =
         // Note that setUseLegacySql is set to false by default
         QueryJobConfiguration.newBuilder(query)
-        // Save the results of the query to a permanent table. See:
-        // https://cloud.google.com/bigquery/docs/writing-results#permanent-table
+        // Save the results of the query to a permanent table.
+        .setDestinationTable(TableId.of(destinationDataset, destinationTable))
+        .build();
+
+    // Print the results.
+    for (FieldValueList row : bigquery.query(queryConfig).iterateAll()) {
+      for (FieldValue val : row) {
+        System.out.printf("%s,", val.toString());
+      }
+      System.out.printf("\n");
+    }
+    // [END bigquery_query_destination_table]
+  }
+
+  /**
+   * Example of running a query and saving the results to a table.
+   */
+  // [TARGET query(QueryJobConfiguration, JobOption...)]
+  public void runQueryLargeResults(String destinationDataset, String destinationTable) throws InterruptedException {
+    // [START bigquery_query_legacy_large_results]
+    // BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();
+    // String destinationDataset = 'my_destination_dataset';
+    // String destinationTable = 'my_destination_table';
+    String query =
+        "SELECT corpus FROM [bigquery-public-data:samples.shakespeare] GROUP BY corpus;";
+    QueryJobConfiguration queryConfig =
+        // To use legacy SQL syntax, set useLegacySql to true.
+        QueryJobConfiguration.newBuilder(query).setUseLegacySql(true)
+        // Save the results of the query to a permanent table.
         .setDestinationTable(TableId.of(destinationDataset, destinationTable))
         // Allow results larger than the maximum response size.
-        // If true, a destination table must be set. See:
-        // https://cloud.google.com/bigquery/docs/writing-results#large-results
+        // If true, a destination table must be set.
         .setAllowLargeResults(true)
         .build();
 
@@ -783,7 +809,7 @@ public void runQueryPermanentTable(String destinationDataset, String destination
       }
       System.out.printf("\n");
     }
-    // [END bigquery_query_destination_table]
+    // [END bigquery_query_legacy_large_results]
   }
 
   /**

google-cloud-examples/src/test/java/com/google/cloud/examples/bigquery/snippets/ITBigQuerySnippets.java

@@ -314,6 +314,14 @@ public void testRunQueryPermanentTable() throws InterruptedException {
     assertTrue(got.contains("romeoandjuliet"));
   }
 
+  @Test
+  public void testRunQueryLargeResults() throws InterruptedException {
+    String tableName = "test_large_results";
+    bigquerySnippets.runQueryLargeResults(DATASET, tableName);
+    String got = bout.toString();
+    assertTrue(got.contains("romeoandjuliet"));
+  }
+
   @Test
   public void testRunUncachedQuery() throws TimeoutException, InterruptedException {
     bigquerySnippets.runUncachedQuery();