from decimal import Decimal import re from unittest.mock import Mock from sqlalchemy import Column from sqlalchemy import event from sqlalchemy import exc from sqlalchemy import inspect from sqlalchemy import Integer from sqlalchemy import Numeric from sqlalchemy import select from sqlalchemy import String from sqlalchemy import Table from sqlalchemy import testing from sqlalchemy.dialects.mssql import base from sqlalchemy.dialects.mssql import pymssql from sqlalchemy.dialects.mssql import pyodbc from sqlalchemy.engine import url from sqlalchemy.exc import DBAPIError from sqlalchemy.exc import IntegrityError from sqlalchemy.testing import assert_raises from sqlalchemy.testing import assert_raises_message from sqlalchemy.testing import assert_warnings from sqlalchemy.testing import engines from sqlalchemy.testing import eq_ from sqlalchemy.testing import expect_raises from sqlalchemy.testing import expect_raises_message from sqlalchemy.testing import expect_warnings from sqlalchemy.testing import fixtures from sqlalchemy.testing import mock class ParseConnectTest(fixtures.TestBase): def test_pyodbc_connect_dsn_trusted(self): dialect = pyodbc.dialect() u = url.make_url("mssql+pyodbc://mydsn") connection = dialect.create_connect_args(u) eq_((("dsn=mydsn;Trusted_Connection=Yes",), {}), connection) def test_pyodbc_connect_old_style_dsn_trusted(self): dialect = pyodbc.dialect() u = url.make_url("mssql+pyodbc:///?dsn=mydsn") connection = dialect.create_connect_args(u) eq_((("dsn=mydsn;Trusted_Connection=Yes",), {}), connection) def test_pyodbc_connect_dsn_non_trusted(self): dialect = pyodbc.dialect() u = url.make_url("mssql+pyodbc://username:password@mydsn") connection = dialect.create_connect_args(u) eq_((("dsn=mydsn;UID=username;PWD=password",), {}), connection) def test_pyodbc_connect_dsn_extra(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://username:password@mydsn/?LANGUAGE=us_" "english&foo=bar" ) connection = dialect.create_connect_args(u) dsn_string = connection[0][0] assert ";LANGUAGE=us_english" in dsn_string assert ";foo=bar" in dsn_string def test_pyodbc_hostname(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://username:password@hostspec/database?driver=SQL+Server" # noqa ) connection = dialect.create_connect_args(u) eq_( ( ( "DRIVER={SQL Server};Server=hostspec;Database=database;UI" "D=username;PWD=password", ), {}, ), connection, ) def test_pyodbc_empty_url_no_warning(self): dialect = pyodbc.dialect() u = url.make_url("mssql+pyodbc://") # no warning is emitted dialect.create_connect_args(u) def test_pyodbc_host_no_driver(self): dialect = pyodbc.dialect() u = url.make_url("mssql+pyodbc://username:password@hostspec/database") def go(): return dialect.create_connect_args(u) connection = assert_warnings( go, [ "No driver name specified; this is expected by " "PyODBC when using DSN-less connections" ], ) eq_( ( ( "Server=hostspec;Database=database;UI" "D=username;PWD=password", ), {}, ), connection, ) def test_pyodbc_connect_comma_port(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://username:password@hostspec:12345/data" "base?driver=SQL Server" ) connection = dialect.create_connect_args(u) eq_( ( ( "DRIVER={SQL Server};Server=hostspec,12345;Database=datab" "ase;UID=username;PWD=password", ), {}, ), connection, ) def test_pyodbc_connect_config_port(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://username:password@hostspec/database?p" "ort=12345&driver=SQL+Server" ) connection = dialect.create_connect_args(u) eq_( ( ( "DRIVER={SQL Server};Server=hostspec;Database=database;UI" "D=username;PWD=password;port=12345", ), {}, ), connection, ) def test_pyodbc_extra_connect(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://username:password@hostspec/database?L" "ANGUAGE=us_english&foo=bar&driver=SQL+Server" ) connection = dialect.create_connect_args(u) eq_(connection[1], {}) eq_( connection[0][0] in ( "DRIVER={SQL Server};Server=hostspec;Database=database;" "UID=username;PWD=password;foo=bar;LANGUAGE=us_english", "DRIVER={SQL Server};Server=hostspec;Database=database;UID=" "username;PWD=password;LANGUAGE=us_english;foo=bar", ), True, ) def test_pyodbc_extra_connect_azure(self): # issue #5592 dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://@server_name/db_name?" "driver=ODBC+Driver+17+for+SQL+Server&" "authentication=ActiveDirectoryIntegrated" ) connection = dialect.create_connect_args(u) eq_(connection[1], {}) eq_( connection[0][0] in ( "DRIVER={ODBC Driver 17 for SQL Server};" "Server=server_name;Database=db_name;" "Authentication=ActiveDirectoryIntegrated", ), True, ) def test_pyodbc_odbc_connect(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc:///?odbc_connect=DRIVER%3D%7BSQL+Server" "%7D%3BServer%3Dhostspec%3BDatabase%3Ddatabase" "%3BUID%3Dusername%3BPWD%3Dpassword" ) connection = dialect.create_connect_args(u) eq_( ( ( "DRIVER={SQL Server};Server=hostspec;Database=database;UI" "D=username;PWD=password", ), {}, ), connection, ) def test_pyodbc_odbc_connect_with_dsn(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc:///?odbc_connect=dsn%3Dmydsn%3BDatabase" "%3Ddatabase%3BUID%3Dusername%3BPWD%3Dpassword" ) connection = dialect.create_connect_args(u) eq_( (("dsn=mydsn;Database=database;UID=username;PWD=password",), {}), connection, ) def test_pyodbc_odbc_connect_ignores_other_values(self): dialect = pyodbc.dialect() u = url.make_url( "mssql+pyodbc://userdiff:passdiff@localhost/dbdiff?od" "bc_connect=DRIVER%3D%7BSQL+Server%7D%3BServer" "%3Dhostspec%3BDatabase%3Ddatabase%3BUID%3Duse" "rname%3BPWD%3Dpassword" ) connection = dialect.create_connect_args(u) eq_( ( ( "DRIVER={SQL Server};Server=hostspec;Database=database;UI" "D=username;PWD=password", ), {}, ), connection, ) @testing.combinations( ( "original", ( "someuser%3BPORT%3D50001", "some{strange}pw%3BPORT%3D50001", "somehost%3BPORT%3D50001", "somedb%3BPORT%3D50001", ), ( "DRIVER={foob};Server=somehost%3BPORT%3D50001;" "Database=somedb%3BPORT%3D50001;UID={someuser;PORT=50001};" "PWD={some{strange}}pw;PORT=50001}", ), ), ( "issue_8062", ( "larry", "{moe", "localhost", "mydb", ), ( "DRIVER={foob};Server=localhost;" "Database=mydb;UID=larry;" "PWD={{moe}", ), ), argnames="tokens, connection_string", id_="iaa", ) def test_pyodbc_token_injection(self, tokens, connection_string): u = url.make_url("mssql+pyodbc://%s:%s@%s/%s?driver=foob" % tokens) dialect = pyodbc.dialect() connection = dialect.create_connect_args(u) eq_( ( connection_string, {}, ), connection, ) def test_pymssql_port_setting(self): dialect = pymssql.dialect() u = url.make_url("mssql+pymssql://scott:tiger@somehost/test") connection = dialect.create_connect_args(u) eq_( ( [], { "host": "somehost", "password": "tiger", "user": "scott", "database": "test", }, ), connection, ) u = url.make_url("mssql+pymssql://scott:tiger@somehost:5000/test") connection = dialect.create_connect_args(u) eq_( ( [], { "host": "somehost:5000", "password": "tiger", "user": "scott", "database": "test", }, ), connection, ) def test_pymssql_disconnect(self): dialect = pymssql.dialect() for error in [ "Adaptive Server connection timed out", "Net-Lib error during Connection reset by peer", "message 20003", "Error 10054", "Not connected to any MS SQL server", "Connection is closed", "message 20006", # Write to the server failed "message 20017", # Unexpected EOF from the server "message 20047", # DBPROCESS is dead or not enabled ]: eq_(dialect.is_disconnect(error, None, None), True) eq_(dialect.is_disconnect("not an error", None, None), False) def test_pyodbc_disconnect(self): dialect = pyodbc.dialect() class MockDBAPIError(Exception): pass class MockProgrammingError(MockDBAPIError): pass dialect.dbapi = Mock( Error=MockDBAPIError, ProgrammingError=MockProgrammingError ) for error in [ MockDBAPIError(code, "[%s] some pyodbc message" % code) for code in [ "08S01", "01002", "08003", "08007", "08S02", "08001", "HYT00", "HY010", ] ] + [ MockProgrammingError(message) for message in [ "(some pyodbc stuff) The cursor's connection has been closed.", "(some pyodbc stuff) Attempt to use a closed connection.", ] ]: eq_(dialect.is_disconnect(error, None, None), True) eq_( dialect.is_disconnect( MockProgrammingError("Query with abc08007def failed"), None, None, ), False, ) @testing.requires.mssql_freetds def test_bad_freetds_warning(self): engine = engines.testing_engine() def _bad_version(connection): return 95, 10, 255 engine.dialect._get_server_version_info = _bad_version assert_raises_message( exc.SAWarning, "Unrecognized server version info", engine.connect ) class FastExecutemanyTest(fixtures.TestBase): __only_on__ = "mssql" __backend__ = True __requires__ = ("pyodbc_fast_executemany",) def test_flag_on(self, metadata): t = Table( "t", metadata, Column("id", Integer, primary_key=True), Column("data", String(50)), ) t.create(testing.db) eng = engines.testing_engine( options={"fast_executemany": True, "use_insertmanyvalues": False} ) @event.listens_for(eng, "after_cursor_execute") def after_cursor_execute( conn, cursor, statement, parameters, context, executemany ): if executemany: assert cursor.fast_executemany with eng.begin() as conn: conn.execute( t.insert(), [{"id": i, "data": "data_%d" % i} for i in range(100)], ) conn.execute(t.insert(), {"id": 200, "data": "data_200"}) @testing.variation("add_event", [True, False]) @testing.variation("setinputsizes", [True, False]) @testing.variation("fastexecutemany", [True, False]) @testing.variation("insertmanyvalues", [False]) # disabled due to #9603 @testing.variation("broken_types", [True, False]) def test_insert_typing( self, metadata, testing_engine, add_event, fastexecutemany, setinputsizes, insertmanyvalues, broken_types, ): """tests for executemany + datatypes that are sensitive to "setinputsizes" Issues tested here include: #6058 - turn off setinputsizes by default, since it breaks with fast_executemany (version 1.4) #8177 - turn setinputsizes back **on** by default, just skip it only for cursor.executemany() calls when fast_executemany is set; otherwise use it. (version 2.0) #8917 - oops, we added "insertmanyvalues" but forgot to adjust the check in #8177 above to accommodate for this, so setinputsizes was getting turned off for "insertmanyvalues" if fast_executemany was still set """ # changes for issue #8177 have eliminated all current expected # failures, but we'll leave this here in case we need it again # (... four months pass ...) # surprise! we need it again. woop! for #8917 expect_failure = ( broken_types and not setinputsizes and insertmanyvalues and not fastexecutemany ) engine = testing_engine( options={ "fast_executemany": fastexecutemany, "use_setinputsizes": setinputsizes, "use_insertmanyvalues": insertmanyvalues, } ) observations = Table( "Observations", metadata, Column("id", Integer, nullable=False, primary_key=True), Column("obs1", Numeric(19, 15), nullable=True), Column("obs2", Numeric(19, 15), nullable=True), Column("obs3", String(10)), schema="test_schema", ) with engine.begin() as conn: metadata.create_all(conn) records = [ { "id": 1, "obs1": Decimal("60.1722066045792"), "obs2": Decimal("24.929289808227466"), "obs3": "obs3", }, { "id": 2, "obs1": Decimal("60.16325715615476"), "obs2": Decimal("24.93886459535008"), "obs3": 5 if broken_types else "obs3", }, { "id": 3, "obs1": Decimal("60.16445165123469"), "obs2": Decimal("24.949856300109516"), "obs3": 7 if broken_types else "obs3", }, ] assert_records = [ { "id": rec["id"], "obs1": rec["obs1"], "obs2": rec["obs2"], "obs3": str(rec["obs3"]), } for rec in records ] if add_event: canary = mock.Mock() @event.listens_for(engine, "do_setinputsizes") def do_setinputsizes( inputsizes, cursor, statement, parameters, context ): canary(list(inputsizes.values())) for key in inputsizes: if isinstance(key.type, Numeric): inputsizes[key] = ( engine.dialect.dbapi.SQL_DECIMAL, 19, 15, ) with engine.begin() as conn: if expect_failure: with expect_raises(DBAPIError): conn.execute(observations.insert(), records) else: conn.execute(observations.insert(), records) eq_( conn.execute( select(observations).order_by(observations.c.id) ) .mappings() .all(), assert_records, ) if add_event: if setinputsizes: eq_( canary.mock_calls, [ # float for int? this seems wrong mock.call( [ float, float, float, engine.dialect.dbapi.SQL_VARCHAR, ] ), mock.call([]), ], ) else: eq_(canary.mock_calls, []) class VersionDetectionTest(fixtures.TestBase): @testing.fixture def mock_conn_scalar(self): return lambda text: Mock( exec_driver_sql=Mock( return_value=Mock(scalar=Mock(return_value=text)) ) ) def test_pymssql_version(self, mock_conn_scalar): dialect = pymssql.MSDialect_pymssql() for vers in [ "Microsoft SQL Server Blah - 11.0.9216.62", "Microsoft SQL Server (XYZ) - 11.0.9216.62 \n" "Jul 18 2014 22:00:21 \nCopyright (c) Microsoft Corporation", "Microsoft SQL Azure (RTM) - 11.0.9216.62 \n" "Jul 18 2014 22:00:21 \nCopyright (c) Microsoft Corporation", ]: conn = mock_conn_scalar(vers) eq_(dialect._get_server_version_info(conn), (11, 0, 9216, 62)) def test_pyodbc_version_productversion(self, mock_conn_scalar): dialect = pyodbc.MSDialect_pyodbc() conn = mock_conn_scalar("11.0.9216.62") eq_(dialect._get_server_version_info(conn), (11, 0, 9216, 62)) def test_pyodbc_version_fallback(self): dialect = pyodbc.MSDialect_pyodbc() dialect.dbapi = Mock() for vers, expected in [ ("11.0.9216.62", (11, 0, 9216, 62)), ("notsqlserver.11.foo.0.9216.BAR.62", (11, 0, 9216, 62)), ("Not SQL Server Version 10.5", (5,)), ]: conn = Mock( exec_driver_sql=Mock( return_value=Mock( scalar=Mock( side_effect=exc.DBAPIError("stmt", "params", None) ) ) ), connection=Mock( dbapi_connection=Mock(getinfo=Mock(return_value=vers)), ), ) eq_(dialect._get_server_version_info(conn), expected) class MiscTest(fixtures.TestBase): __only_on__ = "mssql" __backend__ = True @testing.variation("enable_comments", [True, False]) def test_comments_enabled_disabled( self, testing_engine, metadata, enable_comments ): Table( "tbl_with_comments", metadata, Column( "id", Integer, primary_key=True, comment="pk comment", ), Column("no_comment", Integer), Column( "has_comment", String(20), comment="has the comment", ), comment="table comment", ) eng = testing_engine( options={"supports_comments": bool(enable_comments)} ) metadata.create_all(eng) insp = inspect(testing.db) if enable_comments: eq_( insp.get_table_comment("tbl_with_comments"), {"text": "table comment"}, ) cols = { col["name"]: col["comment"] for col in insp.get_columns("tbl_with_comments") } eq_( cols, { "id": "pk comment", "no_comment": None, "has_comment": "has the comment", }, ) else: eq_( insp.get_table_comment("tbl_with_comments"), {"text": None}, ) cols = { col["name"]: col["comment"] for col in insp.get_columns("tbl_with_comments") } eq_( cols, { "id": None, "no_comment": None, "has_comment": None, }, ) class RealIsolationLevelTest(fixtures.TestBase): __only_on__ = "mssql" __backend__ = True def test_isolation_level(self, metadata): Table("test", metadata, Column("id", Integer)).create( testing.db, checkfirst=True ) with testing.db.connect() as c: default = testing.db.dialect.get_isolation_level(c.connection) values = [ "READ UNCOMMITTED", "READ COMMITTED", "REPEATABLE READ", "SERIALIZABLE", "SNAPSHOT", ] for value in values: with testing.db.connect() as c: c.execution_options(isolation_level=value) c.exec_driver_sql("SELECT TOP 10 * FROM test") eq_( testing.db.dialect.get_isolation_level(c.connection), value ) with testing.db.connect() as c: eq_(testing.db.dialect.get_isolation_level(c.connection), default) class IsolationLevelDetectTest(fixtures.TestBase): def _fixture( self, view_result, simulate_perm_failure=False, simulate_no_system_views=False, ): class Error(Exception): pass dialect = pyodbc.MSDialect_pyodbc() dialect.dbapi = Mock(Error=Error) dialect.server_version_info = base.MS_2012_VERSION result = [] def fail_on_exec( stmt, ): result.clear() if "SELECT name FROM sys.system_views" in stmt: if simulate_no_system_views: raise dialect.dbapi.Error( "SQL Server simulated no system_views error" ) else: if view_result: result.append((view_result,)) elif re.match( ".*SELECT CASE transaction_isolation_level.*FROM sys.%s" % (view_result,), stmt, re.S, ): if simulate_perm_failure: raise dialect.dbapi.Error( "SQL Server simulated permission error" ) result.append(("SERIALIZABLE",)) else: assert False connection = Mock( cursor=Mock( return_value=Mock( execute=fail_on_exec, fetchone=lambda: result[0] if result else None, ) ) ) return dialect, connection def test_dm_pdw_nodes(self): dialect, connection = self._fixture("dm_pdw_nodes_exec_sessions") eq_(dialect.get_isolation_level(connection), "SERIALIZABLE") def test_exec_sessions(self): dialect, connection = self._fixture("exec_sessions") eq_(dialect.get_isolation_level(connection), "SERIALIZABLE") def test_not_supported(self): dialect, connection = self._fixture(None) assert_raises_message( NotImplementedError, "Can't fetch isolation level on this particular ", dialect.get_isolation_level, connection, ) @testing.combinations(True, False) def test_no_system_views(self, simulate_perm_failure_also): dialect, connection = self._fixture( "dm_pdw_nodes_exec_sessions", simulate_perm_failure=simulate_perm_failure_also, simulate_no_system_views=True, ) assert_raises_message( NotImplementedError, r"Can\'t fetch isolation level; encountered error SQL Server " r"simulated no system_views error when attempting to query the " r'"sys.system_views" view.', dialect.get_isolation_level, connection, ) def test_dont_have_table_perms(self): dialect, connection = self._fixture( "dm_pdw_nodes_exec_sessions", simulate_perm_failure=True ) assert_raises_message( NotImplementedError, r"Can\'t fetch isolation level; encountered error SQL Server " r"simulated permission error when attempting to query the " r'"sys.dm_pdw_nodes_exec_sessions" view.', dialect.get_isolation_level, connection, ) class InvalidTransactionFalsePositiveTest(fixtures.TablesTest): __only_on__ = "mssql" __backend__ = True @classmethod def define_tables(cls, metadata): Table( "error_t", metadata, Column("error_code", String(50), primary_key=True), ) @classmethod def insert_data(cls, connection): connection.execute( cls.tables.error_t.insert(), [{"error_code": "01002"}], ) def test_invalid_transaction_detection(self, connection): # issue #5359 t = self.tables.error_t # force duplicate PK error assert_raises( IntegrityError, connection.execute, t.insert(), {"error_code": "01002"}, ) # this should not fail with # "Can't reconnect until invalid transaction is rolled back." result = connection.execute(t.select()).fetchall() eq_(len(result), 1) class IgnoreNotransOnRollbackTest(fixtures.TestBase): def test_ignore_no_transaction_on_rollback(self): """test #8231""" class ProgrammingError(Exception): pass dialect = base.dialect(ignore_no_transaction_on_rollback=True) dialect.dbapi = mock.Mock(ProgrammingError=ProgrammingError) connection = mock.Mock( rollback=mock.Mock( side_effect=ProgrammingError("Error 111214 happened") ) ) with expect_warnings( "ProgrammingError 111214 'No corresponding transaction found.' " "has been suppressed via ignore_no_transaction_on_rollback=True" ): dialect.do_rollback(connection) def test_other_programming_error_on_rollback(self): """test #8231""" class ProgrammingError(Exception): pass dialect = base.dialect(ignore_no_transaction_on_rollback=True) dialect.dbapi = mock.Mock(ProgrammingError=ProgrammingError) connection = mock.Mock( rollback=mock.Mock( side_effect=ProgrammingError("Some other error happened") ) ) with expect_raises_message( ProgrammingError, "Some other error happened" ): dialect.do_rollback(connection)