Avvio rapido: Usare l'editor di query del portale di Azure per eseguire query su un database SQL di AzureQuickstart: Use the Azure portal's query editor to query an Azure SQL Database

SI APPLICA A: Database SQL di Azure

L'editor di query è uno strumento del portale di Azure per l'esecuzione di query SQL sul database in Database SQL di Azure o sul data warehouse in Azure Synapse Analytics.The query editor is a tool in the Azure portal for running SQL queries against your database in Azure SQL Database or data warehouse in Azure Synapse Analytics.

In questa guida di avvio rapido si userà l'editor di query per eseguire query T-SQL (Transact-SQL) su un database.In this quickstart, you'll use the query editor to run Transact-SQL (T-SQL) queries against a database.

PrerequisitiPrerequisites

Per completare questo argomento di avvio rapido, è necessario il database di esempio AdventureWorksLT.Completing this quickstart requires the AdventureWorksLT sample database. Se non si ha una copia di lavoro del database di esempio AdventureWorksLT nel database SQL, seguire questa guida di avvio rapido per crearne velocemente una:If you don't have a working copy of the AdventureWorksLT sample database in SQL Database, the following quickstart quickly creates one:

Configurare le impostazioni di reteConfigure network settings

Se si verifica uno degli errori seguenti nell'editor di query: Le impostazioni di rete locali potrebbero impedire all'editor di query di inviare query. Fare clic qui per le istruzioni su come configurare le impostazioni di rete oppure Non è stato possibile stabilire una connessione al server. Questo potrebbe indicare un problema con la configurazione locale del firewall o le impostazioni del proxy di rete, le informazioni importanti seguenti dovrebbero consentire di risolverlo:If you get one of the following errors in the query editor: 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, or A connection to the server could not be established. This might indicate an issue with your local firewall configuration or your network proxy settings, the following important information should help resolve:

Importante

L'editor di query usa le porte 443 e 1443 per comunicare.The query editor uses ports 443 and 1443 to communicate. Assicurarsi di aver abilitato il traffico HTTPS in uscita su queste porte.Ensure you have enabled outbound HTTPS traffic on these ports. È anche necessario aggiungere l'indirizzo IP in uscita per le regole del firewall consentite del server per accedere ai database e ai data warehouse.You also need to add your outbound IP address to the server's allowed firewall rules to access your databases and data warehouses.

Aprire l'editor di query del database SQLOpen the SQL Database Query Editor

  1. Accedere al portale di Azure e selezionare il database su cui eseguire query.Sign in to the Azure portal and select the database you want to query.

  2. Dal menu Database SQL scegliere Editor di query (anteprima) .In the SQL database menu, select Query editor (preview).

    Cercare l'editor di query

Stabilire una connessione con il databaseEstablish a connection to the database

Anche se è stato eseguito l'accesso al portale, è comunque necessario fornire le credenziali per accedere al database.Even though you're signed into the portal, you still need to provide credentials to access the database. Per connettersi al database, è possibile usare l'autenticazione SQL o Azure Active Directory.You can connect using SQL authentication or Azure Active Directory to connect to your database.

Connettersi con l'autenticazione SQLConnect using SQL Authentication

  1. Nella pagina Accesso, in Autenticazione di SQL Server, immettere l'account di accesso e la password di un utente che ha accesso al database.In the Login page, under SQL server authentication, enter a Login and Password for a user that has access to the database. In caso di dubbi, usare l'account di accesso e la password dell'amministratore del server di database.If you're not sure, use the login and password for the Server admin of the database's server.

    sign in

  2. Selezionare OK.Select OK.

Connettersi con Azure Active DirectoryConnect using Azure Active Directory

La configurazione di un amministratore di Azure Active Directory (Azure AD) consente di usare una singola identità per accedere al portale di Azure e al database.Configuring an Azure Active Directory (Azure AD) administrator enables you to use a single identity to sign in to the Azure portal and your database. Per connettersi al database con Azure AD, seguire questa procedura per configurare un amministratore di Azure AD per l'istanza di SQL Server.To connect to your database using Azure AD, follow the steps below to configure an Azure AD admin for your SQL Server instance.

