データベース App とカスタム App の違い
- データベース App — 既定の種類です。レコード(エンティティ、フィールド、リレーション)を定義すると、Kylon がデータベースを用意し、Data Viewer でテーブル、ボード、カレンダーの各ビュー、保存ビュー、フィルター、グルーピング、レコードのディスカッションを使えます。ソースリポジトリやデプロイは不要です。
- カスタム App — 独自のソースコードを持つ App です。カスタム画面や、レコードの作成・参照・更新・削除を超える App 独自のロジックが必要なときに使います(カスタムページ、ダッシュボード、フォーム、ワークフロー画面、独自 API など)。カスタム App はドラフトから構築し、公開前にプレビューで確認します。
ライフサイクル
app createで App を作成する。--runtime-kind custom_appを指定しない限り、データベース App になります。- データベースをプロビジョニングし、スキーマを定義する。
app registerでエンティティとフィールドを登録し、Data Viewer と App API にデータの形を伝える。- 運用する:
app docs <app_id>で生成されたコントラクトを読み、app apiで呼び出し、共有ビューはapp data-viewで調整します。
従来のテーブル
App が登場する前、構造化データは独立したテーブルに置かれていました。既存のテーブルは、リソースごとの切り替え(カットオーバー)まで引き続き利用できます。table、row、field、view コマンドは、まだアップグレードされていないテーブルにのみ使えます。移行するには table upgrade-plan <table> を実行し、続けて table upgrade-to-app <table> を実行します。カットオーバー後は、置き換え先の App だけを使います。新しいテーブルは作成しないでください。
リファレンス
コマンド全体はkylon workspace app(英語)に記載されています。ワークスペースで最も大きなサブコマンドなので、フラグを覚えようとせず、生成されたリファレンスを参照してください。