FAQ sur les applications Fabric

Cet article répond aux questions courantes sur Fabric Apps.

General

Qu’est-ce que Fabric Apps ?

Fabric Apps est une plateforme back-end qui permet aux développeurs TypeScript de créer et de déployer des applications pilotées par les données plus rapidement. Vous définissez des modèles de données à l’aide de décorateurs TypeScript et Fabric Apps génère automatiquement des API GraphQL, des schémas de base de données et des clients de type sécurisé.

Qui doit utiliser Fabric Apps ?

Fabric Apps est idéal pour les développeurs qui créent :

  • Outils internes et tableaux de bord
  • Applications d’exploration et de visualisation des données
  • Prototypes rapides
  • Applications IA et agent qui ont besoin d’un état persistant

Quelles bases de données sont prises en charge ?

Fabric Apps prend en charge SQL Server : valeur par défaut pour les déploiements de Fabric.

Puis-je utiliser Fabric Apps avec des bases de données existantes ?

Non. Fabric Apps gère le schéma de base de données en fonction de vos modèles de données TypeScript. Vous ne pouvez pas le pointer vers une base de données existante avec un schéma prédéfini.

Development

Comment installer l’interface CLI ?

Vous pouvez installer Rayfin CLI avec npm. Étant donné qu’il s’agit d’un package npm que vous pouvez mettre à jour avec npm update.

npm i @microsoft/rayfin-cli

Puis-je utiliser des applications Fabric sans TypeScript ?

Non. Les modèles de données doivent être définis à l’aide de décorateurs TypeScript. L’application frontale peut utiliser JavaScript, mais le back-end nécessite TypeScript pour les définitions de modèle.

Quelles infrastructures frontend sont prises en charge ?

Fabric Apps fonctionne avec n’importe quelle infrastructure frontale qui peut effectuer des requêtes HTTP :

  • React
  • Vue
  • Angular
  • Svelte
  • Vanille JavaScript/TypeScript

Le Kit de développement logiciel (SDK) client fournit des API de type sécurisé pour toutes les infrastructures.

Authentication

Quelles méthodes d’authentification sont prises en charge ?

Environnement Méthodes prises en charge
Développement local Microsoft Entra authentification unique et e-mail/mot de passe
Déployé sur Fabric Microsoft Entra authentification unique uniquement

Note

L'authentification par e-mail et mot de passe ne fonctionne pas après le déploiement sur Fabric. Vous ne pouvez pas déployer une application sur Fabric, sauf si l'authentification est activée.

Puis-je utiliser des fournisseurs d’authentification personnalisés ?

Non. Fabric Apps prend en charge uniquement Microsoft Entra avec authentification unique (SSO) ainsi que l’adresse e-mail et le mot de passe. Vous ne pouvez pas intégrer d’autres fournisseurs.

Deployment

Puis-je déployer une application sans authentification activée ?

Non. Fabric nécessite que l’authentification fabric soit activée avant de déployer une application Fabric.

Puis-je déployer sur plusieurs environnements (développement, préproduction, production) ?

Vous pouvez gérer manuellement des espaces de travail de Fabric distincts et les déployer sur différents éléments.

Combien de temps le déploiement prend-il ?

Le déploiement initial prend généralement 2 à 5 minutes. Les déploiements suivants avec npx rayfin up staticapp deploy (contenu statique uniquement) prennent 30 à 60 secondes.

Puis-je annuler un déploiement ?

Redéployez la version précédente en revenant au commit Git précédent, puis exécutez npx rayfin up.

Comment résoudre les échecs de déploiement ?

  • Erreurs de génération : exécuter npm run build avant le déploiement. La cause d’échec de déploiement la plus fréquente est l’absence d’une version de production. Une fois la build réussie, exécutez npx rayfin up.
  • Erreurs de capacité ou d’autorisation — Vérifiez que votre espace de travail dispose d’une capacité Fabric attribuée et que vous disposez des autorisations nécessaires pour créer ou modifier des éléments dans l’espace de travail.
  • Erreurs de schéma de base de données : si l’erreur se produit lors de l’application du schéma de base de données, passez en revue les modifications apportées au schéma depuis le dernier déploiement réussi et résolvez les conflits.

Modèles de données

Puis-je utiliser des clés primaires composites ?

Non. Chaque entité doit utiliser un seul champ UUID nommé id comme clé primaire.

Les relations plusieurs-à-plusieurs sont-elles prises en charge ?

Non. Utilisez plutôt une entité de jointure définie explicitement avec deux décorateurs de navigation @one().

Puis-je écrire des requêtes SQL personnalisées ?

Aucune prise en charge de requête SQL directe n’existe. Tous les accès aux données passent par les API GraphQL générées.

Performance et mise à l’échelle

Quelles sont les limites de performances ?

Les performances dépendent de votre capacité Fabric. Contactez votre administrateur Fabric pour connaître les limites spécifiques à la capacité.

Puis-je mettre en cache les résultats de la requête ?

Yes. Implémentez la mise en cache côté client dans votre application frontale. Le back-end ne fournit pas de mise en cache intégrée.

Comment optimiser les performances des requêtes ?

  • Sélectionnez uniquement les champs dont vous avez besoin
  • Utiliser la pagination pour les jeux de résultats volumineux
  • Inclure des champs d’entité associés dans une requête unique plutôt que d’effectuer plusieurs requêtes

Sécurité

Comment les données sont-elles sécurisées ?

  • L’authentification est requise par défaut (configurable par entité)
  • Les politiques de sécurité au niveau des lignes filtrent les données en fonction des claims JWT
  • Toutes les communications utilisent HTTPS dans les déploiements Fabric

Limitations

Quelles sont les limitations actuelles ?

  • count() n’est pas disponible sur le client Fluent GraphQL
  • Les relations plusieurs-à-plusieurs ne sont pas prises en charge
  • Les clés primaires composites ne sont pas prises en charge
  • Les fournisseurs d’authentification personnalisés ne sont pas pris en charge
  • La gestion de plusieurs environnements n’est pas prise en charge par défaut

Consultez Troubleshoot Fabric Apps pour obtenir des solutions de contournement.

Puis-je exporter mes données ?

Yes. Vous pouvez également vous connecter directement à la base de données SQL si vous disposez de la chaîne de connexion.

Contenu connexe

  • Last updated on