# PostgreSQL

Чтобы добавить подключение к базе данных, нажмите на иконку **шестеренки** в правом верхнем углу и перейдите в **Настройки администратора** > **Базы данных** > **Добавить базу данных**.

## Настройки подключения

Вы можете изменить эти настройки в любое время. Просто не забудьте сохранить ваши изменения.

### Отображаемое имя

Имя, которое будет отображаться в интерфейсе GlarusBI.

### Хост

IP адрес базы данных или ее доменное имя (например, esc.mydatabase.com).

### Порт

Порт базы данных. Например, 5432.

### Имя базы данных

Имя базы данных, к которой вы подключаетесь.

### Имя пользователя

Имя пользователя базы данных для учетной записи, которую вы хотите использовать для подключения к базе данных. Вы можете настроить несколько подключений к одной и той же базе данных, используя разные учетные записи пользователей для подключения к одной и той же базе данных, каждая из которых имеет различные наборы [привилегий](../users-roles-privileges.md).

### Пароль

Пароль для имени пользователя, которое вы используете для подключения к базе данных.

## Схемы

Здесь вы можете указать, какие схемы вы хотите синхронизировать и сканировать. Варианты:

- Все
- Только эти...
- Все, кроме...

Для параметров **Только эти** и **Все кроме** вы можете ввести список значений, разделенных запятыми, чтобы сообщить GlarusBI, какие схемы вы хотите включить (или исключить). Например:

```
foo,bar,baz
```

Вы можете использовать подстановочный знак `*` для соответствия нескольким схемам.

Допустим, у вас есть три схемы: foo, bar и baz.

- Если вы установили **Только эти...** и ввели строку `b*`, вы будете синхронизироваться с bar и baz.
- Если у вас установлено **Все, кроме...**, и вы ввели строку `b*`, вы просто синхронизируете foo.

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

### Используйте безопасное соединение (SSL)

#### Режим SSL

Базы данных PostgreSQL поддерживают разные уровни безопасности соединений с разными уровнями накладных расходов.

Параметры режима SSL включают:

- позволять
- предпочитать
- требовать
- проверить-ca
- проверить-полный

См. документацию PostgreSQL для получения таблицы о различных [режимах SSL](https://jdbc.postgresql.org/documentation/ssl/#configuring-the-client) и выберите вариант, который вам подходит.

#### Корневой сертификат SSL (PEM)

Если вы установите для режима SSL значение «verify-ca» или «verify-full», вам потребуется указать корневой сертификат (PEM). Вы можете использовать **путь к локальному файлу** или **путь к загруженному файлу**. Если вы используете GlarusBI Cloud, вам нужно будет выбрать **Путь к загруженному файлу** и загрузить свой сертификат.

### Используйте туннель SSH

См. наше [руководство по туннелированию SSH](../ssh-tunnel.md).


### Проверка подлинности сертификата клиента

Включите для отображения параметров клиентского сертификата.

#### Сертификат клиента SSL (PEM)

Вы можете использовать **путь к локальному файлу** или **путь к загруженному файлу**. Если вы используете GlarusBI Cloud, вам нужно будет выбрать **Путь к загруженному файлу** и загрузить свой сертификат.

#### Клиентский ключ SSL (PKCS-8/DER)

Опять же, у вас есть возможность использовать **путь к локальному файлу** или **путь к загруженному файлу**. Если вы используете GlarusBI Cloud, вам нужно будет выбрать **Путь к загруженному файлу** и загрузить свой сертификат. Вам также потребуется ввести свой **пароль ключа клиента SSL**.

Закрытый ключ должен быть PKCS8 и храниться в формате DER.

Если вместо этого у вас есть клиентский ключ PEM SSL, вы можете преобразовать этот ключ в формат PKCS-8/DER, используя [openssl](https://www.openssl.org/). Команда будет выглядеть примерно так:

```
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 GlarusBI может развернуть столбцы JSON в составные поля, чтобы получить таблицу, в которой каждый ключ JSON становится столбцом. Развертывание JSON включено по умолчанию, но вы можете отключить его, если производительность низкая.

Если вы включили развертывание JSON, вы можете включить развертывание отдельных столбцов в [метаданных таблицы](../../data-modeling/metadata-editing.md#unfold-json).

### Дополнительные параметры строки подключения JDBC

 Вы можете добавлять параметры к строке подключения, которую GlarusBI использует для подключения к вашей базе данных. Используйте следующий формат:

```
options=-c%20key=value
```
В URI подключений к PostgreSQL необходимо использовать [percent-encoding](https://developer.mozilla.org/en-US/docs/Glossary/Percent-encoding) для пробелов и символов.

###  Перезапускать запросы для простых исследований

Выключите эту опцию, если пользователи хотят нажать **Run** (кнопка воспроизведения) перед применением любых [Группировок](../../questions/query-builder/introduction.md#grouping-your-metrics) или выбором фильтров.

По умолчанию GlarusBI будет исполнять запрос сразу после выбора опции группировки из меню **Группировать** или условия фильтра из [меню](https://www.metabase.com/learn/questions/drill-through). Если ваша база данных медленная, вы можете отключить повторное выполнение, чтобы избежать загрузки данных при каждом нажатии.

### Выберите, когда GlarusBI будет запускать синхронизацию и сканирование

Включите эту опцию, чтобы управлять запросами, которые GlarusBI использует для поддержания актуальности вашей базы данных. Для получения дополнительной информации см. [Синхронизация и сканирование баз данных](../sync-scan.md).

#### Синхронизация базы данных

Если вы выбрали **Выберите, когда GlarusBI будет запускать синхронизацию и сканирование** > **ВКЛ**, вы сможете установить:

- Частота [сканирования](../sync-scan.md#how-database-scans-work) раз в час или  раз в день.
- Время, когда сканирование будет запущено, в часовом поясе сервера, где работает ваше приложение GlarusBI.

### Сканирование значений фильтров

GlarusBI может сканировать значения, присутствующие в каждом поле в этой базе данных, чтобы включить фильтры флажков в панелях инструментов и вопросах. Это может быть довольно ресурсоемким процессом, особенно если у вас очень большая база данных.

Если вы выбрали **Выберите, когда GlarusBI будет запускать синхронизацию и сканирование** > **ВКЛ**, вы увидите следующие параметры в разделе **Сканирование значений фильтров**:

- **Регулярно, по расписанию** позволяет запускать [запросы сканирования](../sync-scan.md#how-database-scans-work) с частотой, соответствующей скорости изменения вашей базы данных. Время устанавливается в часовом поясе сервера, где работает ваше приложение GlarusBI. Это лучший вариант для небольшой базы данных или таблиц с отдельными значениями, которые часто обновляются.
- **Только при добавлении нового виджета фильтра** - отличный вариант, если вы хотите, чтобы запросы сканирования запускались по требованию. Включение этой опции означает, что GlarusBI будет сканировать и кэшировать значения поля(ей), используемые при добавлении нового фильтра на панель инструментов или SQL-вопрос.
- **Никогда, я сделаю это вручную, если мне это понадобится** - это вариант для баз данных, которые либо чрезвычайно велики, либо в которых никогда не добавляются новые значения. Используйте кнопку [Повторно отсканировать значения поля сейчас](../sync-scan.md#manually-scanning-column-values), чтобы запустить ручное сканирование и обновить значения фильтра.

## Дополнительная информация

- [Управление базами данных](../../databases/connecting.md)
- [Редактирование метаданных](../../data-modeling/metadata-editing.md)
- [Модели](../../data-modeling/models.md)
- [Установка разрешений на доступ к данным](../../permissions/data.md)