Limitations connues et résolution des problèmes concernant les tables virtuelles

Cet article décrit les limitations connues et les conseils de résolution des problèmes lors de l’utilisation de tables virtuelles dans Microsoft Dataverse.

Limitations connues

Voici une liste des limitations connues pour les tables virtuelles créées à l’aide du fournisseur de connecteur virtuel.

Généralités

• La table ou la liste utilisée doit inclure au moins un champ de chaîne à utiliser comme champ principal et un champ GUID. Sans ces champs de chaîne, la table virtuelle ne peut pas être créée et une erreur sera générée lors de l’étape de récupération des détails de la table.
  • SharePoint utilise le champ ID numérique masqué présent dans toutes les listes
  • SQL peut utiliser un GUID ou un champ entier
  • Excel doit avoir un champ GUID
• Dataverse ne peut créer que des colonnes qui incluent des types de données compatibles avec Dataverse. Il s’agit notamment des types de données suivants :
  • String
  • Texte multiligne (mémo)
  • Nombre entier/Entier
  • Decimal
  • Float
  • Date/Heure
  • Oui/Non (booléen)
  • Choix (sélection multiple)
  • Lien hypertexte/URL
• Types de données non pris en charge pour les tables virtuelles :
  • Fichiers et fichiers joints
  • Image
  • Lookup
• La longueur maximale de caractères autorisée pour une colonne de texte dans une table virtuelle est de 4000 caractères. Si la table source a une limite maximale de caractères supérieure à cette valeur, toute opération de création/mise à jour dépassant la limite maximale de caractères entraîne une erreur de validation et l’opération échoue.
• Les requêtes de table virtuelle sont limitées pour renvoyer 1,000 enregistrements. Si vous avez une relation multi-tables personnalisée (polymorphique) 1:N ou N avec une table virtuelle, toute requête dépassant cette limite échoue et génère une erreur. Utilisez le filtrage dans votre requête pour réduire le jeu d’enregistrements comme solution de contournement à cette limitation.
• La fonctionnalité d’audit n’est pas disponible pour les tables virtuelles, car Dataverse peut uniquement effectuer et stocker des données d’audit pour les données stockées localement.
• Les cumuls et les champs calculés ne peuvent pas être calculés pour les tables virtuelles. En effet, les cumuls sont un calcul côté serveur dans Dataverse, ce qui nécessite que les données soient stockées localement.
• La table virtuelle Microsoft Entra ID fournie par Microsoft n’autorise qu’un accès en lecture.
• Les tables virtuelles Dataverse peuvent afficher des valeurs dans des champs qui dépassent les valeurs maximales normales de Dataverse. Ce comportement est dû au fait que les valeurs présentées ne sont pas stockées localement. Par exemple, la valeur entière maximale Dataverse est 100 000 000 000, mais elle pourrait récupérer et afficher 9 000 000 000 000 à partir de SharePoint. Cependant, si l’utilisateur tente de modifier le nombre à une taille supérieure à la taille maximale acceptée dans Dataverse, une erreur est générée en indiquant que l’enregistrement ne peut pas être sauvegardé car il dépasse la taille maximale.
• La fonctionnalité d’importation et d’exportation des données de table n’est pas prise en charge pour les tables virtuelles.

Pour chaque source de données

Voici les limitations pour chaque source de données.

SQL Server

• Les tables virtuelles SQL peuvent utiliser un GUID ou un champ entier pour la clé primaire de la fonctionnalité.
• Tables SQL Server sans clés primaires : n’importe quel champ non-chaîne peut être sélectionné comme clé primaire. La création de la table virtuelle doit réussir. RetrieveMultiple fonctionne, les autres opérations échouent avec le message d’erreur suivant (provenant du connecteur SQL) : « La requête APIM n’a pas réussi : BadRequest : Aucune clé primaire n’existe dans la table ». Pour la fonctionnalité, un GUID ou un champ entier doit être utilisé comme clé primaire.
• Tables SQL Server utilisant une clé primaire de chaîne : la clé primaire de chaîne SQL est la seule option disponible pour la clé primaire de la table virtuelle. Les clés primaires de chaîne SQL Server sont prises en charge uniquement si les valeurs peuvent être analysées en tant que GUID. Si elles ne peuvent pas être analysées en tant que GUID, la création de la table virtuelle réussit, mais échoue au moment de l’exécution avec les erreurs suivantes :
  • Maker Portal : « Nous n’avons pas pu ouvrir votre table. Essayez de recharger ou d’ouvrir à nouveau. »
  • Suivi du réseau : « Les clés primaires de chaîne ne sont prises en charge que si elles peuvent être analysées en tant que GUID. »
