更新对象

Weaviate 允许部分或完全更新对象。

其他信息

• 部分更新使用 PATCH 请求到 /v1/objects REST API 端点 在底层。
• 完全更新使用 PUT 请求到 /v1/objects REST API 端点 在底层。
• 包含 vector 属性的更新将重新计算向量嵌入（除非所有更新的 text 属性都 跳过）。
• 要更新对象，您必须提供集合名称、id 和要更新的属性。
• 对于 多租户 集合，您还需要指定租户名称。有关详细信息，请参阅 管理数据：多租户操作。
  

对象 CRUD 操作中的集合（类）名称

集合充当命名空间，因此两个不同的集合之间可能存在重复的 ID。

在 Weaviate v1.14 之前，您可以无需指定集合名称即可操作对象。此方法已被弃用。它将在 Weaviate v2.0.0 中删除。

从 v1.20 开始，您可以拥有 多租户 数据集。当 multi-tenancy 启用时，需要租户名称。

始终包含集合名称，并在启用时包含租户名称。

更新对象属性

此操作仅替换指定属性的整个值，而保留未指定的属性。提供集合名称、对象 id 和要更新的属性。

如果您更新先前向量化属性的值，Weaviate 会自动重新向量化对象。 这也会重新索引更新后的对象。

但是，如果您向集合定义添加新属性，Weaviate 仅向量化新对象。 当定义新属性时，Weaviate 不会重新向量化和重新索引现有对象，而仅在更新现有属性时才会重新向量化和重新索引。

PythonJavaScript/TypeScriptGoJava v6Java v5 (已弃用)C#

  API 文档

更多信息文档中的代码片段反映了最新的客户端库和 Weaviate 数据库版本。请查看 发行说明 以获取特定版本。

如果某个片段无法工作或您有任何反馈，请打开一个 GitHub issue。

uuid = "..."  # replace with the id of the object you want to update

jeopardy = client.collections.use("JeopardyQuestion")
jeopardy.data.update(
    uuid=uuid,
    properties={
        "points": 100,
    }
)

const myCollection = client.collections.use('JeopardyQuestion') 
const response = await myCollection.data.update({
  id: 'ed89d9e7-4c9d-4a6a-8d20-095cb0026f54',
  properties: {
    'points': 100,
  },
})

console.log(response)

id := "..." // replace with the id of the object you want to update
client.Data().Updater().
  WithMerge(). // merges properties into the object
  WithID(id).
  WithClassName("JeopardyQuestion").
  WithProperties(map[string]interface{}{
  	"points": 100,
  }).
  Do(ctx)

jeopardy.data.update(uuid,
    u -> u.properties(Map.of("points", 100.0))
);

String id = "..."; // replace with the id of the object you want to update
client.data().updater()
  .withMerge() // merges properties into the object
  .withID(id)
  .withClassName("JeopardyQuestion")
  .withProperties(new HashMap<String, Object>() {{
    put("points", 100);
  }})
  .run();

await jeopardy.Data.Replace(
    uuid,
    properties: new { points = 100 }
);

更新对象向量

对象向量也可以与属性类似地更新。 对于 命名向量，以类似于 对象创建 的方式提供数据作为字典/映射。

PythonJavaScript/TypeScriptGoJava v6Java v5 (已弃用)C#

  API 文档

更多信息文档中的代码片段反映了最新的客户端库和 Weaviate 数据库版本。请查看 发行说明 以获取特定版本。

如果某个片段无法工作或您有任何反馈，请打开一个 GitHub issue。

jeopardy = client.collections.use("JeopardyQuestion")
jeopardy.data.update(
    uuid=uuid,
    properties={
        "points": 100,
    },
    vector=[0.12345] * 1536
)

const jeopardy = client.collections.use('JeopardyQuestion')
const response = await jeopardy.data.update({
  id: 'ed89d9e7-4c9d-4a6a-8d20-095cb0026f54',
  vectors: Array(1536).fill(0.12345), // new vector value
})

