~olafvdspek/drizzle/outfile

« back to all changes in this revision

Viewing changes to docs/configuration/drizzled.rst

  • Committer: Olaf van der Spek
  • Date: 2011-11-09 10:10:15 UTC
  • mfrom: (2436.1.20 drizzle)
  • Revision ID: olafvdspek@gmail.com-20111109101015-io008ttxsv297emd
Merge trunk

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
.. _options:
2
 
 
3
 
Drizzled Options
4
 
================
5
 
 
6
 
There are many different options one can use to configure Drizzle.
7
 
 
8
 
Config File Options
9
 
-------------------
10
 
 
11
1
.. program:: drizzled
12
2
 
 
3
.. _drizzled_configuration:
 
4
 
 
5
drizzled Configuration
 
6
======================
 
7
 
 
8
.. _drizzled_options:
 
9
 
 
10
Options
 
11
-------
 
12
 
 
13
.. _drizzled_gneral_options:
 
14
 
 
15
General Options
 
16
^^^^^^^^^^^^^^^
 
17
 
 
18
.. option:: --help, -?
 
19
 
 
20
   Display this help and exit.
 
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.
 
26
.. _drizzled_config_file_options:
 
27
 
 
28
Config File Options
 
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.
20
44
 
21
45
.. option:: --no-defaults
22
46
 
23
 
   Configuration file defaults are not used if no-defaults is set
24
 
 
25
 
.. option:: --defaults-file arg
26
 
 
27
 
   Configuration file to use
28
 
 
29
 
.. option:: --config-dir arg (=/etc/drizzle)
30
 
 
31
 
   Base location for config files
32
 
 
33
 
.. option:: --plugin-dir arg
34
 
 
35
 
   Directory for plugins
36
 
 
37
 
.. option:: --pid-file arg
38
 
 
39
 
   Pid file used by drizzled.
40
 
 
41
 
Plugin Loading Options
42
 
----------------------
43
 
 
44
 
.. program:: drizzled
45
 
 
46
 
.. option:: --plugin-add arg
 
47
   :Default:
 
48
   :Variable: 
 
49
 
 
50
   Configuration file defaults are not used if no-defaults is set.
 
51
 
 
52
.. _drizzled_plugin_options:
 
53
 
 
54
Plugin Options
 
55
^^^^^^^^^^^^^^
 
56
 
 
57
.. option:: --plugin-add LIST
 
58
 
 
59
   :Default:
 
60
   :Variable: 
47
61
 
48
62
   Optional comma separated list of plugins to load at startup in addition
49
63
   to the default list of plugins.
52
66
 
53
67
     --plugin_add=crc32,console,pbxt
54
68
 
55
 
.. 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: 
56
88
 
57
89
   Optional comma separated list of plugins to not load at startup.
58
90
   Effectively removes a plugin from the list of plugins to be loaded.
61
93
 
62
94
     --plugin_remove=syslog,md5
63
95
 
64
 
.. 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)
65
 
 
66
 
   Optional comma separated list of plugins to load at starup instead of 
67
 
   the default plugin load list. This completely replaces the whole list.
 
96
.. _drizzled_kernel_options:
68
97
 
69
98
Kernel Options
70
 
--------------
71
 
 
72
 
.. program:: drizzled
73
 
 
74
 
.. option:: --auto-increment-increment arg (=1)
75
 
  
 
99
^^^^^^^^^^^^^^
 
100
 
 
101
.. option:: --auto-increment-increment ARG
 
102
 
 
103
   :Default: 1
 
104
   :Variable: ``auto_increment_increment``
 
105
 
76
106
   Auto-increment columns are incremented by this
77
107
 
78
 
.. option:: --auto-increment-offset arg (=1)
 
108
.. option:: --auto-increment-offset ARG
 
109
 
 
110
   :Default: 1
 
111
   :Variable: ``auto_increment_offset``
79
112
 
80
113
   Offset added to Auto-increment columns.
