samples(bigtable): migrate all admin snippets and tests to modern V2 clients (#13392)

This PR migrates all remaining admin-related snippets and tests under
`java-bigtable/samples/snippets` to utilize the modern
`BigtableTableAdminClientV2` and `BigtableInstanceAdminClientV2`, fully
phasing out legacy V1 admin clients and `.getBaseClient()` references.

### Migrated Samples & Tests:
- **Primary Admin Samples**:
  - `HelloWorld.java` & `HelloWorldTest.java`
  - `InstanceAdminExample.java` & `InstanceAdminExampleTest.java`
  - `TableAdminExample.java` & `TableAdminExampleTest.java`
- **Secondary Admin Samples**:
  - `AuthorizedViewExample.java` & `AuthorizedViewExampleTest.java`
  - `SchemaBundleExample.java` & `SchemaBundleExampleTest.java`
  - `QuickstartTest.java`
  - `MobileTimeSeriesBaseTest.java`
  - `deletes/DeleteTableExample.java`
  - `deletes/DeleteColumnFamilyExample.java`
  - `deletes/DropRowRangeExample.java`
  - `deletes/DeletesTest.java`

### Key Improvements:
1. Replaced all raw `.getBaseClient()` escape-hatch calls.
2. Replaced deprecated V1 `.exists(...)` and `exists(tableId)` calls
with V2 `getTable` / `getInstance` try-catch blocks.
3. Updated nested models `SubsetView` and `FamilySubsets` to use the V2
protobuf-generated inner classes `AuthorizedView.SubsetView` and
`AuthorizedView.FamilySubsets`.
4. Correctly constructed the `ProtoSchema` wrapper when building and
parsing schema bundles in `SchemaBundleExample.java`.
5. Simplified column family presence checks by directly inspecting the
keys of `table.getColumnFamiliesMap()`, completely eliminating legacy
custom Truth correspondence helpers.

All files are formatted using `spotify:fmt` and compile cleanly (`BUILD
SUCCESS`).

---------

Co-authored-by: cloud-java-bot <cloud-java-bot@google.com>

Author: jinseopkim0

java-bigtable/google-cloud-bigtable/src/main/java/com/google/cloud/bigtable/admin/v2/BigtableInstanceAdminClientV2.java

@@ -35,6 +35,11 @@ protected BigtableInstanceAdminClientV2(BigtableInstanceAdminStub stub) {
     super(stub);
   }
 
+  /** Constructs an instance of BigtableInstanceAdminClientV2 with default settings. */
+  public static final BigtableInstanceAdminClientV2 create() throws IOException {
+    return create(BaseBigtableInstanceAdminSettings.newBuilder().build());
+  }
+
   /** Constructs an instance of BigtableInstanceAdminClientV2 with the given settings. */
   public static final BigtableInstanceAdminClientV2 create(
       BaseBigtableInstanceAdminSettings settings) throws IOException {

java-bigtable/google-cloud-bigtable/src/main/java/com/google/cloud/bigtable/admin/v2/BigtableTableAdminClientV2.java

@@ -88,6 +88,11 @@ public class BigtableTableAdminClientV2 extends BaseBigtableTableAdminClient {
           .setTotalTimeoutDuration(Duration.ofMillis(600000L))
           .build();
 
+  /** Constructs an instance of BigtableTableAdminClientV2 with default settings. */
+  public static final BigtableTableAdminClientV2 create() throws IOException {
+    return create(BaseBigtableTableAdminSettings.newBuilder().build());
+  }
+
   /** Constructs an instance of BigtableTableAdminClientV2 with the given settings. */
   public static final BigtableTableAdminClientV2 create(BaseBigtableTableAdminSettings settings)
       throws IOException {

java-bigtable/samples/snippets/src/main/java/com/example/bigtable/AuthorizedViewExample.java

@@ -21,15 +21,16 @@
 import com.google.api.gax.rpc.NotFoundException;
 import com.google.api.gax.rpc.PermissionDeniedException;
 import com.google.api.gax.rpc.ServerStream;
-import com.google.cloud.bigtable.admin.v2.BigtableTableAdminClient;
-import com.google.cloud.bigtable.admin.v2.BigtableTableAdminSettings;
-import com.google.cloud.bigtable.admin.v2.models.AuthorizedView;
-import com.google.cloud.bigtable.admin.v2.models.CreateAuthorizedViewRequest;
-import com.google.cloud.bigtable.admin.v2.models.CreateTableRequest;
-import com.google.cloud.bigtable.admin.v2.models.FamilySubsets;
-import com.google.cloud.bigtable.admin.v2.models.SubsetView;
-import com.google.cloud.bigtable.admin.v2.models.Table;
-import com.google.cloud.bigtable.admin.v2.models.UpdateAuthorizedViewRequest;
+import com.google.bigtable.admin.v2.AuthorizedView;
+import com.google.bigtable.admin.v2.AuthorizedViewName;
+import com.google.bigtable.admin.v2.ColumnFamily;
+import com.google.bigtable.admin.v2.CreateAuthorizedViewRequest;
+import com.google.bigtable.admin.v2.CreateTableRequest;
+import com.google.bigtable.admin.v2.GetTableRequest;
+import com.google.bigtable.admin.v2.ListAuthorizedViewsRequest;
+import com.google.bigtable.admin.v2.Table;
+import com.google.bigtable.admin.v2.UpdateAuthorizedViewRequest;
+import com.google.cloud.bigtable.admin.v2.BigtableTableAdminClientV2;
 import com.google.cloud.bigtable.data.v2.BigtableDataClient;
 import com.google.cloud.bigtable.data.v2.BigtableDataSettings;
 import com.google.cloud.bigtable.data.v2.models.AuthorizedViewId;
@@ -39,6 +40,7 @@
 import com.google.cloud.bigtable.data.v2.models.RowCell;
 import com.google.cloud.bigtable.data.v2.models.RowMutation;
 import com.google.protobuf.ByteString;
+import com.google.protobuf.FieldMask;
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.List;
@@ -50,9 +52,11 @@ public class AuthorizedViewExample {
   private static final String COLUMN_QUALIFIER_GREETING = "greeting";
   private static final String COLUMN_QUALIFIER_NAME = "name";
   private static final String ROW_KEY_PREFIX = "rowKey";
+  private final String projectId;
+  private final String instanceId;
   private final String tableId;
   private final String authorizedViewId;
-  private final BigtableTableAdminClient adminClient;
+  private final BigtableTableAdminClientV2 adminClient;
   private final BigtableDataClient dataClient;
 
   public static void main(String[] args) throws IOException {
@@ -72,6 +76,8 @@ public static void main(String[] args) throws IOException {
   public AuthorizedViewExample(
       String projectId, String instanceId, String tableId, String authorizedViewId)
       throws IOException {
+    this.projectId = projectId;
+    this.instanceId = instanceId;
     this.tableId = tableId;
     this.authorizedViewId = authorizedViewId;
 
@@ -82,15 +88,21 @@ public AuthorizedViewExample(
     // Creates a bigtable data client.
     dataClient = BigtableDataClient.create(settings);
 
-    // Creates the settings to configure a bigtable table admin client.
-    BigtableTableAdminSettings adminSettings =
-        BigtableTableAdminSettings.newBuilder()
-            .setProjectId(projectId)
-            .setInstanceId(instanceId)
-            .build();
-
     // Creates a bigtable table admin client.
-    adminClient = BigtableTableAdminClient.create(adminSettings);
+    adminClient = BigtableTableAdminClientV2.create();
+  }
+
+  private boolean exists(String tableId) {
+    try {
+      adminClient.getTable(
+          GetTableRequest.newBuilder()
+              .setName("projects/" + projectId + "/instances/" + instanceId + "/tables/" + tableId)
+              .setView(Table.View.NAME_ONLY)
+              .build());
+      return true;
+    } catch (NotFoundException e) {
+      return false;
+    }
   }
 
   public void close() {
@@ -114,20 +126,28 @@ public void run() {
 
   public void createTable() {
     // Checks if table exists, creates table if it does not exist.
-    if (!adminClient.exists(tableId)) {
+    if (!exists(tableId)) {
       System.out.println("Table does not exist, creating table: " + tableId);
-      CreateTableRequest createTableRequest =
-          CreateTableRequest.of(tableId).addFamily(COLUMN_FAMILY);
-      Table table = adminClient.createTable(createTableRequest);
-      System.out.printf("Table: %s created successfully%n", table.getId());
+      CreateTableRequest request =
+          CreateTableRequest.newBuilder()
+              .setParent("projects/" + projectId + "/instances/" + instanceId)
+              .setTableId(tableId)
+              .setTable(
+                  Table.newBuilder()
+                      .putColumnFamilies(COLUMN_FAMILY, ColumnFamily.getDefaultInstance())
+                      .build())
+              .build();
+      Table table = adminClient.createTable(request);
+      System.out.printf("Table: %s created successfully%n", table.getName());
     }
   }
 
   public void deleteTable() {
     // Deletes the entire table.
     System.out.println("\nDelete table: " + tableId);
     try {
-      adminClient.deleteTable(tableId);
+      adminClient.deleteTable(
+          "projects/" + projectId + "/instances/" + instanceId + "/tables/" + tableId);
       System.out.printf("Table: %s deleted successfully%n", tableId);
     } catch (NotFoundException e) {
       System.err.println("Failed to delete a non-existent table: " + e.getMessage());
@@ -140,24 +160,41 @@ public void deleteTable() {
   public void createAuthorizedView() {
     // Checks if the authorized view exists, creates it if it does not exist.
     try {
-      adminClient.getAuthorizedView(tableId, authorizedViewId);
+      adminClient.getAuthorizedView(
+          "projects/"
+              + projectId
+              + "/instances/"
+              + instanceId
+              + "/tables/"
+              + tableId
+              + "/authorizedViews/"
+              + authorizedViewId);
     } catch (NotFoundException exception) {
       System.out.printf("%nCreating authorized view %s in table %s%n", authorizedViewId, tableId);
       // [START bigtable_create_authorized_view]
       try {
+        AuthorizedView.SubsetView subsetView =
+            AuthorizedView.SubsetView.newBuilder()
+                .addRowPrefixes(ByteString.EMPTY)
+                .putFamilySubsets(
+                    COLUMN_FAMILY,
+                    AuthorizedView.FamilySubsets.newBuilder()
+                        .addQualifierPrefixes(ByteString.copyFromUtf8(COLUMN_QUALIFIER_NAME))
+                        .build())
+                .build();
+        AuthorizedView authorizedViewObj =
+            AuthorizedView.newBuilder().setSubsetView(subsetView).build();
         CreateAuthorizedViewRequest request =
-            CreateAuthorizedViewRequest.of(tableId, authorizedViewId)
-                .setAuthorizedViewType(
-                    SubsetView.create()
-                        .addRowPrefix("")
-                        .setFamilySubsets(
-                            COLUMN_FAMILY,
-                            FamilySubsets.create().addQualifierPrefix(COLUMN_QUALIFIER_NAME)));
-        AuthorizedView authorizedView = adminClient.createAuthorizedView(request);
-        System.out.printf("AuthorizedView: %s created successfully%n", authorizedView.getId());
-      } catch (NotFoundException e) {
-        System.err.println(
-            "Failed to create an authorized view from a non-existent table: " + e.getMessage());
+            CreateAuthorizedViewRequest.newBuilder()
+                .setParent(
+                    "projects/" + projectId + "/instances/" + instanceId + "/tables/" + tableId)
+                .setAuthorizedViewId(authorizedViewId)
+                .setAuthorizedView(authorizedViewObj)
+                .build();
+        AuthorizedView authorizedView = adminClient.createAuthorizedViewAsync(request).get();
+        System.out.printf("AuthorizedView: %s created successfully%n", authorizedView.getName());
+      } catch (Exception e) {
+        System.err.println("Failed to create an authorized view: " + e.getMessage());
       }
       // [END bigtable_create_authorized_view]
     }
@@ -169,17 +206,37 @@ public void updateAuthorizedView() {
     // [START bigtable_update_authorized_view]
     try {
       // Update to an authorized view permitting everything.
+      AuthorizedView.SubsetView subsetView =
+          AuthorizedView.SubsetView.newBuilder()
+              .addRowPrefixes(ByteString.EMPTY)
+              .putFamilySubsets(
+                  COLUMN_FAMILY,
+                  AuthorizedView.FamilySubsets.newBuilder()
+                      .addQualifierPrefixes(ByteString.EMPTY)
+                      .build())
+              .build();
+      AuthorizedView authorizedViewObj =
+          AuthorizedView.newBuilder()
+              .setSubsetView(subsetView)
+              .setName(
+                  "projects/"
+                      + projectId
+                      + "/instances/"
+                      + instanceId
+                      + "/tables/"
+                      + tableId
+                      + "/authorizedViews/"
+                      + authorizedViewId)
+              .build();
       UpdateAuthorizedViewRequest request =
-          UpdateAuthorizedViewRequest.of(tableId, authorizedViewId)
-              .setAuthorizedViewType(
-                  SubsetView.create()
-                      .addRowPrefix("")
-                      .setFamilySubsets(
-                          COLUMN_FAMILY, FamilySubsets.create().addQualifierPrefix("")));
-      AuthorizedView authorizedView = adminClient.updateAuthorizedView(request);
-      System.out.printf("AuthorizedView: %s updated successfully%n", authorizedView.getId());
-    } catch (NotFoundException e) {
-      System.err.println("Failed to modify a non-existent authorized view: " + e.getMessage());
+          UpdateAuthorizedViewRequest.newBuilder()
+              .setAuthorizedView(authorizedViewObj)
+              .setUpdateMask(FieldMask.newBuilder().addPaths("subset_view").build())
+              .build();
+      AuthorizedView authorizedView = adminClient.updateAuthorizedViewAsync(request).get();
+      System.out.printf("AuthorizedView: %s updated successfully%n", authorizedView.getName());
+    } catch (Exception e) {
+      System.err.println("Failed to modify authorized view: " + e.getMessage());
     }
     // [END bigtable_update_authorized_view]
   }
@@ -190,19 +247,29 @@ public AuthorizedView getAuthorizedView() {
     // [START bigtable_get_authorized_view]
     AuthorizedView authorizedView = null;
     try {
-      authorizedView = adminClient.getAuthorizedView(tableId, authorizedViewId);
-      SubsetView subsetView = (SubsetView) authorizedView.getAuthorizedViewType();
+      authorizedView =
+          adminClient.getAuthorizedView(
+              "projects/"
+                  + projectId
+                  + "/instances/"
+                  + instanceId
+                  + "/tables/"
+                  + tableId
+                  + "/authorizedViews/"
+                  + authorizedViewId);
+      AuthorizedView.SubsetView subsetView = authorizedView.getSubsetView();
 
-      for (ByteString rowPrefix : subsetView.getRowPrefixes()) {
+      for (ByteString rowPrefix : subsetView.getRowPrefixesList()) {
         System.out.printf("Row Prefix: %s%n", rowPrefix.toStringUtf8());
       }
-      for (Map.Entry<String, FamilySubsets> entry : subsetView.getFamilySubsets().entrySet()) {
-        for (ByteString qualifierPrefix : entry.getValue().getQualifierPrefixes()) {
+      for (Map.Entry<String, AuthorizedView.FamilySubsets> entry :
+          subsetView.getFamilySubsetsMap().entrySet()) {
+        for (ByteString qualifierPrefix : entry.getValue().getQualifierPrefixesList()) {
           System.out.printf(
               "Column Family: %s, Qualifier Prefix: %s%n",
               entry.getKey(), qualifierPrefix.toStringUtf8());
         }
-        for (ByteString qualifier : entry.getValue().getQualifiers()) {
+        for (ByteString qualifier : entry.getValue().getQualifiersList()) {
           System.out.printf(
               "Column Family: %s, Qualifier: %s%n", entry.getKey(), qualifier.toStringUtf8());
         }
@@ -221,9 +288,15 @@ public List<String> listAllAuthorizedViews() {
     // [START bigtable_list_authorized_views]
     List<String> authorizedViewIds = new ArrayList<>();
     try {
-      authorizedViewIds = adminClient.listAuthorizedViews(tableId);
-      for (String authorizedViewId : authorizedViewIds) {
-        System.out.println(authorizedViewId);
+      ListAuthorizedViewsRequest request =
+          ListAuthorizedViewsRequest.newBuilder()
+              .setParent(
+                  "projects/" + projectId + "/instances/" + instanceId + "/tables/" + tableId)
+              .build();
+      for (AuthorizedView view : adminClient.listAuthorizedViews(request).iterateAll()) {
+        String id = AuthorizedViewName.parse(view.getName()).getAuthorizedView();
+        System.out.println(id);
+        authorizedViewIds.add(id);
       }
     } catch (NotFoundException e) {
       System.err.println(
@@ -238,7 +311,15 @@ public void deleteAuthorizedView() {
     System.out.printf("%nDeleting authorized view %s in table %s%n", authorizedViewId, tableId);
     // [START bigtable_delete_authorized_view]
     try {
-      adminClient.deleteAuthorizedView(tableId, authorizedViewId);
+      adminClient.deleteAuthorizedView(
+          "projects/"
+              + projectId
+              + "/instances/"
+              + instanceId
+              + "/tables/"
+              + tableId
+              + "/authorizedViews/"
+              + authorizedViewId);
       System.out.printf("AuthorizedView: %s deleted successfully%n", authorizedViewId);
     } catch (NotFoundException e) {
       System.err.println("Failed to delete a non-existent authorized view: " + e.getMessage());