Глава 2. Установка

MySQL Workbench доступен для Windows, Linux и macOS.

Двоичные дистрибутивы MySQL Workbench доступны для предыдущих платформ. Дистрибутивы исходного кода также доступны как пакеты tar.gz или RPM.

MySQL Workbench доступен в https://dev.mysql.com/downloads/workbench/. Исходный код также есть на GitHub.

2.1. Системные требования

MySQL Workbench доступен в ряде операционных систем и платформ. Для получения информации о тех платформах, которые официально поддерживаются, см. https://www.mysql.com/support/supportedplatforms/workbench.html .

Общие требования

Общие требования и соображения, которые относятся ко всем операционным системам.

На запуске приложение проверяет версию OpenGL и выбирает между рендерингом программного и аппаратного обеспечения. Чтобы определить, какой метод используется, откройте меню Help, System Info.

Требования для Linux

Минимальные требования для Windows

Следующие предпосылки доступны в Microsoft Download Center:

2.2. Параметры командной строки

В дополнение к определенным для платформы параметрам командной строки у MySQL Workbench есть следующие параметры:

В Microsoft Windows параметры командной строки содержат одно тире вместо двух. Например, надо использовать -log-level в Microsoft Windows и --log-level в Linux и macOS.

2.3. MySQL Workbench в Windows

2.3.1. Установка

MySQL Workbench for Windows может быть установлен, используя MySQL Installer, который устанавливает и обновляет все продукты MySQL в Windows, или автономным пакетом Windows MSI Installer.

Установка MySQL Workbench, используя пакет Windows MSI Installer требует привилегий Administrator или Power User.

Минимальные требования для Windows

Следующие предпосылки доступны в Microsoft Download Center:

Установка через MySQL Installer

Общая загрузка MySQL Installer доступна в https://dev.mysql.com/downloads/windows/installer/. MySQL Installer может установить, модернизировать и управлять большинством продуктов MySQL, включая MySQL Workbench.

Это рекомендуемый подход

Управление всеми вашими продуктами MySQL, включая Workbench, через MySQL Installer является рекомендуемым подходом. Это грамотно обращается со всеми требованиями и предпосылками, конфигурациями и модернизациями.

Выполняя MySQL Installer, можно выбрать MySQL Workbench в качестве одного из продуктов, чтобы установить. Это выбрано по умолчанию и по существу выполняет автономный пакет MSI Installer, описанный в следующей секции.

Установка чкерез Windows MSI Installer

Автономная загрузка доступна в https://dev.mysql.com/downloads/workbench/.

MySQL Workbench может быть установлен, используя пакет Windows MSI Installer. Он носит имя mysql-workbench- community-version -winarch.msi, где version указывает на номер версии MySQL Workbench, а arch на архитектуру (winx64).

Следующая процедура требует привилегий Administrator или Power User.

  1. Чтобы поставить MySQL Workbench, щелкните правой кнопкой мыши по файлу MSI и выберите Install из всплывающего меню или дважды щелкните по файлу.

  2. В окне Setup Type можно выбрать Complete или Custom. Чтобы использовать все функции MySQL Workbench выбирайте Complete.

  3. Если вы не выбираете иное, MySQL Workbench устанавливается в C:\%PROGRAMFILES% \MySQL\MySQL Workbench 8.0 edition_type\, где %PROGRAMFILES% это каталог по умолчанию для программ. Каталог %PROGRAMFILES% определяется на большинстве систем как C:\Program Files\.

2.3.2. Запуск

Чтобы запустить MySQL Workbench в Windows, выберите Start, Programs, MySQL, затем нажмите на MySQL Workbench. Это выполнит файл MySQLWorkbench.exe.

Альтернативно, запустите MySQL Workbench из командной строки. Чтобы просмотреть доступные параметры командной строки, дайте команду MySQLWorkbench -help из каталога установки MySQL Workbench. Вы будете видеть следующий вывод:

MySQLWorkbench.exe [<options>] [<name of a model file or sql script>]

Options:
-swrendering Force the diagram canvas to use software rendering
             instead of OpenGL
-query [<connection>|<connection string>]
   Open a query tab and ask for connection if nothing is specified.
   If named connection is specified it will be opened, else connection
   will be created based on the given connection string, which should
   be in form <user>@<host>:<port>