81
114
   Used when auto-increment-increment != 1
82
115
 
83
 
.. 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``
84
129
 
85
130
   Path to installation directory.
86
131
   All paths are usually resolved relative to this.
87
132
 
88
 
.. 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: 
89
145
 
90
146
   Chroot drizzled daemon during startup.
91
147
 
92
 
.. option:: --collation-server arg
 
148
.. option:: --collation-server ARG
 
149
 
 
150
   :Default:
 
151
   :Variable: ``collation_server``
93
152
 
94
153
   Set the default collation.
95
154
 
96
 
.. option:: --completion-type arg (=0)
97
 
 
98
 
   Default completion type.
 
155
.. option:: --completion-type ARG
 
156
 
 
157
   :Default: 0
 
158
   :Variable: ``completion_type``
 
159
 
 
160
   Unknown.
99
161
 
100
162
.. option:: --core-file
101
163
 
 
164
   :Default:
 
165
   :Variable: 
 
166
 
102
167
   Write core on errors.
103
168
 
104
 
.. option:: --datadir arg
 
169
.. option:: --datadir ARG
 
170
 
 
171
   :Default:
 
172
   :Variable: ``datadir``
105
173
 
106
174
   Path to the database root.
107
175
 
108
 
.. option:: --default-storage-engine arg
 
176
.. option:: --default-storage-engine ARG
 
177
 
 
178
   :Default: InnoDB
 
179
   :Variable: ``storage_engine``
109
180
 
110
181
   Set the default storage engine for tables.
111
182
 
112
 
.. option:: --default-time-zone arg
 
183
.. option:: --default-time-zone ARG
 
184
 
 
185
   :Default:
 
186
   :Variable: 
113
187
 
114
188
   Set the default time zone.
115
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
 
116
205
.. We should really remove --exit-info as an option
117
 
.. option:: --exit-info, -T arg
 
206
.. option:: --exit-info, -T ARG
 
207
 
 
208
   :Default:
 
209
   :Variable: 
118
210
 
119
211
   Used for debugging;  Use at your own risk!
120
212
 
121
213
.. option:: --gdb
122
214
 
123
 
   Set up signals usable for debugging
124
 
 
125
 
.. 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``
126
246
 
127
247
   Set the language used for the month names and the days of the week.
128
248
 
129
 
.. option:: --log-warnings, -W arg
 
249
.. option:: --log-warnings, -W ARG
 
250
 
 
251
   :Default:
 
252
   :Variable: 
130
253
 
131
254
   Log some not critical warnings to the log file.
132
255
 
133
 
.. Why is this a core argument?
134
 
.. option:: --port-open-timeout arg (=0)
135
 
 
136
 
   Maximum time in seconds to wait for the port to become free.
137
 
   A value of 0 means not to wait.
138
 
 
139
 
.. option:: --secure-file-priv arg
140
 
 
141
 
   Limit LOAD DATA, SELECT ... OUTFILE, and LOAD_FILE() to files within
142
 
   specified directory
143
 
 
144
 
.. Why is this still here?
145
 
.. option:: --server-id arg (=0)
146
 
 
147
 
   Uniquely identifies the server instance in the community of replication
148
 
   partners.
149
 
 
150
 
.. option:: --skip-stack-trace
151
 
 
152
 
   Don't print a stack trace on failure.
153
 
 
154
 
.. option:: --symbolic-links, -s
155
 
 
156
 
   Enable symbolic link support.
157
 
 
158
 
.. option:: --timed-mutexes
159
 
 
160
 
   Specify whether to time mutexes (only InnoDB mutexes are currently supported)
161
 
 
162
 
.. option:: --tmpdir, -t arg
163
 
 
164
 
   Path for temporary files.
165
 
 
166
 
.. option:: --transaction-isolation arg
167
 
 
168
 
   Default transaction isolation level.
169
 
 
170
 
