~drizzle-trunk/drizzle/development

« back to all changes in this revision

Viewing changes to docs/configuration/drizzled.rst

  • Committer: Daniel Nichter
  • Date: 2011-10-23 05:45:09 UTC
  • mto: This revision was merged to the branch mainline in revision 2448.
  • Revision ID: daniel@percona.com-20111023054509-5w1z0g4hn1c4guqv
A lot of doc changes: rewrite and expand Configuration and Administration, re-order top-level sections, enhance Contributing, add Release Notes, add Help and Support, fix title casing, label all plugins, other misc. enhancements.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.. program:: drizzled
2
2
 
 
3
.. _drizzled_configuration:
 
4
 
 
5
drizzled Configuration
 
6
======================
 
7
 
3
8
.. _drizzled_options:
4
9
 
5
 
drizzled Options
6
 
================
 
10
Options
 
11
-------
7
12
 
8
13
.. _drizzled_gneral_options:
9
14
 
10
15
General Options
11
 
---------------
 
16
^^^^^^^^^^^^^^^
 
17
 
 
18
.. option:: --help, -?
 
19
 
 
20
   Display this help and exit.
12
21
 
13
22
.. option:: --help-extended
14
23
 
15
24
   Display this help and exit after initializing plugins.
16
25
 
17
 
.. option:: --help, -?
18
 
 
19
 
   Display this help and exit.
20
 
 
21
26
.. _drizzled_config_file_options:
22
27
 
23
28
Config File Options
24
 
-------------------
 
29
^^^^^^^^^^^^^^^^^^^
 
30
 
 
31
.. option:: --config-dir DIR
 
32
 
 
33
   :Default: :file:`/etc/drizzle`
 
34
   :Variable: 
 
35
 
 
36
   Base location for config files.
 
37
 
 
38
.. option:: --defaults-file FILE
 
39
   
 
40
   :Default:
 
41
   :Variable: 
 
42
 
 
43
   Configuration file to use.
25
44
 
26
45
.. option:: --no-defaults
27
46
 
28
 
   Configuration file defaults are not used if no-defaults is set
29
 
 
30
 
.. option:: --defaults-file arg
31
 
 
32
 
   Configuration file to use
33
 
 
34
 
.. option:: --config-dir arg (=/etc/drizzle)
35
 
 
36
 
   Base location for config files
 
47
   :Default:
 
48
   :Variable: 
 
49
 
 
50
   Configuration file defaults are not used if no-defaults is set.
37
51
 
38
52
.. _drizzled_plugin_options:
39
53
 
40
54
Plugin Options
41
 
--------------
42
 
 
43
 
.. option:: --plugin-dir arg
44
 
 
45
 
   Directory for plugins
46
 
 
47
 
.. option:: --pid-file arg
48
 
 
49
 
   Pid file used by drizzled.
50
 
 
51
 
.. option:: --plugin-add arg
 
55
^^^^^^^^^^^^^^
 
56
 
 
57
.. option:: --plugin-add LIST
 
58
 
 
59
   :Default:
 
60
   :Variable: 
52
61
 
53
62
   Optional comma separated list of plugins to load at startup in addition
54
63
   to the default list of plugins.
57
66
 
58
67
     --plugin_add=crc32,console,pbxt
59
68
 
60
 
.. option:: --plugin-remove arg
 
69
.. option:: --plugin-dir DIR
 
70
 
 
71
   :Default:
 
72
   :Variable: 
 
73
 
 
74
   Directory for plugins.
 
75
 
 
76
.. option:: --plugin-load LIST
 
77
 
 
78
   :Default: See :ref:`default_plugins`
 
79
   :Variable: 
 
80
 
 
81
   Optional comma separated list of plugins to load at starup instead of 
 
82
   the default plugin load list. This completely replaces the whole list.
 
83
 
 
84
.. option:: --plugin-remove LIST
 
85
 
 
86
   :Default:
 
87
   :Variable: 
61
88
 
62
89
   Optional comma separated list of plugins to not load at startup.
63
90
   Effectively removes a plugin from the list of plugins to be loaded.
66
93
 
67
94
     --plugin_remove=syslog,md5
68
95
 
69
 
.. option:: --plugin-load arg (=version, uuid_function, user_function, transaction_log, syslog, substr_functions, sleep, show_schema_proto, rot13, reverse_function, rand_function, multi_thread, md5, logging_stats, length, hex_functions, hello_world, filtered_replicator, errmsg_stderr, default_replicator, database_function, crc32, connection_id, compression, charlength, benchmark, ascii)
70
 
 
71
 
   Optional comma separated list of plugins to load at starup instead of 
72
 
   the default plugin load list. This completely replaces the whole list.
73
 
 
74
96
.. _drizzled_kernel_options:
75
97
 
76
98
Kernel Options
77
 
--------------
78
 
 
79
 
.. option:: --auto-increment-increment arg (=1)
80
 
  
 
99
^^^^^^^^^^^^^^
 
100
 
 
101
.. option:: --auto-increment-increment ARG
 
102
 
 
103
   :Default: 1
 
104
   :Variable: ``auto_increment_increment``
 
105
 
81
106
   Auto-increment columns are incremented by this
82
107
 
83
 
.. option:: --auto-increment-offset arg (=1)
 
108
.. option:: --auto-increment-offset ARG
 
109
 
 
110
   :Default: 1
 
111
   :Variable: ``auto_increment_offset``
84
112
 
85
113
   Offset added to Auto-increment columns.
86
114
   Used when auto-increment-increment != 1
87
115
 
88
 
.. option:: --basedir, -b arg
 
116
.. option:: --back-log ARG
 
117
 
 
118
   :Default: 50
 
119
   :Variable: ``back_log``
 
120
 
 
121
   The number of outstanding connection requests Drizzle can have. This comes
 
