在工作区中编辑和运行笔记本¶

设置执行上下文¶

工作区中的笔记本不会自动设置数据库或架构。要查询数据，必须在单元格中使用以下 SQL 命令定义执行上下文：

USE DATABASE <database>;
USE SCHEMA <schema>;

为确保笔记本在不同环境和客户端中一致运行，请对表和其他对象使用完全限定名称。例如：

-- Query data objects using a fully qualified name
SELECT * FROM TABLE <database_name.schema_name.table_name>;

-- Create a table using a fully qualified name
WITH filtered_events AS (
    SELECT
        user_id,
        event_type,
        event_timestamp
    FROM raw_events
    WHERE event_timestamp >= '2025-01-01'
)
CREATE OR REPLACE TABLE <database_name.schema_name.table_name> AS
SELECT *
FROM filtered_events;

使用角色和仓库选择器¶

You can set the active role and warehouse for your notebook.

SnowsightSQL

使用笔记本编辑器左上角的选择器：

查询仓库用于执行笔记本调用的 SQL 查询和 Snowpark 下推计算。它还用于呈现交互式数据网格，但此操作不消耗 Credit。

有关 Credit 使用详情，请参阅 设置计算。

创建 Snowpark 会话¶

Snowpark 是一个 Snowflake 开发者框架，可用于直接在 Snowflake 内部构建数据管道、转换和机器学习逻辑，而无需将数据移出平台。它提供将 Snowflake 数据作为 DataFrames 进行操作的 APIs，将计算推送到 Snowflake 的引擎，以实现可扩展性、高性能和安全性。

要在笔记本中使用 Snowpark Python APIs，请首先在 Python 单元格中创建 Snowpark 会话：

from snowflake.snowpark.context import get_active_session
session = get_active_session()

运行单元格¶

支持四种执行选项：

• 运行所有单元格

• 运行单个单元格

• 运行当前单元格及其上方的所有单元格（通过单元格的省略号菜单）

• 运行当前单元格及其下方的所有单元格（通过单元格的省略号菜单）

单元格名称¶

您可以为单元格命名，以便更方便地导航，并提供上下文标签。

如果导入的 .ipynb 文件已包含名称或标题元数据，将自动使用这些值。

单元格引用¶

双向 SQL 与 Python 单元格引用可在两种语言间重用结果和变量，从而实现 SQL 与 Python 工作流程的无缝衔接。

您可以将鼠标悬停在结果提示工具上，查看可在 Python 和 SQL 中引用该结果的 DataFrame 名称。

SELECT * FROM {{uploaded_df}} WHERE "price" > 326;

import pandas as pd

uploaded_df = pd.read_csv("../data/diamonds.csv")
uploaded_df

SELECT * FROM {{uploaded_df}} WHERE "price" > 326;

SELECT * FROM {{dataframe_1}} WHERE "carat" < 1.0
UNION ALL
SELECT * FROM {{dataframe_2}} WHERE "carat" >= 1.0;

交互式数据网格¶

数据网格支持：

• 滚动

• 搜索

• 筛选

• 排序

• 无需代码即可创建图表

小地图与单元格状态¶

小地图会根据 Markdown 标题生成目录，并显示每个单元格的会话状态，包括正在运行、已成功、失败及已修改。

全局搜索和替换¶

您可以在当前笔记本的所有单元格中搜索关键字。如果要编辑特定单元格，请按 esc 首先退出该单元格的编辑模式。

要在当前笔记本的所有单元格中搜索关键字，请执行以下操作：

• 要搜索关键字，请在小地图中选择 Search，或使用键盘快捷键 CTRL + F。

  显示所有单元格中的匹配关键字。（可选）您可以使用 Replace next 或 Replace all 将搜索词替换为所需值。

笔记本内核¶

只要笔记本服务处于 RUNNING 状态，笔记本内核就会保持活动，从而允许关键的长时间运行任务（例如 ML 训练和数据工程作业）连续执行。

不影响内核执行的操作：

• 浏览其他页面

• 在 Snowsight 的其他位置工作

• 关闭浏览器

• 关闭计算机

您可以通过 Connected 下拉菜单关闭或重启内核。

如果笔记本服务被暂停，笔记本内核也会随之关闭。有关详细信息，请参阅 设置计算。

单元格输出¶

• 单元格输出不会保存到 .ipynb 文件中，且无法导出。

• 执行笔记本的用户可以访问工作区（私有和共享工作区）中笔记本中的单元格输出。

• 单元格输出可见性仅限于发起执行的用户。要运行单元格，必须向您的活动默认角色授予对 笔记本项目对象 (NPO) 的 OWNERSHIP 或 USAGE 权限。

Jupyter 魔法¶

工作区中的笔记本运行 IPython（交互式 Python）内核，并提供标准 Jupyter 单元格和行魔法命令。运行 %lsmagic 可查看可用的魔法命令。

例如，您可以使用 %run magic 命令调用另一个笔记本：

• 在 notebook_a 的 Python 单元格中，调用 %run path/to/notebook_b.ipynb。此操作将在同一个 Python 进程中以 notebook_a 形式执行 notebook_b。

• 对于 notebook_b 中用于渲染 notebook_a 单元格结果的变量和 Pandas DataFrames，请确保使用显式打印。例如：print(var) 或 display(df)。

开发者工具¶

开发者工具包括 Terminal、Scratchpad 和 Variables Explorer。这些工具允许您探索数据和笔记本环境并与之交互。

要访问开发者工具，请在笔记本顶部的控制栏中，选择 <icon>:ui:Tools。

You must be connected to a notebook service to use the developer tools. Switching to a different service will restart the tools.

# If installation fails, run `apt update` first
# Install `htop`
apt install htop

# Run `htop`
htop