1.MySQL 5.5 Reference Manual Including MySQL Cluster NDB 7.2 Reference Guide

2. MySQL 5.5 Reference Manual: Including MySQL Cluster NDB 7.2 Reference Guide Abstract This is the MySQL Reference Manual. It documents MySQL 5.5 through 5.5.38, as well as MySQL Cluster releases based on version 7.2 of NDBCLUSTER through 5.5.37-ndb-7.2.17. MySQL 5.5 features. This manual describes features that are not included in every edition of MySQL 5.5; such features may not be included in the edition of MySQL 5.5 licensed to you. If you have any questions about the features included in your edition of MySQL 5.5, refer to your MySQL 5.5 license agreement or contact your Oracle sales representative. For release notes detailing the changes in each release, see the MySQL 5.5 Release Notes. For legal information, see the Legal Notices. Document generated on: 2014-04-11 (revision: 38404) General Administrators MySQL Enterprise Developers & Functionality Connectors & APIs HA/Scalability Tutorial Installation & Upgrades MySQL Enterprise Edition MySQL Workbench Connectors and APIs HA/Scalability Guide Server Administration Installation Using Unbreakable Linux Network (ULN) MySQL Enterprise Monitor Globalization Connector/J MySQL Cluster NDB 7.2 (GA) SQL Syntax MySQL Installer MySQL Enterprise Backup Optimization Connector/ODBC MySQL and DRBD Storage Engines Security MySQL Enterprise Security Functions and Operators Connector/Net memcached Server Option / Variable Reference Startup / Shutdown MySQL Enterprise Audit Views and Stored Programs Connector/ Python memcached with MySQL Cluster Release Notes Backup and Recovery Overview MySQL Thread Pool Partitioning PHP MySQL and Virtualization MySQL Version Reference MySQL Utilities Precision Math C API MySQL Proxy FAQs Linux/Unix Platform Guide Information Schema Connector/C Replication Windows Platform Guide Performance Schema Connector/C++ Semisynchronous Replication Mac OS X Platform Guide Spatial Extensions MySQL for Excel Solaris Platform Guide Restrictions and Limitations MySQL Cluster API Developer Building from Source 3. iii Table of Contents Preface and Legal Notices .......................................................................................................... xxi 1 General Information ................................................................................................................... 1 1.1 About This Manual .......................................................................................................... 2 1.2 Typographical and Syntax Conventions ............................................................................ 3 1.3 Overview of the MySQL Database Management System ................................................... 4 1.3.1 What is MySQL? .................................................................................................. 4 1.3.2 The Main Features of MySQL ............................................................................... 6 1.3.3 History of MySQL ................................................................................................. 8 1.4 What Is New in MySQL 5.5 ............................................................................................. 9 1.4.1 Scalability Improvements .................................................................................... 13 1.4.2 InnoDB I/O Subsystem Changes ........................................................................ 14 1.4.3 Diagnostic and Monitoring Capabilities ................................................................ 14 1.4.4 Enhanced Solaris Support .................................................................................. 15 1.5 MySQL Development History ......................................................................................... 15 1.6 MySQL Information Sources .......................................................................................... 16 1.6.1 MySQL Mailing Lists ........................................................................................... 16 1.6.2 MySQL Community Support at the MySQL Forums .............................................. 19 1.6.3 MySQL Community Support on Internet Relay Chat (IRC) .................................... 19 1.6.4 MySQL Enterprise .............................................................................................. 19 1.7 How to Report Bugs or Problems .................................................................................. 19 1.8 MySQL Standards Compliance ...................................................................................... 24 1.8.1 MySQL Extensions to Standard SQL ................................................................... 25 1.8.2 MySQL Differences from Standard SQL .............................................................. 28 1.8.3 How MySQL Deals with Constraints .................................................................... 32 1.9 Credits .......................................................................................................................... 36 1.9.1 Contributors to MySQL ....................................................................................... 36 1.9.2 Documenters and translators .............................................................................. 40 1.9.3 Packages that support MySQL ............................................................................ 41 1.9.4 Tools that were used to create MySQL ................................................................ 42 1.9.5 Supporters of MySQL ......................................................................................... 42 2 Installing and Upgrading MySQL .............................................................................................. 45 2.1 General Installation Guidance ........................................................................................ 47 2.1.1 Operating Systems Supported by MySQL Community Server ................................ 47 2.1.2 Choosing Which MySQL Distribution to Install ...................................................... 47 2.1.3 How to Get MySQL ............................................................................................ 51 2.1.4 Verifying Package Integrity Using MD5 Checksums or GnuPG ............................... 51 2.1.5 Installation Layouts ............................................................................................. 60 2.1.6 Compiler-Specific Build Characteristics ................................................................ 60 2.2 Installing MySQL on Unix/Linux Using Generic Binaries .................................................. 60 2.3 Installing MySQL on Microsoft Windows ......................................................................... 63 2.3.1 MySQL Installation Layout on Microsoft Windows ................................................. 64 2.3.2 Choosing An Installation Package ....................................................................... 65 2.3.3 Installing MySQL on Microsoft Windows Using MySQL Installer ............................ 66 2.3.4 MySQL Notifier for Microsoft Windows ................................................................. 83 2.3.5 Installing MySQL on Microsoft Windows Using an MSI Package ............................ 94 2.3.6 MySQL Server Instance Configuration Wizard .................................................... 100 2.3.7 Installing MySQL on Microsoft Windows Using a noinstall Zip Archive ............ 114 2.3.8 Troubleshooting a Microsoft Windows MySQL Server Installation ........................ 121 2.3.9 Upgrading MySQL on Windows ......................................................................... 123 2.3.10 Windows Postinstallation Procedures ............................................................... 124 2.4 Installing MySQL on Mac OS X ................................................................................... 125 2.4.1 General Notes on Installing MySQL on Mac OS X .............................................. 126 2.4.2 Installing MySQL on Mac OS X Using Native Packages ...................................... 127 2.4.3 Installing the MySQL Startup Item ..................................................................... 130 2.4.4 Installing and Using the MySQL Preference Pane .............................................. 133 4. MySQL 5.5 Reference Manual iv 2.4.5 Using the Bundled MySQL on Mac OS X Server ................................................ 135 2.5 Installing MySQL on Linux ........................................................................................... 135 2.5.1 Installing MySQL on Linux Using RPM Packages ............................................... 136 2.5.2 Installing MySQL on Linux Using Debian Packages ............................................ 141 2.5.3 Installing MySQL on Linux Using Native Package Managers ............................... 141 2.6 Installing MySQL Using Unbreakable Linux Network (ULN) ............................................ 145 2.7 Installing MySQL on Solaris and OpenSolaris ............................................................... 145 2.7.1 Installing MySQL on Solaris Using a Solaris PKG ............................................... 146 2.7.2 Installing MySQL on OpenSolaris Using IPS ...................................................... 147 2.8 Installing MySQL on FreeBSD ..................................................................................... 148 2.9 Installing MySQL from Source ...................................................................................... 149 2.9.1 MySQL Layout for Source Installation ................................................................ 151 2.9.2 Installing MySQL Using a Standard Source Distribution ...................................... 151 2.9.3 Installing MySQL Using a Development Source Tree .......................................... 155 2.9.4 MySQL Source-Configuration Options ................................................................ 156 2.9.5 Dealing with Problems Compiling MySQL .......................................................... 167 2.9.6 MySQL Configuration and Third-Party Tools ...................................................... 168 2.10 Postinstallation Setup and Testing .............................................................................. 169 2.10.1 Postinstallation Procedures for Unix-like Systems ............................................. 169 2.10.2 Securing the Initial MySQL Accounts ............................................................... 180 2.11 Upgrading or Downgrading MySQL ............................................................................ 184 2.11.1 Upgrading MySQL .......................................................................................... 184 2.11.2 Downgrading MySQL ...................................................................................... 196 2.11.3 Checking Whether Tables or Indexes Must Be Rebuilt ...................................... 198 2.11.4 Rebuilding or Repairing Tables or Indexes ....................................................... 200 2.11.5 Copying MySQL Databases to Another Machine .............................................. 202 2.12 Environment Variables ............................................................................................... 203 2.13 Perl Installation Notes ................................................................................................ 204 2.13.1 Installing Perl on Unix ..................................................................................... 204 2.13.2 Installing ActiveState Perl on Windows ............................................................ 205 2.13.3 Problems Using the Perl DBI/DBD Interface ...................................................... 206 3 Tutorial .................................................................................................................................. 207 3.1 Connecting to and Disconnecting from the Server ......................................................... 207 3.2 Entering Queries ......................................................................................................... 208 3.3 Creating and Using a Database ................................................................................... 211 3.3.1 Creating and Selecting a Database ................................................................... 212 3.3.2 Creating a Table ............................................................................................... 213 3.3.3 Loading Data into a Table ................................................................................. 214 3.3.4 Retrieving Information from a Table ................................................................... 215 3.4 Getting Information About Databases and Tables .......................................................... 228 3.5 Using mysql in Batch Mode ........................................................................................ 229 3.6 Examples of Common Queries .................................................................................... 231 3.6.1 The Maximum Value for a Column .................................................................... 231 3.6.2 The Row Holding the Maximum of a Certain Column .......................................... 231 3.6.3 Maximum of Column per Group ........................................................................ 232 3.6.4 The Rows Holding the Group-wise Maximum of a Certain Column ....................... 232 3.6.5 Using User-Defined Variables ........................................................................... 233 3.6.6 Using Foreign Keys .......................................................................................... 233 3.6.7 Searching on Two Keys .................................................................................... 235 3.6.8 Calculating Visits Per Day ................................................................................. 235 3.6.9 Using AUTO_INCREMENT .................................................................................. 236 3.7 Using MySQL with Apache .......................................................................................... 238 4 MySQL Programs ................................................................................................................... 239 4.1 Overview of MySQL Programs ..................................................................................... 240 4.2 Using MySQL Programs .............................................................................................. 244 4.2.1 Invoking MySQL Programs ............................................................................... 244 4.2.2 Connecting to the MySQL Server ...................................................................... 245 4.2.3 Specifying Program Options .............................................................................. 248 5. MySQL 5.5 Reference Manual v 4.2.4 Setting Environment Variables ........................................................................... 260 4.3 MySQL Server and Server-Startup Programs ................................................................ 261 4.3.1 mysqld The MySQL Server ......................................................................... 261 4.3.2 mysqld_safe MySQL Server Startup Script ................................................. 262 4.3.3 mysql.server MySQL Server Startup Script ............................................... 267 4.3.4 mysqld_multi Manage Multiple MySQL Servers ......................................... 268 4.4 MySQL Installation-Related Programs .......................................................................... 271 4.4.1 comp_err Compile MySQL Error Message File ............................................. 271 4.4.2 mysqlbug Generate Bug Report .................................................................. 272 4.4.3 mysql_install_db Initialize MySQL Data Directory .................................... 273 4.4.4 mysql_plugin Configure MySQL Server Plugins ......................................... 275 4.4.5 mysql_secure_installation Improve MySQL Installation Security ........... 277 4.4.6 mysql_tzinfo_to_sql Load the Time Zone Tables ................................... 277 4.4.7 mysql_upgrade Check and Upgrade MySQL Tables .................................... 278 4.5 MySQL Client Programs .............................................................................................. 282 4.5.1 mysql The MySQL Command-Line Tool ....................................................... 282 4.5.2 mysqladmin Client for Administering a MySQL Server .................................. 303 4.5.3 mysqlcheck A Table Maintenance Program ................................................. 311 4.5.4 mysqldump A Database Backup Program ..................................................... 318 4.5.5 mysqlimport A Data Import Program .......................................................... 336 4.5.6 mysqlshow Display Database, Table, and Column Information ....................... 341 4.5.7 mysqlslap Load Emulation Client ............................................................... 345 4.6 MySQL Administrative and Utility Programs .................................................................. 353 4.6.1 innochecksum Offline InnoDB File Checksum Utility .................................... 353 4.6.2 myisam_ftdump Display Full-Text Index information ..................................... 354 4.6.3 myisamchk MyISAM Table-Maintenance Utility ............................................. 355 4.6.4 myisamlog Display MyISAM Log File Contents ............................................ 372 4.6.5 myisampack Generate Compressed, Read-Only MyISAM Tables ................... 373 4.6.6 mysqlaccess Client for Checking Access Privileges ..................................... 378 4.6.7 mysqlbinlog Utility for Processing Binary Log Files ..................................... 381 4.6.8 mysqldumpslow Summarize Slow Query Log Files ....................................... 395 4.6.9 mysqlhotcopy A Database Backup Program ............................................... 397 4.6.10 mysql_convert_table_format Convert Tables to Use a Given Storage Engine ...................................................................................................................... 400 4.6.11 mysql_find_rows Extract SQL Statements from Files ............................... 401 4.6.12 mysql_fix_extensions Normalize Table File Name Extensions ............... 402 4.6.13 mysql_setpermission Interactively Set Permissions in Grant Tables ........ 402 4.6.14 mysql_waitpid Kill Process and Wait for Its Termination ........................... 403 4.6.15 mysql_zap Kill Processes That Match a Pattern ......................................... 403 4.7 MySQL Program Development Utilities ......................................................................... 404 4.7.1 msql2mysql Convert mSQL Programs for Use with MySQL .......................... 404 4.7.2 mysql_config Display Options for Compiling Clients ................................... 404 4.7.3 my_print_defaults Display Options from Option Files ............................... 406 4.7.4 resolve_stack_dump Resolve Numeric Stack Trace Dump to Symbols ........ 406 4.8 Miscellaneous Programs .............................................................................................. 407 4.8.1 perror Explain Error Codes ........................................................................ 407 4.8.2 replace A String-Replacement Utility .......................................................... 408 4.8.3 resolveip Resolve Host name to IP Address or Vice Versa ......................... 409 5 MySQL Server Administration ................................................................................................. 411 5.1 The MySQL Server ..................................................................................................... 411 5.1.1 Server Option and Variable Reference ............................................................... 412 5.1.2 Server Configuration Defaults ............................................................................ 439 5.1.3 Server Command Options ................................................................................. 440 5.1.4 Server System Variables ................................................................................... 473 5.1.5 Using System Variables .................................................................................... 573 5.1.6 Server Status Variables .................................................................................... 585 5.1.7 Server SQL Modes ........................................................................................... 609 5.1.8 Server Plugins .................................................................................................. 617 6. MySQL 5.5 Reference Manual vi 5.1.9 IPv6 Support .................................................................................................... 621 5.1.10 Server-Side Help ............................................................................................ 625 5.1.11 Server Response to Signals ............................................................................ 626 5.1.12 The Shutdown Process ................................................................................... 627 5.2 MySQL Server Logs .................................................................................................... 628 5.2.1 Selecting General Query and Slow Query Log Output Destinations ...................... 628 5.2.2 The Error Log ................................................................................................... 631 5.2.3 The General Query Log .................................................................................... 632 5.2.4 The Binary Log ................................................................................................. 633 5.2.5 The Slow Query Log ......................................................................................... 645 5.2.6 Server Log Maintenance ................................................................................... 647 5.3 Running Multiple MySQL Instances on One Machine .................................................... 648 5.3.1 Setting Up Multiple Data Directories .................................................................. 650 5.3.2 Running Multiple MySQL Instances on Windows ................................................ 651 5.3.3 Running Multiple MySQL Instances on Unix ....................................................... 653 5.3.4 Using Client Programs in a Multiple-Server Environment ..................................... 655 5.4 Tracing mysqld Using DTrace .................................................................................... 655 5.4.1 mysqld DTrace Probe Reference ..................................................................... 656 6 Security ................................................................................................................................. 675 6.1 General Security Issues ............................................................................................... 676 6.1.1 Security Guidelines ........................................................................................... 676 6.1.2 Keeping Passwords Secure .............................................................................. 677 6.1.3 Making MySQL Secure Against Attackers .......................................................... 685 6.1.4 Security-Related mysqld Options and Variables ................................................ 686 6.1.5 How to Run MySQL as a Normal User .............................................................. 687 6.1.6 Security Issues with LOAD DATA LOCAL .......................................................... 688 6.1.7 Client Programming Security Guidelines ............................................................ 689 6.2 The MySQL Access Privilege System ........................................................................... 690 6.2.1 Privileges Provided by MySQL .......................................................................... 691 6.2.2 Privilege System Grant Tables .......................................................................... 695 6.2.3 Specifying Account Names ............................................................................... 701 6.2.4 Access Control, Stage 1: Connection Verification ............................................... 702 6.2.5 Access Control, Stage 2: Request Verification .................................................... 705 6.2.6 When Privilege Changes Take Effect ................................................................. 707 6.2.7 Causes of Access-Denied Errors ....................................................................... 708 6.3 MySQL User Account Management ............................................................................. 713 6.3.1 User Names and Passwords ............................................................................. 713 6.3.2 Adding User Accounts ...................................................................................... 715 6.3.3 Removing User Accounts .................................................................................. 718 6.3.4 Setting Account Resource Limits ....................................................................... 718 6.3.5 Assigning Account Passwords ........................................................................... 720 6.3.6 Pluggable Authentication ................................................................................... 722 6.3.7 Authentication Plugins Available in MySQL ........................................................ 724 6.3.8 Proxy Users ..................................................................................................... 739 6.3.9 Using SSL for Secure Connections ................................................................... 742 6.3.10 Connecting to MySQL Remotely from Windows with SSH ................................. 754 6.3.11 MySQL Enterprise Audit Log Plugin ................................................................. 754 6.3.12 SQL-Based MySQL Account Activity Auditing ................................................... 770 7 Backup and Recovery ............................................................................................................ 773 7.1 Backup and Recovery Types ....................................................................................... 774 7.2 Database Backup Methods .......................................................................................... 777 7.3 Example Backup and Recovery Strategy ...................................................................... 779 7.3.1 Establishing a Backup Policy ............................................................................ 779 7.3.2 Using Backups for Recovery ............................................................................. 781 7.3.3 Backup Strategy Summary ................................................................................ 782 7.4 Using mysqldump for Backups .................................................................................... 782 7.4.1 Dumping Data in SQL Format with mysqldump ................................................. 782 7.4.2 Reloading SQL-Format Backups ....................................................................... 783 7. MySQL 5.5 Reference Manual vii 7.4.3 Dumping Data in Delimited-Text Format with mysqldump ................................... 784 7.4.4 Reloading Delimited-Text Format Backups ......................................................... 785 7.4.5 mysqldump Tips .............................................................................................. 786 7.5 Point-in-Time (Incremental) Recovery Using the Binary Log ........................................... 788 7.5.1 Point-in-Time Recovery Using Event Times ....................................................... 789 7.5.2 Point-in-Time Recovery Using Event Positions ................................................... 790 7.6 MyISAM Table Maintenance and Crash Recovery ......................................................... 790 7.6.1 Using myisamchk for Crash Recovery .............................................................. 791 7.6.2 How to Check MyISAM Tables for Errors ........................................................... 792 7.6.3 How to Repair MyISAM Tables .......................................................................... 792 7.6.4 MyISAM Table Optimization ............................................................................... 794 7.6.5 Setting Up a MyISAM Table Maintenance Schedule ............................................ 795 8 Optimization ........................................................................................................................... 797 8.1 Optimization Overview ................................................................................................. 798 8.2 Optimizing SQL Statements ......................................................................................... 799 8.2.1 Optimizing SELECT Statements ......................................................................... 799 8.2.2 Optimizing DML Statements .............................................................................. 833 8.2.3 Optimizing Database Privileges ......................................................................... 834 8.2.4 Optimizing INFORMATION_SCHEMA Queries ...................................................... 834 8.2.5 Other Optimization Tips .................................................................................... 839 8.3 Optimization and Indexes ............................................................................................ 840 8.3.1 How MySQL Uses Indexes ............................................................................... 840 8.3.2 Using Primary Keys .......................................................................................... 841 8.3.3 Using Foreign Keys .......................................................................................... 841 8.3.4 Column Indexes ............................................................................................... 842 8.3.5 Multiple-Column Indexes ................................................................................... 842 8.3.6 Verifying Index Usage ....................................................................................... 844 8.3.7 InnoDB and MyISAM Index Statistics Collection ................................................. 844 8.3.8 Comparison of B-Tree and Hash Indexes .......................................................... 845 8.4 Optimizing Database Structure ..................................................................................... 847 8.4.1 Optimizing Data Size ........................................................................................ 847 8.4.2 Optimizing MySQL Data Types ......................................................................... 849 8.4.3 Optimizing for Many Tables .............................................................................. 850 8.4.4 How MySQL Uses Internal Temporary Tables .................................................... 852 8.5 Optimizing for InnoDB Tables ..................................................................................... 853 8.5.1 Optimizing Storage Layout for InnoDB Tables ................................................... 853 8.5.2 Optimizing InnoDB Transaction Management .................................................... 853 8.5.3 Optimizing InnoDB Logging .............................................................................. 854 8.5.4 Bulk Data Loading for InnoDB Tables ............................................................... 854 8.5.5 Optimizing InnoDB Queries .............................................................................. 855 8.5.6 Optimizing InnoDB DDL Operations .................................................................. 856 8.5.7 Optimizing InnoDB Disk I/O .............................................................................. 856 8.5.8 Optimizing InnoDB Configuration Variables ....................................................... 857 8.5.9 Optimizing InnoDB for Systems with Many Tables ............................................. 858 8.6 Optimizing for MyISAM Tables ..................................................................................... 858 8.6.1 Optimizing MyISAM Queries .............................................................................. 858 8.6.2 Bulk Data Loading for MyISAM Tables ............................................................... 860 8.6.3 Speed of REPAIR TABLE Statements ............................................................... 861 8.7 Optimizing for MEMORY Tables ..................................................................................... 862 8.8 Understanding the Query Execution Plan ..................................................................... 863 8.8.1 Optimizing Queries with EXPLAIN ..................................................................... 863 8.8.2 EXPLAIN Output Format ................................................................................... 863 8.8.3 EXPLAIN EXTENDED Output Format ................................................................. 874 8.8.4 Estimating Query Performance .......................................................................... 875 8.8.5 Controlling the Query Optimizer ........................................................................ 876 8.9 Buffering and Caching ................................................................................................. 878 8.9.1 The InnoDB Buffer Pool ................................................................................... 878 8.9.2 The MyISAM Key Cache ................................................................................... 881 8. MySQL 5.5 Reference Manual viii 8.9.3 The MySQL Query Cache ................................................................................. 885 8.10 Optimizing Locking Operations ................................................................................... 891 8.10.1 Internal Locking Methods ................................................................................ 891 8.10.2 Table Locking Issues ...................................................................................... 893 8.10.3 Concurrent Inserts .......................................................................................... 894 8.10.4 Metadata Locking ........................................................................................... 895 8.10.5 External Locking ............................................................................................. 896 8.11 Optimizing the MySQL Server .................................................................................... 897 8.11.1 System Factors and Startup Parameter Tuning ................................................ 897 8.11.2 Tuning Server Parameters .............................................................................. 897 8.11.3 Optimizing Disk I/O ......................................................................................... 904 8.11.4 Optimizing Memory Use .................................................................................. 908 8.11.5 Optimizing Network Use .................................................................................. 911 8.11.6 The Thread Pool Plugin .................................................................................. 913 8.12 Measuring Performance (Benchmarking) .................................................................... 919 8.12.1 Measuring the Speed of Expressions and Functions ......................................... 919 8.12.2 The MySQL Benchmark Suite ......................................................................... 919 8.12.3 Using Your Own Benchmarks .......................................................................... 920 8.12.4 Measuring Performance with performance_schema ...................................... 921 8.12.5 Examining Thread Information ......................................................................... 921 9 Language Structure ................................................................................................................ 935 9.1 Literal Values .............................................................................................................. 935 9.1.1 String Literals ................................................................................................... 935 9.1.2 Number Literals ................................................................................................ 938 9.1.3 Date and Time Literals ..................................................................................... 938 9.1.4 Hexadecimal Literals ......................................................................................... 940 9.1.5 Boolean Literals ................................................................................................ 941 9.1.6 Bit-Field Literals ................................................................................................ 941 9.1.7 NULL Values .................................................................................................... 941 9.2 Schema Object Names ................................................................................................ 941 9.2.1 Identifier Qualifiers ............................................................................................ 943 9.2.2 Identifier Case Sensitivity .................................................................................. 944 9.2.3 Mapping of Identifiers to File Names ................................................................. 946 9.2.4 Function Name Parsing and Resolution ............................................................. 948 9.3 Reserved Words ......................................................................................................... 951 9.4 User-Defined Variables ................................................................................................ 954 9.5 Expression Syntax ....................................................................................................... 957 9.6 Comment Syntax ......................................................................................................... 959 10 Globalization ........................................................................................................................ 961 10.1 Character Set Support ............................................................................................... 961 10.1.1 Character Sets and Collations in General ......................................................... 962 10.1.2 Character Sets and Collations in MySQL ......................................................... 963 10.1.3 Specifying Character Sets and Collations ......................................................... 964 10.1.4 Connection Character Sets and Collations ....................................................... 971 10.1.5 Configuring the Character Set and Collation for Applications ............................. 973 10.1.6 Character Set for Error Messages ................................................................... 975 10.1.7 Collation Issues .............................................................................................. 976 10.1.8 String Repertoire ............................................................................................ 985 10.1.9 Operations Affected by Character Set Support ................................................. 987 10.1.10 Unicode Support ........................................................................................... 990 10.1.11 Upgrading from Previous to Current Unicode Support ..................................... 994 10.1.12 UTF-8 for Metadata ...................................................................................... 996 10.1.13 Column Character Set Conversion ................................................................. 997 10.1.14 Character Sets and Collations That MySQL Supports ..................................... 998 10.2 Setting the Error Message Language ........................................................................ 1010 10.3 Adding a Character Set ........................................................................................... 1011 10.3.1 Character Definition Arrays ............................................................................ 1013 10.3.2 String Collating Support for Complex Character Sets ...................................... 1014 9. MySQL 5.5 Reference Manual ix 10.3.3 Multi-Byte Character Support for Complex Character Sets ............................... 1014 10.4 Adding a Collation to a Character Set ....................................................................... 1014 10.4.1 Collation Implementation Types ..................................................................... 1015 10.4.2 Choosing a Collation ID ................................................................................ 1017 10.4.3 Adding a Simple Collation to an 8-Bit Character Set ....................................... 1018 10.4.4 Adding a UCA Collation to a Unicode Character Set ....................................... 1019 10.5 Character Set Configuration ..................................................................................... 1022 10.6 MySQL Server Time Zone Support ........................................................................... 1023 10.6.1 Staying Current with Time Zone Changes ...................................................... 1025 10.6.2 Time Zone Leap Second Support .................................................................. 1026 10.7 MySQL Server Locale Support ................................................................................. 1028 11 Data Types ........................................................................................................................ 1031 11.1 Data Type Overview ................................................................................................ 1032 11.1.1 Numeric Type Overview ................................................................................ 1032 11.1.2 Date and Time Type Overview ...................................................................... 1035 11.1.3 String Type Overview .................................................................................... 1036 11.2 Numeric Types ........................................................................................................ 1039 11.2.1 Integer Types (Exact Value) - INTEGER, INT, SMALLINT, TINYINT, MEDIUMINT, BIGINT .............................................................................................. 1040 11.2.2 Fixed-Point Types (Exact Value) - DECIMAL, NUMERIC ................................... 1040 11.2.3 Floating-Point Types (Approximate Value) - FLOAT, DOUBLE ........................... 1041 11.2.4 Bit-Value Type - BIT .................................................................................... 1041 11.2.5 Numeric Type Attributes ................................................................................ 1041 11.2.6 Out-of-Range and Overflow Handling ............................................................. 1042 11.3 Date and Time Types .............................................................................................. 1044 11.3.1 The DATE, DATETIME, and TIMESTAMP Types ............................................... 1045 11.3.2 The TIME Type ............................................................................................ 1046 11.3.3 The YEAR Type ............................................................................................ 1047 11.3.4 YEAR(2) Limitations and Migrating to YEAR(4) ............................................. 1047 11.3.5 Automatic Initialization and Updating for TIMESTAMP ...................................... 1049 11.3.6 Fractional Seconds in Time Values ................................................................ 1052 11.3.7 Conversion Between Date and Time Types .................................................... 1052 11.3.8 Two-Digit Years in Dates .............................................................................. 1053 11.4 String Types ............................................................................................................ 1053 11.4.1 The CHAR and VARCHAR Types ..................................................................... 1054 11.4.2 The BINARY and VARBINARY Types ............................................................. 1055 11.4.3 The BLOB and TEXT Types ........................................................................... 1056 11.4.4 The ENUM Type ............................................................................................ 1058 11.4.5 The SET Type .............................................................................................. 1061 11.5 Data Type Default Values ........................................................................................ 1063 11.6 Data Type Storage Requirements ............................................................................. 1064 11.7 Choosing the Right Type for a Column ..................................................................... 1067 11.8 Using Data Types from Other Database Engines ...................................................... 1068 12 Functions and Operators .................................................................................................... 1069 12.1 Function and Operator Reference ............................................................................. 1070 12.2 Type Conversion in Expression Evaluation ................................................................ 1077 12.3 Operators ................................................................................................................ 1080 12.3.1 Operator Precedence .................................................................................... 1081 12.3.2 Comparison Functions and Operators ............................................................ 1081 12.3.3 Logical Operators .......................................................................................... 1087 12.3.4 Assignment Operators ................................................................................... 1088 12.4 Control Flow Functions ............................................................................................ 1090 12.5 String Functions ...................................................................................................... 1092 12.5.1 String Comparison Functions ......................................................................... 1103 12.5.2 Regular Expressions ..................................................................................... 1107 12.6 Numeric Functions and Operators ............................................................................ 1112 12.6.1 Arithmetic Operators ..................................................................................... 1113 12.6.2 Mathematical Functions ................................................................................. 1115 10. MySQL 5.5 Reference Manual x 12.7 Date and Time Functions ......................................................................................... 1124 12.8 What Calendar Is Used By MySQL? ......................................................................... 1144 12.9 Full-Text Search Functions ....................................................................................... 1145 12.9.1 Natural Language Full-Text Searches ............................................................ 1146 12.9.2 Boolean Full-Text Searches ........................................................................... 1149 12.9.3 Full-Text Searches with Query Expansion ...................................................... 1152 12.9.4 Full-Text Stopwords ...................................................................................... 1152 12.9.5 Full-Text Restrictions ..................................................................................... 1155 12.9.6 Fine-Tuning MySQL Full-Text Search ............................................................ 1156 12.9.7 Adding a Collation for Full-Text Indexing ........................................................ 1158 12.10 Cast Functions and Operators ................................................................................ 1159 12.11 XML Functions ...................................................................................................... 1162 12.12 Bit Functions ......................................................................................................... 1173 12.13 Encryption and Compression Functions .................................................................. 1174 12.14 Information Functions ............................................................................................. 1181 12.15 Miscellaneous Functions ........................................................................................ 1189 12.16 Functions and Modifiers for Use with GROUP BY Clauses ........................................ 1194 12.16.1 GROUP BY (Aggregate) Functions ................................................................ 1194 12.16.2 GROUP BY Modifiers ................................................................................... 1198 12.16.3 MySQL Extensions to GROUP BY ................................................................ 1201 12.17 Spatial Extensions ................................................................................................. 1202 12.17.1 Introduction to MySQL Spatial Support ......................................................... 1203 12.17.2 The OpenGIS Geometry Model .................................................................... 1203 12.17.3 Supported Spatial Data Formats .................................................................. 1209 12.17.4 Creating a Spatially Enabled MySQL Database ............................................ 1211 12.17.5 Spatial Analysis Functions ........................................................................... 1215 12.17.6 Optimizing Spatial Analysis .......................................................................... 1225 12.17.7 MySQL Conformance and Compatibility ....................................................... 1228 12.18 Precision Math ....................................................................................................... 1228 12.18.1 Types of Numeric Values ............................................................................ 1229 12.18.2 DECIMAL Data Type Characteristics ............................................................ 1229 12.18.3 Expression Handling ................................................................................... 1230 12.18.4 Rounding Behavior ...................................................................................... 1232 12.18.5 Precision Math Examples ............................................................................ 1233 13 SQL Statement Syntax ....................................................................................................... 1237 13.1 Data Definition Statements ....................................................................................... 1238 13.1.1 ALTER DATABASE Syntax ............................................................................ 1238 13.1.2 ALTER EVENT Syntax .................................................................................. 1239 13.1.3 ALTER LOGFILE GROUP Syntax .................................................................. 1241 13.1.4 ALTER FUNCTION Syntax ............................................................................ 1242 13.1.5 ALTER PROCEDURE Syntax .......................................................................... 1242 13.1.6 ALTER SERVER Syntax ................................................................................ 1243 13.1.7 ALTER TABLE Syntax .................................................................................. 1243 13.1.8 ALTER TABLESPACE Syntax ........................................................................ 1262 13.1.9 ALTER VIEW Syntax .................................................................................... 1263 13.1.10 CREATE DATABASE Syntax ........................................................................ 1263 13.1.11 CREATE EVENT Syntax .............................................................................. 1264 13.1.12 CREATE FUNCTION Syntax ........................................................................ 1268 13.1.13 CREATE INDEX Syntax .............................................................................. 1268 13.1.14 CREATE LOGFILE GROUP Syntax .............................................................. 1272 13.1.15 CREATE PROCEDURE and CREATE FUNCTION Syntax ................................. 1273 13.1.16 CREATE SERVER Syntax ............................................................................ 1278 13.1.17 CREATE TABLE Syntax .............................................................................. 1279 13.1.18 CREATE TABLESPACE Syntax .................................................................... 1307 13.1.19 CREATE TRIGGER Syntax .......................................................................... 1308 13.1.20 CREATE VIEW Syntax ................................................................................ 1311 13.1.21 DROP DATABASE Syntax ............................................................................ 1314 13.1.22 DROP EVENT Syntax .................................................................................. 1315 11. MySQL 5.5 Reference Manual xi 13.1.23 DROP FUNCTION Syntax ............................................................................ 1315 13.1.24 DROP INDEX Syntax .................................................................................. 1315 13.1.25 DROP LOGFILE GROUP Syntax .................................................................. 1316 13.1.26 DROP PROCEDURE and DROP FUNCTION Syntax ......................................... 1316 13.1.27 DROP SERVER Syntax ................................................................................ 1317 13.1.28 DROP TABLE Syntax .................................................................................. 1317 13.1.29 DROP TABLESPACE Syntax ........................................................................ 1318 13.1.30 DROP TRIGGER Syntax .............................................................................. 1318 13.1.31 DROP VIEW Syntax .................................................................................... 1318 13.1.32 RENAME TABLE Syntax .............................................................................. 1319 13.1.33 TRUNCATE TABLE Syntax .......................................................................... 1319 13.2 Data Manipulation Statements .................................................................................. 1320 13.2.1 CALL Syntax ................................................................................................. 1320 13.2.2 DELETE Syntax ............................................................................................. 1322 13.2.3 DO Syntax ..................................................................................................... 1326 13.2.4 HANDLER Syntax ........................................................................................... 1326 13.2.5 INSERT Syntax ............................................................................................. 1328 13.2.6 LOAD DATA INFILE Syntax ........................................................................ 1336 13.2.7 LOAD XML Syntax ........................................................................................ 1345 13.2.8 REPLACE Syntax ........................................................................................... 1351 13.2.9 SELECT Syntax ............................................................................................. 1352 13.2.10 Subquery Syntax ......................................................................................... 1370 13.2.11 UPDATE Syntax ........................................................................................... 1382 13.3 MySQL Transactional and Locking Statements .......................................................... 1384 13.3.1 START TRANSACTION, COMMIT, and ROLLBACK Syntax ................................ 1384 13.3.2 Statements That Cannot Be Rolled Back ....................................................... 1387 13.3.3 Statements That Cause an Implicit Commit .................................................... 1387 13.3.4 SAVEPOINT, ROLLBACK TO SAVEPOINT, and RELEASE SAVEPOINT Syntax . 1388 13.3.5 LOCK TABLES and UNLOCK TABLES Syntax ................................................. 1389 13.3.6 SET TRANSACTION Syntax .......................................................................... 1394 13.3.7 XA Transactions ........................................................................................... 1396 13.4 Replication Statements ............................................................................................ 1400 13.4.1 SQL Statements for Controlling Master Servers .............................................. 1400 13.4.2 SQL Statements for Controlling Slave Servers ................................................ 1402 13.5 SQL Syntax for Prepared Statements ....................................................................... 1408 13.5.1 PREPARE Syntax ........................................................................................... 1412 13.5.2 EXECUTE Syntax ........................................................................................... 1412 13.5.3 DEALLOCATE PREPARE Syntax .................................................................... 1412 13.5.4 Automatic Prepared Statement Repreparation ................................................ 1413 13.6 MySQL Compound-Statement Syntax ....................................................................... 1413 13.6.1 BEGIN ... END Compound-Statement Syntax ............................................. 1413 13.6.2 Statement Label Syntax ................................................................................ 1414 13.6.3 DECLARE Syntax ........................................................................................... 1414 13.6.4 Variables in Stored Programs ........................................................................ 1415 13.6.5 Flow Control Statements ............................................................................... 1416 13.6.6 Cursors ........................................................................................................ 1421 13.6.7 Condition Handling ........................................................................................ 1422 13.7 Database Administration Statements ........................................................................ 1436 13.7.1 Account Management Statements .................................................................. 1436 13.7.2 Table Maintenance Statements ...................................................................... 1452 13.7.3 Plugin and User-Defined Function Statements ................................................ 1460 13.7.4 SET Syntax ................................................................................................... 1462 13.7.5 SHOW Syntax ................................................................................................. 1466 13.7.6 Other Administrative Statements .................................................................... 1505 13.8 MySQL Utility Statements ........................................................................................ 1512 13.8.1 DESCRIBE Syntax ......................................................................................... 1512 13.8.2 EXPLAIN Syntax ........................................................................................... 1513 13.8.3 HELP Syntax ................................................................................................. 1514 12. MySQL 5.5 Reference Manual xii 13.8.4 USE Syntax ................................................................................................... 1516 14 Storage Engines ................................................................................................................. 1517 14.1 Setting the Storage Engine ...................................................................................... 1521 14.2 Overview of MySQL Storage Engine Architecture ...................................................... 1521 14.2.1 Pluggable Storage Engine Architecture .......................................................... 1522 14.2.2 The Common Database Server Layer ............................................................ 1522 14.3 The InnoDB Storage Engine .................................................................................... 1523 14.3.1 Introduction to InnoDB 1.1 ......................................................................... 1523 14.3.2 Installing the InnoDB Storage Engine ............................................................. 1534 14.3.3 Upgrading the InnoDB Storage Engine ........................................................... 1535 14.3.4 Downgrading the InnoDB Storage Engine ...................................................... 1535 14.3.5 InnoDB Concepts and Architecture ............................................................... 1535 14.3.6 InnoDB Configuration ................................................................................... 1554 14.3.7 InnoDB Administration .................................................................................. 1559 14.3.8 InnoDB Tablespace Management ................................................................. 1559 14.3.9 InnoDB Table Management .......................................................................... 1567 14.3.10 InnoDB Compressed Tables ....................................................................... 1583 14.3.11 InnoDB File-Format Management ................................................................ 1594 14.3.12 InnoDB Row Storage and Row Formats ...................................................... 1599 14.3.13 InnoDB Disk I/O and File Space Management ............................................. 1601 14.3.14 InnoDB Fast Index Creation ........................................................................ 1604 14.3.15 InnoDB Performance Tuning ....................................................................... 1608 14.3.16 InnoDB Startup Options and System Variables ............................................ 1639 14.3.17 InnoDB Backup and Recovery .................................................................... 1675 14.3.18 InnoDB and MySQL Replication .................................................................. 1677 14.3.19 InnoDB Troubleshooting ............................................................................. 1679 14.4 The MyISAM Storage Engine .................................................................................... 1688 14.4.1 MyISAM Startup Options ................................................................................ 1690 14.4.2 Space Needed for Keys ................................................................................ 1692 14.4.3 MyISAM Table Storage Formats .................................................................... 1692 14.4.4 MyISAM Table Problems ............................................................................... 1695 14.5 The MEMORY Storage Engine .................................................................................... 1696 14.6 The CSV Storage Engine ......................................................................................... 1700 14.6.1 Repairing and Checking CSV Tables ............................................................. 1701 14.6.2 CSV Limitations ............................................................................................ 1702 14.7 The ARCHIVE Storage Engine .................................................................................. 1702 14.8 The BLACKHOLE Storage Engine .............................................................................. 1703 14.9 The MERGE Storage Engine ...................................................................................... 1705 14.9.1 MERGE Table Advantages and Disadvantages ................................................ 1708 14.9.2 MERGE Table Problems ................................................................................. 1709 14.10 The FEDERATED Storage Engine ............................................................................ 1710 14.10.1 FEDERATED Storage Engine Overview ......................................................... 1711 14.10.2 How to Create FEDERATED Tables .............................................................. 1712 14.10.3 FEDERATED Storage Engine Notes and Tips ................................................ 1714 14.10.4 FEDERATED Storage Engine Resources ....................................................... 1715 14.11 The EXAMPLE Storage Engine ................................................................................ 1716 14.12 Other Storage Engines ........................................................................................... 1716 15 High Availability and Scalability ........................................................................................... 1717 15.1 Oracle VM Template for MySQL Enterprise Edition ................................................... 1720 15.2 Overview of MySQL with DRBD/Pacemaker/Corosync/Oracle Linux ........................... 1720 15.3 Overview of MySQL with Windows Failover Clustering ............................................... 1723 15.4 Using MySQL within an Amazon EC2 Instance ......................................................... 1725 15.4.1 Setting Up MySQL on an EC2 AMI ................................................................ 1725 15.4.2 EC2 Instance Limitations ............................................................................... 1727 15.4.3 Deploying a MySQL Database Using EC2 ...................................................... 1727 15.5 Using ZFS Replication ............................................................................................. 1730 15.5.1 Using ZFS for File System Replication ........................................................... 1732 15.5.2 Configuring MySQL for ZFS Replication ......................................................... 1732 13. MySQL 5.5 Reference Manual xiii 15.5.3 Handling MySQL Recovery with ZFS ............................................................. 1733 15.6 Using MySQL with memcached ................................................................................ 1733 15.6.1 Installing memcached .................................................................................... 1734 15.6.2 Using memcached ........................................................................................ 1736 15.6.3 Developing a memcached Application ............................................................ 1754 15.6.4 Getting memcached Statistics ........................................................................ 1779 15.6.5 memcached FAQ .......................................................................................... 1787 15.7 MySQL Proxy .......................................................................................................... 1790 15.7.1 MySQL Proxy Supported Platforms ................................................................ 1791 15.7.2 Installing MySQL Proxy ................................................................................. 1791 15.7.3 MySQL Proxy Command Options .................................................................. 1795 15.7.4 MySQL Proxy Scripting ................................................................................. 1804 15.7.5 Using MySQL Proxy ...................................................................................... 1818 15.7.6 MySQL Proxy FAQ ....................................................................................... 1824 16 Replication ......................................................................................................................... 1829 16.1 Replication Configuration ......................................................................................... 1830 16.1.1 How to Set Up Replication ............................................................................ 1831 16.1.2 Replication Formats ...................................................................................... 1840 16.1.3 Replication and Binary Logging Options and Variables .................................... 1847 16.1.4 Common Replication Administration Tasks ..................................................... 1892 16.2 Replication Implementation ...................................................................................... 1895 16.2.1 Replication Implementation Details ................................................................ 1895 16.2.2 Replication Relay and Status Logs ................................................................ 1897 16.2.3 How Servers Evaluate Replication Filtering Rules ........................................... 1900 16.3 Replication Solutions ............................................................................................... 1906 16.3.1 Using Replication for Backups ....................................................................... 1907 16.3.2 Using Replication with Different Master and Slave Storage Engines ................. 1910 16.3.3 Using Replication for Scale-Out ..................................................................... 1911 16.3.4 Replicating Different Databases to Different Slaves ......................................... 1912 16.3.5 Improving Replication Performance ................................................................ 1914 16.3.6 Switching Masters During Failover ................................................................. 1915 16.3.7 Setting Up Replication Using SSL .................................................................. 1917 16.3.8 Semisynchronous Replication ........................................................................ 1918 16.4 Replication Notes and Tips ...................................................................................... 1923 16.4.1 Replication Features and Issues .................................................................... 1923 16.4.2 Replication Compatibility Between MySQL Versions ....................................... 1948 16.4.3 Upgrading a Replication Setup ...................................................................... 1949 16.4.4 Troubleshooting Replication ........................................................................... 1950 16.4.5 How to Report Replication Bugs or Problems ................................................. 1951 17 MySQL Cluster NDB 7.2 ..................................................................................................... 1953 17.1 MySQL Cluster Overview ......................................................................................... 1956 17.1.1 MySQL Cluster Core Concepts ...................................................................... 1958 17.1.2 MySQL Cluster Nodes, Node Groups, Replicas, and Partitions ........................ 1960 17.1.3 MySQL Cluster Hardware, Software, and Networking Requirements ................ 1963 17.1.4 MySQL Cluster Development History ............................................................. 1964 17.1.5 MySQL Server Using InnoDB Compared with MySQL Cluster ......................... 1967 17.1.6 Known Limitations of MySQL Cluster ............................................................. 1971 17.2 MySQL Cluster Installation and Upgrades ................................................................. 1982 17.2.1 Installing MySQL Cluster on Linux ................................................................. 1984 17.2.2 Installing MySQL Cluster on Windows ............................................................ 1990 17.2.3 Initial Configuration of MySQL Cluster ............................................................ 1999 17.2.4 Initial Startup of MySQL Cluster ..................................................................... 2001 17.2.5 MySQL Cluster Example with Tables and Data ............................................... 2002 17.2.6 Safe Shutdown and Restart of MySQL Cluster ............................................... 2005 17.2.7 Upgrading and Downgrading MySQL Cluster NDB 7.2 .................................... 2006 17.3 Configuration of MySQL Cluster NDB 7.2 ................................................................. 2008 17.3.1 Quick Test Setup of MySQL Cluster .............................................................. 2008 17.3.2 MySQL Cluster Configuration Files ................................................................ 2011 14. MySQL 5.5 Reference Manual xiv 17.3.3 Overview of MySQL Cluster Configuration Parameters .................................... 2100 17.3.4 MySQL Server Options and Variables for MySQL Cluster ................................ 2125 17.3.5 Using High-Speed Interconnects with MySQL Cluster ..................................... 2172 17.4 MySQL Cluster Programs ........................................................................................ 2174 17.4.1 ndbd The MySQL Cluster Data Node Daemon .......................................... 2174 17.4.2 ndbinfo_select_all Select From ndbinfo Tables .................................. 2181 17.4.3 ndbmtd The MySQL Cluster Data Node Daemon (Multi-Threaded) .............. 2182 17.4.4 ndb_mgmd The MySQL Cluster Management Server Daemon ..................... 2183 17.4.5 ndb_mgm The MySQL Cluster Management Client ..................................... 2192 17.4.6 ndb_blob_tool Check and Repair BLOB and TEXT columns of MySQL Cluster Tables ......................................................................................................... 2193 17.4.7 ndb_config Extract MySQL Cluster Configuration Information ................... 2195 17.4.8 ndb_cpcd Automate Testing for NDB Development ................................... 2203 17.4.9 ndb_delete_all Delete All Rows from an NDB Table ............................. 2203 17.4.10 ndb_desc Describe NDB Tables ............................................................ 2204 17.4.11 ndb_drop_index Drop Index from an NDB Table ................................... 2208 17.4.12 ndb_drop_table Drop an NDB Table ................................................... 2209 17.4.13 ndb_error_reporter NDB Error-Reporting Utility ................................. 2210 17.4.14 ndb_index_stat NDB Index Statistics Utility ......................................... 2211 17.4.15 ndb_print_backup_file Print NDB Backup File Contents .................... 2216 17.4.16 ndb_print_schema_file Print NDB Schema File Contents ................... 2216 17.4.17 ndb_print_sys_file Print NDB System File Contents ......................... 2217 17.4.18 ndbd_redo_log_reader Check and Print Content of Cluster Redo Log ... 2217 17.4.19 ndb_restore Restore a MySQL Cluster Backup ..................................... 2218 17.4.20 ndb_select_all Print Rows from an NDB Table ................................... 2230 17.4.21 ndb_select_count Print Row Counts for NDB Tables ........................... 2233 17.4.22 ndb_show_tables Display List of NDB Tables ....................................... 2234 17.4.23 ndb_size.pl NDBCLUSTER Size Requirement Estimator ...................... 2235 17.4.24 ndb_waiter Wait for MySQL Cluster to Reach a Given Status ................. 2238 17.4.25 Options Common to MySQL Cluster Programs Options Common to MySQL Cluster Programs .................................................................................................... 2241 17.5 Management of MySQL Cluster ............................................................................... 2244 17.5.1 Summary of MySQL Cluster Start Phases ...................................................... 2245 17.5.2 Commands in the MySQL Cluster Management Client .................................... 2247 17.5.3 Online Backup of MySQL Cluster .................................................................. 2250 17.5.4 MySQL Server Usage for MySQL Cluster ....................................................... 2254 17.5.5 Performing a Rolling Restart of a MySQL Cluster ........................................... 2256 17.5.6 Event Reports Generated in MySQL Cluster ................................................... 2258 17.5.7 MySQL Cluster Log Messages ...................................................................... 2268 17.5.8 MySQL Cluster Single User Mode ................................................................. 2279 17.5.9 Quick Reference: MySQL Cluster SQL Statements ......................................... 2280 17.5.10 The ndbinfo MySQL Cluster Information Database ..................................... 2283 17.5.11 MySQL Cluster Security Issues .................................................................... 2302 17.5.12 MySQL Cluster Disk Data Tables ................................................................. 2310 17.5.13 Adding MySQL Cluster Data Nodes Online ................................................... 2316 17.5.14 Distributed MySQL Privileges for MySQL Cluster .......................................... 2327 17.5.15 NDB API Statistics Counters and Variables .................................................. 2330 17.6 MySQL Cluster Replication ...................................................................................... 2341 17.6.1 MySQL Cluster Replication: Abbreviations and Symbols .................................. 2342 17.6.2 General Requirements for MySQL Cluster Replication .................................... 2343 17.6.3 Known Issues in MySQL Cluster Replication .................................................. 2344 17.6.4 MySQL Cluster Replication Schema and Tables ............................................. 2349 17.6.5 Preparing the MySQL Cluster for Replication .................................................. 2353 17.6.6 Starting MySQL Cluster Replication (Single Replication Channel) .................... 2354 17.6.7 Using Two Replication Channels for MySQL Cluster Replication ...................... 2356 17.6.8 Implementing Failover with MySQL Cluster Replication ................................... 2357 17.6.9 MySQL Cluster Backups With MySQL Cluster Replication ............................... 2359 17.6.10 MySQL Cluster Replication: Multi-Master and Circular Replication .................. 2365 15. MySQL 5.5 Reference Manual xv 17.6.11 MySQL Cluster Replication Conflict Resolution ............................................. 2369 17.7 MySQL Cluster Release Notes ................................................................................. 2378 18 Partitioning ......................................................................................................................... 2379 18.1 Overview of Partitioning in MySQL ........................................................................... 2381 18.2 Partitioning Types .................................................................................................... 2383 18.2.1 RANGE Partitioning ........................................................................................ 2385 18.2.2 LIST Partitioning .......................................................................................... 2389 18.2.3 COLUMNS Partitioning .................................................................................... 2392 18.2.4 HASH Partitioning .......................................................................................... 2399 18.2.5 KEY Partitioning ............................................................................................ 2402 18.2.6 Subpartitioning .............................................................................................. 2404 18.2.7 How MySQL Partitioning Handles NULL ......................................................... 2407 18.3 Partition Management .............................................................................................. 2411 18.3.1 Management of RANGE and LIST Partitions ................................................... 2412 18.3.2 Management of HASH and KEY Partitions ....................................................... 2418 18.3.3 Maintenance of Partitions .............................................................................. 2419 18.3.4 Obtaining Information About Partitions ........................................................... 2420 18.4 Partition Pruning ...................................................................................................... 2422 18.5 Restrictions and Limitations on Partitioning ............................................................... 2426 18.5.1 Partitioning Keys, Primary Keys, and Unique Keys .......................................... 2431 18.5.2 Partitioning Limitations Relating to Storage Engines ........................................ 2435 18.5.3 Partitioning Limitations Relating to Functions .................................................. 2435 18.5.4 Partitioning and Table-Level Locking .............................................................. 2436 19 Stored Programs and Views ............................................................................................... 2439 19.1 Defining Stored Programs ........................................................................................ 2440 19.2 Using Stored Routines (Procedures and Functions) ................................................... 2441 19.2.1 Stored Routine Syntax .................................................................................. 2441 19.2.2 Stored Routines and MySQL Privileges .......................................................... 2442 19.2.3 Stored Routine Metadata ............................................................................... 2442 19.2.4 Stored Procedures, Functions, Triggers, and LAST_INSERT_ID() .................. 2443 19.3 Using Triggers ......................................................................................................... 2443 19.3.1 Trigger Syntax and Examples ........................................................................ 2444 19.3.2 Trigger Metadata .......................................................................................... 2447 19.4 Using the Event Scheduler ....................................................................................... 2447 19.4.1 Event Scheduler Overview ............................................................................ 2448 19.4.2 Event Scheduler Configuration ....................................................................... 2449 19.4.3 Event Syntax ................................................................................................ 2451 19.4.4 Event Metadata ............................................................................................ 2451 19.4.5 Event Scheduler Status ................................................................................. 2452 19.4.6 The Event Scheduler and MySQL Privileges .................................................. 2452 19.5 Using Views ............................................................................................................ 2455 19.5.1 View Syntax ................................................................................................. 2455 19.5.2 View Processing Algorithms .......................................................................... 2456 19.5.3 Updatable and Insertable Views .................................................................... 2457 19.5.4 View Metadata .............................................................................................. 2459 19.6 Access Control for Stored Programs and Views ........................................................ 2459 19.7 Binary Logging of Stored Programs .......................................................................... 2461 20 INFORMATION_SCHEMA Tables ........................................................................................... 2467 20.1 The INFORMATION_SCHEMA CHARACTER_SETS Table ............................................. 2470 20.2 The INFORMATION_SCHEMA COLLATIONS Table .................................................... 2470 20.3 The INFORMATION_SCHEMA COLLATION_CHARACTER_SET_APPLICABILITY Table .............................................................................................................................. 2471 20.4 The INFORMATION_SCHEMA COLUMNS Table .......................................................... 2471 20.5 The INFORMATION_SCHEMA COLUMN_PRIVILEGES Table ....................................... 2472 20.6 The INFORMATION_SCHEMA ENGINES Table .......................................................... 2473 20.7 The INFORMATION_SCHEMA EVENTS Table ............................................................ 2473 20.8 The INFORMATION_SCHEMA GLOBAL_STATUS and SESSION_STATUS Tables .......... 2477 16. MySQL 5.5 Reference Manual xvi 20.9 The INFORMATION_SCHEMA GLOBAL_VARIABLES and SESSION_VARIABLES Tables ............................................................................................................................. 2477 20.10 The INFORMATION_SCHEMA KEY_COLUMN_USAGE Table ....................................... 2477 20.11 The INFORMATION_SCHEMA PARAMETERS Table ................................................... 2478 20.12 The INFORMATION_SCHEMA PARTITIONS Table ................................................... 2479 20.13 The INFORMATION_SCHEMA PLUGINS Table ......................................................... 2482 20.14 The INFORMATION_SCHEMA PROCESSLIST Table ................................................. 2483 20.15 The INFORMATION_SCHEMA PROFILING Table ..................................................... 2484 20.16 The INFORMATION_SCHEMA REFERENTIAL_CONSTRAINTS Table ......................... 2485 20.17 The INFORMATION_SCHEMA ROUTINES Table ....................................................... 2485 20.18 The INFORMATION_SCHEMA SCHEMATA Table ....................................................... 2487 20.19 The INFORMATION_SCHEMA SCHEMA_PRIVILEGES Table ..................................... 2487 20.20 The INFORMATION_SCHEMA STATISTICS Table ................................................... 2488 20.21 The INFORMATION_SCHEMA TABLES Table .......................................................... 2488 20.22 The INFORMATION_SCHEMA TABLESPACES Table ................................................. 2490 20.23 The INFORMATION_SCHEMA TABLE_CONSTRAINTS Table ..................................... 2490 20.24 The INFORMATION_SCHEMA TABLE_PRIVILEGES Table ....................................... 2490 20.25 The INFORMATION_SCHEMA TRIGGERS Table ....................................................... 2491 20.26 The INFORMATION_SCHEMA USER_PRIVILEGES Table ......................................... 2493 20.27 The INFORMATION_SCHEMA VIEWS Table ............................................................ 2493 20.28 INFORMATION_SCHEMA Tables for InnoDB ............................................................ 2494 20.28.1 The INFORMATION_SCHEMA INNODB_CMP and INNODB_CMP_RESET Tables ..................................................................................................................... 2495 20.28.2 The INFORMATION_SCHEMA INNODB_CMPMEM and INNODB_CMPMEM_RESET Tables ..................................................................................................................... 2495 20.28.3 The INFORMATION_SCHEMA INNODB_TRX Table ........................................ 2496 20.28.4 The INFORMATION_SCHEMA INNODB_LOCKS Table .................................... 2497 20.28.5 The INFORMATION_SCHEMA INNODB_LOCK_WAITS Table .......................... 2498 20.28.6 The INFORMATION_SCHEMA INNODB_BUFFER_PAGE Table ........................ 2499 20.28.7 The INFORMATION_SCHEMA INNODB_BUFFER_PAGE_LRU Table ................ 2500 20.28.8 The INFORMATION_SCHEMA INNODB_BUFFER_POOL_STATS Table ............. 2500 20.29 INFORMATION_SCHEMA Tables for MySQL Clus