SET [NAMES|CHARACTER SET]

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.

Synopsis

SetNamesStmt

SET [NAMES|CHARACTER SET] - 图1

  1. SetNamesStmt ::=
  2.     "SET" ("NAMES" ("DEFAULT" | CharsetName ("COLLATE" ("DEFAULT" | CollationName))?) | ("CHARSET" | ("CHAR" | "CHARACTER") "SET") ("DEFAULT" | CharsetName))

Examples

  1. mysql> SHOW VARIABLES LIKE 'character_set%';
  2. +--------------------------+--------------------------------------------------------+
  3. | Variable_name            | Value                                                  |
  4. +--------------------------+--------------------------------------------------------+
  5. | character_sets_dir       | /usr/local/mysql-5.6.25-osx10.8-x86_64/share/charsets/ |
  6. | character_set_connection | utf8mb4                                                |
  7. | character_set_system     | utf8                                                   |
  8. | character_set_results    | utf8mb4                                                |
  9. | character_set_client     | utf8mb4                                                |
  10. | character_set_database   | utf8mb4                                                |
  11. | character_set_filesystem | binary                                                 |
  12. | character_set_server     | utf8mb4                                                |
  13. +--------------------------+--------------------------------------------------------+
  14. 8 rows in set (0.01 sec)
  16. mysql> SET NAMES utf8;
  17. Query OK, 0 rows affected (0.00 sec)
  19. mysql> SHOW VARIABLES LIKE 'character_set%';
  20. +--------------------------+--------------------------------------------------------+
  21. | Variable_name            | Value                                                  |
  22. +--------------------------+--------------------------------------------------------+
  23. | character_sets_dir       | /usr/local/mysql-5.6.25-osx10.8-x86_64/share/charsets/ |
  24. | character_set_connection | utf8                                                   |
  25. | character_set_system     | utf8                                                   |
  26. | character_set_results    | utf8                                                   |
  27. | character_set_client     | utf8                                                   |
  28. | character_set_server     | utf8mb4                                                |
  29. | character_set_database   | utf8mb4                                                |
  30. | character_set_filesystem | binary                                                 |
  31. +--------------------------+--------------------------------------------------------+
  32. 8 rows in set (0.00 sec)
  34. mysql> SET CHARACTER SET utf8mb4;
  35. Query OK, 0 rows affected (0.00 sec)
  37. mysql> SHOW VARIABLES LIKE 'character_set%';
  38. +--------------------------+--------------------------------------------------------+
  39. | Variable_name            | Value                                                  |
  40. +--------------------------+--------------------------------------------------------+
  41. | character_set_connection | utf8mb4                                                |
  42. | character_set_system     | utf8                                                   |
  43. | character_set_results    | utf8mb4                                                |
  44. | character_set_client     | utf8mb4                                                |
  45. | character_sets_dir       | /usr/local/mysql-5.6.25-osx10.8-x86_64/share/charsets/ |
  46. | character_set_database   | utf8mb4                                                |
  47. | character_set_filesystem | binary                                                 |
  48. | character_set_server     | utf8mb4                                                |
  49. +--------------------------+--------------------------------------------------------+
  50. 8 rows in set (0.00 sec)

MySQL compatibility

The SET [NAMES|CHARACTER SET] statement in TiDB is fully compatible with MySQL. If you find any compatibility differences, report a bug.

See also