在声明式共享原生应用程序中编辑笔记本

Declarative Native Apps can include notebooks to query, visualize, and explore the data. This topic describes how to use Notebook Live Editing to streamline the development and testing of notebooks within an application.

使用 Notebook Live Editing 功能，您可以直接在应用程序中编辑和测试笔记本，从而加快开发过程。这样一来，您就不必在外部开发笔记本，也不必为每次变更都重新构建应用程序包。

Notebook Live Editing 使用 开发模式，允许您在应用程序实例内“实时”更改笔记本。您的编辑将保存到应用程序包的专用实时版本中，以便进行快速的动态测试和迭代。

工作原理

该工作流程使用应用程序包的实时版本，该版本充当开发沙盒。本教程介绍如何设置和使用 Notebook Live Editing 功能。

第 1 步：设置开发环境

首先，您需要一个包含以下内容的包：

  • 定义应用程序及其组件的清单文件。

  • 您可以编辑和测试的笔记本。

然后，您可以从包的实时版本创建应用程序实例。创建应用程序时会自动创建实时版本。

  1. 构建包。

    ALTER APPLICATION PACKAGE pkg_name BUILD;
    Copy

  2. 从实时版本创建应用程序实例。此新应用程序中的笔记本将自动处于 开发模式，允许实时编辑。在此步骤之前，应用程序中的笔记本处于 只读模式。

    CREATE APPLICATION live_app_name
  FROM APPLICATION PACKAGE pkg_name
  USING VERSION LIVE;
    Copy

第 2 步：实时编辑和测试笔记本

您的 live_app_name 应用程序正在运行时，在 SnowSight 中，从您账户中的应用程序列表中打开您的应用程序，然后从其列表页面打开其中一个笔记本。在上一步中从应用程序包创建应用程序后，应用程序的笔记本将处于 开发者模式。您现在可以执行以下操作：

  • 直接在浏览器中编辑笔记本单元格。

  • 在应用程序的上下文中立即运行和测试代码。

您所做的任何变更都会立即保存到 pkg_name 应用程序包。这使您可以快速迭代对应用程序的变更，而无需为每个细微调整执行完整的包构建。

第 3 步：完成并发布变更

对笔记本的状态感到满意后，可以将实时版本提升为稳定版本。这将冻结笔记本的当前状态，并使它们成为永久应用程序版本的一部分。应用程序框架会自动为您的版本创建版本号。

  • 发布实时版本以完成您的工作。

ALTER APPLICATION PACKAGE pkg_name RELEASE LIVE VERSION;
Copy

此命令会创建应用程序包的新不可变版本，其中包含您所做的所有笔记本变更。有关应用程序包和实时版本的更多信息，请参阅 Native Application Framework 的声明式共享中的应用程序包。

语言: 中文