Skip to main content
Open In ColabOpen on GitHub

Notion DB 2/2

Notion 是一个协作平台，支持修改后的 Markdown，并集成了看板、任务、维基和数据库。它是用于笔记、知识和数据管理以及项目和任务管理的“一切集成”工作空间。

NotionDBLoader 是一个用于从 Notion 数据库加载内容的 Python 类。它从数据库检索页面，读取其内容，并返回 Document 对象列表。NotionDirectoryLoader 用于从 Notion 数据库转储加载数据。

Requirements​

  • 一个 Notion 数据库
  • Notion 集成 Token

Setup​

1. 创建一个 Notion 表格数据库​

在 Notion 中创建一个新的表格数据库。您可以向数据库添加任何列，它们将被视为元数据。例如，您可以添加以下列：

  • Title：将 Title 设置为默认属性。
  • Categories：一个 Multi-select 属性，用于存储与页面关联的类别。
  • Keywords：一个 Multi-select 属性，用于存储与页面关联的关键词。

将您的内容添加到数据库中每个页面的正文中。NotionDBLoader 将从这些页面中提取内容和元数据。

2. 创建一个 Notion 集成​

要创建 Notion 集成，请遵循以下步骤：

  1. 访问 Notion Developers 页面并使用您的 Notion 帐户登录。
  2. 点击“+ New integration”按钮。
  3. 为您的集成命名，并选择您的数据库所在的工区。
  4. 选择所需的功能，此扩展程序只需要 Read content 功能。
  5. 点击“Submit”按钮创建集成。 集成创建后，您将获得一个 Integration Token (API key)。复制此令牌并妥善保管，因为您需要它来使用 NotionDBLoader。

3. 将集成连接到数据库​

要将您的集成连接到数据库，请遵循以下步骤：

  1. 在 Notion 中打开您的数据库。
  2. 点击数据库视图右上角的三个点菜单图标。
  3. 点击“+ New integration”按钮。
  4. 找到您的集成，您可能需要在搜索框中输入其名称。
  5. 点击“Connect”按钮将集成连接到数据库。

4. 获取数据库 ID​

要获取数据库 ID，请遵循以下步骤：

  1. 在 Notion 中打开您的数据库。
  2. 点击数据库视图右上角的三个点菜单图标。
  3. 从菜单中选择“Copy link”将数据库 URL 复制到剪贴板。
  4. 数据库 ID 是 URL 中找到的由字母数字字符组成的较长字符串。它通常看起来像这样：https://www.notion.so/username/8935f9d140a04f95a872520c4f123456?v=.... 在此示例中，数据库 ID 是 8935f9d140a04f95a872520c4f123456。

在正确设置数据库并获得集成令牌和数据库 ID 后，您现在可以使用 NotionDBLoader 代码从 Notion 数据库加载内容和元数据。

5. Installation​

安装 langchain-community 集成包。

%pip install -qU langchain-community

Notion 数据库加载器​

NotionDBLoader 是 langchain 包中文档加载器的一部分。你可以如下方式使用它：

from getpass import getpass

NOTION_TOKEN = getpass()
DATABASE_ID = getpass()
········
········
from langchain_community.document_loaders import NotionDBLoader
API Reference:NotionDBLoader
loader = NotionDBLoader(
    integration_token=NOTION_TOKEN,
    database_id=DATABASE_ID,
    request_timeout_sec=30,  # optional, defaults to 10
)
docs = loader.load()
print(docs)

Notion 目录加载器​

设置​

从 Notion 导出你的数据集。你可以通过点击右上角的三个点，然后点击 导出 来完成此操作。

导出时，请确保选择 Markdown & CSV 格式选项。

这将会在你的下载文件夹中生成一个 .zip 文件。将 .zip 文件移动到此存储库中。

运行以下命令解压 zip 文件（如有必要，请将 Export... 替换为你自己的文件名）。

unzip Export-d3adfe0f-3131-4bf3-8987-a52017fc1bae.zip -d Notion_DB

用法​

运行以下命令来摄取你刚刚下载的数据。

from langchain_community.document_loaders import NotionDirectoryLoader

loader = NotionDirectoryLoader("Notion_DB")
API Reference:NotionDirectoryLoader
docs = loader.load()