122
   into play when the main Drizzle thread gets very many connection requests in
 
123
   a very short time.
 
124
 
 
125
.. option:: --basedir, -b ARG
 
126
 
 
127
   :Default:
 
128
   :Variable: ``basedir``
89
129
 
90
130
   Path to installation directory.
91
131
   All paths are usually resolved relative to this.
92
132
 
93
 
.. option:: --chroot, -r arg
 
133
.. option:: --bulk-insert-buffer-size SIZE
 
134
 
 
135
   :Default: 8388608
 
136
   :Variable: ``bulk_insert_buffer_size``
 
137
 
 
138
   Size of tree cache used in bulk insert optimization. Note that this is a
 
139
   limit per thread!
 
140
 
 
141
.. option:: --chroot, -r ARG
 
142
 
 
143
   :Default:
 
144
   :Variable: 
94
145
 
95
146
   Chroot drizzled daemon during startup.
96
147
 
97
 
.. option:: --collation-server arg
 
148
.. option:: --collation-server ARG
 
149
 
 
150
   :Default:
 
151
   :Variable: ``collation_server``
98
152
 
99
153
   Set the default collation.
100
154
 
101
 
.. option:: --completion-type arg (=0)
102
 
 
103
 
   Default completion type.
 
155
.. option:: --completion-type ARG
 
156
 
 
157
   :Default: 0
 
158
   :Variable: ``completion_type``
 
159
 
 
160
   Unknown.
104
161
 
105
162
.. option:: --core-file
106
163
 
 
164
   :Default:
 
165
   :Variable: 
 
166
 
107
167
   Write core on errors.
108
168
 
109
 
.. option:: --datadir arg
 
169
.. option:: --datadir ARG
 
170
 
 
171
   :Default:
 
172
   :Variable: ``datadir``
110
173
 
111
174
   Path to the database root.
112
175
 
113
 
.. option:: --default-storage-engine arg
 
176
.. option:: --default-storage-engine ARG
 
177
 
 
178
   :Default: InnoDB
 
179
   :Variable: ``storage_engine``
114
180
 
115
181
   Set the default storage engine for tables.
116
182
 
117
 
.. option:: --default-time-zone arg
 
183
.. option:: --default-time-zone ARG
 
184
 
 
185
   :Default:
 
186
   :Variable: 
118
187
 
119
188
   Set the default time zone.
120
189
 
 
190
.. option:: --disable-optimizer-prune
 
191
 
 
192
   :Default:
 
193
   :Variable: ``optimizer_prune_level``
 
194
 
 
195
   Do not apply any heuristic(s) during query optimization to prune, thus
 
196
   perform an exhaustive search from the optimizer search space.
 
197
 
 
198
.. option:: --div-precision-increment ARG
 
199
 
 
200
   :Default: 4
 
201
   :Variable: ``div_precision_increment``
 
202
  
 
203
   Precision of the result of '/' operator will be increased on that value.
 
204
 
121
205
.. We should really remove --exit-info as an option
122
 
.. option:: --exit-info, -T arg
 
206
.. option:: --exit-info, -T ARG
 
207
 
 
208
   :Default:
 
209
   :Variable: 
123
210
 
124
211
   Used for debugging;  Use at your own risk!
125
212
 
126
213
.. option:: --gdb
127
214
 
128
 
   Set up signals usable for debugging
129
 
 
130
 
.. option:: --lc-time-name arg
 
215
   :Default:
 
216
   :Variable: 
 
217
 
 
218
   Set up signals usable for debugging.
 
219
 
 
220
.. option:: --group-concat-max-len ARG
 
221
 
 
222
   :Default: 1024
 
223
   :Variable: ``group_concat_max_len``
 
224
 
 
225
   The maximum length of the result of function  group_concat.
 
226
 
 
227
.. option:: --join-buffer-constraint ARG
 
228
 
 
229
   :Default: 0
 
230
   :Variable: 
 
231
 
 
232
   A global constraint for join-buffer-size for all clients, cannot be set lower
 
233
   than :option:`--join-buffer-size`.  Setting to 0 means unlimited.
 
234
 
 
235
.. option:: --join-buffer-size SIZE
 
236
 
 
237
   :Default: 131072
 
238
   :Variable: ``join_buffer_size``
 
239
 
 
240
   The size of the buffer that is used for full joins.
 
241
 
 
242
.. option:: --lc-time-name ARG
 
243
 
 
244
   :Default:
 
245
   :Variable: ``lc_time_names``
131
246
 
132
247
   Set the language used for the month names and the days of the week.
133
248
 
134
 
.. option:: --log-warnings, -W arg
 
249
.. option:: --log-warnings, -W ARG
 
250
 
 
251
   :Default:
 
252
   :Variable: 
135
253
 
136
254
   Log some not critical warnings to the log file.
137
255
 
138
 
.. Why is this a core argument?
139
 
.. option:: --port-open-timeout arg (=0)
140
 
 
141
 
   Maximum time in seconds to wait for the port to become free.
142
 
   A value of 0 means not to wait.
143
 
 
144
 
.. option:: --secure-file-priv arg
145
 
 
146
 
   Limit LOAD DATA, SELECT ... OUTFILE, and LOAD_FILE() to files within
147
 
   specified directory
148
 
 
149
 
.. Why is this still here?
150
 
.. option:: --server-id arg (=0)
151
 
 
152
 
   Uniquely identifies the server instance in the community of replication
153
 
   partners.
154
 
 
155
 
.. option:: --skip-stack-trace
156
 
 
157
 
   Don't print a stack trace on failure.
158
 
 
159
 
.. option:: --symbolic-links, -s
160
 
 
161
 
   Enable symbolic link support.
162
 
 
163
 
.. option:: --timed-mutexes
164
 
 
165
 
   Specify whether to time mutexes (only InnoDB mutexes are currently supported)
