.. raw:: latex

  \appcount

.. _settings:

Настройки приложения
========================

Общие
-------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Общие настройки
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Проверять обновления при запуске
     - Если включено, то приложение будет сообщать о новых версиях.
   * - Загружать нестабильные версии
     - Включить/отключить возможность обновления на нестабильную версию приложения.
   * - Спрашивать о сохранении открытых документов
     - Спрашивать о сохранении изменений перед закрытием документа. Если выключено, то изменения не сохраняются.
   * - Парсить переменные процедур и функций
     - Отображать переменные процедур и функций при просмотре подробной информации об объекте
   * - Количество отображаемых последних файлов
     - Количество файлов, отображаемых в меню ``Правка`` :math:`\to` ``Недавние файлы``
   * - Количество отображаемых последних хостов
     - Количество последних введённых хостов, отображаемых в выпадающем списке для выбора.
   * - Разделитель строк
     - Символ, который будет использоваться в качестве разделителя
   * - Кодировка файлов по умолчанию
     - Кодировка файлов по умолчанию

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Логирование
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Отображать системную консоль
     - Отображать/скрывать системную консоль
   * - Логирование работы приложения
     - Записывать события приложения в системный журнал
   * - Системный вывод в консоль
     - Выводить поток ``System.out`` в консоль
   * - Вывод системных ошибок в консоль
     - Выводить поток ``System.err`` в консоль
   * - Количество сохраняемых файлов с логами
     - Количество сохраненных файлов журнала логов. 
       При достижении журнала (``system.log``) размера более 1МБ, запись продолжается в новый файл (system.log.1) и т.д. 
       Когда количество файлов будет равно числу, указанному в этом параметре, файлы будут перезаписаны. 
       Если указано 0, то количество файлов неограниченно.
   * - Уровень лога событий
     - Уровень вывода в журнал состояния вывода и в консоль вывода:
        
        1. ``FATAL`` – фиксирует очень серьезные ошибки, которые, повидимому, приведут к прекращению использования приложения;
        2. ``ERROR`` – фиксирует серьезные ошибки, нуждающаяся в проверке, но не прекращающая работу приложения;
        3. ``WARN`` – фиксирует потенциально опасные ситуации;
        4. ``INFO`` – информирует о событиях работы приложения на высоком уровне;
        5. ``DEBUG`` – информирует о событиях на более низком уровне для отладки приложения (для разработчиков);
        6. ``TRACE`` – подробное ведение журнала для очень низкоуровневой отладки;
        7. ``ALL`` – все вышеперечисленные уровни.
        
        Уровни упорядочены и каждый следующий включает в себя предыдущие уровни.
   * - Путь к папке с логами
     - Определяет абсолютный или относительный путь к директории ``logs``, содержащей файлы логов. 
       Например, при указании относительного пути ``logs`` файлы логов будут создаваться по пути ``/<path_to_app>/logs``. 
       

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Настройки прокси
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Использовать прокси 
     - Использовать прокси-сервер для подключения к интернету
   * - Прокси сервер 
     - Имя или IP прокси-сервера
   * - Прокси порт 
     - Номер порта прокси-сервера
   * - Прокси пользователь 
     - Имя пользователя для авторизации на прокси-сервере (если требуется)
   * - Прокси пароль 
     - Пароль пользователя для авторизации на прокси сервере (если требуется)

Настройки отображения
------------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Общие
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Отображение заставки при запусе
     - Показывать/пропускать заставку при запуске
   * - Развернуть окно при запуске
     - Открывать окно приложения на весь экран при запуске
   * - Строка состояния
     - Показывать/скрывать строку состояния
   * - Подключения
     - Показывать/скрывать окно с информацией о подключении

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Внешний вид
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Тема
     - Оформление приложения
   * - Язык интерфейса
     - Язык приложения
   * - Использовать сглаженные шрифты
     - Отображать шрифт сглаженно, размывая углы

