Editor di query del portale di Azure per il database SQL di Azure

  • Articolo

Si applica a:Database SQL di Azure

L'editor di query (anteprima) è uno strumento per eseguire query T-SQL nel browser sul database SQL di Azure nel portale di Azure.

Eseguire una query nel database SQL di Azure dal portale di Azure

L'editor di query è progettato per l'esecuzione di query e l’esplorazione di oggetti semplificata nel database SQL di Azure, tutto dall'interno del browser nel portale di Azure. Puoi eseguire query T-SQL sul database, nonché modificare i dati nell'editor di dati tabulari integrato.

Analogamente all'esperienza di query in SQL Server Management Studio, usa l'editor di query per query semplici o query T-SQL di dimensioni maggiori. Puoi eseguire query DML (Data Manipulation Language) e DDL (Data Definition Language).

Suggerimento

Si è nuovi nel database SQL di Azure? Ottenere la massima velocità con contenuto di training gratuito approfondito: Nozioni fondamentali su SQL di Azure.

Collegamento tramite l'editor di query

Sono disponibili due opzioni di autenticazione per l'editor di query: autenticazione SQL o autenticazione con Microsoft Entra ID (in precedenza Azure Active Directory).

Autenticazione nel database SQL di Azure

Per esempi, vedi Avvio rapido: usare l'editor di query del portale di Azure (anteprima) per eseguire query su un database SQL di Azure.

  • Per usare l'autenticazione SQL per collegarti a un database SQL di Azure tramite l'editor di query, devi disporre di un account di accesso nel database master del server logico o di un utente SQL indipendente nel database utente desiderato. Per altre informazioni, vedere Autenticazione e autorizzazione per database SQL: concessione dell'accesso.
    • Immetti nome utente e password, quindi seleziona OK.
  • Per usare l'autenticazione di Microsoft Entra per collegarti a un database SQL di Azure tramite l'editor di query, il database deve essere configurato con l'autenticazione di Microsoft Entra e devi aver creato un utente Microsoft Entra nel database.
    • Selezionare Continua come <user@domain>.

Autorizzazioni necessarie per accedere all'editor di query

Per usare l'editor di query, gli utenti devono disporre almeno dell'autorizzazione di Azure di controllo degli accessi in base al ruolo (RBAC) Accesso in lettura al server e al database.

Esistono quattro sezioni principali dell'editor di query:

  • Barra di navigazione

  • Esplora oggetti

  • Finestra Query

  • Copilota per database SQL di Azure

    Screenshot del portale di Azure che mostra rettangoli rossi che evidenziano l'editor di query nel menu principale e la barra di spostamento, Esplora oggetti e finestra Query.

Nella barra di spostamento è possibile eseguire quattro task.

  • Puoi usare Accesso per modificare il contesto di autenticazione.
  • Puoi usare Nuova query per aprire un intervallo di query vuoto.
  • Puoi usare Apri query per selezionare fino a 10 file .sql o .txt dal computer locale e aprirli nell’intervallo di query.
  • Puoi fornire feedback sull'editor di query nel database SQL di Azure.

Esplora oggetti

Esplora oggetti consente di visualizzare ed eseguire task su tabelle, visualizzazioni e stored procedure del database.

  • Espandi Tabelle per visualizzare l’elenco di tabelle nel database. Espandi la tabella per visualizzarne le relative colonne. Usa i puntini di sospensione per selezionare le prime 1.000 righe, accedi all'editor dati o rinomina la tabella. Se rinomini una tabella, usa la freccia di aggiornamento per visualizzare le modifiche.
  • Espandi Visualizzazioni per visualizzare un elenco di visualizzazioni nel database. Espandi la vista per visualizzare le colonne al suo interno. Usa i puntini di sospensione per selezionare le prime 1.000 righe o rinominare la visualizzazione. Se rinomini una visualizzazione, usa la freccia di aggiornamento per visualizzare le modifiche.
  • Espandi Stored procedure per visualizzare un elenco di tutte le stored procedure nel database. Espandi una stored procedure per visualizzare l'output della stored procedure. Usa i puntini di sospensione per visualizzare la definizione della stored procedure nell’intervallo di query.

Finestra Query

Questa finestra consente di digitare o incollare una query, quindi eseguirla. I risultati della query verranno visualizzati nel riquadro dei risultati.

Puoi annullare la query. Come indicato in Considerazioni e limitazioni, esiste un periodo di timeout di cinque minuti.

Il pulsante Salva query consente di salvare il testo della query nel computer come file .sql.