.. option:: --user, -u arg
171
 
 
172
 
   Run drizzled daemon as user.
173
 
  
174
 
.. option:: --version, -V
175
 
 
176
 
   Output version information and exit.
177
 
 
178
 
.. option:: --back-log arg (=50)
179
 
 
180
 
   The number of outstanding connection requests Drizzle can have. This comes
181
 
   into play when the main Drizzle thread gets very many connection requests in
182
 
   a very short time.
183
 
 
184
 
.. option:: --bulk-insert-buffer-size arg (=8388608)
185
 
  
186
 
   Size of tree cache used in bulk insert optimization. Note that this is a
187
 
   limit per thread!
188
 
 
189
 
.. option:: --div-precision-increment arg (=4)
190
 
  
191
 
   Precision of the result of '/' operator will be increased on that value.
192
 
 
193
 
.. option:: --group-concat-max-len arg (=1024)
194
 
 
195
 
   The maximum length of the result of function  group_concat.
196
 
 
197
 
.. option:: --join-buffer-size arg (=131072)
198
 
 
199
 
   The size of the buffer that is used for full joins.
200
 
 
201
 
.. option:: --join-buffer-constraint arg (=0)
202
 
 
203
 
   A global constraint for join-buffer-size for all clients, cannot be set lower
204
 
   than --join-buffer-size.  Setting to 0 means unlimited.
205
 
 
206
 
.. Why is this a core arg?
207
 
.. 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``
208
261
 
209
262
   Max packetlength to send/receive from to server.
210
263
 
211
 
.. option:: --max-connect-errors arg (=10)
 
264
.. option:: --max-connect-errors ARG
 
265
 
 
266
   :Default: 10
 
267
   :Variable: 
212
268
 
213
269
   If there is more than this number of interrupted connections from a host 
214
270
   this host will be blocked from further connections.
215
271
 
216
 
.. option:: --max-error-count arg (=64)
 
272
.. option:: --max-error-count ARG
 
273
 
 
274
   :Default: 64
 
275
   :Variable: ``max_error_count``
217
276
 
218
277
   Max number of errors/warnings to store for a statement.
219
278
 
220
 
.. option:: --max-heap-table-size arg (=16M)
 
279
.. option:: --max-heap-table-size SIZE
 
280
 
 
281
   :Default: 16M
 
282
   :Variable: ``max_heap_table_size``
221
283
 
222
284
   Don't allow creation of heap tables bigger than this.
223
285
 
224
 
.. option:: --max-join-size arg (=2147483647)
 
286
.. option:: --max-join-size SIZE
 
287
 
 
288
   :Default: 2147483647
 
289
   :Variable: ``max_join_size``
225
290
 
226
291
   Joins that are probably going to read more than max_join_size records return 
227
292
   an error.
228
293
 
229
 
.. 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``
230
298
 
231
299
   Max number of bytes in sorted records.
232
 
  
233
 
.. option:: --max-seeks-for-key arg (=18446744073709551615)
234
 
 
235
 
   Limit assumed max number of seeks when looking up rows based on a key
236
 
 
237
 
.. 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``
238
313
 
239
314
   The number of bytes to use when sorting BLOB or TEXT values (only the first 
240
315
   max_sort_length bytes of each value are used; the rest are ignored).
241
316
 
242
 
.. option:: --max-write-lock-count arg (=18446744073709551615)
 
317
.. option:: --max-write-lock-count ARG
 
318
 
 
319
   :Default: -1
 
320
   :Variable: ``max_write_lock_count``
243
321
 
244
322
   After this many write locks, allow some read locks to run in between.
245
 
 
246
 
.. 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``
247
329
 
248
330
   Don't log queries which examine less than min_examined_row_limit rows to
249
331
   file.
250
332
 
251
 
.. option:: --disable-optimizer-prune
252
 
 
253
 
   Do not apply any heuristic(s) during query optimization to prune, thus
254
 
   perform an exhaustive search from the optimizer search space.