Горячие клавиши
-------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{23}|>{\arraybackslash}\X{6}{23}|>{\arraybackslash}\X{11}{23}|
.. list-table:: Горячие клавиши
   :class: longtable
   :header-rows: 1

   * - Команда
     - Горячие клавиши
     - Описание
   * - Верхний регистр
     - Ctrl + Shift + U
     - Приводит выделенный текст в верхний регистр
   * - Выполнить SQL-скрипт
     - F9
     - Выполняет SQL-скрипт, находящийся в редакторе запросов
   * - Выполнить в профайлере
     - Shift + F5
     - Выполняет в профайлере SQL-скрипт, находящийся в редакторе запросов
   * - Выполнить одиночный запрос
     - F5
     - Выполнить одним запросом SQL-скрипт, находящийся в редакторе запросов
   * - Генератор данных
     - 
     - Открыть генератор тестовых данных
   * - Документация 
     - F1
     - Открыть документацию приложения
   * - Драйверы
     - 
     - Открыть окно драйверов
   * - Дублировать текст вверху
     - Ctrl + Alt + Up 
     - Дублировать в редакторе запросов строку, на которую указывает курсор, на строку выше
   * - Дублировать текст внизу
     - Ctrl + Alt + Down
     - Дублировать в редакторе запросов строку, на которую указывает курсор, на строку ниже
   * - Закомментировать текст
     - Ctrl + Slash
     - Закомментировать текущую строку в редакторе запросов
   * - Заменить
     - Ctrl + R
     - Найти и заменить указанный текст
   * - Зафиксировать транзакцию
     - Ctrl + Shift + C
     - Зафиксировать транзакцию
   * - Извлечь метаданные БД в SQL скрипт
     - 
     - Открыть инструмент ``Экспорт метаданных``
   * - Изменить ориентацию разделителя
     - Ctrl + Alt + Q
     - Изменить формат расположения окон приложения
   * - Искать выше
     - Shift + F3
     - Искать указанный текст
   * - Искать далее
     - F3
     - Искать указанный текст
   * - История SQL-запросов
     - Ctrl + Shift + H
     - Открыть историю выполненных запросов 
   * - Менеджер пользователей
     - 
     - Открыть менеджер пользователей
   * - Менеджер привилегий
     - 
     - Открыть менеджер привилегий
   * - Настройки
     - 
     - Открыть настройки приложения
   * - Нижний регистр
     - Ctrl + Shift + L
     - Приводит выделенный текст в нижний регистр
   * - О программе
     - 
     - Открыть информацию о программе
   * - Окно системной консоли
     - 
     - Открыть системную консоль
   * - Откатить все изменения
     - Ctrl + Shift + R
     - Ократить транзакцию
   * - Открыть файл
     - Ctrl + O
     - Добавить в редактор запросов текст выбранного файла
   * - Перейти к 
     - Ctrl + G
     - Перейти к указанной строке в редакторе запросов
   * - Печать
     - Ctrl + P
     - Отрыть окно печати
   * - Показать план
     - Ctrl + Shift + P
     - Показать план запроса, который находится в редакторе запросов
   * - Показать/скрыть панель вывода
     - Ctrl + E
     - Показать/скрыть панель вывода в редакторе запросов
   * - Предыдущее утверждение
     - Ctrl + Shift + Down
     - Вставить в редактор запросов ранее выполненный SQL-скрипт
   * - Проверить обноления
     - 
     - Проверить актуальность используемой версии приложения
   * - Профайлер
     - 
     - Открыть профайлер 
   * - Редактор ER-диаграмм
     - 
     - Открыть редактор ER-диаграмм 
   * - Редактор запросов
     - 
     - Открыть редактор запросов
   * - Сдвинуть текст вверх
     - Alt + Up
     - Переместить выделенный текст на строку выше
   * - Сдвинуть текст вниз
     - Alt + Down
     - Переместить выделенный текст на строку ниже
   * - Следующее утверждение
     - Ctrl + Shift + Up
     - Вставить в редактор запросов следующий сохранённый SQL-скрипт
   * - Создать базу данных
     - 
     - Открыть окно создания базы данных
   * - Создать подключение
     - Ctrl + Shift + N
     - Открыть окно создания подключения
   * - Состояние памяти
     - 
     - Открыть окно с актуальной информацией о состоянии памяти
   * - Сохранить
     - Ctrl + S
     - Сохранить
   * - Сохранить как
     - Ctrl + Shift + S
     - Сохранить как
   * - Сравнить метаданные баз данных
     - 
     - Открыть инструмент сравнения баз данных
   * - Статистика БД
     - 
     - Открыть инструмент для сбора статистики
   * - Трейс менеджер
     - 
     - Открыть трейс менеджер
   * - Формат SQL
     - Ctrl + Shift + F
     - Форматировать выделенный фрагмент текста

