Condividi tramite


Gestione delle origini dati

Microsoft Fabric funziona con molte origini dati, sia in locale che nel cloud. Ogni origine dati ha requisiti di configurazione specifici. Questo articolo illustra come aggiungere un SQL Server di Azure come origine dati cloud come esempio e il processo è simile per altre origini. Per informazioni sulle origini dati in locale, vedere Aggiungere o rimuovere un'origine dati del gateway.

Nota

Al momento, le connessioni cloud funzionano con le pipeline e Kusto. Per dataset, datamarts e flussi di dati, è necessario usare l'esperienza di "recupero dati" di Power Query Online per creare connessioni cloud personali.

Aggiungere un'origine dati

Ecco come aggiungere una nuova origine dati:

  1. Aprire il servizio Microsoft Fabric e selezionare l'icona Settings nell'intestazione. Quindi selezionare Gestisci connessioni e gateway.

    Screenshot che mostra dove selezionare Gestisci connessioni e gateway.

  2. Nella scheda Connessioni selezionare Nuovo nella parte superiore della schermata .

  3. Nella schermata Nuova connessione :

    • Selezionare Cloud
    • Immettere un nome di connessione descrittivo
    • Scegliere il tipo di connessione (in questo esempio viene usato SQL Server )
  4. Compilare i dettagli dell'origine dati. Per SQL Server, è necessario:

    • Nome server
    • Nome database

    Screenshot che mostra esempi di dettagli nella schermata Nuova connessione.

  5. Scegliere il metodo di autenticazione:

    • Basic
    • OAuth2
    • Principale del servizio

    Screenshot che mostra dove selezionare un metodo di autenticazione.

    Nota

    Se si usa OAuth2:

    • Le query con esecuzione prolungata potrebbero non riuscire se superano la scadenza del token OAuth
    • Gli account di Microsoft Entra tra differenti tenant non sono supportati
  6. Facoltativo: configura un livello di privacy sotto Generale>Livello di privacy. Questa impostazione non influisce sulle connessioni DirectQuery .

    Screenshot che mostra le opzioni del livello di privacy.

  7. Fare clic su Crea. Viene visualizzato un messaggio Creata nuova connessione in Impostazioni quando riesce.

    Screenshot del messaggio di riuscita della nuova connessione.

Dopo la creazione, è possibile usare questa origine dati per usare i dati Azure SQL negli elementi Microsoft Fabric supportati.

Consentire l'utilizzo della connessione cloud nel gateway

Quando si crea una connessione, viene visualizzata un'impostazione con l'etichetta Questa connessione può essere usata con gateway dati locali e gateway dati di rete virtuale. Questa impostazione controlla se la connessione può funzionare con i gateway:

  • Se deselezionata: la connessione non può essere usata con valutazioni basate su gateway
  • Quando attivata: la connessione può funzionare con valutazioni basate su gateway

Attenzione

Anche se questa impostazione viene visualizzata durante la creazione di connessioni cloud tramite Dataflow Gen2, non viene attualmente applicata. Tutte le connessioni cloud condivisibili funzionano tramite un gateway, se presente.

Rimuovere un'origine dati

Per rimuovere un'origine dati non più necessaria, seguire questa procedura:

  1. Vai alla schermata Dati in Gestione connessioni e gateway
  2. Selezionare l'origine dati
  3. Selezionare Rimuovi dalla barra multifunzione superiore

Importante

Quando si rimuove un'origine dati, tutti gli elementi che dipendono dall'origine non funzionano più.

Screenshot della posizione da cui selezionare Rimuovi.

Ottenere un ID connessione all'origine dati

Per recuperare un ID di connessione da usare in Microsoft Fabric elementi o API REST, usare uno di questi metodi:

