Connecting to Your Cluster
You can connect to your cluster by using the following clients:
Connection URI and API credentials
All examples below use the following values:
-
{connectionUri}— obtain from the Connections widget -
{login}and{password}— obtain from the My cluster tab.
Java client
The Java thin client connects to the cluster via a standard socket connection. It does not become a part of the cluster topology, never holds any data, and is not used as a destination for compute calculations. The thin client simply establishes a socket connection to a standard node and performs all operations through that node.
-
Add the following dependencies to your Maven project:
<repositories> <repository> <id>GridGain External Repository</id> <url>https://www.gridgainsystems.com/nexus/content/repositories/external</url> </repository> </repositories> <dependencies> <dependency> <groupId>org.gridgain</groupId> <artifactId>ignite-core</artifactId> <version>${gg.version}</version> </dependency> </dependencies> -
Create a client configuration and replace the
{login}and{password}placeholders with your cluster credentials. Replace the{connectionUri}with the connection URI from the Connections widget.public static void main(String[] args) { SslConfiguration sslConfiguration = new SslConfigurationBuilder() .enabled(true) .build(); IgniteClientAuthenticator auth = BasicAuthenticator.builder() .username("{login}") .password("{password}") .build(); // Connect to the cluster. try (IgniteClient client = IgniteClient.builder() .addresses("{connectionUri}:10800") .authenticator(auth) .ssl(sslConfiguration) .build()) { // Query the table using SQL. client.sql().execute(null, "CREATE TABLE IF NOT EXISTS Person (id VARCHAR PRIMARY KEY, name VARCHAR)"); } }
For more information on Java client, see this article.
C++ client
-
Add the GridGain C++ client library to your project. Include the following headers:
-
ignite/client/ignite_client.h -
ignite/client/basic_authenticator.h
-
-
Create a client configuration and replace the
{login}and{password}placeholders with your cluster credentials. Replace the{connectionUri}with the connection URI from the Connections widget.#include <chrono> #include <iostream> #include "ignite/client/ignite_client.h" #include <ignite/client/basic_authenticator.h> using namespace ignite; using namespace std::chrono_literals; void main() { try { auto auth = std::make_shared<basic_authenticator>("{login}", "{password}"); ignite_client_configuration cfg{"{connectionUri}:10800"}; cfg.set_authenticator(std::move(auth)); cfg.set_ssl_mode(ssl_mode::REQUIRE); // Connect to the cluster. auto client = ignite_client::start(std::move(cfg), 5s); auto sql = client.get_sql(); // Query the table using SQL. sql.execute(nullptr, {"CREATE TABLE Person(ID INT PRIMARY KEY, VAL VARCHAR)"}, {}); } catch (std::exception &e) { std::cout << e.what() << std::endl; return 1; } }
For more information on C++ client, see this article.
.NET client
Supported runtimes: .NET 8.0+
-
Install .NET SDK
-
Copy Program and dependency example files to an empty folder.
-
Replace
{gg.version}with the version of the managed cluster. -
Replace the
{login}and{password}placeholders with your cluster API credentials. -
Execute
dotnet runin that folder.
For more information on .NET client, see this article.
.NET LINQ client
Supported runtimes: .NET 8.0+
-
Install .NET SDK
-
Copy Program and dependency example files to an empty folder.
-
Replace
{gg.version}with the version of the managed cluster. -
Replace the
{login}and{password}placeholders with your cluster API credentials. -
Execute
dotnet runin that folder.
For more information on .NET LINQ client, see this article.
Python client
-
Install the pygridgain package:
pip install pygridgain>=9 -
Create a client configuration and replace the
{login}and{password}placeholders with your cluster credentials. Replace the{connectionUri}with the connection URI from the Connections widget.import asyncio import ssl from pygridgain import AsyncClient, EndPoint, BasicAuthenticator, SSLConfig async def main(): # Client configuration. # Replace the {login} and {password} with your cluster credentials. address = EndPoint("{connectionUri}", 10800) auth = BasicAuthenticator(username="{login}", password="{password}") ssl_cfg = SSLConfig(cert_reqs=ssl.CERT_NONE) # Connect to the cluster. async with AsyncClient( address, authenticator=auth, ssl_config=ssl_cfg, ) as client: # Get or create a BinaryMap (cache-like key/value structure). my_map = await client.structures().get_or_create_binary_map("MyTestMap") # Put/get example. await my_map.put(b"1", b"foo") result = await my_map.get(b"1") # Print the decoded result. print(result.decode("utf-8")) # Optional checks. exists = await my_map.contains(b"1") print("Key exists:", exists)
For more information on Python client, see this article.
Python DB API
-
Install the pygridgain_dbapi package:
pip install pygridgain_dbapi -
Create a connection and replace the
{login}and{password}placeholders with your cluster credentials. Replace the{connectionUri}with the connection URI from the Connections widget.import pygridgain_dbapi HOST = "{connectionUri}" PORT = 10800 IDENTITY = "{login}" SECRET = "{password}" # SQL object name. TABLE = "Person" def connect(): return pygridgain_dbapi.connect( address=f"{HOST}:{PORT}", identity=IDENTITY, secret=SECRET, use_ssl=True, ) def main(): # Connect to the cluster. conn = connect() try: cur = conn.cursor() # Create table. cur.execute( f"CREATE TABLE IF NOT EXISTS {TABLE} (" f" id INTEGER PRIMARY KEY, " f" name VARCHAR" f")" ) # Insert values into the table. cur.execute( f"INSERT INTO {TABLE}(id, name) VALUES " f"(1, 'Ed'), (2, 'Ann'), (3, 'Emma')" ) # Count. cur.execute(f"SELECT COUNT(*) FROM {TABLE}") count = cur.fetchone()[0] print(f"COUNT(*) FROM {TABLE} = {count}") # Commit is recommended for DDL/DML in DB-API usage. conn.commit() finally: # Close the connection. conn.close()
For more information on Python DB API, see this article.
© 2026 GridGain Systems, Inc. All Rights Reserved. Privacy Policy | Legal Notices. GridGain® is a registered trademark of GridGain Systems, Inc.
Apache, Apache Ignite, the Apache feather and the Apache Ignite logo are either registered trademarks or trademarks of The Apache Software Foundation.