🥇 ▷ Создание приложения Azure API с проверкой подлинности AAD и веб-заданиями

Следующая статья поможет вам: Создание приложения Azure API с проверкой подлинности AAD и веб-заданиями — источник данных

В этом сообщении описывается, как создавать и заполнять объекты источников данных для учебника Создание приложения API Azure с проверкой подлинности AAD и веб-заданиями. Он рассматривает сервер Azure SQL, базу данных, проект базы данных и библиотеку классов модели.

Создать SQL-сервер Azure

Открыть Портал Azureвойдите в свою учетную запись Microsoft.

Нажмите «+ Новый» на левой панели и выполните поиск в объекте «SQL Server». Блейд поиска показывает список найденных объектов, где первым должен быть «SQL Server (логический сервер)» от Microsoft. Нажмите на него и нажмите «Создать» на следующем лезвии.

Используйте следующие значения для свойств SQL Server:

Свойство	Ценить
Имя сервера	azureapipdbserver
Логин администратора сервера	DatabaseAdmin (вы не можете использовать стандартные имена, такие как Admin, Administrator и т. д.)
Пароль	Надежный пароль
Подтвердите пароль	Такой же надежный пароль
Подписка	Ваша подписка
Группа ресурсов	Используйте существующий и выберите «Azure_API_app_with_AAD_Auth».
Расположение	Используйте ближайший к вашим клиентам центр обработки данных

Обратите внимание, что имя сервера используется как часть прямого URL, поэтому оно должно быть уникальным. Вот почему предлагаемое имя «azureapiappdbserver» должно быть дополнено уникальным префиксом, таким как ваше второе имя, название проекта и т. д.

Нажмите «Создать», чтобы создать SQL-сервер.

Щелкните имя сервера на плитке группы ресурсов и перейдите к колонке для SQL-сервера. Нажмите «Брандмауэр/виртуальные сети (предварительная версия)» в левой части блейда или «Показать настройки брандмауэра» в верхней части блейда. Блейд с настройками брандмауэра открыт.

Чтобы иметь доступ к SQL-серверу, необходимо добавить правило брандмауэра, разрешающее трафик с текущего IP-адреса пользователя. Blade показывает текущий IP-адрес под названием «IP-адрес клиента». Щелкните правой кнопкой мыши по этому адресу и выберите пункт меню «Добавить IP-адрес клиента». Будет создано новое правило. Он может быть обновлен по осмысленному имени и/или диапазону IP-адресов. Нажмите «Сохранить» в верхнем левом углу лезвия.

Создать SQL-сервер Azure

Перейдите к обзорной колонке SQL Server. Нажмите «+ Новая база данных» в верхней части блейда. Показан блейд, создающий новую базу данных.

Используйте следующие значения для свойств базы данных SQL:

Свойство	Ценить
Имя базы данных	база данных azureapiapp
Выберите источник	Пустая база данных
Сервер	Сохранить текущее значение, azureapipdbserver (местоположение)
Хотите использовать эластичный пул SQL?	Не сейчас
Ценовая категория	Вы можете оставить значение по умолчанию «Стандартный S3». В противном случае нажмите кнопку уровня цен и выберите другой уровень. Для предварительного просмотра и тестирования достаточно «Базового».
Сопоставление	SQL_Latin1_General_CP1_CI_AS

Показана панель инструментов. Щелкните имя базы данных на плитке группы ресурсов и перейдите к колонке для базы данных SQL.

В середине блейд-базы расположена диаграмма «DTU». Нажмите на булавку в правом верхнем углу и закрепите диаграмму на приборной панели.

Нажмите «Microsoft Azure» и откройте панель инструментов. Дважды щелкните новую плитку, отобразится диаграмма настройки.

Можно установить множество различных настроек. Например, переименуйте заголовок в «База данных», измените период на «Последние 24 часа», отметьте такие настройки, как «Процент DTU», «Процент размера базы данных», «Процент рабочих». Нажмите «Сохранить и закрыть». Показана панель мониторинга с обновленной плиткой.

Проекты базы данных

Решение с проектом базы данных и библиотекой классов модели можно найти по адресу Репозиторий GitHub. Он содержит следующие проекты:

База данных — проект базы данных, описывающий структуру базы данных: схемы, таблицы, индексы, триггеры и ограничения. Эти скрипты определяют и заполняют справочную таблицу Категории и определяют таблицу Объявления, которая содержит описание объявлений. Обратите внимание, что в качестве целевой платформы выбрана база данных Microsoft Azure SQL Database V12. Этот проект будет развернут в созданной базе данных Azure в качестве приложения уровня данных, что позволит контролировать изменения и быть автоматизированным;
Модели — библиотека классов, содержащая контекст Entity Framework из развернутой базы данных. Решение включает пустую библиотеку классов с добавленным пакетом EntityFramework NuGet.

Развертывание приложения уровня данных в базе данных SQL Azure.

