aRTconn                 package:aRT                 R Documentation

_C_l_a_s_s _a_R_T_c_o_n_n

_D_e_s_c_r_i_p_t_i_o_n:

     Class to store a virtual DBMS connection and manipulate databases.
     The connection is virtual because each time a function of this
     class  is called, it connects, does the stuff, and then
     disconnects.

_O_b_j_e_c_t_s _f_r_o_m _t_h_e _C_l_a_s_s:

     Objects can be created using calls of the form 'openConn(user,
     password, port, host)'.

_A_r_g_u_m_e_n_t_s:


     _u_s_e_r User of the DBMS. The default is the username logged in the
          system.

     _p_a_s_s_w_o_r_d The password, default is .

     _d_b_m_s The Database Management System, It can be postgre or
          mysql, according to your installation.

     _p_o_r_t Port of the connection. The default depends on the DBMS.

     _h_o_s_t Host to connect, default is , that means localhost.

     _n_a_m_e The connection's name. See below.

_E_x_t_e_n_d_s:

     Class 'aRTcomponent', directly.

_M_e_t_h_o_d_s:


     _c_r_e_a_t_e_D_b: Creates a new database and returns a connection to it.

     _d_e_l_e_t_e_D_b: Removes a database from the DBMS.

     _o_p_e_n_D_b: Opens a database.

     _s_h_o_w_D_b_s: Lists the available databases.

     _a_d_d_P_e_r_m_i_s_s_i_o_n: Grants permissions on the DBMS to a given user.

     _g_e_t_P_e_r_m_i_s_s_i_o_n_s: Lists the permissions for all users of a DBMS.

     _d_r_o_p_U_s_e_r: Removes permissions of a user in the DBMS.

_C_o_n_n_e_c_t_i_o_n _n_a_m_e_s:

     aRT supports config files storing information about the user's
     connections. Each user can have his/her own config file, called
     .aRTrc and located in the root of the home directory. An example
     of file is shown below:

     [root]
      user=root
      password=abc123
      dbms=mysql
      [pataxo]
      host=pataxo.est.ufpr.br
      user=pedro


     Each line starting with [ and ending with ] is a name for a
     connection, which can be used in the name argument of
     'openConn()'. The lines below a connection name describe the
     values for the parameters of the respective connection. In this
     file we have two connections, one called root, with an user, a
     password, and a dbms, and the other called pataxo, with a host
     and a user. The missing arguments in the description can be used
     as parameters to 'openConn()'.

     WARNING: If this file contains passwords or any other confidential
     information,  set its permissions correctly (reading permission
     only to its owner).

_A_u_t_h_o_r(_s):

     Marcos Aurelio Carrero, Pedro Ribeiro de Andrade

_S_e_e _A_l_s_o:

     See 'aRT' the package organization.

