Methods - DDL queries: GNOME Data Access 5 manual

Methods - DDL queries

This group of virtual methods is composed of virtual methods which make it possible to handle DDL (data definition) queries to be executed using descriptions of the data required for each kind of DDL query, rather than using SQL directly (because DDL SQL is usually very database specific and must thus be adapted when migrating to another database type). For more information, see the global introduction to DDL queries.

Implementing these methods is not mandatory, and virtual provider's implementation should not implement them.

supports_operation()

This virtual method tells if a particular DDL query type is supported (DDL query types are identified as GdaServerOperationType enums).

create_operation()

This virtual method is used to create and initialize a GdaServerOperation object.

render_operation()

This virtual method uses the information stored in a GdaServerOperation object to create the SQL statement(s) which would be executed if the operation was performed.

Note: more than one SQL statement may be returned by this method

Note: some operations don't return any SQL at all, if the operation can only be done using an API (and not through SQL)

perform_operation()

This virtual method "performs" (execute) a GdaServerOperation object.