MySQL Workbench Abstract This is the MySQL Workbench Reference Manual. It documents the MySQL Workbench Community and MySQL Workbench Commercial releases for versions 8.0 through 8.0.26. If you have not yet installed the MySQL Workbench Community release, please download your free copy from the download site. The MySQL Workbench Community release is available for Microsoft Windows, macOS, and Linux. MySQL Workbench platform support evolves over time. For the latest platform support information, see https:// www.mysql.com/support/supportedplatforms/workbench.html. For notes detailing the changes in each release, see the MySQL Workbench Release Notes. For legal information, including licensing information, see the Preface and Legal Notices. For help with using MySQL, please visit the MySQL Forums, where you can discuss your issues with other MySQL users. Document generated on: 2021-10-01 (revision: 70942) Table of Contents Preface and Legal Notices ................................................................................................................ vii 1 General Information ......................................................................................................................... 1 1.1 What Is New in MySQL Workbench ...................................................................................... 1 1.1.1 New in MySQL Workbench 8.0 Release Series ........................................................... 1 1.1.2 New in MySQL Workbench 6.0 Release Series ........................................................... 6 1.2 MySQL Workbench Editions ................................................................................................ 53 2 Installation ..................................................................................................................................... 55 2.1 System Requirements ......................................................................................................... 55 2.2 Command-Line Options ...................................................................................................... 57 2.3 MySQL Workbench on Windows ......................................................................................... 57 2.3.1 Installing .................................................................................................................. 57 2.3.2 Launching ................................................................................................................ 58 2.3.3 Uninstalling .............................................................................................................. 59 2.4 MySQL Workbench on Linux ............................................................................................... 59 2.4.1 Installing .................................................................................................................. 59 2.4.2 Launching ................................................................................................................ 62 2.4.3 Uninstalling .............................................................................................................. 63 2.5 MySQL Workbench on macOS ........................................................................................... 64 2.5.1 Installing .................................................................................................................. 64 2.5.2 Launching ................................................................................................................ 64 2.5.3 Uninstalling .............................................................................................................. 65 3 Configuration ................................................................................................................................. 67 3.1 User Accessibility Options ................................................................................................... 67 3.2 Workbench Preferences ...................................................................................................... 71 3.2.1 General Editors Preferences ..................................................................................... 72 3.2.2 SQL Editor Preferences ........................................................................................... 73 3.2.3 Administration Preferences ....................................................................................... 80 3.2.4 Modeling Preferences .............................................................................................. 81 3.2.5 Fonts and Colors Preferences .................................................................................. 86 3.2.6 SSH Preferences ..................................................................................................... 87 3.2.7 Other Preferences .................................................................................................... 89 3.3 MySQL Workbench Settings and Log Files .......................................................................... 90 3.4 Common Preferences and Configurations ............................................................................ 92 4 Home Screen Tab ......................................................................................................................... 95 5 Connections in MySQL Workbench ................................................................................................ 99 5.1 Creating A New MySQL Connection (Simple) ...................................................................... 99 5.2 Creating A New MySQL Connection (Tutorial) .................................................................... 100 5.3 Manage Server Connections ............................................................................................. 111 5.3.1 Standard TCP/IP Connection Method ...................................................................... 113 5.3.2 Local Socket/Pipe Connection Method .................................................................... 115 5.3.3 Standard TCP/IP over SSH Connection Method ...................................................... 116 5.3.4 SSL Wizard (Certificates) ....................................................................................... 118 5.3.5 Remote Management ............................................................................................. 122 5.3.6 System Profile ....................................................................................................... 123 5.3.7 Configure Server Management Wizard .................................................................... 124 5.3.8 The Password Storage Vault .................................................................................. 127 5.3.9 Updating Old Authentication Protocol Passwords ..................................................... 127 5.4 Client Connections ............................................................................................................ 130 6 Administrative Tasks .................................................................................................................... 135 6.1 Server Administration ........................................................................................................ 135 6.1.1 Server Logs ........................................................................................................... 137 iii MySQL Workbench 6.1.2 Service Control ...................................................................................................... 138 6.1.3 Configuration (Options File) .................................................................................... 139 6.2 Users and Privileges ......................................................................................................... 140 6.3 Server Status ................................................................................................................... 143 6.4 Status and System Variables ............................................................................................ 144 6.5 Data Export and Import ..................................................................................................... 147 6.5.1 Table Data Export and Import Wizard ..................................................................... 148 6.5.2 SQL Data Export and Import Wizard ....................................................................... 156 6.5.3 Result Data Export and Import ............................................................................... 160 6.6 MySQL Audit Inspector Interface ....................................................................................... 161 6.7 MySQL Enterprise Backup Interface .................................................................................. 163 6.7.1 General Requirements ........................................................................................... 164 6.7.2 Online Backup ....................................................................................................... 166 6.7.3 Backup Recovery ................................................................................................... 169 6.8 MySQL Enterprise Firewall Interface .................................................................................. 173 6.9 wbcopytables Utility .......................................................................................................... 175 7 Performance Tools .....................................................................................................................