MySQL. Библиотека профессионала - Аткинсон Л

322 Глава Утилиты командной строки

( S файл)

Этаопциязадаетпуть используемомудля подключения клокальномусерверу.

Эта опция задает суффикс имени архивного каталога (по умолчанию

имя)

Эта опция задает имя указываемое при подключении к базе данных.

Эта утилита представляет собой оболочку инструкции LOAD DATA INFILE. Син таксис ее вызова таков:

mysqlimport

I с

I С]

I конфигурация]

|

	force I
	I
	|		узел]
	|
	|
	lock tables	|	1]
	|	Р	|
	|
	| s]	\	S файл]
	|
			имя]

V]

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

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

Полный список утилит 323

( С

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

( C)

При наличии этой опции утилита будет сжимать данные, передаваемые от клиента к серверу.

конфигурация)

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

При наличии этой опции таблица будет очищена перед импортом данных.

Эта опция задает символ, применяемый для выделения полей.

Эта опция задает символ, применяемый для отмены специального назначения управляющих символов.

Эта опция задает символ, применяемый для выделения строковых полей.

Эта опция задает символ разделитель полей.

Эта опция заставляет утилиту продолжать процесс заполнения таблиц даже в слу чае возникновения ошибки.

При наличии этой выдается описание синтаксиса командной строки, а все остальные опции игнорируются.

324 Глава Утилиты командной строки

узел)

Эта опция задает узел, к которому попытается подключиться утилита. В качестве аргумента может присутствовать доменное имя или IP адрес.

Эта опция заставляет утилиту игнорировать входные записи, которые дублируют существующиезаписи.

Эта опция задает символ разделитель строк.

( L)

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

( I)

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

Эта опция задерживает процедуру импорта до тех пор, пока не будут завершены все операции чтения таблиц.

[=пароль]

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

( P порт)

Эта опция переопределяет стандартный номер порта, с которым работает утилита (по умолчанию —3306).

Эта опция заставляет утилиту замещать существующие записи записями импорти руемого файла.

Эта опция подавляет вывод на экран любых данных, кроме сообщений об ошибках.

Полный список утилит 325

( S файл)

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

имя)

Эта опция задает имя пользователя, указываемое при регистрации на сервере.

Эта опция заставляет утилиту выдавать более подробные комментарии.

( V)

При наличииэтой опции возвращается лишь информация о версии утилиты.

Эта утилита представляет собой оболочку инструкций SHOW DATABASES, SHOW TABLES и SHOW COLUMNS. Синтаксис ее вызова таков:

mysqlshow

I С]

I конфигурация]

|

| узел]

keys |

|

|

| файл]

I

| файл]

I v]

| V]

[таблица

Утилита возвращает информацию о базах данных и таблицах. При отсутствии ар гументов будет выдан список баз данных. Если указано имя базы данных, утилита вер нет список содержащихся в ней таблиц. В имени таблицы могут присутствовать мета символы что позволяет фильтровать списоктаблиц.

Если указана отдельная будет выдана информация о ее столбцах. В спе цификации столбца тоже могут стоять метасимволы.

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

( C)

При наличииэтой опции утилита будет сжимать данные, передаваемые от клиента к серверу.

326 Глава Утилиты командной строки

конфигурация)

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

При наличии этойопции выдается лишь описание синтаксиса командной строки, а все остальные опции игнорируются,

узел)

Эта опция задает узел, к которому попытается подключиться утилита. В качестве аргумента может присутствовать доменное имя или IP адрес.

При наличии этойопции выдается информация об индексах таблиц.

[=пароль]

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

( P порт)

Эта опция переопределяет стандартный номер порта, с которым работает утилита (поумолчанию—3306).

( S файл)

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

При наличии этой опции выдается дополнительная информация о таблицах.

файл)

Эта опция задает имя пользователя, указываемое при регистрации на сервере.

Эта опция заставляет утилиту выдавать более подробные комментарии.

Полный список утилит 327

( V)

При наличии этой опции возвращается лишь информация о версии утилиты.

Эта утилита упаковывает таблицы ISAM точно так же, как это делает утилита в отношении таблиц

Эта утилита возвращает описание числового кода ошибки. Формат ее вызова таков:

