The jobs pane allows you to run statements on a schedule. These scheduled statements are known as jobs. You can schedule SQL jobs or Materialized view refresh jobs.
SQL job scheduling is best suited for data maintenance statements, such as
CREATE
, DROP
, REFRESH
, MERGE
and TRUNCATE
. Statements that return
results are not supported, which excludes statements that begin with SELECT
;
however SELECT
as part of a statement is supported.
Materialized view refresh is only available to object storage catalogs.
The SQL tab is where you create, view, search for, and manage SQL jobs.
All of the SQL jobs you create are displayed in a list, and each job in the list includes the following columns:
Next run starts: The next date and time the SQL job is scheduled to start running. If the schedule is paused, the status of the schedule also appears here.
To run a statement on a recurring schedule, click Create SQL job, then provide the following information in the New SQL Job dialog:
In the Name and description section, enter a name for the job and a useful description.
In the Query section:
Expand the first drop-down menu, and choose a cluster to run the statement on. We recommend using a fault tolerant cluster.
From the drop-down menu, select a role to run the statement. The role must have the MANAGE_SECURITY privilege.
Enter the statement you want to run.
In the Schedule section:
Choose a time zone from the drop-down menu.
Choose the Select frequency or Enter cron expression recurring
interval format.
For Select frequency: Choose an hourly, daily, weekly, monthly, or annual schedule from the drop-down menu. The corresponding values depend on the schedule selected:
hh:mm
, then specify AM or PM.hh:mm
, specify AM or PM, then
select a day of the week.hh:mm
, specify AM or PM, then
select a date.MM/DD
hh:mm
. Specify AM or PM.For Enter cron expression: Enter the desired schedule in the form of a cron expression. For example, a SQL job run weekly at 9:30 AM on Monday, Wednesday, and Friday:
30 9 * * 1,3,5
Click Create SQL job.
To view the details of a SQL job, click the name of the job. The header of the Job details pane displays the following information about your SQL job:
Run now allows you to run the SQL job instantly.
Completed statements and statements in progress appear in the Job history section, which displays the following information:
To see statement details, click the Query ID.
You can manage SQL jobs in the SQL jobs pane and Job details pane. Click themore_vertoptions menu to edit, delete, pause, or resume the selected SQL job.
The Materialized view refresh tab is where you create, view, search for, and manage materialized view refresh jobs.
All of the materialized view refresh jobs you create are displayed in a list, and each job in the list includes the following columns:
Next run starts: The next date and time the materialized view refresh job is scheduled to start running. If the schedule is paused, the status of the schedule also appears here.
Follow these steps to create a materialized view refresh job:
refresh_schedule
property.CREATE MATERIALIZED VIEW my_refresh_materialization
WITH (
refresh_schedule = '0 0 1 * *'
) AS
SELECT *
FROM lakehouse.burst_bank.customer
Runs that are completed successfully appear automatically on the Materialized refresh view tab.
To make changes to a materialized view refresh job, use the ALTER MATERIALIZED VIEW statement.
To drop a materialized view refresh job, use the DROP MATERIALIZED VIEW statement.
To view the details of a materialized view refresh job, click the name of the job. The header of the Job details pane displays the following information about your materialized view refresh job:
Run now allows you to run the materialized view refresh job instantly.
Completed statements and statements in progress appear in the Job history section, which displays the following information:
To see statement details, click the Query ID.
You can manage materialized view refresh jobs in the Materialized view refresh jobs pane and Job details pane. Click themore_vertoptions menu to edit, delete, pause, or resume the selected SQL job.
Is the information on this page helpful?
Yes
No