VALUES
применяется:
вычисляемый столбецвычисляемой таблицыизмерениевизуального вычисления
Если входной параметр является именем столбца, возвращает таблицу с одним столбцом, содержащую различные значения из указанного столбца. Повторяющиеся значения удаляются и возвращаются только уникальные значения. Можно добавить BLANK значение. Если входной параметр является именем таблицы, возвращает строки из указанной таблицы. Повторяющиеся строки сохраняются. Можно добавить строку BLANK.
Примечание.
Эту функцию нельзя использовать для возврата значений в ячейку или столбец на листе; скорее, вы используете его в качестве промежуточной функции, вложенной в формулу, чтобы получить список различных значений, которые можно считать или использовать для фильтрации или суммы других значений.
Синтаксис
VALUES(<TableNameOrColumnName>)
Параметры
| Термин | Определение |
|---|---|
TableName или ColumnName |
Столбец, из которого возвращаются уникальные значения, или таблица, из которой должны быть возвращены строки. |
Возвращаемое значение
Если входной параметр является именем столбца, одна таблица столбцов. Если входной параметр является именем таблицы, возвращается таблица с теми же столбцами.
Замечания
При использовании функции VALUES в контексте, отфильтрованном, уникальные значения, возвращаемые VALUES, влияют на фильтр. Например, если вы фильтруете по регионам и возвращаете список значений для города, список будет содержать только те города в регионах, которые разрешены фильтром. Чтобы вернуть все города независимо от существующих фильтров, необходимо использовать функцию ALL для удаления фильтров из таблицы. Второй пример демонстрирует использование ALL с VALUES.
Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).
Рекомендации по использованию VALUESсм. в разделе Использование SELECTEDVALUE вместо VALUES.
Связанные функции
В большинстве сценариев, когда аргумент является именем столбца, результаты функции VALUES идентичны результатам функции DISTINCT. Обе функции удаляют дубликаты и возвращают список возможных значений в указанном столбце. Однако функция VALUES также может возвращать пустое значение. Это пустое значение полезно в случаях, когда вы ищете различные значения из связанной таблицы, но значение, используемое в связи, отсутствует из одной таблицы. В терминологии базы данных это называется нарушением целостности ссылок. Такие несоответствия в данных могут возникать при обновлении одной таблицы, а связанная таблица не является.
Если аргумент является именем таблицы, результат функции VALUES возвращает все строки в указанной таблице плюс пустую строку, если имеется нарушение целостности ссылок. Функция DISTINCT удаляет повторяющиеся строки и возвращает уникальные строки в указанной таблице.
Примечание.
Функция DISTINCT позволяет использовать имя столбца или любое допустимое табличное выражение, но функция VALUES принимает только имя столбца или имя таблицы в качестве аргумента.
В следующей таблице приводится сводка несоответствия между данными, которые могут возникать в двух связанных таблицах, когда целостность ссылок не сохраняется.
| Таблица MyOrders | Таблица MySales |
|---|---|
| 1 июня | 1 июня продажи |
| 2 июня | 2 июня продажи |
| (даты заказа не были введены) | 3 июня продажи |
Если функция DISTINCT используется для возврата списка дат, будут возвращены только две даты. Однако если вы используете функцию VALUES, функция возвращает два даты плюс дополнительный пустой элемент. Кроме того, любая строка из таблицы MySales, которая не имеет даты сопоставления в таблице MyOrders, будет "сопоставлена" с этим неизвестным элементом.
Пример
Следующая формула подсчитывает количество уникальных счетов (заказов на продажу) и выдает следующие результаты при использовании в отчете, включающее имена категорий продуктов:
= COUNTROWS(VALUES('InternetSales_USD'[SalesOrderNumber]))
Возвраты
| Метки строк | Подсчет счетов |
|---|---|
| Аксессуары | 18,208 |
| Велосипеды | 15,205 |
| Clothing | 7,461 |
| Общий итог | 27,659 |