Important

Helios features are now enabled during weekly update windows and are no longer directly tied to SingleStore engine releases. Refer to the release notes to view the latest features available in your Helios cluster.

Connect with MySQL Client

Note

When using a third-party SQL client or development tool, you must first add a database user to log into a SingleStore Helios database.

SingleStore is wire-compliant with MySQL meaning connecting to SingleStore is as easy as connecting to a MySQL database. You may need the -u <user>, -h <host>, and -P <port> flags to ensure you are connecting to SingleStore properly. For example:

Shell

mysql -u admin -h svc-xxxx-ddl.aws-oregon-1.svc.singlestore.com -P 3306 --default-auth=mysql_native_password -p

where,

-u: Specifies the name of the SingleStore database user.
-h: Specifies the IP address or hostname of the SingleStore deployment.

Refer to SingleStore Helios Endpoints to determine the endpoint (host:port) of your deployment.
-P: Specifies the port to connect to. Default: 3306.
--default-auth=mysql_native_password: (Optional) For proper authentication.

You may also use the --prompt flag to change the prompt in the interactive session, simply to help distinguish SingleStore from MySQL:

Shell

mysql -u admin -h svc-[...].svc.singlestore.com -P 3306 --default-auth=mysql_native_password -p --prompt="singlestore> "

The output when you connect should look similar to this:

SQL

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 6
Server version: 5.5.8 MemSQL source distribution (compatible; MySQL Enterprise & MySQL Commercial)
Copyright (c) 2000, 2015, Oracle and/or its affiliates. All rights reserved.
Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.
Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.
singlestore>

These commands show more information about the connection and the server:

Note that SHOW STATUS LIKE '%License%'; provides additional license information.

SQL

status

--------------
mysql  Ver 8.0.23 for osx10.15 on x86_64 (Homebrew)

Connection id:		15507
Current database:
Current user:		admin@
SSL:			Cipher in use is AES256-SHA
Current pager:		stdout
Using outfile:		''
Using delimiter:	;
Server version:		5.5.58 MemSQL source distribution (compatible; MySQL Enterprise & MySQL Commercial)
Protocol version:	10
Connection:		svc-9be5e8a1-8a5f-4aa7-b75d-a395570828f2-ddl.aws-oregon-1.svc.singlestore.com via TCP/IP
Server characterset:	utf8
Db     characterset:	utf8
Client characterset:	utf8
Conn.  characterset:	utf8
TCP port:		3306
Binary data as:		Hexadecimal
--------------

SQL

SHOW DATABASES;

+--------------------+
| Database           |
+--------------------+
| cluster          |
| information_schema |
| memsql             |
| test               |
+--------------------+
4 rows in set (0.03 sec)

Important

The @@version and @@version_comment global variables are for compatibility with MySQL clients, which expect certain minimum version numbers and strings to be present. To check the real version of SingleStore Helios you are running, use the @@memsql_version variables instead. To check the license you are running, see the license_key and license_type status codes.

Connect with MySQL Client

In this section

Was this article helpful?

Was this article helpful?