console.log(response)

即将推出

float[] vector = new float[384];
Arrays.fill(vector, 0.12345f);

jeopardy.data.update(uuid, u -> u.properties(Map.of("points", 100.0))
    .vectors(Vectors.of(vector))
);

即将推出

await jeopardy.Data.Replace(
    uuid,
    properties: new { points = 100 },
    vectors: vector
);

替换整个对象

可以通过提供集合名称、id 和新对象来替换整个对象。

PythonJavaScript/TypeScriptGoJava v6Java v5 (已弃用)C#

  API 文档

更多信息文档中的代码片段反映了最新的客户端库和 Weaviate 数据库版本。请查看 发行说明 以获取特定版本。

如果某个片段无法工作或您有任何反馈，请打开一个 GitHub issue。

jeopardy = client.collections.use("JeopardyQuestion")
jeopardy.data.replace(
    uuid=uuid,
    properties={
        "answer": "Replaced",
        # The other properties will be deleted
    },
)

const myCollection = client.collections.use('JeopardyQuestion') 
const response = await myCollection.data.replace({
  id: 'ed89d9e7-4c9d-4a6a-8d20-095cb0026f54',
  properties: {
    'answer': 'Replaced',
    // The other properties will be deleted
  },
})

console.log(response)

id := "..." // replace with the id of the object you want to update
client.Data().Updater(). // replaces the entire object
  WithID(id).
  WithClassName("JeopardyQuestion").
  WithProperties(map[string]interface{}{
  	"answer": "Replaced",
  	// The other properties will be deleted
  }).
  Do(ctx)

jeopardy.data.replace(
    uuid, r -> r.properties(Map.of("answer", "Replaced"
    // The other properties will be deleted
    )));

String id = "..."; // replace with the id of the object you want to update
client.data().updater() // replaces the entire object
  .withID(id)
  .withClassName("JeopardyQuestion")
  .withProperties(new HashMap<String, Object>() {{
    put("answer", "Replaced");
    // The other properties will be deleted
  }})
  .run();

await jeopardy.Data.Replace(
    uuid,
    properties: new { answer = "Replaced" }
// The other properties will be deleted
);

删除属性

删除或更新集合定义中的属性 尚未支持。

在对象级别，您可以将对象替换为已删除这些属性或将文本属性设置为 "" 的副本。

PythonJavaScript/TypeScriptGoJava v6Java v5 (已弃用)C#

  API 文档

更多信息文档中的代码片段反映了最新的客户端库和 Weaviate 数据库版本。请查看 发行说明 以获取特定版本。

如果某个片段无法工作或您有任何反馈，请打开一个 GitHub issue。

from typing import List
from weaviate import WeaviateClient

def del_props(client: WeaviateClient, uuid_to_update: str, collection_name: str, prop_names: List[str]) -> None:
    collection = client.collections.use(collection_name)

    # fetch the object to update
    object_data = collection.query.fetch_object_by_id(uuid_to_update)
    properties_to_update = object_data.properties

    # remove unwanted properties
    for prop_name in prop_names:
        if prop_name in properties_to_update:
            del properties_to_update[prop_name]

    # replace the properties
    collection.data.replace(
        uuid=uuid_to_update,
        properties=properties_to_update
    )


uuid = "..."  # replace with the id of the object you want to delete properties from
del_props(client, uuid, "JeopardyQuestion", ["answer"])

async function deleteProperties(client: WeaviateClient, uuidToUpdate: string, collectionName: string, propNames: string[]) {
  const collection = client.collections.use(collectionName);
  const objectData = await collection.query.fetchObjectById(uuidToUpdate);
  const propertiesToUpdate = objectData?.properties;
  
  if (propertiesToUpdate) {
    for (let propName of propNames) {
        if (propName in propertiesToUpdate) {
          delete propertiesToUpdate[propName];
        }
    }
  
    let result = await collection.data.replace({
      id: uuidToUpdate,
      properties: propertiesToUpdate
    })
  }
}
  
