How does SDK implement state feature? There are APIs that allow filtering through the HTTP request itself (filter through replication keys) and some APIs that return all data, How should one access a state object inside functions like

prepare_request_payload()

for a tap in order get the bookmark values so they can add it in a payload for the API POST Request. I am able to successfully send the requests but i want the value of replication keys in the state file be used in the request as part of state feature .

Hi, @rithesh_s - For datetime-type replication keys, you can use

Stream.get_starting_timestamp(context)

, which takes the same context passed to

prepare_request_payload()

and returns a datetime value. For non-datetime types, use

Stream.get_starting_replication_key_value()

. The two are mostly identical except that the datetime version also considers the

start_date

config value, if set.

Does the timestamp version return the replication value for a stream present in a state file if --state is used?

Yes, that's correct. Timpestamp version will return the matching replication value when --state is passed and a matching stream entry exists within the state file, and if state is not used, the SDK will return

start_date

from config if set. Otherwise (if neither is true) would be null.

Thanks a lot

To help future inquiries, I've added everything from this thread to the docstrings: Improved docstrings for stream class (!105) · Merge requests · Meltano / Meltano SDK for Singer Taps and Targets · GitLab Once merged, these will be These are now rendered in the auto-generated docs at https://sdk.meltano.com/en/latest/classes/singer_sdk.Stream.html#singer_sdk.Stream.get_starting_replication_key_value Still more to do, probably, to make this page discoverable - but it's a start. 🙂

Great Work!!

Thanks! 🙂