#36462: Document has_any_keys lookup array case for JSONField (Postgres)
-------------------------------------+-------------------------------------
     Reporter:  Willem Van Onsem     |                    Owner:  (none)
         Type:  New feature          |                   Status:  closed
    Component:  Documentation        |                  Version:  5.1
     Severity:  Normal               |               Resolution:  wontfix
     Keywords:  orm, documentation,  |             Triage Stage:
  JSON, postgreSQL.                  |  Unreviewed
    Has patch:  0                    |      Needs documentation:  0
  Needs tests:  0                    |  Patch needs improvement:  0
Easy pickings:  0                    |                    UI/UX:  0
-------------------------------------+-------------------------------------
Changes (by Sarah Boyce):

 * resolution:   => wontfix
 * status:  new => closed
 * summary:
     Should we include documentation for has_any_keys for the JSONField if
     the value is an array.
     => Document has_any_keys lookup array case for JSONField (Postgres)

Comment:

 Thank you for the ticket. I agree we don't have documentation for this
 case. However, in deciding if I think this should be documented within the
 [https://docs.djangoproject.com/en/5.2/topics/db/queries/#has-any-keys
 JSONField has_any_keys lookup docs], I found that this works for
 PostgreSQL but not for SQLite and Oracle (not yet tested MariaDB)

 As this is PostgreSQL specific, I'm not sure adding a note for `has_key`,
 `has_any_keys`, `has_keys` for the array cases on PostgreSQL is worth it
 as this might be quite niche.
 As I can't see database specific documentation of additional usage in the
 docs around the lookups already, I don't think it's the norm to include
 this. If you feel strongly, you can start a discussion on the
 [https://forum.djangoproject.com/c/internals/5 Django Forum] and see what
 other people think
-- 
Ticket URL: <https://code.djangoproject.com/ticket/36462#comment:1>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

-- 
You received this message because you are subscribed to the Google Groups 
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
To view this discussion visit 
https://groups.google.com/d/msgid/django-updates/01070197682aca73-0fc2a892-7f28-441e-b1dc-f458867431d2-000000%40eu-central-1.amazonses.com.

Reply via email to