值和类型

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

属性值类型

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

数值

文本

时间点

日期

• 格式：yyyy-[m]m-[d]d或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

时间段

布尔

空间

记录

二进制

列表和集合

构造值类型

构造值类型是包含复合元素的数据类型。UQL支持以下构造值类型：

结果类型

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

RESULT_TYPE_NODE

本条查询返回所有@Paper点的信息：

find().nodes({@Paper}) as n
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的所有信息：

n().re({@Cites} as e).n()
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

本条查询返回一步出向路径的所有信息：

n().re().n() as 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属性：

find().nodes({@Paper}) as n
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

本条查询返回一个表：

find().nodes({@Paper}) as n
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替代。
• 分配新属性：向schema添加新属性时，默认情况下，该schema下已有的点或边，对应的新属性将被赋予null值。
• 不存在的属性引用：引用不存在的属性会返回null值。
• 可选匹配：当find()、khop()等语句使用OPTIONAL关键字时，若没有找到结果，语句生成null值而非空返回。

Null比较

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

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

Null处理

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

• 聚合函数通常忽略null值。
• 语句GROUP BY将所有null值归为一组。