-admin <instance> Open a administration tab to the named instance
-upgrade-mysql-dbs Open a migration wizard tab
-model <model file> Open the given EER model file
-script <sql file> Open the given SQL file in an connection, best in
                         conjunction with a query parameter
-run-script <file> Execute Python code from a file
-run <code>Execute the given Python code
-run-python <code> Execute the given Python code
-migration Open the Migration Wizard tab
-quit-when-done Quit Workbench when the script is done
-log-to-stderr Also log to stderr
-help, -h Show command line options and exit
-log-level=<level> Valid levels are:
           error, warning, info, debug1, debug2, debug3
-verbose, -v Enable diagnostics output
-version Show Workbench version number and exit
-open <file> Open the given file at startup
                   (deprecated, use script, model etc.)

Используйте -swrendering, если ваша видеокарта не поддерживает OpenGL 1.5. Опция -version может использоваться, чтобы показать номер версии MySQL Workbench.

MySQL Workbench может также быть запущен из MySQL Notifier, выбирая SQL Editor или Configure Instance из контекстного меню Notifier. Для получения дополнительной информации посмотрите MySQL Notifier.

2.3.3. Деинсталляция

Метод для того, чтобы деинсталлировать MySQL Workbench зависит от того, как вы его установили.

Удаление MySQL Workbench после установки, используя пакет инсталлятора

  1. Чтобы деинсталлировать MySQL Workbench, откройте Control Panel и выберите Add or Remove Programs. Найдите MySQL Workbench и нажмите Remove.

Если вы установили MySQL Workbench, используя пакет инсталлятора, невозможно удалить MySQL Workbench из командной строки. Хотя можно вручную удалить некоторые компоненты, нет никакого параметра командной строки для удаления MySQL Workbench.

Удаление каталога MySQL Workbench вручную не удалит все файлы, принадлежащие MySQL Workbench.

Удаление MySQL Workbench после установки из MySQL Installer

Откройте MySQL Installer for Windows, нажмите Remove MySQL Products, выберите MySQL Workbench и нажмите Execute.

Что не удалено

Деинсталлирование MySQL Workbench не удаляет ваш каталог конфигурации. Этот каталог включает ваши подключения MySQL, параметры конфигурации, файлы кэша, отрывки SQL и историю, журналы, модули и т.д. Эти файлы хранятся в каталоге %AppData% пользователя.

По умолчанию каталог конфигурации Workbench C:\username\AppData\Roaming\MySQL\Workbench\, где "C:\username\AppData\Roaming\" значение вашей системной переменной Windows %AppData%.

Кроме того, деинсталлирование не удаляет схему .mysqlworkbench, которую Workbench создает, разделяя отрывки SQL через подключение MySQL. Для получения дополнительной информации об общих отрывках посмотрите раздел 8.1.5.

2.4. MySQL Workbench в Linux

2.4.1. Установка

Есть двоичные дистрибутивы MySQL Workbench для нескольких вариантов Linux, включая Fedora, Oracle Linux и Ubuntu.

Опции инсталляции включают:

32-битные двоичные сборки недоступны после MySQL Workbench 6.2.0. Можно использовать исходный код, чтобы построить собственную 32-битную версию по мере необходимости.

Процедура установки на Linux зависит от того, который дистрибутив Linux вы используете.

Требования для Linux

Установка пакетов DEB

В Ubuntu и других системах, которые используют схему пакета Debian, можно загрузить и установить .deb пакеты или использовать диспетчер пакетов APT.

Используя диспетчер пакетов APT

Ваш дистрибутив Linux включает MySQL Workbench, где "apt-get install mysql-workbench" установит его из пакета MySQL Workbench. Чтобы использовать официальные сборки MySQL Workbench, необходимо установить официальное хранилище MySQL APT и выбрать пакет "mysql-workbench-community" вместо "mysql-workbench".

Ручная установка пакета

Вы устанавливаете MySQL Workbench, используя команду:

shell> sudo dpkg -i package.deb

package .deb это имя пакета MySQL Workbench, например, mysql-workbench-community- version1ubu1404-amd64.deb, где version это номер версии MySQL Workbench.

Вас можно предупредить, что определенные библиотеки недоступны, в зависимости от того, что вы уже установили. Установите необходимые библиотеки и затем установите пакет MySQL Workbench.

