Analytics

Подключение БД с SSH-туннелем к PowerBI

Всем привет! 

Оказалось, что PowerBI не имеет встроенной возможности настроить доступ к БД, защищённой SSH-туннелем. Приходится выкручиваться. Мне очень помогла эта статья — спасибо тебе добрый и компетентный в написании инструкций человек, без тебя я бы впала в отчаяние. 

И тем не менее, в ней раскрыты не все нюансы. В своём материале я добавлю следующее:

  • Два уникальных совета, как сделать так, чтобы установленный туннель не падал после авторизации

  • Дополнительная инструкция для подключения к SSH при помощи приватного ключа, а не логина и пароля

  • Скрины из самого PowerBI с настройкой БД и советы о том, как работает выборка из подключенной БД и как обновлять данные, полученные по SQL-запросам.

  • Плюс я ориентирую свой материал на продуктовых аналитиков и аналитиков данных, то есть на тех, у кого нет доступа на редактирование БД и кто может не знать, что такое проброс портов и SSH-tunnel в принципе.

  • Итак, поехали.

    Вам понадобится(этап подготовки):

    1. Установленный Putty. Можно взять здесь — https://www.putty.org/

    2. Данные от вашего бекенда или девопса по списку:

      1. IP-адрес SSH-сервера;

      2. порт SSH-сервера;

      3. username для доступа на SSH-сервер;

      4. пароль для доступа или связка приватного и публичного ключа*

      5. IP-адрес самой БД (обычно 127.0.0.1);

      6. порт самой БД;

      7. название БД;

      8. логин доступа к БД (не то же самое, что username для доступа на SSH-сервер);

      9. пароль для доступа к БД.

    *Выбирать пароль или ключ не вам, а Хранителю сервера, пароль проще, ключ — безопаснее. В статье будут инструкции на оба случая. Если у вас кейс с ключами, то на этапе подготовки вам надо сгенерить оба ключа, разместить их в нужную папку на вашем компьютере и отдать внешний ключ Хранителю сервера, чтобы он его туда добавил. На эту тему есть много инструкций в интернете, я не буду повторяться.

    Поднимаем SSH-туннель

    1. Открываем Putty

    2. В Category/Session вводим IP-адрес SSH-сервера, порт SSH-сервера и выставляем радио-баттон Close window on exit на позицию Never

      
      Подключение БД с SSH-туннелем к PowerBI

    3. Переходим в Category/Connection/SSH и ставим галочку на Don’t start a shell or command at all

      
      Подключение БД с SSH-туннелем к PowerBI

       

    4. Переходим в Category/Connection/SSH/Tunnels, в поле Source port вбиваем порт самой БД, в поле Destination IP-адрес самой БД:порт самой БД. Жмём Add.

      
      Подключение БД с SSH-туннелем к PowerBI

    5. *пункт для тех, кто подключается с приватным ключом, если у вас случай с логином и паролем, то переходите сразу к 6 пункту инструкции

      1. Запустите PuttyGen (установился на ваш компьютер вместе с Putty)

      2. Выберите в верхнем меню Conversions/Import Key

      3. В открывшемся окне Проводника откройте папку, куда вы сохранили файлы приватного и публичного ключа (пункт 2d списка “Вам понадобится”) и выберите файл приватного ключа. Иногда Windows делает этот файл скрытым. Возможно, вам надо будет включить отображение скрытых файлов в Проводнике, нажав на Вид и поставив галочку напротив “Скрытые элементы”

        
      Подключение БД с SSH-туннелем к PowerBI

      4. Нажимаем Save private key. Даём ключу любое имя на латинице и сохраняем в папку с ключами.

      5. Возвращаемся в Putty. Переходим в Category/Connection/SSH/Auth и нажимаем Browse рядом с Private key file for authentication

        
      Подключение БД с SSH-туннелем к PowerBI

      6. В открывшемся окне Проводника выбираем сохранённый в пункте 5d файл приватного ключа.

    6. Переходим в Category/Session, в поле Saved Session вводим имя нашего туннеля (любое), жмём Save. Это позволит нам не вводить все настройки каждый раз заново. После чего жмём Open

      
      Подключение БД с SSH-туннелем к PowerBI

    7. В открывшемся окне Терминала рядом с Login as вводим username для доступа на SSH-сервер и жмём Enter

      
      Подключение БД с SSH-туннелем к PowerBI

    8. *пункт для тех, у кого авторизация по паролю, если вы авторизовались по связке ключей, то пропускайте этот пункт и переходите сразу к 9. 

      1. Вводим пароль для доступа на SSH-сервер и жмём Enter

        
      Подключение БД с SSH-туннелем к PowerBI

    Настройка PowerBI

    SSH-туннель настроен, не закрывайте окно терминала Putty. Теперь переходим в PowerBI. Жмём Получить данные и выбираем “База данных MySQL” или “База данных PostgreSQL” в зависимости от того, что у вас. Интерфейс будет одинаковым, а вот вероятность успеха — разной, потому что MySQL И PostgreSQL используют разные драйвера. Убедитесь, что выбрали свою БД правильно. 

    1. В поле Сервер вводим IP-адрес самой БД:порт самой БД 

    2. В поле База данных вводим название БД

    3. Жмём “Расширенные настройки” и в поле Инструкция SQL вставляем запрос, по которому нужно импортировать данные. Если вы его не напишете, PowerBI приконнектится ко всей БД, но не позволит вам вытаскивать из неё данные запросами и не позволит построить модели (или я не нашла как, если у вас есть успешный опыт, с удовольствием прочитаю его в комментах)

    4. Жмём ok

      
      Подключение БД с SSH-туннелем к PowerBI

    5. Вводим логин доступа к БД и пароль для доступа к БД, жмём Подключение

      
      Подключение БД с SSH-туннелем к PowerBI

    6. Возможна вот такая ошибка, это ok

      
      Подключение БД с SSH-туннелем к PowerBI

    Как обновить данные из БД в PowerBI

    1. Поднимаем SSH-туннель в Putty

    2. Переходим в PowerBI и жмём Обновить. Все созданные запросы ещё раз отправятся на сервер и выгрузят свежую информацию

      
      Подключение БД с SSH-туннелем к PowerBI

    Related posts

    Как изменились хабравчане за 5 лет? Или «280 недель спустя»

    admin

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

    admin

    #GTMTips:

    admin

    Leave a Comment