MAD Designer iconMAD

マルチソースレポート — テーブルとしてのレポート、およびあらゆるもののためのドライバ

このページでは構成可能なレポートについて説明します。あるレポートの結果が、別のレポートがクエリできるテーブルになり、ドライバが行を返すあらゆるものを前面に置くことができます。これは設計記録であり、§8がフェーズを名指ししますが、すべてが構築されているわけではありません。

スコープ: ユーザーが2026-11-22に説明したアーキテクチャ。ユーザーがデータソース(MySQL、SQL Server、PostgreSQL、SQLite、またはeBayのSeller APIのようなWeb API)に対してレポートを設計し、そのレポートの結果がマテリアライズされたSQLiteテーブルとなり、別のレポートがそのレポートに対してクエリを設計できる——あるレポートの出力を別のレポートの出力に、そしてベースソースに、1つのクエリグラフで結合する。リフレッシュ時にエンジンはグラフをボトムアップで歩き、各リーフを自身のソースに対して実行し、各結果をマテリアライズし、最後にマテリアライゼーション上で合成クエリを実行します。非SQLドライバのシームもこの一部です。APIを前面に置くドライバはSQLテキストではなく構造化クエリを受け取り、行をテーブル形式で返します。 日付: 2026-11-22、eba4225a1で読了。決定は2026-11-22に反映(§9.2)。 ステータス: 設計レポート。アイデアと設計を述べるもので、何も実装せず、TASKS.mdに作業を追加しません。データオブジェクト半分の根拠となるコード監査はMAD_DATA_OBJECT.md、方向性はdocs/vision.mdです。このドキュメントは、マルチソース合成モデル(まずドキュメント内サブレポート)、非SQLソースを第一級にするドライバAPI、および統合されたフェーズ順を追加します。


1. アイデアを1ページで

レポートはデータソースからテーブルへの関数です。この設計で重要なアカウント対オーダーの区別は、すでにコードにあります。

拡張は結果をテーブルとしてアドレス可能にすることです。レポートの出力は、今日スキーマテーブルがソースであるのとまったく同じように、別のレポートのソースになります。レポートの上に構築されたレポートは派生テーブルのDAGです。レポートを設計することが再利用可能なデータソースを設計することでもある、ポータブルなセマンティックレイヤーです。

同じ拡張がマルチソースレポートを自然にします。各ソースオブジェクトは自身のデータベースまたはAPIに対して、自身のドライバと認証情報で実行され、自身のSQLiteテーブルにマテリアライズします。合成するオブジェクトはリモートサーバーではなくローカルキャッシュに対して実行され、マテリアライゼーションを結合します。フェデレーションエンジンは追加されません。スナップショットがフェデレーションです。

ユーザーの例: ある企業がeBay出品のレポートを望んでいます。1つのレポートオブジェクトがeBay Seller APIをクエリして出品をマテリアライズし、別のレポートが販売のために会社のMySQLデータベースをクエリし、合成レポートが2つの出力をSKUで結合します。各ドライバは自身のソースだけを知ります。結合はSQLiteで、ローカルに行われます。

非SQLドライバが最初のオブジェクトを可能にするものです。その契約はSQLドライバが満たすのと同じ「スキーマと行」契約ですが、その入力はクエリグラフであるべきで、パースしなければならないSQL文字列ではありません。

2. コードですでに真であること

