Graph walk query function overview
Use the graph walk function to retrieve CI and relationship instances when you do not know the exact relationship path to follow, for example, to view all the dependencies of a computer system regardless of the class to which the dependencies belong. You must know the instance from which to begin the graph walk.
The starting node and query loop
To successfully retrieve instances using the graph walk functions, first specify the start node (
CMDBGraphWalkBegin ) for the graph walk. Then use the
hasNextChunk member of the
CMDBGraphWalkStateStruct structure to loop until you retrieve all the rows that match the query.
In the loop, you call the
CMDBGraphWalkNext function until the query has no more records to return. Chunking occurs when the
maxRetrieve parameter has a value greater than 0. Otherwise, the query returns all the nodes in the first call. For example, if the query retrieves 500 rows of data and the
maxRetrieve parameter is set to 100, the
CMDBGraphWalkNext function returns 100 nodes in the first call, 100 nodes in the next, and so on.