商品マスタをDatahubにインポートする流れを説明します。
商品マスタを用意する
- 商品のマスタデータをCSVファイル形式で用意します。
- フォーマットは、商品・在庫マスタフォーマットをご確認ください。
データセットを作成する
- Datahubのグローバルメニューから「データセット」を選択
- 左上の作成から「データセットを作成」を選択
- データセット名を入力して保存する
- データセット名は任意になりますが、例では「item_master」
- 注意点：
- データセット名には半角英数字とアンダースコアのみ利用できます
- データセット名は後から変更できませんのでご注意ください
データテーブルを作成する
データセット右上のテーブルを作成から「テーブルを作成」を選択。以下のように設定します。
| 項目 | 内容 |
|---|---|
| テーブル名 | 任意のテーブル名を入力（例ではitem_master） |
| 追加先データセット | 上記で作成したデータセットを選択 |
| オプション | 「スキーマを指定して作成」にチェックを入れる |
| スキーマ | 取り込む商品マスタのフィールドに併せて設定します。 参考：商品マスタ（サンプル） 参考：データテーブルのスキーマを指定する |
| 分割テーブルにするかどうか（オプション） | 今回はチェックなし |
注意点：
- テーブル名には半角英数字とアンダースコアのみ利用できます
- テーブル名、追加先データセットは後から変更できませんのでご注意ください
データ型：
- STRING：文字列
- INT64：数値
- DATETIME：日付
（参考）スキーマサンプル
| フィールド名 | 型 |
|---|---|
| item_id | 文字列 |
| name | 文字列 |
| price | 数値 |
| display_price | 文字列 |
| image | 文字列 |
| url | 文字列 |
| l_category_cd | 文字列 |
| s_category_cd | 文字列 |
| brand_cd | 文字列 |
| brand_name | 文字列 |
| sex_cd | 文字列 |
| recommend_f | 文字列 |
用意した商品マスタをデータテーブルにインポートする
CSVファイルをアップロードする場合
- 画面左のCSVからアップロードを選択し、商品マスタのCSVファイルをアップロード
※管理画面でアップロードする場合は毎回手作業になります。定期的に自動でデータをインポートする場合は後述の「外部サービスからジョブフローを使ってインポートする」方法で設定ください。
外部サービスからジョブフローを使ってインポートする場合
外部のストレージサービス（例：Amazon S3, Google Cloud Storage）に商品マスタを定期的にアップロードすることで、自動でDatahubのインポートを行います。KARTEプロジェクト内で利用できる専用のバケットを新規で払い出すことが可能です。詳しくは以下の記事をご確認ください。
専用のバケットの払い出しが必要な場合は営業担当にご連絡ください。
ジョブの設定
- Datahubのグローバルメニュー→ジョブフロー画面に遷移
- 右上の「作成」ボタンを押下してジョブフロー設定画面に遷移
- 設定画面から以下を設定し、右上の「保存して完了」をクリック
| 項目 | 内容 |
|---|---|
| ジョブ名 | 商品マスタをデータテーブルへ |
| ジョブタイプ | データテーブルへインポート |
| インポート元 | 外部サービス |
| 接続先 | Google Cloud Storage / S3 接続先の設定方法についてはこちらをご確認ください ・Google Cloud Storage ・Amazon S3 |
| 個別設定 | バケット：対象のバケット名を選択してください。 スキーマ：データテーブル作成時に指定したスキーマをこちらにも設定してください。 |
| インポート先 | データテーブル：先程作成したデータテーブルを選択 ルール：置き換え |
実行方法を選択
- 「スケジュール実行を有効にする」にチェック
- 「繰り返し実行を有効にする」にチェック
- 実行頻度の設定を行う
- 連携頻度は毎日を推奨しています。
※連携頻度を、1日2回の頻度で設定する場合は、「ジョブ追加」より同様の流れでジョブフローを組んでいただき、スケジュールの実行で別の時間で「毎日」を指定することで実現できます。
ジョブフローの設定
- 「ジョブ実行終了後にアーカイブ」チェックなし
- ジョブフロー名：任意
- ジョブが一つの場合は「先頭のジョブ名を流用」するのを推奨しています。
- 右上の「今すぐ実行」をクリックするとジョブが実行されます。
- ※ジョブの終了までに5〜10分程度時間がかかります。
- ジョブが「実行済み」になっていることを確認します。
商品マスタがデータテーブルにインポートされているか確認する
- 対象のデータテーブル画面に遷移し、プレビュー画面からデータがインポートされていることを確認する
以上で設定は完了です。
正常に取り込めなかった場合
以下のトラブルシューティング、FAQをご確認いただき、それでも解決されない場合はチャットサポートよりご連絡ください。