TigerGraphConnection
A TigerGraphConnection object provides the HTTP(S) communication used by all other modules.
This object is the synchronous version of the connection object.
If you want to use pyTigerGraph in an asynchronous environment, use the AsyncTigerGraphConnection
object.
The TigerGraphConnection
object is the main object that you will interact with when using pyTigerGraph.
To test your connection, you can use the echo()
method. This method sends a simple request to the server and returns the response.
from pyTigerGraph import TigerGraphConnection
conn = TigerGraphConnection(
host="http://localhost",
graphname="MyGraph",
username="tigergraph",
password="tigergraph")
print(conn.echo())
_init_()
init(host: str = "http://127.0.0.1", graphname: str = "MyGraph", gsqlSecret: str = "", username: str = "tigergraph", password: str = "tigergraph", tgCloud: bool = False, restppPort: Union[int, str] = "9000", gsPort: Union[int, str] = "14240", gsqlVersion: str = "", version: str = "", apiToken: str = "", useCert: bool = None, certPath: str = None, debug: bool = None, sslPort: Union[int, str] = "443", gcp: bool = False, jwtToken: str = "")
Initiate a connection object.
Parameters:
-
host
: The host name or IP address of the TigerGraph server. Make sure to include the protocol (http:// or https://). IfcertPath
isNone
and the protocol is https, a self-signed certificate will be used. -
graphname
: The default graph for running queries. -
gsqlSecret
: The secret key for GSQL.
See this for more details. -
username
: The username on the TigerGraph server. -
password
: The password for that user. -
tgCloud
: Set toTrue
if using TigerGraph Cloud. If your hostname containstgcloud
, then this is automatically set toTrue
, and you do not need to set this argument. -
restppPort
: The port for REST++ queries. -
gsPort
: The port for gsql server. -
gsqlVersion
: The version of the GSQL client to be used. Effectively the version of the database being connected to. -
apiToken (Optional)
: Paremeter for specifying a RESTPP service token. UsegetToken()
to get a token. -
version
: DEPRECATED; usegsqlVersion
. -
useCert
: DEPRECATED; the need for a CA certificate is now determined by URL scheme. -
certPath
: The filesystem path to the CA certificate. Required in case of https connections. -
debug
: DEPRECATED; configure standard logging in your app. -
sslPort
: Port for fetching SSL certificate in case of firewall. -
gcp
: DEPRECATED. Previously used for connecting to databases provisioned on GCP in TigerGraph Cloud. -
jwtToken
: The JWT token generated from customer side for authentication
Raises:
TigerGraphException: In case on invalid URL scheme.
getVersion()
getVersion(raw: bool = False) → Union[str, list]
Retrieves the git versions of all components of the system.
Parameter:
-
raw
: Return unprocessed version info string, or extract version info for each component into a list.
Returns:
Either an unprocessed string containing the version info details, or a list with version info for each component.
Endpoint:
-
GET /version
See Show component versions
getVer()
getVer(component: str = "product", full: bool = False) → str
Gets the version information of a specific component.
Get the full list of components using getVersion()
.
Parameters:
-
component
: One of TigerGraph’s components (e.g. product, gpe, gse). -
full
: Return the full version string (with timestamp, etc.) or just X.Y.Z.
Returns:
Version info for specified component.
Raises:
TigerGraphException
if invalid/non-existent component is specified.
customizeHeader()
customizeHeader(timeout: int = 16000, responseSize: int = 32000000.0)
Method to configure the request header.
Parameters:
-
tiemout (int, optional)
: The timeout value desired in milliseconds. Defaults to 16,000 ms (16 sec) -
responseSize
: The size of the response in bytes. Defaults to 3.2E7 bytes (32 MB).
Returns:
Nothing. Sets responseConfigHeader
class attribute.