Condividi tramite

Guida introduttiva: Connettersi ed eseguire query su un database SQL nell'ambiente Fabric usando SQL Server Management Studio (SSMS)

Si applica a:Database SQL in Microsoft Fabric

Introduzione all'uso di SQL Server Management Studio (SSMS) per connettersi al database SQL in Microsoft Fabric ed eseguire alcuni comandi Transact-SQL (T-SQL).

Annotazioni

Anche se Microsoft Entra ID è il nuovo nome per Azure Active Directory (Azure AD), per evitare l'interruzione degli ambienti esistenti, la denominazione Azure AD è tuttora mantenuta in alcuni elementi hardcoded, ad esempio campi dell'interfaccia utente, provider di connessioni, codici errore e cmdlet. All’interno di questo articolo i due nomi vengono utilizzati in modo intercambiabile.

L'articolo illustra i passaggi seguenti:

  • Connettersi a un database SQL in Fabric
  • Creare una tabella nel nuovo database
  • Inserire righe nella nuova tabella
  • Eseguire una query sulla nuova tabella e visualizzare i risultati
  • Usare la tabella della finestra di query per verificare le proprietà di connessione
  • Rimuovere il database

Prerequisiti

Connettersi a un database SQL in Fabric

Annotazioni

Le versioni di SSMS precedenti alla 18.6 non eseguono l'autenticazione ai motori di database tramite l'autenticazione a più fattori (MFA) di Microsoft Entra. Per continuare a usare MFA, è necessario SSMS 18.6 o una versione successiva.

  1. Avviare SQL Server Management Studio (SSMS). La prima volta che si esegue SSMS, viene visualizzata la finestra Connetti al server . Se non è aperto, è possibile aprirlo manualmente selezionando Esplora oggetti>Connetti>motore di database.

    Screenshot del collegamento Connetti in Esplora oggetti.

  2. Individuare il nome del server e il nome del database SQL nel portale di Fabric.

    La stringa di connessione del database SQL è simile alla stringa di connessione del database SQL di Azure. Il nome del server assomiglia a <server-unique-identifer>.database.windows.net e il nome del database assomiglia a <database name>-<unique identifier>.

    Per trovare la stringa di connessione SQL per il database SQL in Fabric:

    • Passare alle impostazioni dell'elemento del database SQL. Selezionare Stringhe di connessione. Il nome del server è Data source e il nome del database è .Initial Catalog

    • In alternativa, nell'elenco di voci dell'area di lavoro selezionare il ... menu. Selezionare Impostazioni e quindi Stringhe di connessione.

    • In alternativa, selezionare il pulsante Apri in e SQL Server Management Studio. Vengono visualizzate le informazioni di connessione al server.

      Screenshot del portale Fabric del pulsante

      Screenshot del portale Fabric della finestra di dialogo di connessione di SQL Server Management Studio, che mostra il nome del server e del database.

  3. Verrà visualizzata la finestra di dialogo Connetti al server . Immettere le informazioni seguenti. Tutte le altre impostazioni possono essere lasciate predefinite:

    Impostazione Valore suggerito Dettagli
    Tipo di server Motore di database Selezionare Motore di database (in genere l'opzione predefinita).
    Nome server Nome di dominio completo del server Immettere il nome del server, incluso .database.fabric.microsoft.com,1433.
    Autenticazione Scegliere Microsoft Entra MFA. Per altre informazioni, vedere Autenticazione nel database SQL in Microsoft Fabric.
    Nome database Fornisci il nome del tuo database SQL.

    È anche possibile modificare opzioni di connessione aggiuntive selezionando Opzioni. Esempi di opzioni di connessione sono il database a cui ci si connette, il valore di timeout della connessione e il protocollo di rete. Questo articolo usa i valori predefiniti per tutte le opzioni.

  4. Selezionare Connetti.

  5. Per verificare che la connessione al database SQL in Infrastruttura sia riuscita, espandere ed esplorare gli oggetti in Esplora oggetti in cui vengono visualizzati il nome del server, la versione di SQL Server e il nome utente. Questi oggetti sono diversi a seconda del tipo di server.

Risolvere i problemi di connettività

  • Se il browser non riesce a connettersi al database SQL quando si usa Microsoft Entra con MFA, è possibile passare a Strumenti>Opzioni>Servizi> diAzure Cloud di Azure e modificare il valore per Usare il Web browser predefinito del sistema o Usare Gestione account Web. Per altre informazioni, vedere Opzioni (Servizi di Azure).

  • Se si verificano problemi di connessione con il database SQL in Fabric, vedere Informazioni sulla sicurezza di rete in Microsoft Fabric.

Cancellare la cache dei token ID di Microsoft Entra

SQL Server Management Studio (SSMS) memorizza brevemente nella cache i token ID di Microsoft Entra. Quando un utente viene aggiunto a un gruppo microsoft Entra ID e tenta immediatamente di eseguire l'autenticazione da SSMS, viene generato il messaggio di errore seguente:

Login failed for user '<token-identified principal>'.
(Microsoft SQL Server, Error: 18456)

Se hai ottenuto di recente l'accesso a un server, puoi cancellare la cache dei token ID di Microsoft Entra da Aiuto>Cancella Cache Token Entra ID.

Screenshot del menu della Guida, con l'opzione

Nella finestra di dialogo seguente viene descritto il motivo per cui questa opzione è utile se di recente è stato ricevuto l'accesso a un server e richiedere di nuovo l'autenticazione.

Screenshot della finestra di dialogo che richiede la conferma per cancellare la cache dei token utente di Microsoft Entra ID.

Creare una tabella nel nuovo database

In questa sezione viene creata una tabella nel database.

  1. Nell'elenco Database di Esplora oggetti fare clic con il pulsante destro del mouse sul database e scegliere Nuova query:

    Screenshot che mostra come creare una nuova query.

  2. Incollare il frammento di codice T-SQL seguente nella finestra di query:

    -- Create a new table called 'Customers' in schema 'dbo'
-- Drop the table if it already exists
IF OBJECT_ID('dbo.Customers', 'U') IS NOT NULL
    DROP TABLE dbo.Customers;
GO

-- Create the table in the specified schema
CREATE TABLE dbo.Customers
(
    CustomerId INT NOT NULL PRIMARY KEY, -- primary key column
    Name NVARCHAR (50) NOT NULL,
    Location NVARCHAR (50) NOT NULL,
    Email NVARCHAR (50) NOT NULL
);
GO

  3. Eseguire la query selezionando Esegui o selezionando F5 sulla tastiera.

Al termine della query, la nuova Customers tabella viene visualizzata nell'elenco delle tabelle in Esplora oggetti. Se la tabella non viene visualizzata, fare clic con il pulsante destro del mouse sul nodoTabelle> in Esplora oggetti e quindi scegliere Aggiorna.

Screenshot che mostra La nuova tabella.

Inserire righe nella nuova tabella

Inserire ora alcune righe nella Customers tabella creata. Incollare il frammento di codice T-SQL seguente nella finestra di query e quindi selezionare Esegui:

-- Insert rows into table 'Customers'
INSERT INTO dbo.Customers (
    [CustomerId],
    [Name],
    [Location],
    [Email]
)
VALUES
    (1, N'Orlando', N'Australia', N''),
    (2, N'Keith', N'India', N'keith0@adventure-works.com'),
    (3, N'Donna', N'Germany', N'donna0@adventure-works.com'),
    (4, N'Janet', N'United States', N'janet1@adventure-works.com');
GO

Eseguire query sulla tabella e visualizzare i risultati

I risultati di una query sono visibili sotto la finestra di testo della query. Per eseguire query sulla Customers tabella e visualizzare le righe inserite, incollare il frammento di codice T-SQL seguente nella finestra di query e quindi selezionare Esegui:

-- Select rows from table 'Customers'
SELECT * FROM dbo.Customers;

I risultati della query vengono visualizzati nell'area in cui è stato immesso il testo.

Screenshot che mostra l'elenco dei risultati.

È anche possibile modificare il modo in cui vengono presentati i risultati selezionando una delle opzioni seguenti:

Screenshot di tre opzioni per la visualizzazione dei risultati delle query.

  • Il primo pulsante visualizza i risultati in Visualizzazione testo, come illustrato nell'immagine nella sezione successiva.
  • Il pulsante centrale visualizza i risultati in Visualizzazione griglia, ovvero l'opzione predefinita.
  • Il terzo pulsante consente di salvare i risultati in un file la cui estensione è .rpt per impostazione predefinita.

Verificare le proprietà di connessione usando la tabella della finestra di query

È possibile trovare informazioni sulle proprietà di connessione nei risultati della query. Dopo aver eseguito la query indicata in precedenza nel passaggio precedente, esaminare le proprietà di connessione nella parte inferiore della finestra di query.

  • È possibile determinare il server e il database a cui si è connessi e il nome utente.

  • È anche possibile visualizzare la durata della query e il numero di righe restituite dalla query eseguita in precedenza.

    Screenshot delle proprietà di connessione.

Pulire le risorse

Rimuovere la tabella di esempio creata in questa guida introduttiva. Incollare il codice T-SQL seguente ed eseguire:

DROP TABLE dbo.Customers;

Contenuti correlati

  • Last updated on