X-Original-To: pgsql-performance-postgresql.org@localhost.postgresql.org Received: from localhost (unknown [64.117.224.193]) by svr1.postgresql.org (Postfix) with ESMTP id 0D0B930DE36 for ; Tue, 10 Jun 2003 18:02:37 +0000 (GMT) Received: from svr1.postgresql.org ([64.117.224.193]) by localhost (svr1.postgresql.org [64.117.224.193]) (amavisd-new, port 10024) with ESMTP id 22604-09 for ; Tue, 10 Jun 2003 15:02:26 -0300 (ADT) Received: from davinci.ethosmedia.com (unknown [209.10.40.251]) by svr1.postgresql.org (Postfix) with ESMTP id DAC9130DE77 for ; Tue, 10 Jun 2003 15:02:24 -0300 (ADT) Received: from [66.219.92.2] (HELO temoku) by davinci.ethosmedia.com (CommuniGate Pro SMTP 4.0.2) with ESMTP id 3108444 for pgsql-performance@postgresql.org; Tue, 10 Jun 2003 11:02:30 -0700 From: Josh Berkus Reply-To: josh@agliodbs.com Organization: Aglio Database Solutions To: pgsql-performance@postgresql.org Subject: Re-ordering .CONF params ... questions for this list Date: Tue, 10 Jun 2003 11:01:46 -0700 User-Agent: KMail/1.4.3 MIME-Version: 1.0 Content-Type: Multipart/Mixed; boundary="------------Boundary-00=_Y22ADXJSAL36M446LS4K" Message-Id: <200306101101.46304.josh@agliodbs.com> X-Archive-Number: 200306/34 X-Sequence-Number: 2118 --------------Boundary-00=_Y22ADXJSAL36M446LS4K Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable Folks, We've been discussing this for a while on HACKERS. However, I haven't been= =20 getting much feedback on the specific order proposed. Attached is an outline of my proposed re-ordering of postgresql.conf.sample= .=20=20=20 Please send me comments. I need to submit a patch by Thursday, so don't ta= ke=20 too long. This is an effort to make the order of run-time params in=20 postgresql.conf.sample and in the docs more logical and less baffling to th= e=20 new DBA. Questions: 1) Should "enable_implicit_from" go in the "Version/Platform Compatibility"= =20 section where I have it now, or in "CLIENT CONNECTIONS-Statement Behavior",= =20 or somewhere else? 2) Where should "preload_libraries" go? I'm very reluctant to start a=20 "Misc." section. Perhaps I should start a "LIBRARIES" section? 3) I have re-ordered each subsection somewhat. The fixed ordering is base= d=20 on: a) My guess at the frequency with which that option will be changed= ,=20 with more common options toward the top of the subsection; b) Grouping for tightly related options and for options that cascad= e; c) where (a) and (b) are unclear, alpha order. Does this order make sense looking at the file? 3) Should we use indenting in PostgreSQL.conf.sample? I tend to think it= =20 would make the file easier to read, but I'm not sure what effect it would= =20 have, if any, on parsing the file and whether other people would find it ea= sy=20 to read. --=20 -Josh Berkus Aglio Database Solutions San Francisco --------------Boundary-00=_Y22ADXJSAL36M446LS4K Content-Type: text/plain; charset="us-ascii"; name="re_order_conf" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="re_order_conf" #CONNECTIONS AND AUTHENTICATION #Connection Settings tcpip_socket max_connections superuser_reserved_connections port unix_socket_directory unix_socket_group unix_socket_permissions #Security & Authentication authentication_timeout ssl krb_server_keyfile virtual_host db_user_namespace #RESOURCE USAGE (except WAL) #Memory shared_buffers sort_mem vacuum_mem #Free Space Map max_fsm_pages max_fsm_relations #Disk Usage max_files_per_process #WRITE AHEAD LOG fsync wal_sync_method wal_buffers checkpoint_segments checkpoint_timeout checkpoint_warning commit_delay commit_siblings #QUERY TUNING #Planner Method Enabling enable_hashagg enable_hashjoin enable_indexscan enable_mergejoin enable_nestloop enable_seqscan enable_sort enable_tidscan #Planner Cost Constants effective_cache_size random_page_cost cpu_tuple_cost cpu_index_tuple_cost cpu_operator_cost default_statistics_target #Genetic Estimate Query Optimizer geqo geqo_threshold geqo_selection_bias geqo_pool_size geqo_effort geqo_generations geqo_random_seed #Other Query Modifiers explain_pretty_print from_collapse_limit join_collapse_limit max_expr_depth #CLIENT CONNECTION DEFAULTS #Statement Behaviour autocommit search_path default_transaction_isolation default_transaction_read_only statement_timeout #Locale and Formatting client_encoding australian_timezones datestyle timezone lc_messages lc_monetary lc_time lc_numeric #Other Defaults dynamic_library_path password_encryption #LOGGING & DEBUGGING #Debugging/Logging Levels server_min_messages client_min_messages log_min_error_statement debug_print_parse debug_print_rewritten debug_print_plan debug_pretty_print debug_assertions silent_mode #Additional Info to Log log_connections log_duration log_pid log_statement log_timestamp hostname_lookup show_source_port #Syslog syslog syslog_facility syslog_ident #STATISTICS #Statistics monitoring show_parser_stats show_planner_stats show_executor_stats show_statement_stats #Query/Index Statistics Collector stats_start_collector stats_reset_on_server_start stats_command_string stats_row_level stats_block_level #LOCK MANAGEMENT deadlock_timeout max_locks_per_transaction #VERSION/PLATFORM COMPATIBILITY OPTIONS enable_implicit_from have_rendezvous regex_flavor sql_inheritance transform_null_equals --------------Boundary-00=_Y22ADXJSAL36M446LS4K--