设置 Snowflake Notebooks¶

位置¶

位置是指存储笔记本对象的地方。最终用户可以查询其角色有权限访问的任何数据库和架构。

• 要将上下文切换到不同的数据库或模式，可以在 SQL 单元格中使用 USE DATABASE 或 USE SCHEMA 命令。

在容器运行时中，创建笔记本的角色还需要具有架构的 CREATE SERVICE 权限。

拥有架构的角色自动具有在该架构下创建笔记本的权限，因为所有者可以创建任何类型的对象，包括笔记本。

允许所有人在特定位置创建笔记本¶

以下步骤概述了如何通过授予对数据库和架构的使用权限来配置在特定位置创建笔记本的访问权限。

将 <database> 和 <database.schema> 替换为要在其中创建笔记本的特定数据库和架构：

----------------------------------
--       Location Setup         --
----------------------------------
GRANT USAGE ON DATABASE <database> TO ROLE PUBLIC;
GRANT USAGE ON SCHEMA <database.schema> TO ROLE PUBLIC;
GRANT CREATE NOTEBOOK ON SCHEMA <database.schema> TO ROLE PUBLIC;

----------------------------------
--    Compute Resource Setup    --
----------------------------------
GRANT USAGE ON WAREHOUSE <warehouse> TO ROLE PUBLIC;

-------------------------------------
-- Optional: External Access --
-------------------------------------

-- Example EAI
CREATE OR REPLACE NETWORK RULE allow_all_rule
MODE = 'EGRESS'
TYPE = 'HOST_PORT'
VALUE_LIST = ('0.0.0.0:443','0.0.0.0:80');

CREATE OR REPLACE EXTERNAL ACCESS INTEGRATION allow_all_integration
ALLOWED_NETWORK_RULES = (allow_all_rule)
ENABLED = true;

GRANT USAGE ON INTEGRATION allow_all_integration TO ROLE PUBLIC;

创建专用角色¶

如果您只希望特定用户创建笔记本（假设他们还没有 OWN 任何架构），您可以创建一个专用角色来控制访问权限。例如：

CREATE ROLE notebooks_rl;

将 ROLE notebook_rl 授予特定用户。然后，使用上述脚本为该角色创建资源并授予权限（将 ROLE PUBLIC 替换为 ROLE notebook_rl）。

笔记本引擎¶

笔记本引擎（“内核”）和 Python 进程在笔记本仓库上运行。Snowflake 建议您一开始先使用“X-小”仓库，以尽量减少 Credit 消耗。

当您使用笔记本时（例如，编辑代码、运行、重新排序或删除单元格），或者如果笔记本在其空闲超时设置内保持活动状态，将持续运行 EXECUTE NOTEBOOK 查询，以指示笔记本引擎处于活动状态，并且正在使用笔记本会话。您可以在 Query history 中查看该查询的状态。EXECUTE NOTEBOOK 运行时，笔记本仓库也在运行。当 EXECUTE NOTEBOOK 结束时，如果仓库中没有其他查询或任务在运行，它将根据自动暂停策略关闭。

要结束 EXECUTE NOTEBOOK 查询（结束笔记本会话），请按照以下步骤操作：

1. 选择 Active 或从 Active 下拉菜单中选择 End session。

2. 在 Query history 中，找到相应的 EXECUTE NOTEBOOK 查询并选择 Cancel query。

3. 根据笔记本的闲置时间设置，让笔记本因闲置而超时。如果笔记本仓库的 STATEMENT_TIMEOUT_IN_SECONDS 和 STATEMENT_QUEUED_TIMEOUT_IN_SECONDS 参数的值设置得较小，笔记本可能会迅速关闭或无法启动，无论用户是否进行操作。

查询¶

SQL 和 Snowpark 查询（例如，session.sql）会下推到按需使用的查询仓库。当 SQL 和 Snowpark 查询完成运行后，如果没有其他作业在其上运行，查询仓库会挂起。请选择适合您查询性能需求的仓库大小。例如，如果需要运行大规模的 SQL 查询或进行计算密集型操作（如使用 Snowpark Python 的计算任务），您可能需要选择更大的仓库。对于需要大量内存的操作，考虑使用 经过优化的 Snowpark 仓库。

您可以在 Notebook Settings 中更改查询仓库。或者，您也可以在笔记本中的任何 SQL 单元格运行以下命令，以更改当前笔记本会话中所有后续查询的查询仓库：

USE WAREHOUSE <warehouse_name>;

空闲时间和重新连接¶

只要没有用户活动（例如编辑代码、运行单元格、重新排序单元格或删除单元格），空闲时间就会累积。每次恢复活动时，空闲时间都会重置。空闲时间达到超时设置后，笔记本会话将自动关闭。

默认情况下，笔记本在闲置 60 分钟（3,600 秒）后会进入暂停状态。您可以将空闲超时设为最大 72 小时（259,200 秒）。要更新空闲超时设置，请使用 CREATE NOTEBOOK 或 ALTER NOTEBOOK 命令来设置 IDLE_AUTO_SHUTDOWN_TIME_SECONDS 属性的值。

1. 登录 Snowsight。

2. 选择 Projects » Notebooks。

3. 选择垂直省略号 菜单配置新时间。

4. 选择 Notebook settings。

5. 手动重新启动会话以使新的空闲时间生效。

在闲置超时之前，即使您刷新页面、访问 Snowsight 的其他部分或关闭或休眠计算机，您的笔记本会话仍将保持活动状态，直到达到闲置超时时间。当您重新打开相同的笔记本时，您会重新连接到同一个会话，并且所有会话状态和变量都会保留，让您能够无缝继续工作。但请注意，Streamlit 小部件的状态将不会保留。

运行同一笔记本的每个用户都有自己独立的会话。它们互不干扰。

优化成本的建议¶

作为账户管理员，请考虑以下建议来控制运行笔记本的成本：

• 要求您的团队使用相同的仓库（建议使用“X-小”）作为专用的“笔记本仓库”来运行笔记本会话，以增加并发性。请注意，如果要同时执行的笔记本数量过多，可能会导致会话启动速度变慢（在仓库中排队）或内存不足错误。

• 允许团队使用 STATEMENT_TIMEOUT_IN_SECONDS 值较低的仓库来运行笔记本。该仓库参数控制任何查询（包括笔记本会话）可以持续多长时间。例如，如果将该参数设置为 10 分钟，则不论用户是否在笔记本会话中活动，笔记本会话最大可以运行 10 分钟。

• 要求团队在不打算在会话中继续活跃工作的情况下结束笔记本会话。

• 如果团队不需要长时间运行会话，请将空闲超时设置降至最低（例如 15 分钟）。

• 或者，提交支持工单，设置适用于整个账户的空闲时间默认值。笔记本所有者仍可在笔记本级别覆盖该值。