Dgraph 入门教程五《Shema》

大家好，欢迎来到IT知识分享网。

要想做好图数据库，必须做图数据库设计，想做好Dgraph，就需要设计好Shema。Shema的语法是必须理解，如果不理解，别人写的Shema，我们也看不懂。我这里也是走马观花式的记录，细节还需要在使用的时候去慢慢理解。看完这篇文章，别人写的Shema，是能看懂的。

1、数据类型

1.1、标量类型

Schema 的标量数据类型有以下几种，Int，Float，String，Boolean，DateTime。还有一种数组类型或者list类型，比如[“e1”, “e1”, “e2”]。

下面是各种类型的定义例子，其中Float 是个list。

type User { userID: ID! name: String! lastSignIn: DateTime recentScores: [Float] reputation: Int active: Boolean } 

1.2、ID类型

可以用ID 类型标记每个节点的唯一字段类型。ID类型可以自动编码，不变的，不重复的。

例如

type Post { id: ID! ... } 

1.3、枚举类型

你可以定义枚举类型，示例如下

enum Tag { GraphQL Database Question ... } type Post { ... tags: [Tag!]! } 

1.4、接口

GraphQL允许你定义接口，节点需要继承父类型的属性，继承的属性和类型都需要一致，示例如下：

interface Fruit { id: ID! price: Int! } type Apple implements Fruit { id: ID! price: Int! color: String! } type Banana implements Fruit { id: ID! price: Int! } 

可以多继承，多继承时，除了ID属性，父类的属性名字不可以一样。

interface Shape { id: ID! shape: String! } interface Color { id: ID! color: String! } type Figure implements Shape & Color { id: ID! shape: String! color: String! size: Int! } 

1.5、联合类型

多个类型可以组合成一个类型

enum Category { Fish Amphibian Reptile Bird Mammal InVertebrate } interface Animal { id: ID! category: Category @search } type Dog implements Animal { breed: String @search } type Parrot implements Animal { repeatsWords: [String] } type Cheetah implements Animal { speed: Float } type Human { name: String! pets: [Animal!]! } union HomeMember = Dog | Parrot | Human type Zoo { id: ID! animals: [Animal] city: String } type Home { id: ID! address: String members: [HomeMember] } 

1.6、密码类型

密码类型 使用关键字@secret。密码类型不可以直接被查询。密码类型用Bsrypt去加密

例如：

type Author @secret(field: "pwd") { name: String! @id } 

1.7、地理类型

类型主要有Point,Polygon和MultiPolygon。

Point

type Point { longitude: Float! latitude: Float! } 

PointList

type PointList { points: [Point!]! } 

Polygon

type Polygon { coordinates: [PointList!]! } 

MultiPolygon

type MultiPolygon { polygons: [Polygon!]! } 

2、节点关系

节点与节点之间有关系相连。Dgraph 可以描述这些关系。用@hasInverse 可以实现双向相连关系。

2.1 、单向关系

type Author { ... } type Post { ... author: Author } 

2.2 、双向关系

type Author { ... posts: [Post] @hasInverse(field: author) } type Post { ... author: Author } 

3、指令

Dgraph 有很多指令 Directives。知道这些指令的含义，才能看懂和更好的写Shema。

3.1 、 @auth

auth 允许您定义如何对类型的查询/变异应用授权规则。

3.2 、@deprecated

这个指定提醒用户某个属性已经废弃

type MyType { id: ID! oldField: String @deprecated(reason: "oldField is deprecated. Use newField instead.") newField: String deprecatedField: String @deprecated } 

3.3、@dgraph

这个指定用于自定义名字，类似别名

type Person @dgraph(type: "Human-Person") { name: String @search(by: [hash]) @dgraph(pred: "name") age: Int } type Human-Person { name Person.age } 

3.4、@id

该指令可以指定某个属性是id字段

type User { username: String! @id ... } 

3.5、@search

该指令用于搜索。

搜索是最多的，也是最复杂的。我这里只是简单介绍了下常用的。对于Int，Float和DateTime ，有下面参数。

It：小于。le：小于等于。eq：等于。in：在内。between：在什么中间。ge:大于等于。gt:大于。

下面是个定义和查询

type Post { ... numLikes: Int @search } query { queryPost(filter: { numLikes: { gt: 50 }}) { ... } } 

对于String

比如：

type Post { title: String @search(by: [term]) text: String @search(by: [fulltext]) ... } query { queryPost(filter: { title: { `allofterms: "GraphQL tutorial"` } } ) { ... } } 

地理字段

举个例子

type Hotel { id: ID! name: String! location: Point @search area: Polygon @search } queryHotel(filter: { location: { near: { coordinate: { latitude: 37., longitude: -122. }, distance: 1000 } } }) { name } 

3.6、@generate

用于指定哪些Api生效

type Person @generate( query: { get: false, query: true, aggregate: false }, mutation: { add: true, delete: false }, subscription: false ) { id: ID! name: String! } 

3.7 @withSubscription

用于订阅属性，一般用于WebSoct。