Détails et limitations du service des fonctions de données utilisateur Fabric

Cet article détaille les détails du service et les limitations actuelles des fonctions de données utilisateur Fabric.

Rapports de capacité

L'utilisation des fonctions de données utilisateur Fabric est indiquée dans l'application Fabric Capacity Metrics. Les rapports de capacité comptent pour la création, la publication, l’exécution et le stockage des fonctions de données utilisateur Fabric. Pour en savoir plus sur les compteurs signalés dans l’application de métriques de capacité d’infrastructure, consultez Opérations Fabric.

Configuration requise pour la sécurité réseau

Pour que les fonctions de données utilisateur Fabric fonctionnent correctement, votre réseau doit autoriser les requêtes « multipart/form-data » et les chargements de fichiers sur les points de terminaison Fabric. Si cette exigence n’est pas en place, les requêtes suivantes peuvent entraîner une erreur CORS (Cross-origin Resource Sharing) : publication de fonctions et chargement de bibliothèques personnalisées.

Limites

Voici les limitations actuelles pour les fonctions de données utilisateur Fabric :

• Les fonctions sont modifiables uniquement par le propriétaire : à ce stade, seul le propriétaire de l’élément Fonctions de données utilisateur peut modifier et publier le code des fonctions. Pour obtenir des instructions sur le transfert de propriété d’éléments Fabric, consultez Prendre possession d’éléments Fabric.

• Période de refroidissement de publication des fonctions : après avoir publié vos fonctions, vous devez attendre au moins 2 minutes avant de publier à nouveau. Cette période de refroidissement s’applique lors de la publication à partir du portail Functions dans le navigateur, de l’extension User Data Functions Visual Studio Code, de l’action d’importation GIT ou à l’aide de pipelines de déploiement.

• « Gérer les connexions » prend uniquement en charge les sources de données Fabric : la fonctionnalité « Gérer les connexions » prend uniquement en charge la connexion à des sources de données natives Fabric pour l’instant. Pour plus d’informations, consultez Se connecter aux sources de données.

• « Gérer les connexions » ne peut pas se connecter aux ressources qui ont des caractères spéciaux dans leurs noms : les ressources fabric, telles que les bases de données, qui ont des caractères spéciaux dans leurs noms, tels que des accolades ou des caractères non ASCII, ne sont pas compatibles avec l’expérience Gérer les connexions dans les fonctions de données utilisateur. Pour plus d’informations, consultez Se connecter aux sources de données.

• Limitations régionales pour les fonctions de données utilisateur : les fonctions de données utilisateur ne sont pas disponibles dans un sous-ensemble de régions Fabric. Pour obtenir la liste mise à jour des régions où les fonctions de données utilisateur Fabric sont disponibles, consultez disponibilité de la région Fabric. Si votre locataire domestique se trouve dans une région non prise en charge, vous pouvez créer une capacité dans une région prise en charge pour utiliser les fonctions de données utilisateur. Pour plus d'informations, voir Gérer la capacité de votre Fabric.

• Limitations régionales pour la fonctionnalité Test en mode Développement : la fonctionnalité de test en mode Développement n’est pas disponible dans les régions Fabric suivantes : Brésil Sud, Israël Centre et Mexique Centre. Vous pouvez toujours tester vos fonctions en les publiant et en les exécutant, ou à l’aide de l’extension VS Code pour les tester localement.

• Mots clés Python réservés dans Fabric User Data Functions : en plus des mots clés réservés du langage Python, Fabric User Data Functions utilise également les mots clés suivants : req, contextet reqInvocationId. Les mots clés réservés ne peuvent pas être utilisés comme noms de paramètres ou noms de fonction.

• Les paramètres avec des valeurs par défaut ou des valeurs facultatives ne sont pas pris en charge : à ce stade, tous les paramètres de fonction sont requis lors de l’appel. De même, la fourniture de valeurs par défaut dans la définition d’argument de fonction n’est actuellement pas prise en charge. Par exemple, la fonction ci-dessous lève une erreur de syntaxe :

      # The default value for the argument called 'name' is not supported and treated like a syntax error.
      @udf.function()
      def goodbye_fabric(name: str = "N/A") -> str:
          return f"Goodbye, {name}."
  

• Prise en charge du principal de service : l’accès aux éléments ou sources de données Fabric à l’aide d’un principal de service n’est actuellement pas pris en charge. Par exemple, vous ne pouvez pas utiliser Fabric User Data Functions comme identité managée ou identité d’espace de travail.

Limites du service

La liste suivante détaille les limites de service pour les éléments User Data Functions.

Étapes suivantes

• Créer un élément Fonctions de données utilisateur à partir du portail Fabric ou à l’aide de l’extension VS Code.
• En savoir plus sur le modèle de programmation des fonctions de données utilisateur