LOOKUPVALUE

s’applique à :colonne calculéetable calculéemesurecalcul visuel

Retourne la valeur de la ligne qui répond à tous les critères spécifiés par une ou plusieurs conditions de recherche.

Syntaxe

LOOKUPVALUE (
    <result_columnName>,
    <search_columnName>,
    <search_value>
    [, <search2_columnName>, <search2_value>]…
    [, <alternateResult>]
)

Paramètres

Terme Définition
result_columnName Nom d’une colonne existante qui contient la valeur à retourner. Il ne peut pas s’agir d’une expression.
search_columnName Nom d’une colonne existante. Il peut se trouver dans la même table que result_columnName ou dans une table associée. Il ne peut pas s’agir d’une expression. Vous pouvez spécifier plusieurs paires de search_columnName et de search_value.
search_value Valeur à rechercher dans search_columnName. Vous pouvez spécifier plusieurs paires de search_columnName et de search_value.
alternateResult (Facultatif) Valeur retournée lorsque le contexte de result_columnName est filtré jusqu’à zéro ou plusieurs valeurs distinctes. Si elle n’est pas spécifiée, la fonction retourne BLANK quand result_columnName est filtrée jusqu’à zéro valeur ou une erreur lorsque le contexte de result_columnName a plusieurs valeurs distinctes.

Valeur de retour

La valeur de result_columnName à la ligne où toutes les paires de search_columnName et search_value ont une correspondance exacte.

Si aucune correspondance ne satisfait à toutes les valeurs de recherche, la fonction retourne BLANK ou alternateResult (si spécifiée). En d’autres termes, la fonction ne retourne pas de valeur de recherche si seuls certains critères correspondent.

Si plusieurs lignes correspondent aux valeurs de recherche et aux valeurs de result_columnName ces lignes sont identiques, cette valeur est retournée. Toutefois, si result_columnName elle retourne des valeurs différentes, la fonction renvoie une erreur ou alternateResult (si elle est spécifiée).

Remarques

  • Si une relation existe entre la table qui contient la colonne de résultat et les tables qui contiennent les colonnes de recherche, dans la plupart des cas, l’utilisation de la RELATED fonction au lieu d’être LOOKUPVALUE plus efficace et offre de meilleures performances.

  • Vous pouvez spécifier plusieurs paires de search_columnName et search_value.

  • Les paramètres search_value et alternateResult sont évalués avant que la fonction effectue une itération dans les lignes de la table de recherche.

  • Lorsqu’elle est évaluée dans un contexte de ligne, LOOKUPVALUE effectue une transition de contexte, par CALCULATEexemple, en convertissant la ligne active en filtres. Dans une colonne calculée, cela peut introduire des dépendances sur d’autres colonnes de la même table, même si l’expression ne référence pas explicitement ces colonnes. Ces dépendances peuvent entraîner des erreurs de dépendance circulaire.

  • LOOKUPVALUE supprime les filtres de la table qui contient result_columnName, avec le même comportement de suppression de filtre que ALL celui appliqué à cette table. Les filtres propagés à partir d’autres tables par le biais de relations bidirectionnelles peuvent toujours affecter le résultat de recherche. L’exemple 3 montre comment supprimer les filtres de la table source lorsque ces filtres restreindraient autrement la recherche.

  • Évitez d’utiliser ISERROR ou IFERROR de capturer une erreur retournée par LOOKUPVALUE. Si certaines entrées de la fonction entraînent une erreur lorsqu’une valeur de sortie unique ne peut pas être déterminée, la fourniture d’un alternateResult paramètre est le moyen le plus fiable et le plus performant de gérer l’erreur.

  • Le paramètre alternateResult retourne une erreur si elle est spécifiée dans une colonne calculée Power Pivot.

  • Cette fonction n’est pas prise en charge pour une utilisation en mode DirectQuery lorsqu’elle est utilisée dans les colonnes calculées ou les règles de sécurité au niveau des lignes (RLS).

Les exemples de cet article peuvent être utilisés avec l’exemple de modèle Adventure Works DW 2020 Power BI Desktop. Pour obtenir le modèle, consultez DAX exemple de modèle.

Exemple 1

Dans cet exemple, LOOKUPVALUE recherche le taux moyen de la devise utilisée pour payer la commande le jour où la commande a été passée :

Exchange Rate =
LOOKUPVALUE (
    'Currency Rate'[Average Rate],
    'Currency Rate'[CurrencyKey], [CurrencyKey],
    'Currency Rate'[DateKey], [OrderDateKey]
)

Vous avez besoin de la date de commande et de la devise pour trouver le taux moyen pour la date et la devise correctes. OrderDateKey et CurrencyKey sont les clés utilisées pour rechercher le taux moyen dans la table Taux monétaire.

Vous pouvez utiliser le taux de change pour calculer le montant des ventes en devise locale avec :

Sales Amount Local Currency =
[Sales Amount] * [Exchange Rate]

Exemple 2

Dans cet exemple, la colonne calculée suivante définie dans la table Sales utilise la fonction LOOKUPVALUE pour retourner des valeurs de canal à partir de la table Sales Order.

CHANNEL =
LOOKUPVALUE (
    'Sales Order'[Channel],
    'Sales Order'[SalesOrderLineKey], [SalesOrderLineKey]
)

Toutefois, dans ce cas, étant donné qu’une relation existe entre les tables Sales Order et Sales , il est plus efficace d’utiliser la RELATED fonction.

CHANNEL =
RELATED ( 'Sales Order'[Channel] )

Exemple 3

Pour cet exemple, remplacez la direction du filtrage croisé de la relation entre Product[ProductKey] et Sales[ProductKey] par les deux. Cela permet aux filtres sur Sales de filtrer le produit.

La colonne calculée suivante dans Sales recherche le nom d’un produit de référence fixe. L’utilisation d’un produit de référence, plutôt que du produit sur la ligne de vente actuelle, montre comment les filtres bidirectionnels peuvent restreindre la recherche.

Reference Product Name =
VAR ReferenceProductKey = 528
RETURN
    LOOKUPVALUE ( 'Product'[Product], 'Product'[ProductKey], ReferenceProductKey )

La transition de contexte interne crée des filtres à partir de la ligne Sales actuelle. Ces filtres se propagent au produit via la relation bidirectionnelle. Pour une ligne de vente avec une clé de produit différente, la recherche retourne BLANK même si le produit de référence existe.

Remplacez la formule de la colonne calculée par l’expression suivante. REMOVEFILTERS efface les filtres Sales créés par la transition de contexte avant la recherche :

Reference Product Name =
VAR ReferenceProductKey = 528
RETURN
    CALCULATE (
        LOOKUPVALUE ( 'Product'[Product], 'Product'[ProductKey], ReferenceProductKey ),
        REMOVEFILTERS ( Sales )
    )

La formule révisée retourne le nom du produit de référence, quel que soit le produit sur la ligne de ventes actuelle. Restaurez la direction du filtre croisé d’origine de la relation après cet exemple.