Configure Jobs

This section covers configuring jobs and job runs in your AI Data Platform.

Topics:

• About Jobs
• Create a Job
• Change Job Location
• Delete a Job
• Schedule a Job Using a Calendar
• Schedule a Job Using a Cron Expression
• Run a Workflow on Demand
• Run a Workflow Job from the Jobs Page
• Change a Job Run Schedule
• Pause or Activate a Job Run Schedule

About Jobs

You create workflows for your data by constructing jobs.

You can track and manage all jobs in your AI Data Platform from the Jobs tab in the Workflow home page. From the Jobs Run tab you can see job history and the status of runs currently in progress.

Jobs are way of organizing and orchestrating groups of tasks as part of workflow. You can use workflows for common data processing, such as ETL workflows, Python scripting, running notebooks, and machine learning.

Jobs can vary in complexity. One job may have only a single task that runs a notebook, while another has more than a hundred tasks and nested jobs carrying out complex tasks with multiple conditions and dependencies.

Running a job starts the tasks inside with the sequences and conditions you specified. Jobs can even be nested inside of other jobs, embedding their sequence of tasks as a single node.

Every job run generates a job file that is stored in a user-specified location during job creation. This job file acts as a reference for managing and tracking job executions. You can run, schedule, and view the JSON representation of the job directly from the file in the workspace, ensuring transparency and reproducibility. This approach allows seamless job monitoring, versioning, and integration within automated workflows.

Jobs can configured to run on a calendar schedule, scheduled to run based on a cron expression, or run immediately.

Create a Job

You need to create a job to begin using workflows in Oracle AI Data Platform.

1. Navigate to your workspace and click Workflow.
2. On the Jobs tab, click Create Job. You can also click Create Job on the top right.
   
   

   

   
   
3. Provide a name and description for your job.
4. Click Browse and select the location to save the job in your AI Data Platform. Click Select.
5. Enter a number for Max Concurrent Runs.
6. Click Create.

Change Job Location

You can change the location of a job after creation.

1. On the Home page, click Workflow.
2. Click the job you want to change the location for.
3. Click the Details tab.
4. Next to Location, click Browse.
5. Pick a new location for the job and click Select.

Delete a Job

You can delete jobs that you no longer need.

1. Navigate to your workspace and click Workflows.
2. Next to the job you want to delete click Options then click Delete.
3. Click Delete.

Schedule a Job Using a Calendar

Workflow jobs can be scheduled to run on an automated basis.

1. On the Home page, click Workflow.
2. Click the job you want to make a schedule for.
3. Click the Details tab.
4. Next to schedule, click Add.
5. Choose whether your schedule begins as Active or Paused.
   • Select Active if you want the schedule in effect immediately.
   • Select Paused if you want to activate the schedule at a later time.
6. Select the Time Zone the schedule uses as a basis.
7. From Schedule Type, select Calendar.
8. Select whether the schedule will be run hourly, daily, weekly, or monthly. You need to provide additional information for Hourly, Weekly, and Monthly options.
   • For Hourly, select the hours on which the schedule repeats.
   • For Weekly, select the days of the week the schedule repeats.
   • For Monthly, select the days of the month the schedule repeats.
9. Enter the time of day the schedule runs. The time of day is in 24 hour format, beginning at 00:00 and ending at 23:59.
10. Check the listed run time at the bottom to confirm your schedule is correct. Click Create.

Schedule a Job Using a Cron Expression

Workflow jobs can be scheduled to run on an automated basis using cron expressions to determine date and times.

1. On the Home page, click Workflow.
2. Click the job you want to make a schedule for.
3. Click the Details tab.
4. Next to schedule, click Add.
5. Choose whether your schedule begins as Active or Paused.
   • Select Active if you want the schedule in effect immediately.
   • Select Paused if you want to activate the schedule at a later time.
6. Select the Time Zone the schedule uses as a basis.
7. From Schedule Type, select Cron Expression.
8. Enter the cron expression.
9. Check the listed run time at the bottom to confirm your schedule is correct. Click Create.

Run a Workflow on Demand

You can choose to run a workflow job immediately.

1. On the Home page, click Workflow.
2. Click on the job you want to run.
3. Click Run Now.

Run a Workflow Job from the Jobs Page

You can quickly run listed jobs directly from the Jobs page.

1. On the home page, click Workflow.
2. In the Jobs tab, next to the listed job you want to run, click Run Now.
   
   

   

   
   

Change a Job Run Schedule

You can edit the schedule of a job run after creation to modify time, timezone, or frequency of that schedule.

1. On the Home page, click Workflow.
2. Click the job you want to make a schedule for.
3. Click the Details tab.
4. Next your schedule, click Edit.
5. Modify the schedule as needed. Check the listed run time at the bottom to confirm your schedule is correct.
6. Click Save.

Pause or Activate a Job Run Schedule

After setting a schedule for a job run you can choose to pause it then reactivate when needed.

1. On the Home page, click Workflow.
2. Click the job you want to make a schedule for.
3. Click the Details tab.
4. Next to your schedule click to Pause or Activate your schedule.
   The option displayed is dependent on the current status of the schedule. If active, Pause is displayed. If paused, Activate is displayed.

Repair Failed Job Runs

You can attempt to repair a run that has failed by reviewing the timeline and details and rerunning the job with optional parameters to assist your diagnostic.

1. Navigate to your workflow.
2. Click Job Runs.
3. Next to the failed job run, click Actions and click Repair run.
4. Review the task details to determine possible causes of failure.
5. Click Repair run and select which tasks to rerun.
6. Add optional parameters that will only apply to this repair run.
   • If you select Key/Value as the Parameter type, click Add and enter parameters.
   • If you select JSON, enter parameter values in the space provided.
7. Click Run repair.