Supabaseが「Explorer」を公開　ログとDBを1画面で調べ手順を残す

Supabaseは10月31日、管理画面の新しいクエリーエディター「Explorer」を公式のXアカウントで発表した。データベースだけでなくログにも同じ画面からSQLを投げられる。あわせて、調べたクエリーとメモを1つのファイルにまとめる「Notebooks」も入った。ファイルはプロジェクトのsupabaseフォルダーに置かれるので、本番の不具合を調べた手順を、チームの人もコーディングエージェントも同じ形で走らせ直せる。

ログとDBを1つの画面で調べる

Supabaseの公式ブログによると、これまで本番の問題を調べる時は、ログ、利用量のグラフ、データベースのレポートを別々に読み、つながりは自分の頭の中で組み立てるしかなかった。ログは問い合わせの書き方もデータベースと違う。Explorerでは、調べる先を選んでSQLを書けば、結果が表かグラフで出る。

ログへのクエリーはそれぞれ自分の時間の範囲を持つ。だから、エラーを見つけたクエリーと遅いリクエストを見つけたクエリーを、何も書き出さずに並べて見比べられる。SQLを書くのが手間なら、管理画面に組み込まれたチャットの「Supabase Assistant」に普通の言葉で頼めば、同じエディターの中にクエリーを書いてくれる。走らせる前に読んで直せる。

Explorerは試験提供の段階で、今日からすべてのプロジェクトで使える。管理画面の「Feature Previews」でオンにすると、サイドバーのSQL Editorと置き換わる。

調べた手順をNotebookで残す

Notebookは、種類の違うクエリーをセルとして並べ、その間の考えをMarkdownのメモで書き添える文書だ。どのクエリーのセルも、結果をグラフにできる。保存するのは結果ではなくクエリーなので、後で開いて走らせると、いつもその時のデータが返る。

ブログは、調べ物のよくある終わり方を、Slackに答えを1つ書き、名前の無いクエリーの断片が誰にも見つからなくなる形だと書く。Notebookなら作業が残る。同じプロジェクトの別の人が続きから引き継げるし、デプロイの後に同じ確かめを走らせて、数字が思ったとおりに動いたかを見られる。

エージェントに走らせ、変更は人が承認

Supabase AssistantはExplorerの中でも動く。調べ物を頼むと、Notebookのセルを書いて走らせ、後で使えるように保存する。ただし、作るのも直すのも、保存の前に必ず人の承認を待つ。承認するのは、1行ずつ読めるSQLとMarkdownだ。セルを1つだけ直すよう頼めば、そのセルだけを書き換える。

AIを使わなくてもよい。ExplorerはAIの機能を使わない普通のSQLの作業場として使え、Notebookも全部手で書ける。

Xの投稿は、Notebookを自分で走らせても、エージェントに走らせてもよいと書いた。ブログも、日々の見張りの一部としてエージェントにNotebookを走らせる使い方を挙げている。

Notebookはリポジトリに置く

Notebookはsupabaseフォルダーの中のファイルなので、プロジェクトのほかのファイルと同じに扱える。版が管理され、プルリクエストでレビューされ、リポジトリを複製した人の手元にも届く。管理画面で作ってCLIで手元に引き下ろすことも、手元で書いて押し上げ、管理画面に出すこともできる。手元で書く時は、自分のコーディングエージェントに書かせてもよい。使うコマンドは「supabase notebooks pull」と「supabase notebooks push」で、今はCLIのベータ版で使える。結果はファイルに入らないので、同じNotebookをどのブランチにも当てられる。

つまり、本番を調べた手順が、SQLとメモのファイルとしてコードと同じ場所に残る。人が見つけた確かめ方を、次はエージェントが同じ形でくり返せるようになる。

編集部の見方

小さなチームでは、障害の調べ方が書いた人の頭の中とSlackの流れに埋もれやすい。調べたクエリーがリポジトリに残り、プルリクエストでレビューできれば、次に同じことが起きた時は、エージェントにそのNotebookを走らせるところから始められる。まずは、よく見るエラーの調べ方を1本Notebookにし、デプロイの後の確かめに使ってみるのがよい。Assistantの書くSQLは承認の前に読めるが、ログに利用者のデータが混じる点は、エージェントに走らせる前に確かめておきたい。