TDatabaseManager Class

Manages the database schema lifecycle: creates, updates, validates, and destroys the database schema based on the Aurelius ORM mapping model.

Remarks

TDatabaseManager compares the schema currently present in the database (imported via an ISchemaImporter) with the schema derived from the mapped entity classes and produces a set of DDL commands to synchronize the two. The typical usage pattern is: - Call UpdateDatabase to automatically detect and apply required changes. - Call ValidateDatabase to inspect differences without applying them. - Call BuildDatabase to create the schema on an empty database. - Call DestroyDatabase to drop all mapped schema objects. After any of these operations, the Actions, Warnings, and Errors collections provide a human-readable report of what occurred or what requires manual intervention. Use the AllowDestructiveCommands property to permit DROP TABLE and DROP SEQUENCE statements during an update. Use UseTransactions to control whether DDL is wrapped in a transaction.

Syntax

Unit: Aurelius.Engine.DatabaseManager

TDatabaseManager = class(TAbstractManager);

Constructors

Name	Description
Create	Overloaded Create(IDBConnection, TMappingExplorer) Create(IDBConnection, TArray<TMappingExplorer>)

Methods

Name	Description
BuildDatabase	Creates the database schema from scratch based on the mapping model.
DestroyDatabase	Drops all mapped schema objects from the database.
Update	Overloaded Update(IDBConnection) Update(IDBConnection, TMappingExplorer) Update(IDBConnection, TArray<TMappingExplorer>)
UpdateDatabase	Validates the database schema and executes the DDL statements required to bring it in line with the mapping model.
ValidateDatabase	Compares the live database schema against the mapping model and records differences as actions, warnings, and errors without executing any DDL.

Properties