zmc
2023-08-08 e792e9a60d958b93aef96050644f369feb25d61b
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
U
¸ý°d\ã@s\ddlmZGdd„dejƒZGdd„dƒ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úUd:\z\workplace\vscode\pyvenv\venv\Lib\site-packages\sqlalchemy/dialects/mssql/json.pyr src@s$eZdZdd„Zdd„Zdd„ZdS)Ú_FormatTypeMixincCs
tƒ‚dS©N)ÚNotImplementedError©ÚselfÚvaluerrr    Ú _format_valueSsz_FormatTypeMixin._format_valuecsˆ |¡‰‡‡fdd„}|S)Ncsˆ |¡}ˆrˆ|ƒ}|Sr ©r©r©rZ
super_procrr    ÚprocessYs
z0_FormatTypeMixin.bind_processor.<locals>.process)Zstring_bind_processor©rÚdialectrrrr    Úbind_processorVs
z_FormatTypeMixin.bind_processorcsˆ |¡‰‡‡fdd„}|S)Ncsˆ |¡}ˆrˆ|ƒ}|Sr rrrrr    rds
z3_FormatTypeMixin.literal_processor.<locals>.process)Zstring_literal_processorrrrr    Úliteral_processoras
z"_FormatTypeMixin.literal_processorN)rrrrrrrrrr    r
Rs r
c@seZdZdd„ZdS)Ú JSONIndexTypecCs t|tƒrd|}nd|}|S)Nz$[%s]z$."%s"©Ú
isinstanceÚintr rrr    rns
 
zJSONIndexType._format_valueN©rrrrrrrr    rmsrc@seZdZdd„ZdS)Ú JSONPathTypecCsdd dd„|Dƒ¡S)Nz$%sÚcSs&g|]}t|tƒrd|nd|‘qS)z[%s]z."%s"r)Ú.0Úelemrrr    Ú
<listcomp>zsÿz.JSONPathType._format_value.<locals>.<listcomp>)Újoinr rrr    rwsþÿÿzJSONPathType._format_valueNrrrrr    rvsrN)rrZsqltypesrr
rrrrrr    Ú<module>s
E