1FreeTDS(May 14, 2011) FreeTDS(May 14, 2011)
2
6 fisql - interactive SQL shell
7
9 fisql [-e] [-F] [-g] [-p] [-n] [-v] [-X] [-Y]
10 [-a display_charset] [-c cmdend]
11 [-D database] [-E editor]
12 [-h headers] [-H hostname] [-i inputfile]
13 [-I interfaces_file] [-J client_charset]
14 [-l login_timeout] [-m errorlevel]
15 [-o outputfile]
16 [-P password] [-s colseparator] [-S server]
17 [-t timeout] [-U username] [-w width]
18 [-y sybase_dir] [-z language]
19
21 fisql is very similar to the "isql" utility programs distributed by
22 Sybase and Microsoft. Like them, fisql uses the command "go" on a line
23 by itself as a separator between batches.
24
26 -a display_charset
27 The client charset name. Not implemented.
28 -c cmdend
30 Command terminator, defaults to go.
31 -D Database name on the server to use.
33 -e Echo SQL input (usually in outputfile)
35 -E editor
37 Specify an editor to invoke. Defaults to vi.
38 -F FIPS mode ON. Server returns a message (but processes the query
40 anyway) when it encounters a non-standard SQL command.
41 -g Display a brief help message
43 -h headers
45 Number of rows after which to repeat the column headers. Default
46 is once per resultset.
47 -H hostname
49 Hostname of the client machine as it will be told to the server.
50 -I interfaces_file
52 Name of the interfaces or freetds.conf file to use.
53 -i inputfile
55 Name of script file, containing SQL.
56 -J client_charset
58 Not implemented.
59 -l login_timeout
61 How long to wait for the server to acknowledge a login attempt.
62 -m errorlevel
64 For errors of the severity level specified or higher, print only
65 the message number, state, and error level. Below that level,
66 print nothing.
67 -n Suppress line numbers in echoed output.
69 -o outputfile
71 Name of output file, holding result data.
72 -p Prints performance statistics. Not implemented.
74 -P password
76 Database server password.
77 -s colseparator
79 The column separator. Default is space. Shell metacharacters
80 require quoting.
81 -S server
83 Database server to which to connect.
84 -t timeout
86 The query timeout, in seconds. How long to wait for a query to
87 be processed. The default is indefinitely, or as determined by
88 freetds.conf.
89 -U username
91 Database server login name.
92 -v Display version and copyright.
94 -w width
96 How many characters wide to print the output. Defaults to 80.
97 -X Use encrypted login. Not implemented in FreeTDS.
99 -y sybase_dir
101 Sets the SYBASE environment variable. Not used by FreeTDS.
102 -Y Use chained transactions.
104 -z language
106 Name of a language for fisql's prompts and messages. Cf.
107 DBSETLNATLANG.
108
110 fisql is a filter; it reads from standard input, writes to standard
111 output, and writes errors to standard error. The -i, -o, and -e options
112 override these, of course.
113 fisql uses the db-lib API provided by FreeTDS. It was first implemented
115 using Sybase's own library and continues to work with it. Before (and
116 after) modifying it, it would be well to test it with Sybase's library
117 to assure compatibility between it and FreeTDS.
118
120 fisql exits 0 on success, and >0 if the server cannot process the
121 query.
122 fisql will report any errors returned by the server, but will continue
124 processing. In a production environment, this behavior may be insuffi‐
125 ciently stringent. To make it extremely intolerant of errors, change
126 the message and error handlers to call exit(3).
127
129 fisql first appeared in FreeTDS 0.65.
130
132 The fisql utility was written by Nicholas S. Castellano
133 <entropy@freetds.org>, who contributed it to the FreeTDS project under
134 the terms of the GPL.
135
137 Requires the GNU readline library.
138FreeTDS Utilities 0.91RC2 FreeTDS(May 14, 2011)