3 a&@sddlmZddlmZddlmZddlmZddlmZddlmZ ddl m Z ddl m Z dd lmZdZGd d d e Zeed dZGddde ZdS))exc)util)_exclusive_against) _generative)ColumnCollection)Insert) ClauseElement)alias)public_factoryrinsertc@sJeZdZdZdZeddZejddZ e e dddid d d Z d S) ra MySQL-specific implementation of INSERT. Adds methods for MySQL-specific syntaxes such as ON DUPLICATE KEY UPDATE. The :class:`~.mysql.Insert` object is created using the :func:`sqlalchemy.dialects.mysql.insert` function. .. versionadded:: 1.2 mysqlcCs|jjS)aProvide the "inserted" namespace for an ON DUPLICATE KEY UPDATE statement MySQL's ON DUPLICATE KEY UPDATE clause allows reference to the row that would be inserted, via a special function called ``VALUES()``. This attribute provides all columns in this row to be referenceable such that they will render within a ``VALUES()`` function inside the ON DUPLICATE KEY UPDATE clause. The attribute is named ``.inserted`` so as not to conflict with the existing :meth:`_expression.Insert.values` method. .. tip:: The :attr:`_mysql.Insert.inserted` attribute is an instance of :class:`_expression.ColumnCollection`, which provides an interface the same as that of the :attr:`_schema.Table.c` collection described at :ref:`metadata_tables_and_columns`. With this collection, ordinary names are accessible like attributes (e.g. ``stmt.inserted.some_column``), but special names and dictionary method names should be accessed using indexed access, such as ``stmt.inserted["column name"]`` or ``stmt.inserted["values"]``. See the docstring for :class:`_expression.ColumnCollection` for further examples. .. seealso:: :ref:`mysql_insert_on_duplicate_key_update` - example of how to use :attr:`_expression.Insert.inserted` )inserted_aliascolumns)selfrC/tmp/pip-build-6_cqtusv/SQLAlchemy/sqlalchemy/dialects/mysql/dml.pyinsertedszInsert.insertedcCst|jddS)Nr)name)r table)rrrrr <szInsert.inserted_alias_post_values_clausezDThis Insert construct already has an ON DUPLICATE KEY clause present)ZmsgscOsV|r|rtjd|r6t|dkr,tjd|d}n|}t|dd}t|||_dS)aE Specifies the ON DUPLICATE KEY UPDATE clause. :param \**kw: Column keys linked to UPDATE values. The values may be any SQL expression or supported literal Python values. .. warning:: This dictionary does **not** take into account Python-specified default UPDATE values or generation functions, e.g. those specified using :paramref:`_schema.Column.onupdate`. These values will not be exercised for an ON DUPLICATE KEY UPDATE style of UPDATE, unless values are manually specified here. :param \*args: As an alternative to passing key/value parameters, a dictionary or list of 2-tuples can be passed as a single positional argument. Passing a single dictionary is equivalent to the keyword argument form:: insert().on_duplicate_key_update({"name": "some name"}) Passing a list of 2-tuples indicates that the parameter assignments in the UPDATE clause should be ordered as sent, in a manner similar to that described for the :class:`_expression.Update` construct overall in :ref:`updates_order_parameters`:: insert().on_duplicate_key_update( [("name", "some name"), ("value", "some value")]) .. versionchanged:: 1.3 parameters can be specified as a dictionary or list of 2-tuples; the latter form provides for parameter ordering. .. versionadded:: 1.2 .. seealso:: :ref:`mysql_insert_on_duplicate_key_update` z9Can't pass kwargs and positional arguments simultaneouslyzDOnly a single dictionary or list of tuples is accepted positionally.r N)r ArgumentErrorlengetattrOnDuplicateClauser)rargskwvaluesr rrron_duplicate_key_update@s4   zInsert.on_duplicate_key_updateN) __name__ __module__ __qualname____doc__stringify_dialectpropertyrrZmemoized_propertyr rrrrrrrrs  z.dialects.mysql.insertz.dialects.mysql.Insertc@s eZdZdZdZdZddZdS)rrNr cCsx||_t|tr:|r:t|dtr:dd|D|_t|}t|trR|sntdnt|trft|}ntd||_dS)NrcSsg|] \}}|qSrr).0keyvaluerrr sz.OnDuplicateClause.__init__..z-update parameter dictionary must not be emptyztupdate parameter must be a non-empty dictionary or a ColumnCollection such as the `.c.` collection of a Table object) r isinstancelisttuple_parameter_orderingdict ValueErrorrupdate)rr r0rrr__init__s    zOnDuplicateClause.__init__)r r!r"Z__visit_name__r-r$r1rrrrrsrN)rr )rrZsql.baserrrZsql.dmlrZStandardInsertZ sql.elementsrZsql.expressionr Zutil.langhelpersr __all__r rrrrrs         x