高価な部分は存在します。MAD_DATA_OBJECT.md §3が詳細な監査であり、このレポートにとって負荷を支える事実は次のとおりです。

  1. 定義はグラフであり、ストアは多数を許容する。 RptqQueryはテーブル、フィールド、リンク、述語、グループを所有します。MADModelDocumentはRptqQueryごとに1つのMADModelDatabaseを構築し、コード自身の注記は現在のバージョンが1つを使うと述べています。基数はアプリのフローの慣習であり、ストアのものではありません(MAD_DATA_OBJECT.md §3.1)。
  2. コンパイラは存在し、決定論的である。 MADQueryFull -copySQLWithManagedObjectContext:error:(MAD/Source/MADQueryFull.m:133-273)はSELECTリスト、トポロジカルソートされたグラフからのFROM/JOINツリー、WHERE句、およびリミットを、ドライバの方言フックを通じて構築します。
  3. 実行シームはすでにテーブル形状である。 MADDatabaseの抽象点はexecuteSQL:fieldKeys:onConnection:intoResultTable:withError:(MADAPI/Source/MADDatabaseProtocol.h:33-34)であり、宛先は任意のid <MADDataTableWriting>で、具体的なテーブルクラスではありません。4つのドライバすべてが同じ方法で充填します。すべてのオブジェクトを削除し、列を追加し、バルク挿入し、行を追加します。
  4. マテリアライゼーションは実際のSQLiteテーブルである。 MADDataTableFastは<tag>.maddbとテーブルt<tag>を書き込みます(MADSqlite3/Source/MADDataTableFast.m:403-406、:463-467、:503-511)。スキーマplistは.mdcacheであり、行とスキーマは分離可能です(docs/05-companion-files.md §5)。SQLiteはすでにドライバ(MADSqlite3/Source/MADDatabaseSqlite3.m)であるため、「データベース」がキャッシュであるクエリは今日のコードであり、新しいコードではありません。
  5. キャッシュは使い捨てでデバイスごとである。 ドキュメントにもiCloudにもありません(docs/05-companion-files.md §5.2)。派生成果物としては正しいことですが、別のレポートのキャッシュをソースとして扱う設計への制約です。キャッシュはそこにないかもしれません。

同じセクションは3つの単一クエリのハードワイヤリングポイントを名指しし、それらは今日も真です。

合成設計にとって重要なさらに2つの事実:

3. 合成モデル

3.1 ノードとエッジ

3.2 リフレッシュはトポロジカル

  1. DAGをボトムアップで歩きます。既存のコンパイラはすでに結合グラフをトポロジカルソートしており(MAD/Source/MADQueryFull.m:170-204)、オブジェクトグラフはオブジェクトレベルで同じ規律を必要とします。
  2. 各リーフを自身のソースに対して、自身のドライバを通じて、自身のマテリアライゼーションに実行します。
  3. 合成するオブジェクトが必要とするマテリアライゼーションをアタッチするか開きます。
  4. 合成クエリをローカルSQLiteデータベースに対して実行し、その結果をマテリアライズします。
  5. グラフを上へ繰り返します。ルートは通常のレポートであり、そのキャッシュがビューアの読むものです。

ページングは変わりません。エンジンは依然として完全な結果をローカルキャッシュに引き込み、UIはキャッシュ上でページングします。APIドライバにとって「ページネーション」は、マテリアライゼーションを埋めるためのAPIのページにわたる内部ループであり、エンジンとのストリーミングやページングの契約ではありません。プランのlimit/offsetは設計モードのプレビューと、フェッチを上限付けしたいドライバのために存在し、ビューアのページングのためではありません。

グループ化、ソート、集計は変わりません。それらはローカルキャッシュ上で計算されます(MAD_DATA_OBJECT.md §3.5)。ドライバは詳細行を返し、GROUP BYやレポートのグループ化を実装する必要はありません。プラン内のソートヒントは、リミットがあるときにドライバがトップNリクエストをプッシュダウンできるようにしますが、エンジンは依然として再ソートします。

3.3 2つのマテリアライゼーションレイアウト

ユーザーの直感はATTACHであり、現在のコードはそれを短い経路にします。

レイアウトA — ソースオブジェクトごとに1つの.maddb、結合にATTACH。

レイアウトB — 1つの.maddbに複数のテーブル。

推奨: 最初の合成実装にはレイアウトA。現在のクラス境界に従い、ユーザーのモデルに合致するからです。レイアウトBは、テーブルごとのファイルモデルが再検討される場合の、よりクリーンな長期的ファイルの話として残ります。

3.4 参照が意味するもの

合成クエリのテーブル参照には、databaseSchemaTable(今日のRptqQueryTable.databaseSchemaTable、MAD/Source/rptq/autogen/RptqQueryTable.h:27)の隣に2つ目の種類が必要です。ユーザーの決定(2026-11-22)は、合成はまずドキュメント内であるということです。.madドキュメントは複数のレポート/クエリ定義——サブレポート——を含み、合成レポートはそのアイデンティティで1つを参照します。1つのポータブルファイルの性質は保たれ、iOSのクロスファイル再認可問題はv1では生じません。別の.madファイル内のレポートへの参照(ドキュメントアイデンティティとパス)は、後の別の関心事であり、同一ドキュメント合成の背後に延期されます。

