Table.FilterWithDataTable

TableInternal

Filters a table using a data table identifier. Intended for internal use only.

Examples on this page use shared sample tables. View them to understand the input data before reading the examples below.

Syntax

Table.FilterWithDataTable(table as table, dataTableIdentifier as text) as any

Parameters

NameTypeRequiredDescription
tabletableYesThe input table to filter.
dataTableIdentifiertextYesAn identifier for the data table used in filtering.

Return Value

anyThe filtered table result.

Remarks

This function is intended for internal use only. It is part of the Power Query engine's infrastructure for applying data table-based filters and is not designed for use in user-authored queries. Its behavior may change without notice between Power Query versions.

For filtering tables in your own queries, use Table.SelectRows with a row filter condition instead.

Examples

Example 1: Recommended alternative — use Table.SelectRows

Table.SelectRows(Sales, each [Category] = "Widgets")
Output
OrderID
Product
Category
Quantity
UnitPrice
CustomerID
OrderDate
11Widget AWidgets1025.5011/15/2024
25Widget AWidgets2025.5012/20/2024

Compatibility

Power BI Desktop Power BI Service Excel Desktop Excel Online Dataflows Fabric Notebooks