バックエンドとデータ
アプリのデータベース
アプリがデータを保存するしくみ、管理 → データベースでデータを見て編集する方法、AIに安全にデータを確認・修正してもらう方法、SQLの実行、間違えたときに元に戻す方法を説明します。
予約、注文、メッセージ、一人ひとりが保存したアイテムなど、アプリが何かを覚えておく必要があるときは、データベースに保存します。Buildliyホスティングのアプリには、それぞれ専用の非公開のデータベースが自動で用意されます。インストールも設定も必要ありません。
このページでは、データが入るしくみ、データの見方と変更のしかた、AIにデータを手伝ってもらう方法、間違えたときに元に戻す方法を説明します。
データベースにデータが入るしくみ
たいていは、アプリに保存してほしいことを伝えるだけで、あとはAIがやってくれます。予約や商品、メンバーなど、種類ごとにテーブルを作り、データを読み取ったり保存したりする画面もビルドします。
お客さんがクラスと時間を選べる予約ページを追加してください。予約はすべて保存して、あとで確認できるようにしてください。
データが入る方法は、ほかにもあります。
- アプリを使う人。 アプリが保存する新規登録、注文、フォームの送信ごとに、行が1つ増えます。
- すでにあるデータ。 CSV、JSON、Excelのファイル(5 MBまで)をチャットに添付するか、ファイルへのリンクを送って、AIに読み込みを頼みます。テーブルの作成とデータの入力が一度に終わります。1回のインポートで読み込めるのは5,000行までです。Excelの場合は、最初に表示されているシートが使われます。
- 手作業で。 管理 → データベースで自分で行を追加します(くわしくは下の説明をご覧ください)。
商品リストのCSVを添付します。データベースに入れて、ショップのページに表示してください。
あなたが何も言っていなくても、アプリにアカウントとデータの保存が必要だとAIが判断することがあります。追加する前に、アプリにアカウントとデータの保存が必要ですというカードで確認することがあります。設定するをクリックすると追加されます。まだしないをクリックすると、わかりやすく表示したサンプルデータのまま作業を続けられます。詳しく知りたいをクリックすると説明が表示されます。
データベースのしくみ
- 非公開です。 データベースにアクセスできるのは、アプリ自身のサーバーコードだけです。訪問者のブラウザがデータベースと直接やり取りすることはないので、ページの中に、誰かがデータを読み取るのに使えるキーが入っていることもありません。
- プレビューには専用のテストデータがあります。 新しいアプリでは、プレビューでテストしながら保存した内容(テスト用の新規登録も含みます)は、実際の訪問者には見えないテストデータに入ります。公開したアプリには、専用の本番データがあります。テストデータと本番データをご覧ください。
- 以前に作ったアプリでは、プレビューと公開中のアプリが1つのデータベースを共有しています。 プレビューでテストしながら保存した内容は、公開中のアプリが使っているのと同じデータベースに入ります。アプリを公開すると、管理 → データベースに「プレビューと公開中のアプリは同じデータを使っているため、テスト中の変更は実際の訪問者にも表示されます。」とお知らせが出ます。
- クレジットで動きます。 データベースは、起動している時間、保存しているデータ、復元用の履歴、送信したデータに応じてクレジットを使います。誰もアプリを使っていないときは、スリープします。プランには毎月、無料のホスティングクレジットが含まれていて、先にそちらが使われます。ホスティングとクレジットと利用状況をご覧ください。
- クレジットがなくなると一時停止します。 まずアプリのデータベースが一時停止し、公開ページはその後さらに2日間オンラインのままです。何も削除されません。クレジットを追加すれば、すべて自動で再開します。
テストデータと本番データ
Buildliyホスティングの新しいアプリには、2種類のデータがあります。
- テストデータは、プレビューで使われるデータです。ビルド中にあなたやAI、Buildliyの「お客さまになってテスト」が保存した内容は、すべてここに入ります。実際の訪問者には見えません。
- 本番データは、公開したアプリが実際の訪問者のために使うデータです。
データタブ、管理 → データベース、SQLエディタの上部には、テストデータ / 本番データの切り替えがあります。アプリを公開する前はテストデータが表示され、公開後は最初に本番データが表示されます。管理 → ユーザーには、アプリを公開するまではテストデータのアカウントが、公開後は公開中のサイトのアカウントが表示されます。
公開すると、ビルド中にAIが作ったテーブルと列が、空の状態で公開中のサイトにコピーされます。公開ダイアログの公開サイトには専用のデータがありますの下に、そのリストが表示されます。行はコピーされません。そのため、メニューや商品リストなど、公開初日から公開中のサイトに表示したい内容は、アプリ自身から用意する必要があります。テーブルや列の追加・変更は、コピーされるようにチャットでAIに頼んでください。SQLで自分で追加したテーブルや列はコピーされません。どのテーブルや列なのかは公開ダイアログに表示され、本番データに同じ変更をするか、テストデータから削除するまで、公開は保留されます。
テストデータをやり直したいときは、テストデータを選んでテストデータをリセットをクリックします。テストデータがすべて削除され、公開中のサイトのテーブルをもとに、空の状態から始まります。公開中のサイトのデータには影響しません。この操作は元に戻せません。
テストデータには、専用の小さなデータベースがあります。アプリのホスティングクレジットを使うのは動いている間だけで、誰も使っていないときは一時停止します。
データを見る・変更する
データベースのセクションを開く
管理タブを開いて、データベースを選びます。左側にテーブルが一覧で表示され、それぞれの行数も出ています。
テーブルを選ぶ
テーブルをクリックすると、その行と列が表示されます。行を読み取り・変更できる人の下には、短い説明も出ています。
探しているものを見つける
行の上にある検索ボックスに入力すると、絞り込めます。ページを移動するには、前へと次へを使います。
ここからできることは、次のとおりです。
- 値を変更する。 値をクリックして新しい値を入力し、Enter を押すと保存、Esc を押すとキャンセルになります。保存するとメッセージが表示され、元に戻すボタンも出ます。
- 行を追加する。 行を追加をクリックして、フォームに入力します。必須の項目には印が付いています。
- 行を削除する。 行にチェックを付けて削除をクリックし、確認します。行はすぐにアプリから消えます。削除する前に、Buildliyはアプリのすべてのデータのバックアップを保存します(くわしくはバックアップと元に戻すをご覧ください)。
- テーブルをダウンロードする。 CSVをダウンロードをクリックすると、すべての行がスプレッドシートのファイルとして保存されます。先に検索してから一致分をダウンロードをクリックすると、一致した行だけが保存されます。パスワード、キー、そのほかの非表示の値は含まれません。1回のダウンロードで保存できるのは20,000行までです。それより大きいテーブルでは、何行が含まれたかがメッセージで表示されます。
パスワード、キー、そのほか秘密にすべき値は非表示になっていて、ここでは編集できません。アプリのログイン機能が管理しているテーブルなど、閲覧専用のテーブルもあります。id列のないテーブルは、検索とダウンロードはできますが、変更はできません。パスワードのように、アプリだけが入力できる値が必要なテーブルでは、新しい行はアプリ自身から作る必要があります。新しいテーブルを追加したり、テーブルの列を変更したりしたいときは、チャットでAIに頼んでください。
アプリが何を保存しているかをわかりやすい言葉でまとめて見るには、右上のワークスペースメニューを開いてデータを選びます。
AIにデータを確認・修正してもらう
データについてAIに質問したり、データの整理や形の変更を頼んだりすることが、チャットの中でそのままできます。
来週の予約は何件ありますか?
自分のメールアドレスで試しに新規登録したテスト用のアカウントを削除してください。
AIは、行を読み取る(1回に50行まで。メールアドレスと電話番号は一部が隠されます)、行を追加・変更・削除する、列を追加したり名前を変えたりする、といったことができます。小さくて安全な変更は、すぐに行われます。行を削除するとき、1回のビルドで20行を超える行を変更するとき、列の名前を変えるときは、AIはいったん止まって、「予約37件を削除します」のようなカードを表示します。カードにはキャンセルと、進めるためのボタンがあります。承認できるのはプロジェクトのオーナーだけです。AIは、変更の直前のデータのコピーを最大24時間保管します。
これらのデータ用ツールでは、テーブルをまるごと削除することはできません。新しいアプリでは、アプリを公開した後は本番データを、公開前はテストデータを操作します。どちらを使ったかは、AIが教えてくれます。以前に作ったアプリでは、プレビューと公開中のアプリが1つのデータベースを共有しているため、AIがデータに加えた変更は公開中のアプリにも影響します。
SQLを実行する
SQLがわかる方は、管理 → SQLエディタを開くと、アプリのデータベースに対してクエリを実行できます。
- SQLを入力して実行をクリックするか、CmdEnter(Mac)またはCtrlEnter(Windows)を押します。
- テーブルの削除、テーブルの中身の全消去、条件なしの行の削除や更新など、データを壊してしまう文は、破壊的な文です。実行前に確認してくださいと表示されて止まります。本当によいときだけこのまま実行をクリックしてください。バックアップがないと、元に戻せません。
- サンプルクエリには、そのまま使える3つのクエリがあります。テーブルを一覧表示、すべてのテーブルの行数を数える(正確な件数です)、RLSポリシーを表示です。
- システム用の領域には触れられず、
information_schemaやデータベース自身のpg_…テーブルなど、そこに触れるSQLはエディタが受け付けません。テーブルを見たいときは、代わりにスタータークエリを使ってください。 - 新しいアプリでは、一度に実行したものはすべて、全部成功するか全部取り消されるかのひとまとまりとして処理されます。そのため、
VACUUMのように、その方法では実行できないメンテナンス用のコマンドは、ここでは使えません。
新しいアプリでは、SQLエディタはテストデータ / 本番データの切り替えで選んだデータに対して動きます。以前に作ったアプリでは、公開中のアプリと同じデータに対して動きます。
誰が何を見られるか
アプリにアカウントがある場合、AIは、一人ひとりが保存したものがその人に結び付くようにビルドします。アプリのサーバーコードは、データを読み取ったり保存したりする前に、誰がログインしているかを確認します。
新しいアプリでは、データベースもこれを強制します。アプリは制限付きのログインでデータベースにつながり、ページが誰がログインしているかの確認を忘れたとしても、データベースは一人ひとりに自分の行だけを見せます。管理 → データベースとSQLエディタでは、これまでどおりすべての行が見られます。公開前チェックリストには、一人ひとりのデータはデータベースで守られていますと表示されます。人ごとのデータが入ったテーブルが保護されていない場合は、一部のユーザーのデータが本人だけに制限されていませんと表示されて、公開できなくなります。
以前に作ったアプリでは、この確認はアプリのコードの中だけにあるため、すべてのページとデータの接続がきちんと確認していることが前提になります。公開前チェックリストでは、各ユーザーのデータはアプリのコードで分けられていますと表示されます。これは提案で、公開を止めるものではありません。
新しいアプリで、アプリ自身のコードが関数、トリガー、ビュー、ルールなど独自のデータベース用コードを追加した場合、Buildliyは、管理 → データベース、管理 → ユーザー、SQLエディタ、AIのデータ用ツールで、そのデータの表示や変更をやめます。そのコードがデータベースへのフルアクセスで動いてしまうおそれがあるためです。「アプリ自身のコードが、Buildliyが安全に扱えない形でデータベースを変更しました」で始まるメッセージが表示されます。アプリがデータベースに追加したものを削除するようAIに頼むか、そのデータをアプリの中から管理してください。
メニューや商品リストのように、誰にでも見せたいデータは、公開にしておけます。頼むときにそう伝えてください。
アプリでこれがどう動いているかを確認するには、ワークスペースメニューを開いてロールを選びます。ユーザーの種類ごとに、何ができるかがわかりやすい言葉で一覧になっています。公開する前には、ログインしていない訪問者や、ログインしているすべてのアカウントに、人の情報を見せてしまうページやデータの接続がないかを、安全チェックでも調べます。見つかったと確実にわかった場合は、公開する前に直す必要があります。公開前チェックリストをご覧ください。ログインそのものについては、アプリのログイン機能をご覧ください。
バックアップと元に戻す
データを取り戻す方法はいくつかあります。
- 削除を元に戻す。 管理 → データベースで行を削除すると、アプリのすべてのデータのバックアップが24時間保管されます(新しい3件まで保管されます)。削除を元に戻すをクリックしてバックアップを選び、戻すをクリックし、確認のために戻すをもう一度クリックします。すべてのテーブルがその時点の状態に戻るため、その後に追加や変更があったもの、たとえば新しい注文や新規登録も取り消されます。戻す直前のデータは7日間保管されるので、そちらに切り替え直すこともできます。
- 管理 → バックアップ。 大きな変更の前に作られたデータのコピーが一覧になっています。データの巻き戻しの前のもの(7日間保管され、巻き戻しを取り消すがあります)と、あなたが承認したAIの変更の前のもの(最大24時間保管され、このデータに戻すがあります)です。AIがデータに加えた変更も、一覧に表示されます。
- データも一緒に復元する。 バージョン履歴から以前のバージョンを復元するとき、データのオプションにチェックを付けると、コードとデザインだけでなくデータも巻き戻せます。このオプションは初期設定ではオフで、データがBuildliyホスティングにあるアプリで、プロジェクトのオーナーにだけ表示されます。データの履歴をさかのぼれる期間には限りがあり、それより古いバージョンでは、コードだけを復元できます。バージョン履歴をご覧ください。
バックアップを見たりデータを戻したりできるのは、プロジェクトのオーナーだけです。
コードタブからダウンロードしたものでも、GitHubに送ったものでも、アプリのコードにはデータベースのデータは含まれません。データの自分用のコピーを持っておくには、CSVをダウンロードで各テーブルをダウンロードしてください。
自分のデータベースを使う
データを自分のSupabaseまたはNeonのアカウントに置きたい場合は、管理 → バックエンドでつなげられます。バックアップ、データの巻き戻し、一部のAIのデータ用ツールは、Buildliyホスティングでのみ使えます。自分のNeonプロジェクトを使う場合、管理 → データベースでデータを見る、検索する、ダウンロードすることはできますが、変更はNeon自身のダッシュボードで行います。自分のSupabaseプロジェクトを使う場合は、データの確認も変更もSupabaseのダッシュボードで行います。自分のバックエンドを使うをご覧ください。