Установка пакетов RPM

На Red Hat-системах и других системах, которые используют формат пакета RPM, можно загрузить и установить пакеты RPM или использовать диспетчер пакетов Yum.

Системы Enterprise Linux, например, Oracle Linux и Red Hat, требуют доступа к хранилищу пакетов EPEL. Для получения дополнительной информации об установке EPEL посмотрите здесь.

Менеджер пакетов Yum

Ваш дистрибутив Linux включает сборку MySQL Workbench, где "yum install mysql-workbench" устанавливает свой пакет MySQL Workbench. Чтобы использовать официальную сборку MySQL Workbench, необходимо установить официальное хранилище MySQL Yum и выбрать пакет "mysql-workbench-community" вместо "mysql-workbench".

Ручная установка пакета

shell> sudo rpm -i package.rpm

package .rpm это имя пакета MySQL Workbench, например, mysql-workbench-community- version-1fc10.x86_64.rpm, где version это версия MySQL Workbench.

Установка в Oracle Enterprise Linux

MySQL Workbench требует доступа к хранилищу EPEL. EPEL это хранилище с дополнительными пакетами RPM, которые не являются частью основного дистрибутива RHEL/OEL. Это включает пакеты (такие как tinyxml), которые требует MySQL Workbench.

Необходимо настроить хранилище EPEL в yum, чтобы решить необходимые зависимости. Например, использование Oracle Linux 6.8:

shell> wget http://download.fedoraproject.org/pub/epel/6/i386/epel-release-6-8.noarch.rpm
shell> rpm -ivh epel-release-6-8.noarch.rpm
shell> yum repolist
Loaded plugins: refresh-packagekit, rhnplugin
repo idrepo namestatus
epel Extra Packages for Enterprise Linux 6 - x86_647,124

Эти инструкции также относятся к подобным дистрибутивам Linux, таким как Red Hat Enterprise Linux, CentOS и Scientific Linux.

Затем, следуйте основанной на RPM документации по установке пакетов RPM.

2.4.2. Запуск

После установки MySQL Workbench он может быть запущен выбором из меню Applications, Programming, MySQL Workbench.

MySQL Workbench может также быть запущен из командной строки в Linux:

shell> /usr/bin/mysql-workbench --help

Это покажет доступные параметры командной строки:

mysql-workbench [<options>] [<name of a model file or sql script>]
Options:
--force-sw-render Force Xlib rendering
--force-opengl-render Force OpenGL rendering
--query [<connection>|<connection string>]
    Open a query tab and ask for connection if nothing is specified.
    If named connection is specified it will be opened, else connection
    will be created based on the given connection string, which should
    be in form <user>@<host>:<port>
--admin <instance> Open a administration tab to the named instance
--upgrade-mysql-dbs Open a migration wizard tab
--model <model file> Open the given EER model file
--script <sql file> Open the given SQL file in an connection,
                          best in conjunction with a query parameter
--run-script <file> Execute Python code from a file
--run <code> Execute the given Python code
--run-python <code> Execute the given Python code
--migration Open the Migration Wizard tab
--quit-when-done Quit Workbench when the script is done
--log-to-stderr Also log to stderr
--help, -h Show command line options and exit
--log-level=<level> Valid levels are:
                error, warning, info, debug1, debug2, debug3
--verbose, -v Enable diagnostics output
--version Show Workbench version number and exit
--open <file> Open the given file at startup
                    (deprecated, use script, model etc.)

2.4.3. Удаление

Процедура того, чтобы деинсталлировать MySQL Workbench в Linux зависит от пакета, который вы используете.

Используя apt, официальное имя пакета с dev.mysql.com mysql-workbench-community, тогда как большинство дистрибутивов Linux использует имя mysql-workbench.

Удаление пакетов DEB

Чтобы деинсталлировать пакет Debian, используйте следующее:

shell> sudo apt-get remove mysql-workbench-community

Или, альтернативно:

shell> sudo dpkg -r mysql-workbench-community

Эта команда не удаляет конфигурационные файлы. Если вы хотите также удалить конфигурационные файлы, используйте эту команду:

shell> sudo dpkg --purge mysql-workbench-community

Удаление пакетов RPM

