知識庫

建立並填入 HubDB 表

作者:HubSpot Support | Nov 21, 2022 1:29:55 PM

HubDB是一個關聯式資料庫,可讓您建立具有靈活架構的表來儲存可在網站頁面上使用的數據,或透過 HubDB API 進行外部查詢。

請注意:
  • 若要使用 HubDB 資料建立動態頁面,您需要Content Hub ProfessionalEnterprise
  • 僅擁有Marketing Hub企業的帳戶 訂閱只能使用 HubDB 發送行銷電子郵件。

建立一個表

  • 點選右上角的「建立表」
  • 在對話方塊中,輸入表格標籤表格名稱。創建表後就無法更改表的名稱。
  • 單擊創建

新增和編輯表數據

直接在您的 HubSpot 帳戶中編輯 HubDB 表或上傳 CSV 以自動將現有資料與表格行合併。

新增自訂表格列

  • 在 HubDB 儀表板上,按一下其中一個表格的標籤
  • 在右上角,按一下「動作」 ,然後選擇「新增列」 。
  • 在對話方塊中,配置您的列:
    • 輸入列標籤
    • 輸入列名稱。您可以使用此名稱透過 HubDB API 查詢您的資料
    • 輸入列描述。當使用者將滑鼠懸停在列名稱旁邊的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 Professional 和 Enterprise)

如果您擁有Content Hub ProfessionalEnterprise帳戶,則可以管理每個 HubDB 表的設置,例如該表是否可透過 API 公開存取以及資料是否可用於建立動態頁面

  • 按一下表格的名稱
  • 在右上角,點擊操作>管理設定

  • 在右側邊欄中,配置表的設定:
    • 允許公共 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 的更多資訊。