Update oslo-incubator db.sqlalchemy module

Changes -
 * pep8: fixed multiple violations
 * Prevent races in opportunistic db test cases
 * Fix Sphinx directive name

Change-Id: Ibc42553bf3730e02a4c98bdfad1509f16d16cb61
Merge "Update oslo-incubator db.sqlalchemy module"