Atoms クラウド データベースは、商品、予約、注文、フォーム送信、ユーザー生成コンテンツなど、アプリが依存する構造化データを保存および管理します。データベースモジュールでは、環境とテーブルの表示、レコードの検索と編集、テーブル構造の確認、CSV ファイルを使用したデータのインポートまたはエクスポートを行えます。

このガイドでは、Atoms クラウドに組み込まれているデータベースについて説明します。プロジェクトで Supabase を使用している場合は、代わりにSupabase 連携をご覧ください。

データベースを開く

データベースを開く前に、プロジェクトをAtoms クラウドに接続してください。まだ接続されていない場合は、Atoms クラウドの接続手順に従ってください。

1. デスクトップ端末でプロジェクトを開きます。
2. App ビューアー があるのと同じワークスペースのツールバーで、Atoms クラウドを選択します。
3. Atoms クラウドのサイドバーでデータベースを選択します。
4. Databasesの下で、確認したいデータベースを選択します。プロジェクトで利用可能な場合、DevelopmentおよびProductionのデータベースカードが表示されます。

各データベースカードには、使用中のストレージ量と利用可能な合計容量が表示されます。アプリの構築とテスト中はDevelopmentを使用してください。Productionで行った変更は公開中アプリのデータに影響する可能性があるため、変更を行う前に必ず現在どの環境にいるかを確認してください。

Development または Production データベースを選択します。

テーブルデータを参照して絞り込む

1. 作業したい環境に応じて、DevelopmentまたはProductionのデータベースカードを選択します。
2. Search tablesを使ってテーブルを見つけるか、一覧から直接選択します。各テーブルカードには、行数と読み取り専用かどうかが表示されます。
3. 現在のテーブル内を検索するにはSearch rowsを使用し、1 つ以上のフィールドで結果を絞り込むにはFilterを選択します。
4. テーブルの下にあるページ矢印コントロールを使用して、追加の行を表示します。
5. テーブル構造を確認するには、•••メニューを開いてSchemaを選択します。

Schemaビューには、各フィールドの名前、データ型、キーの状態、要件、制約、デフォルト値が表示されます。表示されているスキーマをコピーするにはCopyを選択します。

行を追加、編集、または削除する

変更したいデータベースが見つかったら、次の操作を使用できます。

操作	操作方法
行を追加	...を開いてAdd Rowを選択します。利用可能なフィールドに一致する値を入力し、その後行を送信します。
行を編集	セルをダブルクリックして新しい値を入力します。保留中の編集をすべて保存するにはCommit Changesを、破棄するにはDiscardを選択します。
行を削除	1 行以上を選択し、Deleteを選択してから確認します。行の削除は元に戻せません。

行の追加や削除の確認は、選択したデータベースに即座に適用されます。Commit ChangesまたはDiscardの選択が必要なのは、インラインのセル編集のみです。保留中の編集がある場合は、行の追加、CSV ファイルのインポートまたはエクスポート、検索やフィルターの変更、別ページへの移動の前に、編集をコミットまたは破棄してください。

プロジェクトがワークスペース内にある場合、書き込み可能なテーブルの行を編集できるのはEditorsとworkspace ownerのみです。Atoms がテーブルの主キーを検出できない場合、個々のレコードを確実に識別できないため、その行を編集または削除することはできません。

保留中の行編集を確認し、その後変更をコミットまたは破棄します。

テーブルを作成する、またはスキーマを変更する

更新したいデータベース環境を開き、行いたい変更に応じた手順に従ってください。

操作	操作方法
テーブルを作成	テーブル一覧で...をクリックし、Create tableを選択します。有効なテーブル名と初期フィールドを入力し、その後リクエストを送信します。エージェントの完了を待ってから、データベースを再度開き、テーブルを確認してください。
スキーマを変更	変更したいテーブルをクリックし、次に...をクリックしてSchema. を選択します。フィールドを作成するにはAdd Fieldを使用し、編集するには対象のフィールドを選択します。名前、型、デフォルト値、必須状態、一意性を変更できます。キーではないフィールドを削除対象としてマークすることもできます。リクエストをエージェントに送信するにはSubmit Changesを、保留中の変更をクリアするにはDiscardを選択します。

テーブルの作成やテーブルスキーマの変更ができるのはworkspace ownerのみです。

スキーマリクエストを送信しても、マイグレーションが完了したことにはなりません。エージェントの完了を待ち、データベースで結果を確認し、その後アプリをテストしてください。主キーフィールドと読み取り専用テーブルは、この方法では変更できません。

Add Field で新しいフィールドの詳細を入力します。

Submit Changes を選択する前に、保留中のスキーマ変更を確認します。

