sqlTables               package:RODBC               R Documentation

_L_i_s_t _T_a_b_l_e_s _o_n _a_n _O_D_B_C _D_a_t_a_b_a_s_e

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

     List the tables on an ODBC database.

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

     sqlTables(channel, errors = FALSE, as.is = TRUE)

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

 channel: connection handle as returned by 'odbcConnect'.

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

   as.is: as in 'sqlGetResults'.

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

     A data frame on success, or character/numeric on error depending
     on the 'errors' parameter. (See 'sqlGetResults' for further
     details.)

     The column names depend on the database, containing a column
     'table_name' in some mixture of cases (see the examples).

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

     Michael Lapsley and Brian Ripley

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

     'sqlGetResults'

_E_x_a_m_p_l_e_s:

     ## Not run: 
     channel <- odbcConnect("test")
     sqlTables(channel, "USArrests")
     ## MySQL example
     ##   Table_qualifer Table_owner Table_name Table_type     Remarks
     ##1                             usarrests      TABLE MySQL table
     ## Microsoft Access example
     ##      TABLE_CAT TABLE_SCHEM        TABLE_NAME   TABLE_TYPE REMARKS
     ##1 C:\bdr\test        <NA> MSysAccessObjects SYSTEM TABLE    <NA>
     ##2 C:\bdr\test        <NA>          MSysACEs SYSTEM TABLE    <NA>
     ##3 C:\bdr\test        <NA>       MSysObjects SYSTEM TABLE    <NA>
     ##4 C:\bdr\test        <NA>       MSysQueries SYSTEM TABLE    <NA>
     ##5 C:\bdr\test        <NA> MSysRelationships SYSTEM TABLE    <NA>
     ##6 C:\bdr\test        <NA>             hills        TABLE    <NA>
     ##7 C:\bdr\test        <NA>         USArrests        TABLE    <NA>
     close(channel)
     ## End(Not run)

