Freigeben über

VALUES

  • Artikel

Gilt für:Berechnete SpalteBerechnete TabelleMeasurevisuelle Berechnung

Wenn der Eingabeparameter ein Spaltenname ist, wird eine einspaltige Tabelle zurückgegeben, die die unterschiedlichen Werte aus der angegebenen Spalte enthält. Doppelte Werte werden entfernt, und nur eindeutige Werte werden zurückgegeben. Ein BLANK Wert kann hinzugefügt werden. Wenn der Eingabeparameter ein Tabellenname ist, werden die Zeilen aus der angegebenen Tabelle zurückgegeben. Doppelte Zeilen werden beibehalten. Eine BLANK Zeile kann hinzugefügt werden.

Hinweis

Diese Funktion kann nicht verwendet werden, um Werte in eine Zelle oder Spalte auf einem Arbeitsblatt zurückzugeben; Stattdessen verwenden Sie sie als Zwischenfunktion, die in einer Formel geschachtelt ist, um eine Liste mit unterschiedlichen Werten abzurufen, die gezählt oder zum Filtern oder Addieren anderer Werte verwendet werden können.

Syntax

VALUES(<TableNameOrColumnName>)

Parameter

Begriff Definition
TableName oder ColumnName Eine Spalte, aus der eindeutige Werte zurückgegeben werden sollen, oder eine Tabelle, aus der Zeilen zurückgegeben werden sollen.

Rückgabewert

Wenn der Eingabeparameter ein Spaltenname ist, eine Tabelle mit einer einzelnen Spalte. Wenn der Eingabeparameter ein Tabellenname ist, wird eine Tabelle mit denselben Spalten zurückgegeben.

Bemerkungen

  • Wenn Sie die VALUES-Funktion in einem Kontext verwenden, der gefiltert wurde, werden die von VALUES zurückgegebenen eindeutigen Werte vom Filter beeinflusst. Wenn Sie z. B. nach Region filtern und eine Liste der Werte für "Ort" zurückgeben, enthält die Liste nur die Städte in den regionen, die vom Filter zulässig sind. Um alle Städte unabhängig von vorhandenen Filtern zurückzugeben, müssen Sie die ALL-Funktion verwenden, um Filter aus der Tabelle zu entfernen. Im zweiten Beispiel wird die Verwendung von ALL mit VALUESveranschaulicht.

  • Diese Funktion wird für die Verwendung im DirectQuery-Modus nicht unterstützt, wenn sie in berechneten Spalten oder Sicherheitsregeln auf Zeilenebene (RLS) verwendet wird.

  • Bewährte Methoden bei der Verwendung von VALUESfinden Sie unter Verwenden von SELECTEDVALUE anstelle von VALUES.

In den meisten Szenarien ist das Argument ein Spaltenname, sind die Ergebnisse der VALUES-Funktion mit denen der DISTINCT Funktion identisch. Beide Funktionen entfernen Duplikate und geben eine Liste der möglichen Werte in der angegebenen Spalte zurück. Die VALUES-Funktion kann jedoch auch einen leeren Wert zurückgeben. Dieser leere Wert ist nützlich, wenn Sie unterschiedliche Werte aus einer verknüpften Tabelle nachschlagen, aber ein in der Beziehung verwendeter Wert fehlt in einer Tabelle. In der Datenbankterminologie wird dies als Verstoß gegen die referentielle Integrität bezeichnet. Solche Nichtübereinstimmungen in Daten können auftreten, wenn eine Tabelle aktualisiert wird und die zugehörige Tabelle nicht vorhanden ist.

Wenn das Argument ein Tabellenname ist, gibt das Ergebnis der VALUES-Funktion alle Zeilen in der angegebenen Tabelle sowie eine leere Zeile zurück, wenn ein Verstoß gegen die referenzielle Integrität vorliegt. Die DISTINCT-Funktion entfernt doppelte Zeilen und gibt eindeutige Zeilen in der angegebenen Tabelle zurück.

Hinweis

Mit der DISTINCT-Funktion kann ein Spaltenname oder ein beliebiger gültiger Tabellenausdruck als Argument verwendet werden, die VALUES-Funktion akzeptiert jedoch nur einen Spaltennamen oder einen Tabellennamen als Argument.

In der folgenden Tabelle sind die Nichtübereinstimmungen zwischen Daten zusammengefasst, die in zwei verknüpften Tabellen auftreten können, wenn die referenzielle Integrität nicht beibehalten wird.

Tabelle „Meine Bestellungen“ Tabelle „Meine Umsätze“
1\. Juni Umsatz 1. Juni
2\. Juni Umsatz 2. Juni
(keine Bestelldaten eingegeben) Umsatz 3. Juni

Wenn Sie die DISTINCT-Funktion verwenden, um eine Liste von Datumsangaben zurückzugeben, werden nur zwei Datumsangaben zurückgegeben. Wenn Sie jedoch die VALUES-Funktion verwenden, gibt die Funktion die beiden Datumsangaben plus ein zusätzliches leeres Element zurück. Außerdem werden alle Zeilen aus der Tabelle "MySales", die nicht über ein übereinstimmenes Datum in der Tabelle "MyOrders" verfügen, mit diesem unbekannten Element "abgeglichen".

Beispiel

Die folgende Formel zählt die Anzahl eindeutiger Rechnungen (Verkaufsaufträge) und erzeugt die folgenden Ergebnisse, wenn sie in einem Bericht verwendet werden, der die Produktkategorienamen enthält:

= COUNTROWS(VALUES('InternetSales_USD'[SalesOrderNumber]))

Rückgabe

Zeilenbezeichnungen Rechnungen zählen
Accessories 18.208
Bikes 15.205
Clothing 7\.461
Grand Total 27.659

Verwandte Inhalte

FILTER FunktionCOUNTROWS FunktionFilterfunktionen