feat: update studio supporting new HASH INDEX

Issue #3527

Author: lvca

engine/src/main/java/com/arcadedb/query/sql/parser/CreateIndexStatement.java

@@ -72,6 +72,10 @@ public void validate() throws CommandSQLParsingException {
     }
     case "GEOSPATIAL" -> {
     }
+    case "UNIQUE_HASH" -> {
+    }
+    case "NOTUNIQUE_HASH" -> {
+    }
     default -> throw new CommandSQLParsingException("Index type '" + typeAsString + "' is not supported");
     }
   }
@@ -110,6 +114,12 @@ else if (typeAsString.equalsIgnoreCase("UNIQUE")) {
     } else if (typeAsString.equalsIgnoreCase("GEOSPATIAL")) {
       indexType = Schema.INDEX_TYPE.GEOSPATIAL;
       unique = false;
+    } else if (typeAsString.equalsIgnoreCase("UNIQUE_HASH")) {
+      indexType = Schema.INDEX_TYPE.HASH;
+      unique = true;
+    } else if (typeAsString.equalsIgnoreCase("NOTUNIQUE_HASH")) {
+      indexType = Schema.INDEX_TYPE.HASH;
+      unique = false;
     } else
       throw new CommandSQLParsingException("Index type '" + typeAsString + "' is not supported");
 

engine/src/test/java/com/arcadedb/index/HashIndexTest.java

@@ -385,6 +385,71 @@ void transactionRollback() {
     });
   }
 
+  @Test
+  void sqlCreateUniqueHash() {
+    database.command("sql", "CREATE DOCUMENT TYPE SqlHashDoc");
+    database.command("sql", "CREATE PROPERTY SqlHashDoc.code INTEGER");
+    database.command("sql", "CREATE INDEX ON SqlHashDoc (code) UNIQUE_HASH");
+
+    database.transaction(() -> {
+      for (int i = 0; i < 100; ++i) {
+        final MutableDocument doc = database.newDocument("SqlHashDoc");
+        doc.set("code", i);
+        doc.save();
+      }
+    });
+
+    database.transaction(() -> {
+      final Index index = database.getSchema().getIndexByName("SqlHashDoc[code]");
+      assertThat(index.getType()).isEqualTo(Schema.INDEX_TYPE.HASH);
+      assertThat(index.isUnique()).isTrue();
+
+      for (int i = 0; i < 100; ++i) {
+        final IndexCursor cursor = index.get(new Object[] { i });
+        assertThat(cursor.hasNext()).isTrue();
+      }
+    });
+
+    // Duplicate rejection
+    assertThatThrownBy(() -> database.transaction(() -> {
+      final MutableDocument doc = database.newDocument("SqlHashDoc");
+      doc.set("code", 0);
+      doc.save();
+    })).isInstanceOf(DuplicatedKeyException.class);
+  }
+
+  @Test
+  void sqlCreateNotUniqueHash() {
+    database.command("sql", "CREATE DOCUMENT TYPE SqlHashNUDoc");
+    database.command("sql", "CREATE PROPERTY SqlHashNUDoc.tag STRING");
+    database.command("sql", "CREATE INDEX ON SqlHashNUDoc (tag) NOTUNIQUE_HASH");
+
+    database.transaction(() -> {
+      for (int i = 0; i < 50; ++i) {
+        final MutableDocument doc = database.newDocument("SqlHashNUDoc");
+        doc.set("tag", "group_" + (i % 5));
+        doc.save();
+      }
+    });
+
+    database.transaction(() -> {
+      final Index index = database.getSchema().getIndexByName("SqlHashNUDoc[tag]");
+      assertThat(index.getType()).isEqualTo(Schema.INDEX_TYPE.HASH);
+      assertThat(index.isUnique()).isFalse();
+
+      // Each group should have 10 entries
+      for (int g = 0; g < 5; ++g) {
+        final IndexCursor cursor = index.get(new Object[] { "group_" + g });
+        int count = 0;
+        while (cursor.hasNext()) {
+          cursor.next();
+          count++;
+        }
+        assertThat(count).isEqualTo(10);
+      }
+    });
+  }
+
   @Override
   protected void beginTest() {
     database.transaction(() -> {

studio/src/main/resources/static/js/studio-database.js

@@ -815,7 +815,8 @@ function createIndex(typeName) {
 
   html += "<label for='inputCreateIdxAlgorithm'>Index Algorithm <span style='color:#dc3545'>*</span></label>";
   html += "<select class='form-select mt-1 mb-3' id='inputCreateIdxAlgorithm'>";
-  html += "<option value='LSM_TREE' selected>LSM_TREE — default</option>";
+  html += "<option value='LSM_TREE' selected>LSM_TREE — default, supports range queries</option>";
+  html += "<option value='HASH'>HASH — O(1) equality lookups, no range queries</option>";
   html += "<option value='FULL_TEXT'>FULL_TEXT — full-text search index</option>";
   html += "<option value='LSM_VECTOR'>LSM_VECTOR — vector/embedding similarity index</option>";
   html += "</select>";
@@ -873,14 +874,20 @@ function createIndex(typeName) {
     let nullStrategy = $("#inputCreateIdxNullStrategy").val();
     let ifNotExists = $("#inputCreateIdxIfNotExists").prop("checked");
 
-    let indexTypeSql = algorithm == "LSM_TREE" ? (unique ? "UNIQUE" : "NOTUNIQUE") : algorithm;
+    let indexTypeSql;
+    if (algorithm == "LSM_TREE")
+      indexTypeSql = unique ? "UNIQUE" : "NOTUNIQUE";
+    else if (algorithm == "HASH")
+      indexTypeSql = unique ? "UNIQUE_HASH" : "NOTUNIQUE_HASH";
+    else
+      indexTypeSql = algorithm;
 
     let command = "CREATE INDEX";
     if (ifNotExists) command += " IF NOT EXISTS";
     command += " ON `" + typeName + "` (";
     command += selectedProps.map(function (p) { return "`" + p + "`"; }).join(", ");
     command += ") " + indexTypeSql;
-    if (algorithm == "LSM_TREE" && nullStrategy != "") command += " NULL_STRATEGY " + nullStrategy;
+    if ((algorithm == "LSM_TREE" || algorithm == "HASH") && nullStrategy != "") command += " NULL_STRATEGY " + nullStrategy;
 
     jQuery.ajax({
       type: "POST",
@@ -905,7 +912,7 @@ function createIndex(typeName) {
       } else {
         $("#createIdxPropsNormal").show();
         $("#createIdxPropsVector").hide();
-        $("#createIdxLsmOptions").toggle(alg == "LSM_TREE");
+        $("#createIdxLsmOptions").toggle(alg == "LSM_TREE" || alg == "HASH");
       }
     }
     $("#inputCreateIdxAlgorithm").on("change", updateIdxVisibility);