mirror of
https://github.com/mdbtools/mdbtools.git
synced 2025-04-05 15:36:13 +08:00
a44a8ed8ae
Access's `LIKE` is actually case-insensitive, but to prevent breaking existing programs that rely on mdbtools' case-sensitive behavior, introduce a new `ILIKE` operator to perform a case-insensitive match. Use GLib's `g_utf8_casefold` to make the comparison UTF-8 aware. A "poor man's" version is implemented in fakeglib, which relies on `towlower`, and won't work with multi-grapheme case transformations (e.g. German Eszett). Fixes #233
99 lines
4.3 KiB
Plaintext
99 lines
4.3 KiB
Plaintext
NAME
|
|
mdb-sql - SQL interface to MDB Tools
|
|
|
|
SYNOPSIS
|
|
mdb-sql [-HFp] [-d char] [-i file] [-o file] [database]
|
|
mdb-sql -h|--help
|
|
mdb-sql --version
|
|
|
|
DESCRIPTION
|
|
mdb-sql is a utility program distributed with MDB Tools.
|
|
|
|
mdb-sql allows querying of an MDB database using a limited SQL subset
|
|
language.
|
|
|
|
OPTIONS
|
|
-H, --no-header Suppress header row.
|
|
-F, --no-footer Suppress footer row.
|
|
-p, --no-pretty-print Turn off pretty printing. By default results are printed in an
|
|
ascii table format which looks nice but is not conducive to manipulating the
|
|
output with unix tools. This option prints output plainly in a tab separated
|
|
format.
|
|
-d, --delimiter char Specify an alternative column delimiter. If no delimiter is
|
|
specified, columns will be delimited by a tab character if pretty printing
|
|
(-p) is turned off. If pretty printing is enabled this option is meaningless.
|
|
-i, --input file Specify an input file. This option allows an input file containing the SQL to be passed to mdb-sql. See Notes.
|
|
-o, --output file Specify an output file. This option allows the name of an output file to be used instead of stdout.
|
|
--version Print the mdbtools version and exit.
|
|
|
|
COMMANDS
|
|
mdb-sql in interactive mode takes some special commands.
|
|
|
|
connect to database If no database was specified on the command line this command is necessary before any querys are issued. It also allows the switching of databases once in the tool.
|
|
disconnect Will disconnect from the current database.
|
|
go Each batch is sent to the parser using the 'go' command.
|
|
reset A batch can be cleared using the 'reset' command.
|
|
list tables The list tables command will display a list of available tables in this database, similar to the mdb-tables utility on the command line.
|
|
describe table <table> Will display the column information for the specified table.
|
|
quit Will exit the tool.
|
|
|
|
SQL LANGUAGE
|
|
The currently implemented SQL subset is quite small, supporting only single table queries, no aggregates, and limited support for WHERE clauses. Here is a brief synopsis of the supported language.
|
|
|
|
select: SELECT <top clause> [* | <column list>] FROM <table> WHERE <where clause> <limit clause>
|
|
|
|
top clause: TOP <integer> [ PERCENT ]
|
|
|
|
column list: <column> [, <column list>]
|
|
|
|
where clause: <column> <operator> <literal> [AND <where clause>]
|
|
|
|
limit clause: LIMIT <integer>
|
|
|
|
operator: =, =>, =<, <>, like, ilike, <, >
|
|
|
|
literal: integers, floating point numbers, or string literal in single quotes
|
|
|
|
NOTES
|
|
When passing a file (-i) or piping output to mdb-sql the final 'go' is optional. This allow constructs like
|
|
|
|
echo "Select * from Table1" | mdb-sql mydb.mdb
|
|
|
|
to work correctly.
|
|
|
|
The -i command can be passed the string 'stdin' to test entering text as if using a pipe.
|
|
|
|
The 'like' operator performs a case-sensitive pattern match, with ANSI-style wildcards. An underscore in the pattern will match any single character, and a percent sign will match any run of characters.
|
|
|
|
The 'ilike' operator is similar, but performs a case-insensitive pattern match.
|
|
|
|
ENVIRONMENT
|
|
LC_COLLATE Defines the locale for string-comparison operations. See locale(1).
|
|
MDB_JET3_CHARSET Defines the charset of the input JET3 (access 97) file. Default is CP1252. See iconv(1).
|
|
MDBICONV Defines the output charset. Default is UTF-8. mdbtools must have been compiled with iconv.
|
|
MDBOPTS Colon-separated list of options:
|
|
* debug_like
|
|
* debug_write
|
|
* debug_usage
|
|
* debug_ole
|
|
* debug_row
|
|
* debug_props
|
|
* debug_all is a shortcut for all debug_* options
|
|
* no_memo (deprecated; has no effect)
|
|
* use_index (experimental; requires libmswstr)
|
|
|
|
HISTORY
|
|
mdb-sql first appeared in MDB Tools 0.3.
|
|
|
|
SEE ALSO
|
|
mdb-array(1) mdb-count(1) mdb-export(1) mdb-header(1) mdb-hexdump(1)
|
|
mdb-import(1) mdb-json(1) mdb-parsecsv(1) mdb-prop(1) mdb-queries(1)
|
|
mdb-schema(1) mdb-tables(1) mdb-ver(1)
|
|
isql(1)
|
|
|
|
AUTHORS
|
|
The mdb-sql utility was written by Brian Bruns.
|
|
|
|
BUGS
|
|
The supported SQL syntax is a very limited subset and deficient in several ways.
|