Partager via

Type de variable de référence de connexion (préversion)

Une variable de référence de connexion est une variable d’espace de travail qui stocke l’ID d’une connexion de données externe (par exemple, Snowflake, Azure SQL), ce qui permet aux éléments de référencer des ressources externes sans incorporer d’informations d’identification ou de chaînes de connexion.

Guide pratique pour utiliser

Une variable de référence de connexion peut être utilisée comme d’autres variables dans une bibliothèque de variables.

  1. Connectez-vous à Microsoft Fabric
  2. Accédez à votre espace de travail et bibliothèque de variables
  3. En haut, sélectionnez + Nouvelle variable
  4. Indiquez un nom pour la variable, sélectionnez la référence de connexion pour le type, puis cliquez sur ... pour sélectionner une valeur.

Capture d’écran des éléments disponibles pour la référence de connexion. 5. Une fois sélectionnée, votre référence de connexion doit être prête à être utilisée.

Capture d’écran de la référence de connexion.

Si vous avez besoin de modifier une référence de connexion ou de vérifier la valeur, vous pouvez cliquer avec le bouton droit sur la valeur pour afficher une fenêtre contextuelle avec des informations sur la référence de connexion.

Capture d’écran de la fenêtre contextuelle de référence de connexion.

Fonctionnement

La valeur d’une variable de référence de connexion est un pointeur statique vers un objet de connexion identifié par son ID de connexion. La valeur est stockée sous forme de chaîne correspondant à l’ID de la connexion cible. Par exemple:

ConnectionID = aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb

Cet ID identifie de manière unique la connexion référencée. La référence statique ne s’ajuste pas automatiquement aux différents environnements de déploiement. La connexion cible doit exister au moment de la sélection et reste pointée vers cette connexion spécifique, sauf si elle a été modifiée manuellement.

Gardez à l’esprit les éléments suivants lors de l’utilisation des références de connexion :

  • Stocke un identificateur de connexion prédéfini au niveau du tenant.
  • Les références de connexion ne sont pas liées automatiquement pendant le déploiement. Leurs valeurs restent fixes dans les environnements.
  • Prend en charge CI/CD et l’automatisation en paramétrant les connexions externes pour différents environnements (développement, test, prod).
  • Active la configuration dynamique des relations externes (par exemple, le changement de sources de données ou d’informations d’identification par environnement).
  • Les valeurs sont choisies via une boîte de dialogue d’interface utilisateur, et non du texte libre, ce qui garantit que seules les connexions autorisées sont sélectionnables.
  • Seules les connexions avec au moins des autorisations de lecture sont disponibles pour la sélection.

Représentation dans Git et les API

Une référence de connexion est un type de variable avancé dont le schéma valeur stocke l’ID de connexion (et la plateforme résout/affiche les métadonnées). La charge utile inclut les éléments suivants :

  • nom : displayName de la variable de référence de connexion
  • remarque : facultatif, peut être utilisé pour la description ou d’autres notes.
  • type : « connectionReference » (type avancé)
  • value : par ensemble de valeurs, chaque valeur stocke { « connectionId » : « <chaîne GUID/ID> » }

Exemple :


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

Autorisations requises pour créer/utiliser des références de connexion

L’utilisation de variables de référence de connexion implique deux couches d’autorisations :

  • Créer et modifier une variable de référence de connexion : les utilisateurs disposant de rôles Contributeur ou supérieur dans l’espace de travail peuvent créer et modifier des variables dans la bibliothèque, tandis que les visionneuses sont en lecture seule.
  • Accès à la variable de référence de connexion : en plus des droits sur la bibliothèque de variables, vous devez disposer au moins de l’autorisation Lecture sur la variable de référence de connexion que vous envisagez de référencer.

Pour plus d’informations sur les autorisations et la validation des autorisations, consultez Autorisations de bibliothèque de variables

Éléments pris en charge

Voici une liste d’éléments qui prennent en charge les variables de référence de connexion :

Exemple de code Python

L’exemple de code suivant montre comment utiliser une référence de connexion dans un script Python.

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

Ce code effectue les opérations suivantes :

  • Résout une variable de référence de connexion à partir d’une bibliothèque de variables Fabric
  • Récupère l’objet de métadonnées de connexion
  • Extrait l’id de connexion
  • Imprime l’ID afin qu’il puisse être utilisé dans le code ou les appels d’API.

Limites

Les limitations suivantes s’appliquent aux variables de référence de connexion :

  • Les connexions intégrées dans les notebooks ne sont pas prises en charge, car la connection_id pour la connexion notebook n’est pas la même.

Contenu connexe

  • Last updated on