166
 
 
167
 
.. option:: --tmpdir, -t arg
168
 
 
169
 
   Path for temporary files.
170
 
 
171
 
.. option:: --transaction-isolation arg
172
 
 
173
 
   Default transaction isolation level.
174
 
 
175
 
.. option:: --user, -u arg
176
 
 
177
 
   Run drizzled daemon as user.
178
 
  
179
 
.. option:: --version, -V
180
 
 
181
 
   Output version information and exit.
182
 
 
183
 
.. option:: --back-log arg (=50)
184
 
 
185
 
   The number of outstanding connection requests Drizzle can have. This comes
186
 
   into play when the main Drizzle thread gets very many connection requests in
187
 
   a very short time.
188
 
 
189
 
.. option:: --bulk-insert-buffer-size arg (=8388608)
190
 
  
191
 
   Size of tree cache used in bulk insert optimization. Note that this is a
192
 
   limit per thread!
193
 
 
194
 
.. option:: --div-precision-increment arg (=4)
195
 
  
196
 
   Precision of the result of '/' operator will be increased on that value.
197
 
 
198
 
.. option:: --group-concat-max-len arg (=1024)
199
 
 
200
 
   The maximum length of the result of function  group_concat.
201
 
 
202
 
.. option:: --join-buffer-size arg (=131072)
203
 
 
204
 
   The size of the buffer that is used for full joins.
205
 
 
206
 
.. option:: --join-buffer-constraint arg (=0)
207
 
 
208
 
   A global constraint for join-buffer-size for all clients, cannot be set lower
209
 
   than --join-buffer-size.  Setting to 0 means unlimited.
210
 
 
211
 
.. Why is this a core arg?
212
 
.. option:: --max-allowed-packet arg (=64M)
 
256
.. Why is this a core ARG?
 
257
.. option:: --max-allowed-packet SIZE
 
258
 
 
259
   :Default: 64M
 
260
   :Variable: ``max_allowed_packet``
213
261
 
214
262
   Max packetlength to send/receive from to server.
215
263
 
216
 
.. option:: --max-connect-errors arg (=10)
 
264
.. option:: --max-connect-errors ARG
 
265
 
 
266
   :Default: 10
 
267
   :Variable: 
217
268
 
218
269
   If there is more than this number of interrupted connections from a host 
219
270
   this host will be blocked from further connections.
220
271
 
221
 
.. option:: --max-error-count arg (=64)
 
272
.. option:: --max-error-count ARG
 
273
 
 
274
   :Default: 64
 
275
   :Variable: ``max_error_count``
222
276
 
223
277
   Max number of errors/warnings to store for a statement.
224
278
 
225
 
.. option:: --max-heap-table-size arg (=16M)
 
279
.. option:: --max-heap-table-size SIZE
 
280
 
 
281
   :Default: 16M
 
282
   :Variable: ``max_heap_table_size``
226
283
 
227
284
   Don't allow creation of heap tables bigger than this.
228
285
 
229
 
.. option:: --max-join-size arg (=2147483647)
 
286
.. option:: --max-join-size SIZE
 
287
 
 
288
   :Default: 2147483647
 
289
   :Variable: ``max_join_size``
230
290
 
231
291
   Joins that are probably going to read more than max_join_size records return 
232
292
   an error.
233
293
 
234
 
.. option:: --max-length-for-sort-data arg (=1024)
 
294
.. option:: --max-length-for-sort-data SIZE
 
295
 
 
296
   :Default: 1024
 
297
   :Variable: ``max_length_for_sort_data``
235
298
 
236
299
   Max number of bytes in sorted records.
237
 
  
238
 
.. option:: --max-seeks-for-key arg (=18446744073709551615)
239
 
 
240
 
   Limit assumed max number of seeks when looking up rows based on a key
241
 
 
242
 
.. option:: --max-sort-length arg (=1024)
 
300
 
 
301
.. option:: --max-seeks-for-key ARG
 
302
 
 
303
   :Default: -1
 
304
   :Variable: ``max_seeks_for_key``
 
305
 
 
306
   Limit assumed max number of seeks when looking up rows based on a key.
 
307
   Set to -1 to disable.
 
308
 
 
309
.. option:: --max-sort-length SIZE
 
310
 
 
311
   :Default: 1024
 
312
   :Variable: ``max_sort_length``
243
313
 
244
314
   The number of bytes to use when sorting BLOB or TEXT values (only the first 
245
315
   max_sort_length bytes of each value are used; the rest are ignored).
246
316
 
247
 
.. option:: --max-write-lock-count arg (=18446744073709551615)
 
317
.. option:: --max-write-lock-count ARG
 
318
 
 
319
   :Default: -1
 
320
   :Variable: ``max_write_lock_count``
248
321
 
249
322
   After this many write locks, allow some read locks to run in between.
250
 
 
251
 
.. option:: --min-examined-row-limit arg (=0)
 
323
   Set to -1 to disable.
 
324
 
 
325
.. option:: --min-examined-row-limit ARG
 
326
 
 
327
   :Default: 0
 
328
   :Variable: ``min_examined_row_limit``
252
329
 
253
330
   Don't log queries which examine less than min_examined_row_limit rows to
254
331
   file.
255
332
 
256
 
.. option:: --disable-optimizer-prune
257
 
 
258
 
   Do not apply any heuristic(s) during query optimization to prune, thus
259
 
   perform an exhaustive search from the optimizer search space.
260
 
 
261
 
.. option:: --optimizer-search-depth arg (=0)
 
333
.. option:: --optimizer-search-depth ARG
 
334
 
 
335
   :Default: 0
 
336
   :Variable: ``optimizer_search_depth``
262
337
 
263
338
   Maximum depth of search performed by the query optimizer. Values larger than
264
339
   the number of relations in a query result in better query plans, but take
