Condividi tramite

Tipo di variabile di riferimento alla connessione (anteprima)

Una variabile di riferimento alla connessione è una variabile dell'area di lavoro che archivia l'ID di una connessione dati esterna (ad esempio Snowflake, Azure SQL), consentendo agli elementi di fare riferimento a risorse esterne senza incorporare credenziali o stringhe di connessione.

Come usare

Una variabile di riferimento alla connessione può essere usata esattamente come altre variabili in una libreria di variabili.

  1. Accedere a Microsoft Fabric
  2. Passare all'area di lavoro e alla libreria di variabili
  3. Nella parte superiore selezionare + Nuova variabile
  4. Specificare un nome per la variabile, selezionare il riferimento di connessione per il tipo e quindi fare clic su ... per selezionare un valore

Screenshot degli elementi disponibili per il riferimento alla connessione. 5. Una volta selezionato, il riferimento alla connessione deve essere pronto per l'uso.

Screenshot del riferimento alla connessione.

Se è necessario modificare un riferimento alla connessione o controllare il valore, è possibile fare clic con il pulsante destro del mouse sul valore per visualizzare un popup con informazioni sul riferimento alla connessione.

Screenshot del popup di riferimento alla connessione.

Come funziona

Il valore di una variabile di riferimento alla connessione è un puntatore statico a un oggetto connessione identificato dal relativo ID connessione. Il valore viene archiviato come stringa corrispondente all'ID della connessione di destinazione. Per esempio:

ConnectionID = aaaaaaa-0000-1111-2222-bbbbbbbbbb

Questo ID identifica in modo univoco la connessione a cui si fa riferimento. Il riferimento statico non si adatta automaticamente a ambienti di distribuzione diversi. Richiede che la connessione di destinazione esista al momento della selezione e rimanga puntata a quella specifica connessione, a meno che non venga modificata manualmente.

Quando si lavora con i riferimenti alla connessione, tenere presente quanto segue:

  • Archivia un identificatore di connessione predefinito a livello di tenant.
  • I riferimenti alla connessione non vengono associati automaticamente durante la distribuzione. I valori rimangono fissi in ambienti diversi.
  • Supporta CI/CD e automazione parametrizzando le connessioni esterne per ambienti diversi (sviluppo, test, produzione).
  • Abilita la configurazione dinamica delle relazioni esterne ( ad esempio, cambio di origini dati o credenziali per ambiente).
  • I valori vengono scelti tramite una finestra di dialogo dell'interfaccia utente, non testo libero, assicurando che solo le connessioni autorizzate siano selezionabili.
  • Solo le connessioni con autorizzazioni di lettura almeno sono disponibili per la selezione.

Rappresentazione in Git e API

Un riferimento alla connessione è un tipo di variabile avanzata il cui schema del valore archivia l'ID di connessione e la piattaforma risolve/visualizza i metadati. Il payload di creazione include:

  • name: il displayName della variabile di riferimento alla connessione
  • nota: facoltativo, può essere usato per la descrizione o altre note.
  • type: "connectionReference" (tipo avanzato)
  • value: per insieme di valori, ogni valore memorizza { "connectionId": "<GUID/ID string>" }

Esempio:


  {
   "name": "PrimaryDb",
   "note": "",
   "type": "connectionReference",
   "value": { "connectionId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb" }
  }

Autorizzazioni necessarie per creare/usare riferimenti alla connessione

L'uso delle variabili di riferimento alla connessione prevede due livelli di autorizzazioni:

  • Creare e modificare una variabile di riferimento alla connessione: gli utenti con ruolo Collaboratore o superiore nell'area di lavoro possono creare e modificare variabili nella libreria, mentre i visualizzatori sono di sola lettura.
  • Accesso alla variabile di riferimento alla connessione: oltre ai diritti per la libreria di variabili, è necessario disporre almeno dell'autorizzazione Lettura per la variabile di riferimento alla connessione a cui si intende fare riferimento.

Per altre informazioni sulle autorizzazioni e la convalida delle autorizzazioni, vedere Autorizzazioni della libreria di variabili

Elementi supportati

Di seguito è riportato un elenco di elementi che supportano le variabili di riferimento alla connessione:

Esempio di codice Python

L'esempio di codice seguente illustra come usare un riferimento alla connessione in uno script Python.

var_ref = "$(/**/VarLibItem/ConnectionReference)"
var_obj = notebookutils.variableLibrary.get(var_ref)
connection_id = var_obj.get("connectionId").value()
print(connection_id)

Questo codice esegue le operazioni seguenti:

  • Risolve una variabile di riferimento alla connessione da una libreria di variabili per Fabric
  • Recupera l'oggetto metadati di connessione
  • Estrae il connectionId
  • Stampa l'ID in modo che possa essere usato nel codice o nelle chiamate API.

Limitazioni

Le limitazioni seguenti si applicano alle variabili di riferimento alla connessione:

  • Le connessioni predefinite nei notebook non sono supportate perché il connection_id per la connessione notebook non è lo stesso.

Contenuti correlati

  • Last updated on