使用 Snowsight 创建和查看 Streamlit 应用程序¶
注意
此功能适用于 AWS、Microsoft Azure 和 GCP 区域 的账户。不支持 AWS PrivateLink 和 Azure 专用链接。
Streamlit in Snowflake 在 Snowsight 中提供了 Python 编辑器,可让您编写、编辑和运行 Streamlit 应用程序的代码。该编辑器提供自动补全功能,并显示 Streamlit 和 Snowpark 函数的文档。
备注
可以使用 Snowsight 创建单页面 Streamlit 应用程序,但要部署多页面 Streamlit 应用程序,则必须使用 SQL 命令。有关详细信息,请参阅 使用 SQL 创建 Streamlit 应用程序。
部署 Streamlit 应用程序后,可以在 Snowsight 中查看多页面应用程序。有关更多信息,请参阅 查看 Streamlit 应用程序。
使用 Snowsight 创建 Streamlit 应用程序¶
在使用 Snowsight 创建 Streamlit 应用程序之前,应满足以下先决条件:
确保您的账户具有正确的权限,如 创建和使用 Streamlit 应用程序所需的权限 中所述。
要创建 Streamlit 应用程序,请执行以下步骤:
以特定用户身份登录 Snowsight,该用户对您要在其中创建应用程序的架构具有 CREATE STREAMLIT 权限。
在左侧导航栏中,选择 Projects » Streamlit。
选择 + Streamlit。
此时 Create Streamlit App 窗口将打开。
输入应用程序的名称。
在 Warehouse 下拉列表中,选择要在其中运行应用程序和执行查询的仓库。
在 App location 下拉列表中,选择应用程序的数据库和架构。
选择 Create。
Streamlit in Snowflake 编辑器会在查看器模式下打开一个示例 Streamlit 应用程序。查看器模式允许您查看 Streamlit 应用程序将如何向用户显示。
Streamlit in Snowflake 界面分为三个窗格:
对象浏览器:允许您查看您有权访问的数据库、架构和视图。
Streamlit 编辑器:提供用于编辑 Streamlit 代码的 Python 编辑器。
Streamlit 预览:显示正在运行的 Streamlit 应用程序。
默认情况下,仅显示 Streamlit 编辑器和预览窗格。要更改此显示,请使用 Snowflake 中的 Streamlit 编辑器左下角的显示/隐藏按钮。
在 Streamlit in Snowflake 中运行 Streamlit 应用程序¶
要运行 Streamlit 应用程序,请选择 Run 以更新 Streamlit 预览窗格中的内容。
管理 Streamlit 应用程序的包¶
可以通过使用 Snowsight 中的 Streamlit 编辑器,查看、添加和移除 Streamlit 应用程序的外部 Python 包。
查看为 Streamlit 应用程序安装的包¶
要查看为 Streamlit 应用程序安装的包,请执行以下步骤:
以具有 CREATE STREAMLIT 权限的用户身份登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要查看其包的 Streamlit 应用程序。
在 Streamlit 编辑器的顶部,选择 Packages。
Snowsight 会显示已安装包的列表。
将受支持的 Python 包添加到 Streamlit 应用程序中¶
默认情况下, Streamlit in Snowflake 会在环境中安装 python
、snowflake-snowpark
和 streamlit
包。可以使用 Snowsight 添加其他包。请参阅 ` Snowflake Anaconda 通道 <https://repo.anaconda.com/pkgs/snowflake/ (https://repo.anaconda.com/pkgs/snowflake/)>`_,了解受支持的包列表。
要将受支持的 Python 包添加到 Streamlit 应用程序中,请执行以下步骤:
以具有 CREATE STREAMLIT 权限的用户身份登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要添加 Python 包的 Streamlit 应用程序。
在 Streamlit 编辑器的顶部,选择 Packages。
在搜索文本字段中,从支持的包列表中选择一个包,或输入包的名称。
从 Streamlit 应用程序中移除包¶
要从 Streamlit 应用程序中移除包,请执行以下步骤:
以具有 CREATE STREAMLIT 权限的用户身份登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要从中移除 Python 包的 Streamlit 应用程序。
在 Streamlit 编辑器的顶部,选择 Packages。
选择要移除的包旁边的 x 图标。
备注
默认情况下会安装 python
、snowflake-snowpark
和 streamlit
包,并且无法移除这些包。
查看 Streamlit 应用程序¶
有关查看 Streamlit 应用程序所需的权限的信息,请参阅 查看 Streamlit 应用程序所需的权限。
要查看 Streamlit 应用程序,请执行以下步骤:
登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要查看的 Streamlit 应用程序。
Streamlit 主应用程序将在 Snowflake 中的 Streamlit 查看器中打开。
可选:如果正在查看多页面 Streamlit 应用程序,请选择一个选项卡以查看其他页面。
管理 Streamlit 应用程序¶
创建 Streamlit 应用程序后,可以执行以下部分中描述的其他相关任务。
编辑 Streamlit 应用程序¶
要编辑 Streamlit 应用程序,请执行以下步骤:
登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要编辑的 Streamlit 应用程序。
Streamlit 主应用程序将在 Snowflake 中的 Streamlit 查看器中打开。
选择 Edit。
Streamlit 编辑器随即打开。
更新应用程序代码。
要查看对应用程序所做的变更,请选择 Run。
重命名 Streamlit 应用程序¶
要重命名 Streamlit 应用程序,请执行以下步骤:
以具有 CREATE STREAMLIT 权限的用户身份登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要重命名的 Streamlit 应用程序。
选择 Edit。
在左上角选择该应用程序的名称。
在文本框中输入新名称。
在文本框外部点击以提交变更。
更改 Streamlit 应用程序的仓库¶
在开发、测试和运行 Streamlit 应用程序时,可能需要修改用于运行应用程序和查询的仓库。例如,可能需要使用容量更大的仓库来处理应用程序运行的查询。
要更改 Streamlit 应用程序的仓库,请执行以下步骤:
以具有 CREATE STREAMLIT 权限的用户身份登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要更改其仓库的 Streamlit 应用程序。
在左上角选择该应用程序的名称。
从下拉列表中选择新仓库。
删除 Streamlit 应用程序¶
删除 Streamlit 应用程序会将其从 Snowflake 中永久移除。与之共享该应用程序的任何用户都将无法再查看该 Streamlit 应用程序和与之交互。在删除 Streamlit 应用程序之前,请确保已将应用程序代码保存在 Snowflake 之外。
要删除 Streamlit 应用程序,请执行以下步骤:
以具有 CREATE STREAMLIT 权限的用户身份登录 Snowsight。
在导航菜单中,选择 Projects » Streamlit。
选择要删除的 Streamlit 应用程序。
选择 Edit。
在左上角选择该应用程序的名称。
选择 Delete,然后选择 Delete App。
Snowflake 将删除 Streamlit 应用程序,并显示可用应用程序的更新列表。