キャッシュはデバイスごとで使い捨てなので、参照はデータがどこにあるかではなく何を実行するかを記録します。

マテリアライゼーションの命名はファイル名ハッシュから安定したオブジェクトアイデンティティに移り、ファイルが衝突できず、親が特定の子をアドレス指定できるようになります(§3.6、§6)。

3.4.1 親が子の列に名前を付ける方法

RptqQueryFieldは正確に1つのフィールド参照databaseSchemaField(MAD/Source/rptq/autogen/RptqQueryField.h:27)を持ち、選択ビルダー、結合ビルダー、述語、結合UIはすべてqueryField.databaseSchemaField.nameを読みます。子の出力列はスキーマフィールドではなくMADDataColumnです。推奨は、子のMADDataColumnからオブジェクトごとの結果スキーマテーブルとフィールド集合を合成することです。そうすれば親のクエリフィールドは通常のスキーマフィールド行を指し、既存のすべてのビルダーとUIが変更なしで動作します。合成行は子の結果スキーマのスナップショットであり、子のスキーマが変わるとリフレッシュされます。代替案——RptqQueryFieldに2つ目のフィールド参照種別を追加する——はすべてのビルダーに触れるため推奨されません。ビルダーコール。

3.5 失敗、陳腐化、調整

3.6 親が保存するもの

設計時に親は、結合UIを描きフィールド参照を検証するために、子の結果スキーマ——列名、型、長さ——を必要とします。子の行を必要とすべきではなく、子のソース接続も必要とすべきではありません。スキーマはキャッシュがすでにシリアライズするのと同じMADDataColumn記述です。これはデータオブジェクト契約の「実行せずにdescribeする」半分であり、合成の前提条件であって任意の便利機能ではありません。

ユーザーの決定(2026-11-22)は、結果スキーマはアクティブなフィールド——レポートの要素、結合、グループが参照する列——であり、MADQueryActiveQueryFieldsがすでに計算するSELECTリストそのもの(MAD/Source/MADQueryActiveQueryFields.m:27-100)であるということです。振る舞いの変更はありません。describeはそのリストを実行せずにMADDataColumnとして返します。全列形式はテーブルプレビューの関心事のままであり、データオブジェクトのスキーマではありません。公開列名は人間が読めるべきです。MADDataColumn.captionは表示名のためにすでに存在し、SELECTリストビルダーは内部の"Table0"."Field"エイリアスだけを公開するのではなく、表示名がある場合はスキーマフィールドの表示名からそれを設定すべきです。

アイデンティティのもう1つの部分が欠けています。ルートです。RptqDocument -mainQueryとRptqDatabase -defaultQueryはどちらもhasQueries.anyObject(MAD/Source/rptq/RptqDocument+Extras.m:184-186、MAD/Source/rptq/RptqDatabase+Extras.m:88)であり、MADocument -databaseはhasDatabaseSchemas.anyObjectを取ります(MAD/Source/MADocument.m:1248-1258)。1つのドキュメントに複数のデータオブジェクトがあると、ビューアとデザイナがレンダリングするクエリは非決定論的です。ドキュメントに明示的なルート参照(またはフラグ)を追加し、今日の単一クエリをそれへ移行します。ビルダーコール。

4. 非SQLソースのためのドライバシーム

4.1 なぜSQLテキストが間違った境界なのか

