Язык программирования C#9 и платформа .NET5

В текущей главе и многих оставшихся главах книги вам будет нужен доступ к экземпляру SQL Server. Если вы применяете машину разработки, на которой установлена ОС, отличающаяся от Windows, и у вас нет доступного внешнего экземпляра SQL Server, или вы решили не использовать внешний экземпляр SQL Server, то можете запустить SQL Server внутри контейнера Docker на рабочей станции Мае или Linux. Контейнер Docker функционирует и на машинах Windows, поэтому вы можете выполнять примеры в книге с применением Docker независимо от выбранной ОС.

Установка SQL Server в контейнер Docker

В случае использования машины разработки, основанной не на Windows, и отсутствии доступного для примеров экземпляра SQL Server вы можете запустить SQL Server внутри контейнера Docker на рабочей станции Мае или Linux. Контейнер Docker работает также на машинах Windows, поэтому вы можете выполнять примеры в книге с применением Docker независимо от выбранной ОС.

На заметку! Контейнеризация является крупной темой, и в этой книге просто нет места, чтобы углубиться в подробности контейнеров или Docker. Книга охватывает ровно столько, чтобы вы могли проработать примеры.

Docker Desktop можно загрузить по ссылке www.docker.com/get-started. Загрузите и установите подходящую версию (Windows, Mac, Linux) для своей рабочей станции (вам понадобится учетная запись DockerHub). Удостоверьтесь, что при выдаче запроса выбраны контейнеры Linux.

На заметку! Выбранный вариант контейнера (Windows или Linux) — это ОС, функционирующая внутри контейнера, а не ОС, установленная на рабочей станции.

Получение образа и запуск SQL Server 2019

Контейнеры основаны на образах, а каждый образ представляет собой многоуровневый набор, из которого образован финальный продукт. Чтобы получить образ, необходимый для запуска SQL Server 2019 в контейнере, откройте окно командной строки и введите следующую команду:

 docker pull mcr.microsoft.com/mssql/server:2019-latest

После загрузки образа на машину вам понадобится запустить SQL Server, для чего ввести следующую команду (целиком в одной строке):

 docker run -e "ACCEPT_EULA=Y" -e "SA_PASSWORD=P@ssw0rd"

– p 5433:1433 --name AutoLot -d mcr. microsoft.com/mssql/server:2019-latest

Предыдущая команда принимает лицензионное соглашение конечного пользователя. устанавливает пароль (в реальности будет использоваться строгий пароль), устанавливает отображение портов (порт 5433 на вашей машине отображается на стандартный порт для SQL Server в контейнере (1433)), указывает имя контейнера (AutoLot) и, наконец, информирует Docker о том, что должен применяться ранее загруженный образ.

На заметку! Это не те настройки, которые вы захотите использовать в реальной разработке. Информация о том, как изменить пароль системного администратора, и другие сведения доступны по ссылке https://docs.microsoft.com/ru-ru/sql/linux/quickstart-install-connect-docker?view=sql-server-verl5&pivots=cs1-bash.

Чтобы убедиться в том, что Docker функционирует, введите в окне командной строки команду docker ps -а. Вы увидите вывод наподобие показанного ниже (для краткости некоторые колонки опущены):

 C:\Users\japik>docker ps -a

CONTAINER ID IMAGE STATUS PORTS NAMES

347475cfb823 mcr.microsoft.com/mssql/server:2019-latest Up 6 minutes 0.0.0.0:5433->1433/ tcp AutoLot

Чтобы остановить контейнер, введите docker stop 34747, где цифры 34747 представляют собой первые пять символов идентификатора контейнера. Чтобы перезапустить контейнер, введите docker start 34747, не забыв обновить команду соответствующим началом идентификатора вашего контейнера.

На заметку! Вы также можете использовать с командами Docker CLI имя контейнера (AutoLot в этом примере), скажем, docker start AutoLot. Имейте в виду, что независимо от ОС команды Docker чувствительны к регистру символов.

Если вы желаете поработать с инструментальной панелью Docker, щелкните правой кнопкой мыши на значке Docker (в системном лотке) и выберите в контекстном меню пункт Dashboard (Инструментальная панель); вы должны увидеть образ, функционирующий на порте 5433. Наведите курсор мыши на имя образа и появятся команды для остановки, запуска и удаления (помимо прочих), как показано на рис. 21.2.

Установка SQL Server 2019

Вместе с Visual Studio 2019 устанавливается специальный экземпляр SQL Server (по имени (localdb)\mssqllocaldb). Если вы решили не использовать SQL Server Express LocalDB (или Docker) и работаете на машине Windows, тогда можете установить SQL Server 2019 Developer Edition. Продукт SQL Server 2019 Developer Edition бесплатен и доступен для загрузки по следующей ссылке:

 https://www.microsoft.com/ru-ru/sql-server/sqlserver-downloads

Имея другую версию экземпляра, вы можете применять ее в этой книге; понадобится лишь надлежащим образом изменить параметры на экране подключения.

Установка IDE-среды SQL Server

Azure Data Studio — это новая IDE-среда для использования с SQL Server. Она является бесплатной и межплатформенной, а потому будет работать под управлением Windows, Mac или Linux. Загрузить ее можно по ссылке:

 https://www.microsoft.com/en-us/sql-server/sql-server-downloads

На заметку! Если вы работаете на машине Windows и отдаете предпочтение среде управления SQL Server (SQL Server Management Studio — SSMS), то можете загрузить последнюю версию по ссылке https://docs.microsoft.com/ru-ru/sql/ssms/download-sql-server-management-studio-ssms.

Подключение к SQL Server

После установки Azure Data Studio или SSMS настало время подключиться к экземпляру СУБД. В последующих разделах описано подключение к SQL Server в контейнере Docker или LocalDb. Если вы используете другой экземпляр SQL Server, тогда соответствующим образом обновите строку подключения.