percona-toolkitp - Интернет в облаке

ПРОГРАММА:

ИМЯ

percona-toolkit - Расширенные инструменты командной строки для MySQL

ОПИСАНИЕ

Percona Toolkit - это набор расширенных инструментов командной строки, используемых Percona.
(<http://www.percona.com/>) обслуживающий персонал для выполнения различных MySQL и системных задач
которые слишком сложны или сложны для выполнения вручную.

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

Percona Toolkit является производным от Maatkit и Aspersa, двух наиболее известных наборов инструментов для
Администрирование сервера MySQL. Он разработан и поддерживается Percona. Для большего
информацию и другое бесплатное программное обеспечение с открытым исходным кодом, разработанное Percona, посетите
<http://www.percona.com/software/>.

ИНСТРУМЕНТЫ

Этот выпуск Percona Toolkit включает следующие инструменты:

pt-выравнивание
Выровняйте выходные данные других инструментов по столбцам.

pt-архиватор
Архивировать строки из таблицы MySQL в другую таблицу или файл.

pt-config-diff
Различайте файлы конфигурации MySQL и переменные сервера.

pt-тупик-регистратор
Регистрируйте тупиковые ситуации MySQL.

пт-дискстатс
Интерактивный инструмент мониторинга ввода-вывода для GNU / Linux.

pt-дубликат-ключ-проверка
Найдите повторяющиеся индексы и внешние ключи в таблицах MySQL.

пт-фифо-сплит
Разделяйте файлы и конвейерные линии в формате FIFO без разделения.

pt-найти
Найдите таблицы MySQL и выполните действия, подобные поиску GNU.

pt-отпечаток пальца
Преобразуйте запросы в отпечатки пальцев.

pt-fk-журнал ошибок
Зарегистрируйте ошибки внешнего ключа MySQL.

pt-сердцебиение
Следите за задержкой репликации MySQL.

pt-index-использование
Прочтите запросы из журнала и проанализируйте, как они используют индексы.

pt-ioпрофиль
Наблюдайте за процессом ввода-вывода и распечатайте таблицу файлов и операций ввода-вывода.

пт-убийство
Убейте запросы MySQL, соответствующие определенным критериям.

pt-mex
Взгляните на множество примеров MySQL "SHOW GLOBAL STATUS" бок о бок.

pt-mysql-сводка
Красиво резюмируйте информацию MySQL.

pt-онлайн-схема-изменение
ALTER таблицы, не блокируя их.

пт-пмп
Совокупные трассировки стека GDB для выбранной программы.

pt-запрос-дайджест
Анализируйте запросы MySQL из журналов, списка процессов и tcpdump.

пт-шоу-гранты
Канонизируйте и распечатайте гранты MySQL, чтобы вы могли эффективно воспроизводить, сравнивать и
контролировать их версии.

пт-просеять
Просматривает файлы, созданные pt-stalk.

pt-раб-задержка
Сделайте подчиненный сервер MySQL отставанием от своего главного.

pt-slave-найти
Найдите и распечатайте дерево иерархии репликации ведомых устройств MySQL.

pt-slave-перезагрузка
Наблюдайте и перезапускайте репликацию MySQL после ошибок.

pt-стебель
Собирайте криминалистические данные о MySQL при возникновении проблем.

pt-резюме
Красиво резюмируйте системную информацию.

pt-table-контрольная сумма
Проверьте целостность репликации MySQL.

pt-таблица-синхронизация
Эффективно синхронизируйте данные таблицы MySQL.

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

pt-обновление
Убедитесь, что результаты запроса идентичны на разных серверах.

советник-переменная pt
Проанализируйте переменные MySQL и сообщите о возможных проблемах.

пт-визуально-объяснять
Отформатируйте вывод EXPLAIN в виде дерева.

Чтобы узнать больше о бесплатном программном обеспечении с открытым исходным кодом, разработанном Percona, посетите
<http://www.percona.com/software/>.

SPECIAL ВАРИАНТ ВИДЫ

В параметрах инструмента используются стандартные типы ("int", "string" и т. Д.), А также следующие специальные типы:

время
Значения времени по умолчанию - секунды. Например, «--run-time 60» означает 60 секунд.
Значения времени поддерживают необязательный суффикс: s (секунды), m (минуты), h (часы), d (дни).
«--run-time 1m» означает 1 минуту (то же самое, что и 60 секунд).

размер
Значения размера по умолчанию - байты. Например, «--disk-space-free 1024» означает 1
Кибибайт. Значения размера поддерживают необязательный суффикс: k (Кибибайт), M (Мебибайт), G.
(Гибибайт).

DSN См. «ТЕХНИЧЕСКИЕ ХАРАКТЕРИСТИКИ DSN (ИМЯ ИСТОЧНИКА ДАННЫХ)».

Хеш, хеш, массив, массив
Значения хэша, хэша, массива и массива представляют собой списки значений, разделенные запятыми. Например,
"--ignore-tables foo, bar" игнорирует таблицы "foo" и "bar".

КОНФИГУРАЦИЯ FILES

Инструменты Percona Toolkit могут считывать параметры из файлов конфигурации. Файл конфигурации
синтаксис прост и понятен и имеет некоторое сходство с клиентом командной строки MySQL.
инструменты. Все файлы конфигурации следуют одним и тем же соглашениям.

На самом деле происходит то, что строки считываются из файла, а затем добавляются
в качестве параметров командной строки и аргументов инструмента, так что просто подумайте о конфигурации
файлы как способ написания ваших командных строк.

СИНТАКСИС
Синтаксис файлов конфигурации следующий:

· Пробел, за которым следует знак решетки (#), означает, что остальная часть строки является
комментарий. Это удалено. Например:

· Пробелы удаляются в начале и в конце всех строк.

· Пустые строки игнорируются.

· Каждая строка может быть в любом из следующих форматов:

вариант
option = значение

Не ставьте перед параметром префикс «-». Не заключайте значения в кавычки, даже если в них есть пробелы;
значение буквальное. Пробелы вокруг знака равенства удаляются во время обработки.

· Распознаются только длинные опционы.

· Строка, содержащая всего два дефиса, сигнализирует об окончании разбора опции. Любые дальнейшие
строки интерпретируются как дополнительные аргументы (не опции) программы.

ПРИМЕР
Этот файл конфигурации для pt-stalk,

# Конфиг для pt-stalk
переменная = Threads_connected
циклы = 2 # запускать, если проблема видна дважды подряд
--
--пользователь Дэниел

эквивалентно этой командной строке:

pt-stalk --variable Threads_connected --cycles 2 - --user Дэниел

Опции после «-» передаются буквально в mysql и mysqladmin.

ЧИТАТЬ ЗАКАЗАТЬ
Инструменты читают несколько файлов конфигурации по порядку:

1. Глобальный файл конфигурации Percona Toolkit,
/etc/percona-toolkit/percona-toolkit.conf. Все инструменты читают этот файл, поэтому вам следует
добавляйте к нему только те параметры, которые вы хотите применить ко всем инструментам.

2. Глобальный файл конфигурации для конкретного инструмента, /etc/percona-toolkit/TOOL.conf, Где
«ИНСТРУМЕНТ» - это такое название инструмента, как «pt-query-digest». Этот файл назван в честь конкретного
инструмент, который вы используете, поэтому вы можете добавлять параметры, которые применяются только к этому инструменту.

3. Собственный файл конфигурации Percona Toolkit пользователя, $ HOME / .percona-toolkit.conf. Все
инструменты читают этот файл, поэтому вам следует добавлять к нему только те параметры, которые вы хотите применить к
все инструменты.

4. Файл конфигурации для конкретного инструмента пользователя, $ HOME / .TOOL.conf, где "ИНСТРУМЕНТ" - это инструмент
назовите как "pt-query-digest". Этот файл назван в честь конкретного инструмента, который вы используете,
так что вы можете добавить параметры, применимые только к этому инструменту.

УКАЗАНИЕ
Есть специальная опция "--config", которая позволяет указать, какие файлы конфигурации
Percona Toolkit следует прочитать. Вы указываете список файлов, разделенных запятыми. Однако его
поведение не похоже на другие параметры командной строки. Это должно быть дано первый по команде
линии, перед любыми другими вариантами. Если вы попытаетесь указать его где-нибудь еще, это вызовет
ошибка. Также нельзя указать "--config = / путь / к / файлу"; вы должны указать опцию и
путь к файлу через пробел без an равный подпись между ними, например:

--config / путь / к / файлу

Если вам вообще не нужны файлы конфигурации, укажите "--config ''", чтобы
пустой список файлов.

DSN (ДАННЫЕ ИСТОЧНИК ИМЯ) ХАРАКТЕРИСТИКИ

Инструменты Percona Toolkit используют DSN, чтобы указать, как создать соединение DBD с MySQL.
сервер. DSN - это разделенная запятыми строка, состоящая из частей «ключ = значение», например:

h = host1, P = 3306, u = bob

Стандартные ключевые части показаны ниже, но некоторые инструменты добавляют дополнительные ключевые части. Увидеть каждый
документацию инструмента для деталей.

Некоторые инструменты не используют DSN, но все же подключаются к MySQL с помощью таких параметров, как "--host",
«--пользователь» и «--пароль». Такие инструменты используют эти параметры для автоматического создания DSN,
за кулисами.

Другие инструменты используют как DSN, так и параметры, подобные приведенным выше. Параметры предоставляют значения по умолчанию
для всех DSN, которые не указывают соответствующую ключевую часть опции. Например, если DSN
указываются "h = host1" и опция "--port = 12345", затем инструмент автоматически добавляет
«P = 12345» на DSN.

ПОБЕГ ЦЕННОСТИ:
DSN обычно указываются в командной строке, поэтому кавычки и экранирование оболочки должны быть
учтено. Специальные символы, такие как звездочка ("*"), необходимо заключать в кавычки и / или
правильно экранированы, чтобы передаваться как буквальные символы в значениях DSN.

Поскольку части DSN разделяются запятыми, буквальные запятые в значениях DSN должны быть экранированы с помощью
одинарная обратная косая черта ("\"). А поскольку обратная косая черта является escape-символом для большинства оболочек,
две обратные косые черты необходимы, чтобы передать буквальную обратную косую черту. Например, если имя пользователя
буквально «мое, имя», в большинстве оболочек оно должно быть указано как «мое \\, имя». Это относится к
DSN и параметры, связанные с DSN, такие как "--user".

KEY ЧАСТЕЙ
Многие инструменты добавляют дополнительные части к DSN для специальных целей, а иногда и переопределяют
части, чтобы заставить их делать что-то немного другое. Однако все инструменты поддерживаются на
как минимум следующее:

Набор символов по умолчанию для соединения («УСТАНОВИТЬ ИМЕНА»).

Включает настройки набора символов в Perl и MySQL. Если значение равно "utf8", устанавливает Perl's
binmode на STDOUT в utf8, передает параметр mysql_enable_utf8 в DBD :: mysql и
запускает "SET NAMES 'utf8'" после подключения к MySQL. Другие значения устанавливают binmode на STDOUT
без уровня utf8 и запустите «SET NAMES» после подключения к MySQL.

К сожалению, внутри самого Perl нет возможности указать клиентскую библиотеку.
набор символов. «УСТАНОВИТЬ ИМЕНА» влияет только на сервер; если настройки клиентской библиотеки
не совпадают, могут быть проблемы. Вы можете использовать файл по умолчанию, чтобы указать
набор символов клиентской библиотеки, однако. См. Описание части F. ниже.

D База данных по умолчанию для использования при подключении. Инструменты могут "ИСПОЛЬЗОВАТЬ" разные базы данных, пока
работает.

F Файл по умолчанию для клиентской библиотеки MySQL (клиентская библиотека C, используемая DBD :: mysql,
Percona Инструментарий саму трезвость). Все инструменты читаются в разделе «[клиент]» внутри
файл по умолчанию. Если вы его опустите, стандартные файлы по умолчанию будут прочитаны в
обычный порядок. "Стандартный" варьируется от системы к системе, потому что имена файлов для чтения
скомпилированы в клиентскую библиотеку. Например, в системах Debian обычно
"/etc/mysql/my.cnf" затем "~ / .my.cnf". Если вы поместите следующее в"~ / .my.cnf", ты
не нужно будет указывать свое имя пользователя и пароль MySQL в командной строке:

[Клиент]
user = your_user_name
pass = секрет

Пропуск части F обычно является правильным решением. Пока вы настроили
ваш "~ / .my.cnf"правильно, это приведет к автоматическому подключению инструментов без
требуется имя пользователя или пароль.

Вы также можете указать набор символов по умолчанию в файле значений по умолчанию. В отличие от "А"
части, описанной выше, это фактически проинструктирует клиентскую библиотеку (DBD :: mysql) о необходимости
изменить набор символов, который он использует внутри, что не может быть выполнено никаким другим
пути.

h Имя хоста MySQL или IP-адрес для подключения.

L Явно разрешите LOAD DATA LOCAL INFILE.

По какой-то причине некоторые поставщики компилируют libmysql без --enable-local-infile
опция, которая отключает инструкцию. Это может привести к странным ситуациям, например,
сервер разрешает LOCAL INFILE, но клиент выбрасывает исключения, если он используется.

Однако, пока сервер разрешает ЗАГРУЗИТЬ ДАННЫЕ, клиенты могут легко повторно включить ее; видеть
а также
<http://search.cpan.org/~capttofu/DBD-mysql/lib/DBD/mysql.pm>. Этот вариант делает
именно это.

p Пароль MySQL для использования при подключении.

P Номер порта для подключения. Обратите внимание, что обычное поведение в особых случаях
применить: если вы укажете "localhost" в качестве имени хоста в системах Unix, соединение
фактически использует файл сокета, а не соединение TCP / IP, и, таким образом, игнорирует порт.

S Файл сокета MySQL, используемый для подключения (в системах Unix).

u Имя пользователя MySQL для использования при подключении, если это не текущий пользователь системы.

СЛОВА
Многие инструменты позволяют указать DSN в виде одного слова без какого-либо «ключ = значение».
синтаксис. Это называется «голым словом». Как это делается, зависит от инструмента, но это
обычно интерпретируется как часть "h". Вывод инструмента "--help" сообщит вам
поведение для этого инструмента.

РАСПРОСТРАНЕНИЕ
Многие инструменты позволяют передавать значения от одного DSN к другому, поэтому вам не нужно
укажите все части для каждого DSN. Например, если вы хотите указать имя пользователя и
пароль для каждого DSN, вы можете подключиться к трем хостам следующим образом:

h = host1, u = fred, p = wilma host2 host3

Это зависит от инструмента.

ОКРУЖАЮЩАЯ СРЕДА

Переменная среды «PTDEBUG» включает вывод подробной отладки в STDERR. Включить
отладку и запись всего вывода в файл, запустите инструмент, например:

PTDEBUG = 1 контрольная сумма pt-таблицы ...> ФАЙЛ 2> & 1

Будьте осторожны: вывод отладки очень объемный и может генерировать несколько мегабайт вывода.

СИСТЕМА ТРЕБОВАНИЯ

Для большинства инструментов требуются:

· Perl v5.8 или новее

· Bash v3 или новее

· Основные модули Perl, такие как Time :: HiRes

Инструменты, которые подключаются к MySQL, требуют:

· Модули Perl DBI и DBD :: mysql

· MySQL 5.0 или новее

Percona Toolkit официально поддерживает и протестирован на многих популярных дистрибутивах Linux и
MySQL с 5.0 по 5.6; видеть http://goo.gl/srHm7 для списка поддерживаемых платформ и
версий.

Используйте percona-toolkitp онлайн с помощью сервисов onworks.net