8.4. Двоичные типы данных

8.4.1. Шестнадцетеричный формат bytea

Шестнадцатеричный ("hex") формат кодирует двоичные данные как два шестнадцатеричных разряда на байт, старший разряд идёт первым. Строка целиком состоит из последовательности \x (что отличается от escape формата). В некоторых контекстах, может понадобится экранировать начальную обратную косую черту, дублируя её, в таких же случаях, в которых требуется двойная обратная косая черта в esacpe формате; подробности см. ниже. Шестнадцетеричные разряды могут быть как в верхнем, так и в нижнем регистре, а между парами цифр допускаются пробелы (но не внутри пары рарядов и не в начале последовательности \x). Шестнадцетричиный формат совместим с широким диапазоном внешних приложений и протоколов, а также он имеет тенденцию к более быстрому преобразованию данных, чем в случае escape формата, так что его использование является предпочтительным.

Пример:

SELECT E'\\xDEADBEEF';

8.4.2. Escape формат bytea

"Escape" формат является традиционным форматом для типа bytea в PostgreSQL. Он использует подход представления двоичной строки как последовательности ASCII символов, во время конвертации байты, которые не могут быть представлены как ASCII символы, заменяются специальными escape последовательностями. Если, с точки зрения приложения, представленние байтов как символов имеют смысл, то данное представление может быть подходящим. Но на практике это обычно запутывает, потому что затрудняет понимание разницы между двоичными строками и символьными строками, а тут ещё особый механизм экранирования, который является несколько громоздким. Таким образом, в большинстве новых приложений, использование данного формат предположительно нужно избегать

При вводе значений bytea в escape формате, конкретные значения должны быть экранированы, в то время как вообще все значения могут быть экранированы. В общем случае, чтобы экранировать вводимое значение оно преобразуется в трёхциферное восьмеричное значение эквивалентное его десятичному значению и предваряется обратной косой чертой (или двумя, если значение записывается как литерал, используя ситаксис зкранирования строк). Сам символ обратной косой черты (восьмеричное значение 92) может быть представлен двумя обратными косыми чертами. Table 8-7 показывает символы которые должны быть экранированы и предоставляет альтернативные escape последовательности там где это возможно.

Требование об экранировании непечатаемых символов варьируется в зависимости от установок локали. В некоторых случаях вы можете оставлять их незаэкранированными. Заметим, что результат в каждом примере в Table 8-7 составлял точно один байт в длину, даже если предоставление иногда выглядит как более одного символа.

Причина, по которой требуется так много символов обратная косая черта в Table 8-7 заключается в том, что вводимый строковый литерал должен пройти на сервере PostgreSQL через две фазы обработки. Первая обратная косая черта каждой пары итерпретируется для обработчика строкового литерала (включая использование синтаксиса экранирования) как символ экранирования и, таким образом, опускается, оставляя второй символ обратная косая черта в паре. (Для того, чтобы избежать этого уровня экранирования можно использовать строки доллар-кавычка.) Оставшийся символ обратная косая черта затем распознаётся функцией ввода типа bytea, как начинающий трёхциферное восьмеричное значение или символ экранирования следующего символа обратная косая черта. Например, строковый литерал, передаваемый на сервер как 'E\\001' принимает вид \001 после обработчика строкового литерала. Далее \001 посылается функции ввода типа bytea, где преобразовывается в одиночный байт с десятичным значением 1. Заметим, что символ одиночной кавычки для bytea не считается специальным, так как он отвечает обычным правилам строковых литералов. (См. также Section 4.1.2.1.)

Значения Bytea при выводе иногда экранируются. Обычно, в виде эквивалентного трёхциферного восьмеричного значения, предваряемого символом обратная косая черта. Большинство "печатаемых" байт выводится в их стандартном представлении, согласно кодировке клиента. Символ с десятичным значением 92 (обратная косая черта) выводится дважды. Подробности смотрите в Table 8-8.

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