建立並填入 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. 若要使用該表格建立動態頁面，請開啟「啟用使用列資料建立動態頁面」開關。接著，您可以設定以下額外選項：
   • 在「元資料」區段中，點擊下拉式選單並選取哪些欄位將為動態頁面填入元描述、特色圖片及規範網址資料。對於新資料表，您需要建立新欄位來儲存這些資料。
     • 元描述：必須為文字類型的欄位。
     • 特色圖片：必須為圖片類型的欄位。
     • 規範網址：必須為網址類型的欄位。
   • 在「子資料表」區段中，勾選「允許使用子資料表」核取方塊 ，以啟用此資料表對其他 HubDB 資料表的參照。
   • 若要自動建立中間列表頁面，請勾選「自動為子表建立列表頁面」核取方塊。進一步了解如何使用 HubDB 建立多層級動態頁面。
6. 完成後，請按一下「儲存」。

請注意：父表無法引用同時也引用該父表的子表。此舉將形成迴圈，導致在父表中嘗試選取子表時發生錯誤。

發佈資料表

發佈 HubDB 資料表，以便將最新的結構與資料提供給您的網站或透過 HubDB API 使用。在建立資料表或更新欄位與列後，請發佈該資料表以套用變更。

1. 在你的 HubSpot 帳戶中，點擊「更多」，然後前往「內容」 > 「HubDB」。如果你的帳戶中沒有顯示「更多」，請直接前往「內容」 > 「HubDB」。
2. 點擊某個資料表的名稱。
3. 在右上角，點擊「發佈」。
4. 在對話方塊中，點擊「發佈」以將您的變更上線。

匯出資料表資料

1. 在你的 HubSpot 帳戶中，點擊「更多」，然後前往「內容」 > 「HubDB」。如果你的帳戶中沒有顯示「更多」，請直接前往「內容」 > 「HubDB」。
2. 點擊某個資料表的名稱。
3. 在右上角，點擊「動作」下拉式選單並選擇「匯出」。接著選擇檔案格式選項（例如CSV）。HubDB 資料表的資料將立即開始下載。

請注意：從 HubDB 資料表匯出的圖片將以圖片網址格式呈現。若圖片尺寸曾經自訂，其尺寸資訊將顯示於網址末尾。

檢視表格的依賴項

在更新或刪除 HubDB 資料表之前，請先查看哪些資產依賴於該資料表。檢視資料表的依賴項有助於您了解變更對網站內容或 API 使用情況的影響。

1. 在你的 HubSpot 帳戶中，點擊「更多」，然後前往「內容」 > 「HubDB」。如果你的帳戶中沒有顯示「更多」，請直接前往「內容」 > 「HubDB」。
2. 點擊「動作」下拉式選單，並選擇「顯示依賴項目」。
3. 在對話方塊中，點擊某種資產類型（例如「部落格文章」或「模組」），以展開該區段並檢視個別資產。