---
title: "GSQL Interface"
component: "pytigergraph"
version: "1.6"
module: "core-functions"
html_url: "/pytigergraph/1.6/core-functions/gsql"
canonical_url: "https://www.tigergraph.com/docs/pytigergraph/1.6/core-functions/gsql"
markdown_url: "https://www.tigergraph.com/docs/pytigergraph/1.6/core-functions/gsql.md"
---

[View as HTML](https://www.tigergraph.com/docs/pytigergraph/1.6/core-functions/gsql)

# GSQL Interface

Use GSQL within pyTigerGraph. All functions in this module are called as methods on a [TigerGraphConnection object](https://www.tigergraph.com/docs/pytigergraph/1.8/core-functions/base.md).

## gsql()

`gsql(query: str, graphname: str = None, options = None) → Union[str, dict]`

Runs a GSQL query and processes the output.

#### Parameters:

* `query`: The text of the query to run as one string. The query is one or more GSQL statement.
* `graphname`: The name of the graph to attach to. If not specified, the graph name provided at the time of establishing the connection will be used.
* `options`: DEPRECATED

#### Returns:

The output of the statement(s) executed.

## installUDF()

`installUDF(ExprFunctions: str = "", ExprUtil: str = "") → None`

Install user defined functions (UDF) to the database.  
See [this](https://www.tigergraph.com/docs/gsql-ref/4.3/querying/func/query-user-defined-functions.md) for more details. for details on UDFs.

#### Parameters:

* `ExprFunctions (str, optional)`: Path or URL to the file for ExprFunctions. Defaults to '' (a blank path/URL).
* `ExprUtil (str, optional)`: Path or URL to the file for ExprUtil. Defaults to '' (a blank path/URL).

#### Returns:

Status of the installation.

## getUDF()

`getUDF(ExprFunctions: bool = True, ExprUtil: bool = True) → Union[str, Tuple[str, str]]`

Get user defined functions (UDF) installed in the database.  
See [this](https://www.tigergraph.com/docs/gsql-ref/4.3/querying/func/query-user-defined-functions.md) for more details. for details on UDFs.

#### Parameters:

* `ExprFunctions (bool, optional)`: Whether to get ExprFunctions. Defaults to True.
* `ExprUtil (bool, optional)`: Whether to get ExprUtil. Defaults to True.

#### Returns:

str: If only one of `ExprFunctions` or `ExprUtil` is True, return of the content of that file. Tuple\[str, str\]: content of ExprFunctions and content of ExprUtil.
