diff --git a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/package-info.java b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/package-info.java index 85c3584fd6fe..fef46e995a2f 100644 --- a/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/package-info.java +++ b/java-bigquery/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/package-info.java @@ -18,20 +18,32 @@ * A client for BigQuery – A fully managed, petabyte scale, low cost enterprise data warehouse for * analytics. * - *

A simple usage example showing how to create a table in Bigquery. For the complete source code - * see - * CreateTable.java. + *

Use {@link com.google.cloud.bigquery.BigQuery} in this package to manage datasets, tables, + * routines, models, and jobs, run SQL queries, and read paginated results. For new streaming + * ingestion workloads or reading large tables directly in parallel (Apache Arrow or Avro), prefer + * {@code com.google.cloud:google-cloud-bigquerystorage}. See Introduction to loading data, + * BigQuery Storage Write API + * (gRPC), and BigQuery + * Storage Read API for guidance on choosing between APIs. + * + *

A simple usage example showing how to create a table in BigQuery. For the complete source + * code, see + * CreateTable.java. For additional examples, see BigQuery Java code + * samples. * *

{@code
- * BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService(); *
+ * // Reuse a single client across requests and call close() on shutdown to release resources.
+ * BigQuery bigquery = BigQueryOptions.getDefaultInstance().getService();
  * TableId tableId = TableId.of(datasetName, tableName);
  * TableDefinition tableDefinition = StandardTableDefinition.of(schema);
- * TableInfo tableInfo = TableInfo.newBuilder(tableId, tableDefinition).build(); *
+ * TableInfo tableInfo = TableInfo.newBuilder(tableId, tableDefinition).build();
  * bigquery.create(tableInfo);
- * System.out.println("Table created successfully");
  * }
* - * @see Google Cloud BigQuery + * @see com.google.cloud.bigquery.BigQuery + * @see BigQuery documentation */ package com.google.cloud.bigquery;