255
 
 
256
 
.. option:: --optimizer-search-depth arg (=0)
 
333
.. option:: --optimizer-search-depth ARG
 
334
 
 
335
   :Default: 0
 
336
   :Variable: ``optimizer_search_depth``
257
337
 
258
338
   Maximum depth of search performed by the query optimizer. Values larger than
259
339
   the number of relations in a query result in better query plans, but take
263
343
   MAX_TABLES+2, the optimizer will switch to the original find_best (used for
264
344
   testing/comparison).
265
345
 
266
 
.. option:: --preload-buffer-size arg (=32768)
267
 
 
268
 
   The size of the buffer that is allocated when preloading indexes
269
 
 
270
 
.. option:: --query-alloc-block-size arg (=8192)
271
 
 
272
 
   Allocation block size for query parsing and execution
273
 
 
274
 
.. option:: --query-prealloc-size arg (=8192)
275
 
 
276
 
   Persistent buffer for query parsing and execution
277
 
 
278
 
.. option:: --range-alloc-block-size arg (=4096)
279
 
 
280
 
   Allocation block size for storing ranges during optimization
281
 
 
282
 
.. 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``
283
402
 
284
403
   Each thread that does a sequential scan allocates a buffer of this size for
285
404
   each table it scans. If you do many sequential scans, you may want to
286
405
   increase this value.  Note that this only affect MyISAM.
287
406
 
288
 
.. option:: --read-buffer-constraint arg (=0)
289
 
 
290
 
   A global constraint for read-buffer-size for all clients, cannot be set lower
291
 
   than --read-buffer-size.  Setting to 0 means unlimited.
292
 
 
293
 
.. option:: --read-rnd-buffer-size arg (=262144)
 
407
.. option:: --read-rnd-buffer-size SIZE
 
408
 
 
409
   :Default: 262144
 
410
   :Variable: ``read_rnd_buffer_size``
294
411
 
295
412
   When reading rows in sorted order after a sort, the rows are read through
296
413
   this buffer to avoid a disk seeks. If not set, then it's set to the value of
297
414
   record_buffer.
298
415
 
299
 
.. option:: --read-rnd-constraint arg (=0)
 
416
.. option:: --read-rnd-constraint ARG
 
417
 
 
418
   :Default: 0
 
419
   :Variable: 
300
420
 
301
421
   A global constraint for read-rnd-buffer-size for all clients, cannot be set
302
422
   lower than --read-rnd-buffer-size.  Setting to 0 means unlimited.
303
423
 
304
 
.. 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``
305
435
 
306
436
   Select scheduler to be used.
307
437
 
308
 
.. option:: --sort-buffer-size arg (=2097144)
309
 
 
310
 
   Each thread that needs to do a sort allocates a buffer of this size.
311
 
 
312
 
.. 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: 
313
466
 
314
467
   A global constraint for sort-buffer-size for all clients, cannot be set lower
315
468
   than --sort-buffer-size.  Setting to 0 means unlimited.
316
469
 
317
 
.. 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``
318
488
 
319
489
   The number of cached table definitions.
320
490
 
321
 
.. option:: --table-open-cache arg (=1024)
322
 
 
323
 
   The number of cached open tables.
324
 
 
325
 
.. option:: --table-lock-wait-timeout arg (=50)
 
491
.. option:: --table-lock-wait-timeout ARG
 
492
 
 
493
   :Default: 50
 
494
   :Variable: ``table_lock_wait_timeout``
326
495
 
327
496
   Timeout in seconds to wait for a table level lock before returning an error.
328
497
   Used only if the connection has active cursors.
329
498
 
330
 
.. 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``
331
510
 
332
511
   The stack size for each thread. 0 means use OS default.
333
512
 
334
 
.. 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``
335
524
 
336
525
   If an internal in-memory temporary table exceeds this size, Drizzle will
337
526
   automatically convert it to an on-disk MyISAM table.
338
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.