268
343
   MAX_TABLES+2, the optimizer will switch to the original find_best (used for
269
344
   testing/comparison).
270
345
 
271
 
.. option:: --preload-buffer-size arg (=32768)
272
 
 
273
 
   The size of the buffer that is allocated when preloading indexes
274
 
 
275
 
.. option:: --query-alloc-block-size arg (=8192)
276
 
 
277
 
   Allocation block size for query parsing and execution
278
 
 
279
 
.. option:: --query-prealloc-size arg (=8192)
280
 
 
281
 
   Persistent buffer for query parsing and execution
282
 
 
283
 
.. option:: --range-alloc-block-size arg (=4096)
284
 
 
285
 
   Allocation block size for storing ranges during optimization
286
 
 
287
 
.. option:: --read-buffer-size arg (=131072)
 
346
.. option:: --pid-file FILE
 
347
   
 
348
   :Default:
 
349
   :Variable: ``pid_file``
 
350
 
 
351
   PID file used by :program:`drizzled`.
 
352
 
 
353
.. Why is this a core argument?
 
354
.. option:: --port-open-timeout ARG
 
355
 
 
356
   :Default: 0
 
357
   :Variable: 
 
358
 
 
359
   Maximum time in seconds to wait for the port to become free.
 
360
   A value of 0 means not to wait.
 
361
 
 
362
.. option:: --preload-buffer-size SIZE
 
363
 
 
364
   :Default: 32768
 
365
   :Variable: ``preload_buffer_size``
 
366
 
 
367
   The size of the buffer that is allocated when preloading indexes.
 
368
 
 
369
.. option:: --query-alloc-block-size SIZE
 
370
 
 
371
   :Default: 8192
 
372
   :Variable: ``query_alloc_block_size``
 
373
 
 
374
   Allocation block size for query parsing and execution.
 
375
 
 
376
.. option:: --query-prealloc-size SIZE
 
377
 
 
378
   :Default: 8192
 
379
   :Variable: ``query_prealloc_size``
 
380
 
 
381
   Persistent buffer for query parsing and execution.
 
382
 
 
383
.. option:: --range-alloc-block-size SIZE
 
384
 
 
385
   :Default: 4096
 
386
   :Variable: ``range_alloc_block_size``
 
387
 
 
388
   Allocation block size for storing ranges during optimization.
 
389
 
 
390
.. option:: --read-buffer-constraint ARG
 
391
 
 
392
   :Default: 0
 
393
   :Variable: 
 
394
 
 
395
   A global constraint for read-buffer-size for all clients, cannot be set lower
 
396
   than --read-buffer-size.  Setting to 0 means unlimited.
 
397
 
 
398
.. option:: --read-buffer-size SIZE
 
399
 
 
400
   :Default: 131072
 
401
   :Variable: ``read_buffer_size``
288
402
 
289
403
   Each thread that does a sequential scan allocates a buffer of this size for
290
404
   each table it scans. If you do many sequential scans, you may want to
291
405
   increase this value.  Note that this only affect MyISAM.
292
406
 
293
 
.. option:: --read-buffer-constraint arg (=0)
294
 
 
295
 
   A global constraint for read-buffer-size for all clients, cannot be set lower
296
 
   than --read-buffer-size.  Setting to 0 means unlimited.
297
 
 
298
 
.. option:: --read-rnd-buffer-size arg (=262144)
 
407
.. option:: --read-rnd-buffer-size SIZE
 
408
 
 
409
   :Default: 262144
 
410
   :Variable: ``read_rnd_buffer_size``
299
411
 
300
412
   When reading rows in sorted order after a sort, the rows are read through
301
413
   this buffer to avoid a disk seeks. If not set, then it's set to the value of
302
414
   record_buffer.
303
415
 
304
 
.. option:: --read-rnd-constraint arg (=0)
 
416
.. option:: --read-rnd-constraint ARG
 
417
 
 
418
   :Default: 0
 
419
   :Variable: 
305
420
 
306
421
   A global constraint for read-rnd-buffer-size for all clients, cannot be set
307
422
   lower than --read-rnd-buffer-size.  Setting to 0 means unlimited.
308
423
 
309
 
.. option:: --scheduler arg (=multi-thread)
 
424
.. option:: --replicate-query
 
425
 
 
426
   :Default:
 
427
   :Variable: ``replicate_query``
 
428
   
 
429
   Include the SQL query in replicated protobuf messages.
 
430
 
 
431
.. option:: --scheduler ARG
 
432
 
 
433
   :Default: multi-thread
 
434
   :Variable: ``scheduler``
310
435
 
311
436
   Select scheduler to be used.
312
437
 
313
 
.. option:: --sort-buffer-size arg (=2097144)
314
 
 
315
 
   Each thread that needs to do a sort allocates a buffer of this size.
316
 
 
317
 
.. option:: --sort-buffer-constraint arg (=0)
 
438
.. option:: --secure-file-priv ARG
 
439
 
 
440
   :Default:
 
441
   :Variable: ``secure_file_priv``
 
442
 
 
443
   Limit LOAD DATA, SELECT ... OUTFILE, and LOAD_FILE() to files within
 
444
   specified directory.
 
445
 
 
446
.. Why is this still here?
 
447
.. option:: --server-id ARG
 
448
 
 
449
   :Default: 0
 
450
   :Variable: ``server_id``
 
451
 
 
452
   Uniquely identifies the server instance in the community of replication
 
453
   partners.
 
454
 
 
455
.. option:: --skip-stack-trace
 
456
 
 
457
   :Default:
 
458
   :Variable: 
 
459
 
 
460
   Don't print a stack trace on failure.
 
461
 
 
462
.. option:: --sort-buffer-constraint ARG
 
463
 
 
464
   :Default: 0
 
465
   :Variable: 
318
466
 
