Connettersi a Database SQL di Azure ed eseguire query sui dati usando .NET ed Entity Framework Core

Si applica a:Database SQL di Azure

Questo quickstart descrive come collegare un'applicazione a un database in database SQL di Azure ed eseguire query utilizzando .NET e Entity Framework Core. Questa guida di avvio rapido segue l'approccio senza password consigliato per connettersi al database. Per saperne di più sulle connessioni senza password, consulta l'hub senza password.

Prerequisiti

• Una sottoscrizione di Azure.
• Un database SQL configurato per l'autenticazione con Microsoft Entra ID (precedentemente Azure Active Directory). Puoi crearne uno usando Quickstart: Crea un unico database - database SQL di Azure.
• .NET 10.0 o versione successiva.
• Visual Studio o versione successiva con il carico di lavoro Sviluppo ASP.NET e Web.
• L'ultima versione dell'interfaccia della riga di comando di Azure.
• L’ultima versione degli strumenti di Entity Framework Core:
  • Gli utenti di Visual Studio devono installare gli strumenti della console di Gestione pacchetti per Entity Framework Core.
  • Gli utenti dell'interfaccia della riga di comando di .NET devono installare gli strumenti dell'interfaccia della riga di comando di .NET per Entity Framework Core.

Configurazione del server database

La connessione sicura senza password a Database SQL di Azure richiede determinate configurazioni del database. Verificare le impostazioni seguenti nel server logico in Azure per connettersi correttamente a Database SQL di Azure in ambienti locali e ospitati:

1. Per le connessioni di sviluppo locale, assicurarsi che il server logico SQL di Azure sia configurato per consentire all'indirizzo IP del computer locale e ad altri servizi di Azure di connettersi:

   1. Nel menu delle risorse del portale di Azure, in Sicurezza, selezionare Rete.

   2. Selezionare il pulsante Reti selezionate per visualizzare opzioni di configurazione aggiuntive.

   3. Selezionare Aggiungere l'indirizzo IPv4 client (xx.xx.xx.xx.xx) per aggiungere una regola del firewall che consentirà le connessioni dall'indirizzo IPv4 del computer locale. In alternativa, è anche possibile selezionare + Aggiungi una regola del firewall per immettere un indirizzo IP specifico a propria scelta.

   4. Selezionare la casella di controllo Consenti alle risorse e ai servizi di Azure di accedere a questo server.

      

      Avviso

      L'abilitazione dell'impostazione Consenti a servizi e risorse di Azure di accedere a questo server non è una procedura di protezione consigliata per gli scenari di produzione. Le applicazioni reali devono implementare approcci più sicuri, ad esempio restrizioni firewall più avanzate o configurazioni di reti virtuali.

      Per altre informazioni sulle configurazioni di sicurezza del database, vedere le seguenti risorse:

      • Configurare le regole del firewall per il database SQL di Azure.
      • Configurare una rete virtuale con endpoint privati.

2. Al server deve essere abilitata anche l'autenticazione Microsoft Entra e deve essere assegnato un account amministratore di Microsoft Entra. Per le connessioni di sviluppo locali, l'account amministratore di Microsoft Entra deve essere un account con il quale è possibile accedere localmente anche a Visual Studio o all'interfaccia della riga di comando di Azure. È possibile verificare se nel server è abilitata l'autenticazione Microsoft Entra dalla pagina Microsoft Entra ID del server logico.

   

3. Se stai usando un account Azure personale, assicurati di aver configurato Microsoft Entra per Database SQL di Azure in modo da poter assegnare il tuo account come amministratore del server. Se stai usando un account aziendale, è probabile che Microsoft Entra ID sia già configurato per te.

Creare il progetto

I passaggi descritti in questa sezione creano un'API Web minima .NET usando l'interfaccia della riga di comando di .NET o Visual Studio 2022.

Aggiungere Entity Framework Core al progetto

Per connetterti ad database SQL di Azure utilizzando .NET e Entity Framework Core, aggiungi i seguenti pacchetti NuGet al tuo progetto, utilizzando uno dei seguenti metodi:

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

