title | summary | aliases | ||
---|---|---|---|---|
SET [NAMES|CHARACTER SET] | TiDB SQL Statement Reference |
An overview of the usage of SET [NAMES|CHARACTER SET] for the TiDB database. |
|
The statements SET NAMES
, SET CHARACTER SET
and SET CHARSET
modify the variables character_set_client
, character_set_results
and character_set_connection
for the current connection.
SetNamesStmt:
VariableAssignmentList:
VariableAssignment:
CharsetName:
StringName:
CharsetKw:
CharsetNameOrDefault:
mysql> SHOW VARIABLES LIKE 'character_set%';
+--------------------------+--------------------------------------------------------+
| Variable_name | Value |
+--------------------------+--------------------------------------------------------+
| character_sets_dir | /usr/local/mysql-5.6.25-osx10.8-x86_64/share/charsets/ |
| character_set_connection | utf8mb4 |
| character_set_system | utf8 |
| character_set_results | utf8mb4 |
| character_set_client | utf8mb4 |
| character_set_database | utf8mb4 |
| character_set_filesystem | binary |
| character_set_server | utf8mb4 |
+--------------------------+--------------------------------------------------------+
8 rows in set (0.01 sec)
mysql> SET NAMES utf8;
Query OK, 0 rows affected (0.00 sec)
mysql> SHOW VARIABLES LIKE 'character_set%';
+--------------------------+--------------------------------------------------------+
| Variable_name | Value |
+--------------------------+--------------------------------------------------------+
| character_sets_dir | /usr/local/mysql-5.6.25-osx10.8-x86_64/share/charsets/ |
| character_set_connection | utf8 |
| character_set_system | utf8 |
| character_set_results | utf8 |
| character_set_client | utf8 |
| character_set_server | utf8mb4 |
| character_set_database | utf8mb4 |
| character_set_filesystem | binary |
+--------------------------+--------------------------------------------------------+
8 rows in set (0.00 sec)
mysql> SET CHARACTER SET utf8mb4;
Query OK, 0 rows affected (0.00 sec)
mysql> SHOW VARIABLES LIKE 'character_set%';
+--------------------------+--------------------------------------------------------+
| Variable_name | Value |
+--------------------------+--------------------------------------------------------+
| character_set_connection | utf8mb4 |
| character_set_system | utf8 |
| character_set_results | utf8mb4 |
| character_set_client | utf8mb4 |
| character_sets_dir | /usr/local/mysql-5.6.25-osx10.8-x86_64/share/charsets/ |
| character_set_database | utf8mb4 |
| character_set_filesystem | binary |
| character_set_server | utf8mb4 |
+--------------------------+--------------------------------------------------------+
8 rows in set (0.00 sec)
This statement is understood to be fully compatible with MySQL. Any compatibility differences should be reported via an issue on GitHub.