Package com.google.cloud.bigtable.admin.v2

Class BigtableTableAdminClient

java.lang.Object
com.google.cloud.bigtable.admin.v2.BigtableTableAdminClient
All Implemented Interfaces:
AutoCloseable
public final class BigtableTableAdminClient extends Object implements AutoCloseable
Client for creating, configuring, and deleting Cloud Bigtable tables

Provides access to the table schemas only, not the data stored within the tables.

See the individual methods for example code.

Sample code to get started: 


 // One instance per application.
 BigtableTableAdminClient client =  BigtableTableAdminClient.create("[PROJECT]", "[INSTANCE]");

 CreateTableRequest request =
   CreateTableRequest.of("my-table")
     .addFamily("cf1")
     .addFamily("cf2", GCRULES.maxVersions(10))
     .addSplit(ByteString.copyFromUtf8("b"))
     .addSplit(ByteString.copyFromUtf8("q"));
 client.createTable(request);

 // Cleanup during application shutdown.
 client.close();

Creating a new client is a very expensive operation and should only be done once and shared in an application. However, close() needs to be called on the client object to clean up resources such as threads during application shutdown.

This class can be customized by passing in a custom instance of BigtableTableAdminSettings to create(). For example:

To customize credentials: 


 BigtableTableAdminSettings settings = BigtableTableAdminSettings.newBuilder()
   .setProjectId("[PROJECT]")
   .setInstanceId("[INSTANCE]")
   .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
   .build();

 BigtableTableAdminClient client = BigtableTableAdminClient.create(settings);