319
467
   A global constraint for sort-buffer-size for all clients, cannot be set lower
320
468
   than --sort-buffer-size.  Setting to 0 means unlimited.
321
469
 
322
 
.. option:: --table-definition-cache arg (=128)
 
470
.. option:: --sort-buffer-size SIZE
 
471
   
 
472
   :Default: 2097144
 
473
   :Variable: ``sort_buffer_size``
 
474
 
 
475
   Each thread that needs to do a sort allocates a buffer of this size.
 
476
 
 
477
.. option:: --symbolic-links, -s
 
478
 
 
479
   :Default:
 
480
   :Variable: 
 
481
 
 
482
   Enable symbolic link support.
 
483
 
 
484
.. option:: --table-definition-cache ARG
 
485
 
 
486
   :Default: 128
 
487
   :Variable: ``table_definition_cache``
323
488
 
324
489
   The number of cached table definitions.
325
490
 
326
 
.. option:: --table-open-cache arg (=1024)
327
 
 
328
 
   The number of cached open tables.
329
 
 
330
 
.. option:: --table-lock-wait-timeout arg (=50)
 
491
.. option:: --table-lock-wait-timeout ARG
 
492
 
 
493
   :Default: 50
 
494
   :Variable: ``table_lock_wait_timeout``
331
495
 
332
496
   Timeout in seconds to wait for a table level lock before returning an error.
333
497
   Used only if the connection has active cursors.
334
498
 
335
 
.. option:: --thread-stack arg (=0)
 
499
.. option:: --table-open-cache ARG
 
500
 
 
501
   :Default: 1024
 
502
   :Variable: ``table_open_cache``
 
503
 
 
504
   The number of cached open tables.
 
505
 
 
506
.. option:: --thread-stack ARG
 
507
 
 
508
   :Default: 0
 
509
   :Variable: ``thread_stack``
336
510
 
337
511
   The stack size for each thread. 0 means use OS default.
338
512
 
339
 
.. option:: --tmp-table-size arg (=16M)
 
513
.. option:: --timed-mutexes
 
514
 
 
515
   :Default:
 
516
   :Variable: ``timed_mutexes``
 
517
 
 
518
   Specify whether to time mutexes (only InnoDB mutexes are currently supported).
 
519
 
 
520
.. option:: --tmp-table-size SIZE
 
521
 
 
522
   :Default: 16M
 
523
   :Variable: ``tmp_table_size``
340
524
 
341
525
   If an internal in-memory temporary table exceeds this size, Drizzle will
342
526
   automatically convert it to an on-disk MyISAM table.
343
527
 
 
528
.. option:: --tmpdir, -t DIR
 
529
 
 
530
   :Default:
 
531
   :Variable: ``tmpdir``
 
532
 
 
533
   Path for temporary files.
 
534
 
 
535
.. option:: --transaction-isolation ARG
 
536
 
 
537
   :Default: REPEATABLE-READ
 
538
   :Variable: ``tx_isolation``
 
539
 
 
540
   Default transaction isolation level.
 
541
 
 
542
.. option:: --transaction-message-threshold
 
543
 
 
544
   :Default: 1048576
 
545
   :Variable: ``transaction_message_threshold``
 
546
 
 
547
   Max message size written to transaction log, valid values 131072 - 1048576 bytes.
 
548
 
 
549
.. option:: --user, -u ARG
 
550
 
 
551
   :Default:
 
552
   :Variable: 
 
553
 
 
554
   Run drizzled daemon as user.
 
555
  
 
556
.. option:: --version, -V
 
557
 
 
558
   :Default:
 
559
   :Variable: ``version``
 
560
 
 
561
   Output version information and exit.
 
562
 
 
563
.. _drizzled_variables:
 
564
 
 
565
Variables
 
566
---------
 
567
 
 
568
.. _drizzled_auto_increment_increment:
 
569
 
 
570
* ``auto_increment_increment``
 
571
 
 
572
   :Scope: Global
 
573
   :Dynamic: No
 
574
   :Option: :option:`--auto-increment-increment`
 
575
 
 
576
.. _drizzled_auto_increment_offset:
 
577
 
 
578
* ``auto_increment_offset``
 
579
 
 
580
   :Scope: Global
 
581
   :Dynamic: No
 
582
   :Option: :option:`--auto-increment-offset`
 
583
 
 
584
.. _drizzled_autocommit:
 
585
 
 
586
* ``autocommit``
 
587
 
 
588
   :Scope: Global
 
589
   :Dynamic: No
 
590
   :Option: 
 
591
 
 
592
   If statements are auto-committed.
 
593
 
 
594
.. _drizzled_back_log:
 
595
 
 
596
* ``back_log``
 
597
 
 
598
   :Scope: Global
 
599
   :Dynamic: No
 
600
   :Option: :option:`--back-log`
 
601
 
 
602
.. _drizzled_basedir:
 
603
 
 
604
* ``basedir``
 
605
 
 
606
   :Scope: Global
 
607
   :Dynamic: No
 
608
   :Option: :option:`--basedir`
 
609
 
 
610
.. _drizzled_bulk_insert_buffer_size:
 
611
 
 
612
* ``bulk_insert_buffer_size``
 
613
 
 
614
   :Scope: Global
 
615
   :Dynamic: No
 
616
   :Option: :option:`--bulk-insert-buffer-size`
 
617
 
 
618
.. _drizzled_collation_server:
 
619
 
 
620
* ``collation_server``
 
621
 
 
622
   :Scope: Global
 
623
   :Dynamic: No
 
624
   :Option: :option:`--collation-server`
 
625
 
 
626
.. _drizzled_completion_type:
 
627
 
 
628
* ``completion_type``
 
629
 
 
630
   :Scope: Global
 
631
   :Dynamic: No
 
632
   :Option: :option:`--completion-type`
 