Aggiungere il codice per connettersi al database SQL di Azure

Le librerie Entity Framework Core si basano sulle librerie Microsoft.Data.SqlClient e Azure.Identity per implementare connessioni senza password a database SQL di Azure. La libreria Azure.Identity fornisce una classe denominata DefaultAzureCredential che gestisce l'autenticazione senza password in Azure.

DefaultAzureCredential supporta più metodi di autenticazione e determina quello da usare in fase di esecuzione. Questo approccio consente all'app di usare metodi di autenticazione diversi in ambienti diversi (locale o di produzione) senza implementare codice specifico dell'ambiente. La panoramica della libreria di identità di Azure illustra l'ordine e le posizioni in cui DefaultAzureCredential cerca le credenziali.

Completare i passaggi seguenti per connettersi a database SQL di Azure usando Entity Framework Core e la classe DefaultAzureCredential sottostante:

1. Aggiungere una sezione ConnectionStrings al file appsettings.Development.json in modo che corrisponda al codice seguente. Sostituire <server>.database.windows.net con il nome del server di database senza password a cui connettersi e <database> con il nome del 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;"
       }
   }
   

   Nota

   Ricordarsi di aggiornare i segnaposto <your database-server-name> e <your-database-name> nella stringa di connessione del database. Le stringhe di connessione senza password sono sicure per essere sottoposte al controllo del codice sorgente, perché non contengono elementi riservati come nomi utente, password o chiavi di accesso.

   La stringa di connessione senza password comprende un valore di configurazione di Authentication=Active Directory Default, che consente a Entity Framework Core di usare DefaultAzureCredential per connettersi ai servizi di Azure. Quando l'app viene eseguita in locale, esegue l'autenticazione con l'utente con cui si è connessi a Visual Studio. Dopo la distribuzione dell'app in Azure, lo stesso codice individua e applica l'identità gestita associata all'app ospitata, configurata in un secondo momento.

2. Sostituire il contenuto del file Program.cs con il codice seguente:

   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; }
   }
   

   Il codice precedente gestisce i passaggi seguenti:

   • Recupera la stringa di connessione al database senza password dal file appsettings.Development.json per lo sviluppo locale, o dalle variabili di ambiente per gli scenari di produzione ospitati.
   • Registra la classe DbContext Entity Framework Core con il contenitore di inserimento delle dipendenze .NET. Per altre informazioni su DbContext, vedere la documentazione introduttiva di Entity Framework Core.
   • Configura il supporto OpenAPI .NET 10.0 con SwaggerUI per fornire un'interfaccia utente che puoi utilizzare per interagire con gli endpoint dell'app e il database.
   • Aggiunge endpoint per recuperare e aggiungere entità nel database.
   • Definisce una classe Person per rappresentare un singolo record nella tabella del database Persons e la classe PersonDbContext registrata nel contenitore di dependency injection di .NET.

Eseguire migrazioni per creare il database

Per aggiornare lo schema del database e adattarlo al tuo modello dati usando Entity Framework Core, usa una migrazione. Le migrazioni possono creare e aggiornare in modo incrementale uno schema del database per mantenerlo sincronizzato con il modello di dati dell'applicazione. Per saperne di più su questo schema, consulta la panoramica delle migrazioni.

Test dell'app in locale

L'app è pronta per essere testata localmente. Assicurati di essere connesso a Visual Studio o alla interfaccia della riga di comando di Azure con lo stesso account che hai impostato come amministratore del tuo database.

1. Seleziona il pulsante esegui in alto in Visual Studio per avviare il progetto API.

