使用 SQL 创建 Streamlit 应用程序¶

在本地文件系统上创建 Streamlit 文件¶

本部分介绍如何创建单页面或多页面 Streamlit 应用程序。有关每种应用类型的示例，请参阅 示例 – 单页面 Streamlit 应用程序 和 示例 – 多页面 Streamlit 应用程序。

要为 Streamlit 应用程序创建文件，请执行以下步骤：

1. 在本地文件系统上， ` 创建 Streamlit 主应用程序 <https://docs.streamlit.io/library/get-started/create-an-app (https://docs.streamlit.io/library/get-started/create-an-app)>`_。

2. 可选：如果正在创建 ` 多页面 Streamlit 应用程序 <https://docs.streamlit.io/library/get-started/multipage-apps/create-a-multipage-app (https://docs.streamlit.io/library/get-started/multipage-apps/create-a-multipage-app)>`_，请在本地文件系统上创建一个名为 pages 的文件夹，然后将其他 Streamlit 页面添加到此子文件夹。

3. 可选：要在 Streamlit 应用程序中包含外部包，请创建一个 environment.yml 文件。有关包含外部包的详细信息，请参阅 使用 environment.yml 文件来安装包。

创建 Streamlit 页面后，目录结构应类似于：

└── streamlit/
    └── environment.yml
    └── streamlit_main.py
    └── pages/
         └── data_frame_demo.py
         └── plot_demo.py

将 Streamlit 文件上传到命名暂存区¶

要在 Streamlit in Snowflake 内创建 Streamlit 应用程序，必须将应用程序文件上传至命名暂存区。

要上传应用程序文件，请执行以下操作之一：

• 使用 Snowsight 上传应用程序文件，如 使用 Snowsight 暂存文件 中所述。

• 使用 SnowSQL 上传应用程序文件，如下例所示：

  PUT file:///<path_to_your_root_folder>/streamlit/streamlit_main.py @streamlit_db.streamlit_schema.streamlit_stage overwrite=true auto_compress=false;
  PUT file:///<path_to_your_root_folder>/streamlit/environment.yml @streamlit_db.streamlit_schema.streamlit_stage overwrite=true auto_compress=false;
  PUT file:///<path_to_your_root_folder>/streamlit/pages/streamlit_page_2.py @streamlit_db.streamlit_schema.streamlit_stage/pages/ overwrite=true auto_compress=false;
  PUT file:///<path_to_your_root_folder>/streamlit/pages/streamlit_page_3.py @streamlit_db.streamlit_schema.streamlit_stage/pages/ overwrite=true auto_compress=false;
  

  Copy

创建 STREAMLIT 对象¶

STREAMLIT 对象是 Snowflake 中的数据库对象，它封装了 Streamlit 应用程序所需的文件。

1. 要创建 STREAMLIT 对象，请运行 CREATE STREAMLIT 命令，如下例所示：

   CREATE STREAMLIT hello_streamlit
   ROOT_LOCATION = '@streamlit_db.streamlit_schema.streamlit_stage'
   MAIN_FILE = '/streamlit_main.py'
   QUERY_WAREHOUSE = my_warehouse;
   

   Copy

   此命令根据在 ROOT_LOCATION 和 MAIN_FILE 中指定的路径和文件，创建一个名为 hello_streamlit 的 STREAMLIT 对象。

   备注

   虽然 QUERY_WAREHOUSE 子句是可选的，但必须指定查询仓库才能在 Snowflake 中运行 Streamlit 应用程序。

2. 要验证 Streamlit 对象是否已创建，请运行 SHOW STREAMLITS 命令，如下例所示：

   SHOW STREAMLITS;
   

   Copy

重命名 STREAMLIT 对象¶

要重命名 STREAMLIT 对象，请使用 ALTER STREAMLIT 命令的 RENAME TO 子句，如下例所示：

ALTER STREAMLIT hello_streamlit RENAME TO hello_snowflake;

Copy

更改 STREAMLIT 对象中的暂存区或主文件¶

要更改 STREAMLIT 对象的暂存区的路径，请使用 ALTER STREAMLIT 命令来设置该对象的 ROOT_LOCATION 属性，如下例所示：

ALTER STREAMLIT hello_streamlit SET ROOT_LOCATION = '@snowflake_db.snowflake_schema.snowflake_stage'

Copy

要更改 STREAMLIT 对象中的 Streamlit 主文件，请使用 ALTER STREAMLIT 命令来设置该对象的 MAIN_FILE 属性，如下例所示：

ALTER STREAMLIT hello_streamlit SET MAIN_FILE = 'snowflake_main.py'

Copy

更改分配给 STREAMLIT 对象的查询仓库¶

要为 STREAMLIT 对象添加查询仓库或更改当前查询仓库，请使用 ALTER STREAMLIT 命令来设置对象的 QUERY_WAREHOUSE 属性，如下例所示：

ALTER STREAMLIT hello_streamlit SET QUERY_WAREHOUSE = my_new_warehouse;

Copy