Partager via

Téléchargez le manifeste

  • Article

Vue d’ensemble

Les fichiers WorkloadManifest.xml et Item.xml sont requis pour la définition de la charge de travail dans Fabric. Ils contiennent les paramètres de configuration des éléments de charge de travail de base et de charge de travail pour l’installation et servent de guide pour la configuration et la gestion de la charge de travail, ce qui permet de définir, partager et enregistrer les détails essentiels de la charge de travail pour une intégration fluide dans Fabric.

Dans notre exemple de référentiel, un fichier .nupkg est généré à partir des fichiers XML situés dans le dossier src/Packages/manifest pendant le processus de build. Ce fichier empaqueté contient toutes les informations nécessaires sur votre charge de travail. Dans le fichier workload-dev-mode.json, un champ appelé ManifestPackageFilePath doit pointer vers ce fichier .nupkg nouvellement créé.

Processus de chargement et d’inscription

  1. Authentification de l’utilisateur : lors du développement, une fois l’exemple exécuté, votre authentification lance le processus de chargement et d’inscription. Cela garantit l’association correcte de la charge de travail avec votre identité.
  2. Analyse du manifeste : le manifeste chargé subit l’analyse pour valider sa structure et son contenu. Cette étape garantit que le manifeste est correctement mis en forme et prêt pour un traitement ultérieur.
  3. Inscription de la charge de travail : si l’analyse réussit, la charge de travail est inscrite dans Fabric. Les détails de configuration essentiels, tels que l’ID de charge de travail, sont stockés dans la base de données Fabric, ce qui permet une gestion efficace des charges de travail.

Manifeste de charge de travail – Principaux composants du manifeste

Le manifeste, dont la structure est définie par WorkloadDefinition.xsd, décrit les attributs principaux d’une charge de travail, comme le nom, l’application et les points de terminaison.

SchemaVersion, attribut

Représente la version publiée de WorkloadDefinition.xsd de Fabric.

Attribut WorkloadName

Identificateur unique de votre charge de travail. Notez qu’il est nécessaire d’avoir un « Org ». préfixe pour workloadName de sorte que le nom se compose de deux mots avec le séparateur « . », par exemple « Org.MyWorkload ». D’autres préfixes ne sont pas valides et entraînent un échec du chargement. Cela sera appliqué dans les scénarios suivants : connexion de développement, chargement de test.

Version, élément

La version de votre manifeste doit être conforme à SemVer.

Élément CloudServiceConfiguration

La configuration du service de votre charge de travail, actuellement, une seule configuration est prise en charge.

Configuration de l’application Microsoft Entra ID [Azure Active Directory (AAD)]

La section <AADApp> configure l’application Microsoft Entra ID [Azure Active Directory (AAD)] pour les processus d’authentification et d’autorisation. Le AppId représente l’identificateur unique de votre application, le RedirectUri spécifie l’URI auquel Microsoft Entra ID envoie la réponse d’authentification et le ResourceId pointe vers l’identificateur unique de la ressource à laquelle l’application accède. Pour plus de contexte sur ce que ResourceId, AppId et RedirectUri représentent, vous pouvez consulter la documentation d’authentification.

<AADApp>
    <AppId>YourApplicationId</AppId>
    <RedirectUri>YourRedirectUri</RedirectUri>
    <ResourceId>YourResourceId</ResourceId>
</AADApp>

Consultez la documentation d’authentification pour mieux comprendre AppId, ResourceIdet RedirectUri leur importance dans le contexte des processus d’authentification.

Éléments ServiceEndpoint

Représente la configuration d’un point de terminaison logique spécifique, par exemple le point de terminaison principal qui inclut l’implémentation des API CRUD et de travaux des éléments.

  • La configuration du point de terminaison back-end de la charge de travail indique l’URL principale de votre charge de travail.
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>
  • <IsEndpointResolutionService> et EndpointResolutionContext sont définis selon que votre point de terminaison implémente l’API de charge de travail ou uniquement la résolution de point de terminaison. Consultez Résolution du point de terminaison pour obtenir des informations détaillées sur le contexte de résolution et la réponse.

Remarque

La résolution de point de terminaison front-end n’est pas prise en charge.

Manifeste d’élément – Principaux composants du manifeste

Le manifeste, dont la structure est définie par ItemDefinition.xsd, décrit les attributs principaux d’un élément de charge de travail, comme le nom et les définitions de travail.

SchemaVersion, attribut

Représente la version publiée de ItemDefinition.xsd de Fabric.

Attribut TypeName

Identificateur unique de votre élément.

Configuration du Job Scheduler

La section <JobScheduler> englobe différents éléments qui définissent le comportement et les paramètres de du planificateur, du suivi et de la gestion des travaux.

  • <OnDemandJobDeduplicateOptions> et <ScheduledJobDeduplicateOptions> : définissez les options de déduplication pour les projets d’éléments à la demande et planifiés, respectivement. Les options incluent None (aucune déduplication), PerItem (une exécution du travail pour le même élément et le même type de travail) et PerUser (une exécution du travail pour le même utilisateur et le même élément).
  • <ItemJobTypes> : contient des configurations pour différents types de travaux d’élément.
  • <ItemJobType> : décrit un type de travail spécifique.
  • <Name> : Le nom du type de projet. Doit utiliser le nom de l’élément comme préfixe.

Prenons notre exemple de charge de travail, qui inclut trois travaux spécifiques définis dans la section <ItemJobTypes> :

<JobScheduler>
    <OnDemandJobDeduplicateOptions>PerItem</OnDemandJobDeduplicateOptions>
    <ScheduledJobDeduplicateOptions>PerItem</ScheduledJobDeduplicateOptions>
    <ItemJobTypes>
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.ScheduledJob" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsText" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsParquet" />
    </ItemJobTypes>
</JobScheduler>
  • Travail CalculateAsText : ce type de travail gère les calculs textuels, en prenant Operand1 et Operand2, en exécutant l’opération sélectionnée et en enregistrant le résultat dans le Lakehouse.
  • Travail CalculateAsParquet : spécifiquement adapté à l’utilisation des données Parquet, ce type de travail prend également Operand1 et Operand2, effectue l’opération sélectionnée et stocke le résultat dans le Lakehouse, en suivant le format de données Parquet. Consultez le guide du hub de surveillance pour plus d’informations sur les travaux et la configuration associée.

En résumé, les manifestes de charge de travail et d’élément servent de documents fondamentaux pour l’ajout de charges de travail personnalisées à Fabric. Le processus d’authentification déclenche une séquence simple d’actions : chargement, analyse et inscription, garantissant une configuration appropriée et une gestion efficace des charges de travail au sein de l’écosystème Azure.