• Les tables SQL Server sans champ de chaîne de clé non primaire à utiliser comme nom principal : si la table SQL n’a pas de champ de chaîne disponible à utiliser comme nom principal, nous affichons l’erreur suivante à l’étape de configuration : « La table ne comprend pas de champ principal ».
• Les vues SQL peuvent être utilisées pour créer une table virtuelle, mais elles ne fourniront que des opérations de lecture.
• Pour consulter les limitations du connecteur SQL Server, voir Référence du connecteur SQL Server.
• Les colonnes bigint de type de données SQL dans la table source sont mappées en tant que type de données décimales dans les tables virtuelles Dataverse. Lorsque la prise en charge de la plateforme est disponible pour le mappage bigint à un nombre entier, les colonnes précédemment créées dans la table virtuelle doivent être supprimées et de nouvelles colonnes doivent être créées.
• Pour le moment, les types de colonne suivants ne peuvent pas être inclus dans une table virtuelle :
  • Heure
  • Datetime2
  • Image
  • Géométrie
  • Pays
  • RowVersion
• Les types de colonnes suivants sont inclus dans une table virtuelle mais sont uniquement affichés sous forme de champs de texte :
  • HierarchyID
  • XML
  • Sqlvariant

Microsoft Excel Online (Business)

• Excel n’est actuellement pas pris en charge dans l’expérience de table virtuelle pilotée par table
• Les fichiers Excel doivent être stockés sur un OneDrive pour participer à une connexion de table virtuelle.
• La colonne Clé primaire doit être incluse dans le formulaire de création si vous n’avez pas configuré la colonne pour qu’elle s’incrémente automatiquement lors de la conception de la table source sous-jacente. Vous devez entrer une valeur valide dans la colonne de clé primaire pour qu’une opération d’insertion réussisse.
• Si la création du catalogue d’entités prend beaucoup de temps, vous pouvez vérifier l’état d’achèvement de la tâche en accédant à la vue Paramètres -> Paramètres avancés -> Paramètres -> Tâches système.
• La clé primaire ne peut être qu’une colonne contenant des valeurs GUID : étant donné que les métadonnées du tableau Excel affichent toutes les colonnes sous forme de chaîne, notre conception actuelle suppose que la clé primaire sera toujours un GUID représenté sous forme de chaîne.

  Notes

  Aucune validation n’est effectuée lors de la création de l’entité virtuelle, si une colonne non GUID est sélectionnée, l’entité échouera à l’exécution avec cette erreur : "Les clés primaires de chaîne ne sont prises en charge que si elles peuvent être analysées en tant que GUID".

