Snowflake¶
Чтобы добавить подключение к базе данных, нажмите на шестерёнку в правом верхнем углу и перейдите в Управление > Базы данных > Добавить базу данных.
Настройки подключения¶
Вы можете изменить эти настройки в любое время. Просто не забудьте сохранить ваши изменения.
Название¶
Название подключения, которое будет отображаться в интерфейсе Glarus BI.
Имя учётной записи или имя хоста¶
У вас есть возможность использовать имя учётной записи или имя хоста. Ваше имя хоста — это IP-адрес вашей базы данных или её доменное имя (например, database.example.com).
Если ваш URL включает регион вашей базы данных, вы можете подключиться, используя имя учётной записи, в противном случае подключитесь, используя имя хоста.
AWS¶
Подключение с использованием имени учётной записи.
Введите идентификатор вашей учётной записи с регионом, в котором работает ваш кластер Snowflake. Например, xxxxxxxxx.us-east-3.aws. Например, если вы используете 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.
app.snowflake.com¶
Подключение с использованием имени хоста.
Вы можете получить имя хоста, перейдя в Администрирование > Учётные записи. Имя учётной записи будет в разделе Учётные записи. Нажмите на учётную запись, которую вы хотите использовать, и нажмите на значок ссылки, чтобы скопировать URL-адрес хоста: это ваше имя хоста. На изображении ниже Metabot скрывает конфиденциальную информацию. Ссылка "Копировать URL-адрес учётной записи" справа — это то, что вы ищете:
Узнайте больше об идентификаторах учётных записей в Snowflake.
Имя пользователя¶
Имя пользователя базы данных для учётной записи, которую вы хотите использовать для подключения к базе данных. Вы можете настроить несколько подключений к одной и той же базе данных, используя разные учётные записи пользователей для подключения к одной и той же базе данных, каждая из которых имеет разные наборы разрешений.
На странице учётной записи app.snowflake.com вы можете найти пользователей и роли в разделе Администрирование > Пользователи и роли.
Пароль¶
Пароль для подключения к базе данных, соответствующий имени пользователя.
Приватный ключ RSA (PEM)¶
У вас есть возможность использовать Локальный путь к файлу или Загруженный путь к файлу. Если вы находитесь в Metabase Cloud, вам нужно выбрать Загруженный путь к файлу и загрузить свой сертификат.
Хранилище¶
Хранилище Snowflake. Если у пользователя нет хранилища по умолчанию, вам нужно будет указать название хранилища для подключения.
В app.snowflake.com вы можете найти хранилища в разделе Администрирование > Хранилища.
Название базы данных (с учетом регистра)¶
Название базы данных, к которой вы хотите подключиться в Snowflake. В app.snowflake.com вы можете найти базы данных в разделе Данные > Базы данных.
Схемы (необязательно)¶
Вы можете указать, какие схемы вы хотите синхронизировать и сканировать. Если схема не указана, то все схемы, доступные этому пользователю и роли, будут перечислены как папки в Glarus BI.
Варианты:
- "Все";
- "Только эти…";
- "Все, кроме…".
Для параметров Только эти… и Все, кроме… вы можете ввести список значений, разделённых запятыми, чтобы сообщить Glarus BI, какие схемы вы хотите включить (или исключить). Например:
Вы можете использовать подстановочный знак * для соответствия нескольким схемам.
Допустим, у вас есть три схемы: FOO, BAR, и BAZ.
- Если вы установили Только эти… и ввели строку
B*, вы будете синхронизироваться с BAR и BAZ. - Если у вас установлено Все, кроме…, и вы ввели строку
B*, вы просто синхронизируете FOO.
Обратите внимание, что поддерживается только подстановочный знак *; вы не можете использовать другие специальные символы или регулярные выражения.
Роль (необязательно)¶
Укажите роль, чтобы переопределить роль по умолчанию пользователя базы данных. Например, если у пользователя базы данных METABASE есть роли:
- роль по умолчанию
APPLICATION; - дополнительная роль
ANALYTICS.
Вы можете ввести ANALYTICS в поле "Роль", чтобы гарантировать, что пользователь METABASE подключается к Snowflake с использованием роли ANALYTICS по умолчанию.
Использование SSH-туннеля¶
См. наше руководство по SSH-туннелированию.
Дополнительные параметры строки подключения JDBC¶
Вы можете добавлять параметры к строке подключения, которую Glarus BI использует для подключения к вашей базе данных.
Перезапускать запросы для простых исследований¶
Выключите эту опцию, если пользователи хотят нажать Run (кнопка воспроизведения) перед применением любых группировок или выбором фильтров.
По умолчанию Glarus BI будет исполнять запрос сразу после выбора опции группировки из меню Группировать или условия фильтра из меню (документация Metabase, англ.). Если ваша база данных медленная, вы можете отключить повторное выполнение, чтобы избежать загрузки данных при каждом нажатии.
Выберите, когда будет выполняться синхронизация и сканирование¶
Включите эту опцию, чтобы управлять запросами, которые Glarus BI использует для поддержания актуальности вашей базы данных. Для получения дополнительной информации см. Синхронизация и сканирование баз данных.
Синхронизация базы данных¶
Если вы выбрали Выберите, когда будет выполняться синхронизация и сканирование > ВКЛ, вы сможете установить:
- частоту синхронизации: каждый день или каждый час;
- время, когда синхронизация будет запущена, в часовом поясе сервера, где работает ваше приложение Glarus BI.
Сканирование значений фильтров¶
Glarus BI может сканировать значения, присутствующие в каждом поле в этой базе данных, чтобы включить checkbox-фильтры на дашбордах и запросах. Это может быть довольно ресурсоёмким процессом, особенно если у вас очень большая база данных.
Если вы выбрали Выберите, когда будет выполняться синхронизация и сканирование > ВКЛ, вы увидите следующие параметры в разделе Сканирование значений фильтров:
- Регулярно, по расписанию позволяет запускать запросы сканирования с частотой, соответствующей скорости изменения вашей базы данных. Время устанавливается в часовом поясе сервера, где работает ваше приложение Glarus BI. Это лучший вариант для небольшой базы данных или таблиц с отдельными значениями, которые часто обновляются.
- Только при добавлении виджета-фильтра — отличный вариант, если вы хотите, чтобы запросы сканирования запускались по требованию. Включение этой опции означает, что Glarus BI будет сканировать и кэшировать значения поля(ей), используемые при добавлении нового фильтра на дашборд или SQL-запрос.
- Никогда, я сделаю это вручную, если мне это понадобится — это вариант для баз данных, которые либо чрезвычайно велики, либо в которых никогда не добавляются новые значения. Используйте кнопку Повторно отсканировать значения поля сейчас, чтобы запустить ручное сканирование и обновить значения фильтра.
Периодический слепок таблиц¶
Предупреждение
Периодическое снятие слепков увеличит нагрузку на вашу базу данных.
Включите эту опцию, чтобы сканировать образец значений каждый раз, когда Glarus BI выполняет синхронизацию.
Запрос слепков анализирует первые 10 000 строк из каждого столбца и использует эти данные, чтобы оценить, сколько уникальных значений имеет каждый столбец, каковы минимальные и максимальные значения для числовых столбцов и столбцов с датами и временем и т. д. Если вы оставите эту опцию ВЫКЛ, Glarus BI будет снимать слепки ваших столбцов только один раз во время настройки.