跳到内容

创建并填充 HubDB 表

上次更新时间: 二月 12, 2025

除非另有说明,否则适用于以下任何订阅

营销 Hub   Enterprise
内容 Hub   Professional , Enterprise

HubDB是一个关系型数据库,允许你创建具有灵活模式的表格,以存储数据,你可以在网站页面上使用这些数据,也可以通过 HubDB API 从外部进行查询。

请注意
  • 要使用 HubDB 数据创建动态页面,您需要使用Content Hub ProfessionalEnterprise
  • 订阅 Marketing Hub Enterprise的账户只能将 HubDB 用于营销电子邮件。

创建表格

  • 在 HubSpot 帐户中,导航到内容 > HubDB
  • 在右上角单击创建表格
  • 在对话框中输入表标签表名。创建表格后不能更改其名称。
  • 单击创建

添加和编辑表数据

直接在你的 HubSpot 账户中编辑 HubDB 表,或上传 CSV 以自动将现有数据与表行合并。

添加自定义表格列

  • 在 HubDB 面板上,单击其中一个表的标签
  • 在右上角单击 "操作",然后选择 "添加列"。
  • 在对话框中配置列:
    • 输入列标签
    • 输入列名称。您可以使用此名称通过HubDB API 查询数据
    • 输入列描述。当用户将鼠标悬停在列名旁边的info info 图标上时,该描述将显示出来。
    • 输入列类型
  • 单击添加列
  • 要修改或删除列,请将鼠标悬停在列上并单击箭头图标,然后选择编辑删除

添加表格行

  • 在 HubDB 面板上,单击现有表的标签
  • 在右上角单击 "操作",然后选择 "添加行"。
  • 新行将自动创建在任何现有行的下方。为表配置的每一列输入
  • 要克隆或删除行,请将鼠标悬停在行的 ID 上,然后单击downCarat箭头图标,再选择克隆删除

通过 CSV 导入表格数据

如果你现有的电子表格中的数据与你的 HubDB 表模式相匹配,你可以把它导入到 HubSpot 中,自动将其数据与你的表合并。

请注意

  • 要将图片导入HubDB表,请将图片的URL添加到CSV文件中。 要设置图片的尺寸,请将宽度和高度添加到URL的末尾,用逗号抵消。例如:http://www.hubspot.com/sample-image.jpg,100,300。
  • 导入的日期必须使用 MM/DD/YYYY 格式。例如,2022 年 11 月 6 日就是 11/06/2022。

  • 在 HubDB 面板上,单击其中一个表的标签
  • 在右上角单击 "操作",然后选择 "导入"。
  • 单击 "添加或 替换"磁贴:
    • 添加:电子表格中的行将添加到现有数据中。
    • 替换:电子表格中的行将覆盖并替换表格中的任何现有数据。如果电子表格中包含行 ID,则将更新行而不是替换行。
  • 单击下一步
  • 单击选择文件
  • 浏览计算机硬盘中要上传的 CSV,然后单击 "打开"
  • 默认情况下,HubSpot 会检测 CSV 中数据的编码。要手动指定数据编码,请
    • 单击高级选项
    • 单击 "自定义数据编码"下拉菜单,然后选择编码
  • 单击下一步
  • 指定如何将 CSV 中的每个字段映射到相应的 HubDB 表列:
    • 单击HubDB 表列下拉菜单,然后选择
    • 如果尚未为 CSV 字段配置关联列,请单击添加列。在对话框中输入标签、 名称并选择类型。完成后,单击添加列
  • 单击导入

  • 导入完成后,单击完成

管理表格设置(仅限 Content Hub 专业版和企业版)

如果您有Content H ub专业版企业版 账户,您可以管理每个 HubDB 表的设置, 例如表是否可通过 API 公开访问,以及数据是否可用于创建动态页面

  • 在 HubSpot 帐户中,导航到内容 > HubDB
  • 单击表的名称
  • 在右上角,单击操作 >管理设置

  • 在右侧边栏中,配置表的设置:
    • 允许公共 API 访问:默认情况下,表的数据只能在 HubSpot 中通过HubL 访问,或通过已验证的API 调用访问。打开此设置可启用未经验证的API 调用来查询表的数据。要查询数据,你需要在portalId 查询参数中包含 HubSpot 账户 ID。
    • 启用使用行数据创建动态页面:打开此设置可启用使用 HubDB 数据创建动态页面。然后,你可以配置以下附加选项:
      • 使用下拉菜单选择哪些列将在动态页面中填充元描述、特色图片和规范 URL 数据。对于新表,你需要创建新列来包含这些数据。
        • 元描述:必须是文本类型列。
        • 特色图片:必须是图片类型列。
        • 规范 URL:必须是 URL 类型列。
      • 允许使用子表打开此设置 ,允许在此表中引用其他 HubDB 表。你还可以选择 "自动为子表创建列表页"设置,让HubSpot自动创建中间列表页。了解更多有关使用HubDB构建多级动态页面的信息。

        请注意:父表不能引用同时引用父表的子表。这将创建一个循环,当试图在父表中选择子表时会出错。

  • 单击保存

发布表格

用数据填充完 HubDB 表后,就可以将其发布到网站页面上,并通过 HubSpot API 进行查询。

  • 在右上角单击 "发布"
  • 在对话框中,确认你已经准备好公开你的表,然后点击发布

导出表格数据

  • 在 HubDB 面板上,单击其中一个表的标签
  • 在右上角单击 "操作"下拉菜单并选择 "导出",然后选择文件格式。HubDB 数据将立即开始下载。

请注意:从 HubDB 表中导出的图片将以图片 URL 格式显示。如果图片的尺寸已被自定义,它们将出现在 URL 的末尾。

查看表依赖项

创建表格后,你可以通过 HubDB 面板查看内容中使用 HubDB 表格的位置。此外,删除 HubDB 表时,HubSpot 会警告你当前是否有任何资产正在使用该表。

要查看正在使用 HubDB 表的资产,请在 HubDB 面板上单击表旁边的 "操作"下拉菜单,然后选择 "显示依赖项"。

HubSpot 开发人员文档中了解有关 HubDB更多信息。

这篇文章有帮助吗?
此表单仅供记载反馈。了解如何获取 HubSpot 帮助