.NET と Entity Framework Core を使用して Azure SQL Database に接続してクエリを実行する

適用対象:Azure SQL Database

このクイックスタートでは、.NETおよびEntity Framework Coreを使ってアプリケーションをAzure SQL Databaseのデータベースに接続し、クエリを実行する方法を説明します。 このクイックスタートでは、データベースに接続するための推奨されるパスワードレス アプローチに従います。 パスワードレス接続について詳しく知りたい方は、 パスワードレスハブをご覧ください。

前提条件

• Azure サブスクリプション。
• Microsoft Entra ID (旧称 Azure Active Directory) 認証を使用して構成された SQL Database。 Quickstart「Create a single database - Azure SQL Database」を使って作成できます。
• .NET 10.0以降のバージョンです。
• ASP.NET と Web 開発ワークロードを含む Visual Studio 以降。
• 最新バージョンの Azure CLI。
• Entity Framework Core ツールの最新バージョン:
  • Visual Studio ユーザーは、Entity Framework Core 用のパッケージ マネージャー コンソール ツールをインストールする必要があります。
  • .NET CLI ユーザーは、Entity Framework Core 用の .NET CLI ツールをインストールする必要があります。

データベース サーバーを構成する

Azure SQL Database への安全なパスワードレス接続には、特定のデータベース構成が必要です。 Azure の論理サーバーで次の設定を確認し、ローカル環境とホスト環境の両方で Azure SQL Database に適切に接続します。

1. ローカル開発接続の場合は、ローカル コンピューターの IP アドレスとその他の Azure サービスが接続できるように Azure SQL 論理サーバーが構成されていることを確認します。

   1. Azure portal のリソース メニューの [ セキュリティ] で、[ ネットワーク] を選択します。

   2. [ 選択したネットワーク ] ボタンを選択して、追加の構成オプションを表示します。

   3. [Add your client IPv4 address(xx.xx.xx.xx)] (クライアント IPv4 アドレスの追加 (xx.xx.xx.xx)) を選び、ローカル コンピューターの IPv4 アドレスからの接続を有効にするファイアウォール規則を追加します。 または、[+ Add a firewall rule] (ファイアウォール規則の追加) を選び、選んだ特定の IP アドレスを入力することもできます。

   4. [Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] チェックボックスがオンになっていることを確認します。

      

      警告

      [Azure サービスおよびリソースにこのサーバーへのアクセスを許可する] 設定を有効にすることは、運用環境のシナリオでは推奨されるセキュリティ プラクティスではありません。 実際のアプリケーションでは、より強力なファイアウォール制限や仮想ネットワーク構成など、より安全なアプローチを実装する必要があります。

      データベース セキュリティの構成について詳しくは、次のリソースを参照してください。

      • Azure SQL Database ファイアウォール規則を構成する。
      • プライベート エンドポイントを使用して仮想ネットワークを構成する。

2. また、サーバーでは Microsoft Entra 認証が有効になっており、Microsoft Entra 管理者アカウントが割り当てられている必要があります。 ローカル開発接続の場合、Microsoft Entra 管理者アカウントは、ローカルで Visual Studio または Azure CLI にログインできるアカウントである必要があります。 論理サーバーの Microsoft Entra ID ページで、サーバーで Microsoft Entra 認証が有効になっているかどうかを確認できます。

   

3. 個人の Azure アカウントを使用している場合は、アカウントをサーバー管理者として割り当てるために、Microsoft Entra がセットアップされ、Azure SQL Database 用に構成されていることを確認してください。企業アカウントを使用している場合は、Microsoft Entra ID がおそらくすでに構成済みになっています。

プロジェクトを作成する

このセクションの手順では、.NET CLI または Visual Studio 2022 のいずれかを使用して、.NET の最小限の Web API を作成します。

プロジェクトに Entity Framework Core を追加する

.NETとEntity Framework Coreを使ってAzure SQL Databaseに接続するには、以下の方法のいずれかを使ってプロジェクトにNuGetパッケージを追加してください。

dotnet add package Microsoft.EntityFrameworkCore
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
dotnet add package Microsoft.EntityFrameworkCore.Design
dotnet add package Microsoft.AspNetCore.OpenApi
dotnet add package Swashbuckle.AspNetCore.SwaggerUI

Azure SQL Database に接続するコードを追加する

Entity Framework Core ライブラリは、Azure SQL Database へのパスワードレス接続を実装するために、Microsoft.Data.SqlClient ライブラリと Azure.Identity ライブラリに依存します。 Azure.Identity ライブラリには、Azure へのパスワードレス認証を処理する、DefaultAzureCredential というクラスが用意されています。

