<!-- ##### SECTION Title ##### -->
GdaConnection

<!-- ##### SECTION Short_Description ##### -->
Management of connections to data sources

<!-- ##### SECTION Long_Description ##### -->
<para>
  The #GdaConnection class offers access to all operations involving an
  opened connection to a database. #GdaConnection objects are obtained
  via the #GdaClient class.
</para>
<para>
  Once obtained, applications can use #GdaConnection to execute commands,
  run transactions, and get information about all objects stored in the
  underlying database.
</para>

<!-- ##### SECTION See_Also ##### -->
<para>

</para>

<!-- ##### SECTION Stability_Level ##### -->


<!-- ##### STRUCT GdaConnection ##### -->
<para>

</para>


<!-- ##### SIGNAL GdaConnection::conn-closed ##### -->
<para>

</para>

@gdaconnection: the object which received the signal.

<!-- ##### SIGNAL GdaConnection::conn-opened ##### -->
<para>

</para>

@gdaconnection: the object which received the signal.

<!-- ##### SIGNAL GdaConnection::conn-to-close ##### -->
<para>

</para>

@gdaconnection: the object which received the signal.

<!-- ##### SIGNAL GdaConnection::dsn-changed ##### -->
<para>

</para>

@gdaconnection: the object which received the signal.
@arg1: 

<!-- ##### SIGNAL GdaConnection::error ##### -->
<para>

</para>

@gdaconnection: the object which received the signal.
@arg1: 

<!-- ##### ENUM GdaConnectionOptions ##### -->
<para>

</para>

@GDA_CONNECTION_OPTIONS_READ_ONLY: 
@GDA_CONNECTION_OPTIONS_DONT_SHARE: 

<!-- ##### ENUM GdaConnectionFeature ##### -->
<para>

</para>

@GDA_CONNECTION_FEATURE_AGGREGATES: 
@GDA_CONNECTION_FEATURE_BLOBS: 
@GDA_CONNECTION_FEATURE_INDEXES: 
@GDA_CONNECTION_FEATURE_INHERITANCE: 
@GDA_CONNECTION_FEATURE_NAMESPACES: 
@GDA_CONNECTION_FEATURE_PROCEDURES: 
@GDA_CONNECTION_FEATURE_SEQUENCES: 
@GDA_CONNECTION_FEATURE_SQL: 
@GDA_CONNECTION_FEATURE_TRANSACTIONS: 
@GDA_CONNECTION_FEATURE_TRIGGERS: 
@GDA_CONNECTION_FEATURE_UPDATABLE_CURSOR: 
@GDA_CONNECTION_FEATURE_USERS: 
@GDA_CONNECTION_FEATURE_VIEWS: 
@GDA_CONNECTION_FEATURE_XML_QUERIES: 

<!-- ##### ENUM GdaConnectionSchema ##### -->
<para>

</para>

@GDA_CONNECTION_SCHEMA_AGGREGATES: 
@GDA_CONNECTION_SCHEMA_DATABASES: 
@GDA_CONNECTION_SCHEMA_FIELDS: 
@GDA_CONNECTION_SCHEMA_INDEXES: 
@GDA_CONNECTION_SCHEMA_LANGUAGES: 
@GDA_CONNECTION_SCHEMA_NAMESPACES: 
@GDA_CONNECTION_SCHEMA_PARENT_TABLES: 
@GDA_CONNECTION_SCHEMA_PROCEDURES: 
@GDA_CONNECTION_SCHEMA_SEQUENCES: 
@GDA_CONNECTION_SCHEMA_TABLES: 
@GDA_CONNECTION_SCHEMA_TRIGGERS: 
@GDA_CONNECTION_SCHEMA_TYPES: 
@GDA_CONNECTION_SCHEMA_USERS: 
@GDA_CONNECTION_SCHEMA_VIEWS: 
@GDA_CONNECTION_SCHEMA_CONSTRAINTS: 

<!-- ##### FUNCTION gda_connection_new ##### -->
<para>

</para>

@client: 
@provider: 
@dsn: 
@username: 
@password: 
@options: 
@Returns: 
<!-- # Unused Parameters # -->
@error: 
@corba_cnc: 
@cnc_string: 


<!-- ##### FUNCTION gda_connection_reset ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_open ##### -->
<para>

</para>

@cnc: 
@error: 
@Returns: 


