GraphSet Management

Manage All GraphSets

Ultipa Manager provides two ways to list all the graphsets in the current Ultipa Database:

  • go to Graph module, and click current graphset name on top of the panel
  • click current graphset name at the lower right corner of Manager

Click '+' at the top right corner of graphset list to create new graphset:

Rules for graphset name:

  • Start with letters [a-zA-Z]
  • Only includes underscore (_), numbers [0-9] or letters [a-zA-Z]
  • Length between [2, 32] ASCII characters

An existing graphset can be renamed. To rename a graphset, click 'Edit' to the right of the graphset in the list:

'Used' in the row indicates the current graphset; click 'Select' to switch from current graphset to a desired graphset.

Manage Current GraphSet

Basic information

The current graphset panel will show or hide upon clicking Graph module in the sidebar. Basic information of current graphset includes:

  • number of nodes
  • list of user-defined properties and system write-back properties of node
  • number of edges
  • list of user-defined properties and system write-back properties of edge
  • list of indexes
  • number of cluster instances
  • list of cluster instances (click to switch instance)

The properties loaded to engine and the indexes for fulltext search are marked with a dot in orange color:

Property Operations

To delete or create meta-data properties, or to load/unload properties to/from Ultipa Engine, click the 2nd icon to the right of meta-data number in the panel. Take node properties for example:

Refer to chapter of Terminologies for the concept of LTE and UFE.

In the popup window, click '+' at the lower left corner to add new properties:

Rules for property name:

  • Start with letters [a-zA-Z]
  • Only includes underscore (_), numbers [0-9] or letters [a-zA-Z]
  • Length between [2, 32] ASCII characters

Operations on edges properties are similar.

Meta-data Operations

Single Insertion

To add a single meta-data, click the 1st icon to the right of meta-data number in the current graphset panel.

To add a node:

To add an edge:

Note: when adding a singel node or edge, users cannot specify the _id, which will be automatically generated by system.

Batch Import

Meta-data can be imported in bulk from a local file. Four steps are required to complete a batch import operation:

  1. Upload: select and upload a data file from local folder;
  2. Configure: declare column delimitor and whether the column header (property names) is included in the file;
  3. Specify Header: specify property name and data type of each column, and create the properties that do not exist in the current graphset;
  4. Import: import meta-data from the file to the current graphset.

Click 'Import' at the bottom of the current graphset panel, and a list of recent import operations show on the right in time descending order; click 'New Import' on the top:

A data file with node or edge information should be ready at this stage. Prepare a csv node file with below data for example:

Note: users can specify the _id of each meta-data in the file; valid file format are csv, txt, etc.

Click '+ Node' in previous step, select and upload the node file, and click 'Configure' after the upload finishes:

Set column delimitor and declare the column header of the data file. In this example, a csv file uses comma (,) as column delimitor, and the column header is included in the file. Click 'Preview' to check whether the data is parsed correctly:

Incorrect configuration of data format can be detected from the preview page. See an example of preview page resulted from a wrong configuration:

If new properties are recognized from the previous step, namely there are columns that have no names or have names but are not existing in the current graphset, they should be set with names and selected with data types, and further be created:

When all the new properties are created, submit and start the import operation:

An import operation with successful uploading procedure will be shown in the recent import list, where the later steps can be retrieved. Click 'Import' or 'Configure' of a specific record to recall the respective steps:

Procedure of importing edge file can be inferred from above. Note that the edge data file must contain at least the from node id and the to node id:

Batch Export

Corresponding to batch import, Ultipa Manager provides batch export of meta-data into csv file, with column delimited by comma (,):