• Prise en charge de la colonne générée automatiquement PowerAppsId__ : la colonne générée automatiquement PowerAppsId sera utilisée si elle est trouvée (ce sera la seule option disponible pour la clé primaire). Il est nécessaire de fournir une valeur pour PowerAppsId lors de la création de l’enregistrement, même si la valeur sera en fait remplacée par une valeur générée automatiquement. Cela ne se produit pas si la colonne de clé primaire n’est pas la colonne générée automatiquement PowerAppsId.
• Pour le moment, les types de colonne suivants ne peuvent pas être inclus dans une table virtuelle :
  • Heure (ceux-ci seront créés en tant que champs Date/Heure.
• Limitations spécifiques du connecteur Excel : Référence du connecteur Excel Online (Business).

Microsoft SharePoint

• Vous ne pouvez actuellement pas sélectionner une vue Tout pour les colonnes SharePoint sur une table virtuelle. Ce problème est connu.
• Pour le moment, les types de colonne suivants ne peuvent pas être inclus dans une table virtuelle :
  • Personne
  • Image
  • Métadonnées gérées
  • Emplacement : coordonnées
  • Attachment
• Colonnes spécifiques SharePoint qui seront affichées dans la table virtuelle :
  • ID de la ressource de conformité est une colonne interne de SharePoint à des fins de suivi. Il peut être ignoré.
  • ID est la clé primaire externe de SharePoint. Il est en lecture seule et peut être ignoré.

Salesforce (version préliminaire)

• Pour connaître les limitations du connecteur Salesforce, accédez à la référence du connecteur Salesforce.
• Les champs qui font référence à d’autres objets Salesforce sont verrouillés.

Résolution des problèmes

• Il n’y a qu’un (1) enregistrement dans votre table virtuelle, même si vous en avez davantage dans votre table source.
  Solution : vérifiez votre table source et assurez-vous qu’elle a une clé primaire définie.

• J’obtiens l’une des erreurs suivantes lorsque Power Apps (make.powerapps.com) récupère ma liste de tables ou lorsque je sélectionner Terminer pour créer ma table :

  • « Ressource introuvable pour le segment msdyn_get_required_fields »
  • « Erreur d’appel... veuillez vérifier que la connexion... existe dans l’environnement »
  • « La séquence ne correspond à aucun élément pour msdyn_get_required_fields »
    Solution : dans certains cas, vous ne disposez peut-être pas de la solution la plus récente pour le fournisseur de connecteurs virtuels. Pour déterminer si votre solution de fournisseur de connecteurs virtuels a besoin d’une mise à jour :
  1. Sélectionnez Solutions dans le volet de navigation de gauche. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.
  2. Cliquez sur l’onglet Historique.
  3. Recherchez ConnectorProvider.
  4. Affichez les informations pour voir si la solution doit être mise à jour.
  5. Si l’historique indique qu’une mise à jour est nécessaire, accédez au Marketplace commercial Microsoft, recherchez Fournisseur de connecteurs virtuels, puis sélectionnez Se le procurer maintenant pour importer la solution dans votre environnement.
  6. Suivez les étapes pour créer à nouveau la table virtuelle.

• Un message affiche « Connexion "xyz" introuvable dans l’environnement actuel. » à la récupération de la liste des connexions.
  Solution : cela se produit lorsqu’il existe un grand nombre de connexions dans l’environnement Dataverse de l’utilisateur. La version 1029 de la solution du fournisseur de connecteurs corrige ce problème. La version mise à jour devrait être disponible dans toutes les régions d’ici le 20 février 2023. Pour déterminer si votre solution de fournisseur de connecteurs virtuels a besoin d’une mise à jour :

  1. Sélectionnez Solutions dans le volet de navigation de gauche. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.
  2. Cliquez sur l’onglet Historique.
  3. Recherchez ConnectorProvider.
  4. Affichez les informations pour voir si la solution doit être mise à jour.
  5. Si l’historique indique qu’une mise à jour est nécessaire, accédez au Marketplace commercial Microsoft, recherchez Fournisseur de connecteurs virtuels, puis sélectionnez Se le procurer maintenant pour importer la solution dans votre environnement.
  6. Suivez les étapes pour créer à nouveau la table virtuelle.

• Je reçois une notification indiquant qu’un délai d’attente s’est produit à la création de la table virtuelle.
  Solution : cela peut se produire lorsque d’autres tâches existantes retardent la création de la table virtuelle. Patientez quelques minutes et réessayez.

• Je reçois la notification « Une erreur inattendue s’est produite »
  Solution : cela se produit lorsque la source de données de la table virtuelle a été créée avec des valeurs non valides. Pour résoudre ce problème, vous devrez localiser la source de données de table virtuelle à l’origine de l’erreur, la supprimer, puis créer à nouveau la table virtuelle.

  1. Sélectionnez Paramètres utilisateur (icône d’engrenage) > Paramètres avancés de Power Apps.
  2. Dans le menu supérieur, sélectionnez Paramètres.
  3. Accédez à Solutions. Si l’élément ne se trouve pas dans le volet latéral, sélectionnez …Plus, puis sélectionnez l’élément souhaité.
  4. Accédez à la solution qui inclut votre table virtuelle (si vous n’utilisiez pas de solution, accédez à Solution par défaut Common Data Services).
  5. Dans le panneau de gauche, sélectionnez Sources de données de table virtuelle.
  6. Double-cliquez sur chaque source de données (ils commencent tous par VCP_DS_..."), quand vous localisez celui qui comporte l’erreur, supprimez cette source de données.
  7. Créez à nouveau votre table virtuelle.

• Un message affiche « Cette table existe déjà, vous créez à nouveau la table. Le champ principal et le nom du schéma ne peuvent pas être modifiés. »
  Solution : cette table a déjà été créée. Si vous poursuivez la création, la table sera recréé, ce qui entraînera la mise à jour de toutes les modifications de table apportées à la source de données dans la table virtuelle (cela inclut l’ajout ou la suppression de champs). Les valeurs du nom personnalisé et du champ principal ne seront pas modifiables.

• Message d’erreur : « primary_key_name ne peut pas être vide »
  Solution : vous avez choisi une table ou une liste qui ne comprend pas de valeur GUID pour la clé primaire. Vous devrez ajouter une colonne GUID supplémentaire dans votre table source afin de créer une table virtuelle.

• J’ai créé une table virtuelle Excel, mais je ne la vois pas dans « Tables ».
  Solution : la création de la table virtuelle étant asynchrone, vous pouvez vérifier l’état du processus dans Tâches système. Recherchez les travaux système avec un nom commençant par Microsoft.Wrm.DataProvider.Connector.Plugins.ConnectorGenerateVEPlugin et une valeur de colonne Concernant égale au nom de la nouvelle table virtuelle. Si le statut est toujours En cours, attendez simplement que le travail soit terminé. En cas d’erreur, vous pouvez obtenir des détails en cliquant sur le lien hypertexte système, nom du travail. Dans cet exemple, la création de la table est toujours en attente :

  

  Ici, la création de la table a échoué en raison de l’erreur 429 « Too Many Requests » :

  

• La tâche système de création de table a réussi, mais j’obtiens des erreurs d’exécution liées à des colonnes non valides ou manquantes
  Solution : Si un échec se produit lors de la création d’un champ de table, le processus de création de table n’échouera pas et tentera de continuer avec les champs restants. En effet, nous ne voulons pas bloquer la création de la table virtuelle lorsque certains types de colonnes ne sont pas pris en charge. Pour obtenir des détails sur l’erreur, vous pouvez activer la connexion Administration> Paramètres système > Personnalisations > Activer la journalisation dans le journal de suivi du plug-in, puis supprimez la table virtuelle et essayez de la recréer.

Étapes suivantes

Créer des tables virtuelles à l’aide du fournisseur de connecteurs virtuels (version préliminaire)

Configuration d’une relation de table virtuelle