# Snowflake

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

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

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

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

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

### Учётная запись

Введите идентификатор вашей учётной записи с регионом, в котором работает ваш кластер Snowflake. Например, `xxxxxxxxx.us-east-3.aws`.

Введите идентификатор вашей учётной записи Snowflake. Например, если вы используете Snowflake на AWS и ваш URL учётной записи — `https://az12345.ca-central-1.snowflakecomputing.com`:
- `<account_identifier>`: `az12345.ca-central-1`.
- `<cloud_platform>`: `aws`,

вам нужно ввести `az12345.ca-central-1.aws` в качестве имени учётной записи в Glarus BI.

> Не все регионы требуют идентификатора облачной платформы. Если вы находитесь в `us-west-2`, вы введёте `az12345` в качестве имени учётной записи. Для требований по регионам см. [официальную документацию Snowflake](https://docs.snowflake.com/en/user-guide/admin-account-identifier.html#non-vps-account-locator-formats-by-cloud-platform-and-region).

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

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

### Пароль

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

### Приватный ключ RSA (PEM)

У вас есть возможность использовать **Локальный путь к файлу** или **Загруженный путь к файлу**. Если вы находитесь в Metabase Cloud, вам нужно выбрать **Загруженный путь к файлу** и загрузить свой сертификат.

### Хранилище

Хранилище Snowflake. Если не используется хранилище по умолчанию, нужно указать название используемого хранилища при подключении.

### Имя базы данных (с учетом регистра)

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

## Схемы

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

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

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

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

Допустим, у вас есть три схемы: FOO, BAR, и BAZ.

- Если вы установили **Только эти…** и ввели строку `B*`, вы будете синхронизироваться с BAR и BAZ.
- Если у вас установлено **Все, кроме…**, и вы ввели строку `B*`, вы просто синхронизируете FOO.

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

### Роль (необязательно)

Укажите роль, чтобы переопределить роль по умолчанию пользователя базы данных. Например, если у пользователя базы данных `METABASE` есть роли:

- роль по умолчанию `APPLICATION`;
- дополнительная роль `ANALYTICS`.

Вы можете ввести `ANALYTICS` в поле "Роль", чтобы гарантировать, что пользователь `METABASE` подключается к Snowflake с использованием роли `ANALYTICS` по умолчанию.

## Использование SSH-туннеля

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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