Skip to content

M
MariaDB
Commit 960d70f2 authored by unknown's avatar unknown
Browse files
Options

Howard's grammar fixes 


Docs/manual.texi:
  Howard's grammar changes
parent c678a231
Hide whitespace changes
Inline Side-by-side
Showing with 240 additions and 240 deletions
Docs/manual.texi
View file @ 960d70f2
...@@ -4533,7 +4533,7 @@ to get even more flexibility). ...@@ -4533,7 +4533,7 @@ to get even more flexibility).
@item @item
If you want to configure @code{mysqld} with some extra feature that is NOT in If you want to configure @code{mysqld} with some extra feature that is NOT in
the standard binary distributions. Here follows a list of the most common the standard binary distributions. Here is a list of the most common
extra options that you may want to use extra options that you may want to use
@itemize @bullet @itemize @bullet
...@@ -16839,7 +16839,7 @@ file. See @code{ENCRYPT()}. ...@@ -16839,7 +16839,7 @@ file. See @code{ENCRYPT()}.
@item ENCRYPT(str[,salt]) @item ENCRYPT(str[,salt])
Encrypt @code{str} using the UNIX @code{crypt()} system call. The Encrypt @code{str} using the UNIX @code{crypt()} system call. The
@code{salt} argument should be a string with two characters. @code{salt} argument should be a string with two characters.
(As of @strong{MySQL} 3.22.16, @code{salt} may be longer than two characters.): (As of @strong{MySQL} Version 3.22.16, @code{salt} may be longer than two characters.):
@example @example
mysql> select ENCRYPT("hello"); mysql> select ENCRYPT("hello");
...@@ -18101,7 +18101,7 @@ normal check has succeeded!). ...@@ -18101,7 +18101,7 @@ normal check has succeeded!).
@findex BACKUP TABLE @findex BACKUP TABLE
@node BACKUP TABLE, RESTORE TABLE, CHECK TABLE, Reference @node BACKUP TABLE, RESTORE TABLE, CHECK TABLE, Reference
@section @code{BACKUP TABLE} syntax @section @code{BACKUP TABLE} Syntax
@example @example
BACKUP TABLE tbl_name[,tbl_name...] TO '/path/to/backup/directory' BACKUP TABLE tbl_name[,tbl_name...] TO '/path/to/backup/directory'
...@@ -18132,7 +18132,7 @@ version 3.23.25 and later. ...@@ -18132,7 +18132,7 @@ version 3.23.25 and later.
@findex RESTORE TABLE @findex RESTORE TABLE
@node RESTORE TABLE, ANALYZE TABLE, BACKUP TABLE, Reference @node RESTORE TABLE, ANALYZE TABLE, BACKUP TABLE, Reference
@section @code{RESTORE TABLE} syntax @section @code{RESTORE TABLE} Syntax
@example @example
RESTORE TABLE tbl_name[,tbl_name...] FROM '/path/to/backup/directory' RESTORE TABLE tbl_name[,tbl_name...] FROM '/path/to/backup/directory'
...@@ -18159,7 +18159,7 @@ The command returns a table with the following columns: ...@@ -18159,7 +18159,7 @@ The command returns a table with the following columns:
@findex ANALYZE TABLE @findex ANALYZE TABLE
@node ANALYZE TABLE, REPAIR TABLE, RESTORE TABLE, Reference @node ANALYZE TABLE, REPAIR TABLE, RESTORE TABLE, Reference
@section @code{ANALYZE TABLE} syntax @section @code{ANALYZE TABLE} Syntax
@example @example
ANALYZE TABLE tbl_name[,tbl_name...] ANALYZE TABLE tbl_name[,tbl_name...]
...@@ -18167,7 +18167,7 @@ ANALYZE TABLE tbl_name[,tbl_name...] ...@@ -18167,7 +18167,7 @@ ANALYZE TABLE tbl_name[,tbl_name...]
Analyze and store the key distribution for the table. During the Analyze and store the key distribution for the table. During the
analyze the table is locked with a read lock. analyze the table is locked with a read lock.
This is equivalent of running @code{myisamchk -a} on the table. This is equivalent to running @code{myisamchk -a} on the table.
@strong{MySQL} uses the stored key distribution to decide in which order @strong{MySQL} uses the stored key distribution to decide in which order
tables should be joined when one does a join on something else than a tables should be joined when one does a join on something else than a
...@@ -18191,13 +18191,13 @@ the table will not be analyzed again. ...@@ -18191,13 +18191,13 @@ the table will not be analyzed again.
@findex REPAIR TABLE @findex REPAIR TABLE
@node REPAIR TABLE, DELETE, ANALYZE TABLE, Reference @node REPAIR TABLE, DELETE, ANALYZE TABLE, Reference
@section @code{REPAIR TABLE} syntax @section @code{REPAIR TABLE} Syntax
@example @example
REPAIR TABLE tbl_name[,tbl_name...] [QUICK] [EXTENDED] REPAIR TABLE tbl_name[,tbl_name...] [QUICK] [EXTENDED]
@end example @end example
@code{REPAIR TABLE} only works on @code{MyISAM} tables and is the same things @code{REPAIR TABLE} only works on @code{MyISAM} tables and is the same
as running @code{myisamchk -r table_name} on the table. as running @code{myisamchk -r table_name} on the table.
Repair the corrupted table. The command returns a table with the following Repair the corrupted table. The command returns a table with the following
...@@ -18228,7 +18228,7 @@ keys that compress very good. ...@@ -18228,7 +18228,7 @@ keys that compress very good.
@findex DELETE @findex DELETE
@node DELETE, TRUNCATE, REPAIR TABLE, Reference @node DELETE, TRUNCATE, REPAIR TABLE, Reference
@section @code{DELETE} syntax @section @code{DELETE} Syntax
@example @example
DELETE [LOW_PRIORITY] FROM tbl_name DELETE [LOW_PRIORITY] FROM tbl_name
...@@ -18263,7 +18263,7 @@ operations reuse old record positions. To reclaim unused space and reduce ...@@ -18263,7 +18263,7 @@ operations reuse old record positions. To reclaim unused space and reduce
file sizes, use the @code{OPTIMIZE TABLE} statement or the @code{myisamchk} file sizes, use the @code{OPTIMIZE TABLE} statement or the @code{myisamchk}
utility to reorganize tables. @code{OPTIMIZE TABLE} is easier, but utility to reorganize tables. @code{OPTIMIZE TABLE} is easier, but
@code{myisamchk} is faster. @code{myisamchk} is faster.
@xref{OPTIMIZE TABLE, , @code{OPTIMIZE TABLE}}, and @xref{OPTIMIZE TABLE, , @code{OPTIMIZE TABLE}} and
@ref{Optimization}. @ref{Optimization}.
The @strong{MySQL}-specific @code{LIMIT rows} option to @code{DELETE} tells The @strong{MySQL}-specific @code{LIMIT rows} option to @code{DELETE} tells
...@@ -18275,7 +18275,7 @@ the @code{LIMIT} value. ...@@ -18275,7 +18275,7 @@ the @code{LIMIT} value.
@findex TRUNCATE @findex TRUNCATE
@node TRUNCATE, SELECT, DELETE, Reference @node TRUNCATE, SELECT, DELETE, Reference
@section @code{TRUNCATE} syntax @section @code{TRUNCATE} Syntax
@example @example
TRUNCATE table_name TRUNCATE table_name
...@@ -18301,7 +18301,7 @@ files have become corrupted.. ...@@ -18301,7 +18301,7 @@ files have become corrupted..
@findex SELECT @findex SELECT
@node SELECT, JOIN, TRUNCATE, Reference @node SELECT, JOIN, TRUNCATE, Reference
@section @code{SELECT} syntax @section @code{SELECT} Syntax
@c help SELECT @c help SELECT
@example @example
...@@ -18354,7 +18354,7 @@ retrieve rows. If you name more than one table, you are performing a ...@@ -18354,7 +18354,7 @@ retrieve rows. If you name more than one table, you are performing a
join. For information on join syntax, see @ref{JOIN, , @code{JOIN}}. join. For information on join syntax, see @ref{JOIN, , @code{JOIN}}.
@item @item
You can refer to a column as @code{col_name}, @code{tbl_name.col_name} or You can refer to a column as @code{col_name}, @code{tbl_name.col_name}, or
@code{db_name.tbl_name.col_name}. You need not specify a @code{tbl_name} or @code{db_name.tbl_name.col_name}. You need not specify a @code{tbl_name} or
@code{db_name.tbl_name} prefix for a column reference in a @code{SELECT} @code{db_name.tbl_name} prefix for a column reference in a @code{SELECT}
statement unless the reference would be ambiguous. See @ref{Legal names}, statement unless the reference would be ambiguous. See @ref{Legal names},
...@@ -18364,7 +18364,7 @@ forms. ...@@ -18364,7 +18364,7 @@ forms.
@item @item
@cindex aliases, for tables @cindex aliases, for tables
@cindex table aliases @cindex table aliases
A table reference may be aliased using @code{tbl_name [AS] alias_name}. A table reference may be aliased using @code{tbl_name [AS] alias_name}:
@example @example
mysql> select t1.name, t2.salary from employee AS t1, info AS t2 mysql> select t1.name, t2.salary from employee AS t1, info AS t2
...@@ -18375,8 +18375,8 @@ mysql> select t1.name, t2.salary from employee t1, info t2 ...@@ -18375,8 +18375,8 @@ mysql> select t1.name, t2.salary from employee t1, info t2
@item @item
Columns selected for output may be referred to in @code{ORDER BY} and Columns selected for output may be referred to in @code{ORDER BY} and
@code{GROUP BY} clauses using column names, column aliases or column @code{GROUP BY} clauses using column names, column aliases, or column
positions. Column positions begin with 1. positions. Column positions begin with 1:
@example @example
mysql> select college, region, seed from tournament mysql> select college, region, seed from tournament
...@@ -18408,7 +18408,7 @@ Write this instead: ...@@ -18408,7 +18408,7 @@ Write this instead:
mysql> select col_name from tbl_name WHERE col_name > 0; mysql> select col_name from tbl_name WHERE col_name > 0;
@end example @end example
In @strong{MySQL} 3.22.5 or later, you can also write queries like this: In @strong{MySQL} Version 3.22.5 or later, you can also write queries like this:
@example @example
mysql> select user,max(salary) from users mysql> select user,max(salary) from users
...@@ -18424,7 +18424,7 @@ mysql> select user,max(salary) AS sum from users ...@@ -18424,7 +18424,7 @@ mysql> select user,max(salary) AS sum from users
@item @item
@code{SQL_SMALL_RESULT}, @code{SQL_BIG_RESULT}, @code{SQL_BUFFER_RESULT}, @code{SQL_SMALL_RESULT}, @code{SQL_BIG_RESULT}, @code{SQL_BUFFER_RESULT},
@code{STRAIGHT_JOIN} and @code{HIGH_PRIORITY} are @strong{MySQL} extensions @code{STRAIGHT_JOIN}, and @code{HIGH_PRIORITY} are @strong{MySQL} extensions
to ANSI SQL92. to ANSI SQL92.
@item @item
...@@ -18437,12 +18437,12 @@ statement that is waiting for the table to be free. ...@@ -18437,12 +18437,12 @@ statement that is waiting for the table to be free.
@item @item
@code{SQL_BIG_RESULT} can be used with @code{GROUP BY} or @code{DISTINCT} @code{SQL_BIG_RESULT} can be used with @code{GROUP BY} or @code{DISTINCT}
to tell the optimizer that the result set will have many rows. In this case, to tell the optimizer that the result set will have many rows. In this case,
@strong{MySQL} will directly use disk based temporary tables if needed. @strong{MySQL} will directly use disk-based temporary tables if needed.
@strong{MySQL} will also in this case prefer sorting to doing a @strong{MySQL} will also, in this case, prefer sorting to doing a
temporary table with a key on the @code{GROUP BY} elements. temporary table with a key on the @code{GROUP BY} elements.
@item @item
@code{SQL_BUFFER_RESULT} will put force the result to be put into a temporary @code{SQL_BUFFER_RESULT} will force the result to be put into a temporary
table. This will help @strong{MySQL} free the table locks early and will help table. This will help @strong{MySQL} free the table locks early and will help
in cases where it takes a long time to send the result set to the client. in cases where it takes a long time to send the result set to the client.
...@@ -18466,13 +18466,13 @@ arguments. ...@@ -18466,13 +18466,13 @@ arguments.
If two arguments are given, the first specifies the offset of the first row to If two arguments are given, the first specifies the offset of the first row to
return, the second specifies the maximum number of rows to return. return, the second specifies the maximum number of rows to return.
The offset of the initial row is 0 (not 1). The offset of the initial row is 0 (not 1):
@example @example
mysql> select * from table LIMIT 5,10; # Retrieve rows 6-15 mysql> select * from table LIMIT 5,10; # Retrieve rows 6-15
@end example @end example
If one argument is given, it indicates the maximum number of rows to return. If one argument is given, it indicates the maximum number of rows to return:
@example @example
mysql> select * from table LIMIT 5; # Retrieve first 5 rows mysql> select * from table LIMIT 5; # Retrieve first 5 rows
...@@ -18483,7 +18483,7 @@ In other words, @code{LIMIT n} is equivalent to @code{LIMIT 0,n}. ...@@ -18483,7 +18483,7 @@ In other words, @code{LIMIT n} is equivalent to @code{LIMIT 0,n}.
@item @item
@tindex /etc/passwd @tindex /etc/passwd
The @code{SELECT ... INTO OUTFILE 'file_name'} form of @code{SELECT} writes The @code{SELECT ... INTO OUTFILE 'file_name'} form of @code{SELECT} writes
the selected rows to a file. The file is created on the server host, and the selected rows to a file. The file is created on the server host and
cannot already exist (among other things, this prevents database tables and cannot already exist (among other things, this prevents database tables and
files such as @file{/etc/passwd} from being destroyed). You must have the files such as @file{/etc/passwd} from being destroyed). You must have the
@strong{file} privilege on the server host to use this form of @code{SELECT}. @strong{file} privilege on the server host to use this form of @code{SELECT}.
...@@ -18507,7 +18507,7 @@ Additionally, @code{ASCII 0} is converted to @code{ESCAPED BY} followed by 0 ...@@ -18507,7 +18507,7 @@ Additionally, @code{ASCII 0} is converted to @code{ESCAPED BY} followed by 0
(@code{ASCII 48}). (@code{ASCII 48}).
The reason for the above is that you MUST escape any @code{FIELDS The reason for the above is that you MUST escape any @code{FIELDS
TERMINATED BY}, @code{ESCAPED BY} or @code{LINES TERMINATED BY} TERMINATED BY}, @code{ESCAPED BY}, or @code{LINES TERMINATED BY}
characters to reliably be able to read the file characters to reliably be able to read the file
back. @code{ASCII 0} is escaped to make it easier to view with some back. @code{ASCII 0} is escaped to make it easier to view with some
pagers. pagers.
...@@ -18517,7 +18517,7 @@ else need be escaped. ...@@ -18517,7 +18517,7 @@ else need be escaped.
@end itemize @end itemize
@findex DUMPFILE @findex DUMPFILE
If you use @code{INTO DUMPFILE} instead of @code{INTO OUTFILE} @strong{MySQL} If you use @code{INTO DUMPFILE} instead of @code{INTO OUTFILE}, @strong{MySQL}
will only write one row into the file, without any column or line will only write one row into the file, without any column or line
terminations and without any escaping. This is useful if you want to terminations and without any escaping. This is useful if you want to
store a blob in a file. store a blob in a file.
...@@ -18535,7 +18535,7 @@ store a blob in a file. ...@@ -18535,7 +18535,7 @@ store a blob in a file.
@findex NATURAL RIGHT OUTER JOIN @findex NATURAL RIGHT OUTER JOIN
@findex STRAIGHT_JOIN @findex STRAIGHT_JOIN
@node JOIN, INSERT, SELECT, Reference @node JOIN, INSERT, SELECT, Reference
@section @code{JOIN} syntax @section @code{JOIN} Syntax
@strong{MySQL} supports the following @code{JOIN} syntaxes for use in @strong{MySQL} supports the following @code{JOIN} syntaxes for use in
@code{SELECT} statements: @code{SELECT} statements:
...@@ -18554,30 +18554,30 @@ table_reference RIGHT [OUTER] JOIN table_reference ...@@ -18554,30 +18554,30 @@ table_reference RIGHT [OUTER] JOIN table_reference
table_reference NATURAL [RIGHT [OUTER]] JOIN table_reference table_reference NATURAL [RIGHT [OUTER]] JOIN table_reference
@end example @end example
Where @code{table_reference} is defined as Where @code{table_reference} is defined as:
@example @example
table_name [[AS] alias] [USE INDEX (key_list)] [IGNORE INDEX (key_list)] table_name [[AS] alias] [USE INDEX (key_list)] [IGNORE INDEX (key_list)]
@end example @end example
and @code{join_condition} is defined as and @code{join_condition} is defined as:
@example @example
ON conditional_expr | ON conditional_expr |
USING (column_list) USING (column_list)
@end example @end example
Note that in version before 3.23.16 the @code{INNER JOIN} didn't take Note that in versions before Version 3.23.16, the @code{INNER JOIN} didn't take
a join condition! a join condition!
@cindex ODBC compatibility @cindex ODBC compatibility
@cindex compatibility, with ODBC @cindex compatibility, with ODBC
The last @code{LEFT OUTER JOIN} syntax shown above exists only for The last @code{LEFT OUTER JOIN} syntax shown above exists only for
compatibility with ODBC. compatibility with ODBC:
@itemize @bullet @itemize @bullet
@item @item
A table reference may be aliased using @code{tbl_name AS alias_name} or A table reference may be aliased using @code{tbl_name AS alias_name} or
@code{tbl_name alias_name}. @code{tbl_name alias_name}:
@example @example
mysql> select t1.name, t2.salary from employee AS t1, info AS t2 mysql> select t1.name, t2.salary from employee AS t1, info AS t2
...@@ -18606,7 +18606,7 @@ mysql> select table1.* from table1 ...@@ -18606,7 +18606,7 @@ mysql> select table1.* from table1
@end example @end example
This example finds all rows in @code{table1} with an @code{id} value that is This example finds all rows in @code{table1} with an @code{id} value that is
not present in @code{table2} (i.e., all rows in @code{table1} with no not present in @code{table2} (that is, all rows in @code{table1} with no
corresponding row in @code{table2}). This assumes that @code{table2.id} is corresponding row in @code{table2}). This assumes that @code{table2.id} is
declared @code{NOT NULL}, of course. @xref{LEFT JOIN optimization}. declared @code{NOT NULL}, of course. @xref{LEFT JOIN optimization}.
...@@ -18627,7 +18627,7 @@ A.C1=B.C1 AND A.C2=B.C2 AND A.C3=B.C3,... ...@@ -18627,7 +18627,7 @@ A.C1=B.C1 AND A.C2=B.C2 AND A.C3=B.C3,...
@item @item
The @code{NATURAL [LEFT] JOIN} of two tables is defined to be The @code{NATURAL [LEFT] JOIN} of two tables is defined to be
semantically equivalent to a @code{INNER JOIN} or a @code{LEFT JOIN} semantically equivalent to an @code{INNER JOIN} or a @code{LEFT JOIN}
with a @code{USING} clause that names all columns that exist in both with a @code{USING} clause that names all columns that exist in both
tables. tables.
...@@ -18670,7 +18670,7 @@ mysql> select * from table1 IGNORE INDEX (key3) WHERE key1=1 and key2=2 AND ...@@ -18670,7 +18670,7 @@ mysql> select * from table1 IGNORE INDEX (key3) WHERE key1=1 and key2=2 AND
@findex INSERT @findex INSERT
@node INSERT, REPLACE, JOIN, Reference @node INSERT, REPLACE, JOIN, Reference
@section @code{INSERT} syntax @section @code{INSERT} Syntax
@example @example
INSERT [LOW_PRIORITY | DELAYED] [IGNORE] INSERT [LOW_PRIORITY | DELAYED] [IGNORE]
...@@ -18685,16 +18685,16 @@ or INSERT [LOW_PRIORITY | DELAYED] [IGNORE] ...@@ -18685,16 +18685,16 @@ or INSERT [LOW_PRIORITY | DELAYED] [IGNORE]
@end example @end example
@code{INSERT} inserts new rows into an existing table. The @code{INSERT ... @code{INSERT} inserts new rows into an existing table. The @code{INSERT ...
VALUES} form of the statement inserts rows based on explicitly-specified VALUES} form of the statement inserts rows based on explicitly specified
values. The @code{INSERT ... SELECT} form inserts rows selected from another values. The @code{INSERT ... SELECT} form inserts rows selected from another
table or tables. The @code{INSERT ... VALUES} form with multiple value lists table or tables. The @code{INSERT ... VALUES} form with multiple value lists
is supported in @strong{MySQL} 3.22.5 or later. The is supported in @strong{MySQL} Version 3.22.5 or later. The
@code{col_name=expression} syntax is supported in @strong{MySQL} 3.22.10 or @code{col_name=expression} syntax is supported in @strong{MySQL} Version 3.22.10 or
later. later.
@code{tbl_name} is the table into which rows should be inserted. The column @code{tbl_name} is the table into which rows should be inserted. The column
name list or the @code{SET} clause indicates which columns the statement name list or the @code{SET} clause indicates which columns the statement
specifies values for. specifies values for:
@itemize @bullet @itemize @bullet
@item @item
...@@ -18728,13 +18728,13 @@ If you specify the keyword @code{LOW_PRIORITY}, execution of the ...@@ -18728,13 +18728,13 @@ If you specify the keyword @code{LOW_PRIORITY}, execution of the
@code{INSERT} is delayed until no other clients are reading from the table. @code{INSERT} is delayed until no other clients are reading from the table.
In this case the client has to wait until the insert statement is completed, In this case the client has to wait until the insert statement is completed,
which may take a long time if the table is in heavy use. This is in which may take a long time if the table is in heavy use. This is in
contrast to @code{INSERT DELAYED} which lets the client continue at once. contrast to @code{INSERT DELAYED}, which lets the client continue at once.
Note that @code{LOW_PRIORITY} should normally not be used with @code{MyISAM} Note that @code{LOW_PRIORITY} should normally not be used with @code{MyISAM}
tables as this disables concurrent inserts.@xref{MyISAM}. tables as this disables concurrent inserts.@xref{MyISAM}.
@item @item
If you specify the keyword @code{IGNORE} in an @code{INSERT} with many value If you specify the keyword @code{IGNORE} in an @code{INSERT} with many value
rows, any rows which duplicate an existing @code{PRIMARY} or @code{UNIQUE} rows, any rows that duplicate an existing @code{PRIMARY} or @code{UNIQUE}
key in the table are ignored and are not inserted. If you do not specify key in the table are ignored and are not inserted. If you do not specify
@code{IGNORE}, the insert is aborted if there is any row that duplicates an @code{IGNORE}, the insert is aborted if there is any row that duplicates an
existing key value. You can check with the C API function existing key value. You can check with the C API function
...@@ -18747,7 +18747,7 @@ specify values for all columns that require a non-@code{NULL} value. ...@@ -18747,7 +18747,7 @@ specify values for all columns that require a non-@code{NULL} value.
@xref{configure options, , @code{configure} options}. @xref{configure options, , @code{configure} options}.
@item @item
The following conditions hold for a @code{INSERT INTO ... SELECT} statement: The following conditions hold for an @code{INSERT INTO ... SELECT} statement:
@itemize @minus @itemize @minus
@item @item
...@@ -18755,7 +18755,7 @@ The query cannot contain an @code{ORDER BY} clause. ...@@ -18755,7 +18755,7 @@ The query cannot contain an @code{ORDER BY} clause.
@item @item
The target table of the @code{INSERT} statement cannot appear in the The target table of the @code{INSERT} statement cannot appear in the
@code{FROM} clause of the @code{SELECT} part of the query, because it's @code{FROM} clause of the @code{SELECT} part of the query because it's
forbidden in ANSI SQL to @code{SELECT} from the same table into which you are forbidden in ANSI SQL to @code{SELECT} from the same table into which you are
inserting. (The problem is that the @code{SELECT} possibly would inserting. (The problem is that the @code{SELECT} possibly would
find records that were inserted earlier during the same run. When using find records that were inserted earlier during the same run. When using
...@@ -18767,7 +18767,7 @@ sub-select clauses, the situation could easily be very confusing!) ...@@ -18767,7 +18767,7 @@ sub-select clauses, the situation could easily be very confusing!)
@end itemize @end itemize
@findex mysql_info() @findex mysql_info()
If you use @code{INSERT ... SELECT} or a @code{INSERT ... VALUES} If you use @code{INSERT ... SELECT} or an @code{INSERT ... VALUES}
statement with multiple value lists, you can use the C API function statement with multiple value lists, you can use the C API function
@code{mysql_info()} to get information about the query. The format of the @code{mysql_info()} to get information about the query. The format of the
information string is shown below: information string is shown below:
...@@ -18797,13 +18797,13 @@ garbage is stripped and the remaining numeric part is inserted. If the value ...@@ -18797,13 +18797,13 @@ garbage is stripped and the remaining numeric part is inserted. If the value
doesn't make sense as a number at all, the column is set to @code{0}. doesn't make sense as a number at all, the column is set to @code{0}.
@item @item
Inserting a string into a @code{CHAR}, @code{VARCHAR}, @code{TEXT} or Inserting a string into a @code{CHAR}, @code{VARCHAR}, @code{TEXT}, or
@code{BLOB} column that exceeds the column's maximum length. The value is @code{BLOB} column that exceeds the column's maximum length. The value is
truncated to the column's maximum length. truncated to the column's maximum length.
@item @item
Inserting a value into a date or time column that is illegal for the column Inserting a value into a date or time column that is illegal for the column
type. The column is set to the appropriate ``zero'' value for the type. type. The column is set to the appropriate zero value for the type.
@end itemize @end itemize
@findex INSERT DELAYED @findex INSERT DELAYED
...@@ -18815,10 +18815,10 @@ for the ...@@ -18815,10 +18815,10 @@ for the
useful if you have clients that can't wait for the @code{INSERT} to complete. useful if you have clients that can't wait for the @code{INSERT} to complete.
This is a common problem when you use @strong{MySQL} for logging and you also This is a common problem when you use @strong{MySQL} for logging and you also
periodically run @code{SELECT} statements that take a long time to complete. periodically run @code{SELECT} statements that take a long time to complete.
@code{DELAYED} was introduced in @strong{MySQL} 3.22.15. It is a @code{DELAYED} was introduced in @strong{MySQL} Version 3.22.15. It is a
@strong{MySQL} extension to ANSI SQL92. @strong{MySQL} extension to ANSI SQL92.
When you use @code{INSERT DELAYED}, the client will get an ok at once When you use @code{INSERT DELAYED}, the client will get an OK at once
and the row will be inserted when the table is not in use by any other thread. and the row will be inserted when the table is not in use by any other thread.
Another major benefit of using @code{INSERT DELAYED} is that inserts Another major benefit of using @code{INSERT DELAYED} is that inserts
...@@ -18851,8 +18851,8 @@ or @code{WRITE} lock on the table. However, the handler will wait for all ...@@ -18851,8 +18851,8 @@ or @code{WRITE} lock on the table. However, the handler will wait for all
structure is up to date. structure is up to date.
@item @item
The thread executes the @code{INSERT} statement but instead of writing The thread executes the @code{INSERT} statement, but instead of writing
the row to the table it puts a copy of the final row into a queue that the row to the table, it puts a copy of the final row into a queue that
is managed by the handler thread. Any syntax errors are noticed by the is managed by the handler thread. Any syntax errors are noticed by the
thread and reported to the client program. thread and reported to the client program.
...@@ -18898,7 +18898,7 @@ Note that the above means that @code{INSERT DELAYED} commands have higher ...@@ -18898,7 +18898,7 @@ Note that the above means that @code{INSERT DELAYED} commands have higher
priority than normal @code{INSERT} commands if there is an @code{INSERT priority than normal @code{INSERT} commands if there is an @code{INSERT
DELAYED} handler already running! Other update commands will have to wait DELAYED} handler already running! Other update commands will have to wait
until the @code{INSERT DELAYED} queue is empty, someone kills the handler until the @code{INSERT DELAYED} queue is empty, someone kills the handler
thread (with @code{KILL thread_id}) or someone executes @code{FLUSH TABLES}. thread (with @code{KILL thread_id}), or someone executes @code{FLUSH TABLES}.
@item @item
The following status variables provide information about @code{INSERT The following status variables provide information about @code{INSERT
...@@ -18923,7 +18923,7 @@ DELAYED} when you are really sure you need it! ...@@ -18923,7 +18923,7 @@ DELAYED} when you are really sure you need it!
@findex REPLACE @findex REPLACE
@node REPLACE, LOAD DATA, INSERT, Reference @node REPLACE, LOAD DATA, INSERT, Reference
@section @code{REPLACE} syntax @section @code{REPLACE} Syntax
@example @example
REPLACE [LOW_PRIORITY | DELAYED] REPLACE [LOW_PRIORITY | DELAYED]
...@@ -18947,7 +18947,7 @@ In other words, you can't access the values of the old row from a ...@@ -18947,7 +18947,7 @@ In other words, you can't access the values of the old row from a
@findex LOAD DATA INFILE @findex LOAD DATA INFILE
@node LOAD DATA, UPDATE, REPLACE, Reference @node LOAD DATA, UPDATE, REPLACE, Reference
@section @code{LOAD DATA INFILE} syntax @section @code{LOAD DATA INFILE} Syntax
@example @example
LOAD DATA [LOW_PRIORITY] [LOCAL] INFILE 'file_name.txt' [REPLACE | IGNORE] LOAD DATA [LOW_PRIORITY] [LOCAL] INFILE 'file_name.txt' [REPLACE | IGNORE]
...@@ -18966,7 +18966,7 @@ The @code{LOAD DATA INFILE} statement reads rows from a text file into a ...@@ -18966,7 +18966,7 @@ The @code{LOAD DATA INFILE} statement reads rows from a text file into a
table at a very high speed. If the @code{LOCAL} keyword is specified, the table at a very high speed. If the @code{LOCAL} keyword is specified, the
file is read from the client host. If @code{LOCAL} is not specified, the file is read from the client host. If @code{LOCAL} is not specified, the
file must be located on the server. (@code{LOCAL} is available in file must be located on the server. (@code{LOCAL} is available in
@strong{MySQL} 3.22.6 or later.) @strong{MySQL} Version 3.22.6 or later.)
For security reasons, when reading text files located on the server, the For security reasons, when reading text files located on the server, the
files must either reside in the database directory or be readable by all. files must either reside in the database directory or be readable by all.
...@@ -18985,7 +18985,7 @@ host to the server host. On the other hand, you do not need the ...@@ -18985,7 +18985,7 @@ host to the server host. On the other hand, you do not need the
@c old version @c old version
If you are using @strong{MySQL} before Version 3.23.24 you can't read from a If you are using @strong{MySQL} before Version 3.23.24 you can't read from a
FIFO with @code{LOAD DATA INFILE}; If you need to read from a FIFO (for FIFO with @code{LOAD DATA INFILE}. If you need to read from a FIFO (for
example the output from gunzip), use @code{LOAD DATA LOCAL INFILE} example the output from gunzip), use @code{LOAD DATA LOCAL INFILE}
instead. instead.
...@@ -19052,7 +19052,7 @@ must precede @code{LINES} if both are specified. ...@@ -19052,7 +19052,7 @@ must precede @code{LINES} if both are specified.
If you specify a @code{FIELDS} clause, If you specify a @code{FIELDS} clause,
each of its subclauses (@code{TERMINATED BY}, @code{[OPTIONALLY] ENCLOSED each of its subclauses (@code{TERMINATED BY}, @code{[OPTIONALLY] ENCLOSED
BY} and @code{ESCAPED BY}) is also optional, except that you must BY}, and @code{ESCAPED BY}) is also optional, except that you must
specify at least one of them. specify at least one of them.
If you don't specify a @code{FIELDS} clause, the defaults are the If you don't specify a @code{FIELDS} clause, the defaults are the
...@@ -19074,17 +19074,17 @@ when reading input: ...@@ -19074,17 +19074,17 @@ when reading input:
@itemize @bullet @itemize @bullet
@item @item
Look for line boundaries at newlines Look for line boundaries at newlines.
@item @item
Break lines into fields at tabs Break lines into fields at tabs.
@item @item
Do not expect fields to be enclosed within any quoting characters Do not expect fields to be enclosed within any quoting characters.
@item @item
Interpret occurrences of tab, newline or @samp{\} preceded by Interpret occurrences of tab, newline, or @samp{\} preceded by
@samp{\} as literal characters that are part of field values @samp{\} as literal characters that are part of field values.
@end itemize @end itemize
Conversely, the defaults cause @code{SELECT ... INTO OUTFILE} to act as Conversely, the defaults cause @code{SELECT ... INTO OUTFILE} to act as
...@@ -19092,17 +19092,17 @@ follows when writing output: ...@@ -19092,17 +19092,17 @@ follows when writing output:
@itemize @bullet @itemize @bullet
@item @item
Write tabs between fields Write tabs between fields.
@item @item
Do not enclose fields within any quoting characters Do not enclose fields within any quoting characters.
@item @item
Use @samp{\} to escape instances of tab, newline or @samp{\} that occur Use @samp{\} to escape instances of tab, newline or @samp{\} that occur
within field values within field values.
@item @item
Write newlines at the ends of lines Write newlines at the ends of lines.
@end itemize @end itemize
Note that to write @code{FIELDS ESCAPED BY '\\'}, you must specify two Note that to write @code{FIELDS ESCAPED BY '\\'}, you must specify two
...@@ -19271,7 +19271,7 @@ values are written and read using the ``display'' widths of the columns. For ...@@ -19271,7 +19271,7 @@ values are written and read using the ``display'' widths of the columns. For
example, if a column is declared as @code{INT(7)}, values for the column are example, if a column is declared as @code{INT(7)}, values for the column are
written using 7-character fields. On input, values for the column are written using 7-character fields. On input, values for the column are
obtained by reading 7 characters. Fixed-row format also affects handling of obtained by reading 7 characters. Fixed-row format also affects handling of
@code{NULL} values; see below. Note that fixed size format will not work @code{NULL} values; see below. Note that fixed-size format will not work
if you are using a multi-byte character set. if you are using a multi-byte character set.
@end itemize @end itemize
...@@ -19420,7 +19420,7 @@ For more information about the efficiency of @code{INSERT} versus ...@@ -19420,7 +19420,7 @@ For more information about the efficiency of @code{INSERT} versus
@findex UPDATE @findex UPDATE
@node UPDATE, USE, LOAD DATA, Reference @node UPDATE, USE, LOAD DATA, Reference
@section @code{UPDATE} syntax @section @code{UPDATE} Syntax
@example @example
UPDATE [LOW_PRIORITY] [IGNORE] tbl_name SET col_name1=expr1,col_name2=expr2,... UPDATE [LOW_PRIORITY] [IGNORE] tbl_name SET col_name1=expr1,col_name2=expr2,...
...@@ -19460,16 +19460,16 @@ this and doesn't update it. ...@@ -19460,16 +19460,16 @@ this and doesn't update it.
@findex mysql_info() @findex mysql_info()
@code{UPDATE} returns the number of rows that were actually changed. @code{UPDATE} returns the number of rows that were actually changed.
In @strong{MySQL} 3.22 or later, the C API function @code{mysql_info()} In @strong{MySQL} Version 3.22 or later, the C API function @code{mysql_info()}
returns the number of rows that were matched and updated and the number of returns the number of rows that were matched and updated and the number of
warnings that occurred during the @code{UPDATE}. warnings that occurred during the @code{UPDATE}.
In @strong{MySQL} Version 3.23 you can use @code{LIMIT #} to ensure that In @strong{MySQL} Version 3.23, you can use @code{LIMIT #} to ensure that
only a given number of rows are changed. only a given number of rows are changed.
@findex USE @findex USE
@node USE, FLUSH, UPDATE, Reference @node USE, FLUSH, UPDATE, Reference
@section @code{USE} syntax @section @code{USE} Syntax
@example @example
USE db_name USE db_name
...@@ -19477,7 +19477,7 @@ USE db_name ...@@ -19477,7 +19477,7 @@ USE db_name
The @code{USE db_name} statement tells @strong{MySQL} to use the @code{db_name} The @code{USE db_name} statement tells @strong{MySQL} to use the @code{db_name}
database as the default database for subsequent queries. The database remains database as the default database for subsequent queries. The database remains
current until the end of the session, or until another @code{USE} statement current until the end of the session or until another @code{USE} statement
is issued: is issued:
@example @example
...@@ -19507,7 +19507,7 @@ The @code{USE} statement is provided for Sybase compatibility. ...@@ -19507,7 +19507,7 @@ The @code{USE} statement is provided for Sybase compatibility.
@cindex caches, clearing @cindex caches, clearing
@findex FLUSH @findex FLUSH
@node FLUSH, KILL, USE, Reference @node FLUSH, KILL, USE, Reference
@section @code{FLUSH} syntax (clearing caches) @section @code{FLUSH} Syntax (Clearing Caches)
@example @example
FLUSH flush_option [,flush_option] FLUSH flush_option [,flush_option]
...@@ -19542,7 +19542,7 @@ the @code{mysql} database. ...@@ -19542,7 +19542,7 @@ the @code{mysql} database.
@item @code{TABLES} @tab Closes all open tables and force all tables in use to be closed. @item @code{TABLES} @tab Closes all open tables and force all tables in use to be closed.
@item @code{[TABLE | TABLES] table_name [,table_name...]} @tab Flush only the given tables @item @code{[TABLE | TABLES] table_name [,table_name...]} @tab Flushes only the given tables.
@item @code{TABLES WITH READ LOCK} @tab Closes all open tables and locks all tables for all databases with a read until one executes @code{UNLOCK TABLES}. This is very convinient way to get backups if you have a file system, like Veritas,that can take snapshots in time. @item @code{TABLES WITH READ LOCK} @tab Closes all open tables and locks all tables for all databases with a read until one executes @code{UNLOCK TABLES}. This is very convinient way to get backups if you have a file system, like Veritas,that can take snapshots in time.
...@@ -19550,20 +19550,20 @@ the @code{mysql} database. ...@@ -19550,20 +19550,20 @@ the @code{mysql} database.
@end multitable @end multitable
You can also access each of the commands shown above with the @code{mysqladmin} You can also access each of the commands shown above with the @code{mysqladmin}
utility, using the @code{flush-hosts}, @code{flush-logs}, @code{reload} utility, using the @code{flush-hosts}, @code{flush-logs}, @code{reload},
or @code{flush-tables} commands. or @code{flush-tables} commands.
@cindex @code{mysqladmin} @cindex @code{mysqladmin}
@findex KILL @findex KILL
@node KILL, SHOW, FLUSH, Reference @node KILL, SHOW, FLUSH, Reference
@section @code{KILL} syntax @section @code{KILL} Syntax
@example @example
KILL thread_id KILL thread_id
@end example @end example
Each connection to @code{mysqld} runs in a separate thread. You can see Each connection to @code{mysqld} runs in a separate thread. You can see
which threads are running with the @code{SHOW PROCESSLIST} command, and kill which threads are running with the @code{SHOW PROCESSLIST} command and kill
a thread with the @code{KILL thread_id} command. a thread with the @code{KILL thread_id} command.
If you have the @strong{process} privilege, you can see and kill all threads. If you have the @strong{process} privilege, you can see and kill all threads.
...@@ -19585,7 +19585,7 @@ commands to examine and kill threads. ...@@ -19585,7 +19585,7 @@ commands to examine and kill threads.
@findex SHOW GRANTS @findex SHOW GRANTS
@findex SHOW CREATE TABLE @findex SHOW CREATE TABLE
@node SHOW, EXPLAIN, KILL, Reference @node SHOW, EXPLAIN, KILL, Reference
@section @code{SHOW} syntax (Get information about tables, columns,...) @section @code{SHOW} Syntax (Get Information About Tables, Columns,...)
@example @example
SHOW DATABASES [LIKE wild] SHOW DATABASES [LIKE wild]
...@@ -19600,7 +19600,7 @@ or SHOW GRANTS FOR user ...@@ -19600,7 +19600,7 @@ or SHOW GRANTS FOR user
or SHOW CREATE TABLE table_name or SHOW CREATE TABLE table_name
@end example @end example
@code{SHOW} provides information about databases, tables, columns or @code{SHOW} provides information about databases, tables, columns, or
status information about the server. If the @code{LIKE wild} part is status information about the server. If the @code{LIKE wild} part is
used, the @code{wild} string can be a string that uses the SQL @samp{%} used, the @code{wild} string can be a string that uses the SQL @samp{%}
and @samp{_} wild-card characters. and @samp{_} wild-card characters.
...@@ -19623,7 +19623,7 @@ and @samp{_} wild-card characters. ...@@ -19623,7 +19623,7 @@ and @samp{_} wild-card characters.
@cindex displaying, information, @code{SHOW} @cindex displaying, information, @code{SHOW}
@node SHOW DATABASE INFO, SHOW TABLE STATUS, SHOW, SHOW @node SHOW DATABASE INFO, SHOW TABLE STATUS, SHOW, SHOW
@subsection SHOW information about database, tables, columns and index @subsection SHOW Information About Databases, Tables, Columns, and Indexes
You can use @code{db_name.tbl_name} as an alternative to the @code{tbl_name You can use @code{db_name.tbl_name} as an alternative to the @code{tbl_name
FROM db_name} syntax. These two statements are equivalent: FROM db_name} syntax. These two statements are equivalent:
...@@ -19639,7 +19639,7 @@ host. You can also get this list using the @code{mysqlshow} command. ...@@ -19639,7 +19639,7 @@ host. You can also get this list using the @code{mysqlshow} command.
@code{SHOW TABLES} lists the tables in a given database. You can also @code{SHOW TABLES} lists the tables in a given database. You can also
get this list using the @code{mysqlshow db_name} command. get this list using the @code{mysqlshow db_name} command.
@strong{Note:} If a user doesn't have any privileges for a table, the table @strong{NOTE:} If a user doesn't have any privileges for a table, the table
will not show up in the output from @code{SHOW TABLES} or @code{mysqlshow will not show up in the output from @code{SHOW TABLES} or @code{mysqlshow
db_name}. db_name}.
...@@ -19652,7 +19652,7 @@ The @code{DESCRIBE} statement provides information similar to ...@@ -19652,7 +19652,7 @@ The @code{DESCRIBE} statement provides information similar to
@code{SHOW COLUMNS}. @code{SHOW COLUMNS}.
@xref{DESCRIBE, , @code{DESCRIBE}}. @xref{DESCRIBE, , @code{DESCRIBE}}.
@code{SHOW FIELDS} is a synonym for @code{SHOW COLUMNS} and @code{SHOW FIELDS} is a synonym for @code{SHOW COLUMNS}, and
@code{SHOW KEYS} is a synonym for @code{SHOW INDEX}. You can also @code{SHOW KEYS} is a synonym for @code{SHOW INDEX}. You can also
list a table's columns or indexes with @code{mysqlshow db_name tbl_name} list a table's columns or indexes with @code{mysqlshow db_name tbl_name}
or @code{mysqlshow -k db_name tbl_name}. or @code{mysqlshow -k db_name tbl_name}.
...@@ -19663,9 +19663,9 @@ are returned: ...@@ -19663,9 +19663,9 @@ are returned:
@multitable @columnfractions .35 .65 @multitable @columnfractions .35 .65
@item @strong{Column} @tab @strong{Meaning} @item @strong{Column} @tab @strong{Meaning}
@item @code{Table} @tab Name of the table @item @code{Table} @tab Name of the table.
@item @code{Non_unique} @tab 0 if the index can't contain duplicates. @item @code{Non_unique} @tab 0 if the index can't contain duplicates.
@item @code{Key_name} @tab Name of the index @item @code{Key_name} @tab Name of the index.
@item @code{Seq_in_index} @tab Column sequence number in index, starting with 1. @item @code{Seq_in_index} @tab Column sequence number in index, starting with 1.
@item @code{Column_name} @tab Column name. @item @code{Column_name} @tab Column name.
@item @code{Collation} @tab How the column is sorted in the index. In @item @code{Collation} @tab How the column is sorted in the index. In
...@@ -19681,34 +19681,34 @@ only partly indexed. @code{NULL} if the entire key is indexed. ...@@ -19681,34 +19681,34 @@ only partly indexed. @code{NULL} if the entire key is indexed.
@cindex tables, displaying status @cindex tables, displaying status
@cindex status, tables @cindex status, tables
@node SHOW TABLE STATUS, SHOW STATUS, SHOW DATABASE INFO, SHOW @node SHOW TABLE STATUS, SHOW STATUS, SHOW DATABASE INFO, SHOW
@subsection SHOW status information about tables @subsection SHOW Status Information About Tables
@code{SHOW TABLE STATUS} (new in version 3.23) works likes @code{SHOW @code{SHOW TABLE STATUS} (new in Version 3.23) works likes @code{SHOW
STATUS}, but provides a lot of information about each table. You can STATUS}, but provides a lot of information about each table. You can
also get this list using the @code{mysqlshow --status db_name} command. also get this list using the @code{mysqlshow --status db_name} command.
The following columns are returned: The following columns are returned:
@multitable @columnfractions .30 .70 @multitable @columnfractions .30 .70
@item @strong{Column} @tab @strong{Meaning} @item @strong{Column} @tab @strong{Meaning}
@item @code{Name} @tab Name of the table @item @code{Name} @tab Name of the table.
@item @code{Type} @tab Type of table (BDB, ISAM, MERGE, MyISAM or HEAP) @item @code{Type} @tab Type of table (BDB, ISAM, MERGE, MyISAM, or HEAP).
@item @code{Row_format} @tab The row storage format (Fixed, Dynamic, or Compressed) @item @code{Row_format} @tab The row storage format (Fixed, Dynamic, or Compressed).
@item @code{Rows} @tab Number of rows @item @code{Rows} @tab Number of rows.
@item @code{Avg_row_length} @tab Average row length @item @code{Avg_row_length} @tab Average row length.
@item @code{Data_length} @tab Length of the data file @item @code{Data_length} @tab Length of the data file.
@item @code{Max_data_length} @tab Max length of the data file @item @code{Max_data_length} @tab Max length of the data file.
@item @code{Index_length} @tab Length of the index file @item @code{Index_length} @tab Length of the index file.
@item @code{Data_free} @tab Number of allocated but not used bytes @item @code{Data_free} @tab Number of allocated but not used bytes.
@item @code{Auto_increment} @tab Next autoincrement value @item @code{Auto_increment} @tab Next autoincrement value.
@item @code{Create_time} @tab When the table was created @item @code{Create_time} @tab When the table was created.
@item @code{Update_time} @tab When the data file was last updated @item @code{Update_time} @tab When the data file was last updated.
@item @code{Check_time} @tab When one last run a check on the table @item @code{Check_time} @tab When the table was last checked.
@item @code{Create_options} @tab Extra options used with @code{CREATE TABLE} @item @code{Create_options} @tab Extra options used with @code{CREATE TABLE}.
@item @code{Comment} @tab The comment used when creating the table (or some information why @strong{MySQL} couldn't access the table information). @item @code{Comment} @tab The comment used when creating the table (or some information why @strong{MySQL} couldn't access the table information).
@end multitable @end multitable
@node SHOW STATUS, SHOW VARIABLES, SHOW TABLE STATUS, SHOW @node SHOW STATUS, SHOW VARIABLES, SHOW TABLE STATUS, SHOW
@subsection SHOW status information @subsection SHOW Status Information
@cindex @code{mysqladmin} @cindex @code{mysqladmin}
@code{SHOW STATUS} provides server status information @code{SHOW STATUS} provides server status information
...@@ -19775,13 +19775,13 @@ The status variables listed above have the following meaning: ...@@ -19775,13 +19775,13 @@ The status variables listed above have the following meaning:
@multitable @columnfractions .35 .65 @multitable @columnfractions .35 .65
@item @strong{Variable} @tab @strong{Meaning} @item @strong{Variable} @tab @strong{Meaning}
@item @code{Aborted_clients} @tab Number of connections that has been aborted because the client has died without closing the connection properly. @item @code{Aborted_clients} @tab Number of connections aborted because the client died without closing the connection properly.
@item @code{Aborted_connects} @tab Number of tries to connect to the @strong{MySQL} server that has failed. @item @code{Aborted_connects} @tab Number of tries to connect to the @strong{MySQL} server that failed.
@item @code{Bytes_received} @tab Number of bytes received from all clients @item @code{Bytes_received} @tab Number of bytes received from all clients.
@item @code{Bytes_sent} @tab Number of bytes sent to all clients @item @code{Bytes_sent} @tab Number of bytes sent to all clients.
@item @code{Connections} @tab Number of connection attempts to the @strong{MySQL} server. @item @code{Connections} @tab Number of connection attempts to the @strong{MySQL} server.
@item @code{Created_tmp_disk_tables} @tab Number of implicit temporary tables on disk that have been created while executing statements. @item @code{Created_tmp_disk_tables} @tab Number of implicit temporary tables on disk created while executing statements.
@item @code{Created_tmp_tables} @tab Number of implicit temporary tables in memory that have been created while executing statements. @item @code{Created_tmp_tables} @tab Number of implicit temporary tables in memory created while executing statements.
@item @code{Created_tmp_files} @tab How many temporary files @code{mysqld} have created. @item @code{Created_tmp_files} @tab How many temporary files @code{mysqld} have created.
@item @code{Delayed_insert_threads} @tab Number of delayed insert handler threads in use. @item @code{Delayed_insert_threads} @tab Number of delayed insert handler threads in use.
@item @code{Delayed_writes} @tab Number of rows written with @code{INSERT DELAYED}. @item @code{Delayed_writes} @tab Number of rows written with @code{INSERT DELAYED}.
...@@ -19790,7 +19790,7 @@ The status variables listed above have the following meaning: ...@@ -19790,7 +19790,7 @@ The status variables listed above have the following meaning:
@item @code{Handler_delete} @tab Number of times a row was deleted from a table. @item @code{Handler_delete} @tab Number of times a row was deleted from a table.
@item @code{Handler_read_first} @tab Number of times the first entry was read from an index. @item @code{Handler_read_first} @tab Number of times the first entry was read from an index.
If this is high, it suggests that the server is doing a lot of full index scans, for example, If this is high, it suggests that the server is doing a lot of full index scans, for example,
@code{SELECT col1 FROM foo}, assuming that col1 is indexed @code{SELECT col1 FROM foo}, assuming that col1 is indexed.
@item @code{Handler_read_key} @tab Number of requests to read a row based on a key. If this @item @code{Handler_read_key} @tab Number of requests to read a row based on a key. If this
is high, it is a good indication that your queries and tables are properly indexed. is high, it is a good indication that your queries and tables are properly indexed.
@item @code{Handler_read_next} @tab Number of requests to read next row in key order. This @item @code{Handler_read_next} @tab Number of requests to read next row in key order. This
...@@ -19799,9 +19799,9 @@ will be incremented if you are doing an index scan. ...@@ -19799,9 +19799,9 @@ will be incremented if you are doing an index scan.
@item @code{Handler_read_rnd} @tab Number of requests to read a row based on a fixed position. @item @code{Handler_read_rnd} @tab Number of requests to read a row based on a fixed position.
This will be high if you are doing a lot of queries that require sorting of the result. This will be high if you are doing a lot of queries that require sorting of the result.
@item @code{Handler_read_rnd_next} @tab Number of requests to read the next row in the datafile. @item @code{Handler_read_rnd_next} @tab Number of requests to read the next row in the datafile.
This will be high if you are doing a lot of table scans - generally this suggests that you tables This will be high if you are doing a lot of table scans. Generally this suggests that your tables
are not properly indexed or that you queries are not written to take advantaged of the indeces you are not properly indexed or that your queries are not written to take advantage of the indexes you
have.. have.
@item @code{Handler_update} @tab Number of requests to update a row in a table. @item @code{Handler_update} @tab Number of requests to update a row in a table.
@item @code{Handler_write} @tab Number of requests to insert a row in a table. @item @code{Handler_write} @tab Number of requests to insert a row in a table.
@item @code{Key_blocks_used} @tab The number of used blocks in the key cache. @item @code{Key_blocks_used} @tab The number of used blocks in the key cache.
...@@ -19809,21 +19809,21 @@ have.. ...@@ -19809,21 +19809,21 @@ have..
@item @code{Key_reads} @tab The number of physical reads of a key block from disk. @item @code{Key_reads} @tab The number of physical reads of a key block from disk.
@item @code{Key_write_requests} @tab The number of requests to write a key block to the cache. @item @code{Key_write_requests} @tab The number of requests to write a key block to the cache.
@item @code{Key_writes} @tab The number of physical writes of a key block to disk. @item @code{Key_writes} @tab The number of physical writes of a key block to disk.
@item @code{Max_used_connections} @tab The maximum number of connections that has been in use simultaneously. @item @code{Max_used_connections} @tab The maximum number of connections in use simultaneously.
@item @code{Not_flushed_key_blocks} @tab Keys blocks in the key cache that has changed but hasn't yet been flushed to disk. @item @code{Not_flushed_key_blocks} @tab Keys blocks in the key cache that has changed but hasn't yet been flushed to disk.
@item @code{Not_flushed_delayed_rows} @tab Number of rows waiting to be written in @code{INSERT DELAY} queues. @item @code{Not_flushed_delayed_rows} @tab Number of rows waiting to be written in @code{INSERT DELAY} queues.
@item @code{Open_tables} @tab Number of tables that are open. @item @code{Open_tables} @tab Number of tables that are open.
@item @code{Open_files} @tab Number of files that are open. @item @code{Open_files} @tab Number of files that are open.
@item @code{Open_streams} @tab Number of streams that are open (used mainly for logging) @item @code{Open_streams} @tab Number of streams that are open (used mainly for logging).
@item @code{Opened_tables} @tab Number of tables that have been opened. @item @code{Opened_tables} @tab Number of tables that have been opened.
@item @code{Select_full_join} @tab Number of joins without keys (Should be 0). @item @code{Select_full_join} @tab Number of joins without keys (Should be 0).
@item @code{Select_full_range_join} @tab Number of joins where we used a range search on reference table. @item @code{Select_full_range_join} @tab Number of joins where we used a range search on reference table.
@item @code{Select_range} @tab Number of joins where we used ranges on the first table (It's normally not critical even if this is big) @item @code{Select_range} @tab Number of joins where we used ranges on the first table. (It's normally not critical even if this is big.)
@item @code{Select_scan} @tab Number of joins where we scanned the first table. @item @code{Select_scan} @tab Number of joins where we scanned the first table.
@item @code{Select_range_check} @tab Number of joins without keys where we check for key usage after each row (Should be 0). @item @code{Select_range_check} @tab Number of joins without keys where we check for key usage after each row (Should be 0).
@item @code{Questions} @tab Number of queries sent to the server. @item @code{Questions} @tab Number of queries sent to the server.
@item @code{Slow_launch_threads} @tab Number of threads that have taken more than @code{slow_launch_time} to connect. @item @code{Slow_launch_threads} @tab Number of threads that have taken more than @code{slow_launch_time} to connect.
@item @code{Slow_queries} @tab Number of queries that has taken more than @code{long_query_time}. @xref{Slow query log}. @item @code{Slow_queries} @tab Number of queries that have taken more than @code{long_query_time}. @xref{Slow query log}.
@item @code{Sort_merge_passes} @tab Number of merges the sort has to do. If this value is large you should consider increasing @code{sort_buffer}. @item @code{Sort_merge_passes} @tab Number of merges the sort has to do. If this value is large you should consider increasing @code{sort_buffer}.
@item @code{Sort_range} @tab Number of sorts that where done with ranges. @item @code{Sort_range} @tab Number of sorts that where done with ranges.
@item @code{Sort_rows} @tab Number of sorted rows. @item @code{Sort_rows} @tab Number of sorted rows.
...@@ -19845,9 +19845,9 @@ If @code{key_reads} is big, then your @code{key_cache} is probably too ...@@ -19845,9 +19845,9 @@ If @code{key_reads} is big, then your @code{key_cache} is probably too
small. The cache hit rate can be calculated with small. The cache hit rate can be calculated with
@code{key_reads}/@code{key_read_requests}. @code{key_reads}/@code{key_read_requests}.
@item @item
If @code{Handler_read_rnd} is big, then you have a probably a lot of If @code{Handler_read_rnd} is big, then you probably have a lot of queries
queries that requires @strong{MySQL} to scan whole tables or you have that require @strong{MySQL} to scan whole tables or you have joins that don't use
joins that doesn't use keys properly. keys properly.
@item @item
If @code{Created_tmp_tables} or @code{Sort_merge_passes} are high then If @code{Created_tmp_tables} or @code{Sort_merge_passes} are high then
your @code{mysqld} @code{sort_buffer} variables is probably too small. your @code{mysqld} @code{sort_buffer} variables is probably too small.
...@@ -19860,7 +19860,7 @@ tables. ...@@ -19860,7 +19860,7 @@ tables.
@node SHOW VARIABLES, SHOW PROCESSLIST, SHOW STATUS, SHOW @node SHOW VARIABLES, SHOW PROCESSLIST, SHOW STATUS, SHOW
@subsection SHOW VARIABLES @subsection SHOW VARIABLES
@code{SHOW VARIABLES} shows the values of the some of @strong{MySQL} system @code{SHOW VARIABLES} shows the values of some @strong{MySQL} system
variables. You can also get this information using the @code{mysqladmin variables. You can also get this information using the @code{mysqladmin
variables} command. If the default values are unsuitable, you can set most variables} command. If the default values are unsuitable, you can set most
of these variables using command-line options when @code{mysqld} starts up. of these variables using command-line options when @code{mysqld} starts up.
...@@ -19936,11 +19936,11 @@ differ somewhat: ...@@ -19936,11 +19936,11 @@ differ somewhat:
+-------------------------+---------------------------------+ +-------------------------+---------------------------------+
@end example @end example
Each option is described below. Values for buffer sizes, lengths and stack Each option is described below. Values for buffer sizes, lengths, and stack
sizes are given in bytes. You can specify values with a suffix of @samp{K} sizes are given in bytes. You can specify values with a suffix of @samp{K}
or @samp{M} to indicate kilobytes or megabytes. For example, @code{16M} or @samp{M} to indicate kilobytes or megabytes. For example, @code{16M}
indicates 16 megabytes. The case of suffix letters does not matter; indicates 16 megabytes. The case of suffix letters does not matter;
@code{16M} and @code{16m} are equivalent. @code{16M} and @code{16m} are equivalent:
@table @code @table @code
@item @code{ansi_mode}. @item @code{ansi_mode}.
...@@ -19959,7 +19959,7 @@ number of connections in a short period of time. ...@@ -19959,7 +19959,7 @@ number of connections in a short period of time.
In other words, this value is the size of the listen queue for incoming In other words, this value is the size of the listen queue for incoming
TCP/IP connections. Your operating system has its own limit on the size TCP/IP connections. Your operating system has its own limit on the size
of this queue. The manual page for the Unix @code{listen(2)} system of this queue. The manual page for the UNIX @code{listen(2)} system
call should have more details. Check your OS documentation for the call should have more details. Check your OS documentation for the
maximum value for this variable. Attempting to set @code{back_log} maximum value for this variable. Attempting to set @code{back_log}
higher than your operating system limit will be ineffective. higher than your operating system limit will be ineffective.
...@@ -20012,7 +20012,7 @@ If enabled (is on by default), @strong{MySQL} will honor the ...@@ -20012,7 +20012,7 @@ If enabled (is on by default), @strong{MySQL} will honor the
@code{delay_key_write} option @code{CREATE TABLE}. This means that the @code{delay_key_write} option @code{CREATE TABLE}. This means that the
key buffer for tables with this option will not get flushed on every key buffer for tables with this option will not get flushed on every
index update, but only when a table is closed. This will speed up index update, but only when a table is closed. This will speed up
writes on keys a lot but you should add automatic checking of all tables writes on keys a lot, but you should add automatic checking of all tables
with @code{myisamchk --fast --force} if you use this. Note that if you with @code{myisamchk --fast --force} if you use this. Note that if you
start @code{mysqld} with the @code{--delay-key-write-for-all-tables} start @code{mysqld} with the @code{--delay-key-write-for-all-tables}
option this means that all tables will be treated as if they were option this means that all tables will be treated as if they were
...@@ -20040,7 +20040,7 @@ option. ...@@ -20040,7 +20040,7 @@ option.
@item @code{flush_time} @item @code{flush_time}
If this is set to a non-zero value, then every @code{flush_time} seconds all If this is set to a non-zero value, then every @code{flush_time} seconds all
tables will be closed (to free up resources and sync things to disk). We tables will be closed (to free up resources and sync things to disk). We
only recommend this option on Win95, Win98 or on system where you have only recommend this option on Win95, Win98, or on systems where you have
very little resources. very little resources.
@item @code{init_file} @item @code{init_file}
...@@ -20070,7 +20070,7 @@ Index blocks are buffered and are shared by all threads. ...@@ -20070,7 +20070,7 @@ Index blocks are buffered and are shared by all threads.
Increase this to get better index handling (for all reads and multiple Increase this to get better index handling (for all reads and multiple
writes) to as much as you can afford; 64M on a 256M machine that mainly writes) to as much as you can afford; 64M on a 256M machine that mainly
runs @strong{MySQL} is quite common. If you however make this too big runs @strong{MySQL} is quite common. If you, however, make this too big
(more than 50% of your total memory?) your system may start to page and (more than 50% of your total memory?) your system may start to page and
become REALLY slow. Remember that because @strong{MySQL} does not cache become REALLY slow. Remember that because @strong{MySQL} does not cache
data read, that you will have to leave some room for the OS filesystem data read, that you will have to leave some room for the OS filesystem
...@@ -20078,14 +20078,14 @@ cache. ...@@ -20078,14 +20078,14 @@ cache.
You can check the performance of the key buffer by doing @code{show You can check the performance of the key buffer by doing @code{show
status} and examine the variables @code{Key_read_requests}, status} and examine the variables @code{Key_read_requests},
@code{Key_reads}, @code{Key_write_requests} and @code{Key_writes}. The @code{Key_reads}, @code{Key_write_requests}, and @code{Key_writes}. The
@code{Key_reads/Key_read_request} ratio should normally be < 0.01. @code{Key_reads/Key_read_request} ratio should normally be < 0.01.
The @code{Key_write/Key_write_requests} is usually near 1 if you are The @code{Key_write/Key_write_requests} is usually near 1 if you are
using mostly updates/deletes but may be much smaller if you tend to using mostly updates/deletes but may be much smaller if you tend to
do updates that affect many at the same time or if you are do updates that affect many at the same time or if you are
using @code{delay_key_write}. @xref{SHOW}. using @code{delay_key_write}. @xref{SHOW}.
To get even more speed when writing many rows at the same time use To get even more speed when writing many rows at the same time, use
@code{LOCK TABLES}. @xref{LOCK TABLES, , @code{LOCK TABLES}}. @code{LOCK TABLES}. @xref{LOCK TABLES, , @code{LOCK TABLES}}.
@item @code{language} @item @code{language}
...@@ -20115,7 +20115,7 @@ will be incremented. If you are using @code{--log-slow-queries}, the query ...@@ -20115,7 +20115,7 @@ will be incremented. If you are using @code{--log-slow-queries}, the query
will be logged to the slow query logfile. @xref{Slow query log}. will be logged to the slow query logfile. @xref{Slow query log}.
@item @code{lower_case_table_names} @item @code{lower_case_table_names}
Table names are stored in lower case on disk. Table names are stored in lowercase on disk.
@item @code{max_allowed_packet} @item @code{max_allowed_packet}
The maximum size of one packet. The message buffer is initialized to The maximum size of one packet. The message buffer is initialized to
...@@ -20147,7 +20147,7 @@ Don't allow creation of heap tables bigger than this. ...@@ -20147,7 +20147,7 @@ Don't allow creation of heap tables bigger than this.
@item @code{max_join_size} @item @code{max_join_size}
Joins that are probably going to read more than @code{max_join_size} Joins that are probably going to read more than @code{max_join_size}
records return an error. Set this value if your users tend to perform joins records return an error. Set this value if your users tend to perform joins
without a @code{WHERE} clause that take a long time and return that lack a @code{WHERE} clause, that take a long time, and that return
millions of rows. millions of rows.
@item @code{max_sort_length} @item @code{max_sort_length}
...@@ -20156,7 +20156,7 @@ values (only the first @code{max_sort_length} bytes of each value ...@@ -20156,7 +20156,7 @@ values (only the first @code{max_sort_length} bytes of each value
are used; the rest are ignored). are used; the rest are ignored).
@item @code{max_tmp_tables} @item @code{max_tmp_tables}
(This option doesn't yet do anything). (This option doesn't yet do anything.)
Maximum number of temporary tables a client can keep open at the same time. Maximum number of temporary tables a client can keep open at the same time.
@item @code{max_write_lock_count} @item @code{max_write_lock_count}
...@@ -20185,7 +20185,7 @@ is defined by @code{write_timeout}. ...@@ -20185,7 +20185,7 @@ is defined by @code{write_timeout}.
@item @code{net_retry_count} @item @code{net_retry_count}
If a read on a communication port is interrupted, retry this many times If a read on a communication port is interrupted, retry this many times
before giving up. This value should be quite high on @code{FreeBSD} as before giving up. This value should be quite high on @code{FreeBSD} as
internal interrupts is sent to all threads. internal interrupts are sent to all threads.
@item @code{net_write_timeout} @item @code{net_write_timeout}
Number of seconds to wait for a block to be written to a connection before Number of seconds to wait for a block to be written to a connection before
...@@ -20219,13 +20219,13 @@ Is OFF if @code{mysqld} uses external locking. ...@@ -20219,13 +20219,13 @@ Is OFF if @code{mysqld} uses external locking.
Is ON if we only allow local (socket) connections. Is ON if we only allow local (socket) connections.
@item @code{skip_show_databases} @item @code{skip_show_databases}
This prevents people from doing @code{SHOW DATABASES}, if they don't This prevents people from doing @code{SHOW DATABASES} if they don't
have the @code{PROCESS_PRIV} privilege. This can improve security if have the @code{PROCESS_PRIV} privilege. This can improve security if
you're concerned about people being able to see what databases and you're concerned about people being able to see what databases and
tables other users have. tables other users have.
@item @code{slow_launch_time} @item @code{slow_launch_time}
If the creating of the thread longer than this (in seconds), the If creating the thread takes longer than this value (in seconds), the
@code{Slow_launch_threads} counter will be incremented. @code{Slow_launch_threads} counter will be incremented.
@item @code{socket} @item @code{socket}
...@@ -20258,19 +20258,19 @@ For information about how the table cache works, see @ref{Table cache}. ...@@ -20258,19 +20258,19 @@ For information about how the table cache works, see @ref{Table cache}.
The default table type The default table type
@item @code{thread_cache_size} @item @code{thread_cache_size}
How many threads we should keep keep in a cache for reuse. When a How many threads we should keep in a cache for reuse. When a
client disconnects the clients threads is put in the cache if there client disconnects, the client's threads are put in the cache if there
isn't more than @code{thread_cache_size} threads from before. All new aren't more than @code{thread_cache_size} threads from before. All new
threads are first taken from the cache and only when the cache is empty threads are first taken from the cache, and only when the cache is empty
a new thread is created. This variable can be increased to improve is a new thread created. This variable can be increased to improve
performance if you have a lot of new connections (Normally this doesn't performance if you have a lot of new connections. (Normally this doesn't
however give a notable performance improvement if you have a good give a notable performance improvement if you have a good
thread implementation). thread implementation.)
@item @code{thread_concurrency} @item @code{thread_concurrency}
On Solaris, @code{mysqld} will call @code{thr_setconcurrency()} with On Solaris, @code{mysqld} will call @code{thr_setconcurrency()} with
this value. @code{thr_setconcurrency()} permits the application to give this value. @code{thr_setconcurrency()} permits the application to give
the threads system a hint, for the desired number of threads that should the threads system a hint for the desired number of threads that should
be run at the same time. be run at the same time.
@item @code{thread_stack} @item @code{thread_stack}
...@@ -20306,7 +20306,7 @@ information of how to tune the above variables. @xref{Server parameters}. ...@@ -20306,7 +20306,7 @@ information of how to tune the above variables. @xref{Server parameters}.
@findex threads @findex threads
@findex PROCESSLIST @findex PROCESSLIST
@node SHOW PROCESSLIST, SHOW GRANTS, SHOW VARIABLES, SHOW @node SHOW PROCESSLIST, SHOW GRANTS, SHOW VARIABLES, SHOW
@subsection SHOW information about connected threads (processes) @subsection SHOW Information About Connected Threads (Processes)
@code{SHOW PROCESSLIST} shows you which threads are running. You can @code{SHOW PROCESSLIST} shows you which threads are running. You can
also get this information using the @code{mysqladmin processlist} also get this information using the @code{mysqladmin processlist}
...@@ -20317,7 +20317,7 @@ the first 100 characters of each query will be shown. ...@@ -20317,7 +20317,7 @@ the first 100 characters of each query will be shown.
@cindex privileges, display @cindex privileges, display
@node SHOW GRANTS, SHOW CREATE TABLE, SHOW PROCESSLIST, SHOW @node SHOW GRANTS, SHOW CREATE TABLE, SHOW PROCESSLIST, SHOW
@subsection SHOW GRANTS (privileges) for a user @subsection SHOW GRANTS (Privileges) for a User
@code{SHOW GRANTS FOR user} lists the grant commands that must be issued to @code{SHOW GRANTS FOR user} lists the grant commands that must be issued to
duplicate the grants for a user. duplicate the grants for a user.
...@@ -20333,7 +20333,7 @@ mysql> SHOW GRANTS FOR root@@localhost; ...@@ -20333,7 +20333,7 @@ mysql> SHOW GRANTS FOR root@@localhost;
@node SHOW CREATE TABLE, , SHOW GRANTS, SHOW @node SHOW CREATE TABLE, , SHOW GRANTS, SHOW
@subsection SHOW CREATE TABLE @subsection SHOW CREATE TABLE
Shows a @code{CREATE TABLE} statement that will create the given table Shows a @code{CREATE TABLE} statement that will create the given table:
@example @example
mysql> show create table t\G mysql> show create table t\G
*************************** 1. row *************************** *************************** 1. row ***************************
...@@ -20353,7 +20353,7 @@ Create Table: CREATE TABLE t ( ...@@ -20353,7 +20353,7 @@ Create Table: CREATE TABLE t (
@findex EXPLAIN @findex EXPLAIN
@findex SELECT, optimizing @findex SELECT, optimizing
@node EXPLAIN, DESCRIBE, SHOW, Reference @node EXPLAIN, DESCRIBE, SHOW, Reference
@section @code{EXPLAIN} syntax (Get information about a @code{SELECT}) @section @code{EXPLAIN} Syntax (Get Information About a @code{SELECT})
@example @example
EXPLAIN tbl_name EXPLAIN tbl_name
...@@ -20396,7 +20396,7 @@ The join type. Information about the various types is given below. ...@@ -20396,7 +20396,7 @@ The join type. Information about the various types is given below.
The @code{possible_keys} column indicates which indexes @strong{MySQL} The @code{possible_keys} column indicates which indexes @strong{MySQL}
could use to find the rows in this table. Note that this column is could use to find the rows in this table. Note that this column is
totally independent of the order of the tables. That means that some of totally independent of the order of the tables. That means that some of
the keys in possible_keys may not be useable in practice with the the keys in possible_keys may not be usable in practice with the
generated table order. generated table order.
If this column is empty, there are no relevant indexes. In this case, If this column is empty, there are no relevant indexes. In this case,
...@@ -20418,7 +20418,7 @@ decided to use. The key is @code{NULL} if no index was chosen. If ...@@ -20418,7 +20418,7 @@ decided to use. The key is @code{NULL} if no index was chosen. If
@item key_len @item key_len
The @code{key_len} column indicates the length of the key that The @code{key_len} column indicates the length of the key that
@strong{MySQL} decided to use. The length is @code{NULL} if the @strong{MySQL} decided to use. The length is @code{NULL} if the
@code{key} is @code{NULL}. Note that this tell us how many parts of a @code{key} is @code{NULL}. Note that this tells us how many parts of a
multi-part key @strong{MySQL} will actually use. multi-part key @strong{MySQL} will actually use.
@item ref @item ref
...@@ -20431,7 +20431,7 @@ believes it must examine to execute the query. ...@@ -20431,7 +20431,7 @@ believes it must examine to execute the query.
@item Extra @item Extra
This column contains additional information of how @strong{MySQL} will This column contains additional information of how @strong{MySQL} will
resolve the query. Here follows an explanation of the different text resolve the query. Here is an explanation of the different text
strings that can be found in this column: strings that can be found in this column:
@table @code @table @code
...@@ -20441,12 +20441,12 @@ combination after it has found the first matching row. ...@@ -20441,12 +20441,12 @@ combination after it has found the first matching row.
@item Not exists @item Not exists
@strong{MySQL} was able to do a @code{LEFT JOIN} optimization on the @strong{MySQL} was able to do a @code{LEFT JOIN} optimization on the
query and will not examine more rows in this table for a row combination query and will not examine more rows in this table for a row combination
after it founds one rows that matches the @code{LEFT JOIN} criteria. after it finds one row that matches the @code{LEFT JOIN} criteria.
@item @code{range checked for each record (index map: #)} @item @code{range checked for each record (index map: #)}
@strong{MySQL} didn't find a real good index to use. It will instead for @strong{MySQL} didn't find a real good index to use. It will, instead, for
each row combination in the preceding tables do a check which index to each row combination in the preceding tables, do a check on which index to
use (if any) use this index to retrieve the rows from the table. This use (if any), and use this index to retrieve the rows from the table. This
isn't very fast but is of course faster than having to do a join without isn't very fast but is faster than having to do a join without
an index. an index.
@item Using filesort @item Using filesort
@strong{MySQL} will need to do an extra pass to find out how to retrieve @strong{MySQL} will need to do an extra pass to find out how to retrieve
...@@ -20457,17 +20457,17 @@ sorted. Finally the rows are retrieved in sorted order. ...@@ -20457,17 +20457,17 @@ sorted. Finally the rows are retrieved in sorted order.
@item Using index @item Using index
The column information is retrieved from the table using only The column information is retrieved from the table using only
information in the index tree without having to do an additional seek to information in the index tree without having to do an additional seek to
read the actually row. This can be done when all the used columns for read the actual row. This can be done when all the used columns for
the table are part of the same index. the table are part of the same index.
@item Using temporary @item Using temporary
To be able to resolve the query @strong{MySQL} will need to create a To resolve the query @strong{MySQL} will need to create a
temporary table to hold the result. This typically happens if you do an temporary table to hold the result. This typically happens if you do an
@code{ORDER BY} on a different column set than you did an @code{GROUP @code{ORDER BY} on a different column set than you did a @code{GROUP
BY} on. BY} on.
@item Where used @item Where used
A @code{WHERE} clause will be used to restrict which rows will be A @code{WHERE} clause will be used to restrict which rows will be
matched against the next table or sent to the client. If you don't have matched against the next table or sent to the client. If you don't have
this information and the table is of type @code{ALL} or @code{index} this information and the table is of type @code{ALL} or @code{index},
you may have something wrong in your query (if you don't intend to you may have something wrong in your query (if you don't intend to
fetch/examine all rows from the table). fetch/examine all rows from the table).
@end table @end table
...@@ -20495,7 +20495,7 @@ optimizer. @code{const} tables are very fast as they are read only once! ...@@ -20495,7 +20495,7 @@ optimizer. @code{const} tables are very fast as they are read only once!
@item eq_ref @item eq_ref
One row will be read from this table for each combination of rows from One row will be read from this table for each combination of rows from
the previous tables. This the best possible join type, other than the the previous tables. This is the best possible join type, other than the
@code{const} types. It is used when all parts of an index are used by @code{const} types. It is used when all parts of an index are used by
the join and the index is @code{UNIQUE} or a @code{PRIMARY KEY}. the join and the index is @code{UNIQUE} or a @code{PRIMARY KEY}.
...@@ -20603,7 +20603,7 @@ Because @code{type} is @code{ALL} for each table, this output indicates that ...@@ -20603,7 +20603,7 @@ Because @code{type} is @code{ALL} for each table, this output indicates that
long time, as the product of the number of rows in each table must be long time, as the product of the number of rows in each table must be
examined! For the case at hand, this is @code{74 * 2135 * 74 * 3872 = examined! For the case at hand, this is @code{74 * 2135 * 74 * 3872 =
45,268,558,720} rows. If the tables were bigger, you can only imagine how 45,268,558,720} rows. If the tables were bigger, you can only imagine how
long it would take... long it would take.
One problem here is that @strong{MySQL} can't (yet) use indexes on columns One problem here is that @strong{MySQL} can't (yet) use indexes on columns
efficiently if they are declared differently. In this context, efficiently if they are declared differently. In this context,
...@@ -20655,7 +20655,7 @@ et_1 eq_ref PRIMARY PRIMARY 15 tt.AssignedPC 1 ...@@ -20655,7 +20655,7 @@ et_1 eq_ref PRIMARY PRIMARY 15 tt.AssignedPC 1
do eq_ref PRIMARY PRIMARY 15 tt.ClientID 1 do eq_ref PRIMARY PRIMARY 15 tt.ClientID 1
@end example @end example
This is ``almost'' as good as it can get. This is almost as good as it can get.
The remaining problem is that, by default, @strong{MySQL} assumes that values The remaining problem is that, by default, @strong{MySQL} assumes that values
in the @code{tt.ActualPC} column are evenly distributed, and that isn't the in the @code{tt.ActualPC} column are evenly distributed, and that isn't the
...@@ -20667,7 +20667,7 @@ shell> myisamchk --analyze PATH_TO_MYSQL_DATABASE/tt ...@@ -20667,7 +20667,7 @@ shell> myisamchk --analyze PATH_TO_MYSQL_DATABASE/tt
shell> mysqladmin refresh shell> mysqladmin refresh
@end example @end example
Now the join is ``perfect'', and @code{EXPLAIN} produces this result: Now the join is perfect, and @code{EXPLAIN} produces this result:
@example @example
table type possible_keys key key_len ref rows Extra table type possible_keys key key_len ref rows Extra
...@@ -20678,7 +20678,7 @@ do eq_ref PRIMARY PRIMARY 15 tt.ClientID 1 ...@@ -20678,7 +20678,7 @@ do eq_ref PRIMARY PRIMARY 15 tt.ClientID 1
@end example @end example
Note that the @code{rows} column in the output from @code{EXPLAIN} is an Note that the @code{rows} column in the output from @code{EXPLAIN} is an
``educated guess'' from the @strong{MySQL} join optimizer; To optimize a educated guess from the @strong{MySQL} join optimizer. To optimize a
query, you should check if the numbers are even close to the truth. If not, query, you should check if the numbers are even close to the truth. If not,
you may get better performance by using @code{STRAIGHT_JOIN} in your you may get better performance by using @code{STRAIGHT_JOIN} in your
@code{SELECT} statement and trying to list the tables in a different order in @code{SELECT} statement and trying to list the tables in a different order in
...@@ -20687,7 +20687,7 @@ the @code{FROM} clause. ...@@ -20687,7 +20687,7 @@ the @code{FROM} clause.
@findex DESC @findex DESC
@findex DESCRIBE @findex DESCRIBE
@node DESCRIBE, COMMIT, EXPLAIN, Reference @node DESCRIBE, COMMIT, EXPLAIN, Reference
@section @code{DESCRIBE} syntax (Get information about columns) @section @code{DESCRIBE} Syntax (Get Information About Columns)
@example @example
@{DESCRIBE | DESC@} tbl_name @{col_name | wild@} @{DESCRIBE | DESC@} tbl_name @{col_name | wild@}
...@@ -20714,7 +20714,7 @@ The @code{SHOW} statement provides similar information. ...@@ -20714,7 +20714,7 @@ The @code{SHOW} statement provides similar information.
@findex COMMIT @findex COMMIT
@findex ROLLBACK @findex ROLLBACK
@node COMMIT, LOCK TABLES, DESCRIBE, Reference @node COMMIT, LOCK TABLES, DESCRIBE, Reference
@section @code{BEGIN/COMMIT/ROLLBACK} syntax @section @code{BEGIN/COMMIT/ROLLBACK} Syntax
By default, @strong{MySQL} runs in @code{autocommit} mode. This means that By default, @strong{MySQL} runs in @code{autocommit} mode. This means that
as soon as you execute an update, @strong{MySQL} will store the update on as soon as you execute an update, @strong{MySQL} will store the update on
...@@ -20731,8 +20731,8 @@ After this you must use @code{COMMIT} to store your changes to disk or ...@@ -20731,8 +20731,8 @@ After this you must use @code{COMMIT} to store your changes to disk or
@code{ROLLBACK} if you want to ignore the changes you have made since @code{ROLLBACK} if you want to ignore the changes you have made since
the beginning of your transaction. the beginning of your transaction.
If you want to switch from @code{AUTOCOMMIT} mode for one serie of If you want to switch from @code{AUTOCOMMIT} mode for one series of
statements, you can use the @code{BEGIN} or @code{BEGIN WORK} statement. statements, you can use the @code{BEGIN} or @code{BEGIN WORK} statement:
@example @example
BEGIN; BEGIN;
...@@ -20747,7 +20747,7 @@ stored at once, independent of the status of the @code{autocommit} mode. ...@@ -20747,7 +20747,7 @@ stored at once, independent of the status of the @code{autocommit} mode.
@findex LOCK TABLES @findex LOCK TABLES
@findex UNLOCK TABLES @findex UNLOCK TABLES
@node LOCK TABLES, SET OPTION, COMMIT, Reference @node LOCK TABLES, SET OPTION, COMMIT, Reference
@section @code{LOCK TABLES/UNLOCK TABLES} syntax @section @code{LOCK TABLES/UNLOCK TABLES} Syntax
@example @example
LOCK TABLES tbl_name [AS alias] @{READ | [READ LOCAL] | [LOW_PRIORITY] WRITE@} LOCK TABLES tbl_name [AS alias] @{READ | [READ LOCAL] | [LOW_PRIORITY] WRITE@}
...@@ -20845,7 +20845,7 @@ that can take snapshots in time. ...@@ -20845,7 +20845,7 @@ that can take snapshots in time.
@findex SET OPTION @findex SET OPTION
@node SET OPTION, GRANT, LOCK TABLES, Reference @node SET OPTION, GRANT, LOCK TABLES, Reference
@section @code{SET} syntax @section @code{SET} Syntax
@example @example
SET [OPTION] SQL_VALUE_OPTION= value, ... SET [OPTION] SQL_VALUE_OPTION= value, ...
...@@ -20897,7 +20897,7 @@ ODBC programs like Access. ...@@ -20897,7 +20897,7 @@ ODBC programs like Access.
@item AUTOCOMMIT= 0 | 1 @item AUTOCOMMIT= 0 | 1
If set to @code{1} all changes to a table will be done at once. To start If set to @code{1} all changes to a table will be done at once. To start
an multi command transaction you have to use the @code{BEGIN} a multi-command transaction, you have to use the @code{BEGIN}
statement. @xref{COMMIT}. If set to @code{0} you have to use @code{COMMIT} / statement. @xref{COMMIT}. If set to @code{0} you have to use @code{COMMIT} /
@code{ROLLBACK} to accept/revoke that transaction. @xref{COMMIT}. Note @code{ROLLBACK} to accept/revoke that transaction. @xref{COMMIT}. Note
that when you change from not @code{AUTOCOMMIT} mode to that when you change from not @code{AUTOCOMMIT} mode to
...@@ -20910,7 +20910,7 @@ If set to @code{1}, all temporary tables are stored on disk rather than in ...@@ -20910,7 +20910,7 @@ If set to @code{1}, all temporary tables are stored on disk rather than in
memory. This will be a little slower, but you will not get the error memory. This will be a little slower, but you will not get the error
@code{The table tbl_name is full} for big @code{SELECT} operations that @code{The table tbl_name is full} for big @code{SELECT} operations that
require a large temporary table. The default value for a new connection is require a large temporary table. The default value for a new connection is
@code{0} (i.e., use in-memory temporary tables). @code{0} (that is, use in-memory temporary tables).
@item SQL_BIG_SELECTS = 0 | 1 @item SQL_BIG_SELECTS = 0 | 1
If set to @code{0}, @strong{MySQL} will abort if a @code{SELECT} is attempted If set to @code{0}, @strong{MySQL} will abort if a @code{SELECT} is attempted
...@@ -20927,14 +20927,14 @@ table locks early and will help in cases where it takes a long time to ...@@ -20927,14 +20927,14 @@ table locks early and will help in cases where it takes a long time to
send the result set to the client. send the result set to the client.
@item SQL_LOW_PRIORITY_UPDATES = 0 | 1 @item SQL_LOW_PRIORITY_UPDATES = 0 | 1
If set to @code{1}, all @code{INSERT}, @code{UPDATE}, @code{DELETE} and If set to @code{1}, all @code{INSERT}, @code{UPDATE}, @code{DELETE}, and
and @code{LOCK TABLE WRITE} statements wait until there is no pending and @code{LOCK TABLE WRITE} statements wait until there is no pending
@code{SELECT} or @code{LOCK TABLE READ} on the affected table. @code{SELECT} or @code{LOCK TABLE READ} on the affected table.
@item SQL_MAX_JOIN_SIZE = value | DEFAULT @item SQL_MAX_JOIN_SIZE = value | DEFAULT
Don't allow @code{SELECT}'s that will probably need to examine more than Don't allow @code{SELECT}s that will probably need to examine more than
@code{value} row combinations. By setting this value, you can catch @code{value} row combinations. By setting this value, you can catch
@code{SELECT}'s where keys are not used properly and that would probably @code{SELECT}s where keys are not used properly and that would probably
take a long time. Setting this to a value other than @code{DEFAULT} will reset take a long time. Setting this to a value other than @code{DEFAULT} will reset
the @code{SQL_BIG_SELECTS} flag. If you set the @code{SQL_BIG_SELECTS} the @code{SQL_BIG_SELECTS} flag. If you set the @code{SQL_BIG_SELECTS}
flag again, the @code{SQL_MAX_JOIN_SIZE} variable will be ignored. flag again, the @code{SQL_MAX_JOIN_SIZE} variable will be ignored.
...@@ -20942,7 +20942,7 @@ You can set a default value for this variable by starting @code{mysqld} with ...@@ -20942,7 +20942,7 @@ You can set a default value for this variable by starting @code{mysqld} with
@code{-O max_join_size=#}. @code{-O max_join_size=#}.
@item SQL_SAFE_MODE = 0 | 1 @item SQL_SAFE_MODE = 0 | 1
If set to @code{1}, @strong{MySQL} will abort if a @code{UPDATE} or If set to @code{1}, @strong{MySQL} will abort if an @code{UPDATE} or
@code{DELETE} is attempted that doesn't use a key or @code{LIMIT} in the @code{DELETE} is attempted that doesn't use a key or @code{LIMIT} in the
@code{WHERE} clause. This makes it possible to catch wrong updates @code{WHERE} clause. This makes it possible to catch wrong updates
when creating SQL commands by hand. when creating SQL commands by hand.
...@@ -20951,7 +20951,7 @@ when creating SQL commands by hand. ...@@ -20951,7 +20951,7 @@ when creating SQL commands by hand.
The maximum number of records to return from @code{SELECT} statements. If The maximum number of records to return from @code{SELECT} statements. If
a @code{SELECT} has a @code{LIMIT} clause, the @code{LIMIT} takes precedence a @code{SELECT} has a @code{LIMIT} clause, the @code{LIMIT} takes precedence
over the value of @code{SQL_SELECT_LIMIT}. The default value for a new over the value of @code{SQL_SELECT_LIMIT}. The default value for a new
connection is ``unlimited''. If you have changed the limit, the default value connection is ``unlimited.'' If you have changed the limit, the default value
can be restored by using a @code{SQL_SELECT_LIMIT} value of @code{DEFAULT}. can be restored by using a @code{SQL_SELECT_LIMIT} value of @code{DEFAULT}.
@item SQL_LOG_OFF = 0 | 1 @item SQL_LOG_OFF = 0 | 1
...@@ -20994,7 +20994,7 @@ with the update log. ...@@ -20994,7 +20994,7 @@ with the update log.
@findex GRANT @findex GRANT
@findex REVOKE @findex REVOKE
@node GRANT, CREATE INDEX, SET OPTION, Reference @node GRANT, CREATE INDEX, SET OPTION, Reference
@section @code{GRANT} and @code{REVOKE} syntax @section @code{GRANT} and @code{REVOKE} Syntax
@example @example
GRANT priv_type [(column_list)] [, priv_type [(column_list)] ...] GRANT priv_type [(column_list)] [, priv_type [(column_list)] ...]
...@@ -21008,7 +21008,7 @@ REVOKE priv_type [(column_list)] [, priv_type [(column_list)] ...] ...@@ -21008,7 +21008,7 @@ REVOKE priv_type [(column_list)] [, priv_type [(column_list)] ...]
FROM user_name [, user_name ...] FROM user_name [, user_name ...]
@end example @end example
@code{GRANT} is implemented in @strong{MySQL} 3.22.11 or later. For @code{GRANT} is implemented in @strong{MySQL} Version 3.22.11 or later. For
earlier @strong{MySQL} versions, the @code{GRANT} statement does nothing. earlier @strong{MySQL} versions, the @code{GRANT} statement does nothing.
The @code{GRANT} and @code{REVOKE} commands allow system administrators to The @code{GRANT} and @code{REVOKE} commands allow system administrators to
...@@ -21046,7 +21046,7 @@ DROP REFERENCES USAGE ...@@ -21046,7 +21046,7 @@ DROP REFERENCES USAGE
@end example @end example
@code{ALL} is a synonym for @code{ALL PRIVILEGES}. @code{REFERENCES} is not @code{ALL} is a synonym for @code{ALL PRIVILEGES}. @code{REFERENCES} is not
yet implemented. @code{USAGE} is currently a synonym for ``no privileges''. yet implemented. @code{USAGE} is currently a synonym for ``no privileges.''
It can be used when you want to create a user that has no privileges. It can be used when you want to create a user that has no privileges.
To revoke the @strong{grant} privilege from a user, use a @code{priv_type} To revoke the @strong{grant} privilege from a user, use a @code{priv_type}
...@@ -21058,16 +21058,16 @@ REVOKE GRANT OPTION ON ... FROM ...; ...@@ -21058,16 +21058,16 @@ REVOKE GRANT OPTION ON ... FROM ...;
The only @code{priv_type} values you can specify for a table are @code{SELECT}, The only @code{priv_type} values you can specify for a table are @code{SELECT},
@code{INSERT}, @code{UPDATE}, @code{DELETE}, @code{CREATE}, @code{DROP}, @code{INSERT}, @code{UPDATE}, @code{DELETE}, @code{CREATE}, @code{DROP},
@code{GRANT}, @code{INDEX} and @code{ALTER}. @code{GRANT}, @code{INDEX}, and @code{ALTER}.
The only @code{priv_type} values you can specify for a column (that is, when The only @code{priv_type} values you can specify for a column (that is, when
you use a @code{column_list} clause) are @code{SELECT}, @code{INSERT} and you use a @code{column_list} clause) are @code{SELECT}, @code{INSERT}, and
@code{UPDATE}. @code{UPDATE}.
You can set global privileges by using @code{ON *.*} syntax. You can set You can set global privileges by using @code{ON *.*} syntax. You can set
database privileges by using @code{ON db_name.*} syntax. If you specify database privileges by using @code{ON db_name.*} syntax. If you specify
@code{ON *} and you have a current database, you will set the privileges for @code{ON *} and you have a current database, you will set the privileges for
that database. (@strong{Warning:} If you specify @code{ON *} and you that database. (@strong{WARNING:} If you specify @code{ON *} and you
@emph{don't} have a current database, you will affect the global privileges!) @emph{don't} have a current database, you will affect the global privileges!)
In order to accommodate granting rights to users from arbitrary hosts, In order to accommodate granting rights to users from arbitrary hosts,
...@@ -21083,7 +21083,7 @@ You can specify wild cards in the hostname. For example, ...@@ -21083,7 +21083,7 @@ You can specify wild cards in the hostname. For example,
for any host in the @code{144.155.166} class C subnet. for any host in the @code{144.155.166} class C subnet.
The simple form @code{user} is a synonym for @code{user@@"%"}. The simple form @code{user} is a synonym for @code{user@@"%"}.
@strong{Note:} If you allow anonymous users to connect to the @strong{MySQL} @strong{NOTE:} If you allow anonymous users to connect to the @strong{MySQL}
server (which is the default), you should also add all local users as server (which is the default), you should also add all local users as
@code{user@@localhost} because otherwise the anonymous user entry for the @code{user@@localhost} because otherwise the anonymous user entry for the
local host in the @code{mysql.user} table will be used when the user tries to local host in the @code{mysql.user} table will be used when the user tries to
...@@ -21096,7 +21096,7 @@ this query: ...@@ -21096,7 +21096,7 @@ this query:
mysql> SELECT Host,User FROM mysql.user WHERE User=''; mysql> SELECT Host,User FROM mysql.user WHERE User='';
@end example @end example
For the moment, @code{GRANT} only supports host, table, database and For the moment, @code{GRANT} only supports host, table, database, and
column names up to 60 characters long. A user name can be up to 16 column names up to 60 characters long. A user name can be up to 16
characters. characters.
...@@ -21104,7 +21104,7 @@ The privileges for a table or column are formed from the ...@@ -21104,7 +21104,7 @@ The privileges for a table or column are formed from the
logical OR of the privileges at each of the four privilege logical OR of the privileges at each of the four privilege
levels. For example, if the @code{mysql.user} table specifies that a levels. For example, if the @code{mysql.user} table specifies that a
user has a global @strong{select} privilege, this can't be denied by an user has a global @strong{select} privilege, this can't be denied by an
entry at the database, table or column level. entry at the database, table, or column level.
The privileges for a column can be calculated as follows: The privileges for a column can be calculated as follows:
...@@ -21116,7 +21116,7 @@ OR column privileges ...@@ -21116,7 +21116,7 @@ OR column privileges
@end example @end example
In most cases, you grant rights to a user at only one of the privilege In most cases, you grant rights to a user at only one of the privilege
levels, so life isn't normally as complicated as above. :) The details of the levels, so life isn't normally as complicated as above. The details of the
privilege-checking procedure are presented in privilege-checking procedure are presented in
@ref{Privilege system}. @ref{Privilege system}.
...@@ -21127,13 +21127,13 @@ create @code{user} table entries, but @code{REVOKE} will not remove them; ...@@ -21127,13 +21127,13 @@ create @code{user} table entries, but @code{REVOKE} will not remove them;
you must do that explicitly using @code{DELETE}. you must do that explicitly using @code{DELETE}.
@cindex passwords, setting @cindex passwords, setting
In @strong{MySQL} 3.22.12 or later, In @strong{MySQL} Version 3.22.12 or later,
if a new user is created or if you have global grant privileges, the user's if a new user is created or if you have global grant privileges, the user's
password will be set to the password specified by the @code{IDENTIFIED BY} password will be set to the password specified by the @code{IDENTIFIED BY}
clause, if one is given. If the user already had a password, it is replaced clause, if one is given. If the user already had a password, it is replaced
by the new one. by the new one.
@strong{Warning:} If you create a new user but do not specify an @strong{WARNING:} If you create a new user but do not specify an
@code{IDENTIFIED BY} clause, the user has no password. This is insecure. @code{IDENTIFIED BY} clause, the user has no password. This is insecure.
Passwords can also be set with the @code{SET PASSWORD} command. Passwords can also be set with the @code{SET PASSWORD} command.
...@@ -21175,7 +21175,7 @@ server examines table and column privileges for all users and this will slow ...@@ -21175,7 +21175,7 @@ server examines table and column privileges for all users and this will slow
down @strong{MySQL} a bit. down @strong{MySQL} a bit.
When @code{mysqld} starts, all privileges are read into memory. When @code{mysqld} starts, all privileges are read into memory.
Database, table and column privileges take effect at once and Database, table, and column privileges take effect at once, and
user-level privileges take effect the next time the user connects. user-level privileges take effect the next time the user connects.
Modifications to the grant tables that you perform using @code{GRANT} or Modifications to the grant tables that you perform using @code{GRANT} or
@code{REVOKE} are noticed by the server immediately. @code{REVOKE} are noticed by the server immediately.
...@@ -21195,7 +21195,7 @@ In @strong{MySQL} privileges are given for an username + hostname combination ...@@ -21195,7 +21195,7 @@ In @strong{MySQL} privileges are given for an username + hostname combination
and not only for an username. and not only for an username.
@item @item
ANSI SQL doesn't have global or database-level privileges and ANSI SQL ANSI SQL doesn't have global or database-level privileges, and ANSI SQL
doesn't support all privilege types that @strong{MySQL} supports. doesn't support all privilege types that @strong{MySQL} supports.
@strong{MySQL} doesn't support the ANSI SQL @code{TRIGGER}, @code{EXECUTE} or @strong{MySQL} doesn't support the ANSI SQL @code{TRIGGER}, @code{EXECUTE} or
@code{UNDER} privileges. @code{UNDER} privileges.
...@@ -21226,7 +21226,7 @@ dropped only with explicit @code{REVOKE} commands or by manipulating the ...@@ -21226,7 +21226,7 @@ dropped only with explicit @code{REVOKE} commands or by manipulating the
@cindex multi-part index @cindex multi-part index
@findex CREATE INDEX @findex CREATE INDEX
@node CREATE INDEX, DROP INDEX, GRANT, Reference @node CREATE INDEX, DROP INDEX, GRANT, Reference
@section @code{CREATE INDEX} syntax @section @code{CREATE INDEX} Syntax
@example @example
CREATE [UNIQUE|FULLTEXT] INDEX index_name ON tbl_name (col_name[(length)],... ) CREATE [UNIQUE|FULLTEXT] INDEX index_name ON tbl_name (col_name[(length)],... )
...@@ -21277,7 +21277,7 @@ are available in @strong{MySQL} Version 3.23.23 and later. ...@@ -21277,7 +21277,7 @@ are available in @strong{MySQL} Version 3.23.23 and later.
@findex DROP INDEX @findex DROP INDEX
@node DROP INDEX, Comments, CREATE INDEX, Reference @node DROP INDEX, Comments, CREATE INDEX, Reference
@section @code{DROP INDEX} syntax @section @code{DROP INDEX} Syntax
@example @example
DROP INDEX index_name ON tbl_name DROP INDEX index_name ON tbl_name
...@@ -21344,7 +21344,7 @@ input from that file with @code{mysql < some-file}. ...@@ -21344,7 +21344,7 @@ input from that file with @code{mysql < some-file}.
@findex User-defined functions @findex User-defined functions
@findex Functions, user-defined @findex Functions, user-defined
@node CREATE FUNCTION, Reserved words, Comments, Reference @node CREATE FUNCTION, Reserved words, Comments, Reference
@section @code{CREATE FUNCTION/DROP FUNCTION} syntax @section @code{CREATE FUNCTION/DROP FUNCTION} Syntax
@example @example
CREATE [AGGREGATE] FUNCTION function_name RETURNS @{STRING|REAL|INTEGER@} CREATE [AGGREGATE] FUNCTION function_name RETURNS @{STRING|REAL|INTEGER@}
...@@ -21687,7 +21687,7 @@ count variable for the table is not 0 and you are running with ...@@ -21687,7 +21687,7 @@ count variable for the table is not 0 and you are running with
The table is checked for errors. The table is checked for errors.
@item @item
If we found an error, try to do a fast repair (with sorting and without If we found an error, try to do a fast repair (with sorting and without
recreating the data file) of the table. re-creating the data file) of the table.
@item @item
If the repair fails because of an error in the data file (for example a If the repair fails because of an error in the data file (for example a
duplicate key error), we try again, but this time we recreate the data file. duplicate key error), we try again, but this time we recreate the data file.
...@@ -21776,7 +21776,7 @@ Also when scanning a table it is very easy to read a constant number of ...@@ -21776,7 +21776,7 @@ Also when scanning a table it is very easy to read a constant number of
records with each disk read. records with each disk read.
The security comes from if your computer crashes when writing to a The security comes from if your computer crashes when writing to a
fixed size MyISAM file, @code{myisamchk} can easily figure out where each fixed-size MyISAM file, @code{myisamchk} can easily figure out where each
row starts and ends. So it can usually reclaim all records except the row starts and ends. So it can usually reclaim all records except the
partially written one. Note that in @strong{MySQL} all indexes can always be partially written one. Note that in @strong{MySQL} all indexes can always be
reconstructed. reconstructed.
...@@ -22375,7 +22375,7 @@ To connect to the server, you'll usually need to provide a @strong{MySQL} ...@@ -22375,7 +22375,7 @@ To connect to the server, you'll usually need to provide a @strong{MySQL}
user name when you invoke @code{mysql} and, most likely, a password. If the user name when you invoke @code{mysql} and, most likely, a password. If the
server runs on a machine other than the one where you log in, you'll also server runs on a machine other than the one where you log in, you'll also
need to specify a hostname. Contact your administrator to find out what need to specify a hostname. Contact your administrator to find out what
connection parameters you should use to connect (i.e., what host, user name connection parameters you should use to connect (that is, what host, user name
and password to use). Once you know the proper parameters, you should be and password to use). Once you know the proper parameters, you should be
able to connect like this: able to connect like this:
...@@ -22656,7 +22656,7 @@ cancel the current command. ...@@ -22656,7 +22656,7 @@ cancel the current command.
@node Examples, Searching on two keys, Entering queries, Tutorial @node Examples, Searching on two keys, Entering queries, Tutorial
@section Examples of common queries @section Examples of common queries
Here follows examples of how to solve some common problems with Here are examples of how to solve some common problems with
@strong{MySQL}. @strong{MySQL}.
Some of the examples use the table @code{shop} to hold the price of each Some of the examples use the table @code{shop} to hold the price of each
...@@ -24843,8 +24843,8 @@ value + 1. This is an old legacy to be able to handle EOF.) ...@@ -24843,8 +24843,8 @@ value + 1. This is an old legacy to be able to handle EOF.)
You can find the following bitmask definitions in @file{m_ctype.h}: You can find the following bitmask definitions in @file{m_ctype.h}:
@example @example
#define _U 01 /* Upper case */ #define _U 01 /* Uppercase */
#define _L 02 /* Lower case */ #define _L 02 /* Lowercase */
#define _N 04 /* Numeral (digit) */ #define _N 04 /* Numeral (digit) */
#define _S 010 /* Spacing character */ #define _S 010 /* Spacing character */
#define _P 020 /* Punctuation */ #define _P 020 /* Punctuation */
...@@ -24915,7 +24915,7 @@ the size in bytes of the largest character in the set. ...@@ -24915,7 +24915,7 @@ the size in bytes of the largest character in the set.
@node Table size, , Languages, Server @node Table size, , Languages, Server
@section How big MySQL tables can be @section How big MySQL tables can be
@strong{MySQL} 3.22 has a 4G limit on table size. With the new @strong{MySQL} Version 3.22 has a 4G limit on table size. With the new
@code{MyISAM} in @strong{MySQL} Version 3.23 the maximum table size is @code{MyISAM} in @strong{MySQL} Version 3.23 the maximum table size is
pushed up to 8 million terabytes (2 ^ 63 bytes). pushed up to 8 million terabytes (2 ^ 63 bytes).
...@@ -26247,7 +26247,7 @@ automatically changing the in-memory (HEAP) table to a disk-based ...@@ -26247,7 +26247,7 @@ automatically changing the in-memory (HEAP) table to a disk-based
increase the temporary table size by setting the @code{tmp_table_size} increase the temporary table size by setting the @code{tmp_table_size}
option to @code{mysqld}, or by setting the SQL option option to @code{mysqld}, or by setting the SQL option
@code{SQL_BIG_TABLES} in the client program. @xref{SET OPTION, , @code{SQL_BIG_TABLES} in the client program. @xref{SET OPTION, ,
@code{SET OPTION}}. In @strong{MySQL} 3.20, the maximum size of the @code{SET OPTION}}. In @strong{MySQL} Version 3.20, the maximum size of the
temporary table was @code{record_buffer*16}, so if you are using this temporary table was @code{record_buffer*16}, so if you are using this
version, you have to increase the value of @code{record_buffer}. You can version, you have to increase the value of @code{record_buffer}. You can
also start @code{mysqld} with the @code{--big-tables} option to always also start @code{mysqld} with the @code{--big-tables} option to always
...@@ -28489,7 +28489,7 @@ Verbose mode. Print out more information what the program does. ...@@ -28489,7 +28489,7 @@ Verbose mode. Print out more information what the program does.
Print version information and exit. Print version information and exit.
@end table @end table
Here follows a sample run of using @code{mysqlimport}: Here is a sample run of using @code{mysqlimport}:
@example @example
$ mysql --version $ mysql --version
...@@ -29164,7 +29164,7 @@ The following options are used if you start @code{myisamchk} with ...@@ -29164,7 +29164,7 @@ The following options are used if you start @code{myisamchk} with
@table @code @table @code
@item -D # or --data-file-length=# @item -D # or --data-file-length=#
Max length of data file (when recreating data file when it's 'full') Max length of data file (when re-creating data file when it's 'full')
@item -e or --extend-check @item -e or --extend-check
Try to recover every possible row from the data file. Try to recover every possible row from the data file.
Normally this will also find a lot of garbage rows; Don't use this option Normally this will also find a lot of garbage rows; Don't use this option
...@@ -29647,7 +29647,7 @@ What percentage of the data file is used. ...@@ -29647,7 +29647,7 @@ What percentage of the data file is used.
What percentage of the data file is unused. What percentage of the data file is unused.
@item Blocks/Record @item Blocks/Record
Average number of blocks per record (i.e., how many links a fragmented Average number of blocks per record (that is, how many links a fragmented
record is composed of). This is always 1 for fixed-format tables. This value record is composed of). This is always 1 for fixed-format tables. This value
should stay as close to 1.0 as possible. If it gets too big, you can should stay as close to 1.0 as possible. If it gets too big, you can
reorganize the table with @code{myisamchk}. reorganize the table with @code{myisamchk}.
...@@ -30003,7 +30003,7 @@ start from @code{cron} to handle log files. ...@@ -30003,7 +30003,7 @@ start from @code{cron} to handle log files.
You can force @strong{MySQL} to start using new log files by using You can force @strong{MySQL} to start using new log files by using
@code{mysqladmin flush-logs} or by using the SQL command @code{FLUSH LOGS}. @code{mysqladmin flush-logs} or by using the SQL command @code{FLUSH LOGS}.
If you are using @strong{MySQL} 3.21 you must use @code{mysqladmin refresh}. If you are using @strong{MySQL} Version 3.21 you must use @code{mysqladmin refresh}.
The above command does the following: The above command does the following:
...@@ -30385,7 +30385,7 @@ parameter to @code{1}: ...@@ -30385,7 +30385,7 @@ parameter to @code{1}:
If @code{xxx()} sets @code{*error} to @code{1} for any row, the function If @code{xxx()} sets @code{*error} to @code{1} for any row, the function
value is @code{NULL} for the current row and for any subsequent rows value is @code{NULL} for the current row and for any subsequent rows
processed by the statement in which @code{XXX()} was invoked. (@code{xxx()} processed by the statement in which @code{XXX()} was invoked. (@code{xxx()}
will not even be called for subsequent rows.) @strong{Note:} In will not even be called for subsequent rows.) @strong{NOTE:} In
@strong{MySQL} versions prior to 3.22.10, you should set both @code{*error} @strong{MySQL} versions prior to 3.22.10, you should set both @code{*error}
and @code{*is_null}: and @code{*is_null}:
...@@ -30814,7 +30814,7 @@ aren't specified. Another way to around this bug is to upgrade to ...@@ -30814,7 +30814,7 @@ aren't specified. Another way to around this bug is to upgrade to
MyODBC Version 2.50.33 and @strong{MySQL} Version 3.23.x, which together provides a MyODBC Version 2.50.33 and @strong{MySQL} Version 3.23.x, which together provides a
workaround for this bug! workaround for this bug!
Note that if you are using @strong{MySQL} 3.22, you must to apply the Note that if you are using @strong{MySQL} Version 3.22, you must to apply the
MDAC patch and use MyODBC 2.50.32 or 2.50.34 and above to go around MDAC patch and use MyODBC 2.50.32 or 2.50.34 and above to go around
this problem. this problem.
@item @item
...@@ -31189,7 +31189,7 @@ If you have one of the following symptoms, then it is probably a hardware ...@@ -31189,7 +31189,7 @@ If you have one of the following symptoms, then it is probably a hardware
The keyboard doesn't work. This can normally be checked by pressing The keyboard doesn't work. This can normally be checked by pressing
Caps Lock; If the Caps Lock light doesn't change you have to replace Caps Lock; If the Caps Lock light doesn't change you have to replace
your keyboard. (Before doing this, you should however try to reboot your keyboard. (Before doing this, you should however try to reboot
your computer and check all cables to the keyboard :) your computer and check all cables to the keyboard.)
@item @item
The mouse pointer doesn't move. The mouse pointer doesn't move.
@item @item
...@@ -31480,7 +31480,7 @@ an error that is related to your particular system libraries). ...@@ -31480,7 +31480,7 @@ an error that is related to your particular system libraries).
If you have a problem with table with dynamic length rows and you are If you have a problem with table with dynamic length rows and you are
not using @code{BLOB/TEXT} columns (but only @code{VARCHAR} columns) you not using @code{BLOB/TEXT} columns (but only @code{VARCHAR} columns) you
can try to change all @code{VARCHAR} to @code{CHAR} with @code{ALTER can try to change all @code{VARCHAR} to @code{CHAR} with @code{ALTER
TABLE}. This will force @strong{MySQL} to use fixed size rows. Fixed TABLE}. This will force @strong{MySQL} to use fixed-size rows. Fixed
size rows take a little extra space, but are much more tolerant to size rows take a little extra space, but are much more tolerant to
corruption! corruption!
...@@ -31656,7 +31656,7 @@ shell> mysqladmin --socket=/tmp/mysql.sock version ...@@ -31656,7 +31656,7 @@ shell> mysqladmin --socket=/tmp/mysql.sock version
@end example @end example
Note the use of backquotes rather than forward quotes with the @code{hostname} Note the use of backquotes rather than forward quotes with the @code{hostname}
command; these cause the output of @code{hostname} (i.e., the current command; these cause the output of @code{hostname} (that is, the current
hostname) to be substituted into the @code{mysqladmin} command. hostname) to be substituted into the @code{mysqladmin} command.
Here are some reasons the @code{Can't connect to local MySQL server} Here are some reasons the @code{Can't connect to local MySQL server}
...@@ -31866,7 +31866,7 @@ You can also start @code{mysqld} with the @code{--big-tables} option. ...@@ -31866,7 +31866,7 @@ You can also start @code{mysqld} with the @code{--big-tables} option.
This is exactly the same as using @code{SQL_BIG_TABLES} for all queries. This is exactly the same as using @code{SQL_BIG_TABLES} for all queries.
In @strong{MySQL} Version 3.23 in-memory temporary tables will automatically be In @strong{MySQL} Version 3.23 in-memory temporary tables will automatically be
converted to a disk based @code{MyISAM} table after the table size gets converted to a disk-based @code{MyISAM} table after the table size gets
bigger than @code{tmp_table_size}. bigger than @code{tmp_table_size}.
@cindex can't create/write to file @cindex can't create/write to file
...@@ -32115,7 +32115,7 @@ you. ...@@ -32115,7 +32115,7 @@ you.
@item @item
Start the server as user @code{user_name}, or, if you are using Start the server as user @code{user_name}, or, if you are using
@strong{MySQL} 3.22 or later, start @code{mysqld} as the Unix @code{root} @strong{MySQL} Version 3.22 or later, start @code{mysqld} as the Unix @code{root}
user and use the @code{--user=user_name} option. @code{mysqld} will switch user and use the @code{--user=user_name} option. @code{mysqld} will switch
to run as Unix user @code{user_name} before accepting any connections. to run as Unix user @code{user_name} before accepting any connections.
...@@ -32782,7 +32782,7 @@ extension, @code{mysqld} will create log file names of type ...@@ -32782,7 +32782,7 @@ extension, @code{mysqld} will create log file names of type
time you execute @code{mysqladmin refresh} or @code{mysqladmin time you execute @code{mysqladmin refresh} or @code{mysqladmin
flush-logs}, the @code{FLUSH LOGS} statement, or restart the server. flush-logs}, the @code{FLUSH LOGS} statement, or restart the server.
@strong{Note:} For the above scheme to work, you should NOT create @strong{NOTE:} For the above scheme to work, you should NOT create
own files with the same file name as the update log + some extensions own files with the same file name as the update log + some extensions
that may be regarded as a number, in the directory used by the update log! that may be regarded as a number, in the directory used by the update log!
...@@ -32958,7 +32958,7 @@ files to @code{safe_mysqld} with @code{--log}, @code{--log-update} or ...@@ -32958,7 +32958,7 @@ files to @code{safe_mysqld} with @code{--log}, @code{--log-update} or
@code{--log-slow-queries}. Otherwise, both servers may be trying to @code{--log-slow-queries}. Otherwise, both servers may be trying to
write to the same log file. write to the same log file.
@strong{Warning}: Normally you should never have two servers that update @strong{WARNING}: Normally you should never have two servers that update
data in the same database! If your OS doesn't support fault-free system data in the same database! If your OS doesn't support fault-free system
locking, this may lead to unpleasant surprises! locking, this may lead to unpleasant surprises!
...@@ -34795,7 +34795,7 @@ or ...@@ -34795,7 +34795,7 @@ or
@code{unsigned int mysql_num_fields(MYSQL *mysql)} @code{unsigned int mysql_num_fields(MYSQL *mysql)}
The second form doesn't work on @strong{MySQL} 3.22.24 or newer. To pass a The second form doesn't work on @strong{MySQL} Version 3.22.24 or newer. To pass a
@code{MYSQL*} argument, you must use @code{MYSQL*} argument, you must use
@code{unsigned int mysql_field_count(MYSQL *mysql)} instead. @code{unsigned int mysql_field_count(MYSQL *mysql)} instead.
...@@ -35963,7 +35963,7 @@ Use compressed communication between the client and server (@strong{MySQL} ...@@ -35963,7 +35963,7 @@ Use compressed communication between the client and server (@strong{MySQL}
@item mysql_socket=/path/to/socket @item mysql_socket=/path/to/socket
Specify the pathname of the Unix socket that is used to connect Specify the pathname of the Unix socket that is used to connect
to the server (@strong{MySQL} 3.21.15 or later). to the server (@strong{MySQL} Version 3.21.15 or later).
@end table @end table
Multiple modifiers may be given; each must be preceded by a semicolon. Multiple modifiers may be given; each must be preceded by a semicolon.
...@@ -37091,7 +37091,7 @@ may sometimes produce bizarre results. ...@@ -37091,7 +37091,7 @@ may sometimes produce bizarre results.
For example search for the word "search" will produce no results in the For example search for the word "search" will produce no results in the
above example. Word "search" is present in more than half of rows, and above example. Word "search" is present in more than half of rows, and
as, such, is effectively treated as stopword (i.e. with semantical value as, such, is effectively treated as stopword (that is, with semantical value
zero). It is, really, the desired behaviour - natural language query zero). It is, really, the desired behaviour - natural language query
should not return every second row in 1GB table. should not return every second row in 1GB table.
...@@ -37106,7 +37106,7 @@ particular dataset}. ...@@ -37106,7 +37106,7 @@ particular dataset}.
@node Environment variables, Users, MySQL internals, Top @node Environment variables, Users, MySQL internals, Top
@appendix Environment variables @appendix Environment variables
Here follows a list of all environment variables that are used directly or Here is a list of all environment variables that are used directly or
indirectly by @strong{MySQL}. Most of these can also be found at other indirectly by @strong{MySQL}. Most of these can also be found at other
places in this manual. places in this manual.
...@@ -37779,7 +37779,7 @@ Fernandez Herrero. ...@@ -37779,7 +37779,7 @@ Fernandez Herrero.
@itemize @bullet @itemize @bullet
@item Graphical clients @item Graphical clients
@itemize @bullet @itemize @bullet
@item @uref{http://www.ideit.com/products/dbvis, DbVisualizer} @item @uref{http://www.ideit.com/products/dbvis: DbVisualizer}
Freeware JDBC client to graphically visualize the data and structure Freeware JDBC client to graphically visualize the data and structure
of several databases simultaneously. By Innovative-IT Development AB. of several databases simultaneously. By Innovative-IT Development AB.
...@@ -37945,7 +37945,7 @@ SQL/HTML is an HTML database manager for @strong{MySQL} using @code{DBI} 1.06. ...@@ -37945,7 +37945,7 @@ SQL/HTML is an HTML database manager for @strong{MySQL} using @code{DBI} 1.06.
@item @uref{http://www.mysql.com/Downloads/Contrib/udmsearch-3.0.21.tar.gz, UdmSearch 3.0.22 (stable version)} @item @uref{http://www.mysql.com/Downloads/Contrib/udmsearch-3.0.21.tar.gz, UdmSearch 3.0.22 (stable version)}
@item @uref{http://www.mysql.com/Downloads/Contrib/udmsearch-3.1.3.tar.gz, UdmSearch 3.1.3 (development version)} @item @uref{http://www.mysql.com/Downloads/Contrib/udmsearch-3.1.3.tar.gz, UdmSearch 3.1.3 (development version)}
@item @uref{http://search.mnoGo.ru, UdmSearch home page} @item @uref{http://search.mnoGo.ru, UdmSearch home page}
An SQL-based search engine for Internet. By A SQL-based search engine for Internet. By
Alexander I. Barkov @email{bar@@izhcom.ru}. Alexander I. Barkov @email{bar@@izhcom.ru}.
@item @uref{http://www.mysql.com/Downloads/Contrib/wmtcl.doc, wmtcl.doc} @item @uref{http://www.mysql.com/Downloads/Contrib/wmtcl.doc, wmtcl.doc}
...@@ -38091,7 +38091,7 @@ use Access for all DB design and administration, and synchronize with ...@@ -38091,7 +38091,7 @@ use Access for all DB design and administration, and synchronize with
your actual @strong{MySQL} server either way. Free of charge. See your actual @strong{MySQL} server either way. Free of charge. See
@uref{http://www.netdive.com/freebies/importsql/} for any updates. @uref{http://www.netdive.com/freebies/importsql/} for any updates.
Created by Laurent Bossavit of NetDIVE. Created by Laurent Bossavit of NetDIVE.
@strong{Note:} Doesn't work with Access2! @strong{NOTE:} Doesn't work with Access2!
@item @uref{http://www.mysql.com/Downloads/Contrib/msql2mysqlWrapper-1.0.tgz, /msql2mysqlWrapper 1.0} @item @uref{http://www.mysql.com/Downloads/Contrib/msql2mysqlWrapper-1.0.tgz, /msql2mysqlWrapper 1.0}
A C wrapper from @code{mSQL} to @strong{MySQL}. By @email{alfred@@sb.net} A C wrapper from @code{mSQL} to @strong{MySQL}. By @email{alfred@@sb.net}
...@@ -38269,13 +38269,13 @@ Developers that are or has been employed by MySQL AB to work on MySQL. ...@@ -38269,13 +38269,13 @@ Developers that are or has been employed by MySQL AB to work on MySQL.
Has written the following parts of @strong{MySQL}: Has written the following parts of @strong{MySQL}:
@itemize @bullet @itemize @bullet
@item @item
Most the main code in @code{mysqld}. All the main code in @code{mysqld}.
@item @item
New functions for the string library. New functions for the string library.
@item @item
Most of the @code{mysys} library. Most of the @code{mysys} library.
@item @item
The @code{ISAM},@code{MyISAM} and @code{MERGE} libraries (B-tree index file The @code{ISAM} and @code{MyISAM} libraries (B-tree index file
handlers with index compression and different record formats). handlers with index compression and different record formats).
@item @item
The @code{HEAP} library. A memory table system with our superior full dynamic The @code{HEAP} library. A memory table system with our superior full dynamic
...@@ -39009,7 +39009,7 @@ To make it possible to reliably dump and restore tables with ...@@ -39009,7 +39009,7 @@ To make it possible to reliably dump and restore tables with
@code{TIMESTAMP(X)} columns, @strong{MySQL} now reports columns with @code{X} @code{TIMESTAMP(X)} columns, @strong{MySQL} now reports columns with @code{X}
other than 14 or 8 to be strings. other than 14 or 8 to be strings.
@item @item
Changed sort order for latin1 as it was before @strong{MySQL} 3.23.23. Changed sort order for latin1 as it was before @strong{MySQL} Version 3.23.23.
Any table with @code{CHAR} columns that may have characters with ASCII Any table with @code{CHAR} columns that may have characters with ASCII
values greater than 128 that was created or modified with 3.23.22 must values greater than 128 that was created or modified with 3.23.22 must
be repaired! be repaired!
...@@ -39772,7 +39772,7 @@ Changed the argument to @code{mysql_data_seek()} from @code{ulong} to ...@@ -39772,7 +39772,7 @@ Changed the argument to @code{mysql_data_seek()} from @code{ulong} to
@itemize @bullet @itemize @bullet
@item @item
Added @code{mysqld} option @code{-O lower_case_table_names=@{0|1@}} to allow Added @code{mysqld} option @code{-O lower_case_table_names=@{0|1@}} to allow
users to force table names to lower case. users to force table names to lowercase.
@item @item
Added @code{SELECT ... INTO DUMPFILE}. Added @code{SELECT ... INTO DUMPFILE}.
@item @item
...@@ -40143,7 +40143,7 @@ Added aggregate UDF functions. Thanks to Andreas F. Bobak ...@@ -40143,7 +40143,7 @@ Added aggregate UDF functions. Thanks to Andreas F. Bobak
Some small changes to the join table optimizer to make some joins faster. Some small changes to the join table optimizer to make some joins faster.
@item @item
@code{SELECT DISTINCT} is much faster; It uses the new @code{UNIQUE} @code{SELECT DISTINCT} is much faster; It uses the new @code{UNIQUE}
functionality in @code{MyISAM}. One difference compared to @strong{MySQL} 3.22 functionality in @code{MyISAM}. One difference compared to @strong{MySQL} Version 3.22
is that the output of @code{DISTINCT} is not sorted anymore. is that the output of @code{DISTINCT} is not sorted anymore.
@item @item
All C client API macros are now functions to make shared libraries more All C client API macros are now functions to make shared libraries more
...@@ -40430,7 +40430,7 @@ Better support for SCO in @code{configure}. ...@@ -40430,7 +40430,7 @@ Better support for SCO in @code{configure}.
Added option @code{--defaults-file=###} to option file handling to force use Added option @code{--defaults-file=###} to option file handling to force use
of only one specific option file. of only one specific option file.
@item @item
Extended @code{CREATE} syntax to ignore @strong{MySQL} 3.23 keywords. Extended @code{CREATE} syntax to ignore @strong{MySQL} Version 3.23 keywords.
@item @item
Fixed deadlock problem when using @code{INSERT DELAYED} on a table locked with Fixed deadlock problem when using @code{INSERT DELAYED} on a table locked with
@code{LOCK TABLES}. @code{LOCK TABLES}.
...@@ -41104,7 +41104,7 @@ Added @code{DATE_ADD()} and @code{DATE_SUB()} functions. ...@@ -41104,7 +41104,7 @@ Added @code{DATE_ADD()} and @code{DATE_SUB()} functions.
@itemize @bullet @itemize @bullet
@item @item
Fixed a lock problem (bug in @strong{MySQL} 3.22.1) when closing temporary tables. Fixed a lock problem (bug in @strong{MySQL} Version 3.22.1) when closing temporary tables.
@item @item
Added missing @code{mysql_ping()} to the client library. Added missing @code{mysql_ping()} to the client library.
@item @item
...@@ -41152,7 +41152,7 @@ Server error messages are now in @file{mysqld_error.h}. ...@@ -41152,7 +41152,7 @@ Server error messages are now in @file{mysqld_error.h}.
@item @item
The server/client protocol now supports compression. The server/client protocol now supports compression.
@item @item
All bug fixes from @strong{MySQL} 3.21.32. All bug fixes from @strong{MySQL} Version 3.21.32.
@end itemize @end itemize
@node News-3.22.1, News-3.22.0, News-3.22.2, News-3.22.x @node News-3.22.1, News-3.22.0, News-3.22.2, News-3.22.x
...@@ -41183,7 +41183,7 @@ within a row in an existing table. ...@@ -41183,7 +41183,7 @@ within a row in an existing table.
the week starts on Monday (some European countries). By default, the week starts on Monday (some European countries). By default,
@code{WEEK()} assumes the week starts on Sunday. @code{WEEK()} assumes the week starts on Sunday.
@item @item
@code{TIME} columns weren't stored properly (bug in @strong{MySQL} 3.22.0). @code{TIME} columns weren't stored properly (bug in @strong{MySQL} Version 3.22.0).
@item @item
@code{UPDATE} now returns information about how many rows were @code{UPDATE} now returns information about how many rows were
matched and updated, and how many ``warnings'' occurred when doing the update. matched and updated, and how many ``warnings'' occurred when doing the update.
...@@ -41626,7 +41626,7 @@ Added command @code{variables} to @code{mysqladmin}. ...@@ -41626,7 +41626,7 @@ Added command @code{variables} to @code{mysqladmin}.
@item @item
A lot of small changes to the binary releases. A lot of small changes to the binary releases.
@item @item
Fixed a bug in the new protocol from @strong{MySQL} 3.21.20. Fixed a bug in the new protocol from @strong{MySQL} Version 3.21.20.
@item @item
Changed @code{ALTER TABLE} to work with Windows (Windows can't rename Changed @code{ALTER TABLE} to work with Windows (Windows can't rename
open files). Also fixed a couple of small bugs in the Windows version. open files). Also fixed a couple of small bugs in the Windows version.
...@@ -41924,7 +41924,7 @@ Sorting on calculated @code{DOUBLE} values sorted on integer results instead. ...@@ -41924,7 +41924,7 @@ Sorting on calculated @code{DOUBLE} values sorted on integer results instead.
@code{mysql} no longer needs a database argument. @code{mysql} no longer needs a database argument.
@item @item
Changed the place where @code{HAVING} should be. According to ANSI, it should Changed the place where @code{HAVING} should be. According to ANSI, it should
be after @code{GROUP BY} but before @code{ORDER BY}. @strong{MySQL} 3.20 be after @code{GROUP BY} but before @code{ORDER BY}. @strong{MySQL} Version 3.20
incorrectly had it last. incorrectly had it last.
@item @item
Added Sybase command @code{USE DATABASE} to start using another database. Added Sybase command @code{USE DATABASE} to start using another database.
...@@ -42008,7 +42008,7 @@ easily portable to Win95. ...@@ -42008,7 +42008,7 @@ easily portable to Win95.
Changed the @code{CREATE COLUMN} syntax of @code{NOT NULL} columns to be after Changed the @code{CREATE COLUMN} syntax of @code{NOT NULL} columns to be after
the @code{DEFAULT} value, as specified in the ANSI SQL standard. This will the @code{DEFAULT} value, as specified in the ANSI SQL standard. This will
make @code{mysqldump} with @code{NOT NULL} and default values incompatible with make @code{mysqldump} with @code{NOT NULL} and default values incompatible with
@strong{MySQL} 3.20. @strong{MySQL} Version 3.20.
@item @item
Added many function name aliases so the functions can be used with Added many function name aliases so the functions can be used with
ODBC or ANSI SQL92 syntax. ODBC or ANSI SQL92 syntax.
...@@ -42957,7 +42957,7 @@ New functions: @code{INSERT()}, @code{RTRIM()}, @code{LTRIM()} and ...@@ -42957,7 +42957,7 @@ New functions: @code{INSERT()}, @code{RTRIM()}, @code{LTRIM()} and
@code{AUTO_INCREMENT}). The format for @code{SHOW FIELDS FROM tbl_name} @code{AUTO_INCREMENT}). The format for @code{SHOW FIELDS FROM tbl_name}
is changed so the @code{Type} column contains information suitable for is changed so the @code{Type} column contains information suitable for
@code{CREATE TABLE}. In previous releases, some @code{CREATE TABLE} @code{CREATE TABLE}. In previous releases, some @code{CREATE TABLE}
information had to be patched when recreating tables. information had to be patched when re-creating tables.
@item @item
Some parser bugs from 3.19.5 (@code{BLOB} and @code{TIMESTAMP}) are corrected. Some parser bugs from 3.19.5 (@code{BLOB} and @code{TIMESTAMP}) are corrected.
@code{TIMESTAMP} now returns different date information depending on its @code{TIMESTAMP} now returns different date information depending on its
...@@ -43173,7 +43173,7 @@ Delayed insert handler has pending inserts to a table. ...@@ -43173,7 +43173,7 @@ Delayed insert handler has pending inserts to a table.
@end enumerate @end enumerate
@item @item
Before @strong{MySQL} 3.23.2 an @code{UPDATE} that updated a key with Before @strong{MySQL} Version 3.23.2 an @code{UPDATE} that updated a key with
a @code{WHERE} on the same key may have failed because the key was used to a @code{WHERE} on the same key may have failed because the key was used to
search for records and the same row may have been found multiple times: search for records and the same row may have been found multiple times:
...@@ -43190,7 +43190,7 @@ mysql> UPDATE tbl_name SET KEY=KEY+1 WHERE KEY+0 > 100; ...@@ -43190,7 +43190,7 @@ mysql> UPDATE tbl_name SET KEY=KEY+1 WHERE KEY+0 > 100;
This will work because @strong{MySQL} will not use index on expressions in This will work because @strong{MySQL} will not use index on expressions in
the @code{WHERE} clause. the @code{WHERE} clause.
@item @item
Before @strong{MySQL} 3.23, all numeric types where treated as fixed-point Before @strong{MySQL} Version 3.23, all numeric types where treated as fixed-point
fields. That means you had to specify how many decimals a floating-point fields. That means you had to specify how many decimals a floating-point
field shall have. All results were returned with the correct number of field shall have. All results were returned with the correct number of
decimals. decimals.
...@@ -43661,7 +43661,7 @@ If you run into problems with a new port, you may have to do some debugging ...@@ -43661,7 +43661,7 @@ If you run into problems with a new port, you may have to do some debugging
of @strong{MySQL}! of @strong{MySQL}!
@xref{Debugging server}. @xref{Debugging server}.
@strong{Note:} Before you start debugging @code{mysqld}, first get the test @strong{NOTE:} Before you start debugging @code{mysqld}, first get the test
programs @code{mysys/thr_alarm} and @code{mysys/thr_lock} to work. This programs @code{mysys/thr_alarm} and @code{mysys/thr_lock} to work. This
will ensure that your thread installation has even a remote chance to work! will ensure that your thread installation has even a remote chance to work!
...@@ -43778,7 +43778,7 @@ If you have problems debugging threads with gdb, you should download ...@@ -43778,7 +43778,7 @@ If you have problems debugging threads with gdb, you should download
gdb 5.x and try this instead. The new gdb version has very improved gdb 5.x and try this instead. The new gdb version has very improved
thread handling! thread handling!
Here follows an example how to debug mysqld: Here is an example how to debug mysqld:
@example @example
shell> gdb /usr/local/libexec/mysqld shell> gdb /usr/local/libexec/mysqld
...@@ -43962,7 +43962,7 @@ The currently recognized flag characters are: ...@@ -43962,7 +43962,7 @@ The currently recognized flag characters are:
@multitable @columnfractions .1 .9 @multitable @columnfractions .1 .9
@item d @tab Enable output from DBUG_<N> macros for for the current state. May be followed by a list of keywords which selects output only for the DBUG macros with that keyword. A empty list of keywords implies output for all macros. @item d @tab Enable output from DBUG_<N> macros for for the current state. May be followed by a list of keywords which selects output only for the DBUG macros with that keyword. A empty list of keywords implies output for all macros.
@item D @tab Delay after each debugger output line. The argument is the number of tenths of seconds to delay, subject to machine capabilities. I.E. @code{-#D,20} is delay two seconds. @item D @tab Delay after each debugger output line. The argument is the number of tenths of seconds to delay, subject to machine capabilities. That is, @code{-#D,20} is delay two seconds.
@item f @tab Limit debugging and/or tracing, and profiling to the list of named functions. Note that a null list will disable all functions. The appropriate "d" or "t" flags must still be given, this flag only limits their actions if they are enabled. @item f @tab Limit debugging and/or tracing, and profiling to the list of named functions. Note that a null list will disable all functions. The appropriate "d" or "t" flags must still be given, this flag only limits their actions if they are enabled.
@item F @tab Identify the source file name for each line of debug or trace output. @item F @tab Identify the source file name for each line of debug or trace output.
@item i @tab Identify the process with the pid or thread id for each line of debug or trace output. @item i @tab Identify the process with the pid or thread id for each line of debug or trace output.
...@@ -44079,7 +44079,7 @@ for the application but generally it's very hard to say that a given ...@@ -44079,7 +44079,7 @@ for the application but generally it's very hard to say that a given
lock type is better than another; Everything depends on the application lock type is better than another; Everything depends on the application
and different part of the application may require different lock types. and different part of the application may require different lock types.
Here follows some tips about locking in @strong{MySQL}: Here are some tips about locking in @strong{MySQL}:
On web application most applications do lots of selects, very few On web application most applications do lots of selects, very few
deletes, updates mainly on keys and inserts in some specific tables. deletes, updates mainly on keys and inserts in some specific tables.
...@@ -44153,7 +44153,7 @@ If there are some small differences in the implementation, they may be fixed ...@@ -44153,7 +44153,7 @@ If there are some small differences in the implementation, they may be fixed
by changing @file{my_pthread.h} and @file{my_pthread.c}. by changing @file{my_pthread.h} and @file{my_pthread.c}.
@item @item
Run @code{thr_alarm}. If it runs without any ``warning'', ``error'' or aborted Run @code{thr_alarm}. If it runs without any ``warning'', ``error'' or aborted
messages, you are on the right track. Here follows a successful run on messages, you are on the right track. Here is a successful run on
Solaris: Solaris:
@example @example
Main thread: 1 Main thread: 1
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment
GitLab Nexedi Edition | About GitLab | About Nexedi | 沪ICP备2021021310号-2 | 沪ICP备2021021310号-7