值和类型

GQL支持多种值和类型来表示图数据库中的数据。理解这些值和类型对实现有效查询和数据操作至关重要。

图元素类型

图元素类型包括点类型和边类型，分别对应点数据类型和边数据类型。

属性值类型

属性值类型指属性值的数据类型。嬴图支持以下属性值类型：

数值

文本

时间点

日期

• 格式：yyyy-mm-dd或yyyymmdd
• 范围：-9999-12-31到9999-12-31

时间

• 格式：hh:mm:ss[.fraction]或hhmmss[.fraction]
• 范围：00:00:00.000000000到23:59:59.999999999

日期和时间

• 格式：使用空格或字母T连接日期和时间
• 范围：-9999-01-01 00:00:00.000000000到9999-12-31 23:59:59.999999999

时区

• 格式：以UTC偏移量表示，即±hh:mm或±hhmm，直接写在时间后面
• 范围：UTC-15:00到UTC+15:00

除时间戳外，时间点类型的赋值均需以引号包裹。

时间段

布尔

空间

列表

构造值类型

构造值类型是包含复合元素的数据类型。GQL定义了以下构造值类型：

^[1] 如果路径元素列表中的点边有序序列构成一条路径，则称该序列识别一条路径

结果类型

结果类型指的是查询返回值的数据类型。嬴图定义以下结果类型。

RESULT_TYPE_NODE

本条查询返回所有标签为Paper并与变量n绑定的点：

MATCH (n:Paper) RETURN n

n的数据结构：

{
  "data": [
    {
      "id": "P2",
      "uuid": "8718971077612535835",
      "schema": "Paper",
      "values": {
        "title": "Optimizing Queries",
        "score": 9
      }
    },
    {
      "id": "P1",
      "uuid": "8791028671650463770",
      "schema": "Paper",
      "values": {
        "title": "Efficient Graph Search",
        "score": 6
      }
    }
  ],
  "alias": "n",
  "type": 2,
  "type_desc": "RESULT_TYPE_NODE"
}

RESULT_TYPE_EDGE

本条查询返回所有标签为Cites且与变量e绑定的出边：

MATCH ()-[e:Cites]->() RETURN e

e的数据结构：

{
  "data": [
    {
      "from": "P1",
      "to": "P2",
      "uuid": "1",
      "from_uuid": "8791028671650463770",
      "to_uuid": "8718971077612535835",
      "schema": "Cites",
      "values": {
        "weight": 2
      }
    }
  ],
  "alias": "e",
  "type": 3,
  "type_desc": "RESULT_TYPE_EDGE"
}

RESULT_TYPE_PATH

本条查询返回与变量p绑定的一步出向路径：

MATCH p = ()-[]->() RETURN p

p的数据结构：

{
  "data": [
    {
      "nodes": [
        {
          "id": "P1",
          "uuid": "8791028671650463770",
          "schema": "Paper",
          "values": {
            "title": "Efficient Graph Search",
            "score": 6
          }
        },
        {
          "id": "P2",
          "uuid": "8718971077612535835",
          "schema": "Paper",
          "values": {
            "title": "Optimizing Queries",
            "score": 9
          }
        }
      ],
      "edges": [
        {
          "from": "P1",
          "to": "P2",
          "uuid": "1",
          "from_uuid": "8791028671650463770",
          "to_uuid": "8718971077612535835",
          "schema": "Cites",
          "values": {
            "weight": 2
          }
        }
      ],
      "length": 1
    }
  ],
  "alias": "p",
  "type": 1,
  "type_desc": "RESULT_TYPE_PATH"
}

RESULT_TYPE_ATTR

本条查询返回标签为Paper的点的title属性值：

MATCH (n:Paper) RETURN n.title

n.title的数据结构:

{
  "data": {
    "alias": "n.title",
    "type": 4,
    "type_desc": "RESULT_TYPE_ATTR",
    "values": [
      "Optimizing Queries",
      "Efficient Graph Search"
    ]
  },
  "alias": "n.title",
  "type": 4,
  "type_desc": "RESULT_TYPE_ATTR"
}

RESULT_TYPE_TABLE

本条查询返回与变量table绑定的一个表：

MATCH (n:Paper) RETURN table(n.title, n.score) AS table

table的数据结构：

{
  "data": {
    "name": "table",
    "alias": "table",
    "headers": [
      "n.title",
      "n.score"
    ],
    "rows": [
      [
        "Optimizing Queries",
        "9"
      ],
      [
        "Efficient Graph Search",
        "6"
      ]
    ]
  },
  "alias": "table",
  "type": 5,
  "type_desc": "RESULT_TYPE_TABLE"
}

Null值

null值是一种特殊值，在所有可空类型中使用。任何非空值都是有效值。

Null情景

null值可在多种情况下出现，如：

• 默认分配值：在插入点或边时，若未指定属性值给可空属性，则自动接收null值。
• 显式指定Null值：在插入点或边时，可空属性可被专门指定为null。
• 删除属性值：删除属性原有值并用null替代。
• 分配新属性：为标签添加新属性时，默认情况下，该标签下已有的点或边，对应的新属性将被赋予null值。
• 不存在的属性引用：引用不存在的属性会返回null值。
• 可选匹配：在MATCH语句中使用关键字OPTIONAL时，若没有找到匹配模式的结果，MATCH会生成null值而非空返回。
• NULLIF表达式：如果两个比较值相等，NULLIF表达式返回null值。

Null比较

null值本质上未知，因此无法和其他值进行比较。涉及null的比较若使用了=或<>等普通运算符，通常不会生成真或假的结果，而是产生一个未知结果，也表示为null。

涉及null的比较需要用到null谓词（IS NULL和IS NOT NULL）作特殊处理。

Null处理

在某些情况下，null值会得到特殊处理，例如：

• 聚合函数通常忽略null值。
• GROUP BY从句将所有null值归为一组。
• ORDER BY语句允许使用关键字NULLS FIRST和NULL LAST对null排序。