MSSQL - Missing NOLOCK hint when using a Table with a schema

Issue #3430 resolved
created an issue

Using mssql, I don't see the NOLOCK hint in the generated SQL of my select query when I specify a schema in my Table. (I do see the hint if I don't specify a schema.) Here is a test case:

# -*- encoding: utf-8
from sqlalchemy import *
from sqlalchemy.databases import mssql
from sqlalchemy.testing import fixtures, AssertsCompiledSQL

class CompileTest(fixtures.TestBase, AssertsCompiledSQL):
    __dialect__ = mssql.dialect()

    def test_select_without_schema_with_nolock(self):
        metadata = MetaData()
        t = Table(
            'sometable', metadata,
            Column('somecolumn', Integer),
        self.assert_compile(select([t]).with_hint(t, "WITH (NOLOCK)"),
                            'SELECT sometable.somecolumn '
                            'FROM sometable WITH (NOLOCK)')

    def test_select_with_schema_with_nolock(self):
        metadata = MetaData()
        t = Table(
            'sometable', metadata,
            Column('somecolumn', Integer),
        self.assert_compile(select([t]).with_hint(t, "WITH (NOLOCK)"),
                            'SELECT sometable_1.somecolumn '
                            'FROM dlr.sometable AS sometable_1 WITH (NOLOCK)')

Here is the console output when I run it with sqlalchemy master branch (commit 525cc6fe0247a76201c173e535d8309333461afc). The first tests passes but the second test fails.

$ py.test test/
============================================================= test session starts ==============================================================
platform linux2 -- Python 2.7.8 -- py-1.4.27 -- pytest-2.7.1 -- /home/eliot/src/bb/sqlalchemy/venv/bin/python
rootdir: /home/eliot/src/bb/sqlalchemy, inifile: setup.cfg
collected 2 items

test/ FAILED
test/ PASSED

=================================================================== FAILURES ===================================================================
_______________________________________________ CompileTest.test_select_with_schema_with_nolock ________________________________________________
Traceback (most recent call last):
  File "/home/eliot/src/bb/sqlalchemy/test/", line 28, in test_select_with_schema_with_nolock
    'SELECT sometable_1.somecolumn '
  File "/home/eliot/src/bb/sqlalchemy/test/../lib/sqlalchemy/testing/", line 314, in assert_compile
    eq_(cc, result, "%r != %r on dialect %r" % (cc, result, dialect))
  File "/home/eliot/src/bb/sqlalchemy/test/../lib/sqlalchemy/testing/", line 211, in eq_
    assert a == b, msg or "%r != %r" % (a, b)
AssertionError: u'SELECT sometable_1.somecolumn FROM dlr.sometable AS sometable_1' != 'SELECT sometable_1.somecolumn FROM dlr.sometable AS sometable_1 WITH (NOLOCK)' on dialect <sqlalchemy.dialects.mssql.pyodbc.MSDialect_pyodbc object at 0x7f09c573b590>
------------------------------------------------------------- Captured stdout call -------------------------------------------------------------

SQL String:
SELECT sometable_1.somecolumn 
FROM dlr.sometable AS sometable_1{}
=========================================================== short test summary info ============================================================
FAIL test/
====================================================== 1 failed, 1 passed in 0.07 seconds ======================================================

Is this a bug or is my usage incorrect?

Real life usage

I don't think the following information is needed, but here are notes about my real life usage. I can provide further details if it is required.

  • I am using the ORM and Flask-SQLAlchemy:

    class User(db.Model):
        __tablename__ = 'User'
        __table_args__ = (
            {'schema': 'dlr'},
        user_id = db.Column(
            'UserId', db.BigInteger, nullable=False, primary_key=True,
    db.session.query(User).with_hint(User, 'WITH (NOLOCK)').order_by(User.user_id).all()
  • SQLAlchemy==1.0.4, Flask-SQLAlchemy==2.0, pyodbc==3.0.5

  • My laptop: Ubuntu 14.10
  • Database: SQL Server ?2008 I think?

Comments (8)

  1. Michael Bayer repo owner

    ultimately this is the same issue as #3424 which will resolve. But I am continually amazed at how issues that have existed literally for nearly a decade always get reported in pairs, hardly a week apart from each other. thanks for reporting!

  2. Michael Bayer repo owner
    • Added a new dialect flag to the MSSQL dialect legacy_schema_aliasing which when set to False will disable a very old and obsolete behavior, that of the compiler's attempt to turn all schema-qualified table names into alias names, to work around old and no longer locatable issues where SQL server could not parse a multi-part identifier name in all circumstances. The behavior prevented more sophisticated statements from working correctly, including those which use hints, as well as CRUD statements that embed correlated SELECT statements. Rather than continue to repair the feature to work with more complex statements, it's better to just disable it as it should no longer be needed for any modern SQL server version. The flag defaults to True for the 1.0.x series, leaving current behavior unchanged for this version series. In the 1.1 series, it will default to False. For the 1.0 series, when not set to either value explicitly, a warning is emitted when a schema-qualified table is first used in a statement, which suggests that the flag be set to False for all modern SQL Server versions. fixes #3424 fixes #3430

    → <<cset 915791101353>>

  3. Eliot reporter

    This is not your (SQLAlchemy's) concern, but I am still trying to figure out how to set the new legacy_schema_aliasing option with Flask-SQLAlchemy.

    I did confirm that passing legacy_schema_aliasing=False to create_engine fixed my problem.

    Thank you for your hard work!

  4. Eliot reporter

    This is not your (SQLAlchemy's) concern, but I am still trying to figure out how to set the new legacy_schema_aliasing option with Flask-SQLAlchemy.

    I solved my Flask-SQLAlchemy problem. It was not hard to subclass flask.ext.sqlalchemy.SQLAlchemy and override apply_driver_hacks as mentioned in this Flask-SQLAlchemy issue.

    from flask.ext.sqlalchemy import SQLAlchemy
    class MySQLAlchemy(SQLAlchemy):
        def apply_driver_hacks(self, app, info, options):
            super(DPSQLAlchemy, self).apply_driver_hacks(app, info, options)
            options['legacy_schema_aliasing'] = False
  5. Michael Bayer repo owner

    the option wasn't set as something that would work from "config", but I fixed that today. that is if you have a config file that is using engine_from_config():

    sqlalchemy.url = mssql://dsn
    sqlalchemy.legacy_schema_aliasing = false
  6. Log in to comment