/show/graph

URL: http://<db.host>:<db.port>/show/graph

Shows information and characteristics of graphs that exist on the graph server.

Input Parameter Description

Name Type Description
graph_name string Name of the graph on which to retrieve information. If left as the default value, information about all graphs is returned. The default value is ''.
options map of string to strings

Optional parameters. The default value is an empty map ( {} ).

Supported Parameters (keys) Parameter Description
show_original_request

If set to true, the request that was originally used to create the graph is also returned as JSON. The default value is true. The supported values are:

  • true
  • false
server_id Indicates which graph server(s) to send the request to. Default is to send to get information about all the servers.

Output Parameter Description

The GPUdb server embeds the endpoint response inside a standard response structure which contains status information and the actual response to the query. Here is a description of the various fields of the wrapper:

Name Type Description
status String 'OK' or 'ERROR'
message String Empty if success or an error message
data_type String 'show_graph_response' or 'none' in case of an error
data String Empty string
data_str JSON or String

This embedded JSON represents the result of the /show/graph endpoint:

Name Type Description
result boolean Indicates a success. This call will fail if the graph specified in the request does not exist.
load array of ints A percentage approximating the current computational load on the server.
memory array of longs Available memory.
graph_names array of strings Name(s) of the graph(s).
graph_server_ids array of ints Id(s) of the graph(s).
graph_owner_user_names array of strings Owner of the graph(s) and associated solution table(s).
graph_owner_resource_groups array of strings Owner of the resource groups(s) of the graph(s).
directed array of booleans Whether or not the edges of the graph have directions (bi-directional edges can still exist in directed graphs). Consult Directed Graphs for more details.
num_nodes array of longs Total number of nodes in the graph.
num_edges array of longs Total number of edges in the graph.
num_bytes array of longs Memory this graph uses in bytes.
resource_capacity array of longs Memory this graph uses in bytes.
is_persisted array of booleans Shows whether or not the graph is persisted (saved and loaded on launch).
is_partitioned array of booleans Indicated if the graph data is distributed across all available servers.
is_sync_db array of booleans Shows whether or not the graph is linked to the original tables that created it, and will potentially be re-created instead loaded from persist on launch.
has_insert_table_monitor array of booleans Shows whether or not the graph has an insert table monitor attached to it.
original_request array of strings The original client request used to create the graph (before any expression evaluation or separator processing).
info map of string to strings Additional information.

Empty string in case of an error.