Шаблоны SQL
---------------

Шаблоны упрощают написание скрипта.
После нажатия пробела указанное сокращение будет преобразовано в полноценный текст, например:
``SF`` :math:`\to` ``SELECT * FROM``.

Добавлять собственные шаблоны можно с помощью соответствующей кнопки.

Подключение
-------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Общие
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Автоматически подключаться при запуске
     - Автоматически подключаться при запуске
   * - База данных для автоматического подключения
     - Подключение, с которым нужно автоматически устанавливать соединение при запуске
   * - Таймаут подключения к серверу (сек)
     - Время, в течение которого прриложение будет пытаться подключиться к базе данных. 
       Если не соединение не будет установлено до его истечения, то возникнет ошибка.
   * - Таймаут диагностики разрыва соединения (мс)
     - При возникновении ошибки от сервера РБДЭксперт проверяет активно ли соединение. 
       Параметр определяет время, в течение которого приложение будет ожидать ответ от сервера. 
       При достижении таймаута соединение будет разорвано.
   * - Имя пользователя нового подключения при открытии .fdb
     - Имя пользователя, от которого будет выполнено подключение при открытии .fdb
   * - Пароль пользователя нового подключения при открытии .fdb
     - Пароль, с которым будет выполнено подключение при открытии .fdb
   * - Кодировка нового подключения при открытии .fdb
     - Кодировка, с которой будет выполнено подключение при открытии .fdb
   * - Разрешенные плагины аутентификации по умолчанию
     - Список плагинов, которые будут использоваться драйвером для аунтефикации

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Дерево подключений
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Высота узла
     - Расстояние между узлами в пикселях
   * - Подключение по двойному клику
     - Устанавливать соединение с базой данных, после двойного клика по ней в дереве подключений
   * - Разворачивать дерево объектов БД при подключении
     - При включенной опции дерево объектов будет автоматически разворачиваться при подключении к БД
   * - Сортировать по алфавиту
     - Сортировать в алфавитном порядке узлы в дереве подключений
   * - Показать папки для таблиц
     - Формировать в дереве подключений папки для информации о таблице
   * - Показать системные объекты
     - Отображать/скрывать системные объекты в дереве подключений
   * - Показывать панель с параметрами подключения
     - Показать/скрыть панель параметров подключения
   * - Показывать полную статистику БД
     - Отображать в панели параметров подключения полную статистику базы данных
   * - Искать в столбцах
     - Выполнять поиск не только в объектах дерева подключений, но и в именах столбцов.

Редактор запросов
-------------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Общие
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Автоматическое дополнение только по горячим клавишам
     - Предлагать дополнение только после нажатия ``Ctrl + пробел``
   * - Автоматическое дополнение ключевых слов
     - Автоматическое дополнение ключевых слов в редакторе запросов
   * - Автоматическое дополнение объектов БД
     - Автоматическое дополнение объектов БД в редакторе запросов
   * - Авто-коммит для редактора по умолчанию
     - Автоматически фиксировать изменения после выполнения запроса
   * - Хранить метаданные результирующего набора
     - Сохранять метаданные результирующего набора после выполнения запроса
   * - Открывать результирующие наборы данных в одной вкладке
     - При выполнении запроса закрывать предыдущий результирующий набор
   * - Удалять комментарии перед выполнением
     - Удалять SQL комментарии в запросах во время выполнения и отправлять на сервер запрос без них
   * - Выводить весь запрос на панель вывода
     - Добавлять в панель вывода полный текст запроса
   * - Выводить детальный план запроса
     - Добавлять в панель вывода детальный план запроса
   * - Открывать новый редактор для нового открытого подключения
     - Переходить в новую вкладку редактора запросов при установке соединения
   * - Использовать несколько подключений
     - Добавить возможность указать несколько подключений, в которых нужно выполнить запрос
   * - Количество возвратов к предыдущим состояниям. Команда возврата активируется по нажатию ``Ctrl+Z`` (``Windows``)
     - Максимальное допустимое количество отмен
   * - Количество сохраняемых запросов в истории
     - Количество запросов, которое может храниться в истории. При достижении указанного количества старые запросы будут удаляться из истории

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Настройки отображения
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Панель инструментов 
     - Отображать панель инструментов редактора запросов
   * - Параметры транзакции
     - Отображать параметры транзакции
   * - Строка состояния
     - Показать/скрыть строку состояния
   * - Номера строк
     - Отображать номера строк в редакторе запросов
   * - Перенос строк
     - Автоматически переносить строку, если она не помещается в редакторе запросов
   * - Подсветка текущей строки
     - Выделять цветом строку, на которой находится курсор

