1isql(1)                      UnixODBC manual pages                     isql(1)
2
3
4

NAME

6       isql, iusql - unixODBC command-line interactive SQL tool
7
8

SYNOPSIS

10       isql DSN [USER [PASSWORD]] [options]
11
12

DESCRIPTION

14       isql  is  a  command  line tool which allows the user to execute SQL in
15       batch or interactively. It has some  interesting  options  such  as  an
16       option to generate output wrapped in an HTML table.
17
18       iusql is the same tool with built-in Unicode support.
19
20

ARGUMENTS

22       DSN    The Data Source Name, which should be used to make connection to
23              the  database.   The  data  source  is   looked   for   in   the
24              /etc/odbc.ini  and $HOME/.odbc.ini files in that order, with the
25              latter overwriting the former.
26
27
28       USER   Specifies the database  user/role  under  which  the  connection
29              should be made.
30
31
32       PASSWORD
33              Password for the specified USER.
34
35

OPTIONS

37       -b     Run  isql  in non-interactive batch mode. In this mode, the isql
38              processes its standard input,  expecting  one  SQL  command  per
39              line.
40
41
42       -dDELIMITER
43              Delimits columns with delimiter.
44
45
46       -xHEX  Delimits  columns  with  HEX, which is a hexadecimal code of the
47              delimiting character in the format 0xNN - i.e. 0x09 for the  TAB
48              character.
49
50
51       -w     Format the result as HTML table.
52
53
54       -c     Output the names of the columns on the first row. Has any effect
55              only with the -d or -x options.
56
57
58       -mNUM  Limit the column display width to NUM characters.
59
60
61       -lLOCALE
62              Sets locale to LOCALE.
63
64
65       -q     Wrap the character fields in double quotes.
66
67
68       -3     Use the ODBC 3 calls.
69
70
71       -n     Use the newline processing.
72
73
74       -e     Use the SQLExecDirect instead of Prepare.
75
76
77       -k     Use SQLDriverConnect.
78
79
80       -v     Turn on the verbose mode, where the errors are fully  described.
81              Useful for debugging.
82
83
84       --version
85              Prints the program version and exits.
86
87

COMMANDS

89       This section briefly describes some isql runtime commands.
90
91       help
92              List all tables in the database.
93
94       help table
95              List all columns in the table.
96
97       help help
98              List all help options.
99
100

EXAMPLES

102       $ isql WebDB MyID MyPWD -w -b < My.sql
103
104       Connects  to  the  WebDB as user MyID with password MyPWD, then execute
105       the commands in the My.sql file and returns the results wrapped in HTML
106       table.   Each line in My.sql must contain exactly 1 SQL command, except
107       for the last line, which must be blank (unless the -n option is  speci‐
108       fied).
109
110

FILES

112       /etc/odbc.ini
113              System-wide DSN definitions. See odbc.ini(5) for details.
114
115       $HOME/.odbc.ini
116              User-specific DSN definitions. See odbc.ini(5) for details.
117
118

SEE ALSO

120       odbcinst(1), odbc.ini(5)
121
122

AUTHORS

124       The authors of unixODBC are Peter Harvey <pharvey@codebydesign.com> and
125       Nick Gorham <nick@easysoft.com>. For the full list of contributors  see
126       the AUTHORS file.
127
128

130       unixODBC  is  licensed under the GNU Lesser General Public License. For
131       details about the license, see the COPYING file.
132
133
134
135version 2.3.1                   Tue 25 Jun 2013                        isql(1)
Impressum