创建并填充 HubDB 表

HubDB是一款用于创建和管理结构化数据表的数据库工具。您可以利用 HubDB 数据表创建动态页面，并通过HubDB API 从外部查询数据表。HubDB 用于存储结构化数据（例如产品列表、团队名录或活动日程），这样信息就可以在中央位置进行更新，而无需逐个更新多个页面。请参阅HubSpot 的开发者文档，了解更多关于 HubDB 的信息。

开始之前

在开始使用 HubDB 表之前，请先了解相关要求、限制及注意事项。

了解限制与注意事项

• 所有新建的表默认状态均为“草稿”。在表发布之前，无法通过HubL或 API 使用该表输出数据。
• 保存表的更改不会更新实时页面或电子邮件。要应用更改，请在保存后发布该表。如果发布表后，实时页面或电子邮件仍显示旧内容，请重新发布页面或电子邮件以强制其重新渲染。
• 请查阅HubDB 的技术限制。

创建表

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击“创建表格”。
3. 在对话框中，输入“表格标签”和“表格名称”。表格发布后无法更改其名称。
4. 点击“创建”。

添加或导入表数据

创建表后，您可以添加新列和新行，以组织网站页面或通过HubDB API 使用的数据。您还可以导入 CSV 文件，将其数据合并到 HubDB 表中。

添加表列

列定义了表格各部分所存储的数据类型。添加列时，您需要选择列类型并配置相关设置，这些设置将决定数据的输入和使用方式。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 单击某个表的名称。
3. 在右上角，单击“操作”下拉菜单，然后选择“添加列”。
4. 在对话框中，输入“列标签”。
5. 输入“列名”。您可以使用此名称通过 HubDB API 查询数据。
6. 输入“列描述”。当用户将鼠标悬停在列名旁边的“信息”图标上时，将显示此描述。
7. 点击“列类型”下拉菜单，然后选择一种列类型。某些列类型会显示额外的配置选项（例如“单选”或“多选”）。
8. 完成后，点击“添加列”。

添加表格行

行用于存储表中的单个记录。添加行可向表中填充结构化数据，或随着数据的变化更新现有行。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击某个表的名称。
3. 在右上角，点击“操作”下拉菜单并选择“添加行”。
4. 系统将创建一行新数据。如果该表中已有数据行，新行将添加在现有数据行下方。为该表中已配置的每一列输入一个值。

使用 CSV 文件导入表数据

从 CSV 文件导入数据，可一次性向 HubDB 表中添加多行数据。当您处理大型数据集或将现有信息迁移到 HubDB 时，此功能非常有用。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击表名。
3. 在右上角，点击“操作”下拉菜单，然后选择“导入”。
4. 点击“添加或 替换”磁贴：
   • 添加：电子表格中的行将添加到现有数据中。
   • 替换：电子表格中的行将覆盖并替换表中现有的任何数据。如果电子表格中包含行 ID，则行将被更新而非替换。
5. 点击“下一步”。
6. 在“选择文件”页面上，点击“选择文件”。
7. 在文件系统中找到 CSV 文件，然后点击“打开”。
8. 默认情况下，HubSpot 会自动检测 CSV 文件中数据的编码。若要手动指定数据编码：
   • 点击“高级选项”。
   • 点击“自定义数据编码”下拉菜单，然后选择一种编码。
9. 点击“下一步”。
10. 在“映射列”页面上，指定您希望如何将 CSV 中的每个字段映射到相应的 HubDB 表列：
    • 点击“HubDB表列”下拉菜单，然后选择一列。
    • 如果您尚未为该 CSV 字段配置关联列，请点击“添加列”。在对话框中，输入标签、名称并选择类型。完成后，点击“添加列”。
11. 完成后，点击“导入”。
12. 导入完成后，点击“完成”。

管理表数据

通过删除列或行以及调整其顺序，管理 HubDB 表的结构和内容。这些操作有助于保持表的条理清晰，并确保数据结构正确，以便在您的网站上或通过 HubDB API 使用。

删除表列

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击某个表的名称。
3. 将鼠标悬停在列标签上，点击下拉菜单，然后选择“删除”。
4. 在对话框中，点击“删除”。

删除表行

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击表名。
3. 将鼠标悬停在行 ID 上并 点击下拉菜单，然后选择“删除”。

重新排列表的列和行

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 单击表名。
3. 要更改行顺序，请将鼠标悬停在行号上， 点击 拖拽图标，然后将该行向上或向下拖动至新位置。

4. 要更改列的顺序，请将鼠标悬停在列上并点击 拖放图标（dragHandleIcon。然后将该列向左或向右移动至新位置。

管理表格设置

管理单个 HubDB 表的设置，包括公共 API 访问选项以及数据是否可用于创建动态页面。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击某个表的名称。
3. 在右上角，点击“操作”下拉菜单，然后选择“管理设置”。
4. 在右侧面板中，将“允许公共 API 访问”开关切换为“开”以启用无需身份验证的 API 调用，用于查询该表的数据。
   • 默认情况下，只能通过HubL或经过身份验证的API 调用在 HubSpot 中访问该表的数据。
   • 要查询数据，您需要在portalId查询参数中包含 HubSpot 账户 ID。
5. 若要使用该表创建动态页面，请打开“启用使用行数据创建动态页面”开关。随后，您可以配置以下附加选项：
   • 在“元数据”部分，点击下拉菜单并选择哪些列将为动态页面提供元描述、特色图片和规范 URL 数据。对于新表，您需要创建新列来存储这些数据。
     • 元描述：必须为文本类型列。
     • 特色图片：必须是图片类型的列。
     • 规范 URL：必须是 URL 类型的列。
   • 在“子表”部分，选中“允许使用子表”复选框 ，以启用本表对其他 HubDB 表的引用。
   • 若要自动创建中间列表页面，请选中“为子表自动创建列表页面”复选框。了解有关使用 HubDB 构建多级动态页面的更多信息。
6. 完成后，点击“保存”。

请注意：父表不能引用同时引用该父表的子表。这将形成循环，导致在父表中尝试查询子表时出现错误。

发布表

发布 HubDB 表，以便在您的网站上或通过 HubDB API 使用最新的结构和数据。在创建表或更新列、行后，请发布该表以使更改生效。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击某个表的名称。
3. 在右上角，点击“发布”。
4. 在对话框中，点击“发布”以使您的更改生效。

导出表数据

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击某个表的名称。
3. 在右上角，点击“操作”下拉菜单并选择“导出”。然后选择文件格式选项（例如CSV）。HubDB 表数据将立即开始下载。

请注意：从 HubDB 表导出的图片将以图片 URL 的形式呈现。如果图片尺寸经过自定义，这些尺寸信息将显示在 URL 的末尾。

查看表的依赖项

在更新或删除 HubDB 表之前，请查看哪些资源依赖于该表。查看表的依赖项有助于您了解更改对网站内容或 API 使用的影响。

1. 在你的 HubSpot 帐户中，单击更多，然后导航到内容 > HubDB。如果你的帐户中未显示更多，请直接导航到内容 > HubDB。
2. 点击“操作”下拉菜单，然后选择“显示依赖项”。
3. 在对话框中，点击一种资产类型（例如“博客文章”或“模块”），以展开该部分并查看单个资产。