Skip to content

Read Reference Table

Looks up rows from a Data Lake reference table.

@lainstack/reference-table/read · Data

Read Reference Table takes a snapshot of one whole Reference Table and returns it as a Table handle under table. The rows are not inline in the output. Document columns arrive as run files.

Choose it when you need many or all rows. To use them, loop with @lainstack/flow/for-each-item, or load a small table into one list with @lainstack/collection/load-array. To fetch one record by an exact value, use @lainstack/reference-table/find-required-record instead. It returns that row directly.

Traps:

  • The block has no filter. It reads every row.
  • referenceTableId must name an existing table. A missing table fails the step. An archived table fails with status 409 until it is restored or you pick an active one.
  • An empty table still returns a Table handle with its schema and no rows.
  • Row cells are keyed by column id, such as column-1, not by column name.
Setting Key Type Details
Reference Table (required) referenceTableId Text Read all rows from this Reference Table.
Output Path Type
Table table Value