Il pulsante Esporta dati come consente di esportare i risultati della query nel computer come file .json, .csv o .xml.

Il tempo di esecuzione della query, o gli errori, vengono visualizzati nella barra di stato.

Copilot per database SQL di Azure (anteprima)

Copilot in database SQL di Azure è un assistente di intelligenza artificiale progettato per semplificare la progettazione, l'operazione, l'ottimizzazione e l'integrità delle applicazioni basate su database SQL di Azure. Migliora la produttività nei portale di Azure offrendo linguaggio naturale per la conversione SQL e l'assistenza self-help per l'amministrazione del database.

L’ esperienza Linguaggio naturale in SQL all'interno dell'editor di query portale di Azure per database SQL di Azure converte le query in linguaggio naturale in SQL, rendendo le interazioni del database più intuitive.

Per un'esercitazione ed esempi di linguaggio naturale per le funzionalità SQL di Copilot in database SQL di Azure, vedere Linguaggio naturale per SQL nell'editor di query portale di Azure (anteprima). Per ulteriori informazioni, vedere Domande frequenti su Copilot in Microsoft Azure SQL (anteprima).

Editor dati

L'editor di dati consente di modificare i dati in una riga esistente, aggiungere una nuova riga di dati alla tabella o eliminare una riga di dati. Ciò è simile all'esperienza in SQL Server Management Studio (SSMS).

Per accedere all'editor di dati, in Esplora oggetti espandi Tabelle, quindi seleziona i puntini di sospensione a destra del nome tabella e seleziona Modifica dati (anteprima).

Per modificare i dati in una riga esistente, seleziona il valore da modificare, apporta la modifica e quindi seleziona Salva nella parte superiore.

  • Se la colonna è una colonna Identity, non puoi modificare tale valore. Viene visualizzato il messaggio di errore: Save failed: Failed to execute query. Error: Cannot update identity column *column_name*.

Per aggiungere una nuova riga, seleziona Crea nuova riga e immetti i valori da aggiungere. In questo contesto non è possibile aggiungere o usare determinati tipi di dati.

  • Se la colonna è una colonna Identity, non puoi aggiungere un valore in tale campo. Viene visualizzato il messaggio di errore: Save failed: Cannot set value in identity columns *column_name*.
  • Le colonne con vincoli predefiniti non vengono rispettate. L'editor di dati non genererà il valore predefinito: prevede che venga immesso un valore. Non è consigliabile usare l'editor di dati per le tabelle con vincoli di colonna predefiniti.
  • Le colonne calcolate non vengono calcolate. Verrà visualizzato il messaggio di errore Save failed: Failed to execute query. Error: The column *column_name* cannot be modified because it is either a computed column or is the result of a UNION operator. Non è consigliabile usare l'editor di dati per le tabelle con colonne calcolate.

Per eliminare una riga di dati, seleziona la riga e seleziona Elimina riga.

  • Se la riga ha una chiave primaria che ha una relazione di chiave esterna con un'altra tabella, quando la riga viene eliminata verranno eliminate anche le righe correlate nell’altraa tabella.

Considerazioni e limitazioni

Quando ci si collega e si eseguono query del database SQL di Azure con l'editor di query nel portale di Azure, si applicano le considerazioni e limitazioni seguenti.

Limitazioni dell'editor di query

  • Se la query include più istruzioni, nella scheda Risultati vengono visualizzati solo i risultati dell'ultima istruzione.
  • L'editor di query non supporta la connessione al database master del server logico. Per collegarsi al database master, usa altri strumenti per eseguire query sul database SQL di Azure.
  • L'editor di query non può collegarsi a un database di replica con ApplicationIntent=ReadOnly. Per collegarti in questo modo, usa SSMS e specifica ApplicationIntent=ReadOnly nella scheda Parametri di collegamento aggiuntivi nelle opzioni di collegamento. Per altre informazioni, vedi Collegamento a una replica di sola lettura.
  • L’editor di query ha un timeout di 5 minuti per l'esecuzione delle query. Per eseguire query più lunghe, usa altri strumenti per eseguire query sul database SQL di Azure.
  • L'editor di query supporta solo la proiezione cilindrica per i tipi di dati Geography.
  • Per tabelle e visualizzazioni di database non è previsto il supporto di IntelliSense, ma l'editor di query supporta il completamento automatico dei nomi già digitati. Per il supporto di IntelliSense, usa altri strumenti per eseguire query sul database SQL di Azure.
  • Premendo F5 viene aggiornata la pagina dell'editor di query e qualsiasi query attualmente nell'editor non viene salvata.