今日、レポートのリフレッシュはグラフをSQLにコンパイルし、executeSQL:fieldKeys:onConnection:intoResultTable:withError:(MAD/Source/MADOperationRefresh.m:134)を呼びます。これはSQL方言には正しいことです。REST APIにとっては、ドライバにSQLをグラフへパースし直すことを強制し、パーサのサブセットは生成されたSQLと少なくとも2か所で一致しません。ジェネレータはLIMIT句(MADQueryFull.m:164)を追加し、MADSQLParserはそれを拒否します(MAD/Source/sql/MADSQLParser.m:151-154)。またデザイナはNATURAL/CROSS結合(RptqQueryLinks+Extras.m:76-86、MADQueryLinkType.h:15-16)を生成でき、パーサはそれも拒否します(MADSQLParser.m:330-338)。パーサを再利用することはレイヤリングも逆転させます。それはドライバより上のMADにあり、Linuxではmadがドライバをwhole-archiveでリンクします(Linux/CMakeLists.txt:469-474)。

MADQuery/MADQueryFullを直接渡すことも答えではありません。MADQueryFullはMAD内のストア結合であり、SQLを構築するときにだけアクティブフィールドリストを計算します。ドライバはドキュメントストアに対してコンパイルすることになります。

4.2 プラン

MADAPIにドライバ中立の値オブジェクトを追加します。

@interface MADQueryPlanTable : NSObject
@property (copy) NSString *name;                        // schema table or object name
@property (copy) NSString *alias;                       // query alias
@property (copy, nullable) NSString *sourceIdentifier;  // nil = schema table
@end

@interface MADQueryPlanField : NSObject
@property (strong) MADQueryPlanTable *table;
@property (copy) NSString *field;
@property (copy) NSString *outputKey; // exactly what the driver names the column
@end

@interface MADQueryPlanLink : NSObject
@property (assign) MADLinkType type;              // moved down to MADAPI
@property (strong) MADQueryPlanTable *leftTable, *rightTable;
@property (copy) NSString *leftField, *rightField;
@end

@interface MADQueryPlanPredicate : NSObject
@property (assign) MADPredicateOperator op;        // moved down to MADAPI
@property (strong) MADQueryPlanOperand *left, *right; // field reference or literal
@end

@interface MADQueryPlan : NSObject
@property (copy) NSArray<MADQueryPlanTable *> *tables;
@property (copy) NSArray<MADQueryPlanField *> *fields;   // the active SELECT list
@property (copy) NSArray<MADQueryPlanLink *> *links;
@property (copy) NSArray<MADQueryPlanPredicate *> *predicates;
@property (copy) NSArray<MADQueryPlanSort *> *sort;      // pushdown hint
@property (assign) NSUInteger limit;
@property (assign) NSUInteger offset;
@end

MADLinkType、MADPredicateOperator、MADSortOrderは現在MADにあります(MAD/Source/MADQueryLinkType.h、MADPredicateOperator.h、MADSortOrder.h)。MADAPIのプランは、それらが下へ移動するまで(またはプランが独自のenumを定義するまで。それはモデルを重複させます)それらを参照できません。3つの純粋なenumを移動するのが正しい修正です。

実行は既存プロトコルの任意メソッドになります。

@protocol MADDatabaseDataSource <NSObject>
// existing required methods stay ...
@optional
- (BOOL)executeQueryPlan:(MADQueryPlan *)plan
                 options:(MADDatabaseExecutionOptions *)options
          intoResultTable:(id <MADDataTableWriting>)table
                withError:(NSError **)error;
@end

@interface MADDatabaseExecutionOptions : NSObject
@property (copy) BOOL (^isCancelled)(void);
@property (copy) void (^progress)(double fraction, NSString *node);
@property (strong) id credentials;                  // driver-specific, or a resolver
@property (copy) NSArray<MADMaterializationReference *> *attachments; // SQLite composer
@end

プランは論理的なままです。オプションが実行コンテキストを運びます。合成SQLiteドライバは各テーブルのsourceIdentifierをoptionsで供給されるアタッチメント(パス、テーブル、エイリアス)に解決します。これによりファイルパスがサードパーティドライバの表面から外れ、キャンセルとノードごとの進捗に居場所が与えられます。ビルダーコール。

MADOperationRefreshはドライバがそれを実装するときに優先し、そうでなければ既存のSQLパスにフォールバックします。出荷されている4つのドライバは初日に変更を必要としません。参照実装はプランを内部でSQLにコンパイルし、現在のコンパイラの出力と一致することをアサートでき、それによりプランを既存スイートに対して固定します。

4.3 能力