Форматирование кода
---------------------

Общие параметры задают правила форматирования ключевых слов. 

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Параметры редактора запроса
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Преобразовывать табуляцию в пробелы
     - Преобразовывать табуляцию в пробелы
   * - Количество пробелов в табуляции
     - Количество пробелов, на которое нужно заменить табуляцию при преобразовании
   * - Разделитель запросов, используемый по умолчанию
     - Символ, по которому разделяются запросы. По-умолчанию - ``;``. 

Таблица набора данных
---------------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Настройки отображения
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Изменяемость ширины столбцов
     - Включить/отключить возможность менять размер столбцов в результирующем наборе
   * - Перестановка столбцов
     - Включить/отключить возможность перетаскивать столбцы, меняя их местами
   * - Показывать номера строк
     - Показать/скрыть номера строк в результирующей таблице
   * - Ширина столбца (в пикселях)
     - Ширина столбца в результирующей таблице
   * - Высота строки (в пикселях)
     - Высота строки в результирующей таблице
   * - Сохранять ширину столбцов между запросами
     - Сохранять одинаковую ширину столбцов в результирующей таблице
   * - Использовать разделители разрядов для числовых значений
     - Если включено, то разряды числовых значений будут разделены пробелом
   * - Шаблон даты
     - Шаблон даты для типа данных ``DATE``. В таблице ниже рассмотрены подробно параметры шаблона
   * - Шаблон времени
     - Шаблон времени для типа данных ``TIME``. В таблице ниже рассмотрены подробно параметры шаблона
   * - Шаблон даты-времени
     - Шаблон даты-времени для типа данных ``TIMESTAMP``. В таблице ниже рассмотрены подробно параметры шаблона
   * - Шаблон времени с временными зонами
     - Шаблон времени для типа данных ``TIME WITH TIME ZONE``. В таблице ниже рассмотрены подробно параметры шаблона
   * - Шаблон даты-времени с временными зонами
     - Шаблон даты-времени для типа данных ``TIMESTAMP WITH TIME ZONE``. В таблице ниже рассмотрены подробно параметры шаблона
   * - Текст в ячейке со значением ``NULL``
     - Текст, который будет добавлен для значений ``NULL``
   * - Открывать визуализатор данных по двойному клику на ячейку
     - Открывать окно с информацие о значении при двойном клике на ячейку в результирующей таблице 
   * - Транспонировать результат с одной строкой
     - Транспонировать результат, состоящий из одной строки
   * - Выравнивание числовых значений
     - Расположение числовых значений в ячейке
   * - Выравнивание текстовых значений
     - Расположение текстовых значений в ячейке
   * - Выравнивание boolean значений
     - Расположение boolean значений в ячейке
   * - Выравнивание null значений
     - Расположение значений null в ячейке
   * - Выравнивание других значений
     - Расположение значений других типов в ячейке
   * - Использовать форму для добавления/удаления строк
     - Открывать окно при добавлении данных в таблицу
   * - Использовать другой цвет для значений с null при добавлении/удалении записей
     - Выделять цветом ячейку со значением null
   * - Показывать диалоговое окно при достижении лимита записей
     - Отображать предупреждение, что количество записей в результирующей таблице достигло максимального количество возвращаемых записей
   * - Максимальное количество возвращаемых записей
     - Максимальное количество возвращаемых записей в результирующей таблице
   * - Количество подгружаемых записей за раз
     - Количество записей, которые будут извлечены при открытии таблицы набора данных

