[SPARK-45880][SQL] Make the like pattern semantics used in all commands consistent

sql/catalyst/src/main/java/org/apache/spark/sql/connector/catalog/TableCatalog.java

@@ -17,7 +17,16 @@
 
 package org.apache.spark.sql.connector.catalog;
 
+import java.util.Arrays;
+import java.util.Collections;
+import java.util.List;
+import java.util.Map;
+import java.util.Set;
+
+import scala.jdk.javaapi.CollectionConverters;
+
 import org.apache.spark.annotation.Evolving;
+import org.apache.spark.sql.catalyst.util.StringUtils;
 import org.apache.spark.sql.connector.expressions.Transform;
 import org.apache.spark.sql.catalyst.analysis.NoSuchNamespaceException;
 import org.apache.spark.sql.catalyst.analysis.NoSuchTableException;
@@ -26,10 +35,6 @@
 import org.apache.spark.sql.errors.QueryExecutionErrors;
 import org.apache.spark.sql.types.StructType;
 
-import java.util.Collections;
-import java.util.Map;
-import java.util.Set;
-
 /**
  * Catalog methods for working with Tables.
  * <p>
@@ -97,6 +102,26 @@ public interface TableCatalog extends CatalogPlugin {
    */
   Identifier[] listTables(String[] namespace) throws NoSuchNamespaceException;
 
+  /**
+   * List the tables in a namespace from the catalog by pattern string.
+   * <p>
+   * If the catalog supports views, this must return identifiers for only tables and not views.
+   *
+   * @param namespace a multi-part namespace
+   * @param pattern the filter pattern, only '*' and '|' are allowed as wildcards, others will
+   *                follow regular expression convention, case-insensitive match and white spaces
+   *                on both ends will be ignored
+   * @return an array of Identifiers for tables
+   * @throws NoSuchNamespaceException If the namespace does not exist (optional).
+   */
+  default Identifier[] listTables(String[] namespace, String pattern)
+      throws NoSuchNamespaceException {
+    List<String> tableNames = Arrays.stream(listTables(namespace)).map(Identifier::name).toList();
+    return CollectionConverters.asJava(StringUtils.filterPattern(
+        CollectionConverters.asScala(tableNames).toSeq(), pattern)).stream().map(
+            name -> Identifier.of(namespace, name)).toArray(Identifier[]::new);
+  }
+
   /**
    * Load table metadata by {@link Identifier identifier} from the catalog.
    * <p>

sql/catalyst/src/test/scala/org/apache/spark/sql/connector/catalog/CatalogSuite.scala

@@ -96,6 +96,35 @@ class CatalogSuite extends SparkFunSuite {
     assert(catalog.listTables(Array("ns2")).toSet == Set(ident3))
   }
 
+  test("listTables by pattern") {
+    val catalog = newCatalog()
+    val ident1 = Identifier.of(Array("ns"), "test_table_1")
+    val ident2 = Identifier.of(Array("ns"), "test_table_2")
+    val ident3 = Identifier.of(Array("ns2"), "test_table_1")
+
+    intercept[NoSuchNamespaceException](catalog.listTables(Array("ns", "*test*")))
+
+    catalog.createTable(ident1, schema, emptyTrans, emptyProps)
+
+    assert(catalog.listTables(Array("ns"), "*test*").toSet == Set(ident1))
+    intercept[NoSuchNamespaceException](catalog.listTables(Array("ns2"), "*test*"))
+
+    catalog.createTable(ident3, schema, emptyTrans, emptyProps)
+    catalog.createTable(ident2, schema, emptyTrans, emptyProps)
+
+    assert(catalog.listTables(Array("ns"), "*test*").toSet == Set(ident1, ident2))
+    assert(catalog.listTables(Array("ns2"), "*test*").toSet == Set(ident3))
+
+    catalog.dropTable(ident1)
+
+    assert(catalog.listTables(Array("ns"), "*test*").toSet == Set(ident2))
+
+    catalog.dropTable(ident2)
+
+    assert(catalog.listTables(Array("ns"), "*test*").isEmpty)
+    assert(catalog.listTables(Array("ns2"), "*test*").toSet == Set(ident3))
+  }
+
   test("createTable") {
     val catalog = newCatalog()