エンジンとUIは、ドライバIDをハードコードするのではなく、ドライバに何ができるかを尋ねるべきです。

@interface MADDatabaseCapabilities : NSObject
@property (assign) MADLinkTypeMask supportedLinkTypes;
@property (assign) MADPredicateOperatorMask supportedOperators;
@property (assign) BOOL supportsLimitOffset;
@property (assign) BOOL supportsServerSideSort;
@property (assign) BOOL supportsNativeStatementText; // SQL editor
@property (assign) BOOL isReadOnly;
@property (assign) NSUInteger maximumPageSize;
@end

これはMADDesigner/Source/MADDriverSelectorController.m:64-90,124-140、MAD/Source/rptq/RptqDatabaseCredentals+MADDatabaseConnection.m:19-33、Mac/Source/MADMacConnectionWindowController.m:198-204,359-375、CLI/Source/MADCLIServe.m:277-291、およびMADDesigner/Source/MADQueryAddLinkJoinTypeController.m:46-95のハードコードされたドライバリストと結合ルールを置き換えます。レジストリはすでにドライバを列挙しており(registeredDriverClasses)、UIはスイッチの代わりにそれとdriverName/imageIconNameを使えます。

4.4 各レイヤーが保つもの

5. 汎用APIドライバ

ユーザーの「データソースのクラス全体に対する1つのドライバ」は、スキーマがコードではなくソースマニフェストから来るドライバです。エンジンは通常のMADDatabaseを見て、マニフェストがドライバにどのテーブル、フィールド、エンドポイント、ページネーションルールが存在するかを伝えます。

最小のマニフェスト形状:

{
  "name": "eBay Seller",
  "baseURL": "https://api.ebay.com",
  "resources": {
    "listings": {
      "path": "/sell/inventory/v1/inventory_item",
      "rowsPath": "inventoryItems",
      "primaryKey": "sku",
      "pagination": { "limitParam": "limit", "offsetParam": "offset", "max": 100 },
      "fields": {
        "sku": "string",
        "listingId": "string",
        "product.title": "string",
        "price.value": "number"
      },
      "filters": { "sku": { "eq": "sku" } }
    }
  }
}

ドライバはプランをリクエストにマップします。

接続面では、今日の認証情報行はSQLドライバをカバーします(host、username、password、database)。クライアントシークレット、リフレッシュトークン、マーケットプレイスID、またはサンドボックスフラグを必要とするAPIドライバにとって、ユーザーの決定(2026-11-22)は認証情報上の単一の拡張可能なオプションフィールドです。JSON(またはXML)を保持する1つのテキスト列で、ストアフォーマットにバージョン化され、ドライバがパースします——ドライバごとに新しいストア列を作るのではなく。既存のフィールドが一般的なケースをマップします(host = ベースURL、database = マニフェスト名、username = クライアントID、password = OAuthトークン)。機密値(クライアントシークレット、リフレッシュトークン)はドキュメントではなくキーチェーンに入ります。JSONは非機密の形とキーチェーンキー参照を保持します。これは回避策ではなく拡張ポイントであり、ドライバがパラメータを追加するたびにドキュメントフォーマットを変えなくて済みます。

マニフェストの作成はまずバンドル/開発者作成です(ユーザーの決定、2026-11-22)。ドライバの開発者がマニフェストを書き、ドライバと一緒に出荷します。ユーザー向けのマニフェストエディタ/インポートとその信頼境界は、プラグインシステムの背後に延期されます(§5.1)。長期的な要望——プラグインしてUIで追加/削除されるドライバ——はここに記録されます。これはまずmacOS/Linux/Windowsとサーバーの関心事です。iOSは歴史的に任意のサードパーティコードのロードをブロックしてきたため、iOSではドライバはビルド時にリンクされたままです。

汎用ドライバはまた、プランが扱わない非SQLの義務を負います。HTTPクライアントとTLS、認証リフレッシュ、レート制限、リトライ、キャンセル、レスポンスサイズ上限、エラーマッピングです。それらはエンジンではなくドライバフレームワークに属します。

