Чаще всего встречается в URL, но все же его значение чуть более шире - slug - это уникальная строка-идентификатор, понятная человеку (в отличие от ID) и содержащая только “безопасные” символы:
0-9
a-z (общепринято - в нижнем регистре)
символ -
иногда еще символ _
Могут использоваться не только в URL для понятности, но и например в запросах к БД - ведь команда:
… более понятно, чем:
В общем это - человеко-понятный уникальный идентификатор.
Установка Prisma выполняется очень просто - при помощи двух команд. Первая - устанавливает клиентскую часть Prisma:
… вторая команда - устанавливает cli-часть Prisma:
После этого - нужно запустить команду для инициализации Prisma в текущем проекте:
В результате в корне проекта будет создана папка prisma, внутри которой будет находиться файл schema.prisma для настройки подключения Prisma к базе данных (и не только это).
Содержимое файла очень простое:
Наиболее существенные здесь две вещи - это драйвер postgresql для подключения к базе данных Postgres (по умолчанию используется подключение именно к Postgres). Если база данных другая - MySQL и тп - то меняем на нужный драйвер.
Вторая - это строка url, которая используется как настроечный файл для подключения к базе данных. Эта строка (в виде переменной DATABASE_URL) хранится в файле .env, который также автоматически создается Prisma при инициализации.
Если посмотреть на содержимое файла .env, то он будет таким:
То есть - в одной строке - выполняется полная настройка подключения к существующей базе данных. В моем учебном случае это выглядит таким образом:
То есть - postgres - имя пользователя базы данных; 123 - пароль пользователя базы данных; udemy_medium_clone - имя базы данных.
Откуда я взял\узнал эти данные? Просто я заранее создал учебную базу данных в Postgres, у себя локально (в моем случае):
localhost:5432 - я оставил по умолчанию, так как - у меня Postgres также по умолчанию слушает этот порт.
Не забываем добавить файл .env в .gitignore, чтобы данные не засветились на удаленном репозитории - и все, основная настройка Prisma завершена.
Prisma - миграция баз данных
В моем случае - база данных udemy_medium_clone - чистая, в ней пока нет никаких таблиц. Это можно исправить двумя способами.
Первый - создать таблицу в базе данных силами самого SQL и затем выполнить преобразование таблицы в модель данных (Prisma schema) в проекте - командой:
Второй - наоборот, создать модель данных Prisma в проекте и затем мигрировать ее в Postgres, что автоматически приведет к созданию такой таблицы в базе данных.
Давайте поступим по второму варианту. Создадим в файле schema.prisma модель данных пользователя будущего приложения:
(кстати - под VSC и WS - есть специальные плагины для подсветки синтаксиса и форматирования файлов с расширением *.prisma; для VSC плагин работает отлично, для WS - так себе).
И все - можно выполнить миграцию в базу данных командой:
… где –name users - это имя конкретной миграции, чтобы можно было локально увидеть и отследить эту операцию. По выполнении Prisma выведет в консоль отчет об успешной операции:
Как видно из отчета, Prisma создала подпапку migrations, внутри которой будут находиться - папки с детальной информацией по каждой конкретной миграции.
В моем случае - это будет папка 20220223160632_users (помним о ключе –name users) и внутри этой папки - любопытный файлик migration.sql. Если открыть этот файлик, то увидим не что иное, как набор обычных sql-команд по созданию таблицы базы данных:
То есть, по факту - сперва была выполнена операция по преобразованию Prisma-модели в такой sql-запрос, а уже потом - этот запрос выполнился и была создана таблица в базе данных.
А давайте проверим, так ли это на самом деле? Легко!
… правда - таблица users была создана. А давайте посмотрим - что из себя представляет эта таблица users:
… хм, очень похоже на правду - это именно такая таблица, какую я спроектировал в качестве модели в Prisma.
Заключение
Ну вот в принципе и все - Prisma установлена в проекте, успешно настроено ее подключение к конкретной базе данных; создана модель данных и выполнена успешная миграция ее в таблицу в базе данных. Prisma успешно подключена и готова к работе.
Конечно же, есть еще один инструмент для работы с базой данных в Next - это TypeORM. Но его настройка и подключение для меня настолько сложна, запутанна и трудоемка, что я не стыжусь признаться, что TypeORM я не знаю и особого желания знать пока не возникло.
Самый простой пример получения всех данных (колонок) из таблицы в базе данных - при помощи Prisma такой:
… что является аналогом такой sql-команды, например:
Но что, если нужно получить в Prisma - только определенный набор колонок? При помощи sql-команды это делается просто:
Как же выполнить точно такой же запрос - в Prisma? Это можно сделать при помощи дополнительной опции select.
В принципе - в оф. доке все описано - “… select defines which fields are included in the object that Prisma Client returns …” - “… select определяет, какие поля будут включены в объект, который возвращает Prisma Client …”.
Есть такой отличный музыкальный плейер - CMUS; прелесть его в том, что он - консольный, легковесный; висит в фоновом режиме - и играет тебе музыку. Он богат функционалом, но вот его команды - приходится запоминать.
Шаги для создания playlist и папки с музыкой\аудиокнигой. Команды у CMUS - vim-подобные, начинаются с символа двоеточия.
Создание самого playlist’а
Достаточно выполнить такую командой - в любом окне CMUS:
Переход в окно с playlist’ами
Жмем кнопочку с циферкой 3 - чтобы перейти в окно, в котором отображаются все playlist’ы - они будут слева, в колонку расположены. Подводим под вновь созданный playlist курсор (arrow-keys) и жмем Space, чтобы выделить этот playlist.
Добавление файлов в playlist
Вводим команду - для добавления файлов в выделенный playlist. В моем случае - это папка с файлами аудиокниги:
Единственное неудобство - CMUS не понимает пути к файлам, если они написаны кириллицей, не латиницей; приходится заранее - переименовывать папку, перед ее добавлением в playlist CMUS. По крайней мере - я пока не нашел, как заставить CMUS понимать кириллицу в путях.
Когда команда выполнится - в правой колонке окна под номером 3 - появится список аудио-файлов, которые привязаны к данному playlist’у. Можно переходить курсором на этот список - и пользоваться.