ProPeler
Home
Console
Upload
information
Create File
Create Folder
About
Tools
:
/
usr
/
share
/
mysqlsh
/
Filename :
upgrade_checker.msg
back
Copy
# Copyright (c) 2018, 2024, Oracle and/or its affiliates. # # This program is free software; you can redistribute it and/or modify # it under the terms of the GNU General Public License, version 2.0, # as published by the Free Software Foundation. # # This program is designed to work with certain software (including # but not limited to OpenSSL) that is licensed under separate terms, # as designated in a particular file or component or in included license # documentation. The authors of MySQL hereby grant you an additional # permission to link the program and your derivative works with the # separately licensed software that they have either included with # the program or referenced in the documentation. # # This program is distributed in the hope that it will be useful, but # WITHOUT ANY WARRANTY; without even the implied warranty of # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See # the GNU General Public License, version 2.0, for more details. # # You should have received a copy of the GNU General Public License # along with this program; if not, write to the Free Software Foundation, Inc., # 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA # This file defines translations one by one (comments can be added for readability starting with # '#' character). Format for single translation is as follows: # # ------------------------------------------------------------------- # * Translation id: one or more lines (if id contains new line characters) # # # Zero or more lines: text - originally given in source code with formatting suggestions # # One or more lines - translation. Line breaks will be ignored and can be put in translations for # readability - if line break is intended deliberately, line must end with '\n' character sequence. # # Empty line to terminate single translation # ------------------------------------------------------------------- * oldTemporalCheck.title # Usage of old temporal type * oldTemporalCheck.description # Error: Following table columns use a deprecated and no longer supported temporal disk storage # format. They must be converted to the new format before upgrading. It can by done by rebuilding # the table using 'ALTER TABLE <table_name> FORCE' command * oldTemporalCheck.docLink https://mysqlserverteam.com/mysql-8-0-removing-support-for-old-temporal-datatypes/ * routinesSyntaxCheck.title # MySQL 8.0 syntax check for routine-like objects * routinesSyntaxCheck.description # The following objects did not pass a syntax check with the latest MySQL 8.0 grammar. A common # reason is that they reference names that conflict with new reserved keywords. You must update # these routine definitions and `quote` any such references before upgrading. * routinesSyntaxCheck.docLink https://dev.mysql.com/doc/refman/en/keywords.html * reservedKeywordsCheck.title # Usage of db objects with names conflicting with new reserved keywords * reservedKeywordsCheck.description # Warning: The following objects have names that conflict with new reserved keywords. Ensure # queries sent by your applications use `quotes` when referring to them or they will result in # errors. * reservedKeywordsCheck.docLink https://dev.mysql.com/doc/refman/en/keywords.html * utf8mb3Check.title # Usage of utf8mb3 charset * utf8mb3Check.description # Warning: The following objects use the utf8mb3 character set. It is recommended to convert them # to use utf8mb4 instead, for improved Unicode support. * utf8mb3Check.docLink https://dev.mysql.com/doc/refman/8.0/en/charset-unicode-utf8mb3.html * mysqlSchemaCheck.title # Table names in the mysql schema conflicting with new tables in 8.0 * mysqlSchemaCheck.description # Error: The following tables in mysql schema have names that will conflict with the ones # introduced in 8.0 version. They must be renamed or removed before upgrading (use RENAME TABLE # command). This may also entail changes to applications that use the affected tables. * mysqlSchemaCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-strategies.html#upgrade-prerequisites * nonNativePartitioningCheck.title # Partitioned tables using engines with non native partitioning * nonNativePartitioningCheck.description # Error: In MySQL 8.0 storage engine is responsible for providing its own partitioning handler, and # the MySQL server no longer provides generic partitioning support. InnoDB and NDB are the only # storage engines that provide a native partitioning handler that is supported in MySQL 8.0. A # partitioned table using any other storage engine must be altered—either to convert it to InnoDB # or NDB, or to remove its partitioning—before upgrading the server, else it cannot be used # afterwards. * nonNativePartitioningCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-configuration-changes * foreignKeyLengthCheck.title # Foreign key constraint names longer than 64 characters * foreignKeyLengthCheck.description # Error: The following tables must be altered to have constraint names shorter than 64 characters # (use ALTER TABLE). * foreignKeyLengthCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-strategies.html#upgrade-prerequisites * maxdbFlagCheck.title # Usage of obsolete MAXDB sql_mode flag * maxdbFlagCheck.description # Warning: The following DB objects have the obsolete MAXDB option persisted for sql_mode, which # will be cleared during upgrade to 8.0. It can potentially change the datatype DATETIME into # TIMESTAMP if it is used inside object's definition, and this in turn can change the behavior in # case of dates earlier than 1970 or later than 2037. If this is a concern, please redefine these # objects so that they do not rely on the MAXDB flag before running the upgrade to 8.0. * maxdbFlagCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/mysql-nutshell.html#mysql-nutshell-removals * sqlModeFlagCheck.title # Usage of obsolete sql_mode flags * sqlModeFlagCheck.description # Notice: The following DB objects have obsolete options persisted for sql_mode, which will be # cleared during upgrade to 8.0. * sqlModeFlagCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/mysql-nutshell.html#mysql-nutshell-removals * enumSetElementLenghtCheck.title # ENUM/SET column definitions containing elements longer than 255 characters * enumSetElementLenghtCheck.description # Error: The following columns are defined as either ENUM or SET and contain at least one element # longer that 255 characters. They need to be altered so that all elements fit into the 255 # characters limit. * enumSetElementLenghtCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/string-type-overview.html * partitionedTablesInSharedTablespaceCheck.title # Usage of partitioned tables in shared tablespaces * partitionedTablesInSharedTablespaceCheck.description # Error: The following tables have partitions in shared tablespaces. Before upgrading to 8.0 they # need to be moved to file-per-table tablespace. You can do this by running query like 'ALTER TABLE # table_name REORGANIZE PARTITION X INTO (PARTITION X VALUES LESS THAN (30) # TABLESPACE=innodb_file_per_table);' * partitionedTablesInSharedTablespaceCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/mysql-nutshell.html#mysql-nutshell-removals * circularDirectoryCheck.title # Circular directory references in tablespace data file paths * circularDirectoryCheck.description # Error: Following tablespaces contain circular directory references (e.g. the reference '/../') in # data file paths which as of MySQL 8.0.17 are not permitted by the CREATE TABLESPACE ... ADD # DATAFILE clause. An exception to the restriction exists on Linux, where a circular directory # reference is permitted if the preceding directory is a symbolic link. To avoid upgrade issues, # remove any circular directory references from tablespace data file paths before upgrading. * circularDirectoryCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-innodb-changes * removedFunctionsCheck.title # Usage of removed functions * removedFunctionsCheck.description # Error: Following DB objects make use of functions that have been removed in version 8.0. Please # make sure to update them to use supported alternatives before upgrade. * removedFunctionsCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/mysql-nutshell.html#mysql-nutshell-removals * groupByAscCheck.title # Usage of removed GROUP BY ASC/DESC syntax * groupByAscCheck.description # Error: The following DB objects use removed GROUP BY ASC/DESC syntax. They need to be altered so # that ASC/DESC keyword is removed from GROUP BY clause and placed in appropriate ORDER BY clause. * groupByAscCheck.docLink https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-13.html#mysqld-8-0-13-sql-syntax * removedSysLogVars.title # Removed system variables for error logging to the system log configuration * removedSysLogVars.description # Error: System variables related to logging using OS facilities (the Event Log on Windows, and # syslog on Unix and Unix-like systems) have been removed. Where appropriate, the removed system # variables were replaced with new system variables managed by the log_sink_syseventlog error log # component. Installations that used the old system variable names must update their configuration # to use the new variable names. * removedSysLogVars.docLink https://dev.mysql.com/doc/relnotes/mysql/8.0/en/news-8-0-13.html#mysqld-8-0-13-logging * removedSysVars.title # Removed system variables * removedSysVars.description # Error: Following system variables that were detected as being used will be removed. Please update # your system to not rely on them before the upgrade. * removedSysVars.docLink https://dev.mysql.com/doc/refman/8.0/en/added-deprecated-removed.html#optvars-removed * sysVarsNewDefaults.title # System variables with new default values * sysVarsNewDefaults.description # Warning: Following system variables that are not defined in your configuration file will have new # default values. Please review if you rely on their current values and if so define them before # performing upgrade. * sysVarsNewDefaults.docLink https://mysqlserverteam.com/new-defaults-in-mysql-8-0/ * zeroDatesCheck.title # Zero Date, Datetime, and Timestamp values * zeroDatesCheck.description # Warning: By default zero date/datetime/timestamp values are no longer allowed in MySQL, as of # 5.7.8 NO_ZERO_IN_DATE and NO_ZERO_DATE are included in SQL_MODE by default. These modes should be # used with strict mode as they will be merged with strict mode in a future release. If you do not # include these modes in your SQL_MODE setting, you are able to insert date/datetime/timestamp # values that contain zeros. It is strongly advised to replace zero values with valid ones, as they # may not work correctly in the future. * zeroDatesCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/datetime.html\n https://dev.mysql.com/doc/refman/8.0/en/sql-mode.html#sqlmode_no_zero_date\n https://dev.mysql.com/doc/refman/8.0/en/sql-mode.html#sqlmode_no_zero_in_date * schemaInconsistencyCheck.title # Schema inconsistencies resulting from file removal or corruption * schemaInconsistencyCheck.description # Error: Following tables show signs that either table datadir directory or frm file was # removed/corrupted. Please check server logs, examine datadir to detect the issue and fix it # before upgrade * schemaInconsistencyCheck.docLink * ftsTablenameCheck.title # Table names containing 'FTS' * ftsTablenameCheck.description # Error: Upgrading from 5.7 to 8.0 does not support tables with name containing 'FTS' character # string. The workaround is to rename the table for the upgrade - e.g. it is enough to change any # letter of the 'FTS' part to a lower case. It can be renamed back again after the upgrade. * ftsTablenameCheck.docLink * engineMixupCheck.title # Tables recognized by InnoDB that belong to a different engine * engineMixupCheck.description # Error Error: Following tables are recognized by InnoDB engine while the SQL layer believes they belong to a different engine. Such situation may happen when one removes InnoDB table files manually from the disk and creates e.g. a MyISAM table with the same name.\n \n A possible way to solve this situation is to e.g. in case of MyISAM table:\n \n 1. Rename the MyISAM table to a temporary name (RENAME TABLE).\n 2. Create some dummy InnoDB table (its definition does not need to match), then copy (copy, not move) and rename the dummy .frm and .ibd files to the orphan name using OS file commands.\n 3. The orphan table can be then dropped (DROP TABLE), as well as the dummy table.\n 4. Finally the MyISAM table can be renamed back to its original name. * engineMixupCheck.docLink * oldGeometryCheck.title # Spatial data columns created in MySQL 5.6 * oldGeometryCheck.description # Error Error: The following columns are spatial data columns created in MySQL Server version 5.6. MySQL 8.0 servers before 8.0.24 do not support upgrading these tables and will reject them. In order for the upgrade to succeed we encourage you to upgrade directly to MySQL Server version 8.0.24 or newer. Otherwise, you must rebuild these tables using ALTER TABLE FORCE before upgrading. * oldGeometryCheck.docLink * checkTableOutput.title # Issues reported by 'check table x for upgrade' command * checkTableOutput.description * checkTableOutput.docLink * defaultAuthenticationPlugin.title New default authentication plugin considerations * defaultAuthenticationPlugin.description # Warning Warning: The new default authentication plugin 'caching_sha2_password' offers more secure password hashing than previously used 'mysql_native_password' (and consequent improved client connection authentication). However, it also has compatibility implications that may affect existing MySQL installations. If your MySQL installation must serve pre-8.0 clients and you encounter compatibility issues after upgrading, the simplest way to address those issues is to reconfigure the server to revert to the previous default authentication plugin (mysql_native_password). For example, use these lines in the server option file:\n \n [mysqld]\n default_authentication_plugin=mysql_native_password\n \n However, the setting should be viewed as temporary, not as a long term or permanent solution, because it causes new accounts created with the setting in effect to forego the improved authentication security.\n If you are using replication please take time to understand how the authentication plugin changes may impact you. * defaultAuthenticationPlugin.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-compatibility-issues\n https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-replication * defaultAuthenticationPluginMds.title New default authentication plugin considerations * defaultAuthenticationPluginMds.description # Warning Warning: The new default authentication plugin 'caching_sha2_password' offers more secure password hashing than previously used 'mysql_native_password' (and consequent improved client connection authentication). However, it also has compatibility implications that may affect existing MySQL installations. If your MySQL installation must serve pre-8.0 clients, you may encounter compatibility issues after upgrading unless newly created accounts are created to use 'mysql_native_password'. * defaultAuthenticationPluginMds.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-compatibility-issues\n https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-caching-sha2-password-replication * changedFunctionsInGeneratedColumnsCheck.title # Indexes on functions with changed semantics * changedFunctionsInGeneratedColumnsCheck.description # Warning Warning: The following tables have indexes on generated columns that use functions that have had changes in their semantics. Replication problems and index corruption may arise unless the underlying issue is resolved before upgrade. See documentation for more information. * changedFunctionsInGeneratedColumnsCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/upgrading-from-previous-series.html#upgrade-sql-changes * columnsWhichCannotHaveDefaultsCheck.title # Columns which cannot have default values * columnsWhichCannotHaveDefaultsCheck.description # Error Error: The following columns are defined as either BLOB, TEXT, GEOMETRY or JSON and have a default value set. These data types cannot have default values in MySQL versions prior to 8.0.13, while starting with 8.0.13, the default value must be specified as an expression. In order to fix this issue, please use the ALTER TABLE ... ALTER COLUMN ... DROP DEFAULT statement. * columnsWhichCannotHaveDefaultsCheck.docLink https://dev.mysql.com/doc/refman/8.0/en/data-type-defaults.html#data-type-defaults-explicit * mysqlInvalid57NamesCheck.title # Check for invalid table names and schema names used in 5.7 * mysqlInvalid57NamesCheck.description # Error: The following tables and/or schemas have invalid names. In order to fix them use the # mysqlcheck utility as follows:\n # \n # $ mysqlcheck --check-upgrade --all-databases\n # $ mysqlcheck --fix-db-names --fix-table-names --all-databases\n # \n # OR via mysql client, for eg:\n # \n # ALTER DATABASE `#mysql50#lost+found` UPGRADE DATA DIRECTORY NAME; The following tables and/or schemas have invalid names. In order to fix them use the mysqlcheck utility as follows:\n \n $ mysqlcheck --check-upgrade --all-databases\n $ mysqlcheck --fix-db-names --fix-table-names --all-databases\n \n OR via mysql client, for eg:\n \n ALTER DATABASE `#mysql50#lost+found` UPGRADE DATA DIRECTORY NAME; * mysqlInvalid57NamesCheck.docLink https://dev.mysql.com/doc/refman/5.7/en/identifier-mapping.html https://dev.mysql.com/doc/refman/5.7/en/alter-database.html https://dev.mysql.com/doc/refman/8.0/en/mysql-nutshell.html#mysql-nutshell-removals * mysqlOrphanedRoutinesCheck.title # Check for orphaned routines in 5.7 * mysqlOrphanedRoutinesCheck.description # Error: The following routines have been orphaned. Schemas that they are referencing no longer # exists.\n # They have to be cleaned up or the upgrade will fail. * mysqlOrphanedRoutinesCheck.docLink * mysqlDollarSignNameCheck.title # Check for deprecated usage of single dollar signs in object names * mysqlDollarSignNameCheck.description # Warning: The following objects have names with deprecated usage of dollar sign ($) at the # begining of the identifier. To correct this warning, ensure, that names starting with dollar # sign, also end with it, similary to quotes ($example$). * mysqlDollarSignNameCheck.docLink * mysqlIndexTooLargeCheck.title # Check for indexes that are too large to work on higher versions of MySQL Server than 5.7 * mysqlIndexTooLargeCheck.description # Error: The following indexes ware made too large for their format in an older version of MySQL # (older than 5.7.34). Normally those indexes within tables with compact or redundant row formats # shouldn't be larger than 767 bytes. To fix this problem those indexes should be dropped before # upgrading or those tables will be inaccessible. * mysqlIndexTooLargeCheck.docLink * mysqlEmptyDotTableSyntaxCheck.title # Check for deprecated '.<table>' syntax used in routines. * mysqlEmptyDotTableSyntaxCheck.description # Error: The following routines contain identifiers in deprecated identifier syntax (".<table>"), # and should be corrected before upgrade:\n * mysqlEmptyDotTableSyntaxCheck.docLink * mysqlInvalidEngineForeignKeyCheck.title # Check for columns that have foreign keys pointing to tables from a diffrent database engine. * mysqlInvalidEngineForeignKeyCheck.description # Error: The following columns have foreign keys pointing to tables from diffrent database engines # than originating table. This is invalid and probably a mistake done when FOREIGN_KEY_CHECKS was # turned OFF:\n * mysqlInvalidEngineForeignKeyCheck.docLink