(2026年10月29日 追記:記事どおりに再現できるよう、必要なコードと手順を追加しました)
ファイルが数十件を超えると、一覧を上から眺めて探すのは現実的ではなくなります。「先月の見積書だけ見たい」「このタグが付いたものだけ」といった絞り込みと、1画面に出す件数を区切るページング(=ページ送り)は、PDF管理システムに欠かせない機能です。
前回の第2回:ファイル情報をDBに持ち、一覧を表示するでは、PDFのファイル情報を SQLite に保存し、一覧画面を作りました。今回はその一覧に、ファイル名のキーワード検索・タグ・登録日の期間による絞り込みと、20件ずつのページングを追加します。
「検索画面って、入力欄を並べてデータベースに問い合わせるだけでしょう?何か気を付けることがあるの?」
結論から言うと、検索条件は「URLに残す」「サーバーで検証する」「SQLに直接埋め込まない」の3点を押さえると、使いやすく安全な検索になります。URLに条件が残っていれば、検索結果をブックマークしたり、同僚にURLで共有したりできます。この回では、Nuxt 4 と Drizzle ORM、入力検証ライブラリの zod(執筆時点で 4 系)を使って実装します。
検索・絞り込みの設計:条件はURLのクエリ文字列に持つ
今回できるようになること
| 条件 | URLの例 | 内容 |
|---|---|---|
| キーワード | ?q=見積 | ファイル名に「見積」を含む(部分一致) |
| タグ | ?tag=請求書 | 「請求書」タグが付いたファイル |
| 期間 | ?from=2026-07-01&to=2026-07-31 | 登録日が期間内(日本時間の日付で判定) |
| ページ | ?page=2 | 20件ずつ区切った2ページ目 |
条件は組み合わせられます(例:/files?q=見積&tag=2026年度&page=2)。
なぜ条件をURLに持つのか
検索条件を画面の中の変数だけで持つと、再読み込みで条件が消え、ブラウザの「戻る」で前の検索結果に戻れません。URLのクエリ文字列(? 以降の部分)を「検索条件の置き場所」にすると、次のことが自然にできるようになります。
- 再読み込みしても同じ結果が出る
- 「戻る」「進む」で検索結果を行き来できる
- 検索結果のURLをブックマーク・共有できる
- サーバー側で最初からその条件の結果を描画できる
タグは別テーブルで持つ
1つのファイルに複数のタグを付け、1つのタグを複数のファイルで使うため、「タグの一覧(tags)」と「ファイルとタグの対応(file_tags)」の2つのテーブルを追加します。ファイル情報の表に「タグ」列を作ってカンマ区切りで入れる方法もありますが、タグでの絞り込みや、後からのタグ名の変更がしにくくなります。
タグ用のテーブルを追加する
server/db/schema.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/db/schema.ts
+++ b/server/db/schema.ts
@@ -1,4 +1,4 @@
-import { integer, sqliteTable, text } from 'drizzle-orm/sqlite-core'
+import { index, integer, primaryKey, sqliteTable, text } from 'drizzle-orm/sqlite-core'
/** アップロードされたPDFのメタデータ(PDF本体はストレージ側に保存) */
export const files = sqliteTable('files', {
@@ -18,7 +18,25 @@ export const files = sqliteTable('files', {
uploadedBy: text('uploaded_by'),
/** 登録日時 */
createdAt: integer('created_at', { mode: 'timestamp' }).notNull(),
+}, (table) => [
+ // 一覧の並び順・期間での絞り込みに使う
+ index('files_created_at_idx').on(table.createdAt),
+])
+
+/** タグの一覧(名前は一意) */
+export const tags = sqliteTable('tags', {
+ id: integer('id').primaryKey({ autoIncrement: true }),
+ name: text('name').notNull().unique(),
})
+/** ファイルとタグの対応(多対多)。ファイルを消すと対応も消える */
+export const fileTags = sqliteTable('file_tags', {
+ fileId: text('file_id').notNull().references(() => files.id, { onDelete: 'cascade' }),
+ tagId: integer('tag_id').notNull().references(() => tags.id, { onDelete: 'cascade' }),
+}, (table) => [
+ primaryKey({ columns: [table.fileId, table.tagId] }),
+ index('file_tags_tag_id_idx').on(table.tagId),
+])
+
export type FileRow = typeof files.$inferSelect
export type NewFileRow = typeof files.$inferInsert
登録日時の列には索引(インデックス=本の索引のように検索を速くする仕組み)を付けました。一覧は常に登録日時の新しい順に並べ、期間でも絞り込むためです。
スキーマを変えたら、マイグレーションを生成して適用します。
npm run db:generate -- --name tags # server/db/migrations/0001_tags.sql ができる
npm run db:migrate
もう1つ、server/utils/db.ts に次の1行を追加しました。
server/utils/db.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/utils/db.ts
+++ b/server/utils/db.ts
@@ -14,6 +14,8 @@ export function useDb(): BetterSQLite3Database<typeof schema> {
const sqlite = new Database(path)
// 読み書きの同時実行に強い WAL モードにする
sqlite.pragma('journal_mode = WAL')
+ // SQLite は既定で外部キー制約が無効なので有効にする(file_tags の cascade 削除に必要)
+ sqlite.pragma('foreign_keys = ON')
db = drizzle({ client: sqlite, schema })
}
return db
SQLite の外部キー制約(=「存在しないファイルへの対応は作れない」といったテーブル間のルール)は、互換性のため既定で無効になっており、接続ごとに有効にする必要があります。これを忘れると、ファイルを削除したときに対応するタグの行が残ってしまいます。
📰 出典:SQLite 公式ドキュメント Foreign Key Support
検索条件を zod で検証する
クエリ文字列の検証ルール
URLのクエリ文字列は、利用者が自由に書き換えられる「外から来た入力」です。page=-1 や page=abc、存在しない日付などが来ても安全に断れるよう、zod で検証ルールを定義します。
検証には zod(入力の形をルールとして書き、そのルールで検証するライブラリ)を使います。今回から使うので、先にインストールします。
npm install --save-exact zod@4.4.3
server/utils/file-query.ts を新しく作ります。
// server/utils/file-query.ts
import { z } from 'zod'
/** 1ページあたりの件数 */
export const FILES_PER_PAGE = 20
/**
* 一覧APIのクエリ文字列(?q=...&tag=...&from=...&to=...&page=...)の検証ルール。
* 値はすべて文字列で届くため、page は数値に変換(coerce)してから検証する。
* 同じキーが複数ある(?page=1&page=2)と配列になり、検証エラーになる。
*/
export const fileListQuerySchema = z.object({
q: z.string().trim().max(100).optional(),
tag: z.string().trim().min(1).max(30).optional(),
from: z.iso.date().optional(),
to: z.iso.date().optional(),
page: z.coerce.number().int().min(1).max(10000).default(1),
}).refine((v) => !v.from || !v.to || v.from <= v.to, {
message: 'from は to 以前の日付にしてください',
})
export type FileListQuery = z.infer<typeof fileListQuerySchema>
/** タグ1つの検証ルール */
const tagNameSchema = z.string().trim().min(1).max(30)
/**
* アップロード時の tags 入力(カンマ・読点区切りの文字列)を、重複なしのタグ名配列にする。
* 最大10個。不正なら 400。
*/
export function parseTagInput(input: string | undefined): string[] {
if (!input) return []
const names = [...new Set(input.split(/[,、]/).map((s) => s.trim()).filter((s) => s !== ''))]
const result = z.array(tagNameSchema).max(10).safeParse(names)
if (!result.success) {
throw createError({ statusCode: 400, statusMessage: 'タグは1つ30文字以内、10個までにしてください' })
}
return result.data
}
/** LIKE 検索用に % と _ と \ をエスケープする(ESCAPE '\' と組み合わせて使う) */
export function escapeLike(value: string): string {
return value.replace(/[\\%_]/g, (c) => `\\${c}`)
}
/** 日本時間の日付(YYYY-MM-DD)の 0時0分 を Date にする */
export function startOfDayJst(date: string): Date {
return new Date(`${date}T00:00:00+09:00`)
}
z.iso.date()はYYYY-MM-DD形式の日付を検証します。試したところ、2026-02-30のような存在しない日付も不正として扱われました。- クエリ文字列の値はすべて文字列で届くため、
pageはz.coerce.number()で数値に変換してから「1以上の整数」かを確認します。 .refine()で「開始日が終了日より後」という組み合わせの誤りも弾きます。
📰 出典:Zod 公式ドキュメント Defining schemas
同じファイルには、アップロード時のタグ入力(カンマ・読点区切り)を「重複なし・1つ30文字以内・10個まで」に整える parseTagInput も置いています(上のコードの後半)。
一覧APIに絞り込みとページングを追加する
server/api/files.get.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/api/files.get.ts
+++ b/server/api/files.get.ts
@@ -1,9 +1,43 @@
-import { desc } from 'drizzle-orm'
-import { files } from '../db/schema'
+import { and, count, desc, eq, gte, inArray, lt, sql, type SQL } from 'drizzle-orm'
+import { fileTags, files, tags } from '../db/schema'
-/** ファイル一覧(新しい順)。検索・ページングは第3回で追加する */
-export default defineEventHandler(() => {
- return useDb()
+/** ファイル一覧:キーワード・タグ・期間で絞り込み、20件ずつページング */
+export default defineEventHandler(async (event) => {
+ // 1. クエリ文字列を zod で検証(不正なら 400)
+ const parsed = await getValidatedQuery(event, (query) => fileListQuerySchema.safeParse(query))
+ if (!parsed.success) {
+ throw createError({ statusCode: 400, statusMessage: '検索条件が正しくありません' })
+ }
+ const { q, tag, from, to, page } = parsed.data
+ const db = useDb()
+
+ // 2. 条件を組み立てる(値はすべてプレースホルダーで渡され、SQLに直接埋め込まれない)
+ const conditions: SQL[] = []
+ if (q) {
+ conditions.push(sql`${files.originalName} LIKE ${`%${escapeLike(q)}%`} ESCAPE '\\'`)
+ }
+ if (tag) {
+ const taggedFileIds = db
+ .select({ fileId: fileTags.fileId })
+ .from(fileTags)
+ .innerJoin(tags, eq(tags.id, fileTags.tagId))
+ .where(eq(tags.name, tag))
+ conditions.push(inArray(files.id, taggedFileIds))
+ }
+ if (from) {
+ conditions.push(gte(files.createdAt, startOfDayJst(from)))
+ }
+ if (to) {
+ // to の日の 23:59:59 までを含めるため「翌日0時より前」とする
+ const next = startOfDayJst(to)
+ next.setUTCDate(next.getUTCDate() + 1)
+ conditions.push(lt(files.createdAt, next))
+ }
+ const where = conditions.length > 0 ? and(...conditions) : undefined
+
+ // 3. 件数と、該当ページの行を取得
+ const total = db.select({ value: count() }).from(files).where(where).get()?.value ?? 0
+ const rows = db
.select({
id: files.id,
originalName: files.originalName,
@@ -14,7 +48,32 @@ export default defineEventHandler(() => {
createdAt: files.createdAt,
})
.from(files)
- .orderBy(desc(files.createdAt))
- .limit(100)
+ .where(where)
+ .orderBy(desc(files.createdAt), desc(files.id))
+ .limit(FILES_PER_PAGE)
+ .offset((page - 1) * FILES_PER_PAGE)
.all()
+
+ // 4. 表示中の行のタグをまとめて取得(1行ごとに問い合わせない)
+ const tagsByFile = new Map<string, string[]>()
+ if (rows.length > 0) {
+ const tagRows = db
+ .select({ fileId: fileTags.fileId, name: tags.name })
+ .from(fileTags)
+ .innerJoin(tags, eq(tags.id, fileTags.tagId))
+ .where(inArray(fileTags.fileId, rows.map((r) => r.id)))
+ .orderBy(tags.name)
+ .all()
+ for (const t of tagRows) {
+ tagsByFile.set(t.fileId, [...(tagsByFile.get(t.fileId) ?? []), t.name])
+ }
+ }
+
+ return {
+ items: rows.map((r) => ({ ...r, tags: tagsByFile.get(r.id) ?? [] })),
+ total,
+ page,
+ perPage: FILES_PER_PAGE,
+ totalPages: Math.max(1, Math.ceil(total / FILES_PER_PAGE)),
+ }
})
実装のポイントは次のとおりです。
getValidatedQueryで検証する:h3 の関数で、クエリ文字列を取り出して検証関数に渡します。ここでは zod のsafeParseを渡し、失敗したら「検索条件が正しくありません」とだけ返します。zod のエラー詳細をそのまま返すと内部の構造が見えてしまうためです。- SQLに値を直接つなげない:Drizzle の
sqlテンプレートやeqなどに渡した値は、プレースホルダー(=SQL文とは別に値を渡す仕組み)として扱われます。文字列を連結してSQLを作ると、SQLインジェクション(=入力に仕込んだ命令でDBを不正に操作される攻撃)の原因になります。 %と_をエスケープする:LIKE 検索では%(任意の文字列)と_(任意の1文字)が特別な意味を持ちます。「100%」で検索したら全件が出た、とならないよう、ESCAPE '\'を付けて文字として扱います。- 並び順を一意にする:登録日時が同じファイルがあると、ページをまたいで順番が入れ替わることがあります。
idを2番目の並び順に加えて順序を固定しています。
📰 出典:Drizzle ORM 公式ドキュメント Filters
アップロード時にタグを登録する
アップロードAPI(server/api/files.post.ts)では、任意の tags フィールドを受け取り、ファイル情報とタグを1つのトランザクション(=全部成功するか、全部取り消すかのまとまり)で登録します。
server/api/files.post.ts に次の変更を加えます(+ が追加、- が削除)。
--- a/server/api/files.post.ts
+++ b/server/api/files.post.ts
@@ -1,5 +1,6 @@
import { randomUUID } from 'node:crypto'
-import { files } from '../db/schema'
+import { inArray } from 'drizzle-orm'
+import { fileTags, files, tags } from '../db/schema'
export default defineEventHandler(async (event) => {
const { maxUploadBytes } = useRuntimeConfig(event)
@@ -18,6 +19,9 @@ export default defineEventHandler(async (event) => {
throw createError({ statusCode: 400, statusMessage: 'file フィールドにPDFを指定してください' })
}
+ // 任意の "tags" フィールド(カンマ区切り)
+ const tagNames = parseTagInput(parts?.find((part) => part.name === 'tags')?.data.toString('utf8'))
+
// 3. サイズ・拡張子・MIME・先頭バイトを検証し、pdf-lib で読めるか(ページ数)を確認
assertPdfFile(file, maxUploadBytes)
const info = await inspectPdf(file.data)
@@ -40,7 +44,15 @@ export default defineEventHandler(async (event) => {
createdAt: new Date(),
}
try {
- useDb().insert(files).values(row).run()
+ // ファイル行とタグの登録を1つのトランザクションで行う(途中で失敗したら全部取り消し)
+ useDb().transaction((tx) => {
+ tx.insert(files).values(row).run()
+ if (tagNames.length > 0) {
+ tx.insert(tags).values(tagNames.map((name) => ({ name }))).onConflictDoNothing().run()
+ const tagIds = tx.select({ id: tags.id }).from(tags).where(inArray(tags.name, tagNames)).all()
+ tx.insert(fileTags).values(tagIds.map((t) => ({ fileId: id, tagId: t.id }))).run()
+ }
+ })
} catch (err) {
await storage.delete(storageKey)
throw err
@@ -52,5 +64,6 @@ export default defineEventHandler(async (event) => {
originalName: row.originalName,
size: row.size,
pageCount: row.pageCount,
+ tags: tagNames,
}
})
すでにあるタグ名は onConflictDoNothing() で重複登録を避け、改めてIDを引き直して対応表に登録します。アップロード画面には「タグ(カンマ区切り・任意)」の入力欄を追加します。
app/pages/files/upload.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/files/upload.vue
+++ b/app/pages/files/upload.vue
@@ -6,12 +6,14 @@ interface UploadResult {
originalName: string
size: number
pageCount: number
+ tags: string[]
}
const config = useRuntimeConfig()
const maxBytes = config.public.maxUploadBytes
const selected = ref<File | null>(null)
+const tagInput = ref('')
const uploading = ref(false)
const message = ref('')
const result = ref<UploadResult | null>(null)
@@ -34,6 +36,7 @@ async function upload() {
if (!selected.value) return
const body = new FormData()
body.append('file', selected.value)
+ body.append('tags', tagInput.value)
uploading.value = true
message.value = ''
try {
@@ -52,7 +55,10 @@ async function upload() {
<section>
<h1>PDFのアップロード</h1>
<p>PDFファイル({{ Math.floor(maxBytes / 1024 / 1024) }}MBまで)を選択してください。</p>
- <input type="file" accept="application/pdf,.pdf" @change="onChange">
+ <p><input type="file" accept="application/pdf,.pdf" @change="onChange"></p>
+ <p>
+ <label>タグ(カンマ区切り・任意) <input v-model="tagInput" type="text" placeholder="見積書, 2026年度"></label>
+ </p>
<button type="button" :disabled="!selected || uploading" @click="upload">
{{ uploading ? '送信中…' : 'アップロード' }}
</button>
@@ -62,6 +68,7 @@ async function upload() {
<dt>ファイル名</dt><dd>{{ result.originalName }}</dd>
<dt>サイズ</dt><dd>{{ result.size.toLocaleString() }} バイト</dd>
<dt>ページ数</dt><dd>{{ result.pageCount }}</dd>
+ <dt>タグ</dt><dd>{{ result.tags.join('、') || '(なし)' }}</dd>
</dl>
<p v-if="result"><NuxtLink to="/files">ファイル一覧へ</NuxtLink></p>
</section>
一覧画面:検索フォームとページ送り
app/composables/useFiles.ts:URLと検索条件をつなぐ
画面側では、URLの読み書きとAPI呼び出しを composable(=画面の部品から使い回せる処理のまとまり。app/composables/ に置くと自動で使える)にまとめます。
app/composables/useFiles.ts を新しく作ります(app/composables フォルダも作ります)。
// app/composables/useFiles.ts
import type { LocationQuery } from 'vue-router'
/** 検索フォームの入力値(すべて文字列。空文字は「指定なし」) */
export interface FileSearchForm {
q: string
tag: string
from: string
to: string
}
function first(value: LocationQuery[string] | undefined): string {
const v = Array.isArray(value) ? value[0] : value
return typeof v === 'string' ? v : ''
}
/**
* ファイル一覧の検索条件を URL のクエリ文字列で管理する composable。
* URL が「状態の置き場所」なので、ブックマーク・共有・再読み込みでも同じ結果になる。
*/
export function useFiles() {
const route = useRoute()
const router = useRouter()
// APIに渡すクエリは URL のクエリそのもの(検証はサーバーの zod で行う)
const query = computed(() => route.query)
const { data, status, error, refresh } = useFetch('/api/files', { query })
/** 現在の URL から、フォームの初期値を作る */
function currentForm(): FileSearchForm {
return {
q: first(route.query.q),
tag: first(route.query.tag),
from: first(route.query.from),
to: first(route.query.to),
}
}
/** 検索条件を URL に反映する(空の条件は URL に出さない。検索し直したら1ページ目へ) */
function search(form: FileSearchForm) {
const next: Record<string, string> = {}
for (const [key, value] of Object.entries(form)) {
if (value.trim() !== '') next[key] = value.trim()
}
return router.push({ query: next })
}
/** ページを移動する(他の条件はそのまま) */
function goToPage(page: number) {
return router.push({ query: { ...route.query, page: String(page) } })
}
return { data, status, error, refresh, currentForm, search, goToPage }
}
useFetch の query に URL のクエリを computed で渡しているのがポイントです。URLが変わると自動でAPIを呼び直すため、「検索ボタンを押したらAPIを呼ぶ」処理を別に書く必要がありません。画面側はURLを変えるだけです。
app/pages/files/index.vue:フォームと結果
app/pages/files/index.vue に次の変更を加えます(+ が追加、- が削除)。
--- a/app/pages/files/index.vue
+++ b/app/pages/files/index.vue
@@ -1,8 +1,20 @@
<script setup lang="ts">
useHead({ title: 'ファイル一覧 | PDF管理システム' })
-// サーバーAPIの戻り値の型は Nuxt が推論する(createdAt は JSON で文字列になる)
-const { data: rows, status, error, refresh } = await useFetch('/api/files')
+// useFetch はサーバー描画時にも実行され、結果がHTMLに含まれる
+const { data, status, error, currentForm, search, goToPage } = useFiles()
+
+// フォームの入力値。URL が変わったら(戻る・進む等)フォームも合わせる
+const form = reactive(currentForm())
+const route = useRoute()
+watch(() => route.query, () => Object.assign(form, currentForm()))
+
+function onSubmit() {
+ search({ ...form })
+}
+function clear() {
+ search({ q: '', tag: '', from: '', to: '' })
+}
function formatSize(bytes: number): string {
if (bytes < 1024) return `${bytes} B`
@@ -23,41 +35,64 @@ function formatDate(value: string): string {
<template>
<section>
<h1>ファイル一覧</h1>
- <p>
- <NuxtLink to="/files/upload">PDFをアップロード</NuxtLink>
- / <button type="button" @click="() => refresh()">再読み込み</button>
- </p>
+ <p><NuxtLink to="/files/upload">PDFをアップロード</NuxtLink></p>
+
+ <form class="search" @submit.prevent="onSubmit">
+ <label>ファイル名 <input v-model="form.q" type="search" maxlength="100"></label>
+ <label>タグ <input v-model="form.tag" type="text" maxlength="30"></label>
+ <label>登録日 <input v-model="form.from" type="date"> 〜 <input v-model="form.to" type="date"></label>
+ <button type="submit">検索</button>
+ <button type="button" @click="clear">条件をクリア</button>
+ </form>
+
<p v-if="status === 'pending'">読み込み中…</p>
- <p v-else-if="error">一覧を取得できませんでした。</p>
- <p v-else-if="!rows || rows.length === 0">まだファイルがありません。</p>
- <table v-else class="files">
- <thead>
- <tr>
- <th>ファイル名</th>
- <th>サイズ</th>
- <th>ページ数</th>
- <th>登録者</th>
- <th>登録日時</th>
- </tr>
- </thead>
- <tbody>
- <tr v-for="row in rows" :key="row.id">
- <td>
- {{ row.originalName }}
- <small v-if="row.isEncrypted">(パスワード付き)</small>
- </td>
- <td class="num">{{ formatSize(row.size) }}</td>
- <td class="num">{{ row.pageCount }}</td>
- <td>{{ row.uploadedBy ?? '—' }}</td>
- <td>{{ formatDate(row.createdAt) }}</td>
- </tr>
- </tbody>
- </table>
+ <p v-else-if="error">
+ {{ error.statusCode === 400 ? '検索条件が正しくありません。' : '一覧を取得できませんでした。' }}
+ </p>
+ <template v-else-if="data">
+ <p>{{ data.total.toLocaleString() }} 件中 {{ data.page }} / {{ data.totalPages }} ページ</p>
+ <p v-if="data.items.length === 0">該当するファイルはありません。</p>
+ <table v-else class="files">
+ <thead>
+ <tr>
+ <th>ファイル名</th>
+ <th>タグ</th>
+ <th>サイズ</th>
+ <th>ページ数</th>
+ <th>登録者</th>
+ <th>登録日時</th>
+ </tr>
+ </thead>
+ <tbody>
+ <tr v-for="row in data.items" :key="row.id">
+ <td>
+ {{ row.originalName }}
+ <small v-if="row.isEncrypted">(パスワード付き)</small>
+ </td>
+ <td>
+ <NuxtLink v-for="t in row.tags" :key="t" :to="{ query: { tag: t } }" class="tag">{{ t }}</NuxtLink>
+ </td>
+ <td class="num">{{ formatSize(row.size) }}</td>
+ <td class="num">{{ row.pageCount }}</td>
+ <td>{{ row.uploadedBy ?? '—' }}</td>
+ <td>{{ formatDate(row.createdAt) }}</td>
+ </tr>
+ </tbody>
+ </table>
+ <nav class="pager">
+ <button type="button" :disabled="data.page <= 1" @click="goToPage(data.page - 1)">前へ</button>
+ <span>{{ data.page }} / {{ data.totalPages }}</span>
+ <button type="button" :disabled="data.page >= data.totalPages" @click="goToPage(data.page + 1)">次へ</button>
+ </nav>
+ </template>
</section>
</template>
<style scoped>
+.search { display: flex; flex-wrap: wrap; gap: 8px 16px; align-items: center; margin-bottom: 16px; }
.files { border-collapse: collapse; width: 100%; }
.files th, .files td { border-bottom: 1px solid #e5e7eb; padding: 8px; text-align: left; }
.files .num { text-align: right; }
+.tag { display: inline-block; margin-right: 4px; padding: 0 6px; border-radius: 4px; background: #eef2ff; font-size: 0.85em; }
+.pager { display: flex; gap: 12px; align-items: center; margin-top: 16px; }
</style>
登録日の入力には、ブラウザ標準の日付入力(type="date")を使っています。値は YYYY-MM-DD 形式になるので、サーバー側の検証ルールとそのまま対応します。
動作確認の方法
結果の件数を下の表と見比べられるよう、DBとアップロード先を一度空にしてから始めます(これまでに登録したファイルは消えます)。
rm -rf data uploads
npm run db:migrate
npm run build
node .output/server/index.mjs
筆者の環境では、3ページのPDFを「見積書_1.pdf〜見積書_25.pdf(タグ:見積書, 2026年度)」として25件、「請求書_1_100%.pdf」など3件(タグ:請求書、登録日時を2026年7月15日に書き換え)を登録し、APIと画面を確認しました。
同じデータは、別のターミナルでプロジェクトのフォルダに移り、次のコマンドで登録できます(test-files/sample.pdf は第1回で作った3ページのPDFです)。最後の node -e は、better-sqlite3 で DB を直接開いて、請求書3件の登録日時を書き換えています。
for i in $(seq 1 25); do
curl -s -o /dev/null -F "file=@test-files/sample.pdf;filename=見積書_$i.pdf" -F "tags=見積書, 2026年度" http://localhost:3000/api/files
done
for name in "請求書_1_100%.pdf" "請求書_2_50%.pdf" "請求書_3_10%.pdf"; do
curl -s -o /dev/null -F "file=@test-files/sample.pdf;filename=$name" -F "tags=請求書" http://localhost:3000/api/files
done
node -e "
const db = require('better-sqlite3')('data/app.db')
const t = Math.floor(Date.parse('2026-07-15T10:00:00+09:00') / 1000)
console.log(db.prepare(\"UPDATE files SET created_at = ? WHERE original_name LIKE '請求書%'\").run(t).changes, '件の登録日時を変更')
"
# 確認の例(日本語や % は --data-urlencode で URL 用に変換して送る)
curl -G http://localhost:3000/api/files --data-urlencode "q=見積" -d page=2
curl -G http://localhost:3000/api/files --data-urlencode "q=%"
curl "http://localhost:3000/api/files?page=-1" # 400
| リクエスト | 結果 |
|---|---|
/api/files | 28件中 1/2ページ、20件 |
/api/files?page=2 | 8件 |
/api/files?q=見積&page=2 | 25件中 2/2ページ、5件 |
/api/files?q=% | 3件(% を含むファイル名だけ。全件にならない) |
/api/files?tag=請求書 | 3件 |
/api/files?from=2026-07-01&to=2026-07-15 | 3件(終了日当日の登録も含む) |
/api/files?to=2026-07-14 | 0件 |
page=-1、page=abc、from=2026-02-30、開始日>終了日、page=1&page=2 | いずれも 400 |
/files?q=見積&page=2 を直接開く | サーバー描画のHTMLに「25 件中 2 / 2 ページ」と該当ファイルが出る |
/files?page=-1 を直接開く | 「検索条件が正しくありません。」と表示 |
| タグ11個でアップロード | 400 |
ブラウザでフォームを操作して検索する流れ(ボタン操作・戻る/進む)は筆者の環境では実施していません。お手元で確認してください。
つまずきやすい点
- 日付の境界とタイムゾーン:「7月15日まで」をそのまま
<= 2026-07-15 00:00とすると、15日の登録が漏れます。「翌日0時より前」で比較し、日付は日本時間として解釈しています。サーバーのタイムゾーン設定に依存しない書き方にしておくと、クラウドに移したときにずれません。 - OFFSET方式のページングの限界:
LIMIT/OFFSETは分かりやすい反面、ページが深くなるほど遅くなり、閲覧中に新しいファイルが登録されると件がずれることがあります。数万件程度までは実用上問題になりにくいですが、それ以上なら別の方式(最後に見た行を基準に続きを取る方式)を検討します。 - 部分一致検索の速さ:
LIKE '%見積%'のような前後の部分一致は索引が効きにくく、件数が増えると遅くなります。大量のファイルで高速な検索が必要なら、SQLite の全文検索機能や専用の検索エンジンを検討します。 - この時点ではまだ誰でも一覧を見られる:ログインは第4回、権限は第5回で追加します。
発注者向けメモ:「検索」の範囲を要件で分けておく
「PDFを検索できるようにしたい」という要望には、実は難しさの違う2種類が含まれています。
| 種類 | 例 | 難しさ |
|---|---|---|
| ファイル情報の検索 | ファイル名・タグ・登録日・登録者で探す | 今回の実装の範囲。DBの検索で対応できる |
| 本文の全文検索 | PDFの中に書かれた「〇〇株式会社」で探す | PDFからの文字の取り出し、検索用の索引が別途必要。スキャンPDFは文字認識(OCR)も必要 |
本文の全文検索は、今回の仕組みとは別の機能として見積もられるのが一般的です。要件定義の段階で、どちらを求めているのかを明確に分けてください。
- どの項目で探すことが多いか:現場の人が普段どう探しているか(取引先名、案件番号、日付など)を聞き、それを一覧の項目やタグとして持たせます。
- タグを誰が管理するか:自由入力にすると「見積書」「見積り」「見積」のような表記ゆれが起きます。あらかじめ決めた候補から選ぶ方式にするかを決めておきます。
- 件数の見込み:数年分でどのくらいの件数になるかを伝えると、ページングや検索方式の設計が適切になります。
打ち合わせでは、次のように聞いてみてください。
- 「この検索は、ファイル名などの登録情報だけが対象ですか?PDFの本文も対象ですか?」
- 「検索結果のURLを共有したり、ブックマークしたりできますか?」
- 「タグの表記ゆれを防ぐ仕組みはありますか?タグ名を後から変更・統合できますか?」
- 「5年後に件数が今の10倍になっても、検索の速さは保てますか?」
まとめと次回予告
第3回では、ファイル一覧に検索・絞り込み・ページングを追加しました。
- 検索条件はURLのクエリ文字列に持ち、再読み込み・共有・戻る操作に強くする
- クエリ文字列は zod で検証し、不正な値は 400 で断る
- 値はプレースホルダーで渡し、LIKE の
%と_はエスケープする - タグは tags と file_tags の2テーブルで持ち、登録はトランザクションで行う
次回は「ログイン機能を入れる」です。nuxt-auth-utils を使ってID・パスワードでのログインを実装し、未ログインでは一覧もAPIも使えないようにします。ファイル一覧の「登録者」列も、ここで埋まるようになります。
この連載の記事一覧
この記事は連載「Nuxtで作るPDF管理システム」の1回です。連載のほかの回は次のとおりです(連載の一覧ページ)。
- 【Nuxtで作るPDF管理システム 第0回】全体像とNuxt 4プロジェクトの土台づくり
- 【Nuxtで作るPDF管理システム 第1回】PDFをアップロードして安全に保存する
- 【Nuxtで作るPDF管理システム 第2回】ファイル情報をDBに持ち、一覧を表示する
- 【Nuxtで作るPDF管理システム 第3回】検索・絞り込み・ページングをつける(この記事)
- 【Nuxtで作るPDF管理システム 第4回】ログイン機能を入れる
- 【Nuxtで作るPDF管理システム 第5回】権限管理と「認可つきダウンロード」
- 【Nuxtで作るPDF管理システム 第6回】ブラウザでPDFをプレビューする
- 【Nuxtで作るPDF管理システム 第7回】PDFの結合と分割
- 【Nuxtで作るPDF管理システム 第8回】注釈・スタンプ・署名画像を貼る
- 【Nuxtで作るPDF管理システム 第9回】PDFフォーム(AcroForm)に入力する
- 【Nuxtで作るPDF管理システム 第10回】見積書・請求書をデータから生成する
- 【Nuxtで作るPDF管理システム 第11回】本番運用へ:S3への切り替えとデプロイ










コメント
コメント一覧 (1件)
[…] 前回の第3回:検索・絞り込み・ページングをつけるでは、ファイル一覧にキーワード・タグ・期間での絞り込みとページングを追加しました。今回はその一覧とアップロードを、ログインした人だけが使えるようにします。あわせて、空欄だった一覧の「登録者」列も埋まるようになります。 […]