VALUES

Si applica a:Calcolo visivo misuratabella calcolata colonnacalcolata

Quando il parametro di input è un nome di colonna, restituisce una tabella a singola colonna contenente i valori distinti della colonna specificata. I valori duplicati vengono rimossi e vengono restituiti solo valori univoci. È possibile aggiungere un valore BLANK. Quando il parametro di input è un nome di tabella, restituisce le righe dalla tabella specificata. Le righe duplicate vengono mantenute. È possibile aggiungere una riga BLANK.

Nota

Questa funzione non può essere usata per restituire valori in una cella o in una colonna di un foglio di calcolo. Viene invece usata come funzione intermedia, annidata in una formula, per ottenere un elenco di valori distinti che possono essere conteggiati o usati per filtrare o sommare altri valori.

Sintassi

VALUES(<TableNameOrColumnName>)  

Parametri

Termine	Definizione
TableName o ColumnName	Colonna da cui devono essere restituiti valori univoci o tabella da cui devono essere restituite righe.

Valore restituito

Quando il parametro di input è un nome di colonna, una tabella a colonna singola. Quando il parametro di input è un nome di tabella, viene restituita una tabella con le stesse colonne.

Osservazioni:

• Quando si usa la funzione VALUES in un contesto filtrato, i valori univoci restituiti da VALUES sono interessati dal filtro. Se ad esempio si filtra per area e viene restituito un elenco di valori di città, l'elenco includerà solo le città nelle aree consentite dal filtro. Per restituire tutte le città, indipendentemente dai filtri esistenti, è necessario usare la funzione ALL per rimuovere i filtri dalla tabella. Il secondo esempio illustra l'uso di ALL con VALUES.

• Questa funzione non è supportata per l'uso nella modalità DirectQuery se usata in colonne calcolate o nelle regole di sicurezza a livello di riga.

• Per le procedure consigliate quando si usa VALUES, vedere Usare SELECTEDVALUE invece di VALUES.

Funzioni correlate

Nella maggior parte degli scenari, quando l'argomento è un nome di colonna, i risultati della funzione VALUES sono identici a quelli della funzione DISTINCT. Entrambe le funzioni rimuovono i duplicati e restituiscono un elenco dei possibili valori nella colonna specificata. La funzione VALUES tuttavia può restituire anche un valore blank. Questo valore blank è utile quando si cercano valori distinti da una tabella correlata, ma un valore usato nella relazione manca in una tabella. Nella terminologia dei database questa condizione è detta violazione dell'integrità referenziale. Tali mancate corrispondenze nei dati possono verificarsi quando una tabella viene aggiornata e quella correlata no.

Quando l'argomento è un nome di tabella, il risultato della funzione VALUES restituisce tutte le righe nella tabella specificata più una riga vuota, se si verifica una violazione dell'integrità referenziale. La funzione DISTINCT rimuove le righe duplicate e restituisce righe univoche nella tabella specificata.

Nota

La funzione DISTINCT consente di usare come argomento un nome di colonna o un'espressione di tabella valida, ma la funzione VALUES accetta solo un nome di colonna o un nome di tabella come argomento.

La tabella seguente riepiloga la mancata corrispondenza tra i dati, che può verificarsi in due tabelle correlate quando l'integrità referenziale non viene preservata.

Tabella MyOrders	Tabella MySales
June 1	June 1 sales
June 2	June 2 sales
(non sono state immesse date di ordini)	June 3 sales

Se si usa la funzione DISTINCT per restituire un elenco di date, saranno restituite solo due date. Se tuttavia si usa la funzione VALUES, la funzione restituisce le due date più un membro vuoto aggiuntivo. Inoltre, tutte le righe della tabella MySales che non hanno una data corrispondente nella tabella MyOrders verranno associate a questo membro sconosciuto.

Esempio

La formula seguente conteggia il numero di fatture univoche (ordini di vendita) e genera i risultati seguenti se usata in un report che include i nomi delle categorie di prodotti:

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

Resi

Etichette di riga	Conteggio fatture
Accessori	18,208
Bikes	15,205
Clothing	7,461
Grand Total	27,659

Contenuto correlato

Funzione FILTER
Funzione COUNTROWS
Funzioni di filtro