blog-api で使われているクエリの playground

  • 対象: apps/blog-api/adapter/src/repository/*.rs（health / users / articles / users_articles / users_moments）

  • 調査日: 2026-07-16

  • きっかけ: MySQL Workbench で実クエリをそのまま流して EXPLAIN や結果を確認したい

使い方

各 *.sql は MySQL Workbench で開いてそのまま実行できるように、Rust 側の sqlx::query(...).bind(...) のプレースホルダ ? をセッション変数 @param に置換してある。ファイル冒頭の SET @foo = 'xxx'; を実データに合わせて書き換えてから流す。

  • 接続先: mysql://root@tidb.<tailnet>:4000/blog_dev（詳細は docs/source/01_開発ドキュメント/03_database.md）

  • サンプル user_name は shuntaka、サンプル slug は 20260108-shuntaka-blog-rearchitecture を使っている

  • 記事一覧 / ファセット / ベクトル検索は動的組み立てクエリのため、代表パターン（フィルタなし・タグ 1 件 AND・タグ 2 件 AND・タグ 2 件 OR）を展開して並べている

  • 更新系（INSERT / UPDATE / DELETE）は playground 内で流すとデータが変わる。START TRANSACTION; ... ROLLBACK; で囲む前提

ファイル

ファイル

出典 (adapter/src/repository/)

概要

00_health.sql

health.rs

SELECT 1 ヘルスチェック

01_users.sql

users.rs

github_installation_id から user 解決

02_articles_admin_read.sql

articles.rs

管理側: user_id + slug から記事詳細（タグは再帰 CTE）

03_articles_admin_write.sql

articles.rs

管理側: articles の INSERT / UPDATE

04_articles_tags_sync.sql

articles.rs

管理側: articles_tags の DELETE ALL + INSERT IGNORE 同期

05_tag_article_counts_sync.sql

articles.rs

管理側: tag_article_counts の user 単位再集計

06_users_articles_list.sql

users_articles.rs

公開側: user 単位記事一覧（フィルタなし / AND / OR）

07_users_articles_detail.sql

users_articles.rs

公開側: user_name + slug から記事詳細

08_users_articles_search.sql

users_articles.rs

公開側: TiFlash HNSW を使ったベクトル検索

09_tag_facets.sql

users_articles.rs

公開側: タグファセット集計（フィルタなし / with フィルタ）

10_users_moments_list.sql

users_moments.rs

公開側: moments 一覧（カーソルなし / カーソルあり）

注意

  • LIMIT / OFFSET は MySQL / TiDB 仕様でセッション変数 @var を受け付けない（リテラル整数 or prepared placeholder のみ）。playground では LIMIT 20 OFFSET 0 のように直接数値を書き換える運用にしている

  • WITH RECURSIVE は MySQL 8.0+ / TiDB 6.x+ で有効。Workbench の古い接続では拒否される

  • /*+ USE_INDEX(...) */ / /*+ READ_FROM_STORAGE(TIFLASH[c]) */ / /*+ MAX_EXECUTION_TIME(...) */ は TiDB 固有ヒント。stock MySQL では単なるコメント扱い

  • VEC_COSINE_DISTANCE / VECTOR(2048) / article_embedding_chunks は TiDB Vector 機能。08_users_articles_search.sql は TiDB 以外では実行不可

  • article_embedding_chunks.embedding は 2048 次元の PLaMo Embedding。playground では [0, 0, ...] 相当のダミー vector を渡している