Class Dataset (2.40.1)

A Google BigQuery Dataset.

Objects of this class are immutable. Operations that modify the dataset like #update return a new object. To get a Dataset object with the most recent information use #reload. Dataset adds a layer of service-related functionality over DatasetInfo.

Creates a new table in this dataset.

Example of creating a table in the dataset with schema and time partitioning.

 String tableName = “my_table”;
 String fieldName = “my_field”;
 Schema schema = Schema.of(Field.of(fieldName, LegacySQLTypeName.STRING));
 StandardTableDefinition definition = StandardTableDefinition.newBuilder()
     .setSchema(schema)
     .setTimePartitioning(TimePartitioning.of(TimePartitioning.Type.DAY))
     .build();
 Table table = dataset.create(tableName, definition);
 

Deletes this dataset.

Example of deleting a dataset.

 boolean deleted = dataset.delete();
 if (deleted) {
   // The dataset was deleted
 } else {
   // The dataset was not found
 }
 

Checks if this dataset exists.

Example of checking whether a dataset exists.

 boolean exists = dataset.exists();
 if (exists) {
   // the dataset exists
 } else {
   // the dataset was not found
 }
 

Returns the requested table in this dataset or null if not found.

Example of getting a table in the dataset.

 String tableName = “my_table”;
 Table table = dataset.get(tableName);
 

Returns the dataset's BigQuery object used to issue requests.

Returns the paginated list of tables in this dataset.

Example of listing tables in the dataset.

 Page<Table> tables = dataset.list();
 for (Table table : tables.iterateAll()) {
   // do something with the table
 }
 

Fetches current dataset's latest information. Returns null if the dataset does not exist.

Example of reloading a dataset.

 Dataset latestDataset = dataset.reload();
 if (latestDataset == null) {
   // The dataset was not found
 }
 

Returns a builder for the dataset object.

Updates the dataset's information with this dataset's information. Dataset's user-defined id cannot be changed. A new Dataset object is returned.

Example of updating a dataset.

 String friendlyName = "my_friendly_name";
 Builder builder = dataset.toBuilder();
 builder.setFriendlyName(friendlyName);
 Dataset updatedDataset = builder.build().update();