<!-- ##### FUNCTION gda_connection_close ##### -->
<para>

</para>

@cnc: 
<!-- # Unused Parameters # -->
@Returns: 


<!-- ##### FUNCTION gda_connection_close_no_warning ##### -->
<para>

</para>

@cnc: 


<!-- ##### FUNCTION gda_connection_is_opened ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_client ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_set_client ##### -->
<para>

</para>

@cnc: 
@client: 


<!-- ##### FUNCTION gda_connection_get_options ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_provider_obj ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_infos ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_server_version ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_database ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_set_dsn ##### -->
<para>

</para>

@cnc: 
@datasource: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_dsn ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_cnc_string ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_provider ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_set_username ##### -->
<para>

</para>

@srv: 
@username: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_username ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_set_password ##### -->
<para>

</para>

@srv: 
@password: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_password ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_add_event ##### -->
<para>

</para>

@cnc: 
@error: 


<!-- ##### FUNCTION gda_connection_add_event_string ##### -->
<para>

</para>

@cnc: 
@str: 
@Varargs: 


<!-- ##### FUNCTION gda_connection_add_events_list ##### -->
<para>

</para>

@cnc: 
@events_list: 


<!-- ##### FUNCTION gda_connection_get_events ##### -->
<para>

</para>

@cnc: 
@Returns: 


<!-- ##### FUNCTION gda_connection_clear_events_list ##### -->
<para>

</para>

@cnc: 


<!-- ##### FUNCTION gda_connection_change_database ##### -->
<para>

</para>

@cnc: 
@name: 
@Returns: 


<!-- ##### FUNCTION gda_connection_create_table ##### -->
<para>

</para>

@cnc: 
@table_name: 
@attributes_list: 
@index_list: 
@Returns: 
<!-- # Unused Parameters # -->
@attributes: 


<!-- ##### FUNCTION gda_connection_drop_table ##### -->
<para>

</para>

@cnc: 
@table_name: 
@Returns: 


<!-- ##### FUNCTION gda_connection_create_index ##### -->
<para>

</para>

@cnc: 
@index: 
@table_name: 
@Returns: 
<!-- # Unused Parameters # -->
@table: 


<!-- ##### FUNCTION gda_connection_drop_index ##### -->
<para>

</para>

@cnc: 
@index_name: 
@primary_key: 
@table_name: 
@Returns: 


<!-- ##### FUNCTION gda_connection_execute_command ##### -->
<para>

</para>

@cnc: 
@cmd: 
@params: 
@error: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_last_insert_id ##### -->
<para>

</para>

@cnc: 
@recset: 
@Returns: 


<!-- ##### FUNCTION gda_connection_execute_single_command ##### -->
<para>

</para>

@cnc: 
@cmd: 
@params: 
@error: 
@Returns: 


<!-- ##### FUNCTION gda_connection_execute_non_query ##### -->
<para>

</para>

@cnc: 
@cmd: 
@params: 
@error: 
@Returns: 


<!-- ##### FUNCTION gda_connection_begin_transaction ##### -->
<para>

</para>

@cnc: 
@xaction: 
@Returns: 
<!-- # Unused Parameters # -->
@id: 


<!-- ##### FUNCTION gda_connection_commit_transaction ##### -->
<para>

</para>

@cnc: 
@xaction: 
@Returns: 
<!-- # Unused Parameters # -->
@id: 


<!-- ##### FUNCTION gda_connection_rollback_transaction ##### -->
<para>

</para>

@cnc: 
@xaction: 
@Returns: 
<!-- # Unused Parameters # -->
@id: 


<!-- ##### FUNCTION gda_connection_supports ##### -->
<para>

</para>

@cnc: 
@feature: 
@Returns: 


<!-- ##### FUNCTION gda_connection_get_schema ##### -->
<para>

</para>

@cnc: 
@schema: 
@params: 
@error: 
@Returns: 


<!-- ##### FUNCTION gda_connection_create_blob ##### -->
<para>

</para>

@cnc: 
@Returns: 
<!-- # Unused Parameters # -->
@blob: 


<!-- ##### FUNCTION gda_connection_fetch_blob_by_id ##### -->
<para>

</para>

@cnc: 
@sql_id: 
@Returns: 


<!-- ##### FUNCTION gda_connection_value_to_sql_string ##### -->
<para>

</para>

@cnc: 
@from: 
@Returns: 