To customize the endpoint: 

 BigtableTableAdminSettings.Builder settingsBuilder = BigtableTableAdminSettings.newBuilder()
   .setProjectId("[PROJECT]")
   .setInstanceId("[INSTANCE]");

 settingsBuilder.stubSettings()
   .setEndpoint(myEndpoint).build();

 BigtableTableAdminClient client = BigtableTableAdminClient.create(settingsBuilder.build());

  • Method Details

    • create

      public static BigtableTableAdminClient create(@Nonnull String projectId, @Nonnull String instanceId) throws IOException
      Constructs an instance of BigtableTableAdminClient with the given project and instance IDs.
      Throws:
      IOException

    • create

      public static BigtableTableAdminClient create(@Nonnull BigtableTableAdminSettings settings) throws IOException
      Constructs an instance of BigtableTableAdminClient with the given settings.
      Throws:
      IOException

    • create

      public static BigtableTableAdminClient create(@Nonnull String projectId, @Nonnull String instanceId, @Nonnull com.google.cloud.bigtable.admin.v2.stub.EnhancedBigtableTableAdminStub stub)
      Constructs an instance of BigtableTableAdminClient with the given instance name and stub.

    • getProjectId

      public String getProjectId()
      Gets the project ID of the instance whose tables this client manages.

    • getInstanceId

      public String getInstanceId()
      Gets the ID of the instance whose tables this client manages.

    • close

      public void close()
      Specified by:
      close in interface AutoCloseable

    • createTable

      public Table createTable(CreateTableRequest request)
      Creates a new table with the specified configuration.

      Sample code: 

      
 // A table with a single column family, which retains only the latest value.
 Table table = client.createTable(
   CreateTableRequest.of("my-table")
     .addFamily("cf2", GCRULES.maxVersions(1))
 );

 // Another table with more complex garbage collection rules.
 Table table = client.createTable(
   CreateTableRequest.of("my-table")
     .addFamily("cf2", GCRULES.union()
       .rule(GCRULES.maxAge(Duration.ofDays(30)))
       .rule(GCRULES.maxVersions(5))
     )
 );
      See Also:

    • createTableAsync

      public com.google.api.core.ApiFuture<Table> createTableAsync(CreateTableRequest request)
      Asynchronously creates a new table with the specified configuration.

      Sample code: 

      
 // A table with a single column family, which retains values up to 7 days.
 ApiFuture<Table> tableFuture = client.createTableAsync(
   CreateTableRequest.of("my-table")
     .addFamily("cf", GCRULES.maxAge(Duration.ofDays(7)))
 );

 // Another table with more complex garbage collection rules.
 ApiFuture<Table> tableFuture = client.createTableAsync(
   CreateTableRequest.of("my-table")
     .addFamily("cf", GCRULES.intersection()
       .rule(GCRULES.maxAge(120, TimeUnit.HOURS))
       .rule(GCRULES.maxVersions(10))
     )
 );

 ApiFutures.addCallback(
   tableFuture,
   new ApiFutureCallback<Table>() {
     public void onSuccess(Table table) {
       System.out.println("Created table: " + table.getTableName());
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );
      See Also:

    • updateTable

      public Table updateTable(UpdateTableRequest request)
      Update a table with the specified configuration.

      Sample code: 

      
 // Alter change stream retention period.
 Table table = client.updateTable(
   UpdateTableRequest.of("my-table")
     .addChangeStreamRetention(Duration.ofHours(24))
 );

 // Disable change stream
 Table table = client.updateTable(
   UpdateTableRequest.of("my-table")
     .disableChangeStream()
 );
      See Also:

    • updateTableAsync

      public com.google.api.core.ApiFuture<Table> updateTableAsync(UpdateTableRequest request)
      Asynchronously update a table with the specified configuration.

      Sample code: 

      
 // Update table to 1 day change stream retention.
 ApiFuture<Table> tableFuture = client.createTableAsync(
   UpdateTableRequest.of("my-table")
     .addChangeStreamRetention(Duration.ofHours(24))
 );

 ApiFutures.addCallback(
   tableFuture,
   new ApiFutureCallback<Table>() {
     public void onSuccess(Table table) {
       System.out.println("Updated table: " + table.getTableName());
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );
      See Also:

    • modifyFamilies

      public Table modifyFamilies(ModifyColumnFamiliesRequest request)
      Creates, updates and drops column families as specified in the request.

      Sample code: 

      
 Table modifiedTable = client.modifyFamilies(
   ModifyColumnFamiliesRequest.of(tableId)
     .addFamily("cf1")
     .addFamily("cf2", GCRULES.maxAge(Duration.ofSeconds(1000, 20000)))
     .updateFamily(
       "cf3",
       GCRULES.union()
         .rule(GCRULES.maxAge(Duration.ofSeconds(100)))
         .rule(GCRULES.maxVersions(1))
       )
     .addFamily(
       "cf4",
       GCRULES.intersection()
         .rule(GCRULES.maxAge(Duration.ofSeconds(2000)))
         .rule(GCRULES.maxVersions(10))
     )
     .dropFamily("cf5")
 );

 System.out.println("Resulting families:");

 for (ColumnFamily cf : modifiedTable.getColumnFamilies()) {
   System.out.println(cf.getId());
 }
      See Also:

    • modifyFamiliesAsync

      public com.google.api.core.ApiFuture<Table> modifyFamiliesAsync(ModifyColumnFamiliesRequest request)
      Asynchronously creates, updates, and drops column families as specified in the request.

      Sample code: 

      
 ApiFuture<Table> modifiedTableFuture = client.modifyFamiliesAsync(
   ModifyColumnFamiliesRequest.of(tableId)
     .addFamily("cf1")
     .addFamily("cf2", GCRULES.maxAge(Duration.ofSeconds(1000, 20000)))
     .updateFamily(
       "cf3",
       GCRULES.union()
         .rule(GCRULES.maxAge(Duration.ofSeconds(100)))
         .rule(GCRULES.maxVersions(1))
       )
     .addFamily(
       "cf4",
       GCRULES.intersection()
         .rule(GCRULES.maxAge(Duration.ofSeconds(2000)))
         .rule(GCRULES.maxVersions(10))
     )
     .dropFamily("cf5")
 );

 ApiFutures.addCallback(
   modifiedTableFuture,
   new ApiFutureCallback<Table>() {
     public void onSuccess(Table table) {
       System.out.println("Modified table: " + table.getTableName());
       System.out.println("Resulting families:");

       for (ColumnFamily cf : modifiedTable.getColumnFamilies()) {
         System.out.println(cf.getId());
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );
      See Also:

    • deleteTable

      public void deleteTable(String tableId)
      Deletes the table specified by the table ID.

      Sample code: 

      
 client.deleteTable("my-table");

    • deleteTableAsync

      public com.google.api.core.ApiFuture<Void> deleteTableAsync(String tableId)
      Asynchronously deletes the table specified by the table ID.

      Sample code: 

      
 ApiFuture<Void> future = client.deleteTableAsync("my-table");

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Void>() {
     public void onSuccess(Void ignored) {
       System.out.println("Successfully deleted the table");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • exists

      public boolean exists(String tableId)
      Checks if the table specified by the table ID exists.

      Sample code: 

      
 if(client.exists("my-table")) {
   System.out.println("Table exists");
 }

    • existsAsync

      public com.google.api.core.ApiFuture<Boolean> existsAsync(String tableId)
      Asynchronously checks if the table specified by the table ID exists.

      Sample code: 

      
 ApiFuture<Boolean> found = client.existsAsync("my-table");

 ApiFutures.addCallback(
  found,
  new ApiFutureCallback<Boolean>() {
    public void onSuccess(Boolean found) {
      if (found) {
        System.out.println("Table exists");
      } else {
        System.out.println("Table not found");
      }
    }

    public void onFailure(Throwable t) {
      t.printStackTrace();
    }
  },
  MoreExecutors.directExecutor()
 );

    • getTable

      public Table getTable(String tableId)
      Gets the table metadata by table ID.

      Sample code: 

      
 Table table = client.getTable("my-table");

 System.out.println("Got metadata for table: " + table.getId());
 System.out.println("Column families:");

 for (ColumnFamily cf : table.getColumnFamilies()) {
   System.out.println(cf.getId());
 }

    • getTableAsync

      public com.google.api.core.ApiFuture<Table> getTableAsync(String tableId)
      Asynchronously gets the table metadata by table ID.

      Sample code: 

      
 ApiFuture<Table> tableFuture = client.getTableAsync("my-table");

 ApiFutures.addCallback(
   tableFuture,
   new ApiFutureCallback<Table>() {
     public void onSuccess(Table table) {
       System.out.println("Got metadata for table: " + table.getId());
       System.out.println("Column families:");
       for (ColumnFamily cf : table.getColumnFamilies()) {
         System.out.println(cf.getId());
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • getEncryptionInfo

      public Map<String,List<EncryptionInfo>> getEncryptionInfo(String tableId)
      Gets the current encryption info for the table across all of the clusters.

      The returned Map will be keyed by cluster id and contain a status for all of the keys in use.

    • getEncryptionInfoAsync

      public com.google.api.core.ApiFuture<Map<String,List<EncryptionInfo>>> getEncryptionInfoAsync(String tableId)
      Asynchronously gets the current encryption info for the table across all of the clusters.

      The returned Map will be keyed by cluster id and contain a status for all of the keys in use.

    • listTables

      public List<String> listTables()
      Lists all table IDs in the instance.

      Sample code: 

      
 List<String> tableIds = client.listTables();
 for(String tableId: tableIds) {
   System.out.println(name.getTable());
 }

    • listTablesAsync

      public com.google.api.core.ApiFuture<List<String>> listTablesAsync()
      Asynchronously lists all table IDs in the instance.

      Sample code: 

      
 ApiFuture<List<String>> listFuture = client.listTables();

 ApiFutures.addCallback(
   listFuture,
   new ApiFutureCallback<List<String>>() {
     public void onSuccess(List<String> tableIds) {
       System.out.println("Got list of tables:");
       for (String tableId : tableIds) {
         System.out.println(tableId);
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • dropRowRange

      public void dropRowRange(String tableId, String rowKeyPrefix)
      Drops rows by the specified row key prefix and table ID.

      Please note that this method is considered part of the admin API and is rate limited.

      Sample code: 

      
 client.dropRowRange("my-table", "prefix");

    • dropRowRangeAsync

      public com.google.api.core.ApiFuture<Void> dropRowRangeAsync(String tableId, String rowKeyPrefix)
      Asynchronously drops rows by the specified row key prefix and table ID.

      Please note that this method is considered part of the admin API and is rate limited.

      Sample code: 

      
 ApiFuture<Void> dropFuture = client.dropRowRangeAsync("my-table", "prefix");

 ApiFutures.addCallback(
   dropFuture,
   new ApiFutureCallback<Void>() {
     public void onSuccess(Void tableNames) {
       System.out.println("Successfully dropped row range.");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • dropRowRange

      public void dropRowRange(String tableId, com.google.protobuf.ByteString rowKeyPrefix)
      Drops rows by the specified row key prefix and table ID.

      Please note that this method is considered part of the admin API and is rate limited.

      Sample code: 

      
 client.dropRowRange("my-table", ByteString.copyFromUtf8("prefix"));

    • dropRowRangeAsync

      public com.google.api.core.ApiFuture<Void> dropRowRangeAsync(String tableId, com.google.protobuf.ByteString rowKeyPrefix)
      Asynchronously drops rows by the specified row key prefix and table ID.

      Please note that this method is considered part of the admin API and is rate limited.

      Sample code: 

      
 ApiFuture<Void> dropFuture = client.dropRowRangeAsync("my-table", ByteString.copyFromUtf8("prefix"));

 ApiFutures.addCallback(
   dropFuture,
   new ApiFutureCallback<Void>() {
     public void onSuccess(Void tableNames) {
       System.out.println("Successfully dropped row range.");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • dropAllRows

      public void dropAllRows(String tableId)
      Drops all data in the table.

      Sample code: 

      
 client.dropAllRows("my-table");

    • dropAllRowsAsync

      public com.google.api.core.ApiFuture<Void> dropAllRowsAsync(String tableId)
      Asynchronously drops all data in the table.

      Sample code: 

      
 ApiFuture<Void> dropFuture = client.dropAllRowsAsync("my-table");

 ApiFutures.addCallback(
   dropFuture,
   new ApiFutureCallback<Void>() {
     public void onSuccess(Void tableNames) {
       System.out.println("Successfully dropped all data");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • awaitReplication

      public void awaitReplication(String tableId)
      Blocks the current thread until replication has caught up to the point when this method was called. This allows callers to make sure that their mutations have been replicated across all of their clusters.

      Sample code 

      
 client.awaitReplication("my-table");
      Throws:
      com.google.api.gax.retrying.PollException - when polling exceeds the total timeout

    • createBackup

      public Backup createBackup(CreateBackupRequest request)
      Creates a backup with the specified configuration.

      Sample code 

      
 CreateBackupRequest request =
         CreateBackupRequest.of(clusterId, backupId)
             .setSourceTableId(tableId)
             .setExpireTime(expireTime);
 Backup response = client.createBackup(request);

    • createBackupAsync

      public com.google.api.core.ApiFuture<Backup> createBackupAsync(CreateBackupRequest request)
      Creates a backup with the specified configuration asynchronously.

      Sample code 

      
 CreateBackupRequest request =
         CreateBackupRequest.of(clusterId, backupId)
             .setSourceTableId(tableId)
             .setExpireTime(expireTime);
 ApiFuture<Backup> future = client.createBackupAsync(request);

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Backup>() {
     public void onSuccess(Backup backup) {
       System.out.println("Successfully create the backup " + backup.getId());
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • getBackup

      public Backup getBackup(String clusterId, String backupId)
      Gets a backup with the specified backup ID in the specified cluster.

      Sample code 

      
 Backup backup = client.getBackup(clusterId, backupId);

    • getBackupAsync

      public com.google.api.core.ApiFuture<Backup> getBackupAsync(String clusterId, String backupId)
      Gets a backup with the specified backup ID in the specified cluster asynchronously.

      Sample code 

      
 ApiFuture<Backup> future = client.getBackupAsync(clusterId, backupId);

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Backup>() {
     public void onSuccess(Backup backup) {
       System.out.println("Successfully get the backup " + backup.getId());
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • listBackups

      public List<String> listBackups(String clusterId)
      Lists backups in the specified cluster.

      Sample code 

      
 List<String> backups = client.listBackups(clusterId);

    • listBackupsAsync

      public com.google.api.core.ApiFuture<List<String>> listBackupsAsync(String clusterId)
      Lists backups in the specified cluster asynchronously.

      Sample code: 

      
 ApiFuture<List<String>> listFuture = client.listBackupsAsync(clusterId);

 ApiFutures.addCallback(
   listFuture,
   new ApiFutureCallback<List<String>>() {
     public void onSuccess(List<String> backupIds) {
       System.out.println("Got list of backups:");
       for (String backupId : backupIds) {
         System.out.println(backupId);
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • deleteBackup

      public void deleteBackup(String clusterId, String backupId)
      Deletes a backup with the specified backup ID in the specified cluster.

      Sample code 

      
 client.deleteBackup(clusterId, backupId);

    • deleteBackupAsync

      public com.google.api.core.ApiFuture<Void> deleteBackupAsync(String clusterId, String backupId)
      Deletes a backup with the specified backup ID in the specified cluster asynchronously.

      Sample code 

      
 ApiFuture<Void> future = client.deleteBackupAsync(clusterId, backupId);

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Backup>() {
     public void onSuccess(Void unused) {
       System.out.println("Successfully delete the backup.");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • updateBackup

      public Backup updateBackup(UpdateBackupRequest request)
      Updates a backup with the specified configuration.

      Sample code 

      
 Backup backup = client.updateBackup(clusterId, backupId);

    • updateBackupAsync

      public com.google.api.core.ApiFuture<Backup> updateBackupAsync(UpdateBackupRequest request)
      Updates a backup with the specified configuration asynchronously.

      Sample code 

      
 ApiFuture<Backup> future = client.updateBackupAsync(clusterId, backupId);

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Backup>() {
     public void onSuccess(Backup backup) {
       System.out.println("Successfully update the backup " + backup.getId());
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • restoreTable

      public RestoredTableResult restoreTable(RestoreTableRequest request) throws ExecutionException, InterruptedException
      Restores a backup to a new table with the specified configuration.

      Sample code 

      
 RestoredTableResult result =
     client.restoreTable(RestoreTableRequest.of(clusterId, backupId).setTableId(tableId));
      Throws:
      ExecutionException
      InterruptedException

    • restoreTableAsync

      public com.google.api.core.ApiFuture<RestoredTableResult> restoreTableAsync(RestoreTableRequest request)
      Restores a backup to a new table with the specified configuration asynchronously.

      Sample code 

      {@code
 ApiFuture<RestoredTableResult> future = client.restoreTableAsync(
     RestoreTableRequest.of(clusterId, backupId).setTableId(tableId));

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<RestoredTableResult>() {
     public void onSuccess(RestoredTableResult result) {
       System.out.println("Successfully restore the table.");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );
 </pre>

    • awaitOptimizeRestoredTable

      public void awaitOptimizeRestoredTable(OptimizeRestoredTableOperationToken token) throws ExecutionException, InterruptedException
      Awaits a restored table is fully optimized.

      Sample code 

      
 RestoredTableResult result =
     client.restoreTable(RestoreTableRequest.of(clusterId, backupId).setTableId(tableId));
 client.awaitOptimizeRestoredTable(result.getOptimizeRestoredTableOperationToken());
      Throws:
      ExecutionException
      InterruptedException

    • awaitOptimizeRestoredTableAsync

      public com.google.api.core.ApiFuture<Void> awaitOptimizeRestoredTableAsync(OptimizeRestoredTableOperationToken token)
      Awaits a restored table is fully optimized asynchronously.

      Sample code 

      
 RestoredTableResult result =
     client.restoreTable(RestoreTableRequest.of(clusterId, backupId).setTableId(tableId));
 ApiFuture<Void> future = client.awaitOptimizeRestoredTableAsync(
     result.getOptimizeRestoredTableOperationToken());

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Void>() {
     public void onSuccess(Void unused) {
       System.out.println("The optimization of the restored table is done.");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • copyBackup

      public Backup copyBackup(CopyBackupRequest request)
      Copy an existing backup to a new backup in a Cloud Bigtable cluster with the specified configuration.

      Sample code Note: You want to create the client with project and instance where you want the new backup to be copied to. 

      
 BigtableTableAdminClient client =  BigtableTableAdminClient.create("[PROJECT]", "[INSTANCE]");
 CopyBackupRequest request =
         CopyBackupRequest.of(sourceClusterId, sourceBackupId)
             .setDestination(clusterId, backupId)
             .setExpireTime(expireTime);
 Backup response = client.copyBackup(request);
      If the source backup is located in a different instance 
      
 CopyBackupRequest request =
         CopyBackupRequest.of(sourceClusterId, sourceBackupId)
             .setSourceInstance(sourceInstanceId)
             .setDestination(clusterId, backupId)
             .setExpireTime(expireTime);
 Backup response = client.copyBackup(request);
      If the source backup is located in a different project 
      
 CopyBackupRequest request =
         CopyBackupRequest.of(sourceClusterId, sourceBackupId)
             .setSourceInstance(sourceProjectId, sourceInstanceId)
             .setDestination(clusterId, backupId)
             .setExpireTime(expireTime);
 Backup response = client.copyBackup(request);

    • copyBackupAsync

      public com.google.api.core.ApiFuture<Backup> copyBackupAsync(CopyBackupRequest request)
      Creates a copy of a backup from an existing backup in a Cloud Bigtable cluster with the specified configuration asynchronously.

      Sample code 

      
 CopyBackupRequest request =
         CopyBackupRequest.of(sourceClusterId, sourceBackupId)
             .setDestination(clusterId, backupId)
             .setExpireTime(expireTime);
 ApiFuture<Backup> future = client.copyBackupAsync(request);

 ApiFutures.addCallback(
   future,
   new ApiFutureCallback<Backup>() {
     public void onSuccess(Backup backup) {
       System.out.println("Successfully create the backup " + backup.getId());
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • awaitReplicationAsync

      public com.google.api.core.ApiFuture<Void> awaitReplicationAsync(String tableId)
      Returns a future that is resolved when replication has caught up to the point when this method was called. This allows callers to make sure that their mutations have been replicated across all of their clusters.

      Sample code: 

      
 ApiFuture<Void> replicationFuture = client.awaitReplicationAsync("my-table");

 ApiFutures.addCallback(
   replicationFuture,
   new ApiFutureCallback<Void>() {
     public void onSuccess(Table table) {
       System.out.println("All clusters are now consistent");
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor()
 );

    • getIamPolicy

      public com.google.cloud.Policy getIamPolicy(String tableId)
      Gets the IAM access control policy for the specified table.

      Sample code: 

      
 Policy policy = client.getIamPolicy("my-table");
 for(Map.Entry<Role, Set<Identity>> entry : policy.getBindings().entrySet()) {
   System.out.printf("Role: %s Identities: %s\n", entry.getKey(), entry.getValue());
 }
      See Also:

    • getIamPolicyAsync

      public com.google.api.core.ApiFuture<com.google.cloud.Policy> getIamPolicyAsync(String tableId)
      Asynchronously gets the IAM access control policy for the specified table.

      Sample code: 

      
 ApiFuture<Policy> policyFuture = client.getIamPolicyAsync("my-table");

 ApiFutures.addCallback(policyFuture,
   new ApiFutureCallback<Policy>() {
     public void onSuccess(Policy policy) {
       for (Entry<Role, Set<Identity>> entry : policy.getBindings().entrySet()) {
         System.out.printf("Role: %s Identities: %s\n", entry.getKey(), entry.getValue());
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor());
      See Also:

    • setIamPolicy

      public com.google.cloud.Policy setIamPolicy(String tableId, com.google.cloud.Policy policy)
      Replaces the IAM policy associated with the specified table.

      Sample code: 

      
 Policy newPolicy = client.setIamPolicy("my-table",
   Policy.newBuilder()
     .addIdentity(Role.of("bigtable.user"), Identity.user("[email protected]"))
     .addIdentity(Role.of("bigtable.admin"), Identity.group("[email protected]"))
     .build());
      See Also:

    • setIamPolicyAsync

      public com.google.api.core.ApiFuture<com.google.cloud.Policy> setIamPolicyAsync(String tableId, com.google.cloud.Policy policy)
      Asynchronously replaces the IAM policy associated with the specified table.

      Sample code: 

      
 ApiFuture<Policy> newPolicyFuture = client.setIamPolicyAsync("my-table",
   Policy.newBuilder()
     .addIdentity(Role.of("bigtable.user"), Identity.user("[email protected]"))
     .addIdentity(Role.of("bigtable.admin"), Identity.group("[email protected]"))
     .build());

 ApiFutures.addCallback(policyFuture,
   new ApiFutureCallback<Policy>() {
     public void onSuccess(Policy policy) {
       for (Entry<Role, Set<Identity>> entry : policy.getBindings().entrySet()) {
         System.out.printf("Role: %s Identities: %s\n", entry.getKey(), entry.getValue());
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor());
      See Also:

    • testIamPermission

      public List<String> testIamPermission(String tableId, String... permissions)
      Tests whether the caller has the given permissions for the specified table. Returns a subset of the specified permissions that the caller has.

      Sample code: 

      
 List<String> grantedPermissions = client.testIamPermission("my-table",
   "bigtable.tables.readRows", "bigtable.tables.mutateRows");
      System.out.println("Has read access: " + grantedPermissions.contains("bigtable.tables.readRows")); System.out.println("Has write access: " + grantedPermissions.contains("bigtable.tables.mutateRows"));
      See Also:

    • testIamPermissionAsync

      public com.google.api.core.ApiFuture<List<String>> testIamPermissionAsync(String tableId, String... permissions)
      Asynchronously tests whether the caller has the given permissions for the specified table. Returns a subset of the specified permissions that the caller has.

      Sample code: 

      
 ApiFuture<List<String>> grantedPermissionsFuture = client.testIamPermissionAsync("my-table",
   "bigtable.tables.readRows", "bigtable.tables.mutateRows");

 ApiFutures.addCallback(grantedPermissionsFuture,
   new ApiFutureCallback<List<String>>() {
     public void onSuccess(List<String> grantedPermissions) {
       System.out.println("Has read access: " + grantedPermissions.contains("bigtable.tables.readRows"));
       System.out.println("Has write access: " + grantedPermissions.contains("bigtable.tables.mutateRows"));
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor());
      See Also:

    • getBackupIamPolicy

      public com.google.cloud.Policy getBackupIamPolicy(String clusterId, String backupId)
      Gets the IAM access control policy for the specified backup.

      Sample code: 

      
 Policy policy = client.getBackupIamPolicy("my-cluster-id", "my-backup-id");
 for(Map.Entry<Role, Set<Identity>> entry : policy.getBindings().entrySet()) {
   System.out.printf("Role: %s Identities: %s\n", entry.getKey(), entry.getValue());
 }
      See Also:

    • getBackupIamPolicyAsync

      public com.google.api.core.ApiFuture<com.google.cloud.Policy> getBackupIamPolicyAsync(String clusterId, String backupId)
      Asynchronously gets the IAM access control policy for the specified backup.

      Sample code: 

      
 ApiFuture<Policy> policyFuture = client.getBackupIamPolicyAsync("my-cluster-id", "my-backup-id");

 ApiFutures.addCallback(policyFuture,
   new ApiFutureCallback<Policy>() {
     public void onSuccess(Policy policy) {
       for (Entry<Role, Set<Identity>> entry : policy.getBindings().entrySet()) {
         System.out.printf("Role: %s Identities: %s\n", entry.getKey(), entry.getValue());
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor());
      See Also:

    • setBackupIamPolicy

      public com.google.cloud.Policy setBackupIamPolicy(String clusterId, String backupId, com.google.cloud.Policy policy)
      Replaces the IAM policy associated with the specified backup.

      Sample code: 

      
 Policy newPolicy = client.setBackupIamPolicy("my-cluster-id", "my-backup-id",
   Policy.newBuilder()
     .addIdentity(Role.of("bigtable.user"), Identity.user("[email protected]"))
     .addIdentity(Role.of("bigtable.admin"), Identity.group("[email protected]"))
     .build());
      See Also:

    • setBackupIamPolicyAsync

      public com.google.api.core.ApiFuture<com.google.cloud.Policy> setBackupIamPolicyAsync(String clusterId, String backupId, com.google.cloud.Policy policy)
      Asynchronously replaces the IAM policy associated with the specified backup.

      Sample code: 

      
 ApiFuture<Policy> newPolicyFuture = client.setBackupIamPolicyAsync("my-cluster-id", "my-backup-id",
   Policy.newBuilder()
     .addIdentity(Role.of("bigtable.user"), Identity.user("[email protected]"))
     .addIdentity(Role.of("bigtable.admin"), Identity.group("[email protected]"))
     .build());

 ApiFutures.addCallback(newPolicyFuture,
   new ApiFutureCallback<Policy>() {
     public void onSuccess(Policy policy) {
       for (Entry<Role, Set<Identity>> entry : policy.getBindings().entrySet()) {
         System.out.printf("Role: %s Identities: %s\n", entry.getKey(), entry.getValue());
       }
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor());
      See Also:

    • testBackupIamPermission

      public List<String> testBackupIamPermission(String clusterId, String backupId, String... permissions)
      Tests whether the caller has the given permissions for the specified backup. Returns a subset of the specified permissions that the caller has.

      Sample code: 

      
 List<String> grantedPermissions = client.testBackupIamPermission("my-cluster-id", "my-backup-id",
   "bigtable.backups.restore", "bigtable.backups.delete");
      System.out.println("Has restore access: " + grantedPermissions.contains("bigtable.backups.restore"));

      System.out.println("Has delete access: " + grantedPermissions.contains("bigtable.backups.delete"));

      See Also:

    • testBackupIamPermissionAsync

      public com.google.api.core.ApiFuture<List<String>> testBackupIamPermissionAsync(String clusterId, String backupId, String... permissions)
      Asynchronously tests whether the caller has the given permissions for the specified backup. Returns a subset of the specified permissions that the caller has.

      Sample code: 

      
 ApiFuture<List<String>> grantedPermissionsFuture = client.testBackupIamPermissionAsync("my-cluster-id", "my-backup-id",
   "bigtable.backups.restore", "bigtable.backups.delete");

 ApiFutures.addCallback(grantedPermissionsFuture,
   new ApiFutureCallback<List<String>>() {
     public void onSuccess(List<String> grantedPermissions) {
       System.out.println("Has restore access: " + grantedPermissions.contains("bigtable.backups.restore"));
       System.out.println("Has delete access: " + grantedPermissions.contains("bigtable.backups.delete"));
     }

     public void onFailure(Throwable t) {
       t.printStackTrace();
     }
   },
   MoreExecutors.directExecutor());
      See Also: