PostgreSQL¶
Примечание
Эта страница описывает подключение к PostgreSQL как к хранилищу данных. Если вы хотите использовать PostgreSQL как базу данных приложения Glarus BI, см. Настройка базы данных приложения Glarus BI.
Чтобы добавить подключение к базе данных, нажмите значок шестерёнки в правом верхнем углу и перейдите в Управление > Базы данных > Добавить базу данных.
Заполните поля и нажмите Сохранить внизу страницы.
Параметры подключения¶
Тип базы данных¶
Выберите значение «PostgreSQL» из списка – в соответствии с подключаемым источником данных. Для подключения к Greenplum и Supabase используйте «PostgreSQL».
Строка подключения¶
Заполнение необязательно. Если вы вставите готовую строку подключения, поля ниже будут заполнены автоматически.
Название¶
Фактически это название подключения в Glarus BI, которое будет представлено в интерфейсе Glarus BI как «база данных».
Не является именем базы данных в СУБД (но может совпадать). Термин «база данных» в Glarus BI используется не для обозначения единицы в СУБД или самого процесса соединения, а как логический объект, который представляет ваш внешний источник данных внутри системы.
Хост¶
DNS или IP хоста, где размещены данные.
Порт¶
Номер порта СУБД. Для Postgres по умолчанию 5432.
Название базы данных¶
Название БД, к которой вы подключаетесь, в самой СУБД. Используется для адресации запросов по умолчанию.
Внимание
Введённое значение не ограничивает доступ рамками одной БД, если пользователю (роли) на уровне СУБД доступны несколько БД.
Имя пользователя¶
Логин сервисного пользователя в СУБД. Можно настроить несколько подключений к одной и той же базе данных с разными учётными записями и разными наборами прав.
Внимание
Запрещено использование неограниченных учётных записей СУБД: пользователь Glarus BI через редактор прямых запросов в этом случае увидит системные таблицы, сможет модифицировать данные, даже если в конструкторе запросов данные не видны.
Пароль¶
Пароль сервисного пользователя в СУБД.
Схемы¶
Здесь вы можете указать, какие схемы вы хотите синхронизировать и сканировать, чтобы их данные появились в интерфейсе Glarus BI, и появилась возможность выбора этих схем и их таблиц при построении запросов через конструктор.
Варианты:
- Все;
- Только эти…;
- Все, кроме….
Для "Только эти…" и "Все кроме…" вы можете ввести список значений, разделённых запятыми, чтобы сообщить Glarus BI, какие схемы вы хотите включить (или исключить). Например: foo,bar,baz.
Вы можете использовать подстановочный знак * для соответствия нескольким схемам.
Допустим, у вас есть три схемы: foo, bar и baz. Если вы выбрали Только эти… и ввели строку b*, вы будете синхронизироваться с bar и baz. Если у вас установлено Все, кроме…, и вы ввели строку b*, вы просто синхронизируете foo.
Обратите внимание, что поддерживается только подстановочный знак *; вы не можете использовать другие специальные символы или регулярные выражения.
Использовать защищённое соединение (SSL)¶
Glarus BI автоматически пытается сначала подключиться к базам данных с помощью SSL, затем без него в случае неудачи. Если возможно подключение к вашей базе данных через SSL-соединение, Glarus BI будет использовать SSL по умолчанию для вашей базы данных. Если вы предпочитаете подключаться без этого уровня безопасности, вы всегда можете изменить этот параметр позже, но мы настоятельно рекомендуем оставить SSL включенным для обеспечения безопасности данных.
Базы данных PostgreSQL поддерживают разные уровни безопасности соединений с разными уровнями накладных расходов.
Параметры режима SSL включают:
- allow;
- prefer;
- require;
- verify-ca;
- verify-full.
Если вы установите для режима SSL значение «verify-ca» или «verify-full», вам потребуется указать корневой сертификат (PEM). Вы можете использовать путь к локальному файлу или путь к загруженному файлу.
См. таблицу про разные режимы SSL в документации Postgres, англ. и выберите подходящий вариант.
Аутентифицировать клиентский сертификат¶
Включите, чтобы задать параметры клиентского сертификата.
Клиентский SSL‑сертификат (PEM)¶
Можно указать Local file path или Uploaded file path.
Ключ клиентского SSL‑сертификата (PKCS-8/DER)¶
Можно указать Local file path или Uploaded file path. Также потребуется ввести SSL Client Key Password.
Private key должен быть в формате PKCS8 и храниться в формате DER.
Если у вас вместо этого PEM SSL client key, вы можете конвертировать ключ в формат PKCS-8/DER с помощью openssl. Команда будет выглядеть примерно так:
Если вы используете GCP и у вас есть client certificates, всё будет в PEM. Нужно только преобразовать client-key.pem в client-key.der для параметра "SSL Client Key".
Использовать SSH‑туннель¶
См. руководство по SSH‑туннелированию.
Разрешить разворачивание столбцов JSON¶
В базах данных PostgreSQL Glarus BI может развернуть столбцы JSON в составные поля, чтобы получить таблицу, в которой каждый ключ JSON становится столбцом.
Разворачивание JSON включено по умолчанию, но вы можете отключить его, если производительность низкая.
Если вы включили разворачивание JSON, вы можете также включить его для отдельных столбцов в метаданных таблицы.
Дополнительные параметры строки подключения JDBC¶
Можно добавить параметры к строке подключения, которую Glarus BI использует для подключения к базе данных. Используйте формат:
Строка подключения PostgreSQL использует процентное кодирование для пробелов и символов.
Перезапустить запрос для простых исследований¶
Выключите эту опцию, если пользователи хотят нажать "Выполнить" (кнопку воспроизведения) перед применением любых группировок или выбором фильтров.
По умолчанию Glarus BI будет исполнять запрос сразу после выбора опции группировки из меню "Группировать" или условия фильтра из меню. Если ваша база данных медленная, вы можете отключить повторное выполнение, чтобы избежать загрузки данных при каждом нажатии.
Выберите, когда будет выполняться синхронизация и сканирование¶
Включите эту опцию, чтобы управлять запросами, которые Glarus BI использует для поддержания актуальности вашей базы данных. См. "Синхронизация и сканирование базы данных".
База данных синхронизируется¶
Расписание «лёгкой» синхронизации, проверяющей наличие обновление схемы базы данных.
Сканирование значений фильтров¶
Glarus BI может сканировать значения, присутствующие в каждом поле в этой базе данных, чтобы включить checkbox-фильтры на дашбордах и запросах. Это может быть довольно ресурсоёмким процессом, особенно если у вас очень большая база данных.
Если вы выбрали "Выберите, когда будет выполняться синхронизация и сканирование > ВКЛ", вы увидите следующие параметры в разделе:
-
Регулярно, по расписанию: позволяет запускать запросы сканирования с частотой, соответствующей скорости изменения вашей базы данных. Время устанавливается в часовом поясе сервера, где работает ваше приложение Glarus BI. Это лучший вариант для небольшой базы данных или таблиц с отдельными значениями, которые часто обновляются.
-
Только при добавлении виджета фильтра: выберите для запуска сканирования запросов по требованию. Включение этой опции означает, что Glarus BI будет сканировать и кэшировать значения полей, используемые при добавлении нового фильтра на дашборд или в SQL-запрос.
-
Никогда, я сделаю это вручную, если потребуется: это вариант для баз данных, которые либо чрезвычайно велики, либо в которых никогда не добавляются новые значения. Используйте кнопку в настройках сохранённого подключения к БД "Пересканировать значения полей", чтобы запустить ручное сканирование и обновить значения фильтра.
Периодический слепок таблиц¶
Включите эту опцию, чтобы сканировать образец значений каждый раз, когда Glarus BI выполняет синхронизацию.
Запрос слепков исследует первые 10 000 строк из каждого столбца и использует эти данные для приблизительной оценки количества уникальных значений в каждом столбце, минимальных и максимальных значений для числовых столбцов и столбцов с метками времени и т.д. Если вы оставите эту опцию выключенной, Glarus BI будет снимать слепки ваших столбцов только один раз во время настройки.
Периодическое снятие слепков увеличит нагрузку на вашу базу данных.
Подключение к Supabase, Greenplum¶
Чтобы подключиться к Supabase или Greenplum, выберите PostgreSQL.
Пример подключения к Supabase см. в документации Supabase, англ..
Блок "Подключение"¶
После подключения к базе данных вы увидите раздел «Подключение», где отображается текущий статус подключения и параметры управления соединением.
Здесь можно синхронизировать схему базы данных и пересканировать значения полей, а также отредактировать параметры подключения.
«Выполнить синхронизацию схемы» немедленно запустит процесс обновления объектов БД для представления в интерфейсе для данного подключения.
«Пересканировать значения полей» немедленно запустит задание, которое актуализирует значения полей для виджетов фильтров.
Ограничение «только чтение» в настройках подключения к БД¶
В рамках системы Glarus BI вы можете ограничить пользователям возможность записи в БД в настройках подключения. Ограничение будет работать только внутри Glarus BI и только если пользователь не входит в группу с разрешительным доступом. За пределами Glarus BI пользователи смогут модифицировать данные, используя учётные данные СУБД, если узнают их.
Ограничение «только чтение» сделает невозможным сохранение XLSX в данном подключении и нарушит кэширование моделей, если подключение используется как целевое хранилище. В этом случае вы можете использовать ещё одно подключение с другими настройками доступа групп Glarus BI к данным.
- Откройте Управление > Базы данных > (подключение) > Редактировать данные подключения.
- Нажмите «Отобразить дополнительные параметры».
- В «Дополнительные параметры подключения JDBC» запишите:
readOnlyMode=always. - Сохраните настройки подключения.
- Проверьте результат.
Блок "Детали модели"¶
Выберите, нужно ли включать функции, связанные с моделями Glarus BI. Эти функции часто требуют, чтобы сервисный пользователь базы данных имел разрешения на чтение и запись.
Действия для моделей¶
Включите, чтобы разрешить запуск действий для моделей, созданных на основе этих данных. Действия могут читать, записывать и, возможно, удалять данные. Пользователю базы данных понадобятся разрешения на запись.
Кэширование моделей¶
Glarus BI создаст таблицы с данными модели и будет обновлять их по расписанию, которое вы зададите стандартным механизмом. Чтобы включить стандартное кэширование моделей, нужно выдать учётным данным подключения привилегии на чтение и запись в схему, которую предоставляет Glarus BI.
Блок "Хранилище Glarus BI"¶
Включить хранилище Excel в этой БД¶
Выбирает текущее подключение в качестве целевого для хранения таблиц, полученных при импорте XLSX-файлов. Отменяет признак хранилища Excel в других подключениях.
Включить расширенное кэширование моделей в эту БД¶
Выбирает текущее подключение в качестве целевого для хранения таблиц кэша моделей. Отменяет признак хранилища кэша моделей в других подключениях.
Включить расширенное кэширование из этой БД¶
Когда включено, будет использоваться расширенный механизм кэширования моделей, созданных на основе данных таблиц этой БД.
Блок "Опасная зона"¶
См. информацию про "опасную зону".