DB API Feedback Request

This is a pull request to allow people to easily see the API changes [which previously have been welcomed by the other developers].

For now, this is purely here to allow comments on the syntax changes (that as I say, others have approved previously).

It is not a pull request to be merged into master in it's current form.