This is most useful when hydrating request data back into entities.
For example, in your controller code:
$article = $this->Articles->newEntity($this->request->data());
The hydrated entity will correctly do an insert/update based
on the primary key data existing in the database when the entity
is saved. Until the entity is saved, it will be a detached record.