633
 
 
634
.. _drizzled_datadir:
 
635
 
 
636
* ``datadir``
 
637
 
 
638
   :Scope: Global
 
639
   :Dynamic: No
 
640
   :Option: :option:`--datadir`
 
641
 
 
642
.. _drizzled_div_precision_increment:
 
643
 
 
644
* ``div_precision_increment``
 
645
 
 
646
   :Scope: Global
 
647
   :Dynamic: No
 
648
   :Option: :option:`--div-precision-increment`
 
649
 
 
650
.. _drizzled_error_count:
 
651
 
 
652
* ``error_count``
 
653
 
 
654
   :Scope: Global
 
655
   :Dynamic: No
 
656
   :Option: 
 
657
 
 
658
   Error count.
 
659
 
 
660
.. _drizzled_foreign_key_checks:
 
661
 
 
662
* ``foreign_key_checks``
 
663
 
 
664
   :Scope: Global
 
665
   :Dynamic: No
 
666
   :Option: 
 
667
 
 
668
   If foreign key checks are enabled.
 
669
 
 
670
.. _drizzled_group_concat_max_len:
 
671
 
 
672
* ``group_concat_max_len``
 
673
 
 
674
   :Scope: Global
 
675
   :Dynamic: No
 
676
   :Option: :option:`--group-concat-max-len`
 
677
 
 
678
.. _drizzled_hostname:
 
679
 
 
680
* ``hostname``
 
681
 
 
682
   :Scope: Global
 
683
   :Dynamic: No
 
684
   :Option: 
 
685
 
 
686
   Hostname of the server.
 
687
 
 
688
.. _drizzled_identity:
 
689
 
 
690
* ``identity``
 
691
 
 
692
   :Scope: Global
 
693
   :Dynamic: No
 
694
   :Option: 
 
695
 
 
696
   Unknown.
 
697
 
 
698
.. _drizzled_join_buffer_size:
 
699
 
 
700
* ``join_buffer_size``
 
701
 
 
702
   :Scope: Global
 
703
   :Dynamic: No
 
704
   :Option: :option:`--join-buffer-size`
 
705
 
 
706
.. _drizzled_last_insert_id:
 
707
 
 
708
* ``last_insert_id``
 
709
 
 
710
   :Scope: Global
 
711
   :Dynamic: No
 
712
   :Option: 
 
713
 
 
714
   Last auto-increment insert ID value.
 
715
 
 
716
.. _drizzled_lc_time_names:
 
717
 
 
718
* ``lc_time_names``
 
719
 
 
720
   :Scope: Global
 
721
   :Dynamic: No
 
722
   :Option: 
 
723
 
 
724
   Unknown.
 
725
 
 
726
.. _drizzled_max_allowed_packet:
 
727
 
 
728
* ``max_allowed_packet``
 
729
 
 
730
   :Scope: Global
 
731
   :Dynamic: No
 
732
   :Option: :option:`--max-allowed-packet`
 
733
 
 
734
.. _drizzled_max_error_count:
 
735
 
 
736
* ``max_error_count``
 
737
 
 
738
   :Scope: Global
 
739
   :Dynamic: No
 
740
   :Option: :option:`--max-error-count`
 
741
 
 
742
.. _drizzled_max_heap_table_size:
 
743
 
 
744
* ``max_heap_table_size``
 
745
 
 
746
   :Scope: Global
 
747
   :Dynamic: No
 
748
   :Option: :option:`--max-heap-table-size`
 
749
 
 
750
.. _drizzled_max_join_size:
 
751
 
 
752
* ``max_join_size``
 
753
 
 
754
   :Scope: Global
 
755
   :Dynamic: No
 
756
   :Option: :option:`--max-join-size`
 
757
 
 
758
.. _drizzled_max_length_for_sort_data:
 
759
 
 
760
* ``max_length_for_sort_data``
 
761
 
 
762
   :Scope: Global
 
763
   :Dynamic: No
 
764
   :Option: :option:`--max-length-for-sort-data`
 
765
 
 
766
.. _drizzled_max_seeks_for_key:
 
767
 
 
768
* ``max_seeks_for_key``
 
769
 
 
770
   :Scope: Global
 
771
   :Dynamic: No
 
772
   :Option: :option:`--max-seeks-for-key`
 
773
 
 
774
.. _drizzled_max_sort_length:
 
775
 
 
776
* ``max_sort_length``
 
777
 
 
778
   :Scope: Global
 
779
   :Dynamic: No
 
780
   :Option: :option:`--max-sort-length`
 
781
 
 
782
.. _drizzled_max_write_lock_count:
 
783
 
 
784
* ``max_write_lock_count``
 
785
 
 
786
   :Scope: Global
 
787
   :Dynamic: No
 
788
   :Option: :option:`--max-write-lock-count`
 
789
 
 
790
.. _drizzled_min_examined_row_limit:
 
791
 
 
792
* ``min_examined_row_limit``
 
793
 
 
794
   :Scope: Global
 
795
   :Dynamic: No
 
796
   :Option: :option:`--min-examined-row-limit`
 
797
 
 
798
.. _drizzled_optimizer_prune_level:
 
799
 
 
800
* ``optimizer_prune_level``
 
801
 
 
802
   :Scope: Global
 
803
   :Dynamic: No
 
804
   :Option: :option:`--disable-optimizer-prune`
 
805
 
 
806
   Optimizer prune level.
 
807
 
 
808
.. _drizzled_optimizer_search_depth:
 
809
 
 
810
* ``optimizer_search_depth``
 
811
 
 
812
   :Scope: Global
 
813
   :Dynamic: No
 
814
   :Option: :option:`--optimizer-search-depth`
 
815
 
 
816
.. _drizzled_pid_file:
 
817
 
 
818
* ``pid_file``
 
819
 
 
820
   :Scope: Global
 