Используя yum, официальное имя пакета с dev.mysql.com mysql-workbench-community, тогда как большинство дистрибутивов Linux использует имя mysql-workbench.

Чтобы деинсталлировать пакет RPM, используйте эту команду:

shell> sudo yum remove mysql-workbench-community

Или, альтернативно:

shell> sudo rpm -e mysql-workbench-community

Эта команда не удаляет конфигурационные файлы.

Что не удалено

По умолчанию деинсталлирование MySQL Workbench не удаляет ваш каталог конфигурации, он включает ваши подключения MySQL, параметры конфигурации, файлы кэша, отрывки SQL и историю, журналы, модули и т.д. Эти файлы хранятся в вашем пользовательском каталоге .mysql/workbench/ .

По умолчанию каталог конфигурации Workbench это ~username/mysql/workbench/, где "~username" это путь к корневому каталогу вашего пользователя.

Кроме того, деинсталлирование Workbench не удаляет схему .mysqlworkbench, которую Workbench создает, разделяя отрывки SQL через подключение MySQL. Для получения дополнительной информации об общих отрывках посмотрите раздел 8.1.5.

2.5. MySQL Workbench в macOS

2.5.1. Установка

MySQL Workbench for macOS распространяется как файл DMG. Файл называют mysql-workbench-community- version-osx.dmg, где version это версия MySQL Workbench.

Загрузки доступны с https://dev.mysql.com/downloads/workbench/.

Чтобы установить MySQL Workbench в macOS, загрузите файл. Дважды щелкните по загруженному файлу. Вам покажут инсталляционное окно.

Рис. 2.1. MySQL Workbench в macOS: окно установки

Content is described in the surrounding text.

Тяните символ MySQL Workbench на Applications. MySQL Workbench установлен.

Можно теперь запустить MySQL Workbench из папки Applications или из командной строки:

shell> /Applications/MySQLWorkbench.app/Contents/MacOS/MySQLWorkbench --help

Это покажет доступные параметры командной строки:

MySQLWorkbench [<options>] [<name of a model file or sql script>]
Options:
--query [<connection>|<connection string>]
   Open a query tab and ask for connection if nothing is specified.
   If named connection is specified it will be opened,
   else connection will be created based on the given connection string,
   which should be in form <user>@<host>:<port>
--admin <instance> Open a administration tab to the named instance
--upgrade-mysql-dbs Open a migration wizard tab
--model <model file> Open the given EER model file
--script <sql file> Open the given SQL file in an connection, best in
                          conjunction with a query parameter
--run-script <file> Execute Python code from a file
--run <code> Execute the given Python code
--run-python <code> Execute the given Python code
--migration Open the Migration Wizard tab
--quit-when-done Quit Workbench when the script is done
--log-to-stderr Also log to stderr
--help, -h Show command line options and exit
--log-level=<level> Valid levels are:
                error, warning, info, debug1, debug2, debug3
--verbose, -v Enable diagnostics output
--version Show Workbench version number and exit
--open <file> Open the given file at startup
                    (deprecated, use script, model etc.)

2.5.2. Запуск

Чтобы запустить MySQL Workbench в macOS, откройте папку Applications в Finder, затем дважды щелкните по MySQL Workbench.

Также возможно запустить MySQL Workbench из командной строки:

shell> open MySQLWorkbench.app [options] [model_file]

Определение вариантов и/или файла модели дополнительно.

2.5.3. Удаление

Чтобы деинсталлировать MySQL Workbench for macOS, определите местонахождение MySQL Workbench в папке Applications, щелкните правой кнопкой мыши и выберите Move to Trash.

Что не удалено

По умолчанию деинсталлирование MySQL Workbench не удаляет ваш каталог конфигурации, он включает ваши подключения MySQL, параметры конфигурации, файлы кэша, отрывки SQL и историю, журналы, модули и т.д. Эти файлы хранятся в вашем пользовательском каталоге MySQL/Workbench/ .

По умолчанию каталог конфигурации Workbench это ~username/Library/Application Support/MySQL/Workbench, где "~username" это путь к корневому каталогу вашего пользователя.

Кроме того, деинсталлирование Workbench не удаляет схему .mysqlworkbench, которую Workbench создает, разделяя отрывки SQL через подключение MySQL. Для получения дополнительной информации об общих отрывках посмотрите раздел 8.1.5.