sqlDrop                package:RODBC                R Documentation

_D_e_l_e_t_i_o_n _O_p_e_r_a_t_i_o_n_s _o_n _T_a_b_l_e_s _i_n _O_D_B_C _d_a_t_a_b_a_s_e_s

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

     'sqlClear' deletes all the rows of the table 'sqtable'.

     'sqlDrop' removes the table 'sqtable' (if permitted).

_U_s_a_g_e:

     sqlClear(channel, sqtable, errors = TRUE)

     sqlDrop(channel, sqtable, errors = TRUE)

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

 channel: connection object as returned by 'odbcConnect'.

 sqtable: character string: a database table name accessible from the
          connected DSN.  This can be a dotted name of the form
          'schema.table'.

  errors: logical: if 'TRUE' halt and display error, else return '-1'.

_D_e_t_a_i_l_s:

     These submit 'TRUNCATE TABLE' and 'DROP TABLE' SQL queries
     respectively.

     Dotted table names are allowed on systems that support them but
     the existence of the table is not checked and so attempting these
     operations on a non-existent table will give a low-level error. 
     (This can be suppressed by opening the connection with
     'interpretDot = FALSE'.)

     The default drop behaviour in Oracle is to move the table to the
     recycle bin: use


       sqlQuery(channel, "PURGE recyclebin")

     to empty the recycle bin.

     The current user might not have privileges to allow these
     operations, and Actual Technologies' Mac OS X SQLite driver has a
     bug causing them silently to fail.

_V_a_l_u_e:

     If 'errors = FALSE', a numeric value, invisibly. Otherwise a
     character string or 'invisible()'.

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

     Michael Lapsley and Brian Ripley

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

     'odbcConnect', 'sqlQuery', 'sqlFetch', 'sqlSave', 'sqlTables',
     'odbcGetInfo'

