Share via


Aggiungere una connessione a un database SQL di Azure

Con Visual Studio Connessione ed Services è possibile connettersi a database SQL di Azure, a un emulatore locale (ad esempio durante lo sviluppo) o a un database di SQL Server locale. Per SQL Server locale, vedere Connessione a un database.

Con Visual Studio è possibile connettersi da uno dei tipi di progetto seguenti usando la funzionalità servizi Connessione ed:

  • ASP.NET Core
  • .NET Core (tra cui app console, WPF, Windows Form, libreria di classi)
  • Ruolo di lavoro .NET Core
  • Funzioni di Azure
  • App console .NET Framework
  • ASP.NET Model-View-Controller (MVC) (.NET Framework)
  • app piattaforma UWP (Universal Windows Platform)

La funzionalità servizio connesso aggiunge al progetto tutti i riferimenti richiesti e il codice di connessione e modifica i file di configurazione in modo appropriato.

Prerequisiti

Connessione per database SQL di Azure tramite i servizi Connessione ed

  1. Aprire il progetto in Visual Studio.

  2. In Esplora soluzioni fare clic con il pulsante destro del mouse sul nodo Servizi Connessione ed e scegliere Aggiungi dal menu di scelta rapida per aprire il menu dei servizi disponibili.

    Screenshot che mostra le opzioni del menu di scelta rapida dei servizi Connessione ed.

  3. Scegliere Database DI SQL Server. Viene visualizzata la Connessione alla pagina delle dipendenze. Verranno visualizzate diverse opzioni:

    • SQL Server Express Local DB, l'offerta di database SQL predefinita installata con Visual Studio
    • Database di SQL Server in un contenitore locale nel computer
    • Database di SQL Server, un'istanza di SQL Server locale nella rete locale
    • database SQL di Azure, per l'database SQL in esecuzione come servizio di Azure

    È possibile ridurre i costi e semplificare lo sviluppo anticipato iniziando con un database locale. È possibile eseguire la migrazione al servizio attivo in Azure in un secondo momento ripetendo questi passaggi e scegliendo un'altra opzione. Se si crea un database in locale che si vuole ricreare in Azure, è possibile eseguire la migrazione del database ad Azure in quel momento.

    Screenshot che mostra database SQL scelte.

    Se si vuole connettersi al servizio di Azure, continuare con il passaggio successivo o, se non si è già connessi, accedere all'account Azure prima di continuare. Se non si ha un account Azure, è possibile iscriversi per ottenere una versione di valutazione gratuita.

  4. Nella schermata Configura database SQL di Azure selezionare un database SQL di Azure esistente e selezionare Avanti.

    Se è necessario creare un nuovo componente, andare al passaggio successivo. In caso contrario, andare al passaggio 7.

    Screenshot che mostra la schermata

  5. Per creare un database SQL di Azure:

    1. Selezionare Crea nuovo con il segno più verde.

    2. Compilare la database SQL di Azure: Crea nuova schermata e selezionare Crea.

      Screenshot che mostra la schermata

    3. Quando viene visualizzata la schermata Configura database SQL di Azure, il nuovo database viene visualizzato nell'elenco. Selezionare il nuovo database nell'elenco e selezionare Avanti.

  6. Immettere un nome stringa di connessione oppure scegliere l'impostazione predefinita e scegliere se si vuole archiviare il stringa di connessione archiviato in un file di segreti locale o in Azure Key Vault.

    Screenshot che mostra la schermata

  7. La schermata Riepilogo delle modifiche mostra tutte le modifiche che verranno apportate al progetto se si completa il processo. Se le modifiche hanno un aspetto ok, scegliere Fine.

    Screenshot che mostra la sezione

    Se viene richiesto di impostare regole del firewall, scegliere .

    Screenshot che mostra le regole del firewall.

  8. In Esplora soluzioni fare doppio clic sul nodo Servizi Connessione ed per aprire la scheda Servizi Connessione ed. La connessione viene visualizzata nella sezione Dipendenze del servizio:

    Screenshot che mostra la sezione

    Se si fa clic sui tre puntini accanto alla dipendenza aggiunta, è possibile visualizzare varie opzioni, ad esempio Connessione per riaprire la procedura guidata e modificare la connessione. È anche possibile fare clic sui tre puntini in alto a destra della finestra per visualizzare le opzioni per avviare dipendenze locali, modificare le impostazioni e altro ancora.

Accedere al stringa di connessione

