PostgreSQL¶
Эта страница описывает подключение к PostgreSQL как к хранилищу данных. Если вы хотите использовать PostgreSQL как базу данных приложения Glarus BI, см. Настройка базы данных приложения Glarus BI.
Чтобы добавить подключение к базе данных, нажмите значок gear в правом верхнем углу и перейдите в Admin settings > Databases > Add a database.
Заполните поля и нажмите Save changes внизу страницы.
Поддерживаемые версии¶
Glarus BI поддерживает версии PostgreSQL от самой старой поддерживаемой до последней стабильной. См. PostgreSQL versions.
Подключение к Supabase¶
Чтобы подключиться к базе данных Supabase, выберите PostgreSQL. Подробнее см. в документации Supabase.
Подключение и синхронизация (Connection and sync)¶
После подключения к базе данных вы увидите раздел «Connection and sync», где отображается текущий статус подключения и параметры управления соединением.
Здесь можно синхронизировать схему базы данных и пересканировать значения полей, а также отредактировать параметры подключения.
Изменение параметров подключения¶
Эти параметры можно изменить в любое время. Не забудьте сохранить изменения.
Строка подключения¶
Вставьте строку подключения, чтобы автоматически заполнить поля ниже.
Отображаемое название¶
Отображаемое название базы данных в интерфейсе Glarus BI.
Хост¶
IP‑адрес базы данных или доменное имя (например, esc.mydatabase.com).
Порт¶
Порт базы данных. Например, 5432.
Название базы данных¶
Название базы данных, к которой вы подключаетесь.
Имя пользователя¶
Имя пользователя базы данных, с помощью которого вы хотите подключаться. Можно настроить несколько подключений к одной и той же базе данных с разными учётными записями и разными наборами привилегий.
Пароль¶
Пароль для пользователя базы данных.
Использовать провайдера аутентификации¶
{% include plans-blockquote.html feature="Authenticating with a provider" %}
Вместо пароля можно аутентифицироваться с помощью поддерживаемого провайдера.
Только для self-hosted тарифов Pro и Enterprise.
Azure Managed Identity¶
Чтобы использовать Azure Managed Identity, вам нужно указать client ID.
OAuth¶
Чтобы использовать Oauth как провайдера, вам нужно указать:
- Auth token URL
- Auth token request headers (JSON map)
Схемы¶
Вы можете указать, какие схемы нужно синхронизировать и сканировать. Варианты:
- All
- Only these...
- All except...
Для вариантов Only these... и All except... можно указать список значений через запятую. Например:
Можно использовать wildcard * для сопоставления нескольких схем.
Допустим, у вас есть три схемы: foo, bar и baz.
- Если выбрано Only these... и вы ввели
b*, синхронизируются bar и baz. - Если выбрано All except... и вы ввели
b*, синхронизируется только foo.
Поддерживается только wildcard *; другие спецсимволы и regex не поддерживаются.
Использовать защищённое соединение (SSL)¶
Glarus BI автоматически пытается подключаться к базам данных по SSL, а если это не получается — без SSL. Если SSL‑подключение возможно, Glarus BI сделает SSL вариантом по умолчанию. При необходимости вы можете отключить SSL, но мы настоятельно рекомендуем оставлять SSL включённым, чтобы защитить данные.
Режим SSL¶
Варианты режима SSL:
- allow
- prefer
- require
- verify-ca
- verify-full
См. таблицу про разные SSL Modes и выберите подходящий вариант.
Корневой SSL‑сертификат (PEM)¶
Если вы установили режим SSL в "verify-ca" или "verify-full", вам нужно указать корневой сертификат (PEM). Можно указать Local file path или Uploaded file path. В Metabase Cloud нужно выбрать Uploaded file path и загрузить сертификат.
Аутентифицировать клиентский сертификат¶
Включите, чтобы задать параметры клиентского сертификата.
Клиентский SSL‑сертификат (PEM)¶
Можно указать Local file path или Uploaded file path. В Metabase Cloud нужно выбрать Uploaded file path и загрузить сертификат.
Ключ клиентского SSL‑сертификата (PKCS-8/DER)¶
Можно указать Local file path или Uploaded file path. В Metabase Cloud нужно выбрать 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 unfolding, вы также можете переключать разворачивание для отдельных столбцов в метаданных таблицы.
Дополнительные параметры строки подключения JDBC¶
Можно добавить параметры к строке подключения, которую Glarus BI использует для подключения к базе данных. Используйте формат:
PostgreSQL connection URIs ожидают percent-encoding для пробелов и символов.
Перезапускать запросы при простых изменениях¶
Выключите эту опцию (OFF), если пользователи хотят нажимать Run (кнопку воспроизведения) перед применением любых Summarize или фильтров.
По умолчанию Glarus BI выполнит запрос, как только вы выберете вариант группировки из меню Summarize или условие фильтра из drill-through меню. Если база данных работает медленно, возможно, стоит отключить автоматический перезапуск, чтобы не загружать данные при каждом клике.
Выберите, когда запускать синхронизацию и сканирование¶
См. "Синхронизация и сканирование базы данных"
Периодически снимать слепки таблиц¶
Периодическое снятие слепков таблиц увеличит нагрузку на вашу базу данных.
Включите (ON), чтобы сканировать выборку значений каждый раз, когда Glarus BI запускает синхронизацию.
Запрос fingerprinting анализирует первые 10 000 строк каждого столбца и оценивает, сколько уникальных значений у столбца, какие минимальные и максимальные значения у числовых столбцов и столбцов временных меток и т. д. Если оставить опцию OFF, Glarus BI выполнит fingerprinting столбцов только один раз во время настройки.
Возможности моделей¶
Выберите, нужно ли включать функции, связанные с моделями Glarus BI. Эти функции часто требуют, чтобы пользователь базы данных, под которым вы подключаетесь, имел привилегии на чтение и запись.
Actions для моделей¶
Включите, чтобы разрешить запуск actions для моделей, созданных на основе этих данных. Actions могут читать, записывать и, возможно, удалять данные. Пользователю базы данных понадобятся привилегии на запись.
Сохранение моделей (model persistence)¶
Glarus BI создаст таблицы с данными модели и будет обновлять их по расписанию, которое вы зададите. Чтобы включить model persistence, нужно выдать учётным данным подключения привилегии на чтение и запись в схему, которую предоставляет Glarus BI.
Редактирование данных таблиц¶
Включите (ON), чтобы разрешить редактирование данных таблиц прямо в Glarus BI. Когда включено, администраторы смогут создавать, обновлять и удалять записи в таблицах через интерфейс Glarus BI.
Чтобы включить эту возможность, подключение к базе данных должно иметь привилегии на запись. То есть пользователь базы данных, под которым Glarus BI подключается к вашей базе, должен иметь соответствующие привилегии, чтобы изменять данные в таблицах, которые вы хотите сделать редактируемыми.
Опасная зона (Danger zone)¶
См. опасную зону.