汎用ドライバができないことは、できることと同じくらい重要です。任意のGraphQL、行が表形式でないソース、マニフェストが表現できないサーバーサイド結合。能力オブジェクトがそれを伝える方法であり、クエリデザイナがユーザーの知る場所です。

5.1 プラグアンドプレイドライバ(将来、v1ではない)

ユーザーのより大きな目標は、プラグインのようにインストール、登録、登録解除され、アプリにリンクされるのではなくUIで追加/削除できるドライバです。レジストリはすでにリンクによるプロセスごとの登録を行います(ドライバチュートリアルの§1)。真のプラグインシステムはその上に重なるパッケージングと信頼の問題です。動的ロード、発見場所、署名/サンドボックス化、UI。それはmacOS/Linux/Windowsとサーバーの機能であり、iOSのものではなく、この設計のフェーズのスコープ外です。ここに記録するのは、ドライバシーム(Phase 0)が角に追い込まれないためです。プラン、能力、登録の型は動的リンクされたイメージからロード可能なままであるべきで、固定ドライバリストへのコンパイル時結合を持たないことを意味します。

6. ストアとフォーマットで変わること

MAD_DATA_OBJECT.md §4.4に従う最小の形:

.madドキュメントは定義のままで、今も将来もデータを保持しません——それがユーザーの明示的な判断です。スナップショットとマテリアライゼーションはユーザーのシステム上のコンパニオンキャッシュファイルであり、ATTACHが結合するものです。それらのキャッシュファイルの自動命名はファイル名ハッシュから安定したオブジェクトアイデンティティに移り、ファイルが衝突できなくなります。

7. UI、CLI、およびヘッドレスエンジン

8. フェーズ

各フェーズがグリーンで出荷され、単一クエリアプリが動作し続けるように順序付けられています。最初のフェーズは合成から独立しており、非SQLソースをアンブロックするものです。

フェーズ 作業 依存
0 ドライバシーム。 MADQueryPlan + 値型を追加し、3つのenumをMADAPIへ移動する。任意のexecuteQueryPlan:を追加する。能力を追加する。リフレッシュがプランを優先しSQLにフォールバックするようにする。既存ドライバの1つでプランを参照実装し、プランからSQLへの等価性をテストで固定する。振る舞いの変更なし。 —
1 データオブジェクト契約。 SELECTリスト構築を実行から分割する。describe/executeを追加する。結果スキーマをMADDataColumnとして返す。リフレッシュが契約を呼ぶようにする。これはMAD_DATA_OBJECT.mdのPhase 1。 0(重複)
2 クエリが自身を所有する。 MADQueryFullは与えられたクエリを使う。dataTableForQuery:はクエリごとに解決する。MADQueryActiveQueryFieldsはクエリにスコープする。MADModelDocumentは任意のクエリをミラーする。 1
3 同一ドキュメント合成。 クエリテーブルが別のデータオブジェクト(サブレポート)を参照できる。トポロジカルリフレッシュ。MADDatabaseSqlite3のATTACHサポート。合成クエリはローカルキャッシュに対して実行される。これはユーザーの1ポータブルファイルモデル。 1, 2
4 クロスドキュメント合成(延期)。 別の.madレポートへの参照。ドキュメントアイデンティティとパス解決。ライブ対ピン留め。ファイル調整。認証情報ポリシー。欠落/名前変更の処理。優先度は低い。同一ドキュメント合成がユーザーのモデルを満たす。 3
5 汎用APIドライバ。 1つのマニフェスト駆動HTTP/JSONドライバ。マニフェストからのスキーマ。プランからリクエストへのマッピング。ページネーションループ。型マッピング。拡張可能な認証情報optionsフィールド。eBay Sellerを作例として。 0, 1(結合には3も)
6 表面とドキュメント。 レジストリ駆動のドライバリストと結合ルール。ノードごとのリフレッシュUI。CLI動詞。プラン/能力シームで更新されたドライバ作成チュートリアル。 0〜5

フェーズではないもの: プラグアンドプレイドライバのロード(§5.1)はこの設計とは別に追跡されるmacOS/Linux/Windowsとサーバーの機能です。Phase 0〜6のどれもそれに依存せず、Phase 0は動的ロードを可能に保つために固定ドライバリストへの結合を避けるべきなだけです。

