UltipaDocs
Try Playground
    • Install Ultipa
    • Install Ultipa Manager
  • License
    • Meta Servers
    • Shard Servers
    • HDC Servers
    • Vector Servers
    • Server Statistics
    • Privilege
    • Role (Policy)
    • User
  • Backup and Restore
  1. Docs
  2. /
  3. Operations & Maintenance
  4. /
  5. Server Management

Vector Servers

Overview

The vector servers can be deployed alongside Ultipa Powerhouse (v5), providing support for vector indexing and search.

Showing Vector Servers

Retrieves information about all vector servers:

SHOW VECTOR SERVER

Retrieves information about the vector server named vector_server_1:

UQL
show().vector("vector_server_1")

The information about vector servers is organized into a table named _vector, including the following fields:

Field
Description
nameName of the vector server.
addrIP address and port of the vector server.
statusCurrent state of the vector server, which can be ACTIVE or DEAD.
last_heartbeatTimestamp of the last heartbeat sent to the meta servers by the vector server.

Adding a Vector Server

After successfully deploying a new vector server, it must be registered with the meta servers before it can be utilized. This process ensures that the new vector server is recognized within the system.

The following example adds a vector server with the name vector_server_1 and the address 127.0.0.1:55555:

ADD VECTOR SERVER "vector_server_1" AT "127.0.0.1:55555"

Deleting a Vector Server

You can unregister an inactive or obsolete vector server from the meta servers.

The following example deletes the vector server with the name vector_server_1:

DELETE VECTOR SERVER "vector_server_1"