Nota

  • Gli account di posta elettronica (ad esempio outlook.com, gmail.com, yahoo.com e così via) non sono ancora supportati come amministratori di Azure AD.Email accounts (for example, outlook.com, gmail.com, yahoo.com, and so on) aren't yet supported as Azure AD admins. Assicurarsi di scegliere un utente creato in modo nativo o federato in Azure AD.Make sure to choose a user created either natively in the Azure AD or federated into the Azure AD.
  • L'accesso come amministratore di Azure AD non funziona con account per cui è abilitata l'autenticazione a due fattori.Azure AD admin sign in doesn't work with accounts that have 2-factor authentication enabled.

Impostare un amministratore di Active Directory per il serverSet an Active Directory admin for the server

  1. Nel portale di Azure selezionare l'istanza di SQL Server.In the Azure portal, select your SQL Server instance.

  2. Scegliere Amministratore di Active Directory dal menu SQL Server.On the SQL server menu, select Active Directory admin.

  3. Sulla barra degli strumenti della pagina Amministratore di Active Directory di SQL Server selezionare Imposta amministratore e scegliere l'utente o il gruppo da usare come amministratore di Azure AD.On the SQL Server Active Directory admin page toolbar, select Set admin and choose the user or group as your Azure AD admin.

    Active Directory: selezione

  4. Nella casella di ricerca della pagina Aggiungi amministratore immettere un utente o un gruppo da trovare, selezionarlo come amministratore e quindi scegliere il pulsante Seleziona.On the Add admin page, in the search box, enter a user or group to find, select it as an admin, and then choose the Select button.

  5. Di nuovo sulla barra degli strumenti della pagina Amministratore di Active Directory di SQL Server selezionare Salva.Back in the SQL Server Active Directory admin page toolbar, select Save.

Stabilire la connessione al databaseConnect to the database

  1. Dal menu SQL Server scegliere Database SQL e quindi selezionare il database desiderato.In the SQL server menu, select SQL databases, and then select your database.

  2. Dal menu Database SQL scegliere Editor di query (anteprima) .In the SQL database menu, select Query editor (preview). Nella pagina Accesso, sotto l'etichetta Autenticazione di Active Directory, viene visualizzato un messaggio che indica che si è avuto accesso se si è amministratori di Azure AD. Fare clic sul pulsante Continua come <your user or group ID> .In the Login page, under the Active Directory authentication label, a message appears saying you have been signed in if you're an Azure AD admin. Then select the Continue as <your user or group ID> button. Se la pagina indica che l'accesso non è riuscito, potrebbe essere necessario aggiornarla.If the page indicates that you have not successfully logged in, you may need to refresh the page.

Eseguire query su un database nel database SQLQuery a database in SQL Database

Le query di esempio seguenti dovrebbero essere eseguite correttamente sul database di esempio AdventureWorksLT.The following example queries should run successfully against the AdventureWorksLT sample database.

Eseguire una query SELECTRun a SELECT query

  1. Incollare la query seguente nell'editor di query:Paste the following query into the query editor:

     SELECT TOP 20 pc.Name as CategoryName, p.name as ProductName
     FROM SalesLT.ProductCategory pc
     JOIN SalesLT.Product p
     ON pc.productcategoryid = p.productcategoryid;
    
  2. Selezionare Esegui e quindi esaminare l'output nel riquadro Risultati.Select Run and then review the output in the Results pane.

    Risultati dell'Editor di query

  3. Facoltativamente, è possibile salvare la query come file con estensione sql oppure esportare i dati restituiti come file JSON, CSV o XML.Optionally, you can save the query as a .sql file, or export the returned data as a .json, .csv, or .xml file.

Eseguire una query INSERTRun an INSERT query

