Data modeling¶

A data model is a model that organizes data and specifies how they are related to one another. This topic describes the Nebula Graph data model and provides suggestions for data modeling with Nebula Graph.

Data structures¶

Nebula Graph data model uses six data structures to store data. They are graph spaces, vertices, edges, tags, edge types and properties.

• Graph spaces: Graph spaces are used to isolate data from different teams or programs. Data stored in different graph spaces are securely isolated. Storage replications, privileges, and partitions can be assigned.
• Vertices: Vertices are used to store entities.
  • In Nebula Graph, vertices are identified with vertex identifiers (i.e. VID). The VID must be unique in the same graph space. VID should be int64, or fixed_string(N).
  • A vertex must have at least one tag or multiple tags.
• Edges: Edges are used to connect vertices. An edge is a connection or behavior between two vertices.
  • There can be multiple edges between two vertices.
  • Edges are directed. -> identifies the directions of edges. Edges can be traversed in either direction.
  • An edge is identified uniquely with a source vertex, an edge type, a rank value, and a destination vertex. Edges have no EID.
  • An edge must have one and only one edge type.
  • The rank value is an immutable user-assigned 64-bit signed integer. It identifies the edges with the same edge type between two vertices. Edges are sorted by their rank values. The edge with the greatest rank value is listed first. The default rank value is zero.
• Tags: Tags are used to categorize vertices. Vertices that have the same tag share the same definition of properties.
• Edge types: Edge types are used to categorize edges. Edges that have the same edge type share the same definition of properties.
• Properties: Properties are key-value pairs. Both vertices and edges are containers for properties.

Directed property graph¶

Nebula Graph stores data in directed property graphs. A directed property graph has a set of vertices connected by directed edges. Both vertices and edges can have properties. A directed property graph is represented as:

G = < V, E, P_V, P_E >

• V is a set of vertices.
• E is a set of directed edges.
• P_V is the property of vertices.
• P_E is the property of edges.

The following table is an example of the structure of the basketball player dataset. We have two types of vertices, that is player and team, and two types of edges, that is serve and follow.