Référence : exportDataPerformance
Pour bénéficier des optimisations de performance et d’explicabilité de exportData, vos demandes doivent utiliser des versions d’API, des attributs et des éléments particuliers.
Les améliorations de la performance touchent les appels d’API autonomes exportData et les fonctionnalités qui font appel à exportData :
- Publiez des plans.
- Récupération des données de compte à partir de la source de données Adaptive Planning dans Design Integrations.
L’API v38 inclut un nouveau format de demande et de réponse, selon la présence de
stream="true"
ou stream="false"
dans la section call
élément.Comptes pris en charge
Les améliorations de la performance et de l’extensibilité de exportData prennent en charge :
Tous les types de comptes,
sauf
:
- Compte système (inclut l’affectation, le pourcentage de participation minoritaire, l’élimination, le montant cumulé des ajustements de conversion).
- Compte d’hypothèse de feuille modèle.
Toutes les fonctionnalités de modélisation,
à l’exception des suivantes
:
- Conversion par moyenne pondérée.
- Agrégat de texte.
- Tables de répartition.
- Les tables de recherche de valeurs.
Utilisation d'applications
- Publiez des plans.
- Récupération des données de compte à partir de la source de données Adaptive Planning dans Design Integrations.
- Inclut l’optimisation de la performance de l’API ExportData, à l’exception des données cubes avec une strate de temps.
- N’inclut pas la limite supérieure de rangées d’exportation du flux.
Performance et comportement de exportData
L’API exportData se comporte différemment en fonction des configurations suivantes :
API v36
La demande inclut des types de comptes ou des propriétés non pris en charge | stream attribut | Format de réponse | Limite de rangées d'exportation | Optimisations de la performance |
|---|---|---|---|---|
Non | Non disponible | Aucun changement | 500 K | Oui |
Oui | Non disponible | Aucun changement | 500 K | Non |
API v38
La demande inclut des types de comptes ou des propriétés non pris en charge | stream attribut | Format de réponse | Limite de rangées d'exportation | Optimisations de la performance |
|---|---|---|---|---|
Non | Absent ou false
| Sans flux | 500 K | Oui |
Non | true
| Diffusion en continu | 2 millions | Oui |
API v39
La demande inclut des types de comptes ou des propriétés non pris en charge | stream attribut | Format de réponse | Limite de rangées d'exportation | Optimisations de la performance |
|---|---|---|---|---|
Non | Absent ou false
| Sans flux | 500 K | Oui |
Non | true
| Diffusion en continu | 2 millions | Oui |
Oui | true
| Sans flux | 500 K | Non |
Oui | false
| Sans flux | 500 K | Non |
Mises à jour de l'API exportData v36 et au-delà
Le tableau ci-dessous répertorie les améliorations pour le chemin d’optimisation de la performance introduit en 2024R1 pour l’API de sortie de données v36 et au-delà, dans le cadre de la fonction d’optimisation de la performance de l’API de sortie.
API exportData | Comportement non optimisé | Comportement optimisé |
|---|---|---|
L'utilisateur n'a pas accès à TOUTES les combinaisons de comptes et de niveaux pour une dimension dans la règle DAC et cette dimension n'est pas incluse dans la demande de l'API exportData. | La réponse ne renvoie pas les données du compte dans la feuille cube ou la feuille modèle qui :
| La réponse renvoie des rangées avec la valeur sans catégorie pour la dimension. |
Demande d’API avec une dimension incluse aux deux endroits suivants :
| La réponse ne renvoie aucune rangée pour les enfants directs de la dimension ou de la dimension. | La réponse renvoie des rangées pour la valeur d’agrégat des enfants directs et une rangée pour la valeur sans catégorie de la dimension. |
Demande d’API sur un compte cube avec une dimension précisée aux deux endroits :
| La réponse ne renvoie aucune rangée pour les enfants directs de la dimension ou de la dimension. | La réponse renvoie des rangées pour l’agrégat de dimensions ou l’agrégat d’enfants directs, ainsi que la valeur sans catégorie de la dimension en fonction des valeurs spécifiées pour l’agrégat directChildren et le uncategorized attributs dans <dimensionValue> élément. |
Demande d'API le directChildren d’une valeur de dimension de niveau pour un compte dans une feuille cube qui n’inclut pas la dimension de niveau. | La réponse ne renvoie pas de rangées pour le niveau fourni aux valeurs d'agrégat des enfants directs de la valeur de la dimension de niveau. | La réponse renvoie les rangées du niveau fourni aux valeurs d'agrégat des enfants directs de la valeur de la dimension Niveau. |