Value.Firewall
ValueInternalReturns a firewall-partitioned value for the given key. Intended for internal use only.
Syntax
Value.Firewall(key as text) as anyParameters
| Name | Type | Required | Description |
|---|---|---|---|
key | text | Yes | The firewall partition key identifying the data source or partition to retrieve. |
Return Value
any — The value associated with the specified firewall partition key.
Remarks
This function is intended for internal use only and is not designed to be called directly in user-written M queries.
Value.Firewall is part of the Power Query data privacy firewall infrastructure. The firewall engine partitions data by source and enforces rules that prevent unauthorized data flow between sources with different privacy levels (e.g., Public, Organizational, Private). Value.Firewall retrieves a value from a specific firewall partition identified by the key parameter.
When Power Query evaluates a query that combines data from multiple sources, the engine internally inserts Value.Firewall calls to isolate data from each source into its own partition. This ensures that data from a Private source cannot leak into a query sent to a Public source, and vice versa.
### How the firewall works at a high level
- Each data source accessed in a query is assigned a privacy level (Public, Organizational, or Private).
- The engine creates partitions — one per data source — and wraps each partition's data behind
Value.Firewall. - Before combining data across partitions, the engine checks whether the combination is allowed by the configured privacy levels.
- If the combination violates the privacy rules, the query raises a
Formula.Firewallerror rather than silently leaking data.
You will typically encounter Value.Firewall only in diagnostic or trace output from the Power Query engine. Calling it directly will not produce useful results and may raise errors, since the key values are engine-internal identifiers.
Examples
Example 1: Understanding the firewall concept
try Value.Firewall("invalid-key") otherwise "Error: key not recognized by the firewall engine"Result | |
|---|---|
| 1 | Error: key not recognized by the firewall engine |