设置 Snowflake Notebooks¶

查看账户和部署要求¶

确保 *.snowflake.app 在您网络（包括内容筛选系统）的允许列表中，并且可以连接到 Snowflake。当此域列入允许列表时，您的应用程序可以不受任何限制地与 Snowflake 服务器通信。

此外，为防止连接到 Snowflake 后端出现任何问题，请确保网络配置中未阻止 WebSockets。

接受 Anaconda 条款以导入库¶

在开始使用 Snowflake 中的 Anaconda 提供的包之前，您必须确认 外部产品条款。

1. 登录 Snowsight。

2. 选择 Admin » Billing & Terms。

3. 在 Anaconda 部分中，选择 Enable。

4. 在 Anaconda Packages 对话框中，单击链接查看 外部产品条款页面。

5. 如果您同意条款，请选择 Acknowledge & Continue。

如果您在尝试接受 外部产品条款 时遇到错误，可能是由于您的用户配置文件中缺少信息，如姓名或电子邮件地址。

创建资源并授予权限¶

要创建笔记本，角色需要具有以下资源的权限：

• 位置的 CREATE NOTEBOOK 权限

• 计算资源的 USAGE 权限

• （可选）外部访问集成 (EAIs) 的 USAGE 权限

有关为这些资源创建和授予权限的示例脚本，请参阅 笔记本设置模板。

计算资源¶

在仓库运行时中，笔记本的引擎和笔记本中编写的代码的 Python 进程都在笔记本仓库中运行，但 SQL 查询和 Snowpark 向下推送查询则在查询仓库中运行。笔记本的所有者角色需要在两个仓库中都拥有 USAGE 权限。

如果笔记本在容器运行时中运行，则角色需要在计算池上（而不是在笔记本仓库中）拥有 USAGE 权限。计算池是由 Snowflake 管理的基于 CPU 或 GPU 的虚拟机。创建计算池时，需要将 MAX_NODES 参数设置为大于 1，因为每个笔记本需要一个完整的节点来运行。有关信息，请参阅 Snowpark Container Services：使用计算池。

要了解笔记本如何在计算资源上产生 credit 以及管理成本的最佳实践，请参阅 成本结构和注意事项。

外部访问集成（可选）¶

如果您允许某些角色访问外部网络，可以使用 ACCOUNTADMIN 角色来设置并授予外部访问集成 (EAIs) 的 USAGE 权限。EAIs 允许访问特定的外部端点，以便您的团队可以下载数据和模型、发送 API 请求和响应、登录其他服务等。对于在容器运行时运行的笔记本，EAIs 还允许您的团队从 PyPi 和 Hugging Face 等仓库安装包。

有关如何为您的笔记本设置 EAI 的详细信息，请参阅 为 Snowflake Notebooks 设置外部访问。

笔记本设置模板¶

由于笔记本是具有基于角色的创建和所有权权限的对象，因此您可以配置对笔记本功能的访问权限，以满足您的组织和团队的需求。以下是一些示例：

----------------------------------
--       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;

-- For Notebooks on Container runtime, run the following:
GRANT CREATE SERVICE ON SCHEMA <database.schema> TO ROLE PUBLIC;

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

-- For Notebooks on Container runtime:
CREATE COMPUTE POOL CPU_XS
  MIN_NODES = 1
  MAX_NODES = 15
  INSTANCE_FAMILY = CPU_X64_XS;

CREATE COMPUTE POOL GPU_S
  MIN_NODES = 1
  MAX_NODES = 5
  INSTANCE_FAMILY = GPU_NV_S;

GRANT USAGE ON COMPUTE POOL CPU_XS TO ROLE PUBLIC;
GRANT USAGE ON COMPUTE POOL GPU_S 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;

CREATE ROLE notebooks_rl;

成本结构和注意事项¶

笔记本采用包含包括笔记本引擎和查询两部分的计算模型，具有灵活性。笔记本引擎在笔记本仓库中运行，笔记本中调用的查询在查询仓库中运行。您可以从 Create Notebook 对话框和 Notebook Settings 中更改两个仓库。

要更改笔记本仓库，请执行以下步骤：

1. 登录 Snowsight。

2. 选择 Projects » Notebooks。

3. 选择笔记本右上角的垂直省略号 ()。

4. 选择 Notebook settings。

5. 选择要使用的新仓库。

查询¶

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

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

USE WAREHOUSE <warehouse_name>;

Copy

优化成本的建议¶

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

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

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

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

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

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