Добавление подключения к База данных SQL Azure

1. Откройте проект в Visual Studio.

2. В Обозреватель решений щелкните правой кнопкой мыши узел "Подключенные службы" и в контекстном меню выберите "Добавить", чтобы открыть меню доступных служб.

   

   Если узел "Подключенные службы" не отображается, выберите "Добавить подключенные службы> project".>

3. Выберите базу данных SQL Server. Откроется страница подключения к зависимости. Вы увидите несколько вариантов:

   • SQL Server Express LocalDB, встроенное База данных SQL предложение, установленное с помощью Visual Studio
   • База данных SQL Server на локальном контейнере на компьютере
   • База данных SQL Server, локальная среда SQL Server в локальной сети
   • База данных SQL Azure для База данных SQL, работающей в качестве службы Azure

   Вы можете сократить затраты и упростить раннюю разработку, начиная с локальной базы данных. Вы можете перейти в динамическую службу в Azure позже, повторив эти действия и выбрав другой вариант. Если вы создаете базу данных локально, которую вы хотите повторно создать в Azure, вы можете перенести базу данных в Azure в то время.

   

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

4. На экране "Настройка База данных SQL Azure" выберите существующую База данных SQL Azure и нажмите кнопку "Далее".

   Если вам нужно создать новый компонент, перейдите к следующему шагу. В противном случае перейдите к шагу 7.

   

5. Чтобы создать базу данных SQL Azure, выполните приведенные действия.

   1. Нажмите кнопку "Создать" по зеленому знаку плюса.

   2. Заполните База данных SQL Azure: создайте новый экран и нажмите кнопку "Создать".

      

   3. При отображении экрана "Настройка База данных SQL Azure" новая база данных появится в списке. Выберите новую базу данных в списке и нажмите кнопку "Далее".

6. Введите имя строка подключения или выберите значение по умолчанию, а затем нажмите кнопку "Дополнительные параметры".

   

   Примечание.

   В Visual Studio 2022 версии 17.12 и более поздних версиях эта процедура использует управляемое удостоверение Microsoft Entra, метод проверки подлинности без пароля для подключения к базе данных. Предупреждение на этом экране означает, что после выполнения этой процедуры в Visual Studio необходимо выполнить ручной шаг на портале Azure. См . проверку подлинности Microsoft Entra.

7. Выберите, хотите ли строка подключения храниться в локальном файле секретов или в Azure Key Vault, а затем нажмите кнопку "Далее".

   

8. На экране "Сводка изменений" отображаются все изменения, которые будут внесены в проект при завершении процесса. Если изменения выглядят ОК, нажмите кнопку "Готово".

   

   Если появится запрос на настройку правил брандмауэра, нажмите кнопку "Да".

   

9. В Обозреватель решений дважды щелкните узел "Подключенные службы", чтобы открыть вкладку "Подключенные службы". Подключение отображается в разделе "Зависимости службы":

   

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

10. Если вы используете управляемое удостоверение (Visual Studio 17.12 и более поздние версии), см. следующий раздел, чтобы настроить пользователя управляемого удостоверения в базе данных SQL Azure.

Проверка подлинности Microsoft Entra

При использовании Visual Studio 2022 версии 17.12 и более поздних версий процедура подключенных служб использует проверку подлинности Microsoft Entra, которая является самым безопасным методом проверки подлинности. Однако Visual Studio не создает пользователя администратора Microsoft Entra в базе данных SQL Azure автоматически. Если у пользователя администратора Microsoft Entra нет, подключение не пройдет проверку подлинности.

Вы можете использовать портал Azure, PowerShell или Azure CLI для создания пользователя администратора Microsoft Entra. Подробные инструкции по каждому из этих методов см. в разделе "Настройка пользователя администратора Microsoft Entra".

После завершения процесса подключенных служб необходимо создать пользователя SQL, соответствующего управляемому удостоверению, и задать разрешения, выполнив инструкции SQL в базе данных. Войдите в редактор запросов на портале Azure в качестве пользователя администратора Microsoft Entra и выполните следующие инструкции:

CREATE USER [<identity-name>] FROM EXTERNAL PROVIDER;
ALTER ROLE db_datareader ADD MEMBER [<identity-name>];
ALTER ROLE db_datawriter ADD MEMBER [<identity-name>];
ALTER ROLE db_ddladmin ADD MEMBER [<identity-name>];

GO

Имя <identity-name> управляемого удостоверения в идентификаторе Microsoft Entra. Если удостоверение назначено системой, имя всегда будет совпадать с именем приложения Службы приложений. Для слота развертывания имя <app-name>/slots/<slot-name>его назначаемого системой удостоверения. Чтобы предоставить разрешения для группы Microsoft Entra, используйте отображаемое имя группы (например, myAzureSQLDBAccessGroup). См. сведения о типах управляемых удостоверений и управляемых удостоверениях в Microsoft Entra для SQL Azure. Добавляемые роли зависят от вариантов использования. См. раздел ALTER ROLE.

Если вы ссылаетесь System.Data.SqlClientна код, вам потребуется выполнить обновление Microsoft.Data.SqlClientдо версии, так как System.Data.SqlClient не поддерживает проверку подлинности Microsoft Entra. Чтобы обновить, добавьте ссылку на пакет NuGet Microsoft.Data.SqlClient и обновите все директивы using, ссылающиеся System.Data.SqlClient на Microsoft.Data.SqlClient пространство имен. Существуют некоторые изменения в поведении; См. памятка по переносу.

