データベース

このガイドでは、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 を使って現在のテーブル内を検索するか、Filter を選択して 1 つ以上のフィールドで結果を絞り込みます。
4. テーブルの下にあるページ矢印コントロールを使って、追加の行を表示します。
5. テーブルの構造を確認するには、••• メニューを開いて Schema を選択します。

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

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

変更を加えたいデータベースを見つけたら、次の操作を使用できます。

操作	方法
行を追加	Open... を開き、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 または件数の例を提供してください。

データを失わずに、ある Atoms プロジェクトから別のプロジェクトへデータベースを移動できますか？

Atoms は現在、プロジェクト間での自動かつ無損失のデータベース移行をサポートしていません。新しいプロジェクトを作成したり、既存のプロジェクトを分割したりしても、既存のユーザーアカウントやデータベースレコードが新しいプロジェクトに自動的にコピーされることはありません。

進める前に:

• 既存のデータベースまたはプロジェクトリソースをリセット、置換、移行、削除しないでください。
• 元のプロジェクトは既存データのソースとして変更せずに保持してください。
• Atoms Support に連絡し、移行元プロジェクト、移行先プロジェクト、データベースプロバイダー、保持が必要なデータを伝えてください。

場合によっては、チームが移行元データベースから移行先データベースへの一度限りの手動コピーを支援できることがあります。これは継続的な同期ではありません。コピー開始後に移行元へ書き込まれた新しいデータは、移行先に自動的には反映されません。

データ差分を最小限に抑えるため、移行時間帯の間は移行元データベースへの書き込みを停止し、切り替える前に移行先プロジェクトでコピーされたデータを確認してください。完全に無損失な移行は、現時点では保証できません。