Запустите Visual Studio и откройте решение Create_API_App_Part01.sln из хранилище. Скриншоты сделаны с помощью Visual Studio 2015. Чтобы успешно развернуть проект базы данных в базе данных Azure, проверьте последнюю версию SSDT. В противном случае вы можете получить сообщение об ошибке: «Невозможно подключиться к главному или целевому серверу «%databasename%». У вас должен быть пользователь с таким же паролем на главном или целевом сервере «%databasename%».

Щелкните правой кнопкой мыши проект базы данных и выберите элемент “Опубликовать…”. Появится диалоговое окно “Общедоступная база данных”.

Сначала необходимо настроить строку подключения к созданной базе данных SQL. Нажмите «Редактировать…», появится диалоговое окно «Подключиться», и выберите вторую вкладку «Обзор». Есть несколько вариантов. Можно развернуть узел Azure и выбрать созданную базу данных или задать свойства подключения.

Используйте следующие значения для свойств соединения:

Свойство	Ценить
Имя сервера	azureapipdbserver.database.windows.сеть
Аутентификация	Аутентификация SQL-сервера
Имя пользователя	База данныхАдминистратор
Пароль	Пароль пользователя SQL Server
Запомнить пароль	Проверять
Имя базы данных	база данных azureapiapp

Затем нажмите «Проверить соединение», чтобы убедиться, что все поля заполнены правильно.

Установите оба параметра «Зарегистрировать как приложение уровня данных» и «Блокировать публикацию, если база данных отличается от зарегистрированной версии». Это предотвращает прямые изменения в базе данных SQL.

Нажмите «Создать профиль». Создайте папку Publish в каталоге проекта и сохраните файл с именем Azure.publish.xml. Рекомендуется добавить расширение *.publish.xml к .gitignore, так как эти файлы могут содержать конфиденциальную информацию. Вот почему предоставленное решение не содержит файлов публикации.

Нажмите «Опубликовать» и подождите.

Проверить базу данных SQL из Visual Studio

Откройте окно «Обозреватель объектов SQL Server» в Visual Studio (Просмотр | Обозреватель объектов SQL Server).

Разверните и щелкните правой кнопкой мыши узел SQL Server. Нажмите «Добавить SQL Server…». Появится диалоговое окно «Подключение».

Так как на предыдущем шаге использовалось подключение к базе данных SQL, его можно найти в списке недавно использовавшихся подключений. Выберите первую вкладку «История», нажмите на подключение к базе данных azureapiappdatabase. Проверьте значение свойств, нажмите кнопку «Подключиться».

Теперь узел SQL Server содержит узел с именем SQL Azure Server: azureapiappdbserver.database.windows.net, который содержит дочерние элементы, такие как серверный узел в SQL Server Management Studio.

Развернуть дерево до узлов таблицы. Контекстное меню узлов таблицы позволяет просматривать данные, просматривать DML-код и т. д. Щелкните правой кнопкой мыши узел Товары.Категория, нажмите «Просмотреть данные». Появится окно с данными таблицы. Проект содержит сценарий после развертывания, поэтому таблица после развертывания содержит некоторые данные.

Добавление моделей данных с помощью Entity Framework

Switch в окно «Обозреватель решений». Щелкните правой кнопкой мыши проект Models, нажмите «Добавить», а затем «Новый элемент…».

Выберите «Модель данных объекта ADO.NET», введите имя «Товары» и нажмите «Добавить».

Появится окно «Мастер модели данных объекта». Поскольку база данных уже описана, выберите «EF Designer из базы данных». Нажмите «Далее >».

На следующем экране нажмите «Новое подключение…». Появится диалоговое окно «Свойства соединения». Используйте следующие значения для свойств соединения:

Свойство	Ценить
Источник данных	Microsoft SQL Server (SqlClient)
Имя сервера	azureapipdbserver.database.windows.сеть
Аутентификация	Аутентификация SQL-сервера
Имя пользователя	База данныхАдминистратор
Пароль	Пароль пользователя SQL Server
Сохранить мой пароль	Проверять
Выберите или введите имя базы данных	база данных azureapiapp

Нажмите «Проверить соединение», чтобы убедиться, что все поля заполнены правильно. Затем нажмите «ОК», чтобы закрыть диалоговое окно.

Установите флажок «Сохранить настройки подключения в App.Config как:», введите имя GoodEntities и продолжите, нажав «Далее >».

Проверьте узел «Таблицы», «Исчислить во множественном или единственном числе имена сгенерированных объектов» и «Включить столбцы внешнего ключа в модель». Введите значение «Модели» для пространства имен моделей и нажмите «Готово».

Была создана новая Entity Framework, и Visual Studio показывает контекстную диаграмму.

Откройте файл Goods.Context.cs или найдите класс Goods.Context. Найдите конструктор и отключите ленивую загрузку с помощью следующей строки кода:


Configuration.LazyLoadingEnabled = false;

Он не позволяет методам службы REST загружать объекты, на которые ссылаются.

1. Все используемые IP-адреса, имена серверов, рабочих станций, доменов являются вымышленными и используются исключительно в ознакомительных целях. 2. Информация предоставляется «КАК ЕСТЬ».

Table of Contents