Package software.amazon.awscdk.services.glue.alpha

Class Job

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.glue.alpha.Job

All Implemented Interfaces:

IResource, IJob, IGrantable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.98.0 (build 00b106d)",
           date="2024-05-08T21:35:15.767Z")
@Stability(Experimental)
public class Job
extends Resource
implements IJob

(experimental) A Glue Job.

Example:

 Job.Builder.create(this, "EnableSparkUI")
         .jobName("EtlJobWithSparkUIPrefix")
         .sparkUI(SparkUIProps.builder()
                 .enabled(true)
                 .build())
         .executable(JobExecutable.pythonEtl(PythonSparkJobExecutableProps.builder()
                 .glueVersion(GlueVersion.V3_0)
                 .pythonVersion(PythonVersion.THREE)
                 .script(Code.fromAsset(join(__dirname, "job-script", "hello_world.py")))
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	Job.Builder	(experimental) A fluent builder for Job.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.glue.alpha.IJob

IJob.Jsii$Default, IJob.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Job(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Job(software.amazon.jsii.JsiiObjectRef objRef)
	Job(software.constructs.Construct scope, String id, JobProps props)

Method Summary

Modifier and Type	Method	Description
static IJob	fromJobAttributes(software.constructs.Construct scope, String id, JobAttributes attrs)	(experimental) Creates a Glue Job.
IPrincipal	getGrantPrincipal()	(experimental) The principal this Glue Job is running as.
String	getJobArn()	(experimental) The ARN of the job.
String	getJobName()	(experimental) The name of the job.
IRole	getRole()	(experimental) The IAM role Glue assumes to run this job.
SparkUILoggingLocation	getSparkUILoggingLocation()	(experimental) The Spark UI logs location if Spark UI monitoring and debugging is enabled.
Metric	metric(String metricName, MetricType type)	(experimental) Create a CloudWatch metric.
Metric	metric(String metricName, MetricType type, MetricOptions props)	(experimental) Create a CloudWatch metric.
Metric	metricFailure()	(experimental) Return a CloudWatch Metric indicating job failure.
Metric	metricFailure(MetricOptions props)	(experimental) Return a CloudWatch Metric indicating job failure.
Metric	metricSuccess()	(experimental) Return a CloudWatch Metric indicating job success.
Metric	metricSuccess(MetricOptions props)	(experimental) Return a CloudWatch Metric indicating job success.
Metric	metricTimeout()	(experimental) Return a CloudWatch Metric indicating job timeout.
Metric	metricTimeout(MetricOptions props)	(experimental) Return a CloudWatch Metric indicating job timeout.
Rule	onEvent(String id)	(experimental) Create a CloudWatch Event Rule for this Glue Job when it's in a given state.
Rule	onEvent(String id, OnEventOptions options)	(experimental) Create a CloudWatch Event Rule for this Glue Job when it's in a given state.
Rule	onFailure(String id)	(experimental) Return a CloudWatch Event Rule matching FAILED state.
Rule	onFailure(String id, OnEventOptions options)	(experimental) Return a CloudWatch Event Rule matching FAILED state.
Rule	onStateChange(String id, JobState jobState)	(experimental) Create a CloudWatch Event Rule for the transition into the input jobState.
Rule	onStateChange(String id, JobState jobState, OnEventOptions options)	(experimental) Create a CloudWatch Event Rule for the transition into the input jobState.
Rule	onSuccess(String id)	(experimental) Create a CloudWatch Event Rule matching JobState.SUCCEEDED.
Rule	onSuccess(String id, OnEventOptions options)	(experimental) Create a CloudWatch Event Rule matching JobState.SUCCEEDED.
Rule	onTimeout(String id)	(experimental) Return a CloudWatch Event Rule matching TIMEOUT state.
Rule	onTimeout(String id, OnEventOptions options)	(experimental) Return a CloudWatch Event Rule matching TIMEOUT state.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Details

Job

protected Job(software.amazon.jsii.JsiiObjectRef objRef)

Job

protected Job(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Job

@Stability(Experimental)
public Job(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 JobProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props - This parameter is required.

Method Details

fromJobAttributes

@Stability(Experimental)
@NotNull
public static IJob fromJobAttributes(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 JobAttributes attrs)

(experimental) Creates a Glue Job.

Parameters:

scope - The scope creating construct (usually this). This parameter is required.

id - The construct's id. This parameter is required.

attrs - Import attributes. This parameter is required.

metric

@Stability(Experimental)
@NotNull
public Metric metric(@NotNull
 String metricName,
 @NotNull
 MetricType type,
 @Nullable
 MetricOptions props)

(experimental) Create a CloudWatch metric.

Specified by:

metric in interface IJob

Parameters:

metricName - name of the metric typically prefixed with glue.driver., glue.<executorId>. or glue.ALL.. This parameter is required.

type - the metric type. This parameter is required.

props - metric options.

See Also:

• https://docs.aws.amazon.com/glue/latest/dg/monitoring-awsglue-with-cloudwatch-metrics.html

metric

@Stability(Experimental)
@NotNull
public Metric metric(@NotNull
 String metricName,
 @NotNull
 MetricType type)

(experimental) Create a CloudWatch metric.

Specified by:

metric in interface IJob

Parameters:

metricName - name of the metric typically prefixed with glue.driver., glue.<executorId>. or glue.ALL.. This parameter is required.

type - the metric type. This parameter is required.

See Also:

• https://docs.aws.amazon.com/glue/latest/dg/monitoring-awsglue-with-cloudwatch-metrics.html

metricFailure

@Stability(Experimental)
@NotNull
public Metric metricFailure(@Nullable
 MetricOptions props)

(experimental) Return a CloudWatch Metric indicating job failure.

This metric is based on the Rule returned by no-args onFailure() call.

Specified by:

metricFailure in interface IJob

Parameters:

props -

metricFailure

@Stability(Experimental)
@NotNull
public Metric metricFailure()

(experimental) Return a CloudWatch Metric indicating job failure.

This metric is based on the Rule returned by no-args onFailure() call.

Specified by:

metricFailure in interface IJob

metricSuccess

@Stability(Experimental)
@NotNull
public Metric metricSuccess(@Nullable
 MetricOptions props)

(experimental) Return a CloudWatch Metric indicating job success.

This metric is based on the Rule returned by no-args onSuccess() call.

Specified by:

metricSuccess in interface IJob

Parameters:

props -

metricSuccess

@Stability(Experimental)
@NotNull
public Metric metricSuccess()

(experimental) Return a CloudWatch Metric indicating job success.

This metric is based on the Rule returned by no-args onSuccess() call.

Specified by:

metricSuccess in interface IJob

metricTimeout

@Stability(Experimental)
@NotNull
public Metric metricTimeout(@Nullable
 MetricOptions props)

(experimental) Return a CloudWatch Metric indicating job timeout.

This metric is based on the Rule returned by no-args onTimeout() call.

Specified by:

metricTimeout in interface IJob

Parameters:

props -

metricTimeout

@Stability(Experimental)
@NotNull
public Metric metricTimeout()

(experimental) Return a CloudWatch Metric indicating job timeout.

This metric is based on the Rule returned by no-args onTimeout() call.

Specified by:

metricTimeout in interface IJob

onEvent

@Stability(Experimental)
@NotNull
public Rule onEvent(@NotNull
 String id,
 @Nullable
 OnEventOptions options)

(experimental) Create a CloudWatch Event Rule for this Glue Job when it's in a given state.

Specified by:

onEvent in interface IJob

Parameters:

id - construct id. This parameter is required.

options - event options.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onEvent

@Stability(Experimental)
@NotNull
public Rule onEvent(@NotNull
 String id)

(experimental) Create a CloudWatch Event Rule for this Glue Job when it's in a given state.

Specified by:

onEvent in interface IJob

Parameters:

id - construct id. This parameter is required.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onFailure

@Stability(Experimental)
@NotNull
public Rule onFailure(@NotNull
 String id,
 @Nullable
 OnEventOptions options)

(experimental) Return a CloudWatch Event Rule matching FAILED state.

Specified by:

onFailure in interface IJob

Parameters:

id - construct id. This parameter is required.

options - optional event options.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onFailure

@Stability(Experimental)
@NotNull
public Rule onFailure(@NotNull
 String id)

(experimental) Return a CloudWatch Event Rule matching FAILED state.

Specified by:

onFailure in interface IJob

Parameters:

id - construct id. This parameter is required.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onStateChange

@Stability(Experimental)
@NotNull
public Rule onStateChange(@NotNull
 String id,
 @NotNull
 JobState jobState,
 @Nullable
 OnEventOptions options)

(experimental) Create a CloudWatch Event Rule for the transition into the input jobState.

Specified by:

onStateChange in interface IJob

Parameters:

id - construct id. This parameter is required.

jobState - the job state. This parameter is required.

options - optional event options.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onStateChange

@Stability(Experimental)
@NotNull
public Rule onStateChange(@NotNull
 String id,
 @NotNull
 JobState jobState)

(experimental) Create a CloudWatch Event Rule for the transition into the input jobState.

Specified by:

onStateChange in interface IJob

Parameters:

id - construct id. This parameter is required.

jobState - the job state. This parameter is required.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onSuccess

@Stability(Experimental)
@NotNull
public Rule onSuccess(@NotNull
 String id,
 @Nullable
 OnEventOptions options)

(experimental) Create a CloudWatch Event Rule matching JobState.SUCCEEDED.

Specified by:

onSuccess in interface IJob

Parameters:

id - construct id. This parameter is required.

options - optional event options.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onSuccess

@Stability(Experimental)
@NotNull
public Rule onSuccess(@NotNull
 String id)

(experimental) Create a CloudWatch Event Rule matching JobState.SUCCEEDED.

Specified by:

onSuccess in interface IJob

Parameters:

id - construct id. This parameter is required.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onTimeout

@Stability(Experimental)
@NotNull
public Rule onTimeout(@NotNull
 String id,
 @Nullable
 OnEventOptions options)

(experimental) Return a CloudWatch Event Rule matching TIMEOUT state.

Specified by:

onTimeout in interface IJob

Parameters:

id - construct id. This parameter is required.

options - optional event options.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

onTimeout

@Stability(Experimental)
@NotNull
public Rule onTimeout(@NotNull
 String id)

(experimental) Return a CloudWatch Event Rule matching TIMEOUT state.

Specified by:

onTimeout in interface IJob

Parameters:

id - construct id. This parameter is required.

See Also:

• https://docs.aws.amazon.com/AmazonCloudWatch/latest/events/EventTypes.html#glue-event-types

getGrantPrincipal

@Stability(Experimental)
@NotNull
public IPrincipal getGrantPrincipal()

(experimental) The principal this Glue Job is running as.

Specified by:

getGrantPrincipal in interface IGrantable

getJobArn

@Stability(Experimental)
@NotNull
public String getJobArn()

(experimental) The ARN of the job.

Specified by:

getJobArn in interface IJob

getJobName

@Stability(Experimental)
@NotNull
public String getJobName()

(experimental) The name of the job.

Specified by:

getJobName in interface IJob

getRole

@Stability(Experimental)
@NotNull
public IRole getRole()

(experimental) The IAM role Glue assumes to run this job.

getSparkUILoggingLocation

@Stability(Experimental)
@Nullable
public SparkUILoggingLocation getSparkUILoggingLocation()

(experimental) The Spark UI logs location if Spark UI monitoring and debugging is enabled.

See Also:

• https://docs.aws.amazon.com/glue/latest/dg/aws-glue-programming-etl-glue-arguments.html