Apache
/
druid
mirror of https://github.com/apache/druid.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Add dynamic query params example (#16964) 

Co-authored-by: Victoria Lim <vtlim@users.noreply.github.com>
This commit is contained in:
Jill Osborne 2024-08-27 22:27:13 +01:00 committed by GitHub
parent 21dcf804eb
commit 3e031b9dc2
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 16 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/querying/sql.md
View File

@ -398,6 +398,21 @@ at execution time. To use dynamic parameters, replace any literal in the query w
corresponding parameter value when you execute the query. Parameters are bound to the placeholders in the order in corresponding parameter value when you execute the query. Parameters are bound to the placeholders in the order in
which they are passed. Parameters are supported in both the [HTTP POST](../api-reference/sql-api.md) and [JDBC](../api-reference/sql-jdbc.md) APIs. which they are passed. Parameters are supported in both the [HTTP POST](../api-reference/sql-api.md) and [JDBC](../api-reference/sql-jdbc.md) APIs.
Druid supports double and null values in arrays for dynamic queries.
The following example query uses the [ARRAY_CONTAINS](./sql-functions.md#array_contains) function to return `doubleArrayColumn` when the reference array `[-25.7, null, 36.85]` contains all elements of the value of `doubleArrayColumn`:
```sql
{
"query": "SELECT doubleArrayColumn from druid.table where ARRAY_CONTAINS(?, doubleArrayColumn)",
"parameters": [
{
"type": "ARRAY",
"value": [-25.7, null, 36.85]
}
]
}
```
In certain cases, using dynamic parameters in expressions can cause type inference issues which cause your query to fail, for example: In certain cases, using dynamic parameters in expressions can cause type inference issues which cause your query to fail, for example:
```sql ```sql
@ -435,4 +450,4 @@ To use the reserved keywords in queries, enclose them in double quotation marks.
```sql ```sql
SELECT "PARTITIONED" from druid.table SELECT "PARTITIONED" from druid.table
``` ```