入力項目の設計を、別の空のデータベースに再現する
export-seedで設計を書き出し、別名の練習用DBへ適用して項目が一致するか確かめます。
目次
同じ入力欄を持つ練習サイトをもう1つ作るには、現在の設計をseedファイルへ書き出し、別の空のDBへ適用します。seedは、サイトを始めるための設定や初期データをまとめたファイルです。
この実習では、タイトル・要約・写真などの入力欄を、別名の空のデータベースへ再現します。記事本文は移しません。
先に用意するもの
写真付き一覧のガイドの「練習用サイトを準備する」まで済ませてください。同じダウンロード教材「週末ノート」を使います。EmDash 1.4.0、Astro 7.4.5、Node.js 24.22.1が対象です。実行確認はmacOSで行いました。Windows向けの入力例はコマンドプロンプト用で、Windows実機では未確認です。
以下のファイル名は、特に断りがなければ教材の weekend-note フォルダーからの場所です。ファイルの内容はVS Codeで編集し、指定された名前で保存します。コマンドはファイルに保存せず、コマンド入力画面へ貼り付けて実行します。どちらも、囲みの前にある説明で作業する場所を確認してください。開発サーバーは weekend-note のコマンド入力画面で npm run dev を実行しておきます。
起動に使った画面は開いたままにします。このあとのコマンドは、別の入力画面で実行します。VS Code左側のファイル一覧で weekend-note フォルダーを右クリックし、**Open in Integrated Terminal(統合ターミナルで開く)**を選ぶと、そのフォルダーを作業場所にした画面を開けます。Windowsでは、パソコンの準備で選んだコマンドプロンプトを使います。
1. 現在の設計を書き出す
weekend-note のコマンド入力画面で実行します。MacのzshとWindowsのコマンドプロンプトでは、どちらも次の1行です。
npx emdash export-seed --database data.db > exercises/exported-seed.json> は、画面へ出る結果を右側のファイルに保存する記号です。このコマンドは指定したSQLiteファイルを直接読みます。接続先URLを使う content create などとは違うため、--url は付けません。
VS Codeで exercises/exported-seed.json を開きます。collections の中に posts、その fields に title、excerpt、featured_image、content、related_posts があれば、設計が書き出されています。
--with-content を付けていないため、この実習の書き出しでは記事本文を移しません。メニューやサイト設定も含まれるので、他のサイトへそのまま適用する前には内容を読みます。
2. 別のDBへ適用する
初回は exercises/recreated.db が存在しないことを、VS Codeのファイル一覧で確認します。次の命令は、この新しいファイルへ保存します。
npx emdash seed exercises/exported-seed.json --database exercises/recreated.db最後の --database exercises/recreated.db を省略しないでください。省略すると、既定の data.db が対象になります。表示される保存先のパスも見ておきます。
検証では、記事をまとめるコレクションが1つ、その中の入力項目が5つ作られました。メニューは1つ、その中のリンク項目は2つです。元の data.db は引き続きそのまま使えます。
3. 再現された設計を読む
新しいDBの設計をもう一度書き出します。
npx emdash export-seed --database exercises/recreated.db > exercises/recreated-seed.jsonVS Codeで exported-seed.json と recreated-seed.json の posts の欄を比べます。5つの項目名と型が一致すれば成功です。メニューなどの内部IDや並び方ではなく、再現したい入力欄を見ます。
実行確認では、5項目の名前と型が一致しました。この別DBは確認用のファイルです。4350番で動いているサイトは、引き続き元のDBを使います。
作り直したDBの状態も確認したいときは、doctor の診断項目と終了コードの手順で、診断先に ./exercises/recreated.db を指定してください。
記事や画像も移したい場合
記事・画像を含めて移す手順は、サイトの書き出しと取り込みで扱います。seedファイルだけでは、サイト全体を復旧するためのデータは揃いません。
同じ実習を繰り返すときも、新しいファイル名を指定し、既存の記事が入ったDBへ適用しないようにします。ファイルを分けておくと、前回の結果とも比べられます。
終了するとき・次回続けるとき
npm run devを実行した画面が入力待ちに戻っていなければ、その画面でControl + Cを押して停止します。入力待ちに戻ったあともサイトが動き続けている場合は、weekend-noteでnpx astro dev stopを実行します。次回は同じフォルダーでnpm run devを実行してください。初期データを入れるseedコマンドを繰り返す必要はありません。