MySQL 5.7 is the most current release candidate of the popular open-source database. It offers new scalability features that should have you eager to make the change.
To highlight one of the changes, scalability has been greatly improved. On the high end, MySQL 5.7 scales linearly on 48-core servers. On the low end, MySQL 5.7 also works out of the box on a 512 MB DigitalOcean Droplet (something that was not possible without configuration changes in MySQL 5.6).
The new peak performance for a MySQL server is over 640K queries per second, and the memcached API, which speaks directly to the InnoDB storage engine, is capable of sustaining over 1.1 million requests per second.
Before you rush to run
mysql_upgrade, though, you should make sure you’re prepared. This tutorial can help you do just that.
Note: As of July 1, 2022, DigitalOcean no longer supports the creation of new FreeBSD Droplets through the Control Panel or API. However, you can still spin up FreeBSD Droplets using a custom image. Learn how to import a custom image to DigitalOcean by following our product documentation.
One major change in MySQL 5.7 is that data integrity has been improved to be more in line with what veteran developers and DBAs expect. Previously, MySQL would adjust incorrect values to the closest possible correct value, but under the new defaults it will instead return an error.
Here are five examples of queries that will require modification to work in MySQL 5.7 out of the box. Does your application use any of these behaviors?
Create a table with an unsigned column:
CREATE TABLE test ( id int unsigned );
Insert a negative value.
INSERT INTO test VALUES (-1); Query OK, 1 row affected, 1 warning (0.01 sec)
INSERT INTO test VALUES (-1); ERROR 1264 (22003): Out of range value for column 'a' at row 1
Create a test table:
CREATE TABLE test2 ( id int unsigned );
Attempt to divide by zero.
INSERT INTO test2 VALUES (0/0); Query OK, 1 row affected (0.01 sec)
INSERT INTO test2 VALUES (0/0); ERROR 1365 (22012): Division by 0
Create a table with a 10-character column:
CREATE TABLE test3 ( a varchar(10) );
Try to insert a longer string.
INSERT INTO test3 VALUES ('abcdefghijklmnopqrstuvwxyz'); Query OK, 1 row affected, 1 warning (0.00 sec)
INSERT INTO test3 VALUES ('abcdefghijklmnopqrstuvwxyz'); ERROR 1406 (22001): Data too long for column 'a' at row 1
Create a table with a datetime column:
CREATE TABLE test3 ( a datetime );
INSERT INTO test3 VALUES ('0000-00-00 00:00:00'); Query OK, 1 row affected, 1 warning (0.00 sec)
INSERT INTO test3 VALUES ('0000-00-00 00:00:00'); ERROR 1292 (22007): Incorrect datetime value: '0000-00-00 00:00:00' for column 'a' at row 1
This happens when the description is not part of the
GROUP BY, and there is no aggregate function (such as
MAX) applied to it.
SELECT id, invoice_id, description FROM invoice_line_items GROUP BY invoice_id; +----+------------+-------------+ | id | invoice_id | description | +----+------------+-------------+ | 1 | 1 | New socks | | 3 | 2 | Shoes | | 5 | 3 | Tie | +----+------------+-------------+ 3 rows in set (0.00 sec)
SELECT id, invoice_id, description FROM invoice_line_items GROUP BY invoice_id; ERROR 1055 (42000): Expression #3 of SELECT list is not in GROUP BY clause and contains nonaggregated column 'invoice_line_items.description' which is not functionally dependent on columns in GROUP BY clause; this is incompatible with sql_mode=only_full_group_by
In MySQL terms, each of the behaviors shown in the previous section is influenced by what is known as an
The feature debuted in MySQL 4.1 (2004), but has not been compiled in by default. MySQL 5.7 features the following modes turned on by default:
Click on any of these mode names to visit the MySQL manual, to find out more information.
If you are using a recent version of Wordpress, Drupal, or Magento the good news is that you do not need to do anything. These applications are already aware of MySQL’s
sql_mode feature and upon connecting to MySQL will set the options that they are compatible with.
If you are currently building a new application, then it may be a good idea to change the configuration of your existing MySQL 5.6 server to behave with the
sql_mode settings that are shipped in MySQL 5.7.
If you have an existing application, you may want to work through your updates more gradually. These suggestions may help you to transition:
sql_modewhen they connect to MySQL. On an individual statement basis, MySQL also supports the
IGNOREmodifier to downgrade errors. For example:
INSERT IGNORE INTO my_table . . .
sql_modeon a per user-basis. A good use case for this would be to allow internal users to beta test everything to allow for a more gradual transition.
First, see if any of your current queries are producing warnings or errors. This is useful because the behavior for several queries has changed from a warning in 5.6 to an error in 5.7, so you can catch the warnings now before upgrading.
performance_schema is a diagnostic feature which is enabled by default on MySQL 5.6 and above. Using the
performance_schema, it’s possible to write a query to return all the statements the server has encountered that have produced errors or warnings.
MySQL 5.6+ query to report statements that produce errors or warnings:
SELECT `DIGEST_TEXT` AS `query`, `SCHEMA_NAME` AS `db`, `COUNT_STAR` AS `exec_count`, `SUM_ERRORS` AS `errors`, (ifnull((`SUM_ERRORS` / nullif(`COUNT_STAR`,0)),0) * 100) AS `error_pct`, `SUM_WARNINGS` AS `warnings`, (ifnull((`SUM_WARNINGS` / nullif(`COUNT_STAR`,0)),0) * 100) AS `warning_pct`, `FIRST_SEEN` AS `first_seen`, `LAST_SEEN` AS `last_seen`, `DIGEST` AS `digest` FROM performance_schema.events_statements_summary_by_digest WHERE ((`SUM_ERRORS` > 0) OR (`SUM_WARNINGS` > 0)) ORDER BY `SUM_ERRORS` DESC, `SUM_WARNINGS` DESC;
MySQL 5.6+ query to report statements that produce errors:
SELECT `DIGEST_TEXT` AS `query`, `SCHEMA_NAME` AS `db`, `COUNT_STAR` AS `exec_count`, `SUM_ERRORS` AS `errors`, (ifnull((`SUM_ERRORS` / nullif(`COUNT_STAR`,0)),0) * 100) AS `error_pct`, `SUM_WARNINGS` AS `warnings`, (ifnull((`SUM_WARNINGS` / nullif(`COUNT_STAR`,0)),0) * 100) AS `warning_pct`, `FIRST_SEEN` AS `first_seen`, `LAST_SEEN` AS `last_seen`, `DIGEST` AS `digest` FROM performance_schema.events_statements_summary_by_digest WHERE `SUM_ERRORS` > 0 ORDER BY `SUM_ERRORS` DESC, `SUM_WARNINGS` DESC;
You can also do a test run with MySQL 5.6 to make it behave like 5.7.
The author, Morgan Tocker from the MySQL team, has a GitHub project available with a sample configuration file that will allow you to do this. By using the upcoming defaults in MySQL 5.6 you will be able to eliminate the chance that your application will depend on the less-strict behaviour.
The file is rather short, so we’re also including it here:
# This makes a MySQL 5.6 server behave similar to the new defaults # in MySQL 5.7 [mysqld] # MySQL 5.7 enables more SQL modes by default, but also # merges ERROR_FOR_DIVISION_BY_ZERO, NO_ZERO_DATE, NO_ZERO_IN_DATE # into the definition of STRICT_TRANS_TABLES. # Context: http://dev.mysql.com/worklog/task/?id=7467 sql-mode="ONLY_FULL_GROUP_BY,STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION,ERROR_FOR_DIVISION_BY_ZERO,NO_ZERO_DATE,NO_ZERO_IN_DATE" # The optimizer changes the default from 10 dives to 200 dives by default # Context: http://mysqlserverteam.com/you-asked-for-it-new-default-for-eq_range_index_dive_limit/ eq_range_index_dive_limit=200 # MySQL 5.7 contains a new internal server logging API. # The setting log_warnings is deprecated in 5.7.2 in favour of log_error_verbosity. # *But* the default fo log_warnings also changes to 2 as well: log_warnings=2 # MySQL 5.7.7 changes a number of replication defaults # Binary logging is still disabled, but will default to ROW when enabled. binlog_format=ROW sync_binlog=1 slave_net_timeout=60 # InnoDB defaults to the new Dynamic Row format with Barracuda file format. # large_prefix is also enabled, which allows for longer index values. innodb_strict_mode=1 innodb_file_format=Barracuda innodb_large_prefix=1 innodb_purge_threads=4 # coming in 5.7.8 innodb_checksum_algorithm=crc32 # In MySQL 5.7 only 20% of the pool will be dumped, # But 5.6 does not support this option innodb_buffer_pool_dump_at_shutdown=1 innodb_buffer_pool_load_at_startup=1 # These two options had different names in previous versions # (binlogging_impossible_mode,simplified_binlog_gtid_recovery) # This config file targets 5.6.23+, but includes the 'loose' modifier to not fail # prior versions. loose-binlog_error_action=ABORT_SERVER loose-binlog_gtid_recovery_simplified=1 # 5.7 enable additional P_S consumers by default # This one is supported in 5.6 as well. performance-schema-consumer-events_statements_history=ON
Sometimes you want to test or upgrade your server in stages. Rather than changing your server-wide configuration file for MySQL to use new SQL modes, it is also possible to change them on a per session basis. Here is an example:
CREATE TABLE sql_mode_test (a int);
No SQL mode set:
set sql_mode = ''; INSERT INTO sql_mode_test (a) VALUES (0/0); Query OK, 1 row affected (0.01 sec)
Stricter SQL mode set:
set sql_mode = 'STRICT_TRANS_TABLES'; INSERT INTO sql_mode_test (a) VALUES (0/0); ERROR 1365 (22012): Division by 0
At this point, you should be confident that you’re prepared to upgrade to MySQL 5.7. Follow along with MySQL’s official upgrade guide to flip the switch.
MySQL 5.7 takes a big step forward in improving the default configuration and data integrity for modern applications. We hope this article helps you make a smooth transition!
For an overview of all the changes in 5.7 (so far), check out the MySQL Server Team’s blog posts:
Thanks for learning with the DigitalOcean Community. Check out our offerings for compute, storage, networking, and managed databases.