1FISQL(FreeTDS) FreeTDS Reference Manual FISQL(FreeTDS)
2
4 fisql — interactive SQL shell
5
7 fisql [-eFgpnvXY] [-a display_charset] [-A packet_size] [-c cmdend]
8 [-D database] [-E editor] [-h headers] [-H hostname] [-i inputfile]
9 [-I interfaces_file] [-J client_charset] [-l login_timeout]
10 [-m errorlevel] [-o outputfile] [-P password] [-s colseparator]
11 [-S server] [-t timeout] [-U username] [-w width] [-y sybase_dir]
12 [-z language]
13
15 fisql is very similar to the ‘isql’ utility programs distributed by
16 Sybase and Microsoft. Like them, fisql uses the command ‘go’ on a line by
17 itself as a separator between batches.
18
20 -a display_charset
21 The client charset name. Not implemented.
22 -A packet_size
24 Set protocol packet size. You should not need to set this parame‐
25 ter.
26 -c cmdend
28 Command terminator, defaults to ‘go’.
29 -D Database name on the server to use.
31 -e Echo SQL input (usually in outputfile)
33 -E editor
35 Specify an editor to invoke. Defaults to vi.
36 -F FIPS mode ON. Server returns a message (but processes the query
38 anyway) when it encounters a non-standard SQL command.
39 -g Display a brief help message
41 -h headers
43 Number of rows after which to repeat the column headers. Default
44 is once per resultset.
45 -H hostname
47 Hostname of the client machine as it will be told to the server.
48 -I interfaces_file
50 Name of the interfaces or freetds.conf file to use.
51 -i inputfile
53 Name of script file, containing SQL.
54 -J client_charset
56 Not implemented.
57 -l login_timeout
59 How long to wait for the server to acknowledge a login attempt.
60 -m errorlevel
62 For errors of the severity level specified or higher, print only
63 the message number, state, and error level. Below that level,
64 print nothing.
65 -n Suppress line numbers in echoed output.
67 -o outputfile
69 Name of output file, holding result data.
70 -p Prints performance statistics. Not implemented.
72 -P password
74 Database server password.
75 -s colseparator
77 The column separator. Default is space. Shell metacharacters re‐
78 quire quoting.
79 -S server
81 Database server to which to connect.
82 -t timeout
84 The query timeout, in seconds. How long to wait for a query to be
85 processed. The default is indefinitely, or as determined by
86 freetds.conf.
87 -U username
89 Database server login name.
90 -v Display version and copyright.
92 -w width
94 How many characters wide to print the output. Defaults to 80.
95 -X Use encrypted login. Not implemented in FreeTDS.
97 -y sybase_dir
99 Sets the SYBASE environment variable. Not used by FreeTDS.
100 -Y Use chained transactions.
102 -z language
104 Name of a language for fisql's prompts and messages. Cf. DBSETL‐
105 NATLANG.
106
108 fisql is a filter; it reads from standard input, writes to standard out‐
109 put, and writes errors to standard error. The -i, and -e options override
110 these defaults.
111 fisql uses the DB-Library API provided by FreeTDS. It was first imple‐
113 mented using Sybase's own library and continues to work with it. Before
114 (and after) modifying it, it would be well to test it with Sybase's li‐
115 brary to assure compatibility between it and FreeTDS. EXIT STATUS
116 fisql exits 0 on success, and >0 if the server cannot process the query.
118 fisql will report any errors returned by the server, but will continue
120 processing. In a production environment, this behavior may be insuffi‐
121 ciently stringent. To make it extremely intolerant of errors, change the
122 message and error handlers to call exit(3).
123
125 fisql first appeared in FreeTDS 0.65.
126
128 The fisql utility was written by Nicholas S. Castellano
129 <entropy@freetds.org>, who contributed it to the FreeTDS project under
130 the terms of the GPL.
131
133 Requires the GNU readline library.
134FreeTDS 1.3.3 March 25, 2015 FreeTDS 1.3.3