MySQL Workbench

Abstract

This is the MySQL™ Workbench Reference Manual. It documents the MySQL Workbench Community and MySQL Workbench Commercial Editions 8.0 through 8.0.19.

If you have not yet installed the MySQL Workbench Community Edition, please download your free copy from the download site. The MySQL Workbench Community Edition is available for Microsoft Windows, macOS, and Linux.

For notes detailing the changes in each release, see the MySQL Workbench Release Notes.

For legal information, see the Legal Notices.

For help with using MySQL, please visit the MySQL Forums, where you can discuss your issues with other MySQL users.

Licensing information.  This product may include third-party software, used under license. If you are using MySQL Workbench Commercial Editions, see the MySQL Workbench Commercial License Information User Manual for licensing information, including licensing information relating to third-party software that may be included in this Commercial Edition release. If you are using the MySQL Workbench Community Edition, see the MySQL Workbench Community License Information User Manual for licensing information, including licensing information relating to third-party software that may be included in this Community Edition release.

Document generated on: 2020-03-27 (revision: 65507)

Table of Contents

Preface and Legal Notices
1 General Information
1.1 What Is New in MySQL Workbench
1.1.1 New in MySQL Workbench 8.0 Release Series
1.1.2 New in MySQL Workbench 6.0 Release Series
1.2 MySQL Workbench Editions
2 Installation
2.1 System Requirements
2.2 Command-Line Options
2.3 MySQL Workbench on Windows
2.3.1 Installing
2.3.2 Launching
2.3.3 Uninstalling
2.4 MySQL Workbench on Linux
2.4.1 Installing
2.4.2 Launching
2.4.3 Uninstalling
2.5 MySQL Workbench on macOS
2.5.1 Installing
2.5.2 Launching
2.5.3 Uninstalling
3 Configuration
3.1 User Accessibility Options
3.2 Workbench Preferences
3.2.1 General Editors Preferences
3.2.2 SQL Editor Preferences
3.2.3 Administration Preferences
3.2.4 Modeling Preferences
3.2.5 Fonts and Colors Preferences
3.2.6 SSH Preferences
3.2.7 Other Preferences
3.3 MySQL Workbench Settings and Log Files
3.4 Common Preferences and Configurations
4 Home Screen Tab
5 Connections in MySQL Workbench
5.1 Creating A New MySQL Connection (Simple)
5.2 Creating A New MySQL Connection (Tutorial)
5.3 Manage Server Connections
5.3.1 Standard TCP/IP Connection Method
5.3.2 Local Socket/Pipe Connection Method
5.3.3 Standard TCP/IP over SSH Connection Method
5.3.4 SSL Wizard (Certificates)
5.3.5 Remote Management
5.3.6 System Profile
5.3.7 Configure Server Management Wizard
5.3.8 The Password Storage Vault
5.3.9 Updating Old Authentication Protocol Passwords
5.4 Client Connections
6 Administrative Tasks
6.1 Server Administration
6.1.1 Server Logs
6.1.2 Service Control
6.1.3 Configuration (Options File)
6.2 Users and Privileges
6.3 Server Status
6.4 Status and System Variables
6.5 Data Export and Import
6.5.1 Table Data Export and Import Wizard
6.5.2 SQL Data Export and Import Wizard
6.5.3 Result Data Export and Import
6.6 MySQL Audit Inspector Interface
6.7 MySQL Enterprise Backup Interface
6.7.1 General Requirements
6.7.2 Online Backup
6.7.3 Backup Recovery
6.8 MySQL Enterprise Firewall Interface
6.9 wbcopytables Utility
7 Performance Tools
7.1 Performance Dashboard
7.2 Performance Schema Reports
7.3 Query Statistics
7.4 Visual Explain Plan
7.5 Tutorial: Using Explain to Improve Query Performance
8 Database Development
8.1 Visual SQL Editor
8.1.1 SQL Query Tab
8.1.2 SQL Query Toolbar
8.1.3 Query and Edit Menus
8.1.4 Result Grid
8.1.5 SQL Additions - Snippets Tab
8.1.6 SQL Additions - Context Help Tab
8.1.7 Output Panel
8.1.8 Table Data Search Tab
8.1.9 Export or Import a Table
8.1.10 MySQL Table Editor
8.1.11 Code Generation Overview
8.2 Object Management
8.2.1 Object Browser and Editor Navigator
8.2.2 Session and Object Information Panel
8.2.3 Schema and Table Inspector
9 Database Design and Modeling
9.1 Modeling Interface
9.1.1 Model Editor
9.1.2 EER Diagram Editor
9.1.3 Creating Tables
9.1.4 Creating Foreign Key Relationships
9.1.5 Creating Views
9.1.6 Creating Routines and Routine Groups
9.1.7 Creating Layers
9.1.8 Creating Notes
9.1.9 Creating Text Objects
9.1.10 Creating Images
9.2 Additional Modeling Tools
9.2.1 Printing Diagrams
9.2.2 DBDoc Model Reporting
9.2.3 Schema Validation Plugins
9.3 Modeling Tutorials
9.3.1 Creating a Model
9.3.2 Basic Modeling
9.3.3 Importing a Data Definition SQL Script
9.3.4 Using the Default Schema
9.3.5 Documenting the sakila Database
9.4 Forward and Reverse Engineering
9.4.1 Forward Engineering
9.4.2 Reverse Engineering
9.5 Schema Synchronization and Comparison
9.5.1 Database Synchronization
9.5.2 Compare and Report Differences in Catalogs
9.6 Table Templates
9.7 Customizing DBDoc Model Reporting Templates
9.7.1 Supported Template Markers
9.7.2 Creating a Custom Template
10 Database Migration Wizard
10.1 General Installation Requirements
10.1.1 ODBC Libraries
10.1.2 ODBC Drivers
10.2 Migration Overview
10.2.1 A Visual Guide to Performing a Database Migration
10.2.2 Migrating from Supported Databases
10.2.3 Migrating from Unsupported (Generic) Databases
10.3 Conceptual DBMS Equivalents
10.4 Microsoft Access Migration
10.5 Microsoft SQL Server Migration
10.5.1 Preparations
10.5.2 Drivers
10.5.3 Connection Setup
10.5.4 Microsoft SQL Server Type Mapping
10.6 PostgreSQL migration
10.6.1 Preparations
10.6.2 Drivers
10.6.3 Connection Setup
10.6.4 PostgreSQL Type Mapping
10.7 MySQL Migration
10.8 Using the MySQL Workbench Migration Wizard
10.8.1 Connecting to the Databases
10.8.2 Schema Retrieval and Selection
10.8.3 Reverse Engineering
10.8.4 Object Selection
10.8.5 Migration
10.8.6 Manual Editing
10.8.7 Target Creation Options
10.8.8 Schema Creation
10.8.9 Create Target Results
10.8.10 Data Transfer and Migration Setup
10.8.11 Bulk Data Transfer
10.8.12 Migration Report
10.9 MySQL Workbench Migration Wizard FAQ
A MySQL Workbench Frequently Asked Questions
B Keyboard Shortcuts
C Extending Workbench
C.1 GRT and Workbench Data Organization
C.2 Modules
C.3 Plugins and Tools
C.4 Adding a GUI to a Plugin Using MForms
C.5 The Workbench Scripting Shell
C.5.1 Exploring the Workbench Scripting Shell
C.5.2 The Shell Window
C.5.3 Files, Globals, Classes, Modules, and Notifications Tabs
C.6 Tutorial: Writing Plugins
C.6.1 Tutorial: Generate PHP Code to Create a Connection with PDO_MySQL
C.6.2 Tutorial: Generating Foreign Keys with MyISAM
D How To Report Bugs or Problems
E MySQL Enterprise Features
F MySQL Utilities