Phase 0は「そう遠くない」部分です。新しい値型、1つの任意メソッド、リフレッシュ内の分岐、テストです。ストア、UI、合成モデルの変更を必要としません。Phase 3はユーザーのATTACHモデルが着地する場所であり、SQLiteがすでにドライバでコンパイラがすでにグラフをソートするため、聞こえるより小さいです。

9. 決定

9.1 このドキュメントに記録されたビルダーコール

これらはコードまたは設計上のトレードオフから確定しています。再検討できますが、プランはそれらを前提とします。

  1. レイアウトA、ATTACH付き。 オブジェクトごとに1つの.maddb。合成接続がそれらをアタッチします。これはMADDataTableFastのテーブルごとに1ファイルモデルに従います。レイアウトB(1ファイルに複数テーブル)は後のリファクタであり、v1ではありません。これはMAD_DATA_OBJECT.md §9.2のこの設計に対するレイアウトB推奨を置き換えます。
  2. 合成するオブジェクトはローカルのみ。 合成クエリのテーブルはデータオブジェクトです。リモートテーブルはソースオブジェクトでラップされます。リモート/ローカルの混合実行はありません。
  3. 親の子フィールドは通常のスキーマフィールド。 子のMADDataColumnからオブジェクトごとの結果スキーマテーブル/フィールド集合を合成し、子のスキーマが変わるとリフレッシュします。2つ目のフィールド参照種別はありません。
  4. ルートは明示的。 ドキュメントレベルのルート参照(またはフラグ)を今日の単一クエリから移行します。hasQueries.anyObjectではありません。
  5. プランは論理的で、実行コンテキストは別。 MADDatabaseExecutionOptionsがキャンセル、進捗、認証情報、SQLiteコンポーザのアタッチメント集合を運びます。MADQueryPlanTable.sourceIdentifierは論理ソースを名指しし、ファイルパスではありません。
  6. v1では10を超える直接ソースは設計時エラー。 SQLITE_MAX_ATTACHEDを上げるのは3プラットフォームのビルド変更で、延期されます。
  7. プランをSQLコンパイラと並行して構築し、その後等価性を固定する。 プランが現在のスイートで証明されるまで、SQLコンパイラをプランからレンダリングするようリファクタしない。
  8. 既存のRptqQueryに名前を付ける。RptqDataObjectはまだ導入しない。 MAD_DATA_OBJECT.md §9.1がこれを推奨し、より小さな移行です。
  9. 互換性のためにMADDatabaseDriverを接続クラスに残す。 データベースクラスの登録契約は後でその隣に追加できます。
  10. 最初の汎用APIドライバは結合を非サポートと宣言する。 結合には合成に依存し、その後能力オブジェクトの背後でクライアントサイドハッシュ結合を育てます。これにより最初のドライバは単一リソースのフェッチに保たれます。
  11. 同一ドキュメント合成がクロスドキュメントより先に出荷される。 Phase 3はパス/調整/認証情報の複雑さなしでハードワイヤリングポイントを引退させ、クロスドキュメントはPhase 4です。

9.2 ユーザーが回答した決定(2026-11-22)

