OwlCyberSecurity - MANAGER
Edit File: reflection.cpython-312.pyc
� ̓�gw& � �@ � d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ ddlm Z ddl m Z dd l m Z dd l m Z dd l mZ dd l mZ dd l mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddlmZ ddlmZ ddl m Z ddl m Z dd l m Z dd l m Z dd l m!Z! dd l m"Z# dd l$m%Z% dd!l&m'Z' dd"l&m(Z( dd#l)m*Z* dd$l+m,Z, dd%l m-Z- dd&l.m/Z/ er6dd'l0m1Z1 dd(l0m2Z2 dd)l0m3Z3 dd*l0m4Z4 dd+l0m5Z5 dd,l0m6Z6 dd-l0m7Z7 dd.l0m8Z8 dd/l0m9Z9 ed0� Z:e jv d=d1�� Z< d>d2�Z=e G d3� d4e� � Z>e G d5� d6e� � Z?e j� G d7� d8e j� d8 � � ZBe/ G d9� d:� � ZCe G d;� d<� � ZDy)?a� Provides an abstraction for obtaining database schema information. Usage Notes: Here are some general conventions when accessing the low level inspector methods such as get_table_names, get_columns, etc. 1. Inspector methods return lists of dicts in most cases for the following reasons: * They're both standard types that can be serialized. * Using a dict instead of a tuple allows easy expansion of attributes. * Using a list for the outer structure maintains order and is easy to work with (e.g. list comprehension [d['name'] for d in cols]). 2. Records that contain a name, such as the column name in a column record use the key 'name'. So for most return values, each record will have a 'name' attribute.. � )� annotationsN)� dataclass)�auto)�Flag)�unique)�Any)�Callable)� Collection)�Dict)� Generator)�Iterable)�List)�Optional)�Sequence)�Set)�Tuple)� TYPE_CHECKING)�TypeVar)�Union� )� Connection)�Engine� )�exc)� inspection)�sql)�util)� operators)�schema)�_ad_hoc_cache_key_from_args)� quoted_name)� TextClause)� TypeEngine)�InternalTraversal)� topological)�final)�Dialect)�ReflectedCheckConstraint)�ReflectedColumn)� ReflectedForeignKeyConstraint)�ReflectedIndex)� ReflectedPrimaryKeyConstraint)�ReflectedTableComment)�ReflectedUniqueConstraint)�TableKey�_Rc � �� |j dd � }|� | ||g|��i |��S ddh�| j t d� |D � � t �fd�|j � D � � f}|j |� }|� | ||g|��i |��}|||< |S )N� info_cache� unreflectablec 3 � K � | ]= }t |t � r+t |t � rt |� |j fn|�� �? y �w�N)� isinstance�strr! �quote)�.0�as �M/opt/hc_python/lib64/python3.12/site-packages/sqlalchemy/engine/reflection.py� <genexpr>zcache.<locals>.<genexpr>] s= � �� � ����!�S�!� ",�A�{�!;�S��V�Q�W�W� �� B��s �AAc 3 � �K � | ]6 \ }}|�vr-|t |t � rt |� |j fn|f�� �8 y �wr5 )r6 r! r7 r8 )r9 �k�v�excludes �r; r< zcache.<locals>.<genexpr>b sB �� �� � �"���1��� � �Z��;�%?��Q�����!�Q� G�"�s �<?)�get�__name__�tuple�items) �fn�self�con�args�kwr2 �key�retr@ s @r; �cacherL O s� �� � ��� �d�+�J����$��)�d�)�b�)�)��_�-�G� � � � � �� � � � ���� � � � �C� �n�n�S�!�C� �{���s�(�T�(�R�(�� � �3�� �J� c �R � � t j d� fd� � }|S )Nc �� �� |j dd � }|� | ||g|��i |��S t | j f�|� }|j |� }|� | ||g|��i |��}|||< |S )Nr2 )rA r rB ) rE rF rG rH rI r2 rJ rK � traverse_argss �r; �gozflexi_cache.<locals>.gor s} �� � �V�V�L�$�/� � � ��d�C�-�$�-�"�-� -�)�2�;�;�.�-��N�� �.�.��%�� �;��T�3�,��,��,�C� !�J�s�O�� rM � rE zCallable[..., _R]rF r' rG r rH r rI r �returnr0 )r � decorator)rP rQ s ` r; � flexi_cacherU o sZ �� � �^�^�� ���� �� � � � � � � ��" �IrM c �\ � e Zd ZdZ e� Z e� Z e� Z eez Z eez ez Z y)� ObjectKinda� Enumerator that indicates which kind of object to return when calling the ``get_multi`` methods. This is a Flag enum, so custom combinations can be passed. For example, to reflect tables and plain views ``ObjectKind.TABLE | ObjectKind.VIEW`` may be used. .. note:: Not all dialect may support all kind of object. If a dialect does not support a particular object an empty dict is returned. In case a dialect supports an object, but the requested method is not applicable for the specified kind the default value will be returned for each reflected object. For example reflecting check constraints of view return a dict with all the views with empty lists as values. N) rB � __module__� __qualname__�__doc__r �TABLE�VIEW�MATERIALIZED_VIEW�ANY_VIEW�ANY� rM r; rW rW � sH � ��" �F�E�� �6�D� � ���&��'�'�H�&� �$�,�*� *�C�!rM rW c �: � e Zd ZdZ e� Z e� Z eez Zy)� ObjectScopez]Enumerator that indicates which scope to use when calling the ``get_multi`` methods. N)rB rX rY rZ r �DEFAULT� TEMPORARYr_ r` rM r; rb rb � s* � �� �f�G����I� � �I� �C�)rM rb c �� � e Zd ZU dZded< ded< ded< ded < d ed < ej d d � dFd�� Ze dGd�� Z dHd�Z dId�Z dJd�Z dKd�Z e ej d d� dLd�� � Z ej e� dLd�� Z ej e� dMd�� Zej, dNd�� Zej, dOd�� ZedPd�� ZdQd�Z d# dRd �Z d# dSd �Z d# dTd �Z d# dUd �Z dVd!�Z d# dWd"�Z! dX dYd$�Z"dQd%�Z#dQd&�Z$ d# dZd'�Z%d d e&jN e(jR f d[d(�Z* d# dRd)�Z+ d# dRd*�Z, d# dRd+�Z- d# d\d,�Z. d# d]d-�Z/ d^d.�Z0d d e&jN e(jR f d_d/�Z1 d# d`d0�Z2d d e&jN e(jR f dad1�Z3 d# dbd2�Z4d d e&jN e(jR f dcd3�Z5 d# ddd4�Z6d d e&jN e(jR f ded5�Z7 d# dfd6�Z8d d e&jN e(jR f dgd7�Z9 d# dhd8�Z:d d e&jN e(jR f did9�Z; d# djd:�Z<d d e&jN e(jR f dkd;�Z= dl dmd<�Z> dnd=�Z? dod>�Z@ dpd?�ZAeBj� eBj� eBj� eBj� d@�ZG dqdA�ZH dqdB�ZI dqdC�ZJ drdD�ZK ds dtdE�ZLy )u� Inspectora= Performs database schema inspection. The Inspector acts as a proxy to the reflection methods of the :class:`~sqlalchemy.engine.interfaces.Dialect`, providing a consistent interface as well as caching support for previously fetched metadata. A :class:`_reflection.Inspector` object is usually created via the :func:`_sa.inspect` function, which may be passed an :class:`_engine.Engine` or a :class:`_engine.Connection`:: from sqlalchemy import inspect, create_engine engine = create_engine("...") insp = inspect(engine) Where above, the :class:`~sqlalchemy.engine.interfaces.Dialect` associated with the engine may opt to return an :class:`_reflection.Inspector` subclass that provides additional methods specific to the dialect's target database. �Union[Engine, Connection]�bindr �engine�bool� _op_context_requires_connectr' �dialectzDict[Any, Any]r2 z1.4a The __init__() method on :class:`_reflection.Inspector` is deprecated and will be removed in a future release. Please use the :func:`.sqlalchemy.inspect` function on an :class:`_engine.Engine` or :class:`_engine.Connection` in order to acquire an :class:`_reflection.Inspector`.c �& � | j |� y)a� Initialize a new :class:`_reflection.Inspector`. :param bind: a :class:`~sqlalchemy.engine.Connection`, which is typically an instance of :class:`~sqlalchemy.engine.Engine` or :class:`~sqlalchemy.engine.Connection`. For a dialect-specific instance of :class:`_reflection.Inspector`, see :meth:`_reflection.Inspector.from_engine` N)� _init_legacy�rF rh s r; �__init__zInspector.__init__� s � �. ���$� rM c � � t |j d� r|j j } | j | � } |||� |S )N� inspector)�hasattrrl rr �__new__)�cls�initrh rF s r; � _constructzInspector._construct� s> � � �4�<�<�� -��,�,�(�(�C��{�{�3� �� �T�4��� rM c �b � t |d� r| j |� y | j |� y )N�exec_driver_sql)rs �_init_connection� _init_enginero s r; rn zInspector._init_legacy� s) � � �4�*� +� � !� !�$� '� � � �d� #rM c � � |x| _ | _ |j � j � d| _ | j j | _ i | _ y )NT)rh ri �connect�closerk rl r2 )rF ri s r; r{ zInspector._init_engine� sC � �"(�(�� �D�K����� � � �,0��)��{�{�*�*�� � ��rM c � � || _ |j | _ d| _ | j j | _ i | _ y )NF)rh ri rk rl r2 )rF � connections r; rz zInspector._init_connection s6 � � �� � �'�'�� �,1��)��{�{�*�*�� � ��rM c �8 � | j j � y)z�reset the cache for this :class:`.Inspector`. Inspection methods that have data cached will emit SQL queries when next called to get new data. .. versionadded:: 2.0 N)r2 �clear�rF s r; � clear_cachezInspector.clear_cache s � � ��� � � rM a The from_engine() method on :class:`_reflection.Inspector` is deprecated and will be removed in a future release. Please use the :func:`.sqlalchemy.inspect` function on an :class:`_engine.Engine` or :class:`_engine.Connection` in order to acquire an :class:`_reflection.Inspector`.c �: � | j | j |� S )aZ Construct a new dialect-specific Inspector object from the given engine or connection. :param bind: a :class:`~sqlalchemy.engine.Connection` or :class:`~sqlalchemy.engine.Engine`. This method differs from direct a direct constructor call of :class:`_reflection.Inspector` in that the :class:`~sqlalchemy.engine.interfaces.Dialect` is given a chance to provide a dialect-specific :class:`_reflection.Inspector` instance, which may provide additional methods. See the example at :class:`_reflection.Inspector`. )rw rn )ru rh s r; � from_enginezInspector.from_engine s � �: �~�~�c� .� .��5�5rM c �J � t j t j | � S r5 )rf rw r{ �rh s r; � _engine_inspzInspector._engine_insp7 s � ��#�#�I�$:�$:�D�A�ArM c �J � t j t j | � S r5 )rf rw rz r� s r; �_connection_inspzInspector._connection_insp; s � ��#�#�I�$>�$>��E�ErM c # � K � | j r| j j � }n | j } |�� | j r|j � yy# | j r|j � w w xY w�w)a Return a context that optimizes for multiple operations on a single transaction. This essentially allows connect()/close() to be called if we detected that we're against an :class:`_engine.Engine` and not a :class:`_engine.Connection`. N)rk rh r} r~ )rF �conns r; �_operation_contextz Inspector._operation_context? sd � �� � � ,� ,��9�9�$�$�&�D��9�9�D� ��J��0�0�� � � � 1��t�0�0�� � � � 1�s �4A;�A � A;� A8�8A;c # �� K � | j � 5 }| j | j j |� }| j |_ |�� ddd� y# 1 sw Y yxY w�w)z�Return an :class:`_reflection.Inspector` from this one that will run all operations on a single connection. N)r� rw � __class__rz r2 )rF r� �sub_insps r; �_inspection_contextz Inspector._inspection_contextT sL � �� � � $� $� &�$����t�~�~�'F�'F��M�H�"&�/�/�H� ��N� '� &� &�s �A$�<A� A$�A!� A$c �. � | j j S )z�Return the default schema name presented by the dialect for the current engine's database user. E.g. this is typically ``public`` for PostgreSQL and ``dbo`` for SQL Server. )rl �default_schema_namer� s r; r� z Inspector.default_schema_namea s � � �|�|�/�/�/rM c � � | j � 5 } | j j |fd| j i|��cddd� S # 1 sw Y yxY w)z�Return all schema names. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. r2 N)r� rl �get_schema_namesr2 �rF rI r� s r; r� zInspector.get_schema_namesl sI � � � $� $� &�$�0�4�<�<�0�0���!%� � ��46�� '� &� &�� �)A�A Nc � � | j � 5 } | j j ||fd| j i|��cddd� S # 1 sw Y yxY w)a� Return all table names within a particular schema. The names are expected to be real tables only, not views. Views are instead returned using the :meth:`_reflection.Inspector.get_view_names` and/or :meth:`_reflection.Inspector.get_materialized_view_names` methods. :param schema: Schema name. If ``schema`` is left at ``None``, the database's default schema is used, else the named schema is searched. If the database does not support named schemas, behavior is undefined if ``schema`` is not passed as ``None``. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. seealso:: :meth:`_reflection.Inspector.get_sorted_table_and_fkc_names` :attr:`_schema.MetaData.sorted_tables` r2 N)r� rl �get_table_namesr2 �rF r rI r� s r; r� zInspector.get_table_namesy sK � �8 � $� $� &�$�/�4�<�<�/�/��f��)-� � ��<>�� '� &� &�� �*A�Ac � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a Return True if the backend has a table, view, or temporary table of the given name. :param table_name: name of the table to check :param schema: schema name to query, if not the default schema. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. versionadded:: 1.4 - the :meth:`.Inspector.has_table` method replaces the :meth:`_engine.Engine.has_table` method. .. versionchanged:: 2.0:: :meth:`.Inspector.has_table` now formally supports checking for additional table-like objects: * any type of views (plain or materialized) * temporary tables of any kind Previously, these two checks were not formally specified and different dialects would vary in their behavior. The dialect testing suite now includes tests for all of these object types and should be supported by all SQLAlchemy-included dialects. Support among third party dialects may be lagging, however. r2 N)r� rl � has_tabler2 �rF � table_namer rI r� s r; r� zInspector.has_table� sM � �8 � $� $� &�$�)�4�<�<�)�)��j�&��59�_�_��HJ�� '� &� &�� �+A�Ac � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a� Return True if the backend has a sequence with the given name. :param sequence_name: name of the sequence to check :param schema: schema name to query, if not the default schema. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. versionadded:: 1.4 r2 N)r� rl � has_sequencer2 )rF � sequence_namer rI r� s r; r� zInspector.has_sequence� sM � � � $� $� &�$�,�4�<�<�,�,��m�V��8<����KM�� '� &� &�r� c � � | j � 5 } | j j ||||fd| j i|��cddd� S # 1 sw Y yxY w)a� Check the existence of a particular index name in the database. :param table_name: the name of the table the index belongs to :param index_name: the name of the index to check :param schema: schema name to query, if not the default schema. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. versionadded:: 2.0 r2 N)r� rl � has_indexr2 )rF r� � index_namer rI r� s r; r� zInspector.has_index� sV � �& � $� $� &�$�)�4�<�<�)�)����� � �?�?� � � � '� &� &�s �,A�Ac � � | j � 5 } | j j ||fd| j i|��cddd� S # 1 sw Y yxY w)aT Return True if the backend has a schema with the given name. :param schema_name: name of the schema to check :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. versionadded:: 2.0 r2 N)r� rl � has_schemar2 )rF � schema_namerI r� s r; r� zInspector.has_schema� sK � � � $� $� &�$�*�4�<�<�*�*��k��.2�o�o��AC�� '� &� &�r� c � � | j |f�� D �����cg c]* \ }}|r|d nd|D ���cg c] \ \ }}}||f�� c}}}f��, c}}}}}S c c}}}w c c}}}}}w )ag Return dependency-sorted table and foreign key constraint names in referred to within a particular schema. This will yield 2-tuples of ``(tablename, [(tname, fkname), (tname, fkname), ...])`` consisting of table names in CREATE order grouped with the foreign key constraint names that are not detected as belonging to a cycle. The final element will be ``(None, [(tname, fkname), (tname, fkname), ..])`` which will consist of remaining foreign key constraint names that would require a separate CREATE step after-the-fact, based on dependencies between tables. :param schema: schema name to query, if not the default schema. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. seealso:: :meth:`_reflection.Inspector.get_table_names` :func:`.sort_tables_and_constraints` - similar method which works with an already-given :class:`_schema.MetaData`. )�consider_schemasr N)�%sort_tables_on_foreign_key_dependency)rF r rI � table_key� fk_collection�_�tname�fkss r; � get_sorted_table_and_fkc_namesz(Inspector.get_sorted_table_and_fkc_names� s} � �P �;�;�"(�� <� � ���� � !*� �!� �t�5B�C�]�/�*�1�e�c�%�� �]�C� �� � �� D�� s �A �A�A �A r5 c � �� t t t t f }t � }t � }i }g }|D ]� } | j |fi |��} |j | � | j � D ]U \ \ } } } | D � ch c] } | d �� c} ||| f< | D ]0 }| |d k7 s ||d k7 s�|j |d |d f|| ff� �2 �W �� t t j ||� � }|D �� � cg c]8 \ }} || f||| f j! d� |D � � D � cg c] } || f| f�� c} f��: }} }} |dt |� fgz S c c} w # t j $ rk}|j D ]3 �|j �� |j �fd�|�d D � � �5 t t j ||� � }Y d}~��d}~ww xY wc c} w c c} } }w )a� Return dependency-sorted table and foreign key constraint names referred to within multiple schemas. This method may be compared to :meth:`.Inspector.get_sorted_table_and_fkc_names`, which works on one schema at a time; here, the method is a generalization that will consider multiple schemas at once including that it will resolve for cross-schema foreign keys. .. versionadded:: 2.0 �name�referred_table�referred_schemac 3 �, �K � | ] }�d |f�� � y�w)r Nr` )r9 �fkc�edges �r; r< zBInspector.sort_tables_on_foreign_key_dependency.<locals>.<genexpr>` s �� �� � &�.H�s�T�!�W�c�N�.H�s �r Nc 3 �& K � | ] \ }}|�� � y �wr5 r` )r9 r� r� s r; r< zBInspector.sort_tables_on_foreign_key_dependency.<locals>.<genexpr>m s � �� � M�,:���D��N�s �)r r r7 �set�get_multi_foreign_keys�extendrD �add�listr% �sortr �CircularDependencyError�edges�remove�update� difference)rF r� rI � SchemaTab�tuples�remaining_fkcs�fknames_for_table�tnames�schname� schema_fkeysr� r� �fkeys�fk�fkey�candidate_sort�errrK r� s @r; r� z/Inspector.sort_tables_on_foreign_key_dependency( s9 �� �, �(�3�-��,�-� �36�5��?B�u��AC��"$��'�G�6�4�6�6�w�E�"�E�L� �M�M�,� '�%1�%7�%7�%9�!� ��E�E�).�7�).�2�B�v�J��7�!�7�E�"2�3� "�D� ��&6�!7�7�"�d�+<�&=�=� � � � %)�):�$;�$(�)9�$:�!"� ")�%� 0� �� "� &:� (�* D� !�+�"2�"2�6�6�"B� C�N�. %3� � %3� ��%� �%� � 0��%�0@� A� L� L� M�,:�M� �� �� �u�%�r�*� �� � %3� � � �t�T�.� 1�2�3�3�3��W7��& �*�*� D�� � ��� � �d�#� �%�%� &�.?��Q��.H�&� � "� "�+�"2�"2�6�6�"B� C�N�� D�� �� s7 �: D?� E �-*G � G�$G �G�A!F=�=G�G c � � | j � 5 } | j j |fd| j i|��cddd� S # 1 sw Y yxY w)a� Return a list of temporary table names for the current bind. This method is unsupported by most dialects; currently only Oracle Database, PostgreSQL and SQLite implements it. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. r2 N)r� rl �get_temp_table_namesr2 r� s r; r� z Inspector.get_temp_table_namesv sI � � � $� $� &�$�4�4�<�<�4�4���!%� � ��46�� '� &� &�r� c � � | j � 5 } | j j |fd| j i|��cddd� S # 1 sw Y yxY w)an Return a list of temporary view names for the current bind. This method is unsupported by most dialects; currently only PostgreSQL and SQLite implements it. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. r2 N)r� rl �get_temp_view_namesr2 r� s r; r� z Inspector.get_temp_view_names� sI � � � $� $� &�$�3�4�<�<�3�3���!%� � ��46�� '� &� &�r� c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)az Return a dictionary of options specified when the table of the given name was created. This currently includes some options that apply to MySQL and Oracle Database tables. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dict with the table options. The returned keys depend on the dialect in use. Each one is prefixed with the dialect name. .. seealso:: :meth:`Inspector.get_multi_table_options` r2 N)r� rl �get_table_optionsr2 r� s r; r� zInspector.get_table_options� sM � �4 � $� $� &�$�1�4�<�<�1�1��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 } | j j |f||||| j d�|��}t |� cddd� S # 1 sw Y yxY w)a� Return a dictionary of options specified when the tables in the given schema were created. The tables can be filtered by passing the names to use to ``filter_names``. This currently includes some options that apply to MySQL and Oracle tables. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if options of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are dictionaries with the table options. The returned keys in each dict depend on the dialect in use. Each one is prefixed with the dialect name. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_table_options` �r � filter_names�kind�scoper2 N)r� rl �get_multi_table_optionsr2 �dict)rF r r� r� r� rI r� �ress r; r� z!Inspector.get_multi_table_options� sc � �Z � $� $� &�$�6�$�,�,�6�6��� � )��� �?�?� � ��C� ��9� '� &� &�s �8A�A c � � | j � 5 } | j j ||fd| j i|��cddd� S # 1 sw Y yxY w)a Return all non-materialized view names in `schema`. :param schema: Optional, retrieve names from a non-default schema. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. versionchanged:: 2.0 For those dialects that previously included the names of materialized views in this list (currently PostgreSQL), this method no longer returns the names of materialized views. the :meth:`.Inspector.get_materialized_view_names` method should be used instead. .. seealso:: :meth:`.Inspector.get_materialized_view_names` r2 N)r� rl �get_view_namesr2 r� s r; r� zInspector.get_view_names� sK � �0 � $� $� &�$�.�4�<�<�.�.��f��)-� � ��<>�� '� &� &�r� c � � | j � 5 } | j j ||fd| j i|��cddd� S # 1 sw Y yxY w)a� Return all materialized view names in `schema`. :param schema: Optional, retrieve names from a non-default schema. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. .. versionadded:: 2.0 .. seealso:: :meth:`.Inspector.get_view_names` r2 N)r� rl �get_materialized_view_namesr2 r� s r; r� z%Inspector.get_materialized_view_names sK � �& � $� $� &�$�;�4�<�<�;�;��f��)-� � ��<>�� '� &� &�r� c � � | j � 5 } | j j ||fd| j i|��cddd� S # 1 sw Y yxY w)ak Return all sequence names in `schema`. :param schema: Optional, retrieve names from a non-default schema. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. r2 N)r� rl �get_sequence_namesr2 r� s r; r� z Inspector.get_sequence_names$ sK � � � $� $� &�$�2�4�<�<�2�2��f��)-� � ��<>�� '� &� &�r� c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a� Return definition for the plain or materialized view called ``view_name``. :param view_name: Name of the view. :param schema: Optional, retrieve names from a non-default schema. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. r2 N)r� rl �get_view_definitionr2 )rF � view_namer rI r� s r; r� z Inspector.get_view_definition6 sM � � � $� $� &�$�3�4�<�<�3�3��i���48�O�O��GI�� '� &� &�r� c �� � | j � 5 } | j j |||fd| j i|��}ddd� r| j |g� |S # 1 sw Y � xY w)aJ Return information about columns in ``table_name``. Given a string ``table_name`` and an optional string ``schema``, return column information as a list of :class:`.ReflectedColumn`. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: list of dictionaries, each representing the definition of a database column. .. seealso:: :meth:`Inspector.get_multi_columns`. r2 N)r� rl � get_columnsr2 �_instantiate_types)rF r� r rI r� �col_defss r; r� zInspector.get_columnsJ sk � �4 � $� $� &�$�/�t�|�|�/�/��j�&��59�_�_��HJ��H� '� � � #� #�X�J� /��� '� &�s �,A�A$c �` � |D ]) }|D ]" }|d }t |t � r� |� |d< �$ �+ y )N�type)r6 r# )rF �datar� �col_def�coltypes r; r� z Inspector._instantiate_typesl s6 � � �H�#��!�&�/��!�'�:�6�&-�i�G�F�O� $� rM c � � | j � 5 }t | j j |f||||| j d�|��� }ddd� | j j � � |S # 1 sw Y �*xY w)aW Return information about columns in all objects in the given schema. The objects can be filtered by passing the names to use to ``filter_names``. For each table the value is a list of :class:`.ReflectedColumn`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if columns of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are list of dictionaries, each representing the definition of a database column. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_columns` r� N)r� r� rl �get_multi_columnsr2 r� �values)rF r r� r� r� rI r� �table_col_defss r; r� zInspector.get_multi_columnsv s� � �X � $� $� &�$� !�.�� � �.�.���!�!-� � � #��� � �� �N� '� � � �� 5� 5� 7�8� � � '� &�s �7A1�1A:c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a` Return information about primary key constraint in ``table_name``. Given a string ``table_name``, and an optional string `schema`, return primary key information as a :class:`.ReflectedPrimaryKeyConstraint`. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary representing the definition of a primary key constraint. .. seealso:: :meth:`Inspector.get_multi_pk_constraint` r2 N)r� rl �get_pk_constraintr2 r� s r; r� zInspector.get_pk_constraint� sM � �0 � $� $� &�$�1�4�<�<�1�1��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 }t | j j |f||||| j d�|��� cddd� S # 1 sw Y yxY w)au Return information about primary key constraints in all tables in the given schema. The tables can be filtered by passing the names to use to ``filter_names``. For each table the value is a :class:`.ReflectedPrimaryKeyConstraint`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if primary keys of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are dictionaries, each representing the definition of a primary key constraint. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_pk_constraint` r� N)r� r� rl �get_multi_pk_constraintr2 �rF r r� r� r� rI r� s r; r� z!Inspector.get_multi_pk_constraint� s` � �V � $� $� &�$��4�� � �4�4���!�!-� � � #��� � �� � '� &� &�� �6A�Ac � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)ag Return information about foreign_keys in ``table_name``. Given a string ``table_name``, and an optional string `schema`, return foreign key information as a list of :class:`.ReflectedForeignKeyConstraint`. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a list of dictionaries, each representing the a foreign key definition. .. seealso:: :meth:`Inspector.get_multi_foreign_keys` r2 N)r� rl �get_foreign_keysr2 r� s r; r� zInspector.get_foreign_keys sM � �4 � $� $� &�$�0�4�<�<�0�0��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 }t | j j |f||||| j d�|��� cddd� S # 1 sw Y yxY w)ao Return information about foreign_keys in all tables in the given schema. The tables can be filtered by passing the names to use to ``filter_names``. For each table the value is a list of :class:`.ReflectedForeignKeyConstraint`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if foreign keys of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are list of dictionaries, each representing a foreign key definition. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_foreign_keys` r� N)r� r� rl r� r2 r� s r; r� z Inspector.get_multi_foreign_keys% s` � �Z � $� $� &�$��3�� � �3�3���!�!-� � � #��� � �� � '� &� &�r� c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a= Return information about indexes in ``table_name``. Given a string ``table_name`` and an optional string `schema`, return index information as a list of :class:`.ReflectedIndex`. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a list of dictionaries, each representing the definition of an index. .. seealso:: :meth:`Inspector.get_multi_indexes` r2 N)r� rl � get_indexesr2 r� s r; r zInspector.get_indexes_ sM � �2 � $� $� &�$�+�4�<�<�+�+��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 }t | j j |f||||| j d�|��� cddd� S # 1 sw Y yxY w)aP Return information about indexes in in all objects in the given schema. The objects can be filtered by passing the names to use to ``filter_names``. For each table the value is a list of :class:`.ReflectedIndex`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if indexes of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are list of dictionaries, each representing the definition of an index. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_indexes` r� N)r� r� rl �get_multi_indexesr2 r� s r; r zInspector.get_multi_indexes} s` � �X � $� $� &�$��.�� � �.�.���!�!-� � � #��� � �� � '� &� &�r� c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a~ Return information about unique constraints in ``table_name``. Given a string ``table_name`` and an optional string `schema`, return unique constraint information as a list of :class:`.ReflectedUniqueConstraint`. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a list of dictionaries, each representing the definition of an unique constraint. .. seealso:: :meth:`Inspector.get_multi_unique_constraints` r2 N)r� rl �get_unique_constraintsr2 r� s r; r z Inspector.get_unique_constraints� sM � �4 � $� $� &�$�6�4�<�<�6�6��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 }t | j j |f||||| j d�|��� cddd� S # 1 sw Y yxY w)a� Return information about unique constraints in all tables in the given schema. The tables can be filtered by passing the names to use to ``filter_names``. For each table the value is a list of :class:`.ReflectedUniqueConstraint`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if constraints of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are list of dictionaries, each representing the definition of an unique constraint. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_unique_constraints` r� N)r� r� rl � get_multi_unique_constraintsr2 r� s r; r z&Inspector.get_multi_unique_constraints� s` � �Z � $� $� &�$��9�� � �9�9���!�!-� � � #��� � �� � '� &� &�r� c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)a� Return information about the table comment for ``table_name``. Given a string ``table_name`` and an optional string ``schema``, return table comment information as a :class:`.ReflectedTableComment`. Raises ``NotImplementedError`` for a dialect that does not support comments. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary, with the table comment. .. versionadded:: 1.2 .. seealso:: :meth:`Inspector.get_multi_table_comment` r2 N)r� rl �get_table_commentr2 r� s r; r zInspector.get_table_comment sM � �: � $� $� &�$�1�4�<�<�1�1��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 }t | j j |f||||| j d�|��� cddd� S # 1 sw Y yxY w)a� Return information about the table comment in all objects in the given schema. The objects can be filtered by passing the names to use to ``filter_names``. For each table the value is a :class:`.ReflectedTableComment`. Raises ``NotImplementedError`` for a dialect that does not support comments. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if comments of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are dictionaries, representing the table comments. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_table_comment` r� N)r� r� rl �get_multi_table_commentr2 r� s r; r z!Inspector.get_multi_table_comment1 s` � �^ � $� $� &�$��4�� � �4�4���!�!-� � � #��� � �� � '� &� &�r� c � � | j � 5 } | j j |||fd| j i|��cddd� S # 1 sw Y yxY w)ay Return information about check constraints in ``table_name``. Given a string ``table_name`` and an optional string `schema`, return check constraint information as a list of :class:`.ReflectedCheckConstraint`. :param table_name: string name of the table. For special quoting, use :class:`.quoted_name`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a list of dictionaries, each representing the definition of a check constraints. .. seealso:: :meth:`Inspector.get_multi_check_constraints` r2 N)r� rl �get_check_constraintsr2 r� s r; r z Inspector.get_check_constraintsm sM � �4 � $� $� &�$�5�4�<�<�5�5��j�&��59�_�_��HJ�� '� &� &�r� c � � | j � 5 }t | j j |f||||| j d�|��� cddd� S # 1 sw Y yxY w)a� Return information about check constraints in all tables in the given schema. The tables can be filtered by passing the names to use to ``filter_names``. For each table the value is a list of :class:`.ReflectedCheckConstraint`. :param schema: string schema name; if omitted, uses the default schema of the database connection. For special quoting, use :class:`.quoted_name`. :param filter_names: optionally return information only for the objects listed here. :param kind: a :class:`.ObjectKind` that specifies the type of objects to reflect. Defaults to ``ObjectKind.TABLE``. :param scope: a :class:`.ObjectScope` that specifies if constraints of default, temporary or any tables should be reflected. Defaults to ``ObjectScope.DEFAULT``. :param \**kw: Additional keyword argument to pass to the dialect specific implementation. See the documentation of the dialect in use for more information. :return: a dictionary where the keys are two-tuple schema,table-name and the values are list of dictionaries, each representing the definition of a check constraints. The schema is ``None`` if no schema is provided. .. versionadded:: 2.0 .. seealso:: :meth:`Inspector.get_check_constraints` r� N)r� r� rl �get_multi_check_constraintsr2 r� s r; r z%Inspector.get_multi_check_constraints� s` � �Z � $� $� &�$��8�� � �8�8���!�!-� � � #��� � �� � '� &� &�r� c �� � |�||v ry|j |� | j j }| j � 5 }|j |� } ddd� |j } |j D � ci c], } | |j v r | |j j | � ��. } } | f} |�| |j vr? | j | f| gt j t j |d�|j ��}| |j v r|j | �| |j vrt j | � �|j" r.|j" j | � }|r|j% |� d}i }|j | D ] }d}| j' |||||� � |s'| j) | | � st j | � �| j+ || |||� | j- || ||||||| � | j/ || ||||| � | j1 || ||||| � | j3 || ||||| � | j5 || || � y# 1 sw Y ��xY wc c} w )aZ Given a :class:`_schema.Table` object, load its internal constructs based on introspection. This is the underlying method used by most dialects to produce table reflection. Direct usage is like:: from sqlalchemy import create_engine, MetaData, Table from sqlalchemy import inspect engine = create_engine("...") meta = MetaData() user_table = Table("user", meta) insp = inspect(engine) insp.reflect_table(user_table, None) .. versionchanged:: 1.4 Renamed from ``reflecttable`` to ``reflect_table`` :param table: a :class:`~sqlalchemy.schema.Table` instance. :param include_columns: a list of string column names to include in the reflection process. If ``None``, all columns are reflected. N)r� r� r� � _reflect_infoFT)r� rh rl r� �schema_for_objectr� �reflection_options�dialect_kwargsrA �columns�_get_reflection_inforW r_ rb r3 r �NoSuchTableError� table_options�_validate_dialect_kwargs�_reflect_columnr� � _reflect_pk� _reflect_fk�_reflect_indexes�_reflect_unique_constraints�_reflect_check_constraints�_reflect_table_comment)rF �table�include_columns�exclude_columns� resolve_fks� _extend_onr rl r� r r� r> r r� �tbl_opts� found_table�cols_by_orig_name�col_ds r; � reflect_tablezInspector.reflect_table� s� � �B � !�� �"�����u�%��)�)�#�#�� � $� $� &�$��+�+�E�2�F� '� �Z�Z� � �/�/� �/���E�(�(�(� �u�#�#�'�'��*� *�/� � � �Z�(� � � �I�]�5J�5J�$J� 5�D� 5� 5�� � (�\� �^�^�!�o�o� +� � �&�&� �M� � �3�3� 3� �-�-�i�8� 8� �M� 1� 1� 1��&�&�z�2� 2� � &� &�$�2�2�6�6�y�A�H�� �.�.�x�8�� �>@��"�*�*�9�5�E� �K� � � ��� � �!� � 6� �4�>�>�*�f�#E��&�&�z�2� 2� ��� �9�e�->�� � ��� � � � � � � � � � � � � � � � � � � � � � �(�(� � � � � � � � � �'�'� � � � � � � � � �#�#� � � � � �O '� &�� s �I�31I �I c � � |d }|j j j | ||� |j j | ||� |d }|r||vs|r||v ry |d }dD � ci c] } | |v r| || �� } } d|v r| j |d � g } |j d� ��|d } | �J �t | t � rt j | d�� } nGt | t j � s+t j t j | � d�� } n| } | j | � d|v r)t j d i |d ��}| j |� d |v r)t j d i |d ��}| j |� t j ||g| ��i | ��x||< }|j |j" v rd|_ |j% |d� � y c c} w ) Nr� r� )�nullable� autoincrementr8 �inforJ �comment�dialect_options�defaultT)� _reflected�computed�identity)�replace_existingr` )�metadata�dispatch�column_reflectr� rA r6 r" � sa_schema� DefaultClause� FetchedValuer �text�append�Computed�Identity�ColumnrJ � primary_key� append_column)rF r! r) r" r# r( � orig_namer� r� r> �col_kw�colargs� default_textr1 r3 r4 �cols r; r zInspector._reflect_column] s � � �&�M� � ��� � �.�.�t�U�E�B� ���%�%�d�E�5�9� �V�}�� ��O� ;� ��� 7� ���-��� ��� �E�z� �u�Q�x�K�� � � �� %� �M�M�%� 1�2� 3��� �9�9�Y� � +� ��+�L� �+� +�+��,� �3�#�1�1� �T��� � �i�.D�.D�E�#�1�1��H�H�\�*�t��� '�� �N�N�7� #� �� � �)�)�>�E�*�,=�>�H� �N�N�8� $� �� � �)�)�>�E�*�,=�>�H� �N�N�8� $�-6�-=�-=� �'�. � #�. �'-�. � ��)�$�s� �7�7�e�'�'� '� "�C�O� ���C�$��7��_ s �%Gc �< � |j j |� }|rz|d D �cg c] }||v r ||vr|| �� }}|j d� |j _ |j dd � |j _ |j j |� y y c c}w )N�constrained_columnsr� r/ )� pk_constraintrA rA r� r/ �_reload) rF r r� r! r( r# �pk_cons�pk�pk_colss r; r zInspector._reflect_pk� s� � � �-�-�1�1�)�<�� � "�"7�8��8�B��*�*�r� �/H� "�"�%�8� � � &-�[�[��%8�E� � � "�(/� � �I�t�(D�E� � � %� � � � %� %�g� .� ��s �Bc � � |j j |g � } | D �]� } | d } | d D � cg c] } | |v r|| j n| �� }} |rt |� j |� s |rt |� j |� r�g| d }| d }| d }g }|�]|r0t j ||j f|| j ||d�| �� |D ]% }|j dj |||g� � �' ni|r>t j ||j f| j t j ||d�| �� |D ]$ }|j dj ||g� � �& d | v r| d }ni } |j t j ||| fd | j d � d �|��� ��� y c c} w # t j $ r< t# j$ d |j& � d| � ddj |� � d�� Y ���w xY w)Nr� rI r� r� �referred_columns)r � autoload_withr% r �.)rQ r r% r �optionsTr/ )� link_to_namer/ zOn reflected table z0, skipping reflection of foreign key constraint z-; one or more subject columns within name(s) z, z are not present in the table)� foreign_keysrA rJ r� � intersectionr� r9 �Tabler6 rh r= �join� BLANK_SCHEMA�append_constraint�ForeignKeyConstraintr � ConstraintColumnNotFoundErrorr �warnr� )rF r r� r! r( r" r# r$ r% r r� �fkey_d�conname�crI r� r� rP �refspec�columnrS s r; r zInspector._reflect_fk� s^ � � �*�*�.�.�y�"�=���F� �V�n�G� � 5�6�#�6�A� -.�1B�,B�!�!�$�(�(��I�6� � #� ��+�,�9�9�/�J�#�� /�0�;�;�O�L� � $�%6� 7�O� #�$4� 5�N� %�&8� 9� ��G� �*� � �O�O�&� ���� /�&*�i�i�#-�&3� � -�� /�F��N�N����/�>�6�!J�K�� /� � �O�O�&� ���� '+�i�i� (� 5� 5�#-�&3� � -�� /�F��N�N�3�8�8�^�V�,D�#E�F� /��F�"� ��+�� �� ��'�'� �2�2�+� � �� &*� &� � �9� 5� � "� � �s ��#��~ �4�4� �� � �)�%�*�*� � 6.� �i� � #�y�y�)<� =� >� ?+�+�� �s � F)�,9F.�.A G=�<G=)�asc�desc� nulls_first� nulls_lastc �~ � |j j |g � }|D �]d } | d } | d } | j d� } | j di � } | d }| j dd� }| j di � }| j d � }|rt | � j |� s��|r��g }t | � D ]� \ }}|�?| s$t j d |� d | �d |d z � d�� ��t j | | � }nW ||v r|| }n|j | }| j |d� D ]( }|| j v s�| j | } ||� }�* |j |� �� t j | g|��||d�|�� ��g y # t $ r+ t j |� d|�d|j ��� Y ��w xY w)Nr� � column_names� expressions�column_sortingr r� �indexr0 �duplicates_constraintz Skipping � z because key r z5 reflected as None but no 'expressions' were returnedz key z& was not located in columns for table r` )�_tabler )�indexesrA r� �issubset� enumerater r] r r< r` �KeyErrorr� �_index_sort_exprsr= r9 �Index)rF r r� r! r( r" r# r ro �index_dr� r ri rj r �flavorr0 � duplicates� idx_elementsrk r` � idx_element�option�ops r; r zInspector._reflect_indexes s� � � �'�'�+�+�I�r�:�� �G��6�?�D� �n�-�G�!�+�+�m�4�K� $�[�[�)9�2� >�N� �X�&�F� �[�[���1�F� %�k�k�*;�R� @�O� ���%<�=�J� �s�7�|�'<�'<�_�'M���� �L� %�g� .���q��9�&� � � � '��x�q��� � $�q�y�k� *:� :�� �"%�(�(�;�u�+=�">�K� !� � 1�1�*;�A�*>�K�*/�'�'�!�*�K� #1�"4�"4�Q��";��!�T�%;�%;�;�!%�!7�!7��!?�B�*,�[�/�K� #<� �#�#�K�0�5 /�8 �����!�� !�!� � &� �] ��D $� !� � � � %�h�e�A�5� 11�16���� @�� !� !�s �?F�0F<�;F<c �$ � |j j |g � }|D ]� } | d } | d } | j d� } | j d� } | j di � }|rt | � j |� s�^| r�ag }| D ], } ||v r|| n|j | }|j |� �. |j t j || | d �|��� �� y # t $ r) t j d|�d|j �d�� Y ��w xY w) Nr� rh r/ �duplicates_indexr0 zunique constraint key 'z(' was not located in columns for table '�')r� r/ ) �unique_constraintsrA r� rp r` r= rr r r] r� rZ r9 �UniqueConstraint)rF r r� r! r( r" r# r � constraints�const_dr_ r r/ rw r0 �constrained_colsr` �constrained_cols r; r z%Inspector._reflect_unique_constraints_ s- � � $�6�6�:�:�9�b�I� �"�G� �f�o�G� �n�-�G� �k�k�)�,�G� ���%7�8�J� %�k�k�*;�R� @�O� �s�7�|�'<�'<�_�'M���� "� � �� =� � 1�1� *�!�,� "�W�W�Q�Z� $� %�+�+�O�<� � � #� #��*�*�%� � #�� &� � �7 #��( � ��I�I�45�u�z�z�C���s �C � /D�Dc � � |j j |g � }|D ]& } |j t j di | ��� �( y )Nr` )�check_constraintsrA rZ r9 �CheckConstraint) rF r r� r! r( r" r# r r� r� s r; r z$Inspector._reflect_check_constraints� sB � � $�5�5�9�9�)�R�H� �"�G� � #� #�I�$=�$=�$H��$H� I� #rM c �T � |j j |� }|r |d |_ y y �Nr< )� table_commentrA r/ )rF r r� r! r � comment_dicts r; r z Inspector._reflect_table_comment� s. � � %�2�2�6�6�y�A� � � (�� 0�E�M� rM c � � ��� � � |�d< �r(|r&t �� dkD rt �� t |� z � nd � i x�d< }d� ddd� d �� � �� fd�}t |� j d�� |� j � |� j � |� j � |� j d� � |� j d� � |� j d� � |� j d� � |� � }|r|j |� |S |S ) Nr �d r3 TF)�optional� check_filter_names_from_methc �� �� ��*�dk s%� j j | j � s�}nd } �r | dd|i���}|r |sd� |S i }|S # t $ r |s� i }Y |S w xY w)Ng �?r� Fr` )rl �_overrides_defaultrB �NotImplementedError) �methr� r� �_fnr� r� �fraction� has_resultrI rF s �����r; �runz+Inspector._get_reflection_info.<locals>.run� s� �� � � ��s�?��|�|�6�6�t�}�}�E�"���� � � �6�C�6�2�6�C�3�C� &+� � �J� �C� �J�� '� � �����J� �s �A � A � A � A )r� )r� ) r rJ rU ro r r� r� r r3 )r� r r� rj r� rj rS r ) �len�_ReflectionInfor� r� r� r r r r r� r� ) rF r r� � availabler rI r3 r� r. r� r� s ` ` ` @@r; r z Inspector._get_reflection_info� s< �� � ��8� � �I�#�l�*;�c�*A��<�(�3�y�>�9�H��H� /1�0��?��m� � � #�16� ! ��! � �! � +/� ! � � ! � ! �F ���&�&�T�� �d� :� :�;� �T� 8� 8�9���.�.�/� "��1�1�D� � �d� :� :�T�J� !��0�0�4� � �d� :� :�T�J�'� ��" � � � �� &� � ��KrM )rh rg )rv zCallable[..., Any]rh rg rS rf )rh rg rS �None)ri r rS r� )r� r rS r� )rS r� )rh r rS rf )rh r rS rf )rS z!Generator[Connection, None, None])rS z Generator[Inspector, None, None])rS � Optional[str])rI r rS � List[str])r r� rI r rS r� )r� r7 r r� rI r rS rj )r� r7 r r� rI r rS rj ) r� r7 r� r7 r r� rI r rS rj )r� r7 rI r rS rj )r r� rI r rS z;List[Tuple[Optional[str], List[Tuple[str, Optional[str]]]]])r5 )r� zCollection[Optional[str]]rI r rS zgList[Tuple[Optional[Tuple[Optional[str], str]], List[Tuple[Tuple[Optional[str], str], Optional[str]]]]])r� r7 r r� rI r rS �Dict[str, Any]) r r� r� �Optional[Sequence[str]]r� rW r� rb rI r rS � Dict[TableKey, Dict[str, Any]])r� r7 r r� rI r rS r7 )r� r7 r r� rI r rS �List[ReflectedColumn])r� z Iterable[List[ReflectedColumn]]rS r� ) r r� r� r� r� rW r� rb rI r rS �%Dict[TableKey, List[ReflectedColumn]])r� r7 r r� rI r rS r, ) r r� r� r� r� rW r� rb rI r rS z-Dict[TableKey, ReflectedPrimaryKeyConstraint])r� r7 r r� rI r rS �#List[ReflectedForeignKeyConstraint]) r r� r� r� r� rW r� rb rI r rS �3Dict[TableKey, List[ReflectedForeignKeyConstraint]])r� r7 r r� rI r rS �List[ReflectedIndex]) r r� r� r� r� rW r� rb rI r rS �$Dict[TableKey, List[ReflectedIndex]])r� r7 r r� rI r rS � List[ReflectedUniqueConstraint]) r r� r� r� r� rW r� rb rI r rS �/Dict[TableKey, List[ReflectedUniqueConstraint]])r� r7 r r� rI r rS r- ) r r� r� r� r� rW r� rb rI r rS z%Dict[TableKey, ReflectedTableComment])r� r7 r r� rI r rS � List[ReflectedCheckConstraint]) r r� r� r� r� rW r� rb rI r rS �.Dict[TableKey, List[ReflectedCheckConstraint]])r` TNN)r! �sa_schema.Tabler" �Optional[Collection[str]]r# �Collection[str]r$ rj r% � Optional[Set[sa_schema.Table]]r �Optional[_ReflectionInfo]rS r� ) r! r� r) r) r" r� r# r� r( � Dict[str, sa_schema.Column[Any]]rS r� ) r r� r� r/ r! r� r( r� r# r� rS r� )r r� r� r/ r! r� r( r� r" r� r# r� r$ rj r% r� r r� rS r� )r r� r� r/ r! r� r( r� r" r� r# r� r r� rS r� ) r r� r� r/ r! r� r r� rS r� )NNNN) r r� r� r� r� r� r r� rI r rS r� )MrB rX rY rZ �__annotations__r � deprecatedrp � classmethodrw rn r{ rz r� r� r � _inspectsr r� r r� � contextlib�contextmanagerr� r� �propertyr� r� r� r� r� r� r� r� r� r� r� r� rW r[ rb rc r� r� r� r� r� r� r� r� r� r� r� r� r r r r r r r r r* r r r r �asc_op�desc_op�nulls_first_op� nulls_last_oprs r r r r r r` rM r; rf rf � sJ � ��0 $�#� �N�"&�&� �� � ��T�_�_� � 5� � � � � ��%��-F�� �� ��$� � � � ��T�_�_� � 5� �6� � �6�& �Z���&�!�B� "�B� �Z���*�%�F� &�F� � � � � � �( � � � � � � �0� �0� � '+� �#� �25� � � �D 8<� � � �'4� �CF� � � �D ;?�� ��*7��FI�� ��. !%� ��� �� � � � � � �:�$ !%�+ � �+ � �+ � E� + �^ 7>�L4�3�L4� �L4� � L4�\�"�" 8<� � � �'4� �CF� � � �B !%�04�%�+�+� (� 0� 0� 7 � �7 � .�7 � � 7 � � 7 � � 7 � (�7 �t '+��#��25�� ��< '+��#��25�� ��2 '+��#��25�� ��& 7;�� ��&3��BE�� ��* 8<� � � �'4� �CF� � � �D0�3�0� �0� !%�04�%�+�+� (� 0� 0� 9 � �9 � .�9 � � 9 � � 9 � � 9 � /�9 �x 8<�� ��'4��CF�� &��> !%�04�%�+�+� (� 0� 0� 6� �6� .�6� � 6� � 6� � 6� 7�6�r 8<� � � �'4� �CF� � ,� �B !%�04�%�+�+� (� 0� 0� 8� �8� .�8� � 8� � 8� � 8� =�8�v 8<� � � �'4� �CF� � � �@ !%�04�%�+�+� (� 0� 0� 7� �7� .�7� � 7� � 7� � 7� .�7�t 8<� � � �'4� �CF� � (� �B !%�04�%�+�+� (� 0� 0� 8� �8� .�8� � 8� � 8� � 8� 9�8�v 8<� � � �'4� �CF� � � �H !%�04�%�+�+� (� 0� 0� :� �:� .�:� � :� � :� � :� /�:�z 8<� � � �'4� �CF� � '� �B !%�04�%�+�+� (� 0� 0� 8� �8� .�8� � 8� � 8� � 8� 8�8�| ,.� �59�37�U � �U � 3�U � )� U � � U � 3� U � 1�U � �U �nF8� �F8� �F8� 3� F8� )� F8� <� F8� �F8�P/�&�/� �/� � /� <� /� )� /� �/�0W�&�W� �W� � W� <� W� 3� W� )�W� �W� 3�W� +�W� �W�t � � ��!�!� �/�/� �-�-� ��@�&�@� �@� � @� <� @� 3� @� )�@� +�@� �@�D.�&�.� �.� � .� <� .� 3� .� )�.� +�.� �.�` J�&� J� � J� � J� <� J� 3� J� )� J� +� J� � J� 1�&� 1� � 1� � 1� +� 1� � 1� !%�26�/3�37� L� �L� 0�L� -� L� 1� L� � L� �LrM rf c � � e Zd ZdZed d�� Zed d�� Zed d�� Zedd�� Zedd�� Z edd�� Z edd�� Z edd �� Z y )�ReflectionDefaultsz5provides blank default values for reflection methods.c � � g S r5 r` �ru s r; r zReflectionDefaults.columns� � � �� rM c � � d g d�S )N)r� rI r` r� s r; rJ z ReflectionDefaults.pk_constraint� s � � �#%� � rM c � � g S r5 r` r� s r; rU z ReflectionDefaults.foreign_keys r� rM c � � g S r5 r` r� s r; ro zReflectionDefaults.indexes r� rM c � � g S r5 r` r� s r; r z%ReflectionDefaults.unique_constraints r� rM c � � g S r5 r` r� s r; r� z$ReflectionDefaults.check_constraints r� rM c � � i S r5 r` r� s r; r z ReflectionDefaults.table_options r� rM c � � dd iS r� r` r� s r; r� z ReflectionDefaults.table_comment s � ���~� rM N)rS r� )rS r, )rS r� )rS r� )rS r� )rS r� )rS r� )rS r- ) rB rX rY rZ r� r rJ rU ro r r� r r� r` rM r; r� r� � s� � �?��� �� � � � � �� �� �� �� �� �� �� �� �� �� � � � rM r� c �p � e Zd ZU ded< ded< ded< ded< d ed < d ed < d ed< ded< ded< dd�Zy)r� r� r z7Dict[TableKey, Optional[ReflectedPrimaryKeyConstraint]]rJ r� rU r� ro r� r z/Dict[TableKey, Optional[ReflectedTableComment]]r� r� r� r� r z+Dict[TableKey, exc.UnreflectableTableError]r3 c � � | j j � D ]5 \ }}t ||� }|��|�t | ||� �%|j |� �7 y r5 )�__dict__rD �getattr�setattrr� )rF �otherr> r? �ovs r; r� z_ReflectionInfo.update, sJ � ��M�M�'�'�)�D�A�q����"�B��~��9��D�!�R�(��H�H�R�L� *rM N)r� r� rS r� )rB rX rY r� r� r` rM r; r� r� s= � � 2�2�J�J�E�E� 1�1�G�G�B�B�E�E�1�1�>�>�!rM r� rR )rP z Tuple[str, InternalTraversal]rS z0Callable[[Callable[..., _R]], Callable[..., _R]])ErZ � __future__r r� � dataclassesr �enumr r r �typingr r r r r r r r r r r r r r �baser r � r r r r r r r9 � sql.cache_keyr � sql.elementsr! r" � sql.type_apir# � sql.visitorsr$ r% � util.typingr& � interfacesr' r( r) r* r+ r, r- r. r/ r0 rT rL rU rW rb �_self_inspects� Inspectablerf r� r� r` rM r; �<module>r� s� ���& #� � !� � � � � � � � � � � � � � � � � � � � � � � � � %� 7� &� %� %� ,� � ��#�4�+�9�*�9�1�5�$� �T�]�� � � � �� � � � � � � � � � � � � �>�1��5��0 � "�� "� � "�> � *�$� *� � *� ���~ � �&�&�{�3� ~ � �~ �B: �$ � $ � �$ �N �!� !� �!rM