Altri modi per eseguire query sui database SQL di Azure

Oltre all'editor di query nel portale di Azure per il database SQL di Azure, prendi in considerazione gli avvii rapidi seguenti per altri strumenti:

Considerazioni sul collegamento

Risolvere i problemi relativi agli errori di collegamento

  • Se viene visualizzato il messaggio di errore The X-CSRF-Signature header could not be validated, eseguire le azioni seguenti per risolvere il problema:

    • Verifica che l'orologio del computer sia impostato sull'ora e sul fuso orario corretti. Puoi provare a trovare una corrispondenza del fuso orario del computer con Azure cercando il fuso orario per la posizione del database, ad esempio Stati Uniti orientali.
    • Se usi una rete proxy, accertatii che l'intestazione X-CSRF-Signature della richiesta non venga modificata o esclusa.

  • Se il database è serverless e viene visualizzato il messaggio di errore: Database *name* on server *name.database.windows.net* is not currently available. Please retry the connection later. If the problem persists, contact customer support, and provide them the session tracing ID *ID* Indica che il database serverless è attualmente sospeso. In questo caso, selezionando Continue as <user@domain> si invia una richiesta al database da riavviare. Attendi circa un minuto, aggiorna la pagina e riprova.

  • Se viene visualizzato il messaggio di errore "Accesso non riuscito per l'utente <token-identified principal>. Il server non è attualmente configurato per accettare questo token." quando si tenta di usare l'autenticazione AD, l'utente non ha accesso al database.

Connettività della porta 443 e 1443

Se si verifica uno degli errori seguenti nell'editor di query:

  • Your local network settings might be preventing the Query Editor from issuing queries. Please click here for instructions on how to configure your network settings.
  • A connection to the server could not be established. This might indicate an issue with your local firewall configuration or your network proxy settings.

Questi errori si verificano perché l'editor di query non è in grado di comunicare tramite le porte 443 e 1443. Abilita il traffico HTTPS in uscita su queste porte. Le istruzioni seguenti illustrano questo processo, a seconda del sistema operativo. Il reparto IT aziendale potrebbe dover concedere l'approvazione per aprire questo collegamento alla rete locale.

Consenti 443 e 1443 in Windows Defender Firewall

  1. Apri Windows Defender Firewall.
  2. Seleziona Impostazioni avanzate nel menu a sinistra.
  3. In Windows Defender Firewall con sicurezza avanzata, seleziona Regole in uscita nel menu a sinistra.
  4. Seleziona Nuova regola nel menu a destra.
  5. Nella procedura guidata Nuova regola in uscita seguire questi passaggi:
    1. Seleziona porta come tipo di regola da creare e quindi seleziona Avanti.
    2. Selezionare TCP.
    3. Seleziona Porte remote specifiche, immetti 443, 1443e quindi seleziona Avanti.
    4. Seleziona Consenti il collegamento se è sicuro, seleziona Avanti e quindi seleziona di nuovo Avanti.
    5. Mantieni la selezione di Dominio, Privato e Pubblico.
    6. Assegna alla regola un nome, ad esempio Accedere all'editor di query di Azure SQL e, facoltativamente, fornisci una descrizione. Quindi selezionare Fine.

Consentire 443 e 1443 in macOS

  1. Nel menu Apple, apri Preferenze di sistema.
  2. Seleziona Security e privacy e quindi Firewall.
  3. Se Firewall è disattivato, selezionare Fai clic sul blocco per apportare modifiche e selezionare Attiva firewall.
  4. Seleziona Opzioni firewall.
  5. Nella finestra Security e Privacy, seleziona Consentire automaticamente al software firmato di ricevere collegamenti in ingresso.

Consentire 443 e 1443 in Linux

Esegui questi comandi per aggiornare iptables:

sudo iptables -A OUTPUT -p tcp --dport 443 -j ACCEPT
sudo iptables -A OUTPUT -p tcp --dport 1443 -j ACCEPT

Consentire 443 e 1443 nella VM di Azure

Quando usi VM di Azure, disponi di un gruppo di sicurezza di rete di Azure che blocca la connettività. Un gruppo di sicurezza di rete filtra il traffico di rete in ingresso e in uscita da e verso le risorse di Azure in una rete virtuale di Azure. Devi aggiungere le regole di sicurezza in uscita al gruppo di sicurezza di rete. Per un esempio, vedi Creare regole di sicurezza.

Passaggio successivo

Avvio rapido: usare l'editor di query del portale di Azure per eseguire query su un database SQL di Azure

Contenuto correlato