Подключение БД с 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

   

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

   

    

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

   

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

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

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

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

      

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

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

      

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

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

   

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

   

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

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

      

Настройка PowerBI

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

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

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

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

4. Жмём ok

   

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

   

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

   

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

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

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