LOOKUPVALUELOOKUPVALUE

Diese Funktion gibt den Wert für die Zeile zurück, die alle durch mindestens eine Suchbedingung angegebenen Kriterien erfüllt.Returns the value for the row that meets all criteria specified by one or more search conditions.

SyntaxSyntax

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

ParameterParameters

BegriffTerm DefinitionDefinition
result_columnNameresult_columnName Der Name einer vorhandenen Spalte, die den Wert enthält, den Sie zurückgeben möchten.The name of an existing column that contains the value you want to return. Es darf kein Ausdruck sein.It cannot be an expression.
search_columnNamesearch_columnName Hierbei handelt es sich um den Namen einer vorhandenen Spalte.The name of an existing column. Diese kann sich in derselben Tabelle befinden wie „Ergebnis_Spaltenname“ oder in einer verknüpften Tabelle.It can be in the same table as result_columnName or in a related table. Es darf kein Ausdruck sein.It cannot be an expression.
search_valuesearch_value Dies ist der Wert, nach dem in search_columnName gesucht werden soll.The value to search for in search_columnName.
alternateResultalternateResult Der Wert wird zurückgegeben, wenn der Kontext für result_columnName auf 0 (Null) oder mehr als einen bestimmten Wert gefiltert wurde (optional).(Optional) The value returned when the context for result_columnName has been filtered down to zero or more than one distinct value. Wenn dieser Wert nicht angegeben ist, gibt die Funktion einen leeren Wert zurück, wenn „Ergebnis_Spaltenname“ auf den Wert 0 (Null) gefiltert wird. Ein Fehler wird zurückgegeben, wenn mehr als ein eindeutiger Wert vorliegt.When not provided, the function returns BLANK when result_columnName is filtered down to zero value or an error when more than one distinct value.

RückgabewertReturn value

Der Wert von Ergebnis_Spalte in der Zeile, in der alle Paare von Suche_Spalte und Suche_Wert eine genaue Übereinstimmung haben.The value of result_column at the row where all pairs of search_column and search_value have an exact match.

Wenn es keine Übereinstimmung gibt, die alle Suchwerte erfüllt, wird ein leerer Wert oder alternatives_Ergebnis zurückgegeben (falls vorhanden).If there's no match that satisfies all the search values, BLANK or alternateResult (if supplied) is returned. Anders gesagt, die Funktion gibt keinen Suchwert zurück, wenn nur ein paar der Kriterien übereinstimmen.In other words, the function won't return a lookup value if only some of the criteria match.

Wenn mehrere Zeilen mit den Suchwerten übereinstimmen und in allen Fällen die Ergebnis_Spalte-Werte identisch sind, wird dieser Wert zurückgegeben.If multiple rows match the search values and in all cases result_column values are identical, then that value is returned. Wenn Ergebnis_Spalte jedoch unterschiedliche Werte zurückgibt, wird ein Fehler oder alternatives_Ergebniszurückgegeben (falls vorhanden).However, if result_column returns different values, an error or alternateResult (if supplied) is returned.

BemerkungenRemarks

  • Wenn eine Beziehung zwischen dem Ergebnis und den Suchtabellen besteht, ist die Verwendung der RELATED-Funktion anstelle von LOOKUPVALUE in den meisten Fällen effizienter und bietet eine bessere Leistung.If there is a relationship between the result and search tables, in most cases, using RELATED function instead of LOOKUPVALUE is more efficient and provides better performance.

  • Die Parameter Suche_Wert und alternatives_Ergebnis werden ausgewertet, bevor die Funktion die Zeilen der Suchtabelle durchläuft.The search_value and alternateResult parameters are evaluated before the function iterates through the rows of the search table.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.This function is not supported for use in DirectQuery mode when used in calculated columns or row-level security (RLS) rules.

BeispielExample

Die Beispiele in diesem Artikel können dem Beispielmodell für Power BI Desktop hinzugefügt werden. Informationen zum Abrufen des Modells finden Sie unter DAX-Beispielmodell.Examples in this article can be added to the Power BI Desktop sample model. To get the model, see DAX sample model.

Die folgende berechnete Spalte, die in der Sales-Tabelle definiert ist, verwendet die LOOKUPVALUE-Funktion zum Zurückgeben von Channelwerten aus der Sales Order-Tabelle.The following calculated column defined in the Sales table uses the LOOKUPVALUE function to return channel values from the Sales Order table.

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

Da jedoch in diesem Fall eine Beziehung zwischen der Sales Order- und der Sales-Tabelle besteht, ist die Verwendung der RELATED-Funktion effizienter.However, in this case, because there is a relationship between the Sales Order and Sales tables, it's more efficient to use the RELATED function.

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

Siehe auchSee also

RELATED-Funktion (DAX)RELATED function (DAX)
InformationsfunktionenInformation functions