12.16. Разные Функции

DEFAULT(col_name)

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

mysql> UPDATE t SET i = DEFAULT(i)+1
                    WHERE id < 100;

FORMAT(X,D)

Форматирует число X к формату как '#,###,###.##', округленный к D десятичные разряды, и возвраты результат как строка. Для получения дополнительной информации см. Раздел 12.5, "Строковые функции".

GET_LOCK(str,timeout)

Попытки получить блокировку с именем, данным строкой str, использование тайм-аута timeout секунды. Возвраты 1 если блокировка была получена успешно, 0 если попытка, синхронизированная (например, потому что другой клиент ранее заблокировал имя), или NULL если ошибка произошла (такие как исчерпывание памяти, или поток был уничтожен с mysqladmin, уничтожают). Если Вам получили блокировку с GET_LOCK(), это выпускается, когда Вы выполняетесь RELEASE_LOCK(), выполните новое GET_LOCK(), или Ваше соединение завершается (или обычно или неправильно). Блокировки, полученные с GET_LOCK() не взаимодействуйте с транзакциями. Таким образом, фиксация транзакции не выпускает никакие подобные блокировки, полученные во время транзакции.

Эта функция может использоваться, чтобы реализовать блокировки приложения или моделировать блокировки записи. Имена блокируются на основе всего сервера. Если имя было заблокировано одним клиентом, GET_LOCK() блоки любой запрос другим клиентом для блокировки с тем же самым именем. Это включает клиентам, которые договариваются о данном имени блокировки, чтобы использовать имя, чтобы выполнить совместную консультативную блокировку. Но знайте, что это также включаете клиенту, который не является среди группы сотрудничающих клиентов, чтобы заблокировать имя, или непреднамеренно или сознательно, и таким образом препятствовать тому, чтобы любой из сотрудничающих клиентов блокировал то имя. Один способ уменьшить вероятность этого состоит в том, чтобы использовать имена блокировки, которые специфичны для базы данных или специализированы. Например, используйте имена блокировки формы db_name.str или app_name.str.

mysql> SELECT
                    GET_LOCK('lock1',10);        -> 1mysql> SELECT
                    IS_FREE_LOCK('lock2');        -> 1mysql> SELECT
                    GET_LOCK('lock2',10);        -> 1mysql> SELECT
                    RELEASE_LOCK('lock2');        -> 1mysql> SELECT
                    RELEASE_LOCK('lock1');        -> NULL

Второе RELEASE_LOCK() вызовите возвраты NULL потому что блокировка 'lock1' был автоматически выпущен вторым GET_LOCK() вызвать.

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

