SchemaView performance improvements

common/api/core-backend.api.md

@@ -128,6 +128,7 @@ import { GeometryContainmentResponseProps } from '@itwin/core-common';
 import { GeometryParams } from '@itwin/core-common';
 import { GeometryPartProps } from '@itwin/core-common';
 import { GeometryStreamProps } from '@itwin/core-common';
+import { GetSchemaViewArgs } from '@itwin/ecschema-metadata';
 import { GuidString } from '@itwin/core-bentley';
 import { Id64Arg } from '@itwin/core-bentley';
 import { Id64Array } from '@itwin/core-bentley';
@@ -4104,7 +4105,7 @@ export abstract class IModelDb extends IModel {
     getMetaData(classFullName: string): EntityMetaData;
     getSchemaProps(name: string): ECSchemaProps;
     // @beta
-    getSchemaView(): Promise<SchemaView>;
+    getSchemaView(args?: GetSchemaViewArgs): Promise<SchemaView>;
     get holdsSchemaLock(): boolean;
     get iModelId(): GuidString;
     importSchemas(schemaFileNames: LocalFileName[], options?: SchemaImportOptions): Promise<void>;

common/api/core-frontend.api.md

@@ -135,6 +135,7 @@ import { GeometryContainmentResponseProps } from '@itwin/core-common';
 import { GeometryQuery } from '@itwin/core-geometry';
 import { GeometryStreamProps } from '@itwin/core-common';
 import { GeometrySummaryRequestProps } from '@itwin/core-common';
+import { GetSchemaViewArgs } from '@itwin/ecschema-metadata';
 import { GlobeMode } from '@itwin/core-common';
 import { Gradient } from '@itwin/core-common';
 import { GraphicParams } from '@itwin/core-common';
@@ -5208,7 +5209,7 @@ export abstract class IModelConnection extends IModel {
     // @deprecated
     getMassPropertiesPerCandidate(requestProps: MassPropertiesPerCandidateRequestProps): Promise<MassPropertiesPerCandidateResponseProps[]>;
     // @beta
-    getSchemaView(): Promise<SchemaView>;
+    getSchemaView(args?: GetSchemaViewArgs): Promise<SchemaView>;
     getToolTipMessage(id: Id64String): Promise<string[]>;
     readonly hilited: HiliteSet;
     // @internal

common/api/ecschema-metadata.api.md

@@ -923,6 +923,13 @@ export class FormatSetFormatsProvider implements MutableFormatsProvider {
 // @internal (undocumented)
 export function getFormatProps(format: Format | OverrideFormat): FormatProps;
 
+// @beta
+export interface GetSchemaViewArgs {
+    // @internal
+    readonly forceReload?: boolean;
+    readonly schemas?: readonly string[];
+}
+
 // @public @preview
 export interface HasMixins {
     // (undocumented)
@@ -2492,6 +2499,56 @@ export interface SchemaLocaterOptions {
     readonly loadPartialSchemaOnly?: boolean;
 }
 
+// @beta
+export class SchemaManifest {
+    constructor(entries: readonly SchemaManifestEntry[]);
+    // (undocumented)
+    get entries(): readonly SchemaManifestEntry[];
+    findByName(name: string): SchemaManifestEntry | undefined;
+    // @internal
+    static fromRows(schemaRows: readonly SchemaManifestSchemaRow[], referenceRows: readonly SchemaManifestReferenceRow[]): SchemaManifest;
+    getAvailableSchemaNames(): string[];
+    getSchemaClosure(requestedNames: Iterable<string>): string[];
+    get schemaCount(): number;
+    // @internal
+    sortInDependencyOrder(schemaNames: Iterable<string>): string[];
+}
+
+// @beta
+export interface SchemaManifestEntry {
+    // (undocumented)
+    readonly minorVersion: number;
+    // (undocumented)
+    readonly name: string;
+    // (undocumented)
+    readonly readVersion: number;
+    readonly references: readonly SchemaManifestEntry[];
+    // (undocumented)
+    readonly writeVersion: number;
+}
+
+// @internal
+export interface SchemaManifestReferenceRow {
+    // (undocumented)
+    readonly sourceECInstanceId: number;
+    // (undocumented)
+    readonly targetECInstanceId: number;
+}
+
+// @internal
+export interface SchemaManifestSchemaRow {
+    // (undocumented)
+    readonly ecInstanceId: number;
+    // (undocumented)
+    readonly name: string;
+    // (undocumented)
+    readonly versionMajor: number;
+    // (undocumented)
+    readonly versionMinor: number;
+    // (undocumented)
+    readonly versionWrite: number;
+}
+
 // @public @preview
 export enum SchemaMatchType {
     // (undocumented)
@@ -2584,17 +2641,17 @@ export class SchemaView {
     // @internal (undocumented)
     readonly [_storage]: SchemaViewStorage;
     // @internal
-    constructor(data: SchemaViewData, schemaToken?: string);
+    constructor(data: SchemaViewData, schemaToken?: string, mergeContext?: SchemaViewMergeContext);
     // @internal (undocumented)
     buildDerivedClassMap(): ReadonlyMap<number, readonly number[]>;
     get classCount(): number;
+    // @internal
+    static createMergeable(schemaToken?: string): SchemaView;
     findClass(qualifiedName: string): SchemaView.Class | undefined;
     findEnumeration(qualifiedName: string): SchemaView.Enumeration | undefined;
     findKindOfQuantity(qualifiedName: string): SchemaView.KindOfQuantity | undefined;
     findPropertyCategory(qualifiedName: string): SchemaView.PropertyCategory | undefined;
     static fromBinary(blob: Uint8Array, schemaToken?: string): SchemaView;
-    // @internal
-    static fromBuilder(builder: SchemaViewBuilder, schemaToken?: string): SchemaView;
     getSchema(name: string): SchemaView.Schema | undefined;
     getSchemaByAlias(alias: string): SchemaView.Schema | undefined;
     getSchemas(): IterableIterator<SchemaView.Schema>;
@@ -2603,12 +2660,16 @@ export class SchemaView {
     get isOutdated(): boolean;
     // @internal
     markOutdated(): void;
+    // @internal
+    mergeFragment(blob: Uint8Array): void;
     // @internal (undocumented)
     resolveAllProperties(classIdx: number): readonly ResolvedPropertyRef[];
     // @internal (undocumented)
     resolveClassIdx(qualifiedName: string): number;
     get schemaCount(): number;
     get schemaToken(): string;
+    // @internal
+    setSchemaToken(token: string): void;
 }
 
 // @beta (undocumented)
@@ -2894,6 +2955,12 @@ export namespace SchemaView {
     }
 }
 
+// @beta
+export interface SchemaViewBlob {
+    readonly data: Uint8Array;
+    readonly schemaToken: string;
+}
+
 // @internal
 export class SchemaViewBuilder {
     addClass(data: ClassData): number;
@@ -2907,13 +2974,20 @@ export class SchemaViewBuilder {
     addPropertyRef(ref: PropertyRef): void;
     addRelConstraint(data: RelConstraintData): number;
     addSchema(data: SchemaData): number;
+    assembleData(): SchemaViewData;
     build(schemaToken?: string): SchemaView;
+    get classCount(): number;
     get classMixinCount(): number;
     get constraintClassRefCount(): number;
+    get enumerationCount(): number;
     get enumeratorCount(): number;
+    extendLookupMaps(): void;
     getString(sid: number): string;
     internString(value: string | undefined): number;
+    get koqCount(): number;
+    get propCategoryCount(): number;
     get propertyRefCount(): number;
+    get schemaCount(): number;
     updateClass(classIdx: number, data: ClassData): void;
     updateSchemaRanges(schemaIdx: number, ranges: {
         classRangeStart: number;
@@ -2969,9 +3043,46 @@ export interface SchemaViewData {
     readonly strings: readonly string[];
 }
 
+// @beta
+export interface SchemaViewDataProvider {
+    fetchFragmentBlob(schemaNames: readonly string[]): Promise<SchemaViewBlob>;
+    fetchFullBlob(): Promise<SchemaViewBlob>;
+    fetchManifest(): Promise<SchemaManifest>;
+    fetchSchemaToken(): Promise<string>;
+}
+
 // @beta
 export const schemaViewFormatVersion = 1;
 
+// @beta
+export class SchemaViewManager {
+    constructor(dataProvider: SchemaViewDataProvider);
+    getSchemaView(args?: GetSchemaViewArgs): Promise<SchemaView>;
+    invalidateIfChanged(): Promise<void>;
+    reset(): void;
+}
+
+// @internal
+export class SchemaViewMergeContext {
+    // (undocumented)
+    readonly builder: SchemaViewBuilder;
+    // (undocumented)
+    readonly catRowIdToIdx: Map<number, number>;
+    // (undocumented)
+    readonly classResolver: Map<string, number>;
+    // (undocumented)
+    readonly classRowIdToIdx: Map<number, number>;
+    // (undocumented)
+    readonly enumRowIdToIdx: Map<number, number>;
+    // (undocumented)
+    readonly koqRowIdToIdx: Map<number, number>;
+    mergeBlob(data: Uint8Array): void;
+    // (undocumented)
+    readonly schemaECIdToIdx: Map<number, number>;
+    // (undocumented)
+    readonly schemaNames: string[];
+}
+
 // @beta
 export enum SchemaViewPrimitiveType {
     // (undocumented)

common/api/summary/ecschema-metadata.exports.csv

@@ -96,6 +96,7 @@ preview;class;Format
 beta;interface;FormatSet
 beta;class;FormatSetFormatsProvider
 internal;function;getFormatProps
+beta;interface;GetSchemaViewArgs
 public;interface;HasMixins
 preview;interface;HasMixins
 beta;interface;ILocalizationProvider
@@ -258,6 +259,10 @@ beta;class;SchemaLoader
 beta;class;SchemaLocalization
 beta;interface;SchemaLocalizationJson
 beta;interface;SchemaLocaterOptions
+beta;class;SchemaManifest
+beta;interface;SchemaManifestEntry
+internal;interface;SchemaManifestReferenceRow
+internal;interface;SchemaManifestSchemaRow
 public;enum;SchemaMatchType
 preview;enum;SchemaMatchType
 public;class;SchemaPartVisitorDelegate
@@ -275,9 +280,13 @@ beta;namespace;SchemaView
 internal;function;createClass
 internal;function;createProperty
 internal;function;parseFormatString
+beta;interface;SchemaViewBlob
 internal;class;SchemaViewBuilder
 internal;interface;SchemaViewData
+beta;interface;SchemaViewDataProvider
 beta;const;schemaViewFormatVersion
+beta;class;SchemaViewManager
+internal;class;SchemaViewMergeContext
 beta;enum;SchemaViewPrimitiveType
 internal;class;SchemaWalker
 public;enum;StrengthDirection

common/changes/@itwin/core-backend/rschili-schema-view-fragment_2026-07-23-15-54-03.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@itwin/core-backend",
+      "comment": "Add filtering support to SchemaView and improve performance.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@itwin/core-backend"
+}

common/changes/@itwin/core-frontend/rschili-schema-view-fragment_2026-07-23-15-54-03.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@itwin/core-frontend",
+      "comment": "Add filtering support to SchemaView and improve performance.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@itwin/core-frontend"
+}

common/changes/@itwin/ecschema-metadata/rschili-schema-view-fragment_2026-07-23-15-54-03.json

@@ -0,0 +1,10 @@
+{
+  "changes": [
+    {
+      "packageName": "@itwin/ecschema-metadata",
+      "comment": "Add performance improvements for SchemaView. Filtering by schema, incremental loading, and a common lifetime manager class for invalidation.",
+      "type": "none"
+    }
+  ],
+  "packageName": "@itwin/ecschema-metadata"
+}