Datasource

class Datasource

An interface for working with workflow datasources on Redivis.

Constructors

redivis.datasource(name)	Create a reference to a datasource. Can only be called if a default workflow is set.
Workflow.datasource(name)	Create a reference to a Datasource within a specific workflow.
Workflow.list_datasources([max_results])	Returns a list of Datasources within a workflow

Examples

username = "imathews"
workflow_name = "example_workflow_climate_analysis:x7kh"
dataset_name = "ghcn_daily_weather_data"

workflow = redivis.workflow(f"{username}.{workflow_name}")
datasource = workflow.datasource(dataset_name)

datasource.update(version="v2.0")

Attributes

workflow	A reference to the Workflow instance that this datasource belongs to.
properties	A dict containing the API resource representation of the datasource. This will only be populated after certain methods are called, particularly the get method, and will otherwise be None.

Methods

datasource.create()	Create a new datasource in a workflow
datasource.get()	Fetches the datasource, after which datasource.properties will contain a dict with entries corresponding to the properties on the datasource resource definition. Will raise an error if the datasource does not exist.
datasource.exists()	Check whether the datasource exists.
datasource.source_dataset()	Returns a reference to this datasource's source dataset.
datasource.source_workflow()	Returns a reference to this datasource's source workflow.
datasource.update([*, ...])	Update the datasource to reference a new dataset, workflow, or version thereof.