Usare l'interfaccia del servizio

  1. Vai a Gestire connessioni e gateway

    Screenshot della posizione in cui selezionare Impostazioni.

  2. Nella schermata delle Impostazioni della connessione, copiare l'ID della connessione dell'origine dati.

    Screenshot del recupero dell'ID della connessione dalle Impostazioni di connessione.

Usare l'API REST

Usare l'endpoint List Connections per recuperare le informazioni di connessione:

  1. Inviare il GET HTTP all'API Fabric Connections, includendo il token nell'intestazione Authorization.

    curl -X GET https://api.fabric.microsoft.com/v1/connections \
    -H "Authorization: Bearer $ACCESS_TOKEN"
    
  2. Una risposta con esito positivo restituisce un payload JSON simile al seguente:

     {
     "value": [
        {
           "id": "bbbbbbbb-1111-2222-3333-cccccccccccc",
           "displayName": "ContosoConnection1",
           …
        },
        {
           "id": "cccccccc-2222-3333-4444-dddddddddddd",
           "displayName": "ContosoConnection2",
           …
        }
     ],
     "continuationToken": "…",
     "continuationUri": "…"
     }
    
  3. La proprietà id di ogni oggetto nell'array value è l'ID della connessione. Estrarre la id proprietà dalla risposta in base alle esigenze.

    Nota

    Se si dispone di più di 100 connessioni, usare il continuationToken parametro di query nelle richieste successive per scorrere tutti i risultati.

Ecco un frammento di Python di esempio che usa requests e Microsoft Authentication Library (msal) per chiamare l'endpoint GET /v1/connections e analizzare gli ID connessione:

import requests
import msal

# 1. Acquire token
app = msal.ConfidentialClientApplication(
   client_id="YOUR_CLIENT_ID",
   client_credential="YOUR_CLIENT_SECRET",
   authority="https://login.microsoftonline.com/YOUR_TENANT_ID"
)
result = app.acquire_token_for_client(scopes=["https://api.fabric.microsoft.com/.default"])
token = result["access_token"]

# 2. Call API
headers = {"Authorization": f"Bearer {token}"}
resp = requests.get("https://api.fabric.microsoft.com/v1/connections", headers=headers)
resp.raise_for_status()

# 3. Parse IDs
for conn in resp.json().get("value", []):
   print(f"{conn['displayName']}: {conn['id']}")

Recente connessione (anteprima)

Microsoft Fabric fornisce proprietà basate sull'utilizzo per comprendere meglio come vengono configurate e usate le connessioni nel tempo. Queste proprietà migliorano la visibilità del controllo e supportano la gestione del ciclo di vita delle connessioni più sicura.

Nel corso del tempo, le connessioni possono essere riutilizzate, sostituite o lasciate inattive. Senza segnali di utilizzo chiari, può essere difficile determinare se una connessione è ancora attiva o sicura da modificare, ruotare le credenziali o rimuovere. La funzionalità Last Used Time introduce metadati aggiuntivi che consentono di prendere decisioni più informate.

Screenshot che mostra la recenti della connessione.

Nei metadati di connessione sono disponibili due nuove proprietà:

Ultimo collegamento agli elementi

  • Mostra l'ora più recente in cui la connessione è stata collegata a un elemento Fabric.

  • Riflette l'attività di configurazione, ad esempio quando la connessione è stata associata a una pipeline o a un altro artefatto.

  • Consente di identificare le connessioni appena create o appena riutilizzate.

Questa proprietà indica quando una connessione è stata configurata per l'ultima volta o associata a un elemento.

Ultime credenziali usate

  • Mostra l'ora più recente in cui sono state usate le credenziali della connessione in fase di esecuzione.

  • Riflette l'utilizzo effettivo dell'esecuzione, non solo la configurazione.

  • Consente di distinguere tra le connessioni definite e le connessioni usate attivamente.

Questa proprietà indica quando è stata usata per l'ultima volta una connessione per eseguire un carico di lavoro.

