このページでは構成可能なレポートについて説明します。あるレポートの結果が、別のレポートがクエリできるテーブルになり、ドライバが行を返すあらゆるものを前面に置くことができます。これは設計記録であり、§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、および統合されたフェーズ順を追加します。
レポートはデータソースからテーブルへの関数です。この設計で重要なアカウント対オーダーの区別は、すでにコードにあります。
.madアーカイブに存在します。MADDataColumn)と行です。ドキュメントの隣のコンパニオンSQLiteキャッシュ(.maddb + .mdcache)に、アーカイブの外に存在します。派生かつ再生成可能だからです。拡張は結果をテーブルとしてアドレス可能にすることです。レポートの出力は、今日スキーマテーブルがソースであるのとまったく同じように、別のレポートのソースになります。レポートの上に構築されたレポートは派生テーブルのDAGです。レポートを設計することが再利用可能なデータソースを設計することでもある、ポータブルなセマンティックレイヤーです。
同じ拡張がマルチソースレポートを自然にします。各ソースオブジェクトは自身のデータベースまたはAPIに対して、自身のドライバと認証情報で実行され、自身のSQLiteテーブルにマテリアライズします。合成するオブジェクトはリモートサーバーではなくローカルキャッシュに対して実行され、マテリアライゼーションを結合します。フェデレーションエンジンは追加されません。スナップショットがフェデレーションです。
ユーザーの例: ある企業がeBay出品のレポートを望んでいます。1つのレポートオブジェクトがeBay Seller APIをクエリして出品をマテリアライズし、別のレポートが販売のために会社のMySQLデータベースをクエリし、合成レポートが2つの出力をSKUで結合します。各ドライバは自身のソースだけを知ります。結合はSQLiteで、ローカルに行われます。
非SQLドライバが最初のオブジェクトを可能にするものです。その契約はSQLドライバが満たすのと同じ「スキーマと行」契約ですが、その入力はクエリグラフであるべきで、パースしなければならないSQL文字列ではありません。
高価な部分は存在します。MAD_DATA_OBJECT.md §3が詳細な監査であり、このレポートにとって負荷を支える事実は次のとおりです。
RptqQueryはテーブル、フィールド、リンク、述語、グループを所有します。MADModelDocumentはRptqQueryごとに1つのMADModelDatabaseを構築し、コード自身の注記は現在のバージョンが1つを使うと述べています。基数はアプリのフローの慣習であり、ストアのものではありません(MAD_DATA_OBJECT.md §3.1)。MADQueryFull -copySQLWithManagedObjectContext:error:(MAD/Source/MADQueryFull.m:133-273)はSELECTリスト、トポロジカルソートされたグラフからのFROM/JOINツリー、WHERE句、およびリミットを、ドライバの方言フックを通じて構築します。MADDatabaseの抽象点はexecuteSQL:fieldKeys:onConnection:intoResultTable:withError:(MADAPI/Source/MADDatabaseProtocol.h:33-34)であり、宛先は任意のid <MADDataTableWriting>で、具体的なテーブルクラスではありません。4つのドライバすべてが同じ方法で充填します。すべてのオブジェクトを削除し、列を追加し、バルク挿入し、行を追加します。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)であるため、「データベース」がキャッシュであるクエリは今日のコードであり、新しいコードではありません。docs/05-companion-files.md §5.2)。派生成果物としては正しいことですが、別のレポートのキャッシュをソースとして扱う設計への制約です。キャッシュはそこにないかもしれません。同じセクションは3つの単一クエリのハードワイヤリングポイントを名指しし、それらは今日も真です。
MADQueryFullは初期化されたクエリを使うのではなく、ドキュメントの最初のデータベースと最初のクエリを再読します(MAD/Source/MADQueryFull.m:147-149)。MADocument -dataTableForQuery:は1スロットのスイッチです。MADQueryFullにはドキュメントの1つのテーブルを返し、それ以外にはnilを返します(MAD/Source/MADocument.m:873-880)。MADQueryActiveQueryFieldsはクエリスコープなしですべての要素、リンク、グループをスキャンします(MAD/Source/MADQueryActiveQueryFields.m:27-100)。2つ目のクエリのフィールドは最初のクエリのSELECTリストに漏れます。合成設計にとって重要なさらに2つの事実:
initWithId: self.fileURL.lastPathComponent.hash(MAD/Source/MADocument.m:273-275)でテーブルを作成し、キャッシュディレクトリはそのハッシュで名付けられます。何も安定したアイデンティティでテーブルを指すことができません。MADDataTableFastは1つのファイルである。 filenameCacheMadDBは<tag>.maddb(MADSqlite3/Source/MADDataTableFast.m:403-406)であり、各インスタンスは独自の挿入接続と選択接続を開きます(:482-501)。今日「1つの.maddbに複数のテーブル」というモードはありません。MAD_DATA_OBJECT.md §5.1はそのモードを設計変種として説明し、現在のクラスはそれを実装していません。ATTACHサポートがない。 MADSqlite3、MAD、CLIを検索してもATTACH DATABASEの使用は見つかりません。クロスファイル合成にはそれを追加するか、コピーインのステップが必要です。RptqDatabase(ドライバ+接続+認証情報)と1つのクエリ定義を所有します。自身のソースに対して実行されます。MAD/Source/MADQueryFull.m:170-204)、オブジェクトグラフはオブジェクトレベルで同じ規律を必要とします。ページングは変わりません。エンジンは依然として完全な結果をローカルキャッシュに引き込み、UIはキャッシュ上でページングします。APIドライバにとって「ページネーション」は、マテリアライゼーションを埋めるためのAPIのページにわたる内部ループであり、エンジンとのストリーミングやページングの契約ではありません。プランのlimit/offsetは設計モードのプレビューと、フェッチを上限付けしたいドライバのために存在し、ビューアのページングのためではありません。
グループ化、ソート、集計は変わりません。それらはローカルキャッシュ上で計算されます(MAD_DATA_OBJECT.md §3.5)。ドライバは詳細行を返し、GROUP BYやレポートのグループ化を実装する必要はありません。プラン内のソートヒントは、リミットがあるときにドライバがトップNリクエストをプッシュダウンできるようにしますが、エンジンは依然として再ソートします。
ユーザーの直感はATTACHであり、現在のコードはそれを短い経路にします。
レイアウトA — ソースオブジェクトごとに1つの.maddb、結合にATTACH。
MADDataTableFastは独自の<tag>.maddbとt<tag>を保ちます。ATTACH DATABASE '<path>' AS <alias>を実行します。<alias>.t<tag>として修飾します。MADDatabaseSqlite3のATTACHサポート、エイリアス管理、パス引用。クラスはすでに完全なSQLiteラッパーなので、これは小さな追加です。SQLITE_MAX_ATTACHEDはデフォルト10で、リポジトリ内のどのビルドレシピもそれを上げていません(Compressor/sqlite3.xcconfig、Linux/、Windows/Engine/)。上げるのは3プラットフォームのビルド変更です。v1は10を超える直接ソースを設計時エラーとして扱います。.maddbにマテリアライズします。レイアウトB — 1つの.maddbに複数のテーブル。
t<tag>テーブル、ATTACHなし。MADDataTableFastを「1インスタンスが1ファイルを所有する」から共有ファイル/接続モデルに変えるか、その上にテーブルレジストリを追加する必要があります。ATTACHより大きな変更であり、クラスの現在のテーブルごとに1ファイルの設計に逆行します。推奨: 最初の合成実装にはレイアウトA。現在のクラス境界に従い、ユーザーのモデルに合致するからです。レイアウトBは、テーブルごとのファイルモデルが再検討される場合の、よりクリーンな長期的ファイルの話として残ります。
合成クエリのテーブル参照には、databaseSchemaTable(今日のRptqQueryTable.databaseSchemaTable、MAD/Source/rptq/autogen/RptqQueryTable.h:27)の隣に2つ目の種類が必要です。ユーザーの決定(2026-11-22)は、合成はまずドキュメント内であるということです。.madドキュメントは複数のレポート/クエリ定義——サブレポート——を含み、合成レポートはそのアイデンティティで1つを参照します。1つのポータブルファイルの性質は保たれ、iOSのクロスファイル再認可問題はv1では生じません。別の.madファイル内のレポートへの参照(ドキュメントアイデンティティとパス)は、後の別の関心事であり、同一ドキュメント合成の背後に延期されます。
キャッシュはデバイスごとで使い捨てなので、参照はデータがどこにあるかではなく何を実行するかを記録します。
.maddb/.mdcache)に保持し、子を再実行する代わりに再利用します。ピンは保持されたキャッシュ成果物であり、決して.madに埋め込まれたデータではありません——アーカイブは定義のみに保たれます(§6)。ライブもピン留めもキャッシュディレクトリから読みます。「ピン」は「このマテリアライゼーションを保持して再利用する」という意味で、「データをドキュメントにコピーする」ではありません。マテリアライゼーションの命名はファイル名ハッシュから安定したオブジェクトアイデンティティに移り、ファイルが衝突できず、親が特定の子をアドレス指定できるようになります(§3.6、§6)。
RptqQueryFieldは正確に1つのフィールド参照databaseSchemaField(MAD/Source/rptq/autogen/RptqQueryField.h:27)を持ち、選択ビルダー、結合ビルダー、述語、結合UIはすべてqueryField.databaseSchemaField.nameを読みます。子の出力列はスキーマフィールドではなくMADDataColumnです。推奨は、子のMADDataColumnからオブジェクトごとの結果スキーマテーブルとフィールド集合を合成することです。そうすれば親のクエリフィールドは通常のスキーマフィールド行を指し、既存のすべてのビルダーとUIが変更なしで動作します。合成行は子の結果スキーマのスナップショットであり、子のスキーマが変わるとリフレッシュされます。代替案——RptqQueryFieldに2つ目のフィールド参照種別を追加する——はすべてのビルダーに触れるため推奨されません。ビルダーコール。
設計時に親は、結合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つのドキュメントに複数のデータオブジェクトがあると、ビューアとデザイナがレンダリングするクエリは非決定論的です。ドキュメントに明示的なルート参照(またはフラグ)を追加し、今日の単一クエリをそれへ移行します。ビルダーコール。
今日、レポートのリフレッシュはグラフを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を構築するときにだけアクティブフィールドリストを計算します。ドライバはドキュメントストアに対してコンパイルすることになります。
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にコンパイルし、現在のコンパイラの出力と一致することをアサートでき、それによりプランを既存スイートに対して固定します。
エンジンと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を使えます。
getTables: / getTablesFromConnection:error:とfieldsForTable:connection:error:のままです。非SQLドライバはMADDatabaseTableとMADDatabaseFieldの値を返し、レポートユーザーは今日のスキーマテーブルとまったく同じようにクエリデザイナでそれらを見ます。id <MADDataTableWriting>のままです。ドライバはMADDataColumnと、fieldKeys/outputKeyをキーとする行を追加します。MADDatabaseDriver)に残せます。よりクリーンな長期的契約は、型、識別子、能力、接続構築をMADDatabaseサブクラスに置きます。それは現在のプロトコルの隣に4つのドライバを壊さずに追加できます。ユーザーの「データソースのクラス全体に対する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" } }
}
}
}
ドライバはプランをリクエストにマップします。
tables[0]がリソースを選択します。fieldsは選択リストになるか、APIがオブジェクト全体を返す場合は無視されます。predicatesはマニフェストがマッピングを名付ける場合はクエリパラメータになり、そうでなければドライバがローカルにフィルタします。limit/offsetがページループを駆動します。リミットがなければドライバは尽きるまでページングします。linksはAPIがサポートするならネイティブ、ドライバがハッシュ結合を実装するならクライアントサイド、または非サポート(能力がUIでリンクを無効化します)です。MADDataTypeにマップされます。接続面では、今日の認証情報行は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、行が表形式でないソース、マニフェストが表現できないサーバーサイド結合。能力オブジェクトがそれを伝える方法であり、クエリデザイナがユーザーの知る場所です。
ユーザーのより大きな目標は、プラグインのようにインストール、登録、登録解除され、アプリにリンクされるのではなくUIで追加/削除できるドライバです。レジストリはすでにリンクによるプロセスごとの登録を行います(ドライバチュートリアルの§1)。真のプラグインシステムはその上に重なるパッケージングと信頼の問題です。動的ロード、発見場所、署名/サンドボックス化、UI。それはmacOS/Linux/Windowsとサーバーの機能であり、iOSのものではなく、この設計のフェーズのスコープ外です。ここに記録するのは、ドライバシーム(Phase 0)が角に追い込まれないためです。プラン、能力、登録の型は動的リンクされたイメージからロード可能なままであるべきで、固定ドライバリストへのコンパイル時結合を持たないことを意味します。
MAD_DATA_OBJECT.md §4.4に従う最小の形:
RptqQueryが名前を得ます。すでに定義です。RptqQueryTableの参照が2つ目の種類を得ます。スキーマテーブルに加えて、同じドキュメント内のデータオブジェクト(サブレポート)です。スキーマテーブルを名指すv1行は今日と同じ意味です。別の.madファイル内のレポートへの参照はv1を超えて延期され、到来時にはドキュメントアイデンティティとパス、およびライブ/ピン留めマーカーが必要です。fileURL.lastPathComponent.hashではなくオブジェクトのアイデンティティハッシュになります。テーブル名はt<tag>のままで、タグがオブジェクトのアイデンティティになります。.mdcache)とテーブルを得ます。レイアウトAはオブジェクトごとに1ファイルを保ち、レイアウトBはファイルモデルを変えます。MADStoreSchema.m:314)ので、これは新しい機構ではなく既知のパターンです。.madドキュメントは定義のままで、今も将来もデータを保持しません——それがユーザーの明示的な判断です。スナップショットとマテリアライゼーションはユーザーのシステム上のコンパニオンキャッシュファイルであり、ATTACHが結合するものです。それらのキャッシュファイルの自動命名はファイル名ハッシュから安定したオブジェクトアイデンティティに移り、ファイルが衝突できなくなります。
.mad参照は後の追加です。MADOperationRefreshはアプリ、macOS、CLIで共有されます(CLI/Source/MADCLIDocument.m:120-127、Mac/Source/MADMacDocument.m:337-360)。そのためトポロジカルウォークは各フロントエンドではなく、そこかそれが呼ぶヘルパーに属します。各フェーズがグリーンで出荷され、単一クエリアプリが動作し続けるように順序付けられています。最初のフェーズは合成から独立しており、非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がすでにドライバでコンパイラがすでにグラフをソートするため、聞こえるより小さいです。
これらはコードまたは設計上のトレードオフから確定しています。再検討できますが、プランはそれらを前提とします。
ATTACH付き。 オブジェクトごとに1つの.maddb。合成接続がそれらをアタッチします。これはMADDataTableFastのテーブルごとに1ファイルモデルに従います。レイアウトB(1ファイルに複数テーブル)は後のリファクタであり、v1ではありません。これはMAD_DATA_OBJECT.md §9.2のこの設計に対するレイアウトB推奨を置き換えます。MADDataColumnからオブジェクトごとの結果スキーマテーブル/フィールド集合を合成し、子のスキーマが変わるとリフレッシュします。2つ目のフィールド参照種別はありません。hasQueries.anyObjectではありません。MADDatabaseExecutionOptionsがキャンセル、進捗、認証情報、SQLiteコンポーザのアタッチメント集合を運びます。MADQueryPlanTable.sourceIdentifierは論理ソースを名指しし、ファイルパスではありません。SQLITE_MAX_ATTACHEDを上げるのは3プラットフォームのビルド変更で、延期されます。RptqQueryに名前を付ける。RptqDataObjectはまだ導入しない。 MAD_DATA_OBJECT.md §9.1がこれを推奨し、より小さな移行です。MADDatabaseDriverを接続クラスに残す。 データベースクラスの登録契約は後でその隣に追加できます。ユーザー自身の言葉を以下に示します。含意は著者のものです。
MADQueryActiveQueryFieldsがすでに計算するSELECTリストそのもの(MADQueryActiveQueryFields.m:27-100)です。ユーザー: 「それはそのレポートで使われるフィールドだけだろう。」 全列形式はテーブルプレビューの関心事にすぎません。describeは実行せずに同じリストをMADDataColumnとして返します。2つの帰結はこの作業の一部ではなく将来の機能として記録されます。人間が読める列名(内部の"Table0"."Field"エイリアスだけを公開するのではなく、すでに存在するMADDataColumn.captionを設定する)、およびプレビューページング(プレビューは現在約512行で上限付けされ、完全な結果をページングすべき——ユーザーはこれをウィッシュリストのためにフラグし、それはこのドキュメントではなくユーザーのTODO.mdです)。ゼロ行ルールは依然として適用されます。ソースオブジェクトは行を返さなくても完全なスキーマをマテリアライズします。.madにはない。 ユーザー: 「.madファイルはスキーマを記述するだけ……それは変わるべきではない……それは今キャッシュファイルが何であれ、その中にある……Sqlite3データストアであるキャッシュファイルで、それがATTACHされるものだ。」 したがってアーカイブは定義のみに保たれ、ピン留めスナップショットは保持された.maddb/.mdcacheであり、マテリアライゼーションの命名は衝突を避けるために安定したオブジェクトアイデンティティに移ります。.madは複数のレポート/クエリ定義を含み、それぞれがSQLiteテーブルに実行され、合成レポートがそれらをATTACHします。これは1ファイルの性質を保ち、v1のiOSクロスファイル再認可問題を取り除きます。クロスドキュメント参照は同一ドキュメント合成の背後に延期されます。MADQueryFullの再読、1スロットのデータテーブル、スコープされていないアクティブフィールド)は今日の単一クエリアプリにとって負荷を支えています。2つ目のクエリ——ましてネストされたもの——が実行できる前に倒れなければなりません。ATTACHには制限がある(SQLITE_MAX_ATTACHED、デフォルト10)ため、エイリアス/名前管理とパス引用が必要です。本番で発見しないでください。MADAPIに対してコンパイルします。プランと能力の型は公開表面になります。意図的にバージョン化してください。docs/05-companion-files.md §5.1)。docs/project/registers/TODO.mdはユーザー自身のウィッシュリストであり(プレビューページングの願いはそこに属します)、TASKS.mdはエンジニアリングキュー、ROADMAP.mdは次に何が取り上げられるかを述べます。ここにあるものはエージェントの主導で始められません。2つの将来の機能がここで名指しされますが、この設計ではなくユーザーの追跡ファイルに属します。プレビューページングの修正(§9.2.1)とプラグアンドプレイドライバシステム(§5.1)です。このドキュメントはそれらの形が記録される場所であり、それらを予定しません。
クエリタブはすでに関数を構築します。リフレッシュチェーンはすでにそれをコンパイルして実行します。結果テーブルはすでにSQLiteとしてディスク上にスキーマと結果セットです。SQLiteはすでにドライバです。ドライバはすでにテーブルを返します。欠けているのは名前、アドレス、describe半分、そして非SQLドライバがSQLテキストの代わりに必要とする構造化クエリです。それらは追加的です。プラン値オブジェクト、能力オブジェクト、任意の実行メソッド、安定したオブジェクトアイデンティティ、2つ目の種類のテーブル参照、トポロジカルウォーク、およびATTACH。
合成は、ファイル名ハッシュより良いものでアドレス指定された既存のパイプラインです。非SQLドライバは異なる実行本体を持つ同じパイプラインです。どちらも新しいエンジンではなく、どちらも抽象が許すために構築されたものです。
このページは英語原文の日本語翻訳です。内容に相違がある場合は、英語原文が優先されます。