singer_sdk.GraphQLStream
- class singer_sdk.GraphQLStream
Abstract base class for API-type streams.
GraphQL streams inherit from the class GraphQLStream, which in turn inherits from the RESTStream class. GraphQL streams are very similar to REST API-based streams, but instead of specifying a path and url_params, developers override the GraphQL query text.
- prepare_request_payload(context: dict | None, next_page_token: Any | None) dict | None
Prepare the data payload for the GraphQL API request.
Developers generally should generally not need to override this method. Instead, developers set the payload by properly configuring the query attribute.
- Parameters
context – Stream partition or context dictionary.
next_page_token – Token, page number or any request argument to request the next page of data.
- Returns
Dictionary with the body to use for the request.
- Raises
ValueError – If the query property is not set in the request body.
- property query: str
Set or return the GraphQL query string.
- Raises
NotImplementedError – If the derived class doesn’t define this property.
- property records_jsonpath: str
Get the JSONPath expression to extract records from an API response.
- Returns
JSONPath expression string