CSV データをインポートまたはエクスポートする

作業したいテーブルを選択し、該当する操作の手順に従ってください。

操作	操作方法
CSV をインポート	...をクリックしてImport CSVを選択します。10 MB 以下の.csvファイルを選択し、確認前にファイル名、推定行数、選択したテーブル、環境を確認します。CSV の列はテーブルスキーマと一致している必要があります。インポートされた行は即座に追加され、自動では元に戻せないため、先に既存データをエクスポートすることを検討してください。
CSV をエクスポート	...をクリックしてExport CSVを選択します。検索またはフィルターが有効な場合は、一致する行のみがエクスポートされます。それ以外の場合は、現在のテーブルのすべてのデータがエクスポートされます。

CSV ファイルをインポートまたはエクスポートできるのはworkspace ownerのみです。読み取り専用テーブルでは、利用可能なオプションはExport CSVのみです。

権限と保護されたテーブル

操作	実行できる人	追加要件
行の追加、編集、削除	Editor または workspace owner	テーブルは書き込み可能である必要があります。行の編集と削除には主キー情報も必要です。
テーブルの作成またはスキーマの変更	Workspace owner	主キーフィールドと読み取り専用テーブルは変更できません。
CSV ファイルのインポートまたはエクスポート	Workspace owner	CSV ファイルは読み取り専用テーブルにはインポートできません。

保護されたシステムテーブルまたはユーザーテーブルには、Read-onlyバッジが表示されることがあります。利用可能な場合はデータの表示やスキーマの確認はできますが、このページから行や構造を変更することはできません。

よくあるデータベースの問題を解決する

「No databases found」または「No tables found」

Atoms クラウドがプロジェクトに接続されていることを確認してください。すでに接続されている場合は、アプリに永続データを保存する機能が含まれていることを確認してください。必要に応じて、エージェントにデータベース対応機能の追加を依頼してください。エージェントの完了後、データベースを再度開くか、Refreshを選択してください。

データベース操作が表示されない、または利用できない

テーブルにRead-onlyバッジがあるか確認し、次に上記の権限を確認して、ワークスペースでの自分の役割がその操作を許可しているかを確認してください。行の編集と削除には主キー情報も必要です。

保留中の行編集が他の操作を妨げることがあります。行の追加、CSV ファイルのインポートまたはエクスポート、検索やフィルターの変更、別ページへの移動の前に、Commit ChangesまたはDiscardを選択してください。

これらを確認しても操作が利用できない場合は、Supportに連絡し、プロジェクトまたは Chat リンク、環境、テーブル、ワークスペースでの役割、試した操作、正確なエラーテキストを含めてください。

CSV ファイルをインポートできない

データをインポートできるのはworkspace ownerのみで、対象テーブルは書き込み可能である必要があります。次の点を確認してください。

• ファイルが.csv形式であること。
• ファイルサイズが 10 MB 以下であること。
• 列とデータが対象テーブルのスキーマに適合していること。
• 保留中の行編集をコミットまたは破棄していること。

それでもインポートに失敗する場合は、Supportに連絡し、プロジェクトまたは Chat リンク、環境、対象テーブル、ワークスペースでの役割、ファイル名とサイズ、試した操作、正確なエラーテキストを含めてください。

FAQ

本番データベースが同期されません。どうすればよいですか？

Development は正常に動作しているのに、ライブサイト（Production）でテーブルや列の欠落、またはマイグレーションエラーが表示される場合:

重要: 本番データベースを自分で再構築または上書きしないでください。

必要な情報:

• Chat リンクとライブ URL
• 完全な SQL エラーメッセージ
• 欠落しているテーブル名/列名
• 最後に行ったデータベーススキーマ変更
• 最後に正常動作していたライブバージョン
• 本番データを保持する必要があるかどうか
• Development データを完全に同期したいのか、不足している構造だけを補いたいのか

変更を行う前に Development/Production のバージョン、マイグレーション状態、スキーマ差分を比較できるよう、これらの詳細を添えてサポートに連絡してください。

開発データが本番データと異なるのはなぜですか？

複数回公開しているのに、コード更新は正常に反映される一方で Production には古いデータが表示されたままの場合:

サポートに連絡する前に、次を確認してください:

1. 現在の本番データを保持する必要がありますか？

2. 現在の Development データで完全に上書きしたいですか、それとも不足しているレコードだけを補いたいですか？

3. すでにバックアップはありますか？

4. 許容できるメンテナンス時間帯はどの程度ですか？

データの取り扱い方針が確認されるまで、本番データを上書きまたは再構築することはありません。Development/Production の URL と、差異を示すレコード ID や件数の例を提供してください。