Эта функция опасна для основанной на операторе репликации. В MySQL 5.7 регистрируется предупреждение, если Вы используете эту функцию когда binlog_format устанавливается в STATEMENT. (Ошибка #47995)

INET_ATON(expr)

Учитывая представление точечной четверки адреса сети IPv4 как строка, возвращает целое число, которое представляет числовое значение адреса в сетевом порядке байтов (обратный порядок байтов). INET_ATON() возвраты NULL если это не понимает свой параметр.

mysql> SELECT
                    INET_ATON('10.0.5.9');        -> 167773449

Для этого примера возвращаемое значение вычисляется как ^10×2563 + ^0×2562 + 5×256 + 9.

INET_ATON() май или, возможно, не возвращается не -NULL результат для кратких IP-адресов (такой как '127.1' как представление '127.0.0.1'). Из-за этого, INET_ATON()должный не использоваться для таких адресов.

INET_NTOA(expr)

Учитывая числовой адрес сети IPv4 в сетевом порядке байтов, возвращает строковое представление точечной четверки адреса как недвоичная строка в наборе символов соединения. INET_NTOA() возвраты NULL если это не понимает свой параметр.

mysql> SELECT
                    INET_NTOA(167773449);        -> '10.0.5.9'

INET6_ATON(expr)

Учитывая IPv6 или адрес сети IPv4 как строка, возвращает двоичную строку, которая представляет числовое значение адреса в сетевом порядке байтов (обратный порядок байтов). Поскольку адреса IPv6 числового формата требуют большего количества байтов чем самый большой целочисленный тип, представление, возвращенное этой функцией, имеет VARBINARY тип данных: VARBINARY(16) поскольку IPv6 адресуется и VARBINARY(4) для адресов IPv4. Если параметром не является допустимый адрес, INET6_ATON() возвраты NULL.

Следующее использование в качестве примера HEX() вывести на экран INET6_ATON() результат в печатаемой форме:

mysql> SELECT
                    HEX(INET6_ATON('fdfe::5a55:caff:fefa:9089'));        -> 'FDFE0000000000005A55CAFFFEFA9089'mysql> SELECT HEX(INET6_ATON('10.0.5.9'));        -> '0A000509'

INET6_ATON() наблюдает несколько ограничений на допустимые параметры. Они даются в следующем списке наряду с примерами.

Преобразовать адрес IPv4 expr представленный в числовой форме как INT оцените адресу IPv6, представленному в числовой форме как a VARBINARY значение, используйте это выражение:

INET6_ATON(INET_NTOA(expr))

Например:

mysql> SELECT
                    HEX(INET6_ATON(INET_NTOA(167773449)));        -> '0A000509'

INET6_NTOA(expr)

Учитывая IPv6 или адрес сети IPv4, представленный в числовой форме как двоичная строка, возвращает строковое представление адреса как недвоичная строка в наборе символов соединения. Если параметром не является допустимый адрес, INET6_NTOA() возвраты NULL.

INET6_NTOA() имеет эти свойства:

mysql> SELECT
                    INET6_NTOA(INET6_ATON('fdfe::5a55:caff:fefa:9089'));        -> 'fdfe::5a55:caff:fefa:9089'mysql> SELECT INET6_NTOA(INET6_ATON('10.0.5.9'));        -> '10.0.5.9'mysql> SELECT
                    INET6_NTOA(UNHEX('FDFE0000000000005A55CAFFFEFA9089'));        -> 'fdfe::5a55:caff:fefa:9089'mysql> SELECT INET6_NTOA(UNHEX('0A000509'));        -> '10.0.5.9'

IS_FREE_LOCK(str)

Проверки, называют ли блокировку str свободно использовать (то есть, не заблокированный). Возвраты 1 если блокировка свободна (никто не использует блокировку), 0 если блокировка используется, и NULL если ошибка происходит (такие как неправильный параметр).

Эта функция опасна для основанной на операторе репликации. В MySQL 5.7 регистрируется предупреждение, если Вы используете эту функцию когда binlog_format устанавливается в STATEMENT. (Ошибка #47995)

IS_IPV4(expr)

Возвраты 1, если параметром является допустимый адрес IPv4, определенный как строка, 0 иначе.

mysql> SELECT IS_IPV4('10.0.5.9'),
                    IS_IPV4('10.0.5.256');        -> 1, 0

Для данного параметра, если IS_IPV4() возвраты 1, INET_ATON() (и INET6_ATON()) возвратится не -NULL. Обратный оператор не является истиной: В некоторых случаях, INET_ATON() возвраты не -NULL когда IS_IPV4() возвраты 0.

Как подразумевающийся предыдущими комментариями, IS_IPV4() более строго чем INET_ATON() о каком составляет допустимый адрес IPv4, таким образом, это может быть полезно для приложений, которые должны выполнить проверки strong против недопустимых значений. Альтернативно, использовать INET6_ATON() преобразовать адреса IPv4 во внутреннюю форму и проверку на a NULL результат (который указывает на недопустимый адрес). INET6_ATON() одинаково strong как IS_IPV4() о проверке адресов IPv4.

IS_IPV4_COMPAT(expr)

Эта функция берет адрес IPv6, представленный в числовой форме как двоичная строка, как возвращено INET6_ATON(). Это возвращается 1, если параметром является допустимый совместимый с IPv4 адрес IPv6, 0 иначе. У совместимых с IPv4 адресов есть форма ::ipv4_address.

mysql> SELECT
                    IS_IPV4_COMPAT(INET6_ATON('::10.0.5.9'));        -> 1mysql> SELECT IS_IPV4_COMPAT(INET6_ATON('::ffff:10.0.5.9'));        -> 0

Часть IPv4 совместимого с IPv4 адреса может также быть представлена, используя шестнадцатеричную нотацию. Например, 192.168.0.1 имеет это необработанное шестнадцатеричное значение:

mysql> SELECT
                    HEX(INET6_ATON('192.168.0.1'));        -> 'C0A80001'

Выраженный в совместимой с IPv4 форме, ::192.168.0.1 эквивалентно ::c0a8:0001 или (без начальных нулей) ::c0a8:1

mysql> SELECT    -> 
                    IS_IPV4_COMPAT(INET6_ATON('::192.168.0.1')),    -> 
                    IS_IPV4_COMPAT(INET6_ATON('::c0a8:0001')),    -> 
                    IS_IPV4_COMPAT(INET6_ATON('::c0a8:1'));        -> 1, 1, 1

IS_IPV4_MAPPED(expr)

Эта функция берет адрес IPv6, представленный в числовой форме как двоичная строка, как возвращено INET6_ATON(). Это возвращается 1, если параметром является допустимый отображенный на IPv4 адрес IPv6, 0 иначе. У отображенных на IPv4 адресов есть форма ::ffff:ipv4_address.

mysql> SELECT
                    IS_IPV4_MAPPED(INET6_ATON('::10.0.5.9'));        -> 0mysql> SELECT IS_IPV4_MAPPED(INET6_ATON('::ffff:10.0.5.9'));        -> 1

Как с IS_IPV4_COMPAT() часть IPv4 отображенного на IPv4 адреса может также быть представлена, используя шестнадцатеричную нотацию:

mysql> SELECT    -> 
                    IS_IPV4_MAPPED(INET6_ATON('::ffff:192.168.0.1')),    ->  IS_IPV4_MAPPED(INET6_ATON('::ffff:c0a8:0001')),    ->  IS_IPV4_MAPPED(INET6_ATON('::ffff:c0a8:1'));        -> 1, 1, 1

IS_IPV6(expr)

Возвраты 1, если параметром является допустимый адрес IPv6, определенный как строка, 0 иначе. Эта функция не полагает, что адреса IPv4 допустимые адреса IPv6.

mysql> SELECT IS_IPV6('10.0.5.9'),
                    IS_IPV6('::1');        -> 0, 1

Для данного параметра, если IS_IPV6() возвраты 1, INET6_ATON() возвратится не -NULL.

IS_USED_LOCK(str)

Проверки, называют ли блокировку str используется (то есть, заблокированный). Если так, это возвращает идентификатор соединения клиента, который содержит блокировку. Иначе, это возвращается NULL.

Эта функция опасна для основанной на операторе репликации. В MySQL 5.7 регистрируется предупреждение, если Вы используете эту функцию когда binlog_format устанавливается в STATEMENT. (Ошибка #47995)

MASTER_POS_WAIT(log_name,log_pos[,timeout])

Эта функция полезна для управления основной/ведомой синхронизации. Это блокирует, пока ведомое устройство не считало и применило все обновления до указанной позиции в основном журнале. Возвращаемое значение является числом событий журнала, которых должно было ожидать ведомое устройство совершенствоваться к указанной позиции. Функциональные возвраты NULL если ведомый поток SQL не запускается, основная информация ведомого устройства не инициализируется, параметры неправильные, или ошибка происходит. Это возвращается -1 если тайм-аут был превышен. Если ведомый поток SQL останавливается в то время как MASTER_POS_WAIT() ожидает, функциональные возвраты NULL. Если ведомое устройство проходит указанную позицию, функция сразу возвращается.

Если a timeout значение определяется, MASTER_POS_WAIT() ожидание остановок, когда timeout секунды протекли. timeout должно быть больше чем 0; нуль или отрицательный timeout средства никакой тайм-аут.

Эта функция опасна для основанной на операторе репликации. В MySQL 5.7 регистрируется предупреждение, если Вы используете эту функцию когда binlog_format устанавливается в STATEMENT. (Ошибка #47995)

NAME_CONST(name,value)

Возвращает данное значение. Когда использующийся произвести столбец набора результатов, NAME_CONST() заставляет столбец иметь имя. Параметрами должны быть константы.

mysql> SELECT NAME_CONST('myname',
                    14);+--------+| myname |+--------+|     14 |+--------+

Эта функция для внутреннего пользования только. Сервер использует это при записи операторов из сохраненных программ, которые содержат ссылки на локальные переменные программы, как описано в Разделе 18.7, "Двоичное Журналирование Сохраненных Программ", Вы могли бы видеть эту функцию в выводе от mysqlbinlog.

RELEASE_LOCK(str)

Выпускает блокировку, названную строкой str это было получено с GET_LOCK(). Возвраты 1 если блокировка была выпущена, 0 если блокировка не была установлена этим потоком (когда блокировка не выпускается), и NULL если именованная блокировка не существовала. Блокировка не существует, если она никогда не получалась звонком GET_LOCK() или если это было ранее выпущено.

DO оператор удобен, чтобы использовать с RELEASE_LOCK(). См. Раздел 13.2.3,"DO Синтаксис".

Эта функция опасна для основанной на операторе репликации. В MySQL 5.7 регистрируется предупреждение, если Вы используете эту функцию когда binlog_format устанавливается в STATEMENT. (Ошибка #47995)

SLEEP(duration)

Сны (паузы) для числа секунд, данных duration параметр, затем возвращается 0. Если SLEEP() прерывается, это возвращается 1. У продолжительности может быть дробная часть. Если параметр NULL или отрицательный, SLEEP() производит предупреждение, или ошибку в строгом режиме SQL.

Эта функция опасна для основанной на операторе репликации. В MySQL 5.7 регистрируется предупреждение, если Вы используете эту функцию когда binlog_format устанавливается в STATEMENT. (Ошибка #47995)

UUID()

Возвращает Универсальный Уникальный идентификатор (UUID), сгенерированный согласно "DCE 1.1: Вызов удаленной процедуры" (Приложение A) CAE (Общая прикладная среда) Спецификации, опубликованные Open Group в октябре 1997 (Номер документа C706, http://www.opengroup.org/public/pubs/catalog/c706.htm).

UUID разрабатывается как число, которое глобально уникально в пространстве и времени. Два звонка UUID() как ожидают, генерируют два различных значения, даже если эти вызовы будут выполняться на двух отдельных компьютерах, которые не соединяются друг с другом.

UUID является 128-разрядным числом, представленным a utf8 строка пяти шестнадцатеричных чисел в aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee формат:

mysql> SELECT UUID();        -> '6ccd780c-baba-1026-9564-0040f4311e29'

UUID_SHORT()

Возвращает "короткий" универсальный идентификатор как 64-разрядное целое без знака (а не строковая форма 128-разрядный идентификатор как возвращено UUID() функция).

Значение UUID_SHORT() как гарантируют, будет уникален, если следующие условия будут содержать:

UUID_SHORT() возвращаемое значение создается этот путь:

  (server_id & 255) << 56+ (server_startup_time_in_seconds << 24)+ incremented_variable++;

mysql> SELECT
                    UUID_SHORT();        -> 92395783831158784

Отметьте это UUID_SHORT() не работает с основанной на операторе репликацией.

VALUES(col_name)

В INSERT ... ON DUPLICATE KEY UPDATE оператор, можно использовать VALUES(col_name) функция в UPDATE пункт, чтобы обратиться к значениям столбцов от INSERT часть оператора. Другими словами, VALUES(col_name) в UPDATE пункт относится к значению col_name это было бы вставлено, не имел никакого двойного ключевого произошедшего конфликта. Эта функция особенно полезна в многократной строке, вставляет. VALUES() функция значима только в ON DUPLICATE KEY UPDATE пункт INSERT операторы и возвраты NULL иначе. См. Раздел 13.2.5.3,"INSERT ... ON DUPLICATE KEY UPDATE Синтаксис" .

mysql> INSERT INTO table (a,b,c) VALUES
                    (1,2,3),(4,5,6)    -> ON DUPLICATE KEY UPDATE
                    c=VALUES(a)+VALUES(b);