将非分区容器迁移到分区容器

DeviceInformationItem = new DeviceInformationItem
{
   "id": "elevator/PugetSound/Building44/Floor1/1",
   "deviceId": "3cf4c52d-cc67-4bb8-b02f-f6185007a808",
   "_partitionKey": "3cf4c52d-cc67-4bb8-b02f-f6185007a808"
}

public class DeviceInformationItem
{
    [JsonProperty(PropertyName = "id")]
    public string Id { get; set; }

    [JsonProperty(PropertyName = "deviceId")]
    public string DeviceId { get; set; }

    [JsonProperty(PropertyName = "_partitionKey", NullValueHandling = NullValueHandling.Ignore)]
    public string PartitionKey { get {return this.DeviceId; set; }
}

CosmosContainer migratedContainer = database.Containers["testContainer"];

DeviceInformationItem deviceItem = new DeviceInformationItem() {
  Id = "1234",
  DeviceId = "3cf4c52d-cc67-4bb8-b02f-f6185007a808"
}

ItemResponse<DeviceInformationItem > response =
  await migratedContainer.CreateItemAsync<DeviceInformationItem>(
    deviceItem.PartitionKey,
    deviceItem
  );

// Read back the document providing the same partition key
ItemResponse<DeviceInformationItem> readResponse =
  await migratedContainer.ReadItemAsync<DeviceInformationItem>(
    partitionKey: deviceItem.PartitionKey,
    id: device.Id
  );

有关完整示例，请参阅 .NET 示例 GitHub 存储库。

迁移文档

虽然容器定义使用分区键属性进行了增强，但不会自动迁移容器中的文档。 这意味着系统分区键属性 /_partitionKey 路径不会自动添加到现有文档。 需要通过读取没有分区键创建的文档，对现有文档进行重新分区，并在重新编写时把 _partitionKey 属性写入到文档中。

访问没有分区键的文档

应用程序可以使用名为“PartitionKey.None”的特殊系统属性访问没有分区键的现有文档，这是非迁移文档的值。 可以在所有 CRUD 和查询作中使用此属性。 以下示例演示了从 NonePartitionKey 读取单个文档的示例。

CosmosItemResponse<DeviceInformationItem> readResponse =
await migratedContainer.Items.ReadItemAsync<DeviceInformationItem>(
  partitionKey: PartitionKey.None,
  id: device.Id
);

static class Family {
  public String id;
  public String firstName;
  public String lastName;
  public String _partitionKey;

  public Family(String id, String firstName, String lastName, String _partitionKey) {
      this.id = id;
      this.firstName = firstName;
      this.lastName = lastName;
      this._partitionKey = _partitionKey;
  }
}

...

CosmosDatabase cosmosDatabase = cosmosClient.getDatabase("testdb");
CosmosContainer cosmosContainer = cosmosDatabase.getContainer("testcontainer");

//  Create single item
Family family = new Family("id-1", "John", "Doe", "Doe");
cosmosContainer.createItem(family, new PartitionKey(family._partitionKey), new CosmosItemRequestOptions());

//  Create items through bulk operations
family = new Family("id-2", "Jane", "Doe", "Doe");
CosmosItemOperation createItemOperation = CosmosBulkOperations.getCreateItemOperation(family,
    new PartitionKey(family._partitionKey));
cosmosContainer.executeBulkOperations(Collections.singletonList(createItemOperation));

有关完整示例，请参阅 Java 示例 GitHub 存储库。

迁移文档

虽然容器定义使用分区键属性进行了增强，但不会自动迁移容器中的文档。 这意味着系统分区键属性 /_partitionKey 路径不会自动添加到现有文档。 需要通过读取没有分区键创建的文档，对现有文档进行重新分区，并在重新编写时把 _partitionKey 属性写入到文档中。

访问没有分区键的文档

应用程序可以使用名为“PartitionKey.None”的特殊系统属性访问没有分区键的现有文档，这是非迁移文档的值。 可以在所有 CRUD 和查询作中使用此属性。 以下示例演示了从 NonePartitionKey 读取单个文档的示例。

CosmosItemResponse<JsonNode> cosmosItemResponse =
  cosmosContainer.readItem("itemId", PartitionKey.NONE, JsonNode.class);

有关如何重新分区文档的完整示例，请参阅 Java 示例 GitHub 存储库。