DefaultAzureCredential では複数の認証方法がサポートされており、実行時にどれを使うかが決定されます。 このアプローチを採用すると、環境固有のコードを実装することなく、異なる環境 (ローカルと運用環境) で異なる認証方法をアプリに使用できます。 Azure ID ライブラリの概要に関する記事では、DefaultAzureCredential が資格情報を検索する順序と場所について説明されています。

Entity Framework Core と基になる DefaultAzureCredential クラスを使用して Azure SQL Database に接続するには、次の手順を実行します。

1. 次のコードと一致するように、ConnectionStrings セクションを appsettings.Development.json ファイルに追加します。 <server>.database.windows.netを、接続先のパスワードなしのデータベース サーバーの名前に置き換え、<database>データベースの名前に置き換えます。

   {
       "Logging": {
           "LogLevel": {
               "Default": "Information",
               "Microsoft.AspNetCore": "Warning"
           }
       },
       "ConnectionStrings": {
           "AZURE_SQL_CONNECTIONSTRING": "Data Source=<server>.database.windows.net;Initial Catalog=<database>;Authentication=Active Directory Default;Encrypt=True;"
       }
   }
   

   注

   データベース接続文字列の <your database-server-name> と <your-database-name> プレースホルダーを忘れずに更新してください。 パスワードレス接続文字列は、ユーザー名、パスワード、アクセス キーなどのシークレットが含まれていないため、ソース管理にコミットしても安全です。

   パスワードレスの接続文字列には、Authentication=Active Directory Default という構成値が含まれています。これにより、Entity Framework Core で、Azure サービスへの接続に DefaultAzureCredential が使用できるようになります。 アプリをローカルで実行するときは、Visual Studio へのサインインに使用しているユーザーで認証されます。 アプリが Azure にデプロイされると、同じコードが、ホストされているアプリに関連付けられているマネージド ID を検出して適用します。これは後で構成します。

2. Program.cs ファイルの内容を次のコードに置き換えます。

   using Microsoft.EntityFrameworkCore;
   
   var builder = WebApplication.CreateBuilder();
   
   builder.Services.AddOpenApi();
   
   var connection = string.Empty;
   if (builder.Environment.IsDevelopment())
   {
       builder.Configuration.AddEnvironmentVariables().AddJsonFile("appsettings.Development.json");
       connection = builder.Configuration.GetConnectionString("AZURE_SQL_CONNECTIONSTRING");
   }
   else
   {
       connection = Environment.GetEnvironmentVariable("AZURE_SQL_CONNECTIONSTRING");
   }
   
   builder.Services.AddDbContext<PersonDbContext>(options =>
       options.UseSqlServer(connection));
   
   var app = builder.Build();
   
   if (app.Environment.IsDevelopment())
   {
       app.MapOpenApi();
       app.UseSwaggerUI(options =>
       {
           options.SwaggerEndpoint("/openapi/v1.json", "v1");
       });
   }
   
   app.MapGet("/", () => "Hello world!");
   
   app.MapGet("/Person", (PersonDbContext context) => context.Person.ToList());
   
   app.MapPost("/Person", (Person person, PersonDbContext context) =>
   {
       context.Add(person);
       context.SaveChanges();
   });
   
   app.Run();
   
   public class Person
   {
       public int Id { get; set; }
       public string FirstName { get; set; }
       public string LastName { get; set; }
   }
   
   public class PersonDbContext(DbContextOptions<PersonDbContext> options) : DbContext(options)
   {
       public DbSet<Person> Person { get; set; }
   }
   

   上記のコードは、次の手順を処理します。

   • ローカル開発については appsettings.Development.json ファイルから、ホストされた運用シナリオについては環境変数から、パスワードレス データベース接続文字列を取得します。
   • Entity Framework Core の DbContext クラスを、.NET 依存関係挿入コンテナーに登録します。 DbContext の詳細については、Entity Framework Core の概要ドキュメントを参照してください。
   • SwaggerUIで.NET 10.0 OpenAPIのサポートを設定し、アプリのエンドポイントやデータベースとやり取りできるUIを提供します。
   • データベース内のエンティティを取得および追加するためのエンドポイントを追加します。
   • Person データベース テーブル内の 1 つのレコードを表すPersons クラスと、.NET 依存関係挿入コンテナーに登録されたPersonDbContext クラスを定義します。

移行を実行してデータベースを作成する

Entity Framework Coreを使ってデータモデルに合うようにデータベーススキーマを更新するには、移行を使います。 移行により、データベース スキーマを作成して増分更新し、アプリケーションのデータ モデルとの同期を保つことができます。 このパターンについて詳しく知りたい方は、 渡りの概要をご覧ください。

