ClickHouse/docs/en/interfaces/mysql.md

54 lines
1.8 KiB
Markdown
Raw Normal View History

2020-04-03 13:23:32 +00:00
---
toc_priority: 20
toc_title: MySQL Interface
---
# MySQL Interface {#mysql-interface}
2020-10-13 17:23:29 +00:00
ClickHouse supports MySQL wire protocol. It can be enabled by [mysql_port](../operations/server-configuration-parameters/settings.md#server_configuration_parameters-mysql_port) setting in configuration file:
2020-03-20 10:10:48 +00:00
``` xml
<mysql_port>9004</mysql_port>
```
2020-03-19 08:31:06 +00:00
Example of connecting using command-line tool `mysql`:
2020-03-20 10:10:48 +00:00
``` bash
$ mysql --protocol tcp -u default -P 9004
```
2020-03-19 08:31:06 +00:00
Output if a connection succeeded:
2020-03-20 10:10:48 +00:00
``` text
Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 4
Server version: 20.2.1.1-ClickHouse
Copyright (c) 2000, 2019, 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.
2020-03-20 10:10:48 +00:00
mysql>
```
For compatibility with all MySQL clients, it is recommended to specify user password with [double SHA1](../operations/settings/settings-users.md#password_double_sha1_hex) in configuration file.
If user password is specified using [SHA256](../operations/settings/settings-users.md#password_sha256_hex), some clients wont be able to authenticate (mysqljs and old versions of command-line tool mysql).
Restrictions:
2020-01-21 22:42:52 +00:00
- prepared queries are not supported
2020-01-21 22:42:52 +00:00
- some data types are sent as strings
2020-03-19 08:31:06 +00:00
2021-08-29 18:24:52 +00:00
To cancel a long query use `KILL QUERY connection_id` statement (it is replaced with `KILL QUERY WHERE query_id = connection_id` while proceeding). For example:
2021-08-29 18:17:41 +00:00
``` bash
$ mysql --protocol tcp -h mysql_server -P 9004 default -u default --password=123 -e "KILL QUERY 123456;"
```
2020-03-19 08:31:06 +00:00
[Original article](https://clickhouse.tech/docs/en/interfaces/mysql/) <!--hide-->