let id = 'ed89d9e7-4c9d-4a6a-8d20-095cb0026f54'
deleteProperties(client, id, 'JeopardyQuestion', ['answer'])

delProps := func(uuid, className string, propNames ...string) (bool, error) {
  objs, err := client.Data().ObjectsGetter().WithID(uuid).WithClassName(className).Do(ctx)
  if err != nil {
  	return false, err
  }
  if objs == nil || len(objs) == 0 {
  	return false, fmt.Errorf("object with id: %v not found", uuid)
  }
  if objs[0].Properties == nil {
  	return false, fmt.Errorf("object with id: %v has no properties", uuid)
  }
  properties := objs[0].Properties.(map[string]interface{})
  for _, propName := range propNames {
  	delete(properties, propName)
  }
  err = client.Data().Updater().
  	WithID(uuid).
  	WithClassName(className).
  	WithProperties(properties).
  	Do(ctx)
  return err == nil, err
}

id := "..." // replace with the id of the object you want to update
isUpdated, err := delProps(id, "JeopardyQuestion", "answer")

  private static void delProps(WeaviateClient client, String uuidToUpdate, String collectionName,
      List<String> propNames) throws IOException {
    CollectionHandle<Map<String, Object>> collection = client.collections.use(collectionName);

    // fetch the object to update
    Optional<WeaviateObject<Map<String, Object>>> objectDataOpt =
        collection.query.fetchObjectById(uuidToUpdate);
    if (objectDataOpt.isEmpty()) {
      return;
    }
    Map<String, Object> propertiesToUpdate = new HashMap<>(objectDataOpt.get().properties());

    // remove unwanted properties
    for (String propName : propNames) {
      propertiesToUpdate.remove(propName);
    }

    // replace the properties
    collection.data.replace(uuidToUpdate, r -> r.properties(propertiesToUpdate));
  }

    delProps(client, uuid, "JeopardyQuestion", List.of("answer"));

private boolean delProps(String uuid, String className, String ...propNames) {
  Result<List<WeaviateObject>> result = client.data().objectsGetter().withID(uuid).withClassName(className).run();
  if (!result.hasErrors() && result.getResult() != null) {
    WeaviateObject objectData = result.getResult().get(0);
    for (String propName: propNames) {
      objectData.getProperties().remove(propName);
    }
    // Replace the object
    Result<Boolean> update = client.data().updater()
      .withID(uuid)
      .withClassName(className)
      .withProperties(objectData.getProperties())
      .run();
    return update.getResult() != null && update.getResult().equals(true);
  }
  return false;
}

String id = "..."; // replace with the id of the object you want to update
boolean isUpdated = delProps(id, "JeopardyQuestion", "answer");

private static async Task DelProps(
    WeaviateClient client,
    Guid uuidToUpdate,
    string collectionName,
    IEnumerable<string> propNames
)
{
    var collection = client.Collections.Use(collectionName);

    // fetch the object to update
    var objectData = await collection.Query.FetchObjectByID(uuidToUpdate);
    if (objectData?.Properties is not IDictionary<string, object> propertiesToUpdate)
    {
        return;
    }

    // remove unwanted properties
    foreach (var propName in propNames)
    {
        propertiesToUpdate.Remove(propName);
    }

    // replace the properties
    await collection.Data.Replace(uuidToUpdate, propertiesToUpdate);
}


    await DelProps(client, uuid, "JeopardyQuestion", new[] { "answer" });

相关页面

• 连接到 Weaviate

• 参考：REST - /v1/objects

问题和反馈

如果您有任何问题或反馈，请在 用户论坛 中告诉我们。

技术问题

如果您有任何问题，请在我们的 社区论坛 上发帖。

文档反馈

通过打开 GitHub issue 提供反馈。