Didnt find anything in the docs on this. Is D2 capable of doing an UPSERT  in case I am trying to persist an object that may or may not have been saved previously. Different RDBMS support different syntax for this case. Like MySQL has INSERT .. ON DUPLICATE KEY UPDATE (or even INSERT IGNORE) while the SQL standard defines a MERGE syntax which seems to be gaining support. Of course you can always fallback to a SELECT FOR UPDATE (or if you want to be hacky an INSERT which catches duplicate key violations .. but probably not a good idea since many RDBMS rollback on a failure inside a transaction).
See also http://opensource.atlassian.com/projects/hibernate/browse/HHH-3011 asking for MERGE support
Ideally there would be a way to define on a model or model instance level if merge logic should be applied.