创建并填充 HubDB 表

HubDB是一款用于创建和管理结构化数据表的数据库工具。您可以利用 HubDB数据表创建动态页面，并通过HubDB API 对外查询数据表。HubDB 存储结构化数据（例如产品列表、团队名录或活动日程），使信息能够在中央位置统一更新，而非逐个页面单独修改。更多 HubDB 详情请参阅HubSpot 开发者文档。

开始前须知

在开始使用此功能前，请务必充分了解需提前采取的步骤、功能限制及使用可能带来的后果。 

了解限制与注意事项

• 所有新建表默认处于草稿状态。表需发布后才能通过HubL或 API 输出数据。
• 查看HubDB 技术限制。

创建表格

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击创建表格。
3. 在对话框中输入表标签和表名称。发布后无法更改表名。
4. 点击创建。

添加或导入表格数据

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

添加表格列

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

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击某个表的名称。
3. 在右上角点击操作下拉菜单，选择添加列。
4. 在对话框中输入列标签。
5. 输入列名称。此名称可用于通过 HubDB API 查询数据。
6. 输入列描述。当用户将鼠标悬停在列名旁的info 图标上时，该描述将显示。
7. 点击列类型下拉菜单并选择列类型。部分列类型会显示额外配置选项（例如单选或 多选）。
8. 完成后点击添加列。

添加表格行

行用于存储表中的单条记录。可通过添加行向表中填充结构化数据，或在数据变更时更新现有行。

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击表格名称。
3. 在右上角点击操作下拉菜单，选择添加行。
4. 将创建新行。若表中已有行，新行将添加在现有行下方。为表中配置的每个列输入值。

通过CSV文件导入表格数据

从CSV文件导入数据可一次性向HubDB表格添加多行记录。此功能适用于处理大型数据集或将现有信息迁移至HubDB的情境。

1. 在 HubSpot 帐户中，导航到内容 > 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。
2. 点击表格名称。
3. 将鼠标悬停在列标签上，点击下拉菜单，然后选择“删除”。
4. 在对话框中点击“删除”。

删除表行

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击表名。
3. 将鼠标悬停在行 ID 上， 点击下拉菜单，然后选择“删除”。

重新排序表列与行

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击表格名称。
3. 要更改行顺序，请将鼠标悬停在行号上， 点击 拖拽手柄图标 ， 然后将该行向上或向下拖动至新位置。

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

管理表设置

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

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

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

发布表格

发布HubDB表格，使其最新结构和数据可在您的网站或通过HubDB API使用。创建表格或更新列/行后，请发布表格以应用更改。

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击某个表的名称。
3. 在右上角点击发布。
4. 在对话框中，点击发布以使更改生效。

导出表数据

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 点击表格名称。
3. 在右上角，点击操作下拉菜单并选择导出。然后选择文件格式选项（例如CSV）。HubDB 表数据将立即开始下载。

请注意：从 HubDB 表导出的图片将以图片 URL 格式呈现。若图片尺寸经过自定义，其尺寸参数将显示在 URL 末尾。

查看表依赖项

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

1. 在 HubSpot 帐户中，导航到内容 > HubDB。
2. 单击“操作”下拉菜单并选择“显示依赖项”。
3. 在对话框中，点击资产类型（例如博客文章或模块）展开该部分，查看具体资产。