"""Test the TextClause and related constructs.""" from sqlalchemy import and_ from sqlalchemy import asc from sqlalchemy import bindparam from sqlalchemy import Column from sqlalchemy import desc from sqlalchemy import exc from sqlalchemy import extract from sqlalchemy import Float from sqlalchemy import func from sqlalchemy import Integer from sqlalchemy import literal from sqlalchemy import literal_column from sqlalchemy import MetaData from sqlalchemy import select from sqlalchemy import String from sqlalchemy import Table from sqlalchemy import testing from sqlalchemy import text from sqlalchemy import union from sqlalchemy import util from sqlalchemy.sql import column from sqlalchemy.sql import LABEL_STYLE_TABLENAME_PLUS_COL from sqlalchemy.sql import quoted_name from sqlalchemy.sql import sqltypes from sqlalchemy.sql import table from sqlalchemy.sql import util as sql_util from sqlalchemy.sql.selectable import LABEL_STYLE_DISAMBIGUATE_ONLY from sqlalchemy.sql.selectable import LABEL_STYLE_NONE from sqlalchemy.testing import assert_raises_message from sqlalchemy.testing import AssertsCompiledSQL from sqlalchemy.testing import eq_ from sqlalchemy.testing import fixtures from sqlalchemy.testing.assertions import expect_raises_message from sqlalchemy.types import NullType table1 = table( "mytable", column("myid", Integer), column("name", String), column("description", String), ) table2 = table( "myothertable", column("otherid", Integer), column("othername", String) ) class CompileTest(fixtures.TestBase, AssertsCompiledSQL): __dialect__ = "default" def test_basic(self): self.assert_compile( text("select * from foo where lala = bar"), "select * from foo where lala = bar", ) def test_text_adds_to_result_map(self): t1, t2 = text("t1"), text("t2") stmt = select(t1, t2) compiled = stmt.compile() eq_( compiled._result_columns, [ (None, None, (t1,), sqltypes.NULLTYPE), (None, None, (t2,), sqltypes.NULLTYPE), ], ) class SelectCompositionTest(fixtures.TestBase, AssertsCompiledSQL): """test the usage of text() implicit within the select() construct when strings are passed.""" __dialect__ = "default" def test_select_composition_one(self): self.assert_compile( select( literal_column("foobar(a)"), literal_column("pk_foo_bar(syslaal)"), ) .where(text("a = 12")) .select_from( text("foobar left outer join lala on foobar.foo = lala.foo") ), "SELECT foobar(a), pk_foo_bar(syslaal) FROM foobar " "left outer join lala on foobar.foo = lala.foo WHERE a = 12", ) def test_select_composition_two(self): s = select() s = s.add_columns(column("column1"), column("column2")) s = s.where(text("column1=12")) s = s.where(text("column2=19")) s = s.order_by("column1") s = s.select_from(text("table1")) self.assert_compile( s, "SELECT column1, column2 FROM table1 WHERE " "column1=12 AND column2=19 ORDER BY column1", ) def test_select_composition_three(self): self.assert_compile( select(column("column1"), column("column2")) .select_from(table1) .alias("somealias") .select(), "SELECT somealias.column1, somealias.column2 FROM " "(SELECT column1, column2 FROM mytable) AS somealias", ) def test_select_composition_four(self): # test that use_labels doesn't interfere with literal columns self.assert_compile( select( text("column1"), column("column2"), column("column3").label("bar"), table1.c.myid, ) .select_from(table1) .set_label_style(LABEL_STYLE_TABLENAME_PLUS_COL), "SELECT column1, column2, column3 AS bar, " "mytable.myid AS mytable_myid " "FROM mytable", ) def test_select_composition_five(self): # test that use_labels doesn't interfere # with literal columns that have textual labels self.assert_compile( select( text("column1 AS foobar"), text("column2 AS hoho"), table1.c.myid, ) .select_from(table1) .set_label_style(LABEL_STYLE_TABLENAME_PLUS_COL), "SELECT column1 AS foobar, column2 AS hoho, " "mytable.myid AS mytable_myid FROM mytable", ) def test_select_composition_six(self): # test that "auto-labeling of subquery columns" # doesn't interfere with literal columns, # exported columns don't get quoted. # [ticket:4730] refines this but for the moment the behavior with # no columns is being maintained. self.assert_compile( select( literal_column("column1 AS foobar"), literal_column("column2 AS hoho"), table1.c.myid, ) .select_from(table1) .subquery() .select(), "SELECT anon_1.column1 AS foobar, anon_1.column2 AS hoho, " "anon_1.myid FROM " "(SELECT column1 AS foobar, column2 AS hoho, " "mytable.myid AS myid FROM mytable) AS anon_1", ) def test_select_composition_seven(self): self.assert_compile( select(literal_column("col1"), literal_column("col2")) .select_from(table("tablename")) .alias("myalias"), "SELECT col1, col2 FROM tablename", ) def test_select_composition_eight(self): self.assert_compile( select(table1.alias("t"), text("foo.f")) .where(text("foo.f = t.id")) .select_from(text("(select f from bar where lala=heyhey) foo")), "SELECT t.myid, t.name, t.description, foo.f FROM " "(select f from bar where lala=heyhey) foo, " "mytable AS t WHERE foo.f = t.id", ) def test_expression_element_role(self): """test #7287""" self.assert_compile( extract("year", text("some_date + :param")), "EXTRACT(year FROM some_date + :param)", ) @testing.combinations( ( None, "SELECT mytable.myid, whatever FROM mytable " "UNION SELECT mytable.myid, whatever FROM mytable", ), ( LABEL_STYLE_NONE, "SELECT mytable.myid, whatever FROM mytable " "UNION SELECT mytable.myid, whatever FROM mytable", ), ( LABEL_STYLE_DISAMBIGUATE_ONLY, "SELECT mytable.myid, whatever FROM mytable " "UNION SELECT mytable.myid, whatever FROM mytable", ), ( LABEL_STYLE_TABLENAME_PLUS_COL, "SELECT mytable.myid AS mytable_myid, whatever FROM mytable " "UNION SELECT mytable.myid AS mytable_myid, whatever FROM mytable", ), ) def test_select_composition_nine(self, label_style, expected): s1 = select(table1.c.myid, text("whatever")) if label_style: s1 = s1.set_label_style(label_style) s2 = select(table1.c.myid, text("whatever")) if label_style: s2 = s2.set_label_style(label_style) stmt = s1.union(s2) self.assert_compile(stmt, expected) @testing.combinations( ( None, "SELECT anon_1.myid FROM (SELECT mytable.myid AS myid, " "whatever FROM mytable UNION SELECT mytable.myid AS myid, " "whatever FROM mytable) AS anon_1", ), ( LABEL_STYLE_NONE, "SELECT anon_1.myid FROM (SELECT mytable.myid AS myid, " "whatever FROM mytable UNION SELECT mytable.myid AS myid, " "whatever FROM mytable) AS anon_1", ), ( LABEL_STYLE_DISAMBIGUATE_ONLY, "SELECT anon_1.myid FROM (SELECT mytable.myid AS myid, " "whatever FROM mytable UNION SELECT mytable.myid AS myid, " "whatever FROM mytable) AS anon_1", ), ( LABEL_STYLE_TABLENAME_PLUS_COL, "SELECT anon_1.mytable_myid FROM " "(SELECT mytable.myid AS mytable_myid, whatever FROM mytable " "UNION SELECT mytable.myid AS mytable_myid, whatever " "FROM mytable) AS anon_1", ), ) def test_select_composition_ten(self, label_style, expected): s1 = select(table1.c.myid, text("whatever")) if label_style: s1 = s1.set_label_style(label_style) s2 = select(table1.c.myid, text("whatever")) if label_style: s2 = s2.set_label_style(label_style) stmt = s1.union(s2).subquery().select() self.assert_compile(stmt, expected) @testing.combinations( (None, "SELECT mytable.myid, whatever FROM mytable"), (LABEL_STYLE_NONE, "SELECT mytable.myid, whatever FROM mytable"), ( LABEL_STYLE_DISAMBIGUATE_ONLY, "SELECT mytable.myid, whatever FROM mytable", ), ( LABEL_STYLE_TABLENAME_PLUS_COL, "SELECT mytable.myid AS mytable_myid, whatever FROM mytable", ), ) def test_select_composition_eleven(self, label_style, expected): stmt = select(table1.c.myid, text("whatever")) if label_style: stmt = stmt.set_label_style(label_style) self.assert_compile(stmt, expected) @testing.combinations( (None, ["myid", "description"]), (LABEL_STYLE_NONE, ["myid", "description"]), (LABEL_STYLE_DISAMBIGUATE_ONLY, ["myid", "description"]), ( LABEL_STYLE_TABLENAME_PLUS_COL, ["mytable_myid", "mytable_description"], ), ) def test_select_selected_columns_ignores_text(self, label_style, expected): stmt = select(table1.c.myid, text("whatever"), table1.c.description) if label_style: stmt = stmt.set_label_style(label_style) eq_(stmt.selected_columns.keys(), expected) def test_select_bundle_columns(self): self.assert_compile( select( table1, table2.c.otherid, text("sysdate()"), text("foo, bar, lala"), ).where( and_( text("foo.id = foofoo(lala)"), text("datetime(foo) = Today"), table1.c.myid == table2.c.otherid, ), ), "SELECT mytable.myid, mytable.name, mytable.description, " "myothertable.otherid, sysdate(), foo, bar, lala " "FROM mytable, myothertable WHERE foo.id = foofoo(lala) AND " "datetime(foo) = Today AND mytable.myid = myothertable.otherid", ) class BindParamTest(fixtures.TestBase, AssertsCompiledSQL): __dialect__ = "default" def test_positional(self): t = text("select * from foo where lala=:bar and hoho=:whee") t = t.bindparams(bindparam("bar", 4), bindparam("whee", 7)) self.assert_compile( t, "select * from foo where lala=:bar and hoho=:whee", checkparams={"bar": 4, "whee": 7}, ) def test_kw(self): t = text("select * from foo where lala=:bar and hoho=:whee") t = t.bindparams(bar=4, whee=7) self.assert_compile( t, "select * from foo where lala=:bar and hoho=:whee", checkparams={"bar": 4, "whee": 7}, ) def test_positional_plus_kw(self): t = text("select * from foo where lala=:bar and hoho=:whee") t = t.bindparams(bindparam("bar", 4), whee=7) self.assert_compile( t, "select * from foo where lala=:bar and hoho=:whee", checkparams={"bar": 4, "whee": 7}, ) def test_literal_binds(self): t = text("select * from foo where lala=:bar and hoho=:whee") t = t.bindparams(bindparam("bar", 4), whee="whee") self.assert_compile( t, "select * from foo where lala=4 and hoho='whee'", checkparams={}, literal_binds=True, ) def _assert_type_map(self, t, compare): map_ = {b.key: b.type for b in t._bindparams.values()} for k in compare: assert compare[k]._type_affinity is map_[k]._type_affinity def test_typing_construction(self): t = text("select * from table :foo :bar :bat") self._assert_type_map( t, {"foo": NullType(), "bar": NullType(), "bat": NullType()} ) t = t.bindparams(bindparam("foo", type_=String)) self._assert_type_map( t, {"foo": String(), "bar": NullType(), "bat": NullType()} ) t = t.bindparams(bindparam("bar", type_=Integer)) self._assert_type_map( t, {"foo": String(), "bar": Integer(), "bat": NullType()} ) t = t.bindparams(bat=45.564) self._assert_type_map( t, {"foo": String(), "bar": Integer(), "bat": Float()} ) def test_binds_compiled_named(self): self.assert_compile( text( "select * from foo where lala=:bar and hoho=:whee" ).bindparams(bar=4, whee=7), "select * from foo where lala=%(bar)s and hoho=%(whee)s", checkparams={"bar": 4, "whee": 7}, dialect="postgresql", ) def test_unique_binds(self): # unique binds can be used in text() however they uniquify across # multiple text() constructs only, not within a single text t1 = text("select :foo").bindparams(bindparam("foo", 5, unique=True)) t2 = text("select :foo").bindparams(bindparam("foo", 10, unique=True)) stmt = select(t1, t2) self.assert_compile( stmt, "SELECT select :foo_1, select :foo_2", checkparams={"foo_1": 5, "foo_2": 10}, ) def test_binds_compiled_positional(self): self.assert_compile( text( "select * from foo where lala=:bar and hoho=:whee" ).bindparams(bar=4, whee=7), "select * from foo where lala=? and hoho=?", checkparams={"bar": 4, "whee": 7}, dialect="sqlite", ) def test_missing_bind_kw(self): assert_raises_message( exc.ArgumentError, r"This text\(\) construct doesn't define " r"a bound parameter named 'bar'", text(":foo").bindparams, foo=5, bar=7, ) def test_missing_bind_posn(self): assert_raises_message( exc.ArgumentError, r"This text\(\) construct doesn't define " r"a bound parameter named 'bar'", text(":foo").bindparams, bindparam("foo", value=5), bindparam("bar", value=7), ) def test_escaping_colons(self): # test escaping out text() params with a backslash self.assert_compile( text( r"select * from foo where clock='05:06:07' " r"and mork='\:mindy'" ), "select * from foo where clock='05:06:07' and mork=':mindy'", checkparams={}, params={}, dialect="postgresql", ) def test_escaping_double_colons(self): self.assert_compile( text( r"SELECT * FROM pg_attribute WHERE " r"attrelid = :tab\:\:regclass" ), "SELECT * FROM pg_attribute WHERE " "attrelid = %(tab)s::regclass", params={"tab": None}, dialect="postgresql", ) def test_double_colons_dont_actually_need_escaping(self): # this is news to me. bound param won't work but you can put the # double colons in self.assert_compile( text( r"SELECT * FROM pg_attribute WHERE " r"attrelid = foo::regclass" ), "SELECT * FROM pg_attribute WHERE " "attrelid = foo::regclass", params={}, dialect="postgresql", ) def test_text_in_select_nonfrom(self): generate_series = text( "generate_series(:x, :y, :z) as s(a)" ).bindparams(x=None, y=None, z=None) s = select( (func.current_date() + literal_column("s.a")).label("dates") ).select_from(generate_series) self.assert_compile( s, "SELECT CURRENT_DATE + s.a AS dates FROM " "generate_series(:x, :y, :z) as s(a)", checkparams={"y": None, "x": None, "z": None}, ) self.assert_compile( s.params(x=5, y=6, z=7), "SELECT CURRENT_DATE + s.a AS dates FROM " "generate_series(:x, :y, :z) as s(a)", checkparams={"y": 6, "x": 5, "z": 7}, ) def test_escaping_percent_signs(self): stmt = text("select '%' where foo like '%bar%'") self.assert_compile( stmt, "select '%' where foo like '%bar%'", dialect="sqlite" ) self.assert_compile( stmt, "select '%%' where foo like '%%bar%%'", dialect="mysql" ) def test_percent_signs_literal_binds(self): stmt = select(literal("percent % signs %%")) self.assert_compile( stmt, "SELECT 'percent % signs %%' AS anon_1", dialect="sqlite", literal_binds=True, ) self.assert_compile( stmt, "SELECT 'percent %% signs %%%%' AS anon_1", dialect="mysql", literal_binds=True, ) class AsFromTest(fixtures.TestBase, AssertsCompiledSQL): __dialect__ = "default" def test_basic_toplevel_resultmap_positional(self): t = text("select id, name from user").columns( column("id", Integer), column("name") ) col_pos = {col.name: idx for idx, col in enumerate(t.selected_columns)} compiled = t.compile() eq_( compiled._create_result_map(), { "id": ( "id", (t.selected_columns.id, "id", "id", "id"), t.selected_columns.id.type, col_pos["id"], ), "name": ( "name", (t.selected_columns.name, "name", "name", "name"), t.selected_columns.name.type, col_pos["name"], ), }, ) def test_basic_toplevel_resultmap(self): t = text("select id, name from user").columns(id=Integer, name=String) col_pos = {col.name: idx for idx, col in enumerate(t.selected_columns)} compiled = t.compile() eq_( compiled._create_result_map(), { "id": ( "id", (t.selected_columns.id, "id", "id", "id"), t.selected_columns.id.type, col_pos["id"], ), "name": ( "name", (t.selected_columns.name, "name", "name", "name"), t.selected_columns.name.type, col_pos["name"], ), }, ) def test_basic_subquery_resultmap(self): t = ( text("select id, name from user") .columns(id=Integer, name=String) .subquery() ) stmt = select(table1.c.myid).select_from( table1.join(t, table1.c.myid == t.c.id) ) compiled = stmt.compile() eq_( compiled._create_result_map(), { "myid": ( "myid", (table1.c.myid, "myid", "myid", "mytable_myid"), table1.c.myid.type, 0, ) }, ) def test_column_collection_ordered(self): t = text("select a, b, c from foo").columns( column("a"), column("b"), column("c") ) eq_(t.selected_columns.keys(), ["a", "b", "c"]) def test_column_collection_pos_plus_bykey(self): # overlapping positional names + type names t = text("select a, b, c from foo").columns( column("a"), column("b"), b=Integer, c=String ) eq_(t.selected_columns.keys(), ["a", "b", "c"]) eq_(t.selected_columns.b.type._type_affinity, Integer) eq_(t.selected_columns.c.type._type_affinity, String) def _xy_table_fixture(self): m = MetaData() t = Table("t", m, Column("x", Integer), Column("y", Integer)) return t def _mapping(self, stmt): compiled = stmt.compile() return { elem: key for key, elements in compiled._create_result_map().items() for elem in elements[1] } def test_select_label_alt_name(self): t = self._xy_table_fixture() l1, l2 = t.c.x.label("a"), t.c.y.label("b") s = text("select x AS a, y AS b FROM t").columns(l1, l2) mapping = self._mapping(s) assert l1 in mapping assert t.c.x not in mapping def test_select_alias_label_alt_name(self): t = self._xy_table_fixture() l1, l2 = t.c.x.label("a"), t.c.y.label("b") s = text("select x AS a, y AS b FROM t").columns(l1, l2).alias() mapping = self._mapping(s) assert l1 in mapping assert t.c.x not in mapping def test_select_column(self): t = self._xy_table_fixture() x, y = t.c.x, t.c.y s = text("select x, y FROM t").columns(x, y) mapping = self._mapping(s) assert t.c.x in mapping def test_select_alias_column(self): t = self._xy_table_fixture() x, y = t.c.x, t.c.y s = text("select x, y FROM t").columns(x, y).alias() mapping = self._mapping(s) assert t.c.x in mapping def test_select_table_alias_column(self): t = self._xy_table_fixture() x = t.c.x ta = t.alias() s = text("select ta.x, ta.y FROM t AS ta").columns(ta.c.x, ta.c.y) mapping = self._mapping(s) assert x not in mapping def test_subquery_accessors(self): t = self._xy_table_fixture() s = text("SELECT x from t").columns(t.c.x) self.assert_compile( select(s.scalar_subquery()), "SELECT (SELECT x from t) AS anon_1" ) self.assert_compile( select(s.subquery()), "SELECT anon_1.x FROM (SELECT x from t) AS anon_1", ) def test_select_label_alt_name_table_alias_column(self): t = self._xy_table_fixture() x = t.c.x ta = t.alias() l1, l2 = ta.c.x.label("a"), ta.c.y.label("b") s = text("SELECT ta.x AS a, ta.y AS b FROM t AS ta").columns(l1, l2) mapping = self._mapping(s) assert x not in mapping assert l1 in mapping assert ta.c.x not in mapping def test_cte(self): t = ( text("select id, name from user") .columns(id=Integer, name=String) .cte("t") ) s = select(table1).where(table1.c.myid == t.c.id) self.assert_compile( s, "WITH t AS (select id, name from user) " "SELECT mytable.myid, mytable.name, mytable.description " "FROM mytable, t WHERE mytable.myid = t.id", ) def test_cte_recursive(self): t = ( text("select id, name from user") .columns(id=Integer, name=String) .cte("t", recursive=True) ) s = select(table1).where(table1.c.myid == t.c.id) self.assert_compile( s, "WITH RECURSIVE t(id, name) AS (select id, name from user) " "SELECT mytable.myid, mytable.name, mytable.description " "FROM mytable, t WHERE mytable.myid = t.id", ) def test_unions(self): s1 = text("select id, name from user where id > 5").columns( id=Integer, name=String ) s2 = text("select id, name from user where id < 15").columns( id=Integer, name=String ) stmt = union(s1, s2) eq_(stmt.selected_columns.keys(), ["id", "name"]) self.assert_compile( stmt, "select id, name from user where id > 5 UNION " "select id, name from user where id < 15", ) def test_subquery(self): t = ( text("select id, name from user") .columns(id=Integer, name=String) .subquery() ) stmt = ( select(table1.c.myid) .select_from(table1.join(t, table1.c.myid == t.c.id)) .order_by(t.c.name) ) self.assert_compile( stmt, "SELECT mytable.myid FROM mytable JOIN " "(select id, name from user) AS anon_1 " "ON mytable.myid = anon_1.id ORDER BY anon_1.name", ) def test_alias(self): t = ( text("select id, name from user") .columns(id=Integer, name=String) .alias("t") ) s = select(table1).where(table1.c.myid == t.c.id) self.assert_compile( s, "SELECT mytable.myid, mytable.name, mytable.description " "FROM mytable, (select id, name from user) AS t " "WHERE mytable.myid = t.id", ) def test_scalar_subquery(self): t = text("select id from user").columns(id=Integer) subq = t.scalar_subquery() assert subq.type._type_affinity is Integer()._type_affinity s = select(table1.c.myid, subq).where(table1.c.myid == subq) self.assert_compile( s, "SELECT mytable.myid, (select id from user) AS anon_1 " "FROM mytable WHERE mytable.myid = (select id from user)", ) def test_build_bindparams(self): t = text("select id from user :foo :bar :bat") t = t.bindparams(bindparam("foo", type_=Integer)) t = t.columns(id=Integer) t = t.bindparams(bar=String) t = t.bindparams(bindparam("bat", value="bat")) eq_(set(t.element._bindparams), {"bat", "foo", "bar"}) class TextErrorsTest(fixtures.TestBase, AssertsCompiledSQL): __dialect__ = "default" def _test(self, fn, arg, offending_clause): arg = util.to_list(arg) assert_raises_message( exc.ArgumentError, r"Textual (?:SQL|column|SQL FROM) expression %(stmt)r should be " r"explicitly declared (?:with|as) text\(%(stmt)r\)" % {"stmt": util.ellipses_string(offending_clause)}, fn, *arg, ) def test_where(self): self._test(select(table1.c.myid).where, "myid == 5", "myid == 5") def test_column(self): self._test(select, ["myid"], "myid") def test_having(self): self._test(select(table1.c.myid).having, "myid == 5", "myid == 5") def test_from(self): self._test(select(table1.c.myid).select_from, "mytable", "mytable") class OrderByLabelResolutionTest(fixtures.TestBase, AssertsCompiledSQL): __dialect__ = "default" def _test_exception(self, stmt, offending_clause, dialect=None): assert_raises_message( exc.CompileError, r"Can't resolve label reference for ORDER BY / GROUP BY / " "DISTINCT etc. " "Textual SQL " "expression %r should be explicitly " r"declared as text\(%r\)" % (offending_clause, offending_clause), stmt.compile, dialect=dialect, ) def test_order_by_label(self): stmt = select(table1.c.myid.label("foo")).order_by("foo") self.assert_compile( stmt, "SELECT mytable.myid AS foo FROM mytable ORDER BY foo" ) def test_no_order_by_text(self): stmt = select(text("foo")).order_by("foo") with expect_raises_message( exc.CompileError, r"Can't resolve label reference for ORDER BY / GROUP BY / ", ): stmt.compile() def test_order_by_colname(self): stmt = select(table1.c.myid).order_by("name") self.assert_compile( stmt, "SELECT mytable.myid FROM mytable ORDER BY mytable.name" ) def test_order_by_alias_colname(self): t1 = table1.alias() stmt = ( select(t1.c.myid) .set_label_style(LABEL_STYLE_TABLENAME_PLUS_COL) .order_by("name") ) self.assert_compile( stmt, "SELECT mytable_1.myid AS mytable_1_myid " "FROM mytable AS mytable_1 ORDER BY mytable_1.name", ) @testing.combinations( ((column("q") + 5).label("a"), "a", ()), (column("q").op("+")(5).label("a"), "a", ()), ((column("q") + 5).label("a"), "a DESC", (desc,)), (column("q").op("+")(5).label("a"), "a DESC", (desc,)), ) def test_order_by_expr(self, case, expected, modifiers): order_by = case for mod in modifiers: order_by = mod(order_by) stmt = select(case).order_by(order_by) col_expr = str(case) self.assert_compile( stmt, "SELECT %s AS a ORDER BY %s" % (col_expr, expected) ) def test_order_by_named_label_from_anon_label(self): s1 = select(table1.c.myid.label(None).label("foo"), table1.c.name) stmt = s1.order_by("foo") self.assert_compile( stmt, "SELECT mytable.myid AS foo, mytable.name " "FROM mytable ORDER BY foo", ) def test_order_by_outermost_label(self): # test [ticket:3335], assure that order_by("foo") # catches the label named "foo" in the columns clause only, # and not the label named "foo" in the FROM clause s1 = select(table1.c.myid.label("foo"), table1.c.name).alias() stmt = select(s1.c.name, func.bar().label("foo")).order_by("foo") self.assert_compile( stmt, "SELECT anon_1.name, bar() AS foo FROM " "(SELECT mytable.myid AS foo, mytable.name AS name " "FROM mytable) AS anon_1 ORDER BY foo", ) def test_unresolvable_warning_order_by(self): stmt = select(table1.c.myid).order_by("foobar") self._test_exception(stmt, "foobar") def test_distinct_label(self): stmt = select(table1.c.myid.label("foo")).distinct("foo") self.assert_compile( stmt, "SELECT DISTINCT ON (foo) mytable.myid AS foo FROM mytable", dialect="postgresql", ) def test_distinct_label_keyword(self): stmt = select(table1.c.myid.label("foo")).distinct("foo") self.assert_compile( stmt, "SELECT DISTINCT ON (foo) mytable.myid AS foo FROM mytable", dialect="postgresql", ) def test_unresolvable_distinct_label(self): from sqlalchemy.dialects import postgresql stmt = select(table1.c.myid.label("foo")).distinct("not a label") self._test_exception(stmt, "not a label", dialect=postgresql.dialect()) def test_group_by_label(self): stmt = select(table1.c.myid.label("foo")).group_by("foo") self.assert_compile( stmt, "SELECT mytable.myid AS foo FROM mytable GROUP BY foo" ) def test_group_by_colname(self): stmt = select(table1.c.myid).group_by("name") self.assert_compile( stmt, "SELECT mytable.myid FROM mytable GROUP BY mytable.name" ) def test_unresolvable_warning_group_by(self): stmt = select(table1.c.myid).group_by("foobar") self._test_exception(stmt, "foobar") def test_asc(self): stmt = select(table1.c.myid).order_by(asc("name"), "description") self.assert_compile( stmt, "SELECT mytable.myid FROM mytable " "ORDER BY mytable.name ASC, mytable.description", ) def test_group_by_subquery(self): stmt = select(table1).alias() stmt = ( select(stmt) .set_label_style(LABEL_STYLE_TABLENAME_PLUS_COL) .group_by("myid") ) self.assert_compile( stmt, "SELECT anon_1.myid AS anon_1_myid, anon_1.name AS anon_1_name, " "anon_1.description AS anon_1_description FROM " "(SELECT mytable.myid AS myid, mytable.name AS name, " "mytable.description AS description FROM mytable) AS anon_1 " "GROUP BY anon_1.myid", ) def test_order_by_literal_col_quoting_one(self): col = literal_column("SUM(ABC)").label("SUM(ABC)") tbl = table("my_table") query = select(col).select_from(tbl).order_by(col) self.assert_compile( query, 'SELECT SUM(ABC) AS "SUM(ABC)" FROM my_table ORDER BY "SUM(ABC)"', ) def test_order_by_literal_col_quoting_two(self): col = literal_column("SUM(ABC)").label("SUM(ABC)_") tbl = table("my_table") query = select(col).select_from(tbl).order_by(col) self.assert_compile( query, 'SELECT SUM(ABC) AS "SUM(ABC)_" FROM my_table ORDER BY ' '"SUM(ABC)_"', ) def test_order_by_literal_col_quoting_one_explicit_quote(self): col = literal_column("SUM(ABC)").label(quoted_name("SUM(ABC)", True)) tbl = table("my_table") query = select(col).select_from(tbl).order_by(col) self.assert_compile( query, 'SELECT SUM(ABC) AS "SUM(ABC)" FROM my_table ORDER BY "SUM(ABC)"', ) def test_order_by_literal_col_quoting_two_explicit_quote(self): col = literal_column("SUM(ABC)").label(quoted_name("SUM(ABC)_", True)) tbl = table("my_table") query = select(col).select_from(tbl).order_by(col) self.assert_compile( query, 'SELECT SUM(ABC) AS "SUM(ABC)_" FROM my_table ORDER BY ' '"SUM(ABC)_"', ) def test_order_by_func_label_desc(self): stmt = select(func.foo("bar").label("fb"), table1).order_by(desc("fb")) self.assert_compile( stmt, "SELECT foo(:foo_1) AS fb, mytable.myid, mytable.name, " "mytable.description FROM mytable ORDER BY fb DESC", ) def test_pg_distinct(self): stmt = select(table1).distinct("name") self.assert_compile( stmt, "SELECT DISTINCT ON (mytable.name) mytable.myid, " "mytable.name, mytable.description FROM mytable", dialect="postgresql", ) def test_over(self): stmt = select(column("foo"), column("bar")).subquery() stmt = select( func.row_number().over(order_by="foo", partition_by="bar") ).select_from(stmt) self.assert_compile( stmt, "SELECT row_number() OVER " "(PARTITION BY anon_2.bar ORDER BY anon_2.foo) " "AS anon_1 FROM (SELECT foo, bar) AS anon_2", ) def test_union_column(self): s1 = select(table1) s2 = select(table1) stmt = union(s1, s2).order_by("name") self.assert_compile( stmt, "SELECT mytable.myid, mytable.name, mytable.description FROM " "mytable UNION SELECT mytable.myid, mytable.name, " "mytable.description FROM mytable ORDER BY name", ) def test_union_label(self): s1 = select(func.foo("hoho").label("x")) s2 = select(func.foo("Bar").label("y")) stmt = union(s1, s2).order_by("x") self.assert_compile( stmt, "SELECT foo(:foo_1) AS x UNION SELECT foo(:foo_2) AS y ORDER BY x", ) def test_standalone_units_stringable(self): self.assert_compile(desc("somelabel"), "somelabel DESC") def test_columnadapter_anonymized(self): """test issue #3148 Testing the anonymization applied from the ColumnAdapter.columns collection, typically as used in eager loading. """ exprs = [ table1.c.myid, table1.c.name.label("t1name"), func.foo("hoho").label("x"), ] ta = table1.alias() adapter = sql_util.ColumnAdapter(ta, anonymize_labels=True) s1 = ( select(*[adapter.columns[expr] for expr in exprs]) .set_label_style(LABEL_STYLE_TABLENAME_PLUS_COL) .order_by("myid", "t1name", "x") ) assert_raises_message( exc.CompileError, r"Can't resolve label reference for ORDER BY / GROUP BY / " "DISTINCT etc. " "Textual SQL " "expression 't1name' should be explicitly " r"declared as text\('t1name'\)", s1.compile, ) def test_columnadapter_non_anonymized(self): """test issue #3148 Testing the anonymization applied from the ColumnAdapter.columns collection, typically as used in eager loading. """ exprs = [ table1.c.myid, table1.c.name.label("t1name"), func.foo("hoho").label("x"), ] ta = table1.alias() adapter = sql_util.ColumnAdapter(ta) s1 = ( select(*[adapter.columns[expr] for expr in exprs]) .set_label_style(LABEL_STYLE_TABLENAME_PLUS_COL) .order_by("myid", "t1name", "x") ) # labels are maintained self.assert_compile( s1, "SELECT mytable_1.myid AS mytable_1_myid, " "mytable_1.name AS t1name, foo(:foo_1) AS x " "FROM mytable AS mytable_1 ORDER BY mytable_1.myid, t1name, x", )