821
   :Dynamic: No
 
822
   :Option: :option:`--pid-file`
 
823
 
 
824
.. _drizzled_plugin_dir:
 
825
 
 
826
* ``plugin_dir``
 
827
 
 
828
   :Scope: Global
 
829
   :Dynamic: No
 
830
   :Option: :option:`--plugin-dir`
 
831
 
 
832
.. _drizzled_preload_buffer_size:
 
833
 
 
834
* ``preload_buffer_size``
 
835
 
 
836
   :Scope: Global
 
837
   :Dynamic: No
 
838
   :Option: :option:`--preload-buffer-size`
 
839
 
 
840
.. _drizzled_pseudo_thread_id:
 
841
 
 
842
* ``pseudo_thread_id``
 
843
 
 
844
   :Scope: Global
 
845
   :Dynamic: No
 
846
   :Option: 
 
847
 
 
848
   Unknown.
 
849
 
 
850
.. _drizzled_query_alloc_block_size:
 
851
 
 
852
* ``query_alloc_block_size``
 
853
 
 
854
   :Scope: Global
 
855
   :Dynamic: No
 
856
   :Option: :option:`--query-alloc-block-size`
 
857
 
 
858
.. _drizzled_query_prealloc_size:
 
859
 
 
860
* ``query_prealloc_size``
 
861
 
 
862
   :Scope: Global
 
863
   :Dynamic: No
 
864
   :Option: :option:`--query-prealloc-size`
 
865
 
 
866
.. _drizzled_range_alloc_block_size:
 
867
 
 
868
* ``range_alloc_block_size``
 
869
 
 
870
   :Scope: Global
 
871
   :Dynamic: No
 
872
   :Option: :option:`--range-alloc-block-size`
 
873
 
 
874
.. _drizzled_read_buffer_size:
 
875
 
 
876
* ``read_buffer_size``
 
877
 
 
878
   :Scope: Global
 
879
   :Dynamic: No
 
880
   :Option: :option:`--read-buffer-size`
 
881
 
 
882
.. _drizzled_read_rnd_buffer_size:
 
883
 
 
884
* ``read_rnd_buffer_size``
 
885
 
 
886
   :Scope: Global
 
887
   :Dynamic: No
 
888
   :Option: :option:`--read-rnd-buffer-size`
 
889
 
 
890
.. _drizzled_replicate_query:
 
891
 
 
892
* ``replicate_query``
 
893
 
 
894
   :Scope: Global
 
895
   :Dynamic: No
 
896
   :Option: :option:`--replicate-query`
 
897
 
 
898
.. _drizzled_scheduler:
 
899
 
 
900
* ``scheduler``
 
901
 
 
902
   :Scope: Global
 
903
   :Dynamic: No
 
904
   :Option: :option:`--scheduler`
 
905
 
 
906
.. _drizzled_secure_file_priv:
 
907
 
 
908
* ``secure_file_priv``
 
909
 
 
910
   :Scope: Global
 
911
   :Dynamic: No
 
912
   :Option: :option:`--secure-file-priv`
 
913
 
 
914
.. _drizzled_server_id:
 
915
 
 
916
* ``server_id``
 
917
 
 
918
   :Scope: Global
 
919
   :Dynamic: No
 
920
   :Option: :option:`--server-id`
 
921
 
 
922
.. _drizzled_server_uuid:
 
923
 
 
924
* ``server_uuid``
 
925
 
 
926
   :Scope: Global
 
927
   :Dynamic: No
 
928
   :Option: 
 
929
 
 
930
   Server UUID.
 
931
 
 
932
.. _drizzled_sort_buffer_size:
 
933
 
 
934
* ``sort_buffer_size``
 
935
 
 
936
   :Scope: Global
 
937
   :Dynamic: No
 
938
   :Option: :option:`--sort-buffer-size`
 
939
 
 
940
.. _drizzled_sql_big_selects:
 
941
 
 
942
* ``sql_big_selects``
 
943
 
 
944
   :Scope: Global
 
945
   :Dynamic: No
 
946
   :Option: 
 
947
 
 
948
   Unknown.
 
949
 
 
950
.. _drizzled_sql_buffer_result:
 
951
 
 
952
* ``sql_buffer_result``
 
953
 
 
954
   :Scope: Global
 
955
   :Dynamic: No
 
956
   :Option: 
 
957
 
 
958
   Unknown.
 
959
 
 
960
.. _drizzled_sql_notes:
 
961
 
 
962
* ``sql_notes``
 
963
 
 
964
   :Scope: Global
 
965
   :Dynamic: No
 
966
   :Option: 
 
967
 
 
968
   Unknown.
 
969
 
 
970
.. _drizzled_sql_select_limit:
 
971
 
 
972
* ``sql_select_limit``
 
973
 
 
974
   :Scope: Global
 
975
   :Dynamic: No
 
976
   :Option: 
 
977
 
 
978
   Unknown.
 
979
 
 
980
.. _drizzled_sql_warnings:
 
981
 
 
982
* ``sql_warnings``
 
983
 
 
984
   :Scope: Global
 
985
   :Dynamic: No
 
986
   :Option: 
 
987
 
 
988
   Unknown.
 
989
 
 
990
.. _drizzled_storage_engine:
 
991
 
 
992
* ``storage_engine``
 
993
 
 
994
   :Scope: Global
 
995
   :Dynamic: No
 
996
   :Option: :option:`--default-storage-engine`
 
997
 
 
998
.. _drizzled_table_definition_cache:
 
999
 
 
1000
* ``table_definition_cache``
 
1001
 
 
1002
   :Scope: Global
 
1003
   :Dynamic: No
 
1004
   :Option: :option:`--table-definition-cache`
 
1005
 
 
1006
.. _drizzled_table_lock_wait_timeout:
 
