docs-v2/content/influxdb/cloud-dedicated/reference/influxql/quoting.md

2.0 KiB

title description menu weight list_code_example
Quotation Single quotation marks (`'`) are used in the string literal syntax. Double quotation marks (`"`) are used to quote identifiers.
influxdb_cloud_dedicated
name identifier parent
Quotation influxql-quotation influxql-reference
214 ```sql -- String literal 'I am a string' -- Quoted identifier "this-is-an-identifier" ```

InfluxQL supports both single and double quotation marks, but they each function differently and serve different purposes.

Single quotes

Use single quotation marks (') in the string literal and timestamp literal syntax.

In the following example, the WHERE clause evaluates the value of the room tag. Tags only contain string values, so the right operand of the predicate expression should be a string literal.

... WHERE room = 'Kitchen'

Double quotes

Use double quotation marks (") to quote identifiers. Identifiers must be double-quoted in the following cases:

  • The identifier contains non-word characters. Word characters are defined as [a-z,A-Z,0-9,_].
  • The identifier is case-sensitive.
  • The identifier contains InfluxQL keywords.
  • The identifier begins with a digit.

Double-quoted identifiers can also:

  • Contain any Unicode character except for a new line.
  • Contain escaped " characters (for example: \").
  • Include InfluxQL keywords.

While not always necessary, we recommend that you double quote identifiers.

{{% note %}} InfluxQL quoting guidelines differ from line protocol quoting guidelines. {{% /note %}}