PostgreSQL¶
Чтобы добавить подключение к базе данных, нажмите шестерёнку в правом верхнем углу и перейдите в Управление > Базы данных > Добавить базу данных.
Настройки подключения¶
Вы можете изменить эти настройки в любое время. Просто не забудьте сохранить ваши изменения.
Отображаемое имя¶
Имя, которое будет отображаться в интерфейсе Glarus BI.
Хост¶
IP-адрес базы данных или её доменное имя (например, esc.mydatabase.com).
Порт¶
Порт базы данных. Например, 5432.
Имя базы данных¶
Имя базы данных, к которой вы подключаетесь.
Имя пользователя¶
Имя пользователя базы данных для учётной записи, которую вы хотите использовать для подключения к базе данных. Вы можете настроить несколько подключений к одной и той же базе данных, используя разные учётные записи пользователей для подключения к одной и той же базе данных, каждая из которых имеет различные наборы разрешений.
Пароль¶
Пароль для имени пользователя, которое вы используете для подключения к базе данных.
Схемы¶
Здесь вы можете указать, какие схемы вы хотите синхронизировать и сканировать. Варианты:
«Все»;
«Только эти…»;
«Все, кроме…».
Для параметров Только эти… и Все кроме… вы можете ввести список значений, разделённых запятыми, чтобы сообщить Glarus BI, какие схемы вы хотите включить (или исключить). Например:
foo,bar,baz
Вы можете использовать подстановочный знак * для соответствия нескольким схемам.
Допустим, у вас есть три схемы: foo, bar и baz.
если вы установили Только эти… и ввели строку
b*, вы будете синхронизироваться с bar и baz;если у вас установлено Все, кроме…, и вы ввели строку
b*, вы просто синхронизируете foo.
Обратите внимание, что поддерживается только подстановочный знак *; вы не можете использовать другие специальные символы или регулярные выражения.
Используйте безопасное соединение (SSL)¶
Режим SSL¶
Базы данных PostgreSQL поддерживают разные уровни безопасности соединений с разными уровнями накладных расходов.
Параметры режима SSL включают:
allow;
prefer;
require;
verify-ca;
verify-full.
См. документацию PostgreSQL для получения таблицы о различных режимах SSL и выберите вариант, который вам подходит.
Корневой сертификат SSL (PEM)¶
Если вы установите для режима SSL значение «verify-ca» или «verify-full», вам потребуется указать корневой сертификат (PEM). Вы можете использовать путь к локальному файлу или путь к загруженному файлу. Если вы используете Glarus BI Cloud, вам нужно будет выбрать Путь к загруженному файлу и загрузить свой сертификат.
Используйте туннель SSH¶
См. наше руководство по туннелированию SSH.
Проверка подлинности сертификата клиента¶
Включите для отображения параметров клиентского сертификата.
Сертификат клиента SSL (PEM)¶
Вы можете использовать путь к локальному файлу или путь к загруженному файлу. Если вы используете Glarus BI Cloud, вам нужно будет выбрать Путь к загруженному файлу и загрузить свой сертификат.
Клиентский ключ SSL (PKCS-8/DER)¶
Опять же, у вас есть возможность использовать путь к локальному файлу или путь к загруженному файлу. Если вы используете Glarus BI Cloud, вам нужно будет выбрать Путь к загруженному файлу и загрузить свой сертификат. Вам также потребуется ввести свой пароль ключа клиента SSL.
Закрытый ключ должен быть PKCS8 и храниться в формате DER.
Если вместо этого у вас есть клиентский ключ PEM SSL, вы можете преобразовать этот ключ в формат PKCS-8/DER, используя openssl. Команда будет выглядеть примерно так:
openssl pkcs8 -topk8 -inform PEM -outform DER -in client-key.pem -out client-key.der -nocrypt
Примечание. Если вы используете GCP, и вам удалось выдать клиентские сертификаты, всё будет предоставлено в формате PEM, вам нужно только преобразовать client-key.pem в client-key.der для «SSL Client Key».
Развернуть столбцы JSON¶
В базах данных PostgreSQL Glarus BI может развернуть столбцы JSON в составные поля, чтобы получить таблицу, в которой каждый ключ JSON становится столбцом. Развёртывание JSON включено по умолчанию, но вы можете отключить его, если производительность низкая.
Если вы включили развёртывание JSON, вы можете включить развёртывание отдельных столбцов в метаданных таблицы.
Дополнительные параметры строки подключения JDBC¶
Вы можете добавлять параметры к строке подключения, которую Glarus BI использует для подключения к вашей базе данных. Используйте следующий формат:
options=-c%20key=value
В URI подключений к PostgreSQL необходимо использовать percent-encoding для пробелов и символов.
Перезапускать запросы для простых исследований¶
Выключите эту опцию, если пользователи хотят нажать Run (кнопка воспроизведения) перед применением любых группировок или выбором фильтров.
По умолчанию Glarus BI будет исполнять запрос сразу после выбора опции группировки из меню Группировать или условия фильтра из меню. Если ваша база данных медленная, вы можете отключить повторное выполнение, чтобы избежать загрузки данных при каждом нажатии.
Выберите, когда будет выполняться синхронизация и сканирование¶
Включите эту опцию, чтобы управлять запросами, которые Glarus BI использует для поддержания актуальности вашей базы данных. Для получения дополнительной информации см. Синхронизация и сканирование баз данных.
Синхронизация базы данных¶
Если вы выбрали Выберите, когда будет выполняться синхронизация и сканирование > ВКЛ, вы сможете установить:
частоту сканирования: раз в час или раз в день;
время, когда сканирование будет запущено, в часовом поясе сервера, где работает ваше приложение Glarus BI.
Сканирование значений фильтров¶
Glarus BI может сканировать значения, присутствующие в каждом поле в этой базе данных, чтобы включить checkbox-фильтры в панелях инструментов и вопросах. Это может быть довольно ресурсоёмким процессом, особенно если у вас очень большая база данных.
Если вы выбрали Выберите, когда будет выполняться синхронизация и сканирование > ВКЛ, вы увидите следующие параметры в разделе Сканирование значений фильтров:
Регулярно, по расписанию позволяет запускать запросы сканирования с частотой, соответствующей скорости изменения вашей базы данных. Время устанавливается в часовом поясе сервера, где работает ваше приложение Glarus BI. Это лучший вариант для небольшой базы данных или таблиц с отдельными значениями, которые часто обновляются.
Только при добавлении виджета-фильтра — отличный вариант, если вы хотите, чтобы запросы сканирования запускались по требованию. Включение этой опции означает, что Glarus BI будет сканировать и кэшировать значения поля(ей), используемые при добавлении нового фильтра на панель инструментов или SQL-вопрос.
Никогда, я сделаю это вручную, если мне это понадобится — это вариант для баз данных, которые либо чрезвычайно велики, либо в которых никогда не добавляются новые значения. Используйте кнопку Повторно отсканировать значения поля сейчас, чтобы запустить ручное сканирование и обновить значения фильтра.