GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ISQL (1)

NAME

isql, iusql - unixODBC command-line interactive SQL tool

CONTENTS

Synopsis
Description
Arguments
Options
Commands
Examples
Files
See Also
Authors
Copyright

SYNOPSIS

isql DSN [USER [PASSWORD]] [options]

DESCRIPTION

isql is a command line tool which allows the user to execute SQL in batch or interactively. It has some interesting options such as an option to generate output wrapped in an HTML table.

iusql is the same tool with built-in Unicode support.

ARGUMENTS

DSN The Data Source Name, which should be used to make connection to the database. The data source is looked for in the /etc/odbc.ini and $HOME/.odbc.ini files in that order, with the latter overwriting the former.

USER Specifies the database user/role under which the connection should be made.

PASSWORD Password for the specified USER.

OPTIONS

-b Run isql in non-interactive batch mode. In this mode, the isql processes its standard input, expecting one SQL command per line.

-dDELIMITER Delimits columns with delimiter.

-xHEX Delimits columns with HEX, which is a hexadecimal code of the delimiting character in the format 0xNN - i.e. 0x09 for the TAB character.

-w Format the result as HTML table.

-c Output the names of the columns on the first row. Has any effect only with the -d or -x options.

-mNUM Limit the column display width to NUM characters.

-lLOCALE Sets locale to LOCALE.

-q Wrap the character fields in double quotes.

-3 Use the ODBC 3 calls.

-n Use the new line processing. (multiple lines of SQL, terminated with command GO).

-e Use the SQLExecDirect instead of Prepare.

-k Use SQLDriverConnect.

-v Turn on the verbose mode, where the errors are fully described. Useful for debugging.

--version Prints the program version and exits.

-LNUM Alter the maximum number of characters displayed from a character field to NUM characters. Default is 300.

COMMANDS

This section briefly describes some isql runtime commands.

help

List all tables in the database.

help table

List all columns in the table.

help help

List all help options.

EXAMPLES

$ isql WebDB MyID MyPWD -w -b < My.sql

Connects to the WebDB as user MyID with password MyPWD, then execute the commands in the My.sql file and returns the results wrapped in HTML table. Each line in My.sql must contain exactly 1 SQL command, except for the last line, which must be blank (unless the -n option is specified).

FILES

/etc/odbc.ini

System-wide DSN definitions. See odbc.ini(5) for details.

$HOME/.odbc.ini

User-specific DSN definitions. See odbc.ini(5) for details.

SEE ALSO

odbcinst(1), odbc.ini(5)

AUTHORS

The authors of unixODBC are Peter Harvey <pharvey@codebydesign.com> and Nick Gorham <nick@lurcher.org>. For the full list of contributors see the AUTHORS file.

COPYRIGHT

unixODBC is licensed under the GNU Lesser General Public License. For details about the license, see the COPYING file.

Search for    or go to Top of page |  Section 1 |  Main Index


version 2.3.2 ISQL (1) Tue 25 Jun 2013

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.