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

Merge pull request #4995 from influxdata/pjb-delete-influxql-syntax 

feat: improve delete predicate keyword escaping requirements
wcooke/removesupportcontact
Phil Bracikowski 2023-06-27 09:40:10 -07:00 committed by GitHub
parent eeba6442e5 81a6855b89
commit 8feddb16e5
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
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`.