ユーザー自身の言葉を以下に示します。含意は著者のものです。

  1. 出力スキーマはアクティブなフィールド——変更なし。 データオブジェクトの出力はレポートが使う列です。レイアウト要素のフィールド、結合フィールド、グループフィールドであり、MADQueryActiveQueryFieldsがすでに計算するSELECTリストそのもの(MADQueryActiveQueryFields.m:27-100)です。ユーザー: 「それはそのレポートで使われるフィールドだけだろう。」 全列形式はテーブルプレビューの関心事にすぎません。describeは実行せずに同じリストをMADDataColumnとして返します。2つの帰結はこの作業の一部ではなく将来の機能として記録されます。人間が読める列名(内部の"Table0"."Field"エイリアスだけを公開するのではなく、すでに存在するMADDataColumn.captionを設定する)、およびプレビューページング(プレビューは現在約512行で上限付けされ、完全な結果をページングすべき——ユーザーはこれをウィッシュリストのためにフラグし、それはこのドキュメントではなくユーザーのTODO.mdです)。ゼロ行ルールは依然として適用されます。ソースオブジェクトは行を返さなくても完全なスキーマをマテリアライズします。
  2. ドライバはすべてのプラットフォームで実行されることが期待され、プラグアンドプレイが目標。 ユーザー: 「それは本当にドライバを書く人次第だが、そうだろうと思う。」 ヘッドレスエンジンと同じDAGはLinux/Windowsでも成り立ちます。特定のドライバがヘッドレスで実行されるかはその作者の関心事です。より大きな要望——「ドライバがプラグアンドプレイになり、UIで追加/削除できる」——は§5.1、将来の機能でありmacOS/Linux/Windows/サーバーの関心事です。iOSは歴史的に任意のサードパーティコードのロードをブロックしてきたからです。
  3. スナップショットはコンパニオンキャッシュに存在し、決して.madにはない。 ユーザー: 「.madファイルはスキーマを記述するだけ……それは変わるべきではない……それは今キャッシュファイルが何であれ、その中にある……Sqlite3データストアであるキャッシュファイルで、それがATTACHされるものだ。」 したがってアーカイブは定義のみに保たれ、ピン留めスナップショットは保持された.maddb/.mdcacheであり、マテリアライゼーションの命名は衝突を避けるために安定したオブジェクトアイデンティティに移ります。
  4. マニフェストはまずバンドル/開発者作成。 ユーザー: 「あなたの答えは正しい……アイデアは常に、新しいドライバが何らかのプラグインシステムで追加できるというものだった……iOSでプラグインを持てるとは思わない。」 v1は開発者作成のマニフェストを持つマニフェスト駆動ドライバを出荷します。ユーザー向けのマニフェストエディタ/インポートとその信頼境界はプラグインシステムの背後に乗ります。
  5. 合成はまずドキュメント内——1つのポータブルファイル内のサブレポート。 ユーザー: 「たぶん『サブレポート』をmadドキュメントに追加できる……アイデアは依然として1つのポータブルファイルだ。」 .madは複数のレポート/クエリ定義を含み、それぞれがSQLiteテーブルに実行され、合成レポートがそれらをATTACHします。これは1ファイルの性質を保ち、v1のiOSクロスファイル再認可問題を取り除きます。クロスドキュメント参照は同一ドキュメント合成の背後に延期されます。
  6. 認証情報は拡張可能なオプションフィールドを育てる。 ユーザー: 「1つを設計してレポートフォーマットに追加できる……たぶんすべてを1つのデータベースフィールドに、何らかの方法でパースする(JSONやXMLのように)ので拡張可能にできる。」 JSONを保持する1つのテキスト列で、ストアにバージョン化され、ドライバがパースします。機密値(クライアントシークレット、リフレッシュトークン)はキーチェーンに入り、JSONは非機密の形とキーチェーン参照を保持します。

9.3 著者が前提とするデフォルト(ビルダーコール)

10. リスク、そしてなぜ一行ではないか

11. これがそうでないもの

2つの将来の機能がここで名指しされますが、この設計ではなくユーザーの追跡ファイルに属します。プレビューページングの修正(§9.2.1)とプラグアンドプレイドライバシステム(§5.1)です。このドキュメントはそれらの形が記録される場所であり、それらを予定しません。

12. 一貫する筋

クエリタブはすでに関数を構築します。リフレッシュチェーンはすでにそれをコンパイルして実行します。結果テーブルはすでにSQLiteとしてディスク上にスキーマと結果セットです。SQLiteはすでにドライバです。ドライバはすでにテーブルを返します。欠けているのは名前、アドレス、describe半分、そして非SQLドライバがSQLテキストの代わりに必要とする構造化クエリです。それらは追加的です。プラン値オブジェクト、能力オブジェクト、任意の実行メソッド、安定したオブジェクトアイデンティティ、2つ目の種類のテーブル参照、トポロジカルウォーク、およびATTACH。

合成は、ファイル名ハッシュより良いものでアドレス指定された既存のパイプラインです。非SQLドライバは異なる実行本体を持つ同じパイプラインです。どちらも新しいエンジンではなく、どちらも抽象が許すために構築されたものです。

このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。