2. Nella pagina Swagger UI (ad esempio, https://localhost:<port>/swagger), espandi il POST metodo e seleziona Prova.

3. Modificare il codice JSON di esempio per includere i valori per il nome e il nome della famiglia. Selezionare Esegui per aggiungere un nuovo record al database. L'API restituisce una risposta di esito positivo.

   

4. Espandere il GET metodo nella pagina dell'interfaccia utente di Swagger e selezionare Prova. Selezionare Esegui e, in questo modo, viene restituita la persona appena creata.

Eseguire la distribuzione nel servizio app di Azure

L'app è pronta per essere distribuita su Azure. Visual Studio può creare un servizio app di Azure per distribuire l'applicazione in un singolo flusso di lavoro.

1. Assicurati che l'app sia arrestata e che la compilazione venga completata correttamente.

2. Nella finestra Esplora soluzioni di Visual Studio, fare clic con il pulsante destro del mouse sul nodo del progetto di primo livello e scegliere Pubblica.

3. Nella finestra di dialogo di pubblicazione selezionare Azure come destinazione di distribuzione, quindi selezionare Avanti.

4. Per la destinazione specifica, selezionare Servizio app di Azure (Windows), quindi scegliere Avanti.

5. Selezionare l'icona + verde per creare un nuovo servizio app in cui eseguire la distribuzione e immettere i valori seguenti:

   • Nome: lasciare il valore predefinito.
   • Nome sottoscrizione: Seleziona la sottoscrizione a cui vuoi effettuare il deployment.
   • Gruppo di risorse: selezionare Nuovo e creare un nuovo gruppo di risorse denominato msdocs-dotnet-sql.
   • Piano di hosting: selezionare Nuovo per aprire la finestra di dialogo del piano di hosting. Lasciare i valori predefiniti, quindi selezionare OK.
   • Selezionare Crea per chiudere la finestra di dialogo iniziale. Visual Studio crea la risorsa App Service su Azure.

   

6. Dopo aver creato la risorsa, assicurati di selezionarla nell'elenco dei servizi app, e poi seleziona Avanti.

7. Nel passaggio Gestione API, selezionare la casella di controllo Salta questo passaggio nella parte inferiore, quindi selezionare Fine.

8. Selezionare Pubblica nella parte in alto a destra del riepilogo del profilo di pubblicazione per distribuire l'app in Azure.

Al termine della distribuzione, Visual Studio avvia il browser per visualizzare l'app ospitata. Vedi il Hello world messaggio dall'endpoint predefinito. Tuttavia, a questo punto gli endpoint del database non funzionano correttamente in Azure. È comunque necessario configurare la connessione protetta tra il servizio app e il database SQL per recuperare i dati.

Connettere il servizio app al database SQL di Azure

Per collegare l'istanza di App Service a database SQL di Azure, completare i seguenti passaggi:

1. Creare un'identità gestita per il servizio app. La Microsoft.Data.SqlClient libreria inclusa nell'app individua automaticamente l'identità gestita, proprio come ha individuato l'utente di Visual Studio locale.

2. Creare un utente del database SQL e associarlo all'identità gestita del servizio app.

3. Assegnare ruoli SQL all'utente del database che consentano di leggere, scrivere e potenzialmente di ottenere altre autorizzazioni.

Puoi utilizzare più strumenti per implementare questi passaggi:

Testare l'applicazione distribuita

Passare all'URL dell'app per testare il funzionamento della connessione al database SQL di Azure. È possibile individuare l'URL dell'app nella pagina di panoramica del servizio app. Accodare il percorso /person alla fine dell'URL per passare allo stesso endpoint testato in locale.

La persona creata in locale verrà visualizzata nel browser. L'applicazione è ora connessa al database SQL di Azure in ambienti locali e ospitati.

Pulire le risorse

Al termine dell'utilizzo del database SQL di Azure, eliminare la risorsa per evitare costi accidentali.

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

Contenuto correlato

• Esercitazione: Proteggere un database nel database SQL di Azure
• Autorizza l'accesso al database ad database SQL di Azure
• Panoramica delle funzionalità di sicurezza del database SQL di Azure e dell'istanza gestita di SQL
• Guida per soddisfare i requisiti di sicurezza comuni con database SQL di Azure e Istanza gestita di SQL di Azure