[Django] #34636: Add documentation for Query's function `sql_with_params`

[Django]

#34636: Add documentation for Query's function `sql_with_params`
-------------------------------------+-------------------------------------
Reporter: Paolo | Owner: nobody
Melchiorre |
Type: New | Status: new
feature |
Component: Database | Version: dev
layer (models, ORM) | Keywords: async, orm, sql,
Severity: Normal | params, documentation
Triage Stage: | Has patch: 0
Unreviewed |
Needs documentation: 0 | Needs tests: 0
Patch needs improvement: 0 | Easy pickings: 0
UI/UX: 0 |
-------------------------------------+-------------------------------------
The `sql_with_params` Query's function can be very useful to generate SQL
code and params for asynchronous execution, so it will be very useful to
explicitly document it.

--
Ticket URL: <https://code.djangoproject.com/ticket/34636>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.

[Django]

#34636: Add documentation for Query's function `sql_with_params`
-------------------------------------+-------------------------------------

Reporter: Paolo Melchiorre | Owner: nobody
Type: New feature | Status: closed
Component: Database layer | Version: dev
(models, ORM) |
Severity: Normal | Resolution: wontfix
Keywords: async, orm, sql, | Triage Stage:
params, documentation | Unreviewed
Has patch: 0 | Needs documentation: 0

Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Mariusz Felisiak):

* status: new => closed
* resolution: => wontfix

Comment:

Thanks for the ticket, however, we don't want to encourage users to use
raw SQL queries.

--
Ticket URL: <https://code.djangoproject.com/ticket/34636#comment:1>

[Django]

#34636: Add documentation for Query's function `sql_with_params`
-------------------------------------+-------------------------------------
Reporter: Paolo Melchiorre | Owner: nobody

Type: New feature | Status: new

Component: Database layer | Version: dev
(models, ORM) |
Severity: Normal | Resolution:

Keywords: async, orm, sql, | Triage Stage: Accepted
params, documentation |

Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Simon Charette):

* resolution: wontfix =>
* stage: Unreviewed => Accepted
* status: closed => new

Comment:

Re-opening per [https://code.djangoproject.com/ticket/25705#comment:20
these discussions].

A point that was brought up is that we should likely allow `alias` to be
passed to `sql_with_params` to be truly useful in multi-db setups.
--
Ticket URL: <https://code.djangoproject.com/ticket/34636#comment:2>

[Django]

#34636: Add documentation for Query's function `sql_with_params`
-------------------------------------+-------------------------------------

Reporter: Paolo Melchiorre | Owner: Alex
Type: New feature | Status: assigned

Component: Database layer | Version: dev
(models, ORM) |
Severity: Normal | Resolution:
Keywords: async, orm, sql, | Triage Stage: Accepted
params, documentation |
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 0 | UI/UX: 0
-------------------------------------+-------------------------------------

Changes (by Alex):

* owner: nobody => Alex
* status: new => assigned

--
Ticket URL: <https://code.djangoproject.com/ticket/34636#comment:3>