アプリをローカルでテストする

アプリはローカルでテストする準備ができています。 Visual StudioまたはAzure CLIに、データベースの管理者として設定した同じアカウントでサインインしていることを確認してください。

1. Visual Studioの上部にある実行ボタンを選択してAPIプロジェクトを起動します。

2. Swagger UIのページ(例えば https://localhost:<port>/swagger)で、 POST メソッドを展開して 「試してみる」を選択します。

3. サンプル JSON を変更して、名とファミリ名の値を含めます。 [実行] を選択して、新しいレコードをデータベースに追加します。 API は正常な応答を返します。

   

4. Swagger UI ページで GET メソッドを展開し、[ 試してみる] を選択します。 [実行] を選択すると、先ほど作成した人物が返されます。

Azure App Service にデプロイする

アプリはAzureへのデプロイ準備ができています。 Visual Studio によって、1 つのワークフローで Azure アプリ サービスを作成し、アプリケーションをデプロイできます。

1. アプリが停止され、正常に構築されていることを確認してください。

2. Visual Studio の [ソリューション エクスプローラー] ウィンドウで、最上位レベルのプロジェクト ノードを右クリックし、[発行] を選択します。

3. 発行ダイアログで、デプロイ ターゲットとして [Azure] を選んでから、[次へ] を選択します。

4. 具体的なターゲットとしては、[Azure App Service (Windows)] を選択し、[次へ] を選択します。

5. 緑色の [+] アイコンを選択して、デプロイ先となる新しいアプリ サービスを作成し、次の値を入力します。

   • 名前: 既定値のままにします。
   • サブスクリプション名: デプロイするサブスクリプションを選択します。
   • [リソース グループ]: [新規] を選択し、msdocs-dotnet-sql という名前の新しいリソース グループを作成します。
   • [ホスティング プラン]: [新規] を選択して、ホスティング プラン ダイアログを開きます。 既定値のままにして [OK] を選択します。
   • [作成] 選択して、元のダイアログを閉じます。 Visual Studio によって、Azure に App Service リソースが作成されます。

   

6. リソースが作成されたら、アプリサービスのリストから選択し、 次に選択してください。

7. [API Management] の手順で、下部にある [この手順をスキップする] チェックボックスをオンにし、[完了] を選択します。

8. 発行プロファイルの概要の右上にある [発行] を選択して、アプリを Azure にデプロイします。

デプロイが完了すると、Visual Studio によってブラウザーが起動され、ホストされているアプリが表示されます。 デフォルトのエンドポイントからの Hello world メッセージが表示されます。 ただし、この時点では、データベース エンドポイントは Azure では正しく機能しません。 データを取得するために、App Service と SQL データベースの間にセキュリティで保護された接続を構成する必要があります。

App Service を Azure SQL Database に接続する

App ServiceインスタンスをAzure SQL Databaseに接続するには、以下の手順を踏みます:

1. App Service 用のマネージド ID を作成します。 アプリに含まれる Microsoft.Data.SqlClient ライブラリは、ローカルの Visual Studio ユーザーを検出した場合と同様に、マネージド ID を自動的に検出します。

2. SQL データベース ユーザーを作成し、App Service のマネージド ID に関連付けます。

3. 読み取り、書き込み、場合によってはその他のアクセス許可を付与する SQL ロールをデータベース ユーザーに割り当てます。

以下のステップを実行するために複数のツールを使うことができます:

デプロイされたアプリケーションをテストする

アプリの URL を参照して、Azure SQL Database への接続が動作していることをテストします。 アプリの URL は、App Service の概要ページで確認できます。 URL の末尾に /person パスを追加して、ローカルでテストしたのと同じエンドポイントを参照します。

ローカルで作成した人物がブラウザーに表示されるはずです。 これで、アプリケーションはローカル環境とホスト環境の両方で Azure SQL Database に接続されました。

リソースのクリーンアップ

Azure SQL Database の操作が完了したら、意図しないコストを回避するためにリソースを削除します。

az sql db delete --name <database-name> --resource-group <resource-group-name> --server <logical-server-name>

関連するコンテンツ

• チュートリアル:Azure SQL Database 内のデータベースをセキュリティで保護する
• Azure SQL Database へのデータベース アクセスを承認する
• Azure SQL Database と SQL Managed Instance のセキュリティ機能の概要
• Azure SQL Database と Azure SQL Managed Instance で一般的なセキュリティ要件に対処するためのプレイブック