Direct Load Step

This type of step loads data directly from an external source.

JSON Request

The following template shows the body of a JSON request that could be used in a Direct Load Step PUT or PATCH request. It lists all of the step's required and optional body parameters but excludes the read-only options. The default values for each parameter are shown. Below the request (in Schema Details) is a table that describes the complete schema, including the read-only parameters. Clicking a link in the template takes you to the schema details for that parameter.

{ "title" : "string", "transformQuery" : "string", "incrementalData" : [ "string" ], "type" : "DirectLoadStep", "enabled" : true, "contextProvider" : [ "string" ], "description" : "string", "ontology" : [ "string" ], "source" : [ "string" ], "ignoreLoadErrors" : true, "disableLoadCounts" : true, "preGenerateStatistics" : true, "tags" : [ { "description" : "string", "title" : "string" } ], "tagTitle" : [ "string" ] }

Schema Details

The table below describes the Direct Load Step schema.

You can also see the Direct Load Step schema by expanding Schemas at the bottom of the Graph Studio REST API document and viewing DirectLoadStep.

Property	Format	Required?	Description
uri (read-only)	"uri"	Auto-generated	The URI of the step.
creator (read-only)	"uri"	Auto-generated	The creator of the step.
created (read-only)	"dateTime"	Auto-generated	The timestamp when the step was created.
modifier (read-only)	"uri"	Auto-generated	The user who modified the step.
alltypes (read-only)	Array of strings	Optional	A list of the types related to the step, such as DirectLoadStep, Step, LayerChild, etc.
contextAttribute (read-only)	Array of strings	Optional	A list of any context attributes that are used.
title	"string"	Required	The name of the step.
transformQuery	"string"	Required	The SPARQL query to run.
incrementalData	"string"	Optional	Incremental load data associated with the step.
type	"string"	Required	The type of step: "DirectLoadStep".
enabled	boolean	Optional	Controls whether the step is enabled or disabled.
contextProvider	[ "uri", "..." ]	Optional	A list of any referenced context providers (the data source URI). You can retrieve data for the parent layer to get a list of providers for that layer.
description	"string"	Optional	A brief description of the step.
ontology	[ "uri", "..." ]	Optional	This type of step automatically generates a managed model that is owned and managed by the data layer that contains the Direct Load Step. If you would like to associate additional models with this step, you can include the URIs for those models. For more information about managed models, see Managed Model Concepts.
source	[ "uri", "..." ]	Required	The source data for the step. Options are any combination of the following values:

• "http://cambridgesemantics.com/ontologies/Graphmarts#Self": The source is the data that is in this step's layer.
• "http://cambridgesemantics.com/ontologies/Graphmarts#AllPrevious": The source is the data from all of the successful layers that precede this step's layer. Failed layers are ignored.
• "http://cambridgesemantics.com/ontologies/Graphmarts#Previous": The source is the data that is in the one layer that precedes this step's layer.
• "layer_uri": The source is a specific layer in the graphmart.

| | ignoreLoadErrors | boolean | Optional | Controls whether to ignore errors and proceed with the load or fail the step if there is an error. | | disableLoadCounts | boolean | Optional | Controls whether Graph Studio periodically queries Graph Lakehouse to count the total number of statements that are processed. Disabling the load count decreases the number of queries that run during activation. | | preGenerateStatistics | boolean | Optional | Controls whether Graph Lakehouse generates statistics on the data before the step is run. | | tags | Array of objects | Optional | Any tags on the step. | | tagTitle | ["string"] | Optional | A virtual property that is available for all objects. It lists the tags associated with the step or can be used to add a tag to the step without including a description. |