查询实体记录

Query entity records node for reading one or more records from a Data Fabric entity in a Flow, without an Integration Service connection.

Reads one or more records from a Data Fabric entity. This is a native Flow node — it doesn't require an Integration Service (IS) connection. It works only with entities created inside a VS Code solution. Refer to Entities in VS Code.

配置

字段	必填	描述
Data Fabric 实体	是	The entity to query. Select Refresh schema if the entity's fields changed since you added the node.
Records to return	是	Single record returns one record and fails if the filter matches more than one. Multiple records returns an array of matching records.
Filter condition(s)	否	One or more field/operator/value conditions, combined with All (AND) or Any (OR).
Sort by (Multiple records only)	否	The field to sort results by, and direction (Ascending or Descending). Without a sort, the query can return a different set of records each time.
Records to skip (Multiple records only)	否	Number of matching records to skip before returning results. Default 0.
Record limit (Multiple records only)	否	Maximum number of records to return. Default 100, maximum 1000.

Within Filter condition(s), select Add condition for another condition at the same level, or Add group to nest a condition group with its own AND/OR logic.

This node doesn't support the Error handling tab.

输出

For Single record, the output fields mirror the entity's schema directly. For Multiple records, the output is a results array, with each item mirroring the entity's schema. Access them downstream as $vars.<nodeId>.output.<fieldName> (single record) or $vars.<nodeId>.output.results[<index>].<fieldName> (multiple records).

The output panel includes a Live mode. When it is enabled, the output is a live reference to the query, tagged Live query in the schema tree — downstream nodes always see current values without re-running the query. Update entity record and Delete entity record can target a record found by this node directly, by referencing it instead of re-specifying the entity and filter.