tigergraph__run_installed_query
Executes a pre-installed GSQL query on a TigerGraph graph using provided parameters, enabling faster repeated runs.
Instructions
Run an installed GSQL query on a TigerGraph graph with parameters. Faster than interpreted queries for repeated execution.
Use When: • Running pre-installed, compiled queries • Queries that are executed frequently • Performance-critical operations • Parameterized queries with different inputs
Quick Start:
{
"query_name": "getPersonFriends",
"params": {"personId": "user123", "maxHops": 2}
}Common Workflow:
Install query once with 'install_query'
Run multiple times with 'run_installed_query' and different params
Much faster than 'run_query' for repeated use
Tips: • Queries must be installed first with 'install_query' • Use 'is_query_installed' to check if query exists • Provide params as dictionary matching query signature • Faster than interpreted queries
Related Tools: install_query, is_query_installed, show_query
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | No | Query parameters. | |
| profile | No | Connection profile name. Omit to use the active default profile. Use 'list_connections' to see available profiles. | |
| graph_name | No | Name of the graph. If not provided, uses default connection. | |
| query_name | Yes | Name of the installed query. |