+hdZddlmZddlZddlZddlZddlmZddl m Z ddl m Z ddl mZdd l mZdd l mZdd l mZdd l mZdd l mZddl mZddl mZddl mZddlmZddlmZddlmZddlmZddlmZddlmZddlm Z ddl!m"Z#ddl m$Z$ejJdZ&GddejNZ(GddeZ)Gdd eZ*Gd!d"e Z+Gd#d$eZ,Gd%d&eZ-Gd'd(eZ.e j^Z0Gd)d*eZ1Gd+d,eZ2Gd-d.eZ3e jhd/d0Z5e jhd1d0Z6e jhd2d30Z7e jhd4e6e7z0Z8Gd5d6eZ9e9Z:y)7aM .. dialect:: postgresql+psycopg2 :name: psycopg2 :dbapi: psycopg2 :connectstring: postgresql+psycopg2://user:password@host:port/dbname[?key=value&key=value...] :url: https://pypi.org/project/psycopg2/ psycopg2 Connect Arguments -------------------------- Keyword arguments that are specific to the SQLAlchemy psycopg2 dialect may be passed to :func:`_sa.create_engine()`, and include the following: * ``isolation_level``: This option, available for all PostgreSQL dialects, includes the ``AUTOCOMMIT`` isolation level when using the psycopg2 dialect. This option sets the **default** isolation level for the connection that is set immediately upon connection to the database before the connection is pooled. This option is generally superseded by the more modern :paramref:`_engine.Connection.execution_options.isolation_level` execution option, detailed at :ref:`dbapi_autocommit`. .. seealso:: :ref:`psycopg2_isolation_level` :ref:`dbapi_autocommit` * ``client_encoding``: sets the client encoding in a libpq-agnostic way, using psycopg2's ``set_client_encoding()`` method. .. seealso:: :ref:`psycopg2_unicode` * ``use_native_unicode``: Under Python 2 only, this can be set to False to disable the use of psycopg2's native Unicode support. .. seealso:: :ref:`psycopg2_disable_native_unicode` * ``executemany_mode``, ``executemany_batch_page_size``, ``executemany_values_page_size``: Allows use of psycopg2 extensions for optimizing "executemany"-style queries. See the referenced section below for details. .. seealso:: :ref:`psycopg2_executemany_mode` .. tip:: The above keyword arguments are **dialect** keyword arguments, meaning that they are passed as explicit keyword arguments to :func:`_sa.create_engine()`:: engine = create_engine( "postgresql+psycopg2://scott:tiger@localhost/test", isolation_level="SERIALIZABLE", ) These should not be confused with **DBAPI** connect arguments, which are passed as part of the :paramref:`_sa.create_engine.connect_args` dictionary and/or are passed in the URL query string, as detailed in the section :ref:`custom_dbapi_args`. .. _psycopg2_ssl: SSL Connections --------------- The psycopg2 module has a connection argument named ``sslmode`` for controlling its behavior regarding secure (SSL) connections. The default is ``sslmode=prefer``; it will attempt an SSL connection and if that fails it will fall back to an unencrypted connection. ``sslmode=require`` may be used to ensure that only secure connections are established. Consult the psycopg2 / libpq documentation for further options that are available. Note that ``sslmode`` is specific to psycopg2 so it is included in the connection URI:: engine = sa.create_engine( "postgresql+psycopg2://scott:tiger@192.168.0.199:5432/test?sslmode=require" ) Unix Domain Connections ------------------------ psycopg2 supports connecting via Unix domain connections. When the ``host`` portion of the URL is omitted, SQLAlchemy passes ``None`` to psycopg2, which specifies Unix-domain communication rather than TCP/IP communication:: create_engine("postgresql+psycopg2://user:password@/dbname") By default, the socket file used is to connect to a Unix-domain socket in ``/tmp``, or whatever socket directory was specified when PostgreSQL was built. This value can be overridden by passing a pathname to psycopg2, using ``host`` as an additional keyword argument:: create_engine("postgresql+psycopg2://user:password@/dbname?host=/var/lib/postgresql") .. seealso:: `PQconnectdbParams \ `_ .. _psycopg2_multi_host: Specifying multiple fallback hosts ----------------------------------- psycopg2 supports multiple connection points in the connection string. When the ``host`` parameter is used multiple times in the query section of the URL, SQLAlchemy will create a single string of the host and port information provided to make the connections. Tokens may consist of ``host::port`` or just ``host``; in the latter case, the default port is selected by libpq. In the example below, three host connections are specified, for ``HostA::PortA``, ``HostB`` connecting to the default port, and ``HostC::PortC``:: create_engine( "postgresql+psycopg2://user:password@/dbname?host=HostA:PortA&host=HostB&host=HostC:PortC" ) As an alternative, libpq query string format also may be used; this specifies ``host`` and ``port`` as single query string arguments with comma-separated lists - the default port can be chosen by indicating an empty value in the comma separated list:: create_engine( "postgresql+psycopg2://user:password@/dbname?host=HostA,HostB,HostC&port=PortA,,PortC" ) With either URL style, connections to each host is attempted based on a configurable strategy, which may be configured using the libpq ``target_session_attrs`` parameter. Per libpq this defaults to ``any`` which indicates a connection to each host is then attempted until a connection is successful. Other strategies include ``primary``, ``prefer-standby``, etc. The complete list is documented by PostgreSQL at `libpq connection strings `_. For example, to indicate two hosts using the ``primary`` strategy:: create_engine( "postgresql+psycopg2://user:password@/dbname?host=HostA:PortA&host=HostB&host=HostC:PortC&target_session_attrs=primary" ) .. versionchanged:: 1.4.40 Port specification in psycopg2 multiple host format is repaired, previously ports were not correctly interpreted in this context. libpq comma-separated format is also now supported. .. versionadded:: 1.3.20 Support for multiple hosts in PostgreSQL connection string. .. seealso:: `libpq connection strings `_ - please refer to this section in the libpq documentation for complete background on multiple host support. Empty DSN Connections / Environment Variable Connections --------------------------------------------------------- The psycopg2 DBAPI can connect to PostgreSQL by passing an empty DSN to the libpq client library, which by default indicates to connect to a localhost PostgreSQL database that is open for "trust" connections. This behavior can be further tailored using a particular set of environment variables which are prefixed with ``PG_...``, which are consumed by ``libpq`` to take the place of any or all elements of the connection string. For this form, the URL can be passed without any elements other than the initial scheme:: engine = create_engine('postgresql+psycopg2://') In the above form, a blank "dsn" string is passed to the ``psycopg2.connect()`` function which in turn represents an empty DSN passed to libpq. .. versionadded:: 1.3.2 support for parameter-less connections with psycopg2. .. seealso:: `Environment Variables\ `_ - PostgreSQL documentation on how to use ``PG_...`` environment variables for connections. .. _psycopg2_execution_options: Per-Statement/Connection Execution Options ------------------------------------------- The following DBAPI-specific options are respected when used with :meth:`_engine.Connection.execution_options`, :meth:`.Executable.execution_options`, :meth:`_query.Query.execution_options`, in addition to those not specific to DBAPIs: * ``isolation_level`` - Set the transaction isolation level for the lifespan of a :class:`_engine.Connection` (can only be set on a connection, not a statement or query). See :ref:`psycopg2_isolation_level`. * ``stream_results`` - Enable or disable usage of psycopg2 server side cursors - this feature makes use of "named" cursors in combination with special result handling methods so that result rows are not fully buffered. Defaults to False, meaning cursors are buffered by default. * ``max_row_buffer`` - when using ``stream_results``, an integer value that specifies the maximum number of rows to buffer at a time. This is interpreted by the :class:`.BufferedRowCursorResult`, and if omitted the buffer will grow to ultimately store 1000 rows at a time. .. versionchanged:: 1.4 The ``max_row_buffer`` size can now be greater than 1000, and the buffer will grow to that size. .. _psycopg2_batch_mode: .. _psycopg2_executemany_mode: Psycopg2 Fast Execution Helpers ------------------------------- Modern versions of psycopg2 include a feature known as `Fast Execution Helpers \ `_, which have been shown in benchmarking to improve psycopg2's executemany() performance, primarily with INSERT statements, by multiple orders of magnitude. SQLAlchemy internally makes use of these extensions for ``executemany()`` style calls, which correspond to lists of parameters being passed to :meth:`_engine.Connection.execute` as detailed in :ref:`multiple parameter sets `. The ORM also uses this mode internally whenever possible. The two available extensions on the psycopg2 side are the ``execute_values()`` and ``execute_batch()`` functions. The psycopg2 dialect defaults to using the ``execute_values()`` extension for all qualifying INSERT statements. .. versionchanged:: 1.4 The psycopg2 dialect now defaults to a new mode ``"values_only"`` for ``executemany_mode``, which allows an order of magnitude performance improvement for INSERT statements, but does not include "batch" mode for UPDATE and DELETE statements which removes the ability of ``cursor.rowcount`` to function correctly. The use of these extensions is controlled by the ``executemany_mode`` flag which may be passed to :func:`_sa.create_engine`:: engine = create_engine( "postgresql+psycopg2://scott:tiger@host/dbname", executemany_mode='values_plus_batch') Possible options for ``executemany_mode`` include: * ``values_only`` - this is the default value. the psycopg2 execute_values() extension is used for qualifying INSERT statements, which rewrites the INSERT to include multiple VALUES clauses so that many parameter sets can be inserted with one statement. .. versionadded:: 1.4 Added ``"values_only"`` setting for ``executemany_mode`` which is also now the default. * ``None`` - No psycopg2 extensions are not used, and the usual ``cursor.executemany()`` method is used when invoking statements with multiple parameter sets. * ``'batch'`` - Uses ``psycopg2.extras.execute_batch`` for all qualifying INSERT, UPDATE and DELETE statements, so that multiple copies of a SQL query, each one corresponding to a parameter set passed to ``executemany()``, are joined into a single SQL string separated by a semicolon. When using this mode, the :attr:`_engine.CursorResult.rowcount` attribute will not contain a value for executemany-style executions. * ``'values_plus_batch'``- ``execute_values`` is used for qualifying INSERT statements, ``execute_batch`` is used for UPDATE and DELETE. When using this mode, the :attr:`_engine.CursorResult.rowcount` attribute will not contain a value for executemany-style executions against UPDATE and DELETE statements. By "qualifying statements", we mean that the statement being executed must be a Core :func:`_expression.insert`, :func:`_expression.update` or :func:`_expression.delete` construct, and not a plain textual SQL string or one constructed using :func:`_expression.text`. When using the ORM, all insert/update/delete statements used by the ORM flush process are qualifying. The "page size" for the "values" and "batch" strategies can be affected by using the ``executemany_batch_page_size`` and ``executemany_values_page_size`` engine parameters. These control how many parameter sets should be represented in each execution. The "values" page size defaults to 1000, which is different that psycopg2's default. The "batch" page size defaults to 100. These can be affected by passing new values to :func:`_engine.create_engine`:: engine = create_engine( "postgresql+psycopg2://scott:tiger@host/dbname", executemany_mode='values', executemany_values_page_size=10000, executemany_batch_page_size=500) .. versionchanged:: 1.4 The default for ``executemany_values_page_size`` is now 1000, up from 100. .. seealso:: :ref:`tutorial_multiple_parameters` - General information on using the :class:`_engine.Connection` object to execute statements in such a way as to make use of the DBAPI ``.executemany()`` method. .. _psycopg2_unicode: Unicode with Psycopg2 ---------------------- The psycopg2 DBAPI driver supports Unicode data transparently. Under Python 2 only, the SQLAlchemy psycopg2 dialect will enable the ``psycopg2.extensions.UNICODE`` extension by default to ensure Unicode is handled properly; under Python 3, this is psycopg2's default behavior. The client character encoding can be controlled for the psycopg2 dialect in the following ways: * For PostgreSQL 9.1 and above, the ``client_encoding`` parameter may be passed in the database URL; this parameter is consumed by the underlying ``libpq`` PostgreSQL client library:: engine = create_engine("postgresql+psycopg2://user:pass@host/dbname?client_encoding=utf8") Alternatively, the above ``client_encoding`` value may be passed using :paramref:`_sa.create_engine.connect_args` for programmatic establishment with ``libpq``:: engine = create_engine( "postgresql+psycopg2://user:pass@host/dbname", connect_args={'client_encoding': 'utf8'} ) * For all PostgreSQL versions, psycopg2 supports a client-side encoding value that will be passed to database connections when they are first established. The SQLAlchemy psycopg2 dialect supports this using the ``client_encoding`` parameter passed to :func:`_sa.create_engine`:: engine = create_engine( "postgresql+psycopg2://user:pass@host/dbname", client_encoding="utf8" ) .. tip:: The above ``client_encoding`` parameter admittedly is very similar in appearance to usage of the parameter within the :paramref:`_sa.create_engine.connect_args` dictionary; the difference above is that the parameter is consumed by psycopg2 and is passed to the database connection using ``SET client_encoding TO 'utf8'``; in the previously mentioned style, the parameter is instead passed through psycopg2 and consumed by the ``libpq`` library. * A common way to set up client encoding with PostgreSQL databases is to ensure it is configured within the server-side postgresql.conf file; this is the recommended way to set encoding for a server that is consistently of one encoding in all databases:: # postgresql.conf file # client_encoding = sql_ascii # actually, defaults to database # encoding client_encoding = utf8 .. _psycopg2_disable_native_unicode: Disabling Native Unicode ^^^^^^^^^^^^^^^^^^^^^^^^ Under Python 2 only, SQLAlchemy can also be instructed to skip the usage of the psycopg2 ``UNICODE`` extension and to instead utilize its own unicode encode/decode services, which are normally reserved only for those DBAPIs that don't fully support unicode directly. Passing ``use_native_unicode=False`` to :func:`_sa.create_engine` will disable usage of ``psycopg2.extensions. UNICODE``. SQLAlchemy will instead encode data itself into Python bytestrings on the way in and coerce from bytes on the way back, using the value of the :func:`_sa.create_engine` ``encoding`` parameter, which defaults to ``utf-8``. SQLAlchemy's own unicode encode/decode functionality is steadily becoming obsolete as most DBAPIs now support unicode fully. Transactions ------------ The psycopg2 dialect fully supports SAVEPOINT and two-phase commit operations. .. _psycopg2_isolation_level: Psycopg2 Transaction Isolation Level ------------------------------------- As discussed in :ref:`postgresql_isolation_level`, all PostgreSQL dialects support setting of transaction isolation level both via the ``isolation_level`` parameter passed to :func:`_sa.create_engine` , as well as the ``isolation_level`` argument used by :meth:`_engine.Connection.execution_options`. When using the psycopg2 dialect , these options make use of psycopg2's ``set_isolation_level()`` connection method, rather than emitting a PostgreSQL directive; this is because psycopg2's API-level setting is always emitted at the start of each transaction in any case. The psycopg2 dialect supports these constants for isolation level: * ``READ COMMITTED`` * ``READ UNCOMMITTED`` * ``REPEATABLE READ`` * ``SERIALIZABLE`` * ``AUTOCOMMIT`` .. seealso:: :ref:`postgresql_isolation_level` :ref:`pg8000_isolation_level` NOTICE logging --------------- The psycopg2 dialect will log PostgreSQL NOTICE messages via the ``sqlalchemy.dialects.postgresql`` logger. When this logger is set to the ``logging.INFO`` level, notice messages will be logged:: import logging logging.getLogger('sqlalchemy.dialects.postgresql').setLevel(logging.INFO) Above, it is assumed that logging is configured externally. If this is not the case, configuration such as ``logging.basicConfig()`` must be utilized:: import logging logging.basicConfig() # log messages to stdout logging.getLogger('sqlalchemy.dialects.postgresql').setLevel(logging.INFO) .. seealso:: `Logging HOWTO `_ - on the python.org website .. _psycopg2_hstore: HSTORE type ------------ The ``psycopg2`` DBAPI includes an extension to natively handle marshalling of the HSTORE type. The SQLAlchemy psycopg2 dialect will enable this extension by default when psycopg2 version 2.4 or greater is used, and it is detected that the target database has the HSTORE type set up for use. In other words, when the dialect makes the first connection, a sequence like the following is performed: 1. Request the available HSTORE oids using ``psycopg2.extras.HstoreAdapter.get_oids()``. If this function returns a list of HSTORE identifiers, we then determine that the ``HSTORE`` extension is present. This function is **skipped** if the version of psycopg2 installed is less than version 2.4. 2. If the ``use_native_hstore`` flag is at its default of ``True``, and we've detected that ``HSTORE`` oids are available, the ``psycopg2.extensions.register_hstore()`` extension is invoked for all connections. The ``register_hstore()`` extension has the effect of **all Python dictionaries being accepted as parameters regardless of the type of target column in SQL**. The dictionaries are converted by this extension into a textual HSTORE expression. If this behavior is not desired, disable the use of the hstore extension by setting ``use_native_hstore`` to ``False`` as follows:: engine = create_engine("postgresql+psycopg2://scott:tiger@localhost/test", use_native_hstore=False) The ``HSTORE`` type is **still supported** when the ``psycopg2.extensions.register_hstore()`` extension is not used. It merely means that the coercion between Python dictionaries and the HSTORE string format, on both the parameter side and the result side, will take place within SQLAlchemy's own marshalling logic, and not that of ``psycopg2`` which may be more performant. )absolute_importN)UUID)ARRAY _ColonCast)_DECIMAL_TYPES) _FLOAT_TYPES) _INT_TYPES)ENUM) PGCompiler) PGDialect)PGExecutionContext)PGIdentifierPreparer)HSTORE)JSON)JSONB)exc) processors)types)util)cursor)collections_abczsqlalchemy.dialects.postgresqlceZdZdZdZy) _PGNumericcyN)selfdialects Z/var/www/html/venv/lib/python3.12/site-packages/sqlalchemy/dialects/postgresql/psycopg2.pybind_processorz_PGNumeric.bind_processorcZ|jr_|tvr.tjtj |j S|tvs|tvrytjd|z|tvry|tvs|tvrtjStjd|z)NzUnknown PG numeric type: %d) asdecimalr rto_decimal_processor_factorydecimalDecimal_effective_decimal_return_scaler r rInvalidRequestErrorto_floatr r!coltypes r"result_processorz_PGNumeric.result_processors >>,&!>>OOT%I%IN*g.C--1G;,&N*g.C!***--1G;r%N__name__ __module__ __qualname__r#r0rr%r"rrs r%rceZdZfdZxZS)_PGEnumcvtjr|jdurd|_tt|||S)NT force_nocheck)rpy2k_expect_unicodesuperr6r0r r!r/ __class__s r"r0z_PGEnum.result_processor0s5 99--5$3D Wd4WgFFr%)r2r3r4r0 __classcell__r=s@r"r6r6/s G Gr%r6c(eZdZfdZfdZxZS) _PGHStorecD|jrytt||Sr)_has_native_hstorer;rAr#)r r!r=s r"r#z_PGHStore.bind_processor@s!  % %D8A Ar%cF|jrytt|||Sr)rCr;rAr0r<s r"r0z_PGHStore.result_processorFs#  % %D:7GL Lr%)r2r3r4r#r0r>r?s@r"rArA?sB MMr%rAceZdZdZy)_PGARRAYct||Srr)r bindvalues r"bind_expressionz_PGARRAY.bind_expressionNs)T**r%N)r2r3r4rIrr%r"rFrFMs+r%rFceZdZdZy)_PGJSONcyrrr.s r"r0z_PGJSON.result_processorSr$r%Nr2r3r4r0rr%r"rKrKRr%rKceZdZdZy)_PGJSONBcyrrr.s r"r0z_PGJSONB.result_processorXr$r%NrMrr%r"rPrPWrNr%rPceZdZdZdZy)_PGUUIDc@|js|jrd}|Syy)Nc | t|}|Sr) _python_UUIDvalues r"processz'_PGUUID.bind_processor..process`s$(/E r%as_uuiduse_native_uuid)r r!rYs r"r#z_PGUUID.bind_processor]$|| 7 7  N!8|r%c@|js|jrd}|Syy)Nc | t|}|Sr)strrWs r"rYz)_PGUUID.result_processor..processjs$JE r%rZ)r r!r/rYs r"r0z_PGUUID.result_processorgr]r%Nr1rr%r"rSrS\s r%rSc"eZdZdZdZdZdZy)PGExecutionContext_psycopg2Ncdtt|dddttdd}|jj |S)Nc__)hexid_server_side_id_dbapi_connectionr)r idents r"create_server_side_cursorz5PGExecutionContext_psycopg2.create_server_side_cursorxsC!D]12.O4E0Fqr0JK%%,,U33r%c|jrU|jrI|jjr3tj}||j |j|_|j|j y)N)initial_buffer)_psycopg2_fetched_rowscompiled returning_cursor FullyBufferedCursorFetchStrategyrcursor_fetch_strategy _log_notices)r strat_clss r" post_execz%PGExecutionContext_psycopg2.post_exec~s\  ' '  '' @@I)2 D,G,G*D & $++&r%c<|jjr.t|jjtjsy|jjD]%}t j |j'g|jjddyr) connectionnotices isinstancerIterableloggerinforstrip)r rnotices r"ruz(PGExecutionContext_psycopg2._log_noticess}   ((    % %'?'?1  ''// )F KK  ( ) (*!!!$r%)r2r3r4rorlrwrurr%r"rbrbus!4 '&*r%rbc eZdZy)PGCompiler_psycopg2Nr2r3r4rr%r"rrr%rc eZdZy)PGIdentifierPreparer_psycopg2Nrrr%r"rrrr%rexecutemany_plain) canonicalexecutemany_batchexecutemany_valuesreexecutemany_values_plus_batchc*eZdZdZdZej rdZdZdZ dZ e Z e ZeZdZdZej(j+dej,iZej.ej0ej4eeeej<eee e!e"ejBe"e#e$e%e&ejNe(i Z ddZ)fdZ*e+d Z,e+d Z-e+d Z.ej^d Z0d Z1dZ2dZ3dZ4dZ5dZ6dZ7ddZ8ejrdZ:dZ;dZ<xZ=S)PGDialect_psycopg2psycopg2TFpyformat)rruse_native_unicodec tj|fi|||_|s%tjst j d|sd|_||_||_ ||_ ||_ tjj|tdgtdgt dgt"ddgid|_|j$t zrd|_||_||_|j,rt/|j,d rot1j2d |j,j4} | r(t7d | j9d d dD|_|j:dkr t=dyyy)Nz7psycopg2 native_unicode mode is required under Python 3Fbatch values_onlyvalues_plus_batchvaluesexecutemany_modeT __version__z(\d+)\.(\d+)(?:\.(\d+))?c38K|]}|t|ywr)int).0xs r" z.PGDialect_psycopg2.__init__..s.  CF.srrer)rez+psycopg2 version 2.7 or higher is required.)r__init__rrr9r ArgumentErrorrCuse_native_hstorer\supports_unicode_bindsclient_encodingsymbolparse_user_argumentEXECUTEMANY_PLAINEXECUTEMANY_BATCHEXECUTEMANY_VALUESEXECUTEMANY_VALUES_PLUS_BATCHrinsert_executemany_returningexecutemany_batch_page_sizeexecutemany_values_page_sizedbapihasattrrematchrtuplegrouppsycopg2_version ImportError) r rrrr\rrrkwargsms r"rzPGDialect_psycopg2.__init__s_ 4*6*"4!$))##I !&+D #!2.&8#.!% ? ? !D6!G9"]O-0CX/N    !   #5 504D -+F(,H) ::'$**m<4djj6L6LMA(-.$%GGAq!$4.)%$$v-!A.=:r%ctt| ||jxr|j |j du|_|jsd|_t|_ |jtz |_ y)NF) r;r initializer _hstore_oidsryrCfull_returningrrrrsupports_sane_multi_rowcount)r ryr=s r"rzPGDialect_psycopg2.initializesy  $2:>  " " E!!*"7"78D ""05D -$5D !  ! !$5 5- )r%cddl}|S)Nr)r)clsrs r"rzPGDialect_psycopg2.dbapi)s r%cddlm}|S)Nr) extensions)rr)rrs r"_psycopg2_extensionsz'PGDialect_psycopg2._psycopg2_extensions/s 'r%cddlm}|S)Nr)extras)rr)rrs r"_psycopg2_extrasz#PGDialect_psycopg2._psycopg2_extras5s # r%c|j}|j|j|j|j|j dS)N) AUTOCOMMITzREAD COMMITTEDzREAD UNCOMMITTEDzREPEATABLE READ SERIALIZABLE)rISOLATION_LEVEL_AUTOCOMMITISOLATION_LEVEL_READ_COMMITTED ISOLATION_LEVEL_READ_UNCOMMITTEDISOLATION_LEVEL_REPEATABLE_READISOLATION_LEVEL_SERIALIZABLE)r rs r"_isolation_lookupz$PGDialect_psycopg2._isolation_lookup;sG..0 $??(GG * K K)II&CC   r%c > |j|jdd}|j|y#t$r`}tjt j d|d|jddj|j|Yd}~vd}~wwxYw)Nrf zInvalid value 'z2' for isolation_level. Valid isolation levels for z are z, )replace_context) rreplaceKeyErrorrraise_rrnamejoinset_isolation_level)r rylevelerrs r"rz&PGDialect_psycopg2.set_isolation_levelFs **5==c+BCE &&u-  KK!!dii43I3I)JL !$    s3 BABBc||_yrreadonlyr ryrXs r" set_readonlyzPGDialect_psycopg2.set_readonlyUs # r%c|jSrrr rys r" get_readonlyzPGDialect_psycopg2.get_readonlyXs"""r%c||_yr deferrablers r"set_deferrablez!PGDialect_psycopg2.set_deferrable[s % r%c|jSrrrs r"get_deferrablez!PGDialect_psycopg2.get_deferrable^s$$$r%cd}|j} |sd|_|j} |j|j|j |s|j s||_y#|j |s|j s||_wwwxYw#|j j$r}|j|||rYd}~yd}~wwxYw)NTF) autocommitrexecute_dialect_specific_select_onecloseclosedrError is_disconnect)r dbapi_connectionrbefore_autocommitrs r"do_pingzPGDialect_psycopg2.do_pingas,77 $.2 +%,,.F Dt@@A (1A1H1H2C$/ (1A1H1H2C$/2I(zz !!#'7@  s4BA+%B+)BBC0C C  Cc~jjgjfd}j|jfd}j|j r"j rfd}j|tjr.j r"jrfd}j|j r#jrfd}j|j r#jrfd}j|rfd}|Sy)Nc<|jjyr)set_client_encodingrconnr s r" on_connectz1PGDialect_psycopg2.on_connect..on_connect}s(()=)=>r%c>j|jyr)risolation_levelrs r"rz1PGDialect_psycopg2.on_connect..on_connects((t/C/CDr%c*jd|yr) register_uuid)rrs r"rz1PGDialect_psycopg2.on_connect..on_connects$$T40r%cvjj|jj|yr) register_typeUNICODE UNICODEARRAY)rrs r"rz1PGDialect_psycopg2.on_connect..on_connects/((););TB(()@)@$Gr%cj|}|7|\}}d|i}tjrd|d<||d<j|fi|yy)NoidTunicode array_oid)rrr9register_hstore)r hstore_oidsrrkwrr s r"rz1PGDialect_psycopg2.on_connect..on_connects^"//5 *%0NCByy(,9 &/B{O*F**4626 +r%czj|jj|jy)N)loads)register_default_json_json_deserializerregister_default_jsonb)rrr s r"rz1PGDialect_psycopg2.on_connect..on_connectsA,, 7 7--- 7 7.r%c$D] }|| yrr)rfnfnss r"rz1PGDialect_psycopg2.on_connect..on_connectsBtHr%) rrrappendrrr\rr9rrr)r rrrr s` @@@r"rzPGDialect_psycopg2.on_connectvs&&(..0     + ? JJz "    + E JJz " ::$.. 1 JJz " 99(?(? H JJz " ::$00 7 JJz " ::$11  JJz "   r%c|jtzrk|ri|jr]|jjrGd|jj z}|j s|j|j}||vrd}nd}|rz|j|d}|jrd|ji}ni}|j}|j|||f|t|jjd||_y|jt zrA|j"rd|j"i}ni}|jj$|||fi|y|j'||y)Nz(%s)z%s page_size)templatefetch)rrisinsertrp&_is_safe_for_fast_insert_values_helperinsert_single_values_exprsupports_unicode_statementsencodeencodingrrrexecute_valuesboolrqrorr execute_batch executemany)r r statement parameterscontextrrxtrass r"do_executemanyz!PGDialect_psycopg2.do_executemanysn  ! !$6 6    GG))CCC 33%7%>%>t}}%M""2%)"!%  !))*++H #xxV : D$< #s Dct||jjrRt|ddryt |j dd}dD]"}|j |}|dk\sd|d|vs"yy)NrFT r)zterminating connectionzclosed the connectionzconnection not openz"could not receive data from serverzcould not send data to serverzconnection already closedzcursor already closedz!losed the connection unexpectedlyz'connection has been closed unexpectedlyz.SSL error: decryption failed or bad record macz&SSL SYSCALL error: Bad file descriptorzSSL SYSCALL error: EOF detectedz&SSL SYSCALL error: Operation timed outzSSL SYSCALL error: Bad address")r{rrgetattrr` partitionfind)r eryrstr_emsgidxs r"rz PGDialect_psycopg2.is_disconnects~ a)) * z8U3F$$T*1-E .jjo!85#; 63 4r%)TNTTrdir)>r2r3r4driversupports_statement_cacherr9rsupports_server_side_cursorsdefault_paramstylerrbexecution_ctx_clsrstatement_compilerrpreparerrrCrengine_config_typesunionasbool update_copycolspecssqltypesNumericrr r6EnumrrArrKrrPrrSrrFrr classmethodrrrmemoized_propertyrrrrrrrrr memoized_instancemethodrr9rr>r?s@r"rrs F# yy',##' ##( 3,,H#77== t{{+ t   j ' MM7 I ' MM7 8 ' NNH  H" &$'%)5n "       .$#&%*DL,6\ !!"  D&r%r);__doc__ __future__rr)loggingruuidrrVarrayrPGARRAYbaserr r r r r rrrhstorerjsonrrr+rrrrQrenginerrrr getLoggerr}rRrr6rArFrKrPrScounterrirbrrrrrrrrr!rr%r"rcssjV' %# $&!'#   ; <!!: Gd G M M+w+ d u d,$,,.+*"4+*\ *  $8  DKK 3qADKK 3qA T[[!5C + #"44! IIX r%