Add support for wildcard_query function

docs/user/dql/functions.rst

@@ -3137,17 +3137,17 @@ Description
 
 ``wildcard_query(field_expression, query_expression[, option=<option_value>]*)``
 
-The wildcard_query function maps to the wildcard_query query used in search engine. It returns documents that match provided text in the specified field.
-Supported wildcard characters can be found here: https://opensearch.org/docs/latest/opensearch/query-dsl/term/#wildcards
-SQL wildcard % is converted to * as well as _ to ?. You may include % and _ in the search by escaping with a backslash prefix.
+The `wildcard_query` function maps to the `wildcard_query` query used in search engine. It returns documents that match provided text in the specified field.
+OpenSearch supports wildcard characters `*` and `?`.  See the full description here: https://opensearch.org/docs/latest/opensearch/query-dsl/term/#wildcards.
+SQL wildcard character `%` is converted to `*`. SQL character wildcard `_` is converted to `?`. You may include a backslash `\` to escape wildcard characters.
 
 Available parameters include:
 
 - boost
 - case_insensitive
 - rewrite
 
-For backward compatibility, wildcardquery is also supported and mapped to wildcard_query query as well.
+For backward compatibility, `wildcardquery` is also supported and mapped to `wildcard_query` query as well.
 
 Example with only ``field`` and ``query`` expressions, and all other parameters are set default values::
 
@@ -3180,3 +3180,4 @@ Another example to show how to set custom values for the optional parameters::
     | test wildcard in _ the middle of the text |
     | test wildcard __ beside each other        |
     +-------------------------------------------+
+

integ-test/src/test/java/org/opensearch/sql/ppl/LikeQueryIT.java

@@ -0,0 +1,88 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+
+package org.opensearch.sql.ppl;
+
+import static org.opensearch.sql.legacy.TestsConstants.TEST_INDEX_WILDCARD;
+import static org.opensearch.sql.util.MatcherUtils.rows;
+import static org.opensearch.sql.util.MatcherUtils.verifyDataRows;
+
+import java.io.IOException;
+import org.json.JSONObject;
+import org.junit.Test;
+
+public class LikeQueryIT extends PPLIntegTestCase {
+
+  @Override
+  public void init() throws IOException {
+    loadIndex(Index.WILDCARD);
+  }
+
+  @Test
+  public void test_like_with_percent() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(KeywordBody, 'test wildcard%') | fields KeywordBody";
+    JSONObject result = executeQuery(query);
+    verifyDataRows(result,
+        rows("test wildcard"),
+        rows("test wildcard in the end of the text%"),
+        rows("test wildcard in % the middle of the text"),
+        rows("test wildcard %% beside each other"),
+        rows("test wildcard in the end of the text_"),
+        rows("test wildcard in _ the middle of the text"),
+        rows("test wildcard __ beside each other"));
+  }
+
+  @Test
+  public void test_like_with_escaped_percent() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(KeywordBody, '\\\\%test wildcard%') | fields KeywordBody";
+    JSONObject result = executeQuery(query);
+    verifyDataRows(result,
+        rows("%test wildcard in the beginning of the text"));
+  }
+
+  @Test
+  public void test_like_in_where_with_escaped_underscore() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(KeywordBody, '\\\\_test wildcard%') | fields KeywordBody";
+    JSONObject result = executeQuery(query);
+    verifyDataRows(result,
+        rows("_test wildcard in the beginning of the text"));
+  }
+
+  @Test
+  public void test_like_on_text_field_with_one_word() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(TextBody, 'test*') | fields TextBody";
+    JSONObject result = executeQuery(query);
+    assertEquals(9, result.getInt("total"));
+  }
+
+  @Test
+  public void test_like_on_text_keyword_field_with_one_word() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(TextKeywordBody, 'test*') | fields TextKeywordBody";
+    JSONObject result = executeQuery(query);
+    assertEquals(8, result.getInt("total"));
+  }
+
+  @Test
+  public void test_like_on_text_keyword_field_with_greater_than_one_word() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(TextKeywordBody, 'test wild*') | fields TextKeywordBody";
+    JSONObject result = executeQuery(query);
+    assertEquals(7, result.getInt("total"));
+  }
+
+  @Test
+  public void test_like_on_text_field_with_greater_than_one_word() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(TextBody, 'test wild*') | fields TextBody";
+    JSONObject result = executeQuery(query);
+    assertEquals(0, result.getInt("total"));
+  }
+
+  @Test
+  public void test_convert_field_text_to_keyword() throws IOException {
+    String query = "source=" + TEST_INDEX_WILDCARD + " | WHERE Like(TextKeywordBody, '*') | fields TextKeywordBody";
+    String result = explainQueryToString(query);
+    assertTrue(result.contains("TextKeywordBody.keyword"));
+  }
+}

integ-test/src/test/java/org/opensearch/sql/sql/LikeQueryIT.java

@@ -0,0 +1,140 @@
+/*
+ * Copyright OpenSearch Contributors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+
+
+package org.opensearch.sql.sql;
+
+import org.json.JSONObject;
+import org.junit.Test;
+import org.opensearch.sql.legacy.SQLIntegTestCase;
+
+import java.io.IOException;
+
+import static org.opensearch.sql.legacy.TestsConstants.TEST_INDEX_WILDCARD;
+import static org.opensearch.sql.util.MatcherUtils.rows;
+import static org.opensearch.sql.util.MatcherUtils.verifyDataRows;
+
+public class LikeQueryIT extends SQLIntegTestCase {
+  @Override
+  protected void init() throws Exception {
+    loadIndex(Index.WILDCARD);
+  }
+
+  @Test
+  public void test_like_in_select() throws IOException {
+    String query = "SELECT KeywordBody, KeywordBody LIKE 'test wildcard%' FROM " + TEST_INDEX_WILDCARD;
+    JSONObject result = executeJdbcRequest(query);
+    verifyDataRows(result,
+        rows("test wildcard", true),
+        rows("test wildcard in the end of the text%", true),
+        rows("%test wildcard in the beginning of the text", false),
+        rows("test wildcard in % the middle of the text", true),
+        rows("test wildcard %% beside each other", true),
+        rows("test wildcard in the end of the text_", true),
+        rows("_test wildcard in the beginning of the text", false),
+        rows("test wildcard in _ the middle of the text", true),
+        rows("test wildcard __ beside each other", true),
+        rows("test backslash wildcard \\_", false));
+  }
+
+  @Test
+  public void test_like_in_select_with_escaped_percent() throws IOException {
+    String query = "SELECT KeywordBody, KeywordBody LIKE '\\\\%test wildcard%' FROM " + TEST_INDEX_WILDCARD;
+    JSONObject result = executeJdbcRequest(query);
+    verifyDataRows(result,
+        rows("test wildcard", false),
+        rows("test wildcard in the end of the text%", false),
+        rows("%test wildcard in the beginning of the text", true),
+        rows("test wildcard in % the middle of the text", false),
+        rows("test wildcard %% beside each other", false),
+        rows("test wildcard in the end of the text_", false),
+        rows("_test wildcard in the beginning of the text", false),
+        rows("test wildcard in _ the middle of the text", false),
+        rows("test wildcard __ beside each other", false),
+        rows("test backslash wildcard \\_", false));
+  }
+
+  @Test
+  public void test_like_in_select_with_escaped_underscore() throws IOException {
+    String query = "SELECT KeywordBody, KeywordBody LIKE '\\\\_test wildcard%' FROM " + TEST_INDEX_WILDCARD;
+    JSONObject result = executeJdbcRequest(query);
+    verifyDataRows(result,
+        rows("test wildcard", false),
+        rows("test wildcard in the end of the text%", false),
+        rows("%test wildcard in the beginning of the text", false),
+        rows("test wildcard in % the middle of the text", false),
+        rows("test wildcard %% beside each other", false),
+        rows("test wildcard in the end of the text_", false),
+        rows("_test wildcard in the beginning of the text", true),
+        rows("test wildcard in _ the middle of the text", false),
+        rows("test wildcard __ beside each other", false),
+        rows("test backslash wildcard \\_", false));
+  }
+
+  @Test
+  public void test_like_in_where() throws IOException {
+    String query = "SELECT KeywordBody FROM " + TEST_INDEX_WILDCARD + " WHERE KeywordBody LIKE 'test wildcard%'";
+    JSONObject result = executeJdbcRequest(query);
+    verifyDataRows(result,
+        rows("test wildcard"),
+        rows("test wildcard in the end of the text%"),
+        rows("test wildcard in % the middle of the text"),
+        rows("test wildcard %% beside each other"),
+        rows("test wildcard in the end of the text_"),
+        rows("test wildcard in _ the middle of the text"),
+        rows("test wildcard __ beside each other"));
+  }
+
+  @Test
+  public void test_like_in_where_with_escaped_percent() throws IOException {
+    String query = "SELECT KeywordBody FROM " + TEST_INDEX_WILDCARD + " WHERE KeywordBody LIKE '\\\\%test wildcard%'";
+    JSONObject result = executeJdbcRequest(query);
+    verifyDataRows(result,
+        rows("%test wildcard in the beginning of the text"));
+  }
+
+  @Test
+  public void test_like_in_where_with_escaped_underscore() throws IOException {
+    String query = "SELECT KeywordBody FROM " + TEST_INDEX_WILDCARD + " WHERE KeywordBody LIKE '\\\\_test wildcard%'";
+    JSONObject result = executeJdbcRequest(query);
+    verifyDataRows(result,
+        rows("_test wildcard in the beginning of the text"));
+  }
+
+  @Test
+  public void test_like_on_text_field_with_one_word() throws IOException {
+    String query = "SELECT * FROM " + TEST_INDEX_WILDCARD + " WHERE TextBody LIKE 'test*'";
+    JSONObject result = executeJdbcRequest(query);
+    assertEquals(9, result.getInt("total"));
+  }
+
+  @Test
+  public void test_like_on_text_keyword_field_with_one_word() throws IOException {
+    String query = "SELECT * FROM " + TEST_INDEX_WILDCARD + " WHERE TextKeywordBody LIKE 'test*'";
+    JSONObject result = executeJdbcRequest(query);
+    assertEquals(8, result.getInt("total"));
+  }
+
+  @Test
+  public void test_like_on_text_keyword_field_with_greater_than_one_word() throws IOException {
+    String query = "SELECT * FROM " + TEST_INDEX_WILDCARD + " WHERE TextKeywordBody LIKE 'test wild*'";
+    JSONObject result = executeJdbcRequest(query);
+    assertEquals(7, result.getInt("total"));
+  }
+
+  @Test
+  public void test_like_on_text_field_with_greater_than_one_word() throws IOException {
+    String query = "SELECT * FROM " + TEST_INDEX_WILDCARD + " WHERE TextBody LIKE 'test wild*'";
+    JSONObject result = executeJdbcRequest(query);
+    assertEquals(0, result.getInt("total"));
+  }
+
+  @Test
+  public void test_convert_field_text_to_keyword() throws IOException {
+    String query = "SELECT * FROM " + TEST_INDEX_WILDCARD + " WHERE TextKeywordBody LIKE '*'";
+    String result = explainQuery(query);
+    assertTrue(result.contains("TextKeywordBody.keyword"));
+  }
+}