1. Откройте проект в Visual Studio.

2. В Обозреватель решений щелкните правой кнопкой мыши узел "Подключенные службы" и в контекстном меню выберите "Добавить", чтобы открыть меню доступных служб.

   

   Если узел "Подключенные службы" не отображается, выберите "Добавить подключенные службы> project".>

3. Выберите базу данных SQL Server. Откроется страница подключения к зависимости. Вы увидите несколько вариантов:

   • SQL Server Express LocalDB, встроенное База данных SQL предложение, установленное с помощью Visual Studio
   • База данных SQL Server на локальном контейнере на компьютере
   • База данных SQL Server, локальная среда SQL Server в локальной сети
   • База данных SQL Azure для База данных SQL, работающей в качестве службы Azure

   Вы можете сократить затраты и упростить раннюю разработку, начиная с локальной базы данных. Вы можете перейти в динамическую службу в Azure позже, повторив эти действия и выбрав другой вариант. Если вы создаете базу данных локально, которую вы хотите повторно создать в Azure, вы можете перенести базу данных в Azure в то время.

   

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

4. На экране "Настройка База данных SQL Azure" выберите существующую База данных SQL Azure и нажмите кнопку "Далее".

   Если вам нужно создать новый компонент, перейдите к следующему шагу. В противном случае перейдите к шагу 7.

   

5. Чтобы создать базу данных SQL Azure, выполните приведенные действия.

   1. Нажмите кнопку "Создать" по зеленому знаку плюса.

   2. Заполните База данных SQL Azure: создайте новый экран и нажмите кнопку "Создать".

      

   3. При отображении экрана "Настройка База данных SQL Azure" новая база данных появится в списке. Выберите новую базу данных в списке и нажмите кнопку "Далее".

6. Введите имя строка подключения или выберите значение по умолчанию и выберите, хотите ли строка подключения храниться в локальном файле секретов или в Azure Key Vault.

   

7. На экране "Сводка изменений" отображаются все изменения, которые будут внесены в проект при завершении процесса. Если изменения выглядят ОК, нажмите кнопку "Готово".

   

   Если появится запрос на настройку правил брандмауэра, нажмите кнопку "Да".

   

8. В Обозреватель решений дважды щелкните узел "Подключенные службы", чтобы открыть вкладку "Подключенные службы". Подключение отображается в разделе "Зависимости службы":

   

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

Добавление миграции

При изменении модели данных можно использовать средства Entity Framework Core для добавления соответствующей миграции, описывающей в коде обновления, необходимые для синхронизации схемы базы данных. Entity Framework Core сравнивает текущую модель с моментальным снимком старой модели, чтобы определить различия и создать исходные файлы миграции. Файлы добавляются в проект, как правило, в папке с именем Migrations и могут отслеживаться в системе управления версиями проекта, как и любой другой исходный файл.

При выборе этого параметра вам будет предложено указать имя класса контекста, представляющее схему базы данных, которую требуется перенести.

Обновление базы данных

После создания миграции его можно применить к базе данных. Entity Framework обновляет базу данных и схему с изменениями, указанными в коде миграции. При выборе этого параметра вам будет предложено указать имя класса контекста, представляющее схему базы данных, которую требуется перенести.

Создание скрипта SQL

Рекомендуемый способ развертывания миграции в рабочую базу данных — создание скриптов SQL. К преимуществам этой стратегии относятся следующие преимущества:

• Скрипты SQL можно проверить для точности; Это важно, так как применение изменений схемы к рабочим базам данных является потенциально опасной операцией, которая может привести к потере данных.
• В некоторых случаях скрипты можно настроить в соответствии с конкретными потребностями рабочей базы данных.
• Скрипты SQL можно использовать в сочетании с технологией развертывания и даже создавать в рамках процесса CI.
• Скрипты SQL можно предоставлять в DBA и управлять и архивировать отдельно.

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

Открытие в SQL Server обозреватель объектов

Для удобства эта команда позволяет перейти к обозреватель объектов SQL Server, чтобы просматривать таблицы и другие сущности базы данных и работать непосредственно с данными. См . обозреватель объектов.

В проектах ASP.NET Core параметр подключения или строка подключения, созданный подключенными службами, доступен в объекте конфигурации. К нему можно получить доступ по свойству класса WebApplicationBuilder (builder во многих шаблонах проектов), как показано в следующем примере:

var connection = builder.Configuration["ConnectionStrings:DatabaseConnection"];

Строка, предоставляемая свойству Configuration, должна соответствовать ключу в secrets.json или в Azure Key Vault, который вы указали в процедуре подключенных служб. Например, при использовании Visual Studio 2022 17.12 и более поздних версий параметр подключения хранится в secrets.json как:

{
  "ConnectionStrings:DatabaseConnection": "Server=tcp:webapplication16dbserver.database.windows.net;Authentication=Active Directory Default;Database=WebApplication16_db;",
}

В проектах ASP.NET Core параметр подключения или строка подключения, созданный подключенными службами, доступен в объекте конфигурации. К нему можно получить доступ по свойству класса WebApplicationBuilder (builder во многих шаблонах проектов), как показано в следующем примере:

var connection = builder.Configuration["ConnectionStrings:ConnectionString1"];