Skip To Content

计划笔记本任务

从 10.8.1 开始,您可以创建任务以计划笔记本的自动执行。 每次根据您所设置的计划执行笔记本时,站点都会打开一个新容器并在无用户控制的情况下运行笔记本。

您可以从笔记本编辑器的任务窗格中创建一个或多个已计划任务以运行笔记本。 您可以将其计划为在将来运行一次或定期运行(可在每分钟一次到每五个月一次之间随意选择)。

如果要准备自动执行的笔记本(例如定期执行),则需要牢记一些注意事项。

准备笔记本

该计划程序提供在执行时将参数插入为新单元格的选项,例如帐户凭据或要定义的变量。

此操作将使用标签单元格工具栏选项,使您能够创建并管理笔记本工作空间中的每个单元格的标签。 您可以单击查看并选择单元格工具栏来更改单元格工具栏选项。

您可以通过在 notebook 中的单元格添加标签 injected-parameters 的方式,指定 notebook 中添加此新单元格的位置。 新单元格将插入在此单元格之后。 该操作只识别具有 injected-parameters 标签的一个单元格。

内容注意事项

除了可以插入的参数单元格外,计划笔记本操作不支持用户与笔记本之间进行任何交互。 避免在笔记本运行时添加任何需要用户交互的内容,例如单击地图上的某个点。

如上所示,必须将要在自动执行时添加的所有凭据或新变量插入参数单元格中。 确保您的笔记本中不包含任何会阻止笔记本完成的内容。

创建任务

准备好笔记本后,您可以创建任务以计划其执行情况。 您可以使用笔记本编辑器中的任务窗格创建一个或多个任务以自动执行笔记本,并指定任务的计划。

  1. 如果还没有保存笔记本,则请创建一个标题并保存笔记本。

    任务按钮在笔记本编辑器的顶部功能区中变为可用状态。

  2. 请单击创建任务以打开对话框。

    注:
    您也可以通过笔记本项目详细信息页面上的任务选项卡来创建任务。

  3. 标题文本框中提供一个标题以描述您的任务计划,例如 Weekly data cleaning run
  4. 如果在笔记本任务执行过程中您希望将任何参数添加到笔记本中,则请在参数部分中提供这些参数。 在密钥设置中提供一个密钥,在设置中为每个参数提供配对值,然后单击添加参数以保存参数。

    添加至少一个参数后,将参数保存至笔记本选项随即出现。 如果选择已启用,则在运行时,随新参数插入的单元格将被保存到笔记本中。

  5. 单击下一步移至设置任务计划详细信息页面。

    在这里,您可以指定此任务的特定计划。

    提示:
    当您更改重复频率的值时,以下选项将发生更改以适应该值。 例如,如果您选择每天重复,则一周的每一天都会出现这些复选框。

  6. 如果要使用每次运行的结果来更新笔记本,请保持选择完成时更新项目选项。 如果您不希望笔记本自动更新,则请取消选择该选项。
  7. 当您对标题、可选参数和任务计划感到满意时,请单击创建任务

    该任务随即激活,并根据您设置的计划执行笔记本。

如果您希望设置多个计划,且有可能插入不同的参数,则可以使用相同的工作流为笔记本创建更多任务。

使用现有任务

为笔记本创建任务后,您可以随时查看任务的详细信息并进行编辑或删除。 您可以从笔记本编辑器的任务窗格或笔记本项目详细信息页面的任务选项卡对任务进行更改。 在这两个位置中,您可以查看笔记本的所有任务及各个任务的创建时间、上次修改时间和当前状态。

  1. 在笔记本编辑器的顶部功能区上,单击任务
  2. 计划任务部分,查找您想要使用的任务。
  3. 单击任务旁边的操作 操作,然后执行以下任意操作:
    • 单击详细信息以查看每个任务单独运行的结果。
    • 单击编辑以更改标题、参数或任务计划。
    • 单击暂停以暂停活动的任务。 暂停时,单击恢复以恢复任务。
    • 单击删除以移除任务。
      注:

      删除任务的同时也会删除该任务的运行历史记录。 要保留活动任务的历史记录,请考虑暂停任务以停止进一步运行。

更改笔记本的所有权将同时更改该笔记本任务的所有权。 任务将以非活动状态转移到新用户。 新所有者可以在笔记本编辑器的任务窗格中启用这些任务,也可以在笔记本项目详细信息页的任务选项卡中启用。