尝试以扩展 VS Code 中的代理模式!

VS Code 中 Data Wrangler 快速入门指南

Data Wrangler 是一个以代码为中心的数据查看和清理工具,已集成到 VS Code 和 VS Code Jupyter Notebooks 中。它提供丰富的用户界面来查看和分析您的数据,显示富有洞察力的列统计信息和可视化效果,并在您清理和转换数据时自动生成 Pandas 代码。

以下示例展示了如何从 Notebook 打开 Data Wrangler,使用内置操作来分析和清理数据。然后,自动生成的代码会导出回 Notebook 中。

a gif of opening Data Wrangler from a notebook, looking through the data, switching from Viewing to Editing mode, applying data transformations, and exporting the generated Python code back into the notebook

本页面的目标是帮助您快速上手并运行 Data Wrangler。

设置您的环境

  1. 如果您尚未安装 Python,请先安装它(注意:Data Wrangler 仅支持 Python 3.8 或更高版本)。
  2. 安装 Data Wrangler 扩展

当您首次启动 Data Wrangler 时,它会询问您要连接到哪个 Python 内核。它还会检查您的计算机和环境,以确定是否已安装所需的 Python 包(如 Pandas)。

打开 Data Wrangler

任何时候您在 Data Wrangler 中,都处于一个沙盒化的环境中,这意味着您可以安全地探索和转换数据。在您明确导出更改之前,原始数据集不会被修改。

从 Jupyter Notebook 启动 Data Wrangler

如果您的 Notebook 中有一个 Pandas 数据帧,在运行 df.head()df.tail()display(df)print(df)df 中的任何一个命令后,您现在会在单元格底部看到一个 在 Data Wrangler 中打开 'df' 按钮(其中 df 是您的数据帧的变量名)。

a screenshot showing the entry point into Data Wrangler from a notebook

直接从文件启动 Data Wrangler

您也可以直接从本地文件(如 .csv 文件)启动 Data Wrangler。为此,请在 VS Code 中打开包含您想打开的文件的任何文件夹。在文件资源管理器视图中,右键单击该文件,然后点击 在 Data Wrangler 中打开

a screenshot showing the entry point into Data Wrangler from a file

UI 导览

Data Wrangler 在处理您的数据时有两种模式。每种模式的详细信息将在下面的后续部分中解释。

  1. 查看模式:查看模式优化了界面,以便您快速查看、筛选和排序数据。此模式非常适合对数据集进行初步探索。
  2. 编辑模式:编辑模式优化了界面,以便您对数据集应用转换、清理或修改。当您在界面中应用这些转换时,Data Wrangler 会自动生成相关的 Pandas 代码,这些代码可以导出回您的 Notebook 以供重用。

注意:默认情况下,Data Wrangler 在查看模式下打开。您可以在“设置”编辑器中更改此行为

查看模式界面

a screenshot showing the different components in the UI for Data Wrangler in Viewing mode

  1. 数据摘要面板显示了整个数据集或(如果选中)特定列的详细摘要统计信息。

  2. 您可以从列的标题菜单中对该列应用任何数据筛选/排序

  3. 在 Data Wrangler 的查看编辑模式之间切换,以访问内置的数据操作。

  4. 快速洞察标题栏是您可以快速查看每列有价值信息的地方。根据列的数据类型,快速洞察会显示数据的分布或数据点的频率,以及缺失值和唯一值。

  5. 数据网格为您提供一个可滚动的窗格,您可以在其中查看整个数据集。


编辑模式界面

切换到编辑模式可在 Data Wrangler 中启用额外的功能和用户界面元素。在下面的屏幕截图中,我们使用 Data Wrangler 将最后一列的缺失值替换为该列的中位数。

a screenshot showing the different components in the UI for Data Wrangler in Editing mode

  1. 操作面板是您可以搜索 Data Wrangler 所有内置数据操作的地方。这些操作按类别组织。

  2. 清理步骤面板显示了所有先前应用的操作列表。它使用户能够撤销特定操作或编辑最近的操作。选择一个步骤将在数据网格中高亮显示更改,并显示与该操作相关的生成代码。

  3. 导出菜单可让您将代码导出回 Jupyter Notebook 或将数据导出到新文件中。

  4. 当您选择一个操作并预览其对数据的影响时,网格会叠加显示您对数据所做更改的数据差异视图。

  5. 代码预览部分显示了当选择一个操作时 Data Wrangler 生成的 Python 和 Pandas 代码。未选择任何操作时,此部分为空。您可以编辑生成的代码,这会导致数据网格高亮显示对数据的影响。

示例:替换数据集中的缺失值

给定一个数据集,常见的数据清理任务之一是处理数据中存在的任何缺失值。下面的示例展示了如何使用 Data Wrangler 将一列中的缺失值替换为该列的中位数值。虽然转换是通过界面完成的,但 Data Wrangler 也会自动生成替换缺失值所需的 Python 和 Pandas 代码。

an example of using Data Wrangler to replace missing values in your dataset

  1. 操作面板中,搜索填充缺失值操作。
  2. 在参数中指定您希望用什么来替换缺失值。在本例中,我们将用该列的中位数值替换缺失值。
  3. 验证数据网格是否在数据差异中向您显示了正确的更改。
  4. 验证 Data Wrangler 生成的代码是否符合您的预期。
  5. 应用该操作,它将被添加到您的清理步骤历史记录中。

后续步骤

本页面介绍了如何快速开始使用 Data Wrangler。有关 Data Wrangler 的完整文档和教程,包括 Data Wrangler 当前支持的所有内置操作,请参阅以下页面。

使用 Data Wrangler