chore: generate libraries at Sat Dec 14 01:46:19 UTC 2024

Author: cloud-java-bot

README.md

@@ -375,6 +375,13 @@ Samples are in the [`samples/`](https://github.com/googleapis/java-datastore/tre
 | Query Profile Explain Aggregation | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/queryprofile/QueryProfileExplainAggregation.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/queryprofile/QueryProfileExplainAggregation.java) |
 | Query Profile Explain Analyze | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/queryprofile/QueryProfileExplainAnalyze.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/queryprofile/QueryProfileExplainAnalyze.java) |
 | Query Profile Explain Analyze Aggregation | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/queryprofile/QueryProfileExplainAnalyzeAggregation.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/queryprofile/QueryProfileExplainAnalyzeAggregation.java) |
+| Store Vectors | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/StoreVectors.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/StoreVectors.java) |
+| Vector Search Basic | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchBasic.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchBasic.java) |
+| Vector Search Distance Result Property | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceResultProperty.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceResultProperty.java) |
+| Vector Search Distance Result Property Projection | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceResultPropertyProjection.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceResultPropertyProjection.java) |
+| Vector Search Distance Threshold | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceThreshold.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceThreshold.java) |
+| Vector Search Large Response | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchLargeResponse.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchLargeResponse.java) |
+| Vector Search Prefilter | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchPrefilter.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchPrefilter.java) |
 | Task List | [source code](https://github.com/googleapis/java-datastore/blob/main/samples/snippets/src/main/java/com/google/datastore/snippets/TaskList.java) | [![Open in Cloud Shell][shell_img]](https://console.cloud.google.com/cloudshell/open?git_repo=https://github.com/googleapis/java-datastore&page=editor&open_in_editor=samples/snippets/src/main/java/com/google/datastore/snippets/TaskList.java) |
 
 

samples/snippets/src/main/java/com/example/datastore/vectorsearch/StoreVectors.java

@@ -34,22 +34,22 @@ public static void invoke() throws Exception {
 
     // Prepares the entity with a vector embedding
     Entity entity =
-            Entity.newBuilder(key)
-                    .set("name", "Kahawa")
-                    .set("description", "Information about the Kahawa coffee beans.")
-                    .set("roast", "dark")
-                    .set("embedding_field", VectorValue.newBuilder(1.0, 7.0, 11.1).build())
-                    .build();
+        Entity.newBuilder(key)
+            .set("name", "Kahawa")
+            .set("description", "Information about the Kahawa coffee beans.")
+            .set("roast", "dark")
+            .set("embedding_field", VectorValue.newBuilder(1.0, 7.0, 11.1).build())
+            .build();
 
     // Saves the entity
     datastore.put(entity);
     System.out.printf("Saved %s: %s%n", entity.getKey().getName(), entity.getString("description"));
 
     // Retrieve entity
     Entity retrieved = datastore.get(key);
-    System.out.printf("Retrieved %s with embedding_field: %s%n",
-            key.getName(),
-            retrieved.getVector("embedding_field"));
+    System.out.printf(
+        "Retrieved %s with embedding_field: %s%n",
+        key.getName(), retrieved.getVector("embedding_field"));
   }
 }
 // [END datastore_store_vectors]

samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchBasic.java

