开始使用 Streamlit in Snowflake¶

本主题将引导您完成使用容器运行时，在五分钟内完成第一个 Streamlit in Snowflake 应用程序的部署。之后，会使用两个实践示例向您展示如何构建查询数据的真实应用程序，为每个查看者提供个性化体验并写回 Snowflake。

先决条件¶

在创建 Streamlit 应用程序之前，请确保管理员已完成针对 Streamlit 应用程序的基本安全设置。

您的角色必须拥有以下权限：


权限	对象	备注
USAGE	在其中创建 Streamlit 应用程序的数据库的权限
CREATE STREAMLIT USAGE	在其中创建 Streamlit 应用程序的架构的权限
USAGE	运行 Streamlit 应用程序的计算池	对于所有账户，Snowflake 都会配置一个普通用户有访问权限的通用计算池。有关更多信息，请参阅 Configuring your own preferred compute pools for Streamlit apps。
USAGE	用于在 Streamlit 应用程序中运行查询的仓库的权限

有关更多信息，请参阅创建和使用 Streamlit 应用程序所需的权限。

部署首个 Streamlit in Snowflake 应用程序¶

最快速的入门方式是使用默认的入门代码创建一个 Streamlit 应用。当您在不指定源文件的情况下创建应用程序时，Snowflake 会自动提供示例代码。

登录 Snowsight。
在导航菜单中，选择 Projects » Streamlit。
选择 + Streamlit App。
输入应用程序的名称。
选择要在其中创建应用程序的数据库和架构。
选择 Run on container。
选择计算池和查询仓库。
选择 Create。

Snowsight 会将您重定向到应用程序编辑器。您的应用程序将在几分钟内准备就绪。然后，您可以立即查看并编辑它。

在 SQL 会话中，运行以下 SQL 命令：

CREATE STREAMLIT my_first_app
   RUNTIME_NAME = 'SYSTEM$ST_CONTAINER_RUNTIME_PY3_11'
   COMPUTE_POOL = my_compute_pool
   QUERY_WAREHOUSE = my_warehouse;

ALTER STREAMLIT my_first_app ADD LIVE VERSION FROM LAST;

要查看应用程序，请登录 Snowsight，在导航菜单中选择 Projects » Streamlit，然后选择您的应用程序。

备注

需要 Snowflake CLI 3.14.0 或更高版本。3.14+ 版本默认使用现代 CREATE STREAMLIT 语法。

初始化一个新的 Streamlit 项目：
```
snow init my_first_app --template example_streamlit
```
导航到项目目录：
```
cd my_first_app
```

编辑 snowflake.yml 文件以使用容器运行时：

definition_version: 2
entities:
   my_streamlit:
      type: streamlit
      identifier: my_first_app
      query_warehouse: my_warehouse
      compute_pool: my_compute_pool
      runtime_name: SYSTEM$ST_CONTAINER_RUNTIME_PY3_11
      main_file: streamlit_app.py
      artifacts:
      - streamlit_app.py

部署应用程序并在浏览器中打开它：
```
snow streamlit deploy --open
```

编辑应用程序¶

部署后，您可以编辑应用程序代码以对其进行自定义。快速测试方法如下：

登录 Snowsight。
在导航菜单中选择 Projects » Streamlit，然后选择应用程序。
选择 Edit。
修改 streamlit_app.py 中的代码。
选择 Run 以查看更改。

获取应用程序的源位置：
```
DESCRIBE STREAMLIT my_first_app;
```

将更新后的文件复制到该位置：

COPY FILES INTO '<live_version_location_uri>' FROM @my_stage FILES = ('streamlit_app.py');

在本地项目目录中编辑 streamlit_app.py。
重新部署：
```
snow streamlit deploy --replace
```

有关更多信息，请参阅编辑 Streamlit 应用程序。

下一步是什么？¶

现在您已经有了一个正在运行的应用程序，请尝试以下实践示例之一：

示例：构建个性化数据仪表板：选择使用时默认使用的角色和仓库。构建一个仪表板，用于查询 Snowflake 数据并使用 st.connection 和 st.user 为每个查看器提供个性化显示：
示例：构建写入 Snowflake 的表单：选择使用时默认使用的角色和仓库。构建一个将用户输入写回 Snowflake 表的表单，演示 st.form、依赖项管理，以及 st.user。

要了解有关特定主题的更多信息，请执行以下操作：

创建 Streamlit 应用程序：选择使用时默认使用的角色和仓库。有关通过 Snowsight、SQL，或 CLI 创建应用程序的详细说明。
管理 Streamlit 应用程序的依赖项：选择使用时默认使用的角色和仓库。将 Python 包添加到应用程序中。
Streamlit 应用程序的运行时环境：选择使用时默认使用的角色和仓库。了解容器和仓库运行时。
Streamlit in Snowflake 中的外部网络访问：选择使用时默认使用的角色和仓库。将应用程序连接到外部服务。