# Get records from stream

This step returns records that were previously generated by another transformation in a job. The records were passed to this step using one of the streaming input steps (for example, [Kinesis consumer](/pdia-data-integration/pdi-transformation-steps-reference-overview/kinesis-consumer.md) or [Kafka consumer](/pdia-data-integration/pdi-transformation-steps-reference-overview/kafka-consumer.md)), which are available in the **Streaming** category of transformations.

{% hint style="info" %}
This step produces one or more rows and cannot be placed within an existing stream. It must be the first step in a stream because it produces rows.

If you want to add this data to an existing stream, use a join step.
{% endhint %}

### Step name

* **Step name**: Specifies the unique name of the Get records from stream transformation step on the canvas. You can customize the name or leave it as the default.

### Fields

![Get Records from Stream Options](/files/9biT71PR6j1ZKA3YbWJr)

Use the **Fields** table to enter the metadata of the fields you expect from the previous transformation.

| Column        | Description                                                                                                                                                                                                                |
| ------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Fieldname** | Name of the field that contains the records from the previous result.                                                                                                                                                      |
| **Type**      | <p>Type of data. Options include:</p><ul><li>Number</li><li>String</li><li>Date</li><li>Boolean</li><li>Integer</li><li>BigNumber</li><li>Serializable</li><li>Binary</li><li>Timestamp</li><li>Internet Address</li></ul> |
| **Length**    | <ul><li>For a field with the type of Number, enter the total number of significant figures in a number.</li><li>For a field with the type of String, enter the length of the string.</li></ul>                             |
| **Precision** | For a field with the type of Number, enter the number of floating point digits. Otherwise, leave blank.                                                                                                                    |

**Note:** There is no validation performed on this metadata. It is intended as a design-time aid.

### Metadata injection support

This step supports metadata injection. You can use it with [ETL metadata injection](/pdia-data-integration/pdi-transformation-steps-reference-overview/etl-metadata-injection.md) to pass metadata to your transformation at runtime.

### See also

* [Kafka consumer](/pdia-data-integration/pdi-transformation-steps-reference-overview/kafka-consumer.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.pentaho.com/pdia-data-integration/pdi-transformation-steps-reference-overview/get-records-from-stream.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.