Main Content

addNodeLabel

Add labels to nodes in Neo4j database

Description

addNodeLabel(neo4jconn,node,labels) adds node labels to one or more nodes in a Neo4j® database using a Neo4j database connection.

example

nodeinfo = addNodeLabel(neo4jconn,node,labels) returns updated node information as a Neo4jNode object for one node, or as a table for multiple nodes.

example

Examples

collapse all

Add one node label to a single node in a Neo4j® database and access the node.

Create a Neo4j database connection using the URL http://localhost:7474/db/data, user name neo4j, and password matlab.

url = 'http://localhost:7474/db/data';
username = 'neo4j';
password = 'matlab';
neo4jconn = neo4j(url,username,password);

Check the Message property of the Neo4j connection object neo4jconn. The blank Message property indicates a successful connection.

neo4jconn.Message
ans =

     []

Retrieve the first node in the table of node information. This node has the label Person.

nlabel = "Person";
nodeinfo = searchNode(neo4jconn,nlabel);
node = nodeinfo.NodeObject(1);

Add one node label to a single node in the database using the Neo4j database connection.

labels = "Analyst";
addNodeLabel(neo4jconn,node,labels)

Display the node labels for the updated node. The NodeLabels property contains two labels.

nodeinfo = searchNode(neo4jconn,labels);
nodeinfo.NodeLabels
ans = 2×1 cell array
    {'Person' }
    {'Analyst'}

Close the database connection.

close(neo4jconn)

Add node labels to multiple nodes in a Neo4j® database. Access the updated node information using an output argument.

Create a Neo4j database connection using the URL http://localhost:7474/db/data, user name neo4j, and password matlab.

url = 'http://localhost:7474/db/data';
username = 'neo4j';
password = 'matlab';
neo4jconn = neo4j(url,username,password);

Check the Message property of the Neo4j connection object neo4jconn. The blank Message property indicates a successful connection.

neo4jconn.Message
ans =

     []

Find nodes with the label Person, and display the node labels.

nlabel = "Person";
nodeinfo = searchNode(neo4jconn,nlabel);
nodeinfo.NodeLabels
ans = 7×1 cell array
    {'Person'}
    {'Person'}
    {'Person'}
    {'Person'}
    {'Person'}
    {'Person'}
    {'Person'}

Add multiple node labels to the nodes in the database using the Neo4j database connection. The nodeinfo output argument is a Neo4jNode object.

node = nodeinfo.NodeObject;
labels = ["Analyst" "Scientist"];
nodeinfo = addNodeLabel(neo4jconn,node,labels);

Display the node information for the updated nodes. Each node has three node labels (Person, Analyst, and Scientist).

nodeinfo.NodeLabels
ans = 7×1 cell array
    {3×1 cell}
    {3×1 cell}
    {3×1 cell}
    {3×1 cell}
    {3×1 cell}
    {3×1 cell}
    {3×1 cell}

Close the database connection.

close(neo4jconn)

Input Arguments

collapse all

Neo4j database connection, specified as a Neo4jConnect object created with the function neo4j.

Node in a Neo4j database, specified as a Neo4jNode object, Neo4jNode object array, numeric scalar, or a numeric vector. For one node, specify a Neo4jNode object or a numeric scalar. For multiple nodes, specify a Neo4jNode object array or a numeric vector.

The numeric scalar or vector must contain Neo4j database node identifiers.

Example: 15

Example: [2,3,4]

Node labels, specified as a character vector, cell array of character vectors, string scalar, or string array. To specify one node label, use a character vector or string scalar. For multiple node labels, use a cell array of character vectors or a string array.

Example: "Person"

Data Types: char | string | cell

Output Arguments

collapse all

Node information in the Neo4j database, returned as a Neo4jNode object for one node or as a table for multiple nodes.

For multiple nodes, the table contains these variables:

  • NodeLabels — Cell array of character vectors that contains the node labels for each database node

  • NodeData — Cell array of structures that contains node information such as property keys

  • NodeObjectNeo4jNode object for each database node

The row names of the table are Neo4j node identifiers of each database node.

Version History

Introduced in R2019a