Eseguire l'istruzione T-SQL INSERT seguente per aggiungere un nuovo prodotto nella tabella SalesLT.Product.Run the following INSERT T-SQL statement to add a new product in the SalesLT.Product table.

  1. Sostituire la query precedente con questa.Replace the previous query with this one.

    INSERT INTO [SalesLT].[Product]
           ( [Name]
           , [ProductNumber]
           , [Color]
           , [ProductCategoryID]
           , [StandardCost]
           , [ListPrice]
           , [SellStartDate]
           )
    VALUES
           ('myNewProduct'
           ,123456789
           ,'NewColor'
           ,1
           ,100
           ,100
           ,GETDATE() );
    
  2. Selezionare Esegui per inserire una nuova riga nella tabella Product.Select Run to insert a new row in the Product table. Nel riquadro Messaggi verrà visualizzato Query succeeded: Affected rows: 1 (Query riuscita. Righe interessate: 1).The Messages pane displays Query succeeded: Affected rows: 1.

Eseguire una query UPDATERun an UPDATE query

Eseguire l'istruzione T-SQL UPDATE seguente per modificare il nuovo prodotto.Run the following UPDATE T-SQL statement to modify your new product.

  1. Sostituire la query precedente con questa.Replace the previous query with this one.

    UPDATE [SalesLT].[Product]
    SET [ListPrice] = 125
    WHERE Name = 'myNewProduct';
    
  2. Selezionare Esegui per aggiornare la riga specificata nella tabella Product.Select Run to update the specified row in the Product table. Nel riquadro Messaggi verrà visualizzato Query succeeded: Affected rows: 1 (Query riuscita. Righe interessate: 1).The Messages pane displays Query succeeded: Affected rows: 1.

Eseguire una query DELETERun a DELETE query

Eseguire l'istruzione T-SQL DELETE seguente per rimuovere il nuovo prodotto.Run the following DELETE T-SQL statement to remove your new product.

  1. Sostituire la query precedente con questa:Replace the previous query with this one:

    DELETE FROM [SalesLT].[Product]
    WHERE Name = 'myNewProduct';
    
  2. Selezionare Esegui per eliminare la riga specificata nella tabella Product.Select Run to delete the specified row in the Product table. Nel riquadro Messaggi verrà visualizzato Query succeeded: Affected rows: 1 (Query riuscita. Righe interessate: 1).The Messages pane displays Query succeeded: Affected rows: 1.

Considerazioni sull'editor di queryQuery editor considerations

Quando si usa l'editor di query è necessario tenere presente quanto segue.There are a few things to know when working with the query editor.

  • L'editor di query usa le porte 443 e 1443 per comunicare.The query editor uses ports 443 and 1443 to communicate. Assicurarsi di aver abilitato il traffico HTTPS in uscita su queste porte.Ensure you have enabled outbound HTTPS traffic on these ports. È anche necessario aggiungere l'indirizzo IP in uscita per le regole del firewall consentite del server per accedere ai database e ai data warehouse.You will also need to add your outbound IP address to the server's allowed firewall rules to access your databases and data warehouses.

  • Se si usa la connessione collegamento privato, l'editor di query funziona senza dover aggiungere l'indirizzo IP del client nel firewall del database SQL.If you have a Private Link connection, the Query Editor works without needing to add the Client Ip address into the SQL Database firewall.

  • Premendo F5, la pagina dell'editor di query verrà aggiornata e qualsiasi query in uso andrà persa.Pressing F5 refreshes the query editor page and any query being worked on is lost.

  • L'editor di query non supporta la connessione al database master.Query editor doesn't support connecting to the master database.

  • Esiste un timeout di 5 minuti per l'esecuzione delle query.There's a 5-minute timeout for query execution.

  • L'editor di query supporta solo la proiezione cilindrica per i tipi di dati Geography.The query editor only supports cylindrical projection for geography data types.

  • Per tabelle e viste di database non è previsto il supporto di IntelliSense, ma l'editor supporta il completamento automatico dei nomi già digitati.There's no support for IntelliSense for database tables and views, but the editor does support autocomplete on names that have already been typed.

Passaggi successiviNext steps

Per altre informazioni sul supporto per T-SQL (Transact-SQL) disponibile nei database SQL di Azure, vedere Risoluzione delle differenze di Transact-SQL durante la migrazione al database SQL.To learn more about the Transact-SQL (T-SQL) supported in Azure SQL Database, see Resolving Transact-SQL differences during migration to SQL Database.