SQL & SQLAlchemy vs Jupyter Book

Для проработки базовых знаний по MySQL, полученных на курсе Аналитик данных в Skillbox, выбрал из обзора Лучшие книги по SQL на Rutube топ обзора: Изучаем SQL. Генерация, выборка и обработка данных, 3-е изд. Алан Болье (O’Reilly) пер. 2021.

Возник вопрос: где делать практику? Чтобы была возможность вернуться: подсмотреть/вспомнить код (запрос) и увидеть вывод (результат запроса).

• В книге используется клиент командной строки mysql (MySQL 8.0 Command Line Client) – но тогда не сохранится ни код (запрос), ни вывод. Можно конечно использовать логирование в текстовый файл с помощью команды tee, но мне этот способ оказался менее удобен в сравнении с итоговым решением.

• Можно использовать графический IDE, например, DBeaver – код сохранится, но вывод нет. По крайней мере в версии Community инструмента SQL Notebook нет.

Подсказку нашел в книге SQL. Pocket guide, 4-е изд. Элис Жао (O’Reilly) пер. 2024. В Главе 2 описывается подключение Python к базе данных через драйвер mysql-connector-python. Но в итоге выбор пал на PyMySQL и SQLAlchemy.

Вопрос вроде бы был уже решен, но тут появилась “подкожная” мысль, которая и стала причиной этого гайда: что если для доступа к блокнотам использовать не просто GitHub, а создать статический сайт с функцией поиска?

Опыт с Material for MkDocs у меня уже был, но он использует только файлы Markdown. И тут я вспомнил про книгу Learning Data Science, которая Powered by Jupyter Book. И мое желание быстрее приступить к проработке SQL пришлось отложить на исследование нового инструмента и на составление гайда – потому что я не смог повторить сходу все установки/настройки и прочие манипуляции на втором компе.

А ещё потому что:

• Пришлось искать костыльное решение для отображения синтаксиса SQL на сайте: потому что JupySQL подсвечивает синтаксис в блокноте Jupyter, но не на созданном с помощью Jupyter Book сайте. В этот момент идею с сайтом хотелось уже бросить в пользу обычного хранения на GitHub.

• Плюс у “подкожной мысли” появилось продолжение: а что если доступ к GitHub заблокируют? Смогу ли использовать отечественный GitVerse? Если да – как использовать GitHub и GitVerse в параллели с одним локальным репозиторием?

На случай если кому-то пригодятся мои изыскания решил поделиться.