Ultipa graph algorithms can be executed using both GQL and UQL via Ultipa Manager, Ultipa CLI, or by integrating Ultipa Drivers into your applications. Drivers are available for Java, Python, Go, Node.js, and C#.
Algorithm Results
The results of an algorithm's execution include a primary result and optionally a statistical summary.
- Primary result delivers the algorithm’s core outputs, such as node rankings, pairwise similarities, or calculated metrics.
- Statistical summary, when available, offers aggregated insights, including averages, sums, or distribution details, to support further analysis of the primary results.
Execution Modes
Algorithms can be executed in one of the six execution modes: File Writeback, DB Writeback, Stats Writeback, Full Return, Stream Return, and Stats Return.
An algorithm may support one or more of these execution methods. For details, refer to the individual algorithm page.
Overall, the HDC and distributed algorithm versions differ in their support for these execution modes:
| Execution Mode | HDC Algorithm | Distributed Algorithm |
|---|---|---|
| File Writeback | Yes | Yes |
| DB Writeback | Yes | Yes |
| Stats Writeback | Yes | / |
| Full Return | Yes | / |
| Stream Return | Yes | / |
| Stats Return | Yes | / |
We will introduce each execution mode below, along with their syntax. Note that regardless of whether an algorithm runs on an HDC graph or a distributed projection, the syntax remains the same.
File Writeback
In this mode, the algorithm runs as a job, writing its primary result to one or more files and, when available, saving the statistical summary to the job for later access. This is useful for handling large outputs that don't need to be returned directly to the client, especially when offline storage or later processing is required.
DB Writeback
In this mode, the algorithm runs as a job, writing certain columns from its primary result directly to designated node properties within the database for permanent storage and, when available, saving the statistical summary to the job. This allows data to be readily accessible for future queries or analyses.
Stats Writeback
In this mode, the algorithm runs as a job. The statistical summary from the execution are saved along with the job.
Full Return
In this mode, the algorithm runs as a real-time process. The algorithm completes execution and then returns the full primary result in a single response to the client.
Stream Return
In this mode, the algorithm runs as a real-time process. The primary result is streamed progressively to the client as they are generated. This mode optimizes resource usage and provides faster access to results, beneficial for applications needing immediate feedback.
Stats Return
In this mode, the algorithm runs as a real-time process. After execution completes, it returns the statistical summary to the client.