HubDBテーブルの作成と入力

HubDB は、構造化されたデータテーブルの作成と管理に使用するデータベースツールです。HubDBテーブルを使用すると、 HubDB API経由で 外部から動的ページを作成したり 、テーブルを照会したりできます。HubDBには構造化データ(製品リスト、チーム名簿、イベントスケジュールなど)が保存されるため、複数のページを個別に更新する必要がないため、情報を一元的に更新することができます。HubSpotの 開発者ドキュメントでHubDBの詳細をご確認ください。

始める前に

この機能を使い始める前に、あらかじめ必要となる手順と、この機能の使用に伴う制限事項と潜在的な結果について十分に理解しておいてください。 

制限事項と考慮事項について

• 全ての新しく作成されたテーブルのステータスは、下書きとして設定されます。テーブルを公開するまで、テーブルを使用して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. 行の順序を変更するには、 行番号 の上にカーソルを重ねて dragHandleIcon ドラッグ&ドロップアイコンをクリックします。次に、 行 を上または下に移動して新しい位置に移動します。

4. 列の順序を変更するには、 列の上にマウスポインターを置き、 dragHandleIcon ドラッグ&ドロップアイコンをクリックします。次に、 列 を左右の新しい位置に移動します。

テーブル設定を管理

パブリックAPIアクセスのオプションや動的 ページの作成にデータを使用できるかどうかなど、個々のHubDBテーブル設定を管理します。

1. HubSpotアカウントにて、［コンテンツ］＞［HubDB］の順に進みます。
2. テーブルの名をクリックする。
3. 右上の [アクション ]ドロップダウンメニューをクリックし、[ 設定を管理]を選択します。
4. 右側のパネルで、[ パブリックAPIアクセスを許可 ]スイッチをオンに切り替えると、認証されていないAPI呼び出しによるテーブル内のデータのクエリーが有効になります。
   • 既定では、HubSpotでテーブル内のデータにアクセスするには、 HubL または認証済みの API呼び出しが必要です。
   • データを照会するには、 portalId クエリーパラメーターにHubSpotアカウントIDを含める必要があります。
5. テーブルを使用して 動的ページを作成するには 、[行データを使用した動的ページ作成を有効化]スイッチをオンに切り替えます。その後、以下の追加オプションを設定できる：
   • [メタデータ ]セクションで、ドロップダウンメニュー をクリックし、メタディスクリプション、キービジュアル、canonical（正規）URLデータを動的ページに取り込む 列 を選択します。新しいテーブルの場合は、これらのデータを格納する新しい列を作成する必要があります。
     • メタディスクリプション：テキストタイプの列でなければならない。
     • キービジュアル画像：は画像タイプの列でなければならない。
     • canonical 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. ダイアログボックスで、 アセットタイプ ( [ブログ記事 ]、[ モジュール]など)をクリックしてセクションを展開し、個々のアセットを表示します。