WERTE

Wenn der Eingabeparameter ein Spaltenname ist, wird eine einspaltige Tabelle zurückgegeben, die die verschiedenen Werte aus der angegebenen Spalte enthält. Doppelte Werte werden entfernt, und es werden nur eindeutige Werte zurückgegeben. Ein leerer 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 leere Zeile kann hinzugefügt werden.

Hinweis

Diese Funktion kann nicht verwendet werden, um Werte in einer Zelle oder Spalte in einem Arbeitsblatt zurückzugeben. Verwenden Sie sie stattdessen als in einer Formel geschachtelte Zwischenfunktion, um eine Liste der verschiedenen Werte zu erhalten, die gezählt oder zum Filtern oder Summieren 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 gefilterten Kontext verwenden, hat der Filter Einfluss auf die von VALUES zurückgegebenen eindeutigen Werte. Wenn Sie z. B. nach „Region“ filtern und eine Liste der Werte für „Stadt“ zurückgeben, enthält die Liste nur die Städte in den vom Filter zugelassenen Regionen. Wenn Sie alle Städte unabhängig von vorhandenen Filtern zurückgeben möchten, müssen Sie die Funktion ALL verwenden, um Filter aus der Tabelle zu entfernen. Im zweiten Beispiel wird die Verwendung von ALL mit VALUES veranschaulicht.

  • Die Verwendung dieser Funktion im DirectQuery-Modus wird nicht unterstützt, wenn sie in berechneten Spalten oder RLS-Regeln (Row-Level Security) eingesetzt wird.

  • Bewährte Methoden für die Verwendung von VALUES finden Sie unter Verwenden von SELECTEDVALUE anstelle von VALUES.

In den meisten Szenarios sind die Ergebnisse der VALUES-Funktion identisch mit denen der DISTINCT-Funktion, wenn das Argument ein Spaltenname ist. 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 suchen, ein in der Beziehung verwendeter Wert jedoch in einer Tabelle fehlt. In der Datenbankterminologie wird dies als Verstoß gegen die referentielle Integrität bezeichnet. Derartige Datenkonflikte können auftreten, wenn eine Tabelle aktualisiert wird und die verknüpfte Tabelle nicht vorhanden ist.

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

Hinweis

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

Die folgende Tabelle zeigt die Datenkonflikte, die bei zwei verknüpften Tabellen auftreten können, wenn die referentielle Integrität nicht beachtet 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 mit Datumswerten zurückzugeben, werden nur zwei Datumswerte zurückgegeben. Wenn Sie hingegen die VALUES-Funktion verwenden, gibt die Funktion die beiden Datumswerte sowie ein zusätzliches leeres Element zurück. Außerdem wird jede Zeile aus der Tabelle „Meine Umsätze“, die nicht über ein übereinstimmendes Datum in der Tabelle „Meine Bestellungen“ verfügt, mit diesem unbekannten Element „abgeglichen“.

Beispiel

Die folgende Formel zählt die Anzahl der eindeutigen Rechnungen (Aufträge) und erzeugt die folgenden Ergebnisse, wenn sie in einem Bericht verwendet wird, der die Namen der Produktkategorien enthält:

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

Rückgabe

Zeilenbezeichnungen Anzahl der Rechnungen
Accessories 18.208
Bikes 15.205
Clothing 7\.461
Grand Total 27.659

FILTER-Funktion
COUNTROWS-Funktion
Filterfunktionen