18.13. Совместимость с разными версиями и платформами
18.13.1. Предыдущие версии Postgres Pro
array_nulls(boolean)Этот параметр определяет, будет ли при разборе вводимого массива распознаваться строка
NULLбез кавычек как элемент массива, равный NULL. Значение по умолчанию,on, позволяет задавать NULL в качестве элементов вводимого массива. Однако до версии 8.2 PostgreSQL не поддерживал ввод элементов NULL в массивах, а воспринималNULLкак обычный элемент массива со строковым значением «NULL». Для обратной совместимости с приложениями, зависящими от старого поведения, эту переменную можно отключить (присвоив ейoff).Заметьте, что массивы, содержащие NULL, можно создать, даже когда эта переменная имеет значение
off.backslash_quote(enum)Этот параметр определяет, можно ли будет представить знак апострофа в строковой константе в виде
\'. В стандарте SQL определён другой, предпочитаемый вариант передачи апострофа, дублированием (''), но Postgres Pro исторически также принимал вариант\'. Однако применение варианта\'сопряжено с угрозами безопасности, так как в некоторых клиентских кодировках существуют многобайтные символы, последний байт которых численно равен ASCII-коду\. Если код на стороне клиента выполнит экранирование некорректно, это может открыть возможности для SQL-инъекции. Предотвратить этот риск можно, запретив серверу принимать запросы, в которых апостроф экранируется обратной косой. Допустимые значения параметраbackslash_quote:on(принимать\'всегда),off(не принимать никогда) иsafe_encoding(принимать, только если клиентская кодировка не допускает присутствия ASCII-кода\в многобайтных символах). Значение по умолчанию —safe_encoding.Заметьте, что в строковой константе, записанной согласно стандарту, знаки
\обозначают просто\. Этот параметр влияет только на восприятие строк, не соответствующих стандарту, в том числе с синтаксисом спецпоследовательностей (E'...').default_with_oids(boolean)Этот параметр определяет, будут ли команды
CREATE TABLEиCREATE TABLE ASбез явных указанийWITH OIDSиWITHOUT OIDSдобавлять столбец OID в создаваемые таблицы. Он также устанавливает, будут ли столбцы OID добавляться в таблицы, создаваемые командойSELECT INTO. По умолчанию значение этого параметра —off(столбцы OID не добавляются); в PostgreSQL версии 8.0 и ранее он был включён (on).Практика использования OID в пользовательских таблицах считается устаревшей, так что в большинстве инсталляций не следует включать этот параметр. Приложения, которым требуется столбец OID в определённой таблице, могут явно указать
WITH OIDSпри создании таблицы. Этот параметр следует включать только для совместимости со старыми приложениями, которые не делают этого.escape_string_warning(boolean)Когда этот параметр включён, сервер выдаёт предупреждение, если обратная косая черта (
\) встречается в обычной строковой константе (с синтаксисом'...') и параметрstandard_conforming_stringsотключён. Значение по умолчанию —on(вкл.).Приложения, которые предпочитают использовать обратную косую в виде спецсимвола, должны перейти к применению синтаксиса спецстрок (
E'...'), так как по умолчанию теперь в обычных строках обратная косая воспринимается как обычный символ, в соответствии со стандартом SQL. Включение данного параметра помогает найти код, нуждающийся в модификации.lo_compat_privileges(boolean)В PostgreSQL до версии 9.0 для больших объектов не назначались права доступа, и поэтому они были всегда доступны на чтение и запись для всех пользователей. Если установить для этого параметра значение
on, существующие теперь проверки прав отключаются для совместимости с предыдущими версиями. Значение по умолчанию —off. Изменить этот параметр могут только суперпользователи.Установка данного параметра не приводит к отключению всех проверок безопасности, связанных с большими объектами — затрагиваются только те проверки, которые изменились в PostgreSQL 9.0. Например, функции
lo_import()иlo_export()будут требовать прав суперпользователя вне зависимости от данного значения.operator_precedence_warning(boolean)Когда этот параметр включён, анализатор запроса будет выдавать предупреждение для всех конструкций, которые поменяли поведение после PostgreSQL 9.4 в результате изменения приоритетов операторов. Это полезно для аудита, так как позволяет понять, не сломалось ли что-то вследствие этого изменения. Но в производственной среде включать его не следует, так как предупреждения могут выдаваться и тогда, когда код абсолютно правильный и соответствует стандарту SQL. Значение по умолчанию —
off.За подробностями обратитесь к Подразделу 4.1.6.
quote_all_identifiers(boolean)Принудительно заключать в кавычки все идентификаторы, даже если это не ключевые слова (сегодня), при получении SQL из базы данных. Это касается вывода
EXPLAIN, а также результатов функций типаpg_get_viewdef. См. также описание аргумента--quote-all-identifiersкоманд pg_dump и pg_dumpall.nul_byte_replacement_on_import(string)Заменять нулевые байты (
'\0') ASCII-символом с указанным десятичным кодом при загрузке данных с использованием командыCOPY FROM. Такая замена может потребоваться при загрузке данных из другой СУБД, так как Postgres Pro не принимает нулевые байты в данных. ASCII-символ замены должен отличаться от символовQUOTEиDELIMITER, применяемых при выполненииCOPY FROM; в противном случае результат может быть неожиданным. Значение по умолчанию —'\0', то есть замена не производится.standard_conforming_strings(boolean)Этот параметр определяет, будет ли обратная косая черта в обычных строковых константах (
'...') восприниматься буквально, как того требует стандарт SQL. Начиная с версии PostgreSQL 9.1, он имеет значениеon(в предыдущих версиях значение по умолчанию былоoff). Приложения могут выяснить, как обрабатываются строковые константы, проверив этот параметр. Наличие этого параметра может также быть признаком того, что поддерживается синтаксис спецпоследовательностей (E'...'). Этот синтаксис (Подраздел 4.1.2.2) следует использовать, если приложению нужно, чтобы обратная косая воспринималась как спецсимвол.synchronize_seqscans(boolean)Этот параметр включает синхронизацию обращений при последовательном сканировании больших таблиц, чтобы эти операции читали один блок примерно в одно и то же время, и, таким образом, нагрузка разделялась между ними. Когда он включён, сканирование может начаться в середине таблицы, чтобы синхронизироваться со сканированием, которое уже выполняется. По достижении конца таблицы сканирование «заворачивается» к началу и завершает обработку пропущенных строк. Это может привести к непредсказуемому изменению порядка строк, возвращаемых запросами, в которых отсутствует предложение
ORDER BY. Когда этот параметр выключен (имеет значениеoff), реализуется поведение, принятое до версии 8.3, когда последовательное сканирование всегда начиналось с начала таблицы. Значение по умолчанию —on.
18.13.2. Совместимость с разными платформами и клиентами
transform_null_equals(boolean)Когда этот параметр включён, проверки вида
(иливыражение= NULLNULL =) воспринимаются каквыражение, то есть они истинны, есливыражениеIS NULLвыражениедаёт значение NULL, и ложны в противном случае. Согласно спецификации SQL, сравнениедолжно всегда возвращать NULL (неизвестное значение). Поэтому по умолчанию этот параметр выключен (равенвыражение= NULLoff).Однако формы фильтров в Microsoft Access генерируют запросы, в которых проверка на значение NULL записывается как
, так что если вы используете этот интерфейс для обращения к базе данных, имеет смысл включить данный параметр. Так как проверки видавыражение= NULLвсегда возвращают значение NULL (следуя правилам стандарта SQL), они не очень полезны и не должны встречаться в обычных приложениях, так что на практике от включения этого параметра не будет большого вреда. Однако начинающие пользователи часто путаются в семантике выражений со значениями NULL, поэтому по умолчанию этот параметр выключен.выражение= NULLЗаметьте, что этот параметр влияет только на точную форму сравнения
= NULL, но не на другие операторы сравнения или выражения, результат которых может быть равнозначен сравнению с применением оператора равенства (например, конструкциюIN). Поэтому данный параметр не может быть универсальной защитой от плохих приёмов программирования.За сопутствующей информацией обратитесь к Разделу 9.2.
18.13. Version and Platform Compatibility
18.13.1. Previous Postgres Pro Versions
array_nulls(boolean)This controls whether the array input parser recognizes unquoted
NULLas specifying a null array element. By default, this ison, allowing array values containing null values to be entered. However, PostgreSQL versions before 8.2 did not support null values in arrays, and therefore would treatNULLas specifying a normal array element with the string value “NULL”. For backward compatibility with applications that require the old behavior, this variable can be turnedoff.Note that it is possible to create array values containing null values even when this variable is
off.backslash_quote(enum)This controls whether a quote mark can be represented by
\'in a string literal. The preferred, SQL-standard way to represent a quote mark is by doubling it ('') but Postgres Pro has historically also accepted\'. However, use of\'creates security risks because in some client character set encodings, there are multibyte characters in which the last byte is numerically equivalent to ASCII\. If client-side code does escaping incorrectly then a SQL-injection attack is possible. This risk can be prevented by making the server reject queries in which a quote mark appears to be escaped by a backslash. The allowed values ofbackslash_quoteareon(allow\'always),off(reject always), andsafe_encoding(allow only if client encoding does not allow ASCII\within a multibyte character).safe_encodingis the default setting.Note that in a standard-conforming string literal,
\just means\anyway. This parameter only affects the handling of non-standard-conforming literals, including escape string syntax (E'...').default_with_oids(boolean)This controls whether
CREATE TABLEandCREATE TABLE ASinclude an OID column in newly-created tables, if neitherWITH OIDSnorWITHOUT OIDSis specified. It also determines whether OIDs will be included in tables created bySELECT INTO. The parameter isoffby default; in PostgreSQL 8.0 and earlier, it wasonby default.The use of OIDs in user tables is considered deprecated, so most installations should leave this variable disabled. Applications that require OIDs for a particular table should specify
WITH OIDSwhen creating the table. This variable can be enabled for compatibility with old applications that do not follow this behavior.escape_string_warning(boolean)When on, a warning is issued if a backslash (
\) appears in an ordinary string literal ('...'syntax) andstandard_conforming_stringsis off. The default ison.Applications that wish to use backslash as escape should be modified to use escape string syntax (
E'...'), because the default behavior of ordinary strings is now to treat backslash as an ordinary character, per SQL standard. This variable can be enabled to help locate code that needs to be changed.lo_compat_privileges(boolean)In PostgreSQL releases prior to 9.0, large objects did not have access privileges and were, therefore, always readable and writable by all users. Setting this variable to
ondisables the new privilege checks, for compatibility with prior releases. The default isoff. Only superusers can change this setting.Setting this variable does not disable all security checks related to large objects — only those for which the default behavior has changed in PostgreSQL 9.0. For example,
lo_import()andlo_export()need superuser privileges regardless of this setting.operator_precedence_warning(boolean)When on, the parser will emit a warning for any construct that might have changed meanings since PostgreSQL 9.4 as a result of changes in operator precedence. This is useful for auditing applications to see if precedence changes have broken anything; but it is not meant to be kept turned on in production, since it will warn about some perfectly valid, standard-compliant SQL code. The default is
off.See Section 4.1.6 for more information.
quote_all_identifiers(boolean)When the database generates SQL, force all identifiers to be quoted, even if they are not (currently) keywords. This will affect the output of
EXPLAINas well as the results of functions likepg_get_viewdef. See also the--quote-all-identifiersoption of pg_dump and pg_dumpall.nul_byte_replacement_on_import(string)Replace NUL bytes
'\0'with the specified decimal code of an ASCII character while loading data using theCOPY FROMcommand. Such a replacement may be required when transferring data from another DBMS since Postgres Pro does not allow NUL bytes in data. The specified ASCII code must not coincide with theQUOTEandDELIMITERcharacters used byCOPY FROMas it may cause unexpected results. The default value is'\0', so no replacement occurs.standard_conforming_strings(boolean)This controls whether ordinary string literals (
'...') treat backslashes literally, as specified in the SQL standard. Beginning in PostgreSQL 9.1, the default ison(prior releases defaulted tooff). Applications can check this parameter to determine how string literals will be processed. The presence of this parameter can also be taken as an indication that the escape string syntax (E'...') is supported. Escape string syntax (Section 4.1.2.2) should be used if an application desires backslashes to be treated as escape characters.synchronize_seqscans(boolean)This allows sequential scans of large tables to synchronize with each other, so that concurrent scans read the same block at about the same time and hence share the I/O workload. When this is enabled, a scan might start in the middle of the table and then “wrap around” the end to cover all rows, so as to synchronize with the activity of scans already in progress. This can result in unpredictable changes in the row ordering returned by queries that have no
ORDER BYclause. Setting this parameter tooffensures the pre-8.3 behavior in which a sequential scan always starts from the beginning of the table. The default ison.
18.13.2. Platform and Client Compatibility
transform_null_equals(boolean)When on, expressions of the form
(orexpr= NULLNULL =) are treated asexpr, that is, they return true ifexprIS NULLexprevaluates to the null value, and false otherwise. The correct SQL-spec-compliant behavior ofis to always return null (unknown). Therefore this parameter defaults toexpr= NULLoff.However, filtered forms in Microsoft Access generate queries that appear to use
to test for null values, so if you use that interface to access the database you might want to turn this option on. Since expressions of the formexpr= NULLalways return the null value (using the SQL standard interpretation), they are not very useful and do not appear often in normal applications so this option does little harm in practice. But new users are frequently confused about the semantics of expressions involving null values, so this option is off by default.expr= NULLNote that this option only affects the exact form
= NULL, not other comparison operators or other expressions that are computationally equivalent to some expression involving the equals operator (such asIN). Thus, this option is not a general fix for bad programming.Refer to Section 9.2 for related information.