@@ -33,14 +33,15 @@ public static void invoke() throws Exception {
 
     // Create vector search query
     Query<Entity> vectorSearchQuery =
-            Query.newEntityQueryBuilder()
-                    .setKind("CoffeeBean")
-                    .setFindNearest(new FindNearest(
-                            "embedding_field",
-                            VectorValue.newBuilder(1, 9, 11.1).build(),
-                            FindNearest.DistanceMeasure.EUCLIDEAN,
-                            1))
-                    .build();
+        Query.newEntityQueryBuilder()
+            .setKind("CoffeeBean")
+            .setFindNearest(
+                new FindNearest(
+                    "embedding_field",
+                    VectorValue.newBuilder(1, 9, 11.1).build(),
+                    FindNearest.DistanceMeasure.EUCLIDEAN,
+                    1))
+            .build();
 
     // Execute vector search query
     QueryResults<Entity> results = datastore.run(vectorSearchQuery);

samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchDistanceResultPropertyProjection.java

@@ -33,15 +33,17 @@ public static void invoke() throws Exception {
 
     // Create vector search query with projection
     Query<ProjectionEntity> vectorSearchQuery =
-            Query.newProjectionEntityQueryBuilder()
-                    .setKind("CoffeeBean")
-                    .setFindNearest(new FindNearest(
-                            "embedding_field",
-                            VectorValue.newBuilder(1, 9, 11.1).build(),
-                            FindNearest.DistanceMeasure.EUCLIDEAN,
-                            3, "vector_distance"))
-                    .setProjection("roast")
-                    .build();
+        Query.newProjectionEntityQueryBuilder()
+            .setKind("CoffeeBean")
+            .setFindNearest(
+                new FindNearest(
+                    "embedding_field",
+                    VectorValue.newBuilder(1, 9, 11.1).build(),
+                    FindNearest.DistanceMeasure.EUCLIDEAN,
+                    3,
+                    "vector_distance"))
+            .setProjection("roast")
+            .build();
 
     // Execute vector search query
     QueryResults<ProjectionEntity> results = datastore.run(vectorSearchQuery);
@@ -52,9 +54,9 @@ public static void invoke() throws Exception {
 
     while (results.hasNext()) {
       ProjectionEntity entity = results.next();
-      System.out.printf("Entity: %s, Distance: %s%n",
-              entity.getKey().getName(),
-              entity.getDouble("vector_distance"));
+      System.out.printf(
+          "Entity: %s, Distance: %s%n",
+          entity.getKey().getName(), entity.getDouble("vector_distance"));
     }
   }
 }

samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchLargeResponse.java

@@ -39,20 +39,23 @@ public static void invoke() throws Exception {
 
     // Create a keys-only vector search query
     StructuredQuery<ProjectionEntity> keyOnlyVectorQuery =
-            Query.newProjectionEntityQueryBuilder()
-                    .setKind("CoffeeBean")
-                    .setProjection("__key__")
-                    .setFindNearest(new FindNearest(
-                            "embedding_field",
-                            VectorValue.newBuilder(1, 9, 11.1).build(),
-                            FindNearest.DistanceMeasure.EUCLIDEAN,
-                            3, "vector_distance", 2.0))
-                    .build();
+        Query.newProjectionEntityQueryBuilder()
+            .setKind("CoffeeBean")
+            .setProjection("__key__")
+            .setFindNearest(
+                new FindNearest(
+                    "embedding_field",
+                    VectorValue.newBuilder(1, 9, 11.1).build(),
+                    FindNearest.DistanceMeasure.EUCLIDEAN,
+                    3,
+                    "vector_distance",
+                    2.0))
+            .build();
 
     QueryResults<ProjectionEntity> keyOnlyResults = datastore.run(keyOnlyVectorQuery);
     ProjectionEntity[] keyEntities = Iterators.toArray(keyOnlyResults, ProjectionEntity.class);
     Key[] keys =
-            ImmutableList.copyOf(keyEntities).stream().map(e -> e.getKey()).toArray(Key[]::new);
+        ImmutableList.copyOf(keyEntities).stream().map(e -> e.getKey()).toArray(Key[]::new);
     System.out.printf("Key query result size: %s%n", keys.length);
 
     // Lookup the full entities using the result of the keys only query.
@@ -62,10 +65,11 @@ public static void invoke() throws Exception {
 
     // Combine and print results
     for (int i = 0; i < keyEntities.length; i++) {
-      System.out.printf("Entity: %s, Distance: %s, Roast: %s%n",
-              keyEntities[i].getKey().getName(),
-              keyEntities[i].getDouble("vector_distance"),
-              entitiesArray[i].getString("roast"));
+      System.out.printf(
+          "Entity: %s, Distance: %s, Roast: %s%n",
+          keyEntities[i].getKey().getName(),
+          keyEntities[i].getDouble("vector_distance"),
+          entitiesArray[i].getString("roast"));
     }
   }
 }

samples/snippets/src/main/java/com/example/datastore/vectorsearch/VectorSearchPrefilter.java

@@ -34,15 +34,18 @@ public static void invoke() throws Exception {
 
     // Create vector search query with property filter
     Query<Entity> vectorSearchQuery =
-            Query.newEntityQueryBuilder()
-                    .setKind("CoffeeBean")
-                    .setFilter(PropertyFilter.eq("roast", "dark"))
-                    .setFindNearest(new FindNearest(
-                            "embedding_field",
-                            VectorValue.newBuilder(1, 9, 11.1).build(),
-                            FindNearest.DistanceMeasure.EUCLIDEAN,
-                            3, "vector_distance", 3.0))
-                    .build();
+        Query.newEntityQueryBuilder()
+            .setKind("CoffeeBean")
+            .setFilter(PropertyFilter.eq("roast", "dark"))
+            .setFindNearest(
+                new FindNearest(
+                    "embedding_field",
+                    VectorValue.newBuilder(1, 9, 11.1).build(),
+                    FindNearest.DistanceMeasure.EUCLIDEAN,
+                    3,
+                    "vector_distance",
+                    3.0))
+            .build();
 
     // Execute vector search query
     QueryResults<Entity> results = datastore.run(vectorSearchQuery);
@@ -53,9 +56,9 @@ public static void invoke() throws Exception {
 
     while (results.hasNext()) {
       Entity entity = results.next();
-      System.out.printf("Entity: %s, Distance: %s%n",
-              entity.getKey().getName(),
-              entity.getDouble("vector_distance"));
+      System.out.printf(
+          "Entity: %s, Distance: %s%n",
+          entity.getKey().getName(), entity.getDouble("vector_distance"));
     }
   }
 }

samples/snippets/src/test/java/com/example/datastore/vectorsearch/VectorSearchSampleIT.java

@@ -38,31 +38,33 @@ public class VectorSearchSampleIT {
   private Key coffeeBeanKey2;
   private Key coffeeBeanKey3;
 
-  @Rule
-  public final SystemsOutRule systemsOutRule = new SystemsOutRule();
+  @Rule public final SystemsOutRule systemsOutRule = new SystemsOutRule();
 
   @Before
   public void setUp() {
-    //DatastoreOptions.getDefaultHttpTransportOptions()
+    // DatastoreOptions.getDefaultHttpTransportOptions()
     coffeeBeanKey1 = datastore.newKeyFactory().setKind("CoffeeBean").newKey("Kahawa");
     // Prepares the entity with a vector embedding
-    Entity entity1 = Entity.newBuilder(coffeeBeanKey1)
+    Entity entity1 =
+        Entity.newBuilder(coffeeBeanKey1)
             .set("name", "Arabica")
             .set("description", "Information about the Arabica coffee beans.")
             .set("roast", "dark")
             .set("embedding_field", VectorValue.newBuilder(1.0, 7.0, 11.1).build())
             .build();
 
     coffeeBeanKey2 = datastore.newKeyFactory().setKind("CoffeeBean").newKey("Robusta");
-    Entity entity2 = Entity.newBuilder(coffeeBeanKey2)
+    Entity entity2 =
+        Entity.newBuilder(coffeeBeanKey2)
             .set("name", "Robusta")
             .set("description", "Information about the Robusta coffee beans.")
             .set("roast", "light")
             .set("embedding_field", VectorValue.newBuilder(1.0, 9.0, 11.1).build())
             .build();
 
     coffeeBeanKey3 = datastore.newKeyFactory().setKind("CoffeeBean").newKey("Excelsa");
-    Entity entity3 = Entity.newBuilder(coffeeBeanKey3)
+    Entity entity3 =
+        Entity.newBuilder(coffeeBeanKey3)
             .set("name", "Excelsa")
             .set("description", "Information about the Excelsa coffee beans.")
             .set("roast", "dark")