Skip to main content
Version: v20 R2 BETA

Obtenir des informations du serveur

Vous pouvez obtenir plusieurs informations du serveur REST :

  • les datastores exposées et leurs attributs
  • le contenu du cache du serveur REST, y compris les sessions utilisateur.

Catalogue​

Utilisez les paramètres $catalog,$catalog/{dataClass}, ou $catalog/$all pour obtenir la liste des dataclasses exposées et leurs attributs.

Pour obtenir la collection de toutes les dataclass exposées avec leurs attributs :

GET /rest/$catalog/$all

Informations sur le cache​

Utilisez le paramètre $info pour obtenir des informations sur les sélections d'entités stockées dans le cache du 4D Server et sur l'exécution des sessions utilisateur.

queryPath et queryPlan​

Les sélections d'entité générées par les requêtes peuvent avoir les deux propriétés suivantes : queryPlan et queryPath. Pour calculer et retourner ces propriétés, il vous suffit d'ajouter $queryPlan et/ou $queryPath dans la demande REST.

Par exemple :

GET /rest/People/$filter="employer.name=acme AND lastName=Jones"&$queryplan=true&$querypath=true

Ces propriétés sont des objets contenant des informations sur la façon dont le serveur exécute les requêtes composites en interne via des dataclass et des relations :

  • queryPlan : objet contenant la description détaillée de la requête juste avant son exécution (c'est-à-dire la requête planifiée).
  • queryPath : objet contenant la description détaillée de la requête telle qu'elle a été réellement effectuée.

Les informations enregistrées incluent le type de requête (indexé et séquentiel) et chaque sous-requête nécessaire ainsi que les opérateurs de conjonction. Query paths also contain the number of entities found and the time required to execute each search criterion. Query paths also contain the number of entities found and the time required to execute each search criterion. Generally, the description of the query plan and its path are identical but they can differ because 4D can implement dynamic optimizations when a query is executed in order to improve performance. For example, the 4D engine can dynamically convert an indexed query into a sequential one if it estimates that it is faster. This particular case can occur when the number of entities being searched for is low.