Informazioni su come archiviare i segreti in modo sicuro seguendo Cassaforte archiviazione dei segreti dell'app in fase di sviluppo in ASP.NET Core. In particolare, per leggere il stringa di connessione dall'archivio segreti, è possibile aggiungere codice come in Leggere il segreto tramite l'API di configurazione. Vedere anche Inserimento delle dipendenze in ASP.NET Core.

Migrazioni di Entity Framework

Può essere utile usare un archivio dati locale durante la fase di sviluppo iniziale, ma con Entity Framework Core, quando si è pronti per passare al cloud, è possibile usare il supporto di Visual Studio per la migrazione di Entity Framework per spostare il database o unire le modifiche con un archivio dati remoto. Vedere Panoramica delle migrazioni.

Nella scheda Servizi Connessione ed è possibile trovare i comandi di migrazione facendo clic sui tre puntini, come illustrato nello screenshot:

Screenshot che mostra i comandi di migrazione.

I comandi sono disponibili per creare nuove migrazioni, applicarle direttamente o generare script SQL che applicano le migrazioni.

Aggiungere la migrazione

Quando viene introdotta una modifica del modello di dati, è possibile usare gli strumenti di Entity Framework Core per aggiungere una migrazione corrispondente che descrive nel codice gli aggiornamenti necessari per mantenere sincronizzato lo schema del database. Entity Framework Core confronta il modello corrente con uno snapshot del modello precedente per determinare le differenze e genera i file di origine della migrazione. I file vengono aggiunti al progetto, in genere in una cartella denominata Migrazioni e possono essere rilevati nel controllo del codice sorgente del progetto come qualsiasi altro file di origine.

Quando si sceglie questa opzione, viene chiesto di specificare il nome della classe di contesto che rappresenta lo schema del database di cui si vuole eseguire la migrazione.

Screenshot che mostra l'aggiunta di una migrazione di Entity Framework.

Aggiornare il database

Dopo aver creato una migrazione, può essere applicata a un database. Entity Framework aggiorna il database e lo schema con le modifiche specificate nel codice di migrazione. Quando si sceglie questa opzione, viene chiesto di specificare il nome della classe di contesto che rappresenta lo schema del database di cui si vuole eseguire la migrazione.

Genera script SQL

Il modo consigliato per distribuire le migrazioni in un database di produzione consiste nel generare script SQL. I vantaggi di questa strategia includono quanto segue:

  • Gli script SQL possono essere esaminati per verificare l'accuratezza; questo aspetto è importante perché l'applicazione delle modifiche dello schema ai database di produzione è un'operazione potenzialmente pericolosa che potrebbe comportare la perdita di dati.
  • In alcuni casi, gli script possono essere ottimizzati per soddisfare le esigenze specifiche di un database di produzione.
  • Gli script SQL possono essere usati insieme a una tecnologia di distribuzione e possono anche essere generati come parte del processo di integrazione continua.
  • Gli script SQL possono essere forniti a un amministratore di database e possono essere gestiti e archiviati separatamente.

Quando si usa questa opzione, viene richiesta la classe di contesto del database e il percorso del file di script.

Screenshot che mostra l'opzione Genera script SQL.

Aprire in SQL Server Esplora oggetti

Per praticità, questo comando consente di passare al Esplora oggetti di SQL Server, in modo da poter visualizzare tabelle e altre entità di database e lavorare direttamente con i dati. Vedere Esplora oggetti.

Screenshot che mostra l'Esplora oggetti di SQL Server.

Passaggi successivi

È possibile continuare con le guide introduttive per database SQL di Azure, ma invece di iniziare dall'inizio, è possibile iniziare dopo la configurazione della connessione iniziale. Se si usa Entity Framework, è possibile iniziare da Aggiungere il codice per connettersi a database SQL di Azure. Se si usano SqlClient o ADO.NET classi di dati, è possibile iniziare da Aggiungere il codice per connettersi a database SQL di Azure.

Il codice non corrisponde esattamente a quello usato nelle guide introduttive, che usano un modo diverso per ottenere il stringa di connessione. Le stringa di connessione sono segreti e vengono archiviate in modo sicuro come illustrato in Cassaforte archiviazione dei segreti dell'app in fase di sviluppo in ASP.NET Core. In particolare, per leggere il stringa di connessione dall'archivio segreti, è possibile aggiungere codice come in Leggere il segreto tramite l'API di configurazione. Nei progetti ASP.NET Core, il stringa di connessione creato da servizi Connessione ed è disponibile in un oggetto di configurazione. È possibile accedervi tramite una proprietà sulla WebApplicationBuilder classe (builder in molti modelli di progetto), come nell'esempio seguente:

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