数据类型

所有数据类型

属性

创建每一个点或边属性时都需指定数据类型，或使用默认的数据类型（string）。所有支持的属性数据类型如下：

^[1]decimal存储的是准确的数字，因此需指定精度和标度。精度是所有数字的位数，包括整数与小数（不包括小数点），标度是小数点后的数字位数。

返回的数据

从服务器获取数据并处理后，返回数据的数据类型如下：

示例图集：

NODE

返回name属性值为Alice的点：

find().nodes({name == 'Alice'}) as n
return n{*}

点的数据结构为：

{
	"id": "STU001",
	"uuid": 1,
	"schema": "student",
	"values": {
		"name": "Alice",
		"age": 25
	}
}

EDGE

返回UUID为53的边：

find().edges({_uuid == 53}) as e
return e{*}

边的数据结构为：

{
	"uuid": 53,
	"schema": "studyAt",
	"from": "STU001",
	"to": "UNI001",
	"from_uuid": 1,
	"to_uuid": 1001,
	"values": {
		"start": 2001,
		"end": 2005
	}
}

PATH

返回从Alice到Oxford的路径：

n({name == 'Alice'}).e().n({name == 'Oxford'}) as p
return p{*}

路径的数据结构为：

{
	"length": 1,
	"nodes": [{
		"id": "STU001",
		"uuid": 1,
		"schema": "student",
		"values": {
			"name": "Alice",
			"age": 25
		}
	}, {
		"id": "UNI001",
		"uuid": 1001,
		"schema": "university",
		"values": {
			"name": "Oxford"
		}
	}],
	"edges": [{
		"uuid": 53,
		"schema": "studyAt",
		"from": "STU001",
		"to": "UNI001",
		"from_uuid": 1,
		"to_uuid": 1001,
		"values": {
			"start": 2001,
			"end": 2005
		}
	}]
}

GRAPH

返回由从Alice到Oxford的路径转换而成的图：

n({name == 'Alice'}).e().n({name == 'Oxford'}) as p
return toGraph(collect(p))

图的数据结构为：

{
	"nodes": [{
		"id": "STU001",
		"uuid": 1,
		"schema": "student",
		"values": {
			"name": "Alice",
			"age": 25
		}
	}, {
		"id": "UNI001",
		"uuid": 1001,
		"schema": "university",
		"values": {
			"name": "Oxford"
		}
	}],
	"edges": [{
		"uuid": 53,
		"schema": "studyAt",
		"from": "STU001",
		"to": "UNI001",
		"from_uuid": 1,
		"to_uuid": 1001,
		"values": {
			"start": 2001,
			"end": 2005
		}
	}]
}

TABLE

返回有所有点的ID和name属性值构成的表：

find().nodes() as n
return table(n._id, n.name)

结果：

表的数据结构为：

{
  "name": "table(n._id, n.name)",
  "alias": "table(n._id, n.name)",
  "headers": [
    "n._id",
    "n.name"
  ],
  "rows": [
    [
      "STU001",
      "Alice"
    ],
    [
      "UNI001",
      "Oxford"
    ]
  ]
}

ATTR

返回Alice在Oxford学习了多久：

find().edges({_uuid == 53}) as e
return e.end - e.start

该结果的数据结构为：

{
  "values": [
    4
  ]
}

关于如何在RETURN子句中指定有效的返回格式，请参考这里的表格。

Null

在嬴图数据库中，null表示属性值或查询结果不存在。请注意null与0或空字符串不是一回事。具体来说，以下情况会产生null值：

• 插入点或边（insert()、insert().overwrite()）时，未指定的属性会被赋值为null
• 创建属性时，相应schema中已有点或边的该新属性会被赋值为null
• 请求一个不存在的属性时，会返回null
• 查询子句（find()、khop()、n().e().n()等）没有任何结果时，如果使用了前缀OPTIONAL，会返回null（而不是无任何返回值）

当条件判断表达式包含null时：

• 如果有确定的结果，返回真或假
• 否则，返回null

有null参与的数值运算（+/-/*///%）的结果均为null。

有null参与的聚合函数运算（count()/sum()/max()/min()/avg()/stddev()/collect()）均忽略null值进行相应的运算。

与判断null值相关的函数和操作符：

• coalesce()
• ifnull()
• 空
• 非空