+h!ddlmZddlmZddlmZddlmZddlmZddlmZddlm Z dd lm Z dd l m Z dd l mZGd d ejZGdde ZdZy))ARRAY)util) coercions)elements) expression) functions)roles)schema)ColumnCollectionConstraint)InternalTraversalceZdZdZdZdZdejfdejfdejfgZ dZ d dZ d Z e jfd Zed Zy) aggregate_order_byaRepresent a PostgreSQL aggregate order by expression. E.g.:: from sqlalchemy.dialects.postgresql import aggregate_order_by expr = func.array_agg(aggregate_order_by(table.c.a, table.c.b.desc())) stmt = select(expr) would represent the expression:: SELECT array_agg(a ORDER BY b DESC) FROM table; Similarly:: expr = func.string_agg( table.c.a, aggregate_order_by(literal_column("','"), table.c.a) ) stmt = select(expr) Would represent:: SELECT string_agg(a, ',' ORDER BY a) FROM table; .. versionadded:: 1.1 .. versionchanged:: 1.2.13 - the ORDER BY argument may be multiple terms .. seealso:: :class:`_functions.array_agg` postgresqltargettypeorder_bycvtjtj||_|jj |_t |}|dk(r td|dk(r-tjtj|d|_ytj|dtji|_y)Nz)at least one ORDER BY element is requiredr_literal_as_text_role) rexpectr ExpressionElementRolerrlen TypeErrorrr ClauseList)selfrr_lobs U/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/dialects/postgresql/ext.py__init__zaggregate_order_by.__init__@s&&u'B'BFK KK$$ 8} 19GH H QY%,,++Xa[DM%//161L1LDMNc|SN)ragainsts r self_groupzaggregate_order_by.self_groupPs r c 2|j|jfSr"rr)rkwargss r get_childrenzaggregate_order_by.get_childrenSs{{DMM))r c d||jfi||_||jfi||_yr"r')rclonekws r_copy_internalsz"aggregate_order_by._copy_internalsVs,DKK.2. dmm2r2 r c\|jj|jjzSr")r _from_objectsr)rs rr/z aggregate_order_by._from_objectsZs!{{((4==+F+FFFr r")__name__ __module__ __qualname____doc____visit_name__stringify_dialectr dp_clauseelementdp_type_traverse_internalsrr%r)r_cloner-propertyr/r#r rrrs} D*N$ $556 "**+ &778  *%-OO3GGr rcneZdZdZdZdZdZdZejdddd Z fd Z d d Z xZ S) ExcludeConstraintzA table-level EXCLUDE constraint. Defines an EXCLUDE constraint as described in the `PostgreSQL documentation`__. __ https://www.postgresql.org/docs/current/static/sql-createtable.html#SQL-CREATETABLE-EXCLUDE exclude_constraintNFrwherez:class:`.ExcludeConstraint`z$:paramref:`.ExcludeConstraint.where`cg}g}i|_t|\}}ttjtj ||D]R\\}}} } } | |j | | |jn| } | | |j| <|j || | fT||_tj|g||jd|jd|jdd|jdd|_ |jd} | )tjtj| |_|jd i|_y) a2 Create an :class:`.ExcludeConstraint` object. E.g.:: const = ExcludeConstraint( (Column('period'), '&&'), (Column('group'), '='), where=(Column('group') != 'some group'), ops={'group': 'my_operator_class'} ) The constraint is normally embedded into the :class:`_schema.Table` construct directly, or added later using :meth:`.append_constraint`:: some_table = Table( 'some_table', metadata, Column('id', Integer, primary_key=True), Column('period', TSRANGE()), Column('group', String) ) some_table.append_constraint( ExcludeConstraint( (some_table.c.period, '&&'), (some_table.c.group, '='), where=some_table.c.group != 'some group', name='some_table_excl_const', ops={'group': 'my_operator_class'} ) ) :param \*elements: A sequence of two tuples of the form ``(column, operator)`` where "column" is a SQL expression element or a raw SQL string, most typically a :class:`_schema.Column` object, and "operator" is a string containing the operator to use. In order to specify a column name when a :class:`_schema.Column` object is not available, while ensuring that any necessary quoting rules take effect, an ad-hoc :class:`_schema.Column` or :func:`_expression.column` object should be used. :param name: Optional, the in-database name of this constraint. :param deferrable: Optional bool. If set, emit DEFERRABLE or NOT DEFERRABLE when issuing DDL for this constraint. :param initially: Optional string. If set, emit INITIALLY when issuing DDL for this constraint. :param using: Optional string. If set, emit USING when issuing DDL for this constraint. Defaults to 'gist'. :param where: Optional SQL expression construct or literal SQL string. If set, emit WHERE when issuing DDL for this constraint. :param ops: Optional dictionary. Used to define operator classes for the elements; works the same way as that of the :ref:`postgresql_ops ` parameter specified to the :class:`_schema.Index` construct. .. versionadded:: 1.3.21 .. seealso:: :ref:`postgresql_operator_classes` - general description of how PostgreSQL operator classes are specified. Nname deferrable initially)r@rArBusinggistr>ops) operatorszipr expect_col_expression_collectionr DDLConstraintColumnRoleappendr@ _render_exprsr rgetrCrStatementOptionRoler>rE)rrr,columns render_exprs expressionsrFexprcolumnstrname add_elementoperatorr@r>s rrzExcludeConstraint.__init__psQn !$h Y>A  6 6--{   ?  8 : 0T67K( &{+"("46;;'D'/t$   tX 6 7 8"*"++   vvl+ff[)  VVGV, w  "))%*C*CUKDJ66%$r c tt| |tj|j |j Dcgc]*\\}}}}t|tjr|n|||f,c}}}}|_ycc}}}}wr") superr< _set_parentr zip_longestrKrN isinstancer ClauseElement)rtabler,rQr@rUcolexpr __class__s rrXzExcludeConstraint._set_parents} 259483C3C""DLL4   0&tX #4)?)?@g     s/A? c |jDcgc]<}tj||j||j|j f>}}|j ||j |j|j|j|jd}|jj|j|Scc}w)N)r@rArBr>rC) rNr _copy_expressionparentrFr@r^rArBr>rCdispatch_update)r target_tabler,rQrcs r_copyzExcludeConstraint._copys   ''dkk<Htyy)    DNN nn****   4==)! sACr")r0r1r2r3r4r> inherit_cachecreate_drop_stringify_dialectr_document_text_coercionrrXrf __classcell__)r^s@rr<r<_sT*N EM$0!%X%%%. w%  w%r  r r<cRt|d<tjj|i|S)zPostgreSQL-specific form of :class:`_functions.array_agg`, ensures return type is :class:`_postgresql.ARRAY` and not the plain :class:`_types.ARRAY`, unless an explicit ``type_`` is passed. .. versionadded:: 1.1 _default_array_type)rr func array_agg)argr,s rrnrns)!&B >> # #S /B //r N)arrayrrsqlrrrr r r sql.schemar sql.visitorsr ColumnElementrr<rnr#r rrvsQ4-HG11HGVn2nb 0r