3 ๖aฮใ@s^ddlmZGdd„dejƒZGdd„deƒZGdd„deejjƒZGdd „d eejjƒZd S) ้)ฺtypesc@seZdZdZdS)ฺJSONaล MSSQL JSON type. MSSQL supports JSON-formatted data as of SQL Server 2016. The :class:`_mssql.JSON` datatype at the DDL level will represent the datatype as ``NVARCHAR(max)``, but provides for JSON-level comparison functions as well as Python coercion behavior. :class:`_mssql.JSON` is used automatically whenever the base :class:`_types.JSON` datatype is used against a SQL Server backend. .. seealso:: :class:`_types.JSON` - main documentation for the generic cross-platform JSON datatype. The :class:`_mssql.JSON` type supports persistence of JSON values as well as the core index operations provided by :class:`_types.JSON` datatype, by adapting the operations to render the ``JSON_VALUE`` or ``JSON_QUERY`` functions at the database level. The SQL Server :class:`_mssql.JSON` type necessarily makes use of the ``JSON_QUERY`` and ``JSON_VALUE`` functions when querying for elements of a JSON object. These two functions have a major restriction in that they are **mutually exclusive** based on the type of object to be returned. The ``JSON_QUERY`` function **only** returns a JSON dictionary or list, but not an individual string, numeric, or boolean element; the ``JSON_VALUE`` function **only** returns an individual string, numeric, or boolean element. **both functions either return NULL or raise an error if they are not used against the correct expected value**. To handle this awkward requirement, indexed access rules are as follows: 1. When extracting a sub element from a JSON that is itself a JSON dictionary or list, the :meth:`_types.JSON.Comparator.as_json` accessor should be used:: stmt = select( data_table.c.data["some key"].as_json() ).where( data_table.c.data["some key"].as_json() == {"sub": "structure"} ) 2. When extracting a sub element from a JSON that is a plain boolean, string, integer, or float, use the appropriate method among :meth:`_types.JSON.Comparator.as_boolean`, :meth:`_types.JSON.Comparator.as_string`, :meth:`_types.JSON.Comparator.as_integer`, :meth:`_types.JSON.Comparator.as_float`:: stmt = select( data_table.c.data["some key"].as_string() ).where( data_table.c.data["some key"].as_string() == "some string" ) .. versionadded:: 1.4 N)ฺ__name__ฺ __module__ฺ __qualname__ฺ__doc__ฉrr๚D/tmp/pip-build-6_cqtusv/SQLAlchemy/sqlalchemy/dialects/mssql/json.pyr s.process)Zstring_bind_processor)r ฺdialectrr)r rr ฺbind_processorTs z_FormatTypeMixin.bind_processorcsˆj|ƒ‰‡‡fdd„}|S)Ncsˆj|ƒ}ˆrˆ|ƒ}|S)N)r)r )r rrr rbs z3_FormatTypeMixin.literal_processor..process)Zstring_literal_processor)r rrr)r rr ฺliteral_processor_s z"_FormatTypeMixin.literal_processorN)rrrrrrrrrr r Ps r c@seZdZdd„ZdS)ฺ JSONIndexTypecCs t|tƒrd|}nd|}|S)Nz$[%s]z$."%s")ฺ isinstanceฺint)r r rrr rls  zJSONIndexType._format_valueN)rrrrrrrr rksrc@seZdZdd„ZdS)ฺ JSONPathTypecCsddjdd„|DƒƒS)Nz$%sฺcSs&g|]}t|tƒrd|nd|‘qS)z[%s]z."%s")rr)ฺ.0ฺelemrrr ๚ ysz.JSONPathType._format_value..)ฺjoin)r r rrr ruszJSONPathType._format_valueN)rrrrrrrr rtsrN)rrZsqltypesrฺobjectr rrrrrr ฺs E