ЗНАЧЕНИЯ
Область применения: вычисление вычисляемого столбца вычисляемой таблицы Меры визуального элемента
Если входной параметр является именем столбца, возвращает таблицу с одним столбцом, содержащую различные значения из указанного столбца. Повторяющиеся значения удаляются и возвращаются только уникальные значения. Можно добавить пустое значение. Если входной параметр является именем таблицы, возвращает строки из указанной таблицы. Повторяющиеся строки сохраняются. Можно добавить ПУСТую строку.
Примечание.
Эту функцию нельзя использовать для возврата значений в ячейку или столбец на листе; скорее, вы используете его в качестве промежуточной функции, вложенной в формулу, чтобы получить список различных значений, которые можно считать или использовать для фильтрации или суммы других значений.
Синтаксис
VALUES(<TableNameOrColumnName>)
Параметры
Термин | Определение |
---|---|
TableName или ColumnName | Столбец, из которого возвращаются уникальные значения, или таблица, из которой должны быть возвращены строки. |
Возвращаемое значение
Если входной параметр является именем столбца, одна таблица столбцов. Если входной параметр является именем таблицы, возвращается таблица с теми же столбцами.
Замечания
При использовании функции VALUES в контексте, отфильтрованном, уникальные значения, возвращаемые значениями, возвращаемыми значениями, влияют на фильтр. Например, если вы фильтруете по регионам и возвращаете список значений для города, список будет содержать только те города в регионах, которые разрешены фильтром. Чтобы вернуть все города независимо от существующих фильтров, необходимо использовать функцию ALL для удаления фильтров из таблицы. Второй пример демонстрирует использование ALL с ЗНАЧЕНИЯми.
Эта функция не поддерживается для использования в режиме DirectQuery при использовании в вычисляемых столбцах или правилах безопасности на уровне строк (RLS).
Рекомендации по использованию ЗНАЧЕНИй см. в разделе "Использование SELECTEDVALUE" вместо ЗНАЧЕНИЙ.
Связанные функции
В большинстве случаев, когда аргумент является именем столбца, результаты функции 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 |