非パーティション分割コンテナーをパーティション分割コンテナーに移行する

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 から 1 つのドキュメントを読み取るサンプルを示します。

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 から 1 つのドキュメントを読み取るサンプルを示します。

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

ドキュメントを再パーティション分割する方法の完全なサンプルについては、Java サンプルの GitHub リポジトリをご覧ください。