software.amazon.awscdk.services.glue

Class Job

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.core.Construct

software.amazon.awscdk.core.Resource

software.amazon.awscdk.services.glue.Job

All Implemented Interfaces:

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

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-04T15:39:09.619Z")
 @Stability(value=Experimental)
public class Job
extends Resource
implements IJob

(experimental) A Glue Job.

Example:

 Bucket bucket;
 Job.Builder.create(this, "PythonShellJob")
         .executable(JobExecutable.pythonShell(PythonShellExecutableProps.builder()
                 .glueVersion(GlueVersion.V1_0)
                 .pythonVersion(PythonVersion.THREE)
                 .script(Code.fromBucket(bucket, "script.py"))
                 .build()))
         .description("an example Python Shell job")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static 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.amazon.awscdk.services.glue.IJob

IJob.Jsii$Default, IJob.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and 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.core.Resource

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

Methods inherited from class software.amazon.awscdk.core.Construct

getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate

Methods inherited from class software.constructs.Construct

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.amazon.awscdk.core.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.amazon.awscdk.core.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Job

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

Job

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

Job

@Stability(value=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 Detail

fromJobAttributes

@Stability(value=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(value=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..` 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(value=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..` 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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=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(value=Experimental)
 @NotNull
public IPrincipal getGrantPrincipal()

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

Specified by:

getGrantPrincipal in interface IGrantable

getJobArn

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

(experimental) The ARN of the job.

Specified by:

getJobArn in interface IJob

getJobName

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

(experimental) The name of the job.

Specified by:

getJobName in interface IJob

getRole

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

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

getSparkUILoggingLocation

@Stability(value=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