跳转至

字符串

Nebula Graph 支持定长字符串和变长字符串。

声明与表示方式

nGQL 中的字符串声明方式如下:

  • 使用关键字STRING声明变长字符串。
  • 使用关键字FIXED_STRING(<length>)声明定长字符串,<length>为字符串长度,例如FIXED_STRING(32)

字符串的表示方式为用双引号或单引号包裹,例如"Hello, Cooper"'Hello, Cooper'

字符串读写

nGQL 支持以如下方式使用字符串:

  • VID 的数据类型定义为定长字符串。
  • 将变长字符串设置为 Schema 名称,包括图空间、Tag、Edge type 和属性的名称。
  • 将属性值的数据类型定义为定长或变长字符串。

例如:

  • 将属性值的类型定义为定长字符串

    ngql nebula> CREATE TAG IF NOT EXISTS t1 (p1 FIXED_STRING(10));

  • 将属性值的类型定义为变长字符串

    ngql nebula> CREATE TAG IF NOT EXISTS t2 (p2 STRING);

如果尝试写入的定长字符串超出长度限制:

  • 当该定长字符串为属性值时,写入会成功,Nebula Graph 将截断字符串,仅存入符合长度限制的部分。
  • 当该定长字符串为 VID 时,写入会失败,Nebula Graph 将报错。

转义字符

字符串中不支持直接换行,可以使用转义字符实现,例如:

  • "\n\t\r\b\f"
  • "\110ello world"

OpenCypher 兼容性

openCypher、Cypher 和 nGQL 之间有一些细微区别,例如下面 openCypher 的示例,不能将单引号替换为双引号。

```ngql

File: Literals.feature

Feature: Literals

Background: Given any graph Scenario: Return a single-quoted string When executing query: """ RETURN '' AS literal """ Then the result should be, in any order: | literal | | '' | # Note: it should return single-quotes as openCypher required. And no side effects ```

Cypher 的返回结果同时支持单引号和双引号,nGQL 遵循 Cypher 的方式。

ngql nebula > YIELD '' AS quote1, "" AS quote2, "'" AS quote3, '"' AS quote4 +--------+--------+--------+--------+ | quote1 | quote2 | quote3 | quote4 | +--------+--------+--------+--------+ | "" | "" | "'" | """ | +--------+--------+--------+--------+


最后更新: 2026年8月17日