Описание шаблонов
~~~~~~~~~~~~~~~~~~~~~~~

.. tabularcolumns:: |>{\arraybackslash}\X{2}{17}|>{\arraybackslash}\X{7}{17}|>{\arraybackslash}\X{2}{17}|>{\arraybackslash}\X{6}{17}|
.. list-table:: Шаблоны даты и времени
   :class: longtable
   :header-rows: 1

   * - Символ
     - Описание
     - Представление
     - Пример
   * - G 
     - эра (в английской локализации - AD и BC)
     - текст
     - н.э; Anno Domini; A
   * - u
     - год
     - год
     - 2025; 25
   * - y 
     - год эры
     - год
     - 2012; 12
   * - D 
     - день в году
     - число
     - 38
   * - M/L
     - месяц в году
     - число/текст
     - 7; 07; Jul; July; J
   * - d 
     - день в месяце
     - число
     - 7
   * - Q/q
     - квартал года
     - число/текст
     - 3; 03; Q3; 3rd quarter
   * - Y 
     - год основанный на неделях
     - число
     - 1996; 96
   * - w 
     - неделя в году
     - число
     - 27
   * - W 
     - неделя в месяце
     - число
     - 2
   * - E 
     - день недели
     - текст 
     - Вт; Tue; Tuesday; T
   * - e/c 
     - локализация дня недели
     - число/текст
     - 2; 02; Tue; Tuesday; T
   * - F 
     - день недели в месяце
     - число
     - 1
   * - a 
     - AM/PM указатель
     - текст 
     - AM
   * - B
     - Часть дня
     - текст
     - in the morning
   * - h 
     - время в 12-часовом формате (1-12)
     - число
     - 12
   * - K 
     - количество часов в 12-часовом формате (0-11)
     - число
     - 0
   * - k 
     - количество часов в 24-часовом формате (1-24)
     - число
     - 18
   * - H 
     - часы в 24-часовом формате (0-23)
     - число
     - 6
   * - m 
     - минута часа
     - число
     - 32
   * - s 
     - секунды
     - число
     - 11
   * - S 
     - миллисекунды
     - число
     - 978
   * - A 
     - миллидень
     - число
     - 1234
   * - n 
     - наносекунды
     - число
     - 987654321
   * - N 
     - нанодень
     - число
     - 1234000000
   * - O 
     - смещение часового пояса
     - смещение
     - GMT+8; GMT+08:00; UTC-08:00
   * - X
     - смещение временной зоны относительно 0
     - смещение
     - 	Z; -08; -0830; -08:30; -083015; -08:30:15
   * - z 
     - смещение временной зоны
     - смещение
     - +0000; -08; -0830; -08:30; -083015; -08:30:15
   * - p 
     - следующий модификатор
     - модификатор
     - 1
   * - ’ 
     - символ экранирования для текста 
     - разделитель
     - ’Date=’
   * - ” 
     - кавычка 
     - литерал
     - ’o”clock’

Панель инструментов
---------------------------

.. tabularcolumns:: |>{\arraybackslash}\X{6}{17}|>{\arraybackslash}\X{11}{17}|
.. list-table:: Видимость
   :class: longtable
   :header-rows: 1

   * - Параметр
     - Описание
   * - Панель инструментов базы данных
     - Отображать/скрывать панель инструментов базы данных
   * - Панель инструментов приложения
     - Отображать/скрывать панель инструментов приложения
   * - Панель системных инструментов
     - Отображать/скрывать панель системных инструментов

Во вкладках ``Инструменты базы данных``, ``Инструменты приложения``, ``Системные инструменты`` и ``Инструменты редактора`` 
находятся настройки для определения набора инструментов соответствующих панелей.

Шрифты
-----------

Настройки шрифтов редактора запросов, дерева подключений и системной консоли.

Цвета
-------

Настройки цветов, которые используются в приложении.