реггог

I	| I I
|
I
|	V]

С помощью утилиты реггог можно преобразовывать коды ошибок в сообщения об ошибках (листинг 14.15).

реггог
Error code	1:	Operation not permitted
Error code	2:	No such file or directory
Error code	3:	No such process
Error code		Interrupted system call
Error code	5:	Input/output error

При наличии этой опции выдается лишь описание синтаксиса командной строки, а все остальные опции игнорируются.

При наличииэтой опции будет выдано лишь описание ошибки.

—verbose

Эта опция заставляет утилиту выдавать более подробные комментарии.

( V)

При наличии этой опции возвращается лишь о версии утилиты.

328 Глава Утилиты командной строки

replace

Эта утилита предназначена для замены строк в текстовых файлах. Ее синтаксис таков:

replaced

|

шаблон замена [шаблон

файл

Утилита меняет одну строку на другую. Можно задавать сразу несколько команд замены. По умолчанию текст читается из потока и записывается в поток но опция — позволяетуказывать список файлов для замены.

В табл. 14.5 описаны специальные коды, используемые в шаблонах.

Код	Описание
\	Начало строки
	Конец строки
\Ь	Пробел, начало строки или конец строки

В листинге 14.16 обычные SQL комментарии заменяются комментариями в стиле

MySQL.

replace

I

При наличии этой опции выдается лишь описание синтаксиса командной строки, а все остальные опции игнорируются.

S

Эта опцияподавляет вывод на экран любых данных, кроме сообщений об ошибках.

V

Эта опция заставляет утилиту выдавать более подробные сообщения.

Полный список утилит 329

Этот сценарий запускает демон и контролирует его перезапуск в случае сбоя. Именно такой способ вызова программы MySQL рекомендуется в UNIX системах. Сценарий в первую очередь ищет утилиту и только если она не найдена, запускается обычный демон mysqld. Сначала поиск ведется в текущем ка а затем — в системных каталогах.

Все опции, указанные в командной строке, передаются демону MySQL. Параметры самого сценария safe_mysqld (перечислены ниже) задаются в конфигурационном файле.

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

Эта опция задает путевое имя глобального конфигурационного файла.

Эта опция задает путевое имя журнала ошибок. В него включается информация о демоне mysqld, которую сам демон не смог сообщить, например сообщения о не удачных попытках запуска.

Эта опция задает каталог, в котором находится демон mysqld или mysqld max.

Эта опция позволяет идентифицировать исполняемый файл сервера MySQL по суффиксу. Например, установка означает запуск файла mysqld max. Пустая строка соответствует демону mysqld.

Эта опция задает имя исполняемого файла в каталоге, который указан в опции

no defaults

Эта опция отключаетконфигурационные файлы.

Эта опция задает максимальное число файлов mysqld, которые быть откры ты одновременно. Чтобы данная опция работала правильно, сценарий должен быть запущен от имени пользователя root.

БИБЛИОТЕКА

ФУНКЦИЙ ЯЗЫКА С

этой

Типы данных Клиентские функции

Функции работы с массивами Функции работы с наборами символов Функции работы с файлами Функции обработки ошибок Функции работы с Функции работы со списками

Функции управления памятью Функции работы с опциями Функции обработки паролей Функции обработки строк Функции работы с потоками

состав MySQL входит и библиотека функций языка С. Она предназначена для написания программ, взаимодействующих с сервером баз данных. В сочетании с библиотекой эта библиотека используется большинством ути

лит дистрибутива MySQL. Библиотеки других языков представляют собой оболочки библиотеки языка С.

Клиентская библиотека содержит также универсальные функции обработки мас сивов и строк, упрощающие взаимодействие с сервером. Их списки приведены в кон це главы.

Типы данных

В клиентской библиотеке определен ряд типов данных. Большинство соответст вующих структур объявлено в файле Существуют также функции, предназначенные для извлечения информации из этих структур.

MYSQL	\

Эта структура описывает сеанс подключения к серверу баз данных. Ее поля пере числены в табл. 15.1.

Поле		Хранимая
NETnet		Параметры взаимодействия
		Дескриптор файла для протокола SSL
char	*host	Адрес узла