[Feature] implement transpose command as in the roadmap opensearch-project#4786 (opensearch-project#5011)

* transpose command implementation

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* transpose rows to columns

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added argument type missing map and hashmap

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added tests

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added more validations

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added validation

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* index.md formatting fix

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* doc format

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* coderabbit review fixes

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added recommended changes

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added recommended changes

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* for cross cluster failure debugging

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* for cross cluster failure debugging

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* for cross cluster failure debugging

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* trim columnName

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* per review moved to class varialble.

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* per review moved to class varialble.

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* added field resolution

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* fix by removing metadata field

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

* fixed explain test after removing of metadata fields in transpose result

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>

---------

Signed-off-by: Asif Bashar <asif.bashar@gmail.com>
# Conflicts:
#	integ-test/src/test/java/org/opensearch/sql/ppl/NewAddedCommandsIT.java
#	ppl/src/main/antlr/OpenSearchPPLLexer.g4

Author: asifabashar

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

@@ -213,6 +213,7 @@ public void testTransposeCommand() throws IOException {
     }
   }
 
+
   @Test
   public void testFieldFormatCommand() throws IOException {
     JSONObject result;

integ-test/src/test/java/org/opensearch/sql/security/CrossClusterSearchIT.java

@@ -305,6 +305,24 @@ public void testCrossClusterTranspose() throws IOException {
         rows("age", "28", "36", "33"));
   }
 
+  @Test
+  public void testCrossClusterTranspose() throws IOException {
+    // Test query_string without fields parameter on remote cluster
+    JSONObject result =
+        executeQuery(
+            String.format(
+                "search source=%s | where  firstname='Hattie' or firstname ='Nanette' or"
+                    + " firstname='Dale'|sort firstname desc |fields firstname,age,balance |"
+                    + " transpose 3 column_name='column_names'",
+                TEST_INDEX_BANK_REMOTE));
+
+    verifyDataRows(
+        result,
+        rows("firstname", "Nanette", "Hattie", "Dale"),
+        rows("balance", "32838", "5686", "4180"),
+        rows("age", "28", "36", "33"));
+  }
+
   @Test
   public void testCrossClusterAppend() throws IOException {
     // TODO: We should enable calcite by default in CrossClusterSearchIT?

ppl/src/main/antlr/OpenSearchPPLLexer.g4

@@ -74,7 +74,6 @@ AGGREGATION:                        'AGGREGATION';
 APPENDPIPE:                         'APPENDPIPE';
 COLUMN_NAME:                        'COLUMN_NAME';
 
-
 //Native JOIN KEYWORDS
 JOIN:                               'JOIN';
 ON:                                 'ON';
@@ -161,7 +160,6 @@ INPUT:                              'INPUT';
 OUTPUT:                             'OUTPUT';
 PATH:                               'PATH';
 
-
 // COMPARISON FUNCTION KEYWORDS
 CASE:                               'CASE';
 ELSE:                               'ELSE';