Insieme, queste proprietà forniscono segnali di configurazione e segnali di utilizzo del runtime per ottenere informazioni operative migliori.

Gestisci utenti

Dopo aver aggiunto un'origine dati cloud, concedere agli utenti e ai gruppi di sicurezza l'accesso all'origine dati specifica. L'elenco di accesso per l'origine dati controlla solo chi è autorizzato a utilizzare l'origine dati negli elementi che includono dati dell'origine dati.

Nota

La condivisione delle connessioni con altri utenti comporta rischi di modifiche non autorizzate e potenziale perdita di dati. Gli utenti con accesso all'origine dati possono scrivere dati nell'origine dati e connettersi in base alle credenziali memorizzate o al SSO selezionato durante la creazione dell'origine dati. Prima di condividere una connessione all'origine dati, assicuratevi sempre che gli account utente o gruppo che state condividendo siano attendibili e abbiano solo i privilegi necessari (idealmente, un account di servizio con diritti limitati nello scopo).

Aggiungere utenti a un'origine dati

  1. Selezionare l'icona Impostazioni e aprire Gestisci connessioni e gateway

  2. Trova l'origine dati nell'elenco. Usare il filtro o la ricerca nella barra multifunzione superiore per individuare rapidamente le connessioni cloud.

    Screenshot che mostra dove trovare tutte le connessioni cloud.

  3. Selezionare Gestisci utenti nella barra multifunzione superiore

  4. Nella schermata Gestisci utenti :

    • Aggiungere utenti o gruppi di sicurezza dall'organizzazione
    • Selezionare il nuovo nome utente
    • Scegliere il proprio ruolo: Utente, Utente con ricondivisione o Proprietario
  5. Selezionare Condividi per concedere loro l'accesso

    Screenshot che mostra la schermata Gestisci utenti.

Nota

È necessario aggiungere utenti a ogni origine dati separatamente, ognuno ha un proprio elenco di accesso.

Rimuovere utenti da un'origine dati

Per rimuovere l'accesso, passare alla scheda Gestisci utenti e rimuovere l'utente o il gruppo di sicurezza dall'elenco.

Gestire le autorizzazioni di condivisione

Controllare chi può condividere le connessioni nell'organizzazione. Per impostazione predefinita, gli utenti possono condividere le connessioni se sono:

  • Proprietari di connessioni o amministratori
  • Utenti con autorizzazioni di condivisione

La condivisione delle connessioni consente ai team di collaborare mantenendo al tempo stesso le credenziali protette. Le connessioni condivise funzionano solo all'interno di Fabric.

Limitare la condivisione delle connessioni

Gli amministratori tenant possono limitare gli utenti che possono condividere le connessioni:

  1. Sono necessari privilegi di amministratore del servizio Power BI

  2. Aprire le impostazioni di Power BI o Infrastruttura e passare a Gestisci connessioni e gateway

  3. Attivare l'opzione amministrazione del tenant in alto a destra

    Screenshot che mostra l'opzione di gestione tenant nella pagina di gestione delle connessioni e dei gateway.

  4. Selezionare Blocco delle connessioni cloud condivisibili e attivarlo.

    • Se disattivata (impostazione predefinita): qualsiasi utente può condividere le connessioni
    • Quando attivato: la condivisione è bloccata a livello di tenant

    Screenshot che mostra la funzionalità di gestione della condivisione delle connessioni cloud.

  5. Facoltativo: aggiungere utenti specifici a un elenco di elementi consentiti:

    • Cercare gli utenti e selezionare Aggiungi
    • Gli utenti elencati possono comunque condividere le connessioni
    • Tutti gli altri utenti sono bloccati dalla condivisione

    Screenshot che mostra la funzionalità di gestione della condivisione della connessione cloud attivata.

Nota

  • Il blocco della condivisione potrebbe limitare la collaborazione tra gli utenti
  • Le connessioni condivise esistenti rimangono condivise quando si attiva la restrizione