Influxdata
/
docs-v2
mirror of https://github.com/influxdata/docs-v2.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

feat: improve delete predicate keyword escaping requirements 

Delete predicates are parsed by the influxql parser. Therefore, any
influxql keywords that match a tag name need to be escaped with double
quotes. The keyword matching is case-insensitive but tag name matching
for the delete predicate is case-sensitive.
pjb-delete-influxql-syntax
Phil Bracikowski 2023-06-27 09:12:36 -07:00
parent eeba6442e5
commit 81a6855b89
1 changed files with 6 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

9
content/influxdb/v2.7/reference/syntax/delete-predicate.md
View File

@ -37,12 +37,15 @@ key1="value1" AND key2="value"
If your predicate contains keywords or strings with special characters, wrap each in escaped
quotes to ensure the predicate string is parsed correctly.
Because delete predicates follow [InfluxQL](/influxdb/v2.7/reference/syntax/influxql) syntax, [any InfluxQL keyword](/influxdb/v2.7/reference/syntax/influxql/spec/#keywords)
that matches your tag name needs to be escaped. Keywords are case-insensitive.
```js
// Escaped due to the "-"
"_measurement=\"example-dash\""
// Escaped because "name" is a keyword
"_measurement=example and \"name\"=predicate"
// Escaped because "Name" is a keyword
"_measurement=example and \"Name\"=predicate"
```
{{% /note %}}
@ -116,4 +119,4 @@ The delete predicate syntax has the following limitations.
- Delete predicates only support equality (`=`), not inequality (`!=`).
- Delete predicates can use any column or tag **except** `_time`
{{% oss-only %}}, `_field`, {{% /oss-only %}}or `_value`.