在笔记本中探索查询结果

---

注意：BigQuery Studio 笔记本将于 2024 年 4 月 11 日之后在正式版中开始收费。您将开始在账单中看到 BigQuery Studio 笔记本基于用量的费用。

您可以使用 BigQuery 中的 Colab Enterprise 笔记本来探索 BigQuery 查询结果。

在本教程中，您将查询 BigQuery 公共数据集中的数据，并在笔记本中探索查询结果。

目标

• 在 BigQuery 中创建和运行查询。
• 在笔记本中探索查询结果。

费用

本教程使用通过 Google Cloud 公共数据集计划提供的数据集。Google 会支付这些数据集的存储费用，并提供对数据的公开访问权限。您需要为数据执行的查询付费。如需了解详情，请参阅 BigQuery 价格。

准备工作

1. 在 Google Cloud Console 中的项目选择器页面上，选择或创建一个 Google Cloud 项目。

   注意：如果您不打算保留在此过程中创建的资源，请创建新的项目，而不要选择现有的项目。完成本教程介绍的步骤后，您可以删除所创建的项目，并移除与该项目关联的所有资源。

   转到“项目选择器”

2. 确保您的 Google Cloud 项目已启用结算功能。

3. 启用 BigQuery API。

   启用 API

   对于新项目，系统会自动启用 BigQuery。

启用 BigQuery Studio

按照启用 BigQuery Studio 进行资产管理中的说明以保存、共享和管理代码资产（例如笔记本）版本。

重要提示：2024 年 3 月，系统将自动为所有 BigQuery 项目启用支持 BigQuery Studio 功能的 API。如需了解详情，请参阅自动启用 BigQuery Studio API。

所需权限

如需创建和运行笔记本，您需要以下 Identity and Access Management (IAM) 角色：

• BigQuery User (roles/bigquery.user)
• Notebook Runtime User (roles/aiplatform.notebookRuntimeUser)
• Code Creator (roles/dataform.codeCreator)

在笔记本中打开查询结果

您可以运行 SQL 查询，然后使用笔记本来探索数据。如果您想要在使用数据之前先在 BigQuery 中修改数据，或者如果您只需要表中的部分字段，则此方法会非常有用。

1. 在 Google Cloud 控制台中，转到 BigQuery 页面。

   转到 BigQuery

2. 在输入内容即可搜索字段中，输入 bigquery-public-data。

   如果未显示该项目，请在搜索字段中输入 bigquery，然后点击搜索所有项目，将搜索字符串与现有项目匹配。

3. 选择 bigquery-public-data > ml_datasets > penguins。

4. 对于 penguins 表，点击 查看操作，然后点击查询。

5. 在生成的查询中添加星号 (*)，以便选择字段，如下所示：

   SELECT * FROM `bigquery-public-data.ml_datasets.penguins` LIMIT 1000;
   

6. 点击 运行。

7. 在查询结果部分中，点击探索数据，然后点击使用 Python 笔记本进行探索。

准备好笔记本以供使用

通过连接到运行时并设置应用默认值来准备好笔记本，以供使用。

1. 在笔记本标头中，点击连接以连接到默认运行时。
2. 在设置代码块中，点击 运行单元。

探索数据

1. 若要将 penguins 数据加载到 BigQuery DataFrame 中并显示结果，请单击从 BigQuery 作业加载为 DataFrame 的结果集部分的代码块中的 运行单元。
2. 如需获取有关数据的描述性指标，请点击使用 describe() 显示描述性统计信息部分的代码块中的 运行单元。
3. 可选：使用其他 Python 函数或软件包来探索和分析数据。

以下代码示例展示了使用 bigframes.pandas 分析数据，以及使用 bigframes.ml 根据 BigQuery DataFrame 中的 penguins 数据创建线性回归模型：

# Load data from BigQuery
query_or_table = "bigquery-public-data.ml_datasets.penguins"
bq_df = bpd.read_gbq(query_or_table)

# Inspect one of the columns (or series) of the DataFrame:
bq_df["body_mass_g"]

# Compute the mean of this series:
average_body_mass = bq_df["body_mass_g"].mean()
print(f"average_body_mass: {average_body_mass}")

# Find the heaviest species using the groupby operation to calculate the
# mean body_mass_g:
(
    bq_df["body_mass_g"]
    .groupby(by=bq_df["species"])
    .mean()
    .sort_values(ascending=False)
    .head(10)
)

# Create the Linear Regression model
from bigframes.ml.linear_model import LinearRegression

# Filter down to the data we want to analyze
adelie_data = bq_df[bq_df.species == "Adelie Penguin (Pygoscelis adeliae)"]

# Drop the columns we don't care about
adelie_data = adelie_data.drop(columns=["species"])

# Drop rows with nulls to get our training data
training_data = adelie_data.dropna()

# Pick feature columns and label column
X = training_data[
    [
        "island",
        "culmen_length_mm",
        "culmen_depth_mm",
        "flipper_length_mm",
        "sex",
    ]
]
y = training_data[["body_mass_g"]]

model = LinearRegression(fit_intercept=False)
model.fit(X, y)
model.score(X, y)

清理

为避免因本教程中使用的资源导致您的 Google Cloud 账号产生费用，请删除包含这些资源的项目，或者保留项目但删除各个资源。

为了避免产生费用，最简单的方法是删除您为本教程创建的 Google Cloud 项目。

警告：删除项目会产生以下影响

• 项目中的所有内容都会被删除。如果您将现有项目用于本文档中的任务，则删除该项目后，还将删除您已在该项目中完成的任何其他工作。
• 自定义项目 ID 丢失。创建此项目时，您可能创建了要在将来使用的自定义项目 ID。要保留使用该项目 ID 的网址（例如 appspot.com 网址），请删除项目内的所选资源，而不是删除整个项目。

如果您打算探索多个架构、教程或快速入门，则重复使用项目可以帮助您避免超出项目配额限制。

1. 在 Google Cloud 控制台中，进入管理资源页面。

   转到“管理资源”

2. 在项目列表中，选择要删除的项目，然后点击删除。
3. 在对话框中输入项目 ID，然后点击关闭以删除项目。

后续步骤

• 详细了解在 BigQuery 中创建笔记本。
• 详细了解如何使用 BigQuery DataFrames 探索数据。