1007
 
 
1008
* ``table_lock_wait_timeout``
 
1009
 
 
1010
   :Scope: Global
 
1011
   :Dynamic: No
 
1012
   :Option: :option:`--table-lock-wait-timeout`
 
1013
 
 
1014
.. _drizzled_table_open_cache:
 
1015
 
 
1016
* ``table_open_cache``
 
1017
 
 
1018
   :Scope: Global
 
1019
   :Dynamic: No
 
1020
   :Option: :option:`--table-open-cache`
 
1021
 
 
1022
.. _drizzled_thread_stack:
 
1023
 
 
1024
* ``thread_stack``
 
1025
 
 
1026
   :Scope: Global
 
1027
   :Dynamic: No
 
1028
   :Option: :option:`--thread-stack`
 
1029
 
 
1030
.. _drizzled_timed_mutexes:
 
1031
 
 
1032
* ``timed_mutexes``
 
1033
 
 
1034
   :Scope: Global
 
1035
   :Dynamic: No
 
1036
   :Option: :option:`--timed-mutexes`
 
1037
 
 
1038
.. _drizzled_timestamp:
 
1039
 
 
1040
* ``timestamp``
 
1041
 
 
1042
   :Scope: Global
 
1043
   :Dynamic: No
 
1044
   :Option: 
 
1045
 
 
1046
   Current UNIX timestamp.
 
1047
 
 
1048
.. _drizzled_tmp_table_size:
 
1049
 
 
1050
* ``tmp_table_size``
 
1051
 
 
1052
   :Scope: Global
 
1053
   :Dynamic: No
 
1054
   :Option: :option:`--tmp-table-size`
 
1055
 
 
1056
.. _drizzled_tmpdir:
 
1057
 
 
1058
* ``tmpdir``
 
1059
 
 
1060
   :Scope: Global
 
1061
   :Dynamic: No
 
1062
   :Option: :option:`--tmpdir`
 
1063
 
 
1064
.. _drizzled_transaction_message_threshold:
 
1065
 
 
1066
* ``transaction_message_threshold``
 
1067
 
 
1068
   :Scope: Global
 
1069
   :Dynamic: No
 
1070
   :Option: :option:`--transaction-message-threshold`
 
1071
 
 
1072
.. _drizzled_tx_isolation:
 
1073
 
 
1074
* ``tx_isolation``
 
1075
 
 
1076
   :Scope: Global
 
1077
   :Dynamic: No
 
1078
   :Option: :option:`--transactions-isolation`
 
1079
 
 
1080
.. _drizzled_unique_checks:
 
1081
 
 
1082
* ``unique_checks``
 
1083
 
 
1084
   :Scope: Global
 
1085
   :Dynamic: No
 
1086
   :Option: 
 
1087
 
 
1088
   Check UNIQUE indexes for uniqueness.
 
1089
 
 
1090
.. _drizzled_vc_branch:
 
1091
 
 
1092
* ``vc_branch``
 
1093
 
 
1094
   :Scope: Global
 
1095
   :Dynamic: No
 
1096
   :Option: 
 
1097
 
 
1098
   Version control (Bazaar) branch.
 
1099
 
 
1100
.. _drizzled_vc_release_id:
 
1101
 
 
1102
* ``vc_release_id``
 
1103
 
 
1104
   :Scope: Global
 
1105
   :Dynamic: No
 
1106
   :Option: 
 
1107
 
 
1108
   Version control (Bazaar) release id.
 
1109
 
 
1110
.. _drizzled_vc_revid:
 
1111
 
 
1112
* ``vc_revid``
 
1113
 
 
1114
   :Scope: Global
 
1115
   :Dynamic: No
 
1116
   :Option: 
 
1117
 
 
1118
   Version control (Bazaar) revision id.
 
1119
 
 
1120
.. _drizzled_vc_revno:
 
1121
 
 
1122
* ``vc_revno``
 
1123
 
 
1124
   :Scope: Global
 
1125
   :Dynamic: No
 
1126
   :Option: 
 
1127
 
 
1128
   Version control (Bazaar) revision number.
 
1129
 
 
1130
.. _drizzled_version:
 
1131
 
 
1132
* ``version``
 
1133
 
 
1134
   :Scope: Global
 
1135
   :Dynamic: No
 
1136
   :Option: :option:`--version`
 
1137
 
 
1138
   Drizzle version.
 
1139
 
 
1140
.. _drizzled_version_comment:
 
1141
 
 
1142
* ``version_comment``
 
1143
 
 
1144
   :Scope: Global
 
1145
   :Dynamic: No
 
1146
   :Option: 
 
1147
 
 
1148
   Version comment.
 
1149
 
 
1150
.. _drizzled_version_compile_machine:
 
1151
 
 
1152
* ``version_compile_machine``
 
1153
 
 
1154
   :Scope: Global
 
1155
   :Dynamic: No
 
1156
   :Option: 
 
1157
 
 
1158
   Version compile for machine type.
 
1159
 
 
1160
.. _drizzled_version_compile_os:
 
1161
 
 
1162
* ``version_compile_os``
 
1163
 
 
1164
   :Scope: Global
 
1165
   :Dynamic: No
 
1166
   :Option: 
 
1167
 
 
1168
   Version compile for OS.
 
1169
 
 
1170
.. _drizzled_version_compile_vendor:
 
1171
 
 
1172
* ``version_compile_vendor``
 
1173
 
 
1174
   :Scope: Global
 
1175
   :Dynamic: No
 
1176
   :Option: 
 
1177
 
 
1178
   Version compile for OS vendor.
 
1179
 
 
1180
.. _drizzled_warning_count:
 
1181
 
 
1182
* ``warning_count``
 
1183
 
 
1184
   :Scope: Global
 
1185
   :Dynamic: No
 
1186
   :Option: 
 
1187
 
 
1188
   Unknown.