Overview

The Shard Servers is a crucial component of the Ultipa Powerhouse (v5) architecture, typically comprising multiple servers dedicated to distributed graph storage and computation. This design enables horizontal scaling while delivering highly competitive performance.

Each shard supports multi-replica data storage. In the three-shard setup below, shards 1 and 2 each have three replicas, while shard 3 has two replicas. Graphsets are distributed across these shards, with Graph_1 stored in all three shards, Graph_2 and Graph_3 partially stored across the three shards, and Graph_4 located in a single shard.

You can project graphsets from the physical storage of the shard servers into their memory, resulting in what are known as distributed projections. These projections allow graph algorithms to execute with improved performance.

Showing Shard Servers

Retrieves information about all shard servers:

show().shard()

The details returned for each shard server include:

Adding a Shard Server

After successfully deploying a new shard server, it must be registered with the meta servers using the alter().shard().add() clause before it can be utilized. This process ensures that the new shard server is recognized within the system.

The following example adds a shard server 4 with three replicas:

alter().shard().add({
  shardId: 4,
  replicas: [
    {addr: "127.0.0.1:40061", streamAddr: "127.0.0.1:40023"},
    {addr: "127.0.0.2:40061", streamAddr: "127.0.0.2:40023"},
    {addr: "127.0.0.3:40061", streamAddr: "127.0.0.3:40023"}
  ]
})

Deleting a Shard Server

You can unregister an inactive or obsolete shard server from the meta servers using the alter().shard().delete() clause.

The following example deletes the shard server with the shardId 1:

alter().shard().delete({shardId: 1})