16.2. 2.2.x Branch

16.2.1. Upgrade Notes

  • The minimum supported version of Erlang is now 17, not R16B03. Support for Erlang 21is still ongoing and will be provided in a future release.

  • The CouchDB replication client can now use the /_session endpoint whenauthenticating against remote CouchDB instances, improving performance sincere-authorization does not have to be performed with every request. Because ofthis performance improvement, it is recommended to increase the PBKDF2 workfactor beyond the default 10 to a modern default such as 10000. This is donevia the local ini file setting [couch_httpd_auth] iterations = 10000.

Do not do this if an older version of CouchDB is replicating TO this instance orcluster regularly, since CouchDB < 2.2.0 must perform authentication on every requestand replication performance will suffer.

A future version will make this increased number of iterations a default.

  • #820, #1032: Multiple queries can now be made at thePOST /{db}/all_docs/queries, POST /{db}/_design_docs/queries andPOST /{db}/_local_docs/queries endpoints. Also, a new endpointPOST /{db}/_design/{ddoc}/_view/{view}/queries has been introduced to replacethe ?queries parameter formerly provided for making multiple queries to a view.The old ?queries parameter _is now deprecated and will be removed in a futurerelease of CouchDB.

  • The maximum http request limit, which had been lowered in 2.1.0, has been re-raisedto a 4GB limit for now. (#1446). Ongoing discussion about the path forwardfor future releases is available in #1200 and #1253.

  • #1118: The least recently used (LRU) cache of databases is now only updatedon database write, not read. This has lead to significant performance enhancementson very busy clusters. To restore the previous behaviour, your local ini file cancontain the block [couchdb] update_lru_on_read = true.

  • #1153: The CouchDB replicator can now make use of the /_session endpointrather than relying entirely on HTTP basic authentication headers. This can greatlyimprove replication performance. We encourage you to upgrade any nodes or clusters thatregularly act as replication clients to use this new feature, which is enabled bydefault (#1462).

  • #1283: The [couchdb] enable_database_recovery feature, which onlysoft-deletes databases in response to a DELETE /{db} call, is now documented indefault.ini.

  • #1330: CouchDB externals and OS daemons are now officially deprecated and nolonger documented. Support for these features will be completely removed in a futurerelease of CouchDB (probably 3.0.0).

  • #1436: CouchDB proxy authentication now uses a proper chttpd_authmodule, simplifying configuration in local ini files. While this is not a backward-compatible breaking change, it is best to update your local ini files to reference thenew {chttpd_auth, proxy_authentication_handler} handler rather than thecouch_httpd_auth version, as couch_httpd is in the process of being deprecatedcompletely.

  • #1476, #1477: The obsolete update_notification feature, whichwas replaced by /{db}/_changes feeds c. CouchDB 1.2, has been completely removed.This feature never worked in 2.0 for databases, only for shards, making it effectivelyuseless.

16.2.2. Version 2.2.0

16.2.2.1. Features

  • Much improved documentation. Highlights include:

    • A complete rewrite of the sharding documentation.
    • Developer installation notes (INSTALL.*.rst)
    • Much of the content of the original CouchDB Wiki has been imported into theofficial docs. (The old CouchDB Wiki is in the process of being deprecated.)

  • Much improved Fauxton functionality. Highlights include:

    • Search support in the code editor
    • Support for relative Fauxton URLs (i.e., not always at /_utils)
    • Replication setup enhancements for various authentication mechanisms
    • Fixes for IE10, IE11, and Edge (we hope…)
    • Resolving conflicts of design documents is now allowed

  • #496, COUCHDB-3287: New pluggable storage engine framework has landed inCouchDB. This internal refactor makes it possible for CouchDB to use different backendsfor storing the base database file itself. The refactor included a full migration ofthe existing “legacy” storage engine into the new framework.

  • #603: When creating a new database on a cluster without quorum, CouchDB willnow return a 202 Accepted code if possible, indicating that at least one nodehas written the database record to disk, and that other nodes will be updated as theyreturn to an online state. This replaces the former 500 internal error.

  • #1136, #1139: When deleting a database in a cluster withoutquorum, CouchDB will no longer throw a 500 error status, but a 202 as long asat least one node records the deletion, or a 200 when all nodes respond. This fixparallels the one made for #603.

  • #745: CouchDB no longer fails to complete replicating databases withlarge attachments. The fix for this issue included several related changes:

    • The maximum http request limit, which had been lowered in 2.1.0, has been re-raisedto a 4GB limit for now. (#1446). Ongoing discussion about the path forwardfor future releases is available in #1200 and #1253.
    • An update to the replicator http client that improves active socket accounting,without which CouchDB can cease to be responsive over the main http interface(#1117)
    • The replicator’s http client no longer performs unconditional retries on failure(#1177)
    • A path by which CouchDB could lose track of their RPC workers during multipartattachment processing was removed. (#1178)
    • When CouchDB transmits a 413 Payload Too Large response on attachment upload,it now correctly flushes the receive socket before closing the connection to avoida TCP reset, and to give the client a better chance of parsing the 413 response. Intandem, the replicator http client correctly closes its own socket after processingany 413 response. (#1234)
    • A fabric process to receive unchunked attachments can no longer orphan processesthat leave unprocessed binaries in memory until all available memory is exhausted.(#1264).
    • When using CouchDB’s native SSL responder (port 6984 by default), sessions are nowtimed out by default after 300s. This is to work around RAM explosion in the BEAM VMwhen using the Erlang-native SSL libraries. (#1321

  • #822: A new end point /_dbs_info has been added to returninformation about a list of specified databases. This endpoint can take the place ofmultiple queries to /{db}.

  • #875, #1030: couch_peruser installations can now specify adefault q value for each peruser-created database that is different from thecluster’s q value. Set this in your local ini file, under [couch_peruser] q.

  • #876, #1068: The couch_peruser database prefix is nowconfigurable through your local ini file, under [couch_peruser] database_prefix.

  • #887: Replicator documents can now include parameters for target databasecreation, such as "create_target_params": {"q": "1"}. This can assist indatabase resharding or placement.

  • #977: When using COPY to copy a document, CouchDB no longer fails ifthe new ID includes Unicode characters.

  • #1095: Recognize the environment variables ARGS_FILE, SYSCONFIG_FILE,COUCHDB_ARGS_FILE and COUCHDB_SYSCONFIG_FILE to overrride where CouchDB looksfor the vm.args and sys.config files at startup.

  • #1101, #1425: Mango can now be used to find conflicted documentsin a database by adding conflicts: true to a mango selector.

  • #1126: When queried back after saving, replication documents no longercontain sensitive credential information (such as basic authenticataion headers).

  • #1203:

  • The compaction daemon now has a snooze period, during which it waits to start
    the next compaction after finishing the previous one. This value is useful in
    setups with many databases (e.g. with couch_peruser) or many design docs,
    which can cause a CPU spike every check_interval seconds. The setting can
    be adjusted in your local ini file via [compaction_daemon] snooze_period.
    The current default is a 3 second pause.

  • The check_interval has been raised from 300 seconds to 3600 seconds.

  • A notice-level log about closing view indexes has been demoted to the
    debug level. In a sceario with many design docs, this would createsignficant
    load on the logging subsystem every [compaction_daemon] check_interval for
    no discernible benefit.

  • #1309, #1435: CouchDB now reports the git sha at the time of buildin the top-level GET / version string, in a new git_sha key. This can be usedto help ensure an unmodified version of CouchDB has been built and is running on anygiven machine.

  • COUCHDB-2971, #1346: CouchDB now includes a new builtin reduce function_approx_count_distinct, that uses a HyperLogLog algorithm to estimate the number ofdistinct keys in the view index. The precision is currently fixed to 2^11 observables,and therefore uses approximately 1.5KB of memory.

  • #1377: CouchDB finalization of view reduces now occurs at the coordinatornode. This simplified the built-in _stats function.

  • #1392: When running CouchDB under Erlang 19.0 or newer, messages can now bestored off the process heap. This is extremely useful for Erlang processes that canhave huge number of messages in their mailbox, and is now enabled for couch_server,couch_log_server, ddoc_cache, mem3_shards, and rexi_server wheneverpossible.

  • #1424: The CouchDB native SSL/TLS server httpsd now accepts socket-levelconfiguration options through the [httpsd] server_options ini file setting.

  • #1440: CouchDB can now be configured to prevent non-admins from accessingthe GET /_all_dbs method by specifying [chttpd] admin_only_all_dbs = true inyour local ini file(s). The true setting will become default in future versions.

  • #1171, #1445: CouchDB can now be configured to use the internalErlang MD5 hash function when not available in the external environment (e.g. FIPSenabled CentOS) at compile time with the configure flag —enable-md5. Becausethis implementation is slower, it is not recommended in the general case.

16.2.2.2. Performance

  • #958: The revision stemming algorithm was optimized down from O(N^2) toO(N) via a depth-first search approach, and then further improved by calling thestemming operation only when necessary. This new algorithm can be disabled bysetting the option [couchdb] stem_interactive_updates = false if necessary.

  • #1246: CouchDB now checks for request authorization only once per eachdatabase request, improving the performance of any request that requiresauthorization.

16.2.2.3. Bugfixes

  • #832, #1064: Tracking of Couch logging stats has been added backinto the per-node /_node/<node-name>/_stats endpoint.

  • #953, #973: Return 404 Not Found on GET /_scheduler,not 405 Method Not Allowed.

  • #955: The /{db}/_bulk_docs endpoint now correctly responds with a400 Bad Request error if the new_edits parameter is not a boolean.

  • #969: CouchDB now returns offset and update_seq values when keysare provided to the GET or POST /{db}/_all_docs?update_seq=true endpoints.This was affecting PouchDB compatibility.

  • #984, #1434: CouchDB views now retain their update_seq aftercompaction, preventing potentially expensive client-side view rewinds after compaction.

  • #1012: Address a theoretical race condition the replication scheduler couldencounter when trying to determine if the cluster is “stable” enough to resumehandling replication-introduced document updates.

  • #1051: Return a user-friendly error message when attempting to create aCouchDB user with an invalid password field (non-string).

  • #1059: DB-specific compaction configurations were not working correctly. Thesyntax now also supports shard-level custom compaction configuration if desired (whichit probably isn’t.)

  • #1097: Compaction daemon will not crash out when trying to check specificfile system mounts that are not “real” file systems (like /run on Linux).

  • #1198: Fauxton is no longer available on the node-local port (5986, bydefault). The node-local port is only to be used for specific administrative tasks;removing the Fauxton interface prevents mistaking the node-local port as the correctCouchDB port (5984, by default).

  • #1165: validate_doc_update view functions can once again be implementeddirectly in Erlang (after enabling the optional Erlang view server).

  • #1223: The couch_config application now correctly handles non-persistentinteger and boolean-valued configuration changes.

  • #1242: couch_os_daemons may now reside in directories with spaces.

  • #1258: CouchDB will now successfully login users, even if password encryptionis very slow.

  • #1276: The replication scheduler status for a repeatedly erroring job nowcorrectly reflects the crashing state in more scenarios.

  • #1375: If CouchDB fails authorization but passes authentication, it no longerdrops the user_ctx out of the request.

  • #1390: The active size of views (as returned in a database info response) nolonger is incorrectly calculated in such a way that it could occasionally be larger thanthe actual on-disk file size.

  • #1401: CouchDB Erlang views no longer crash in the couch_native processwith an unexpected function_clause error.

  • #1419: When deleting a file, CouchDB now properly ignores the configurationflag enable_database_recovery when set when compacting databases, rather thanalways retaining the old, renamed, uncompacted database file.

  • #1439: The CouchDB setup wizard now correctly validates bind_addresses. Italso no longer logs credentials by moving logging of internal wizard setup steps tothe debug level from the notice level.

16.2.2.4. Mango

  • #816, #962, #1038: If a user specifies a value foruse_index that is not valid for the selector (does not meet coverage requirementsor proper sort fields), attempt to fall back to a valid index or full DB scan ratherthan returning a 400. If we fall back, populate a warning field in theresponse. Mango also tries to use indexes where $or may select a field only whencertain values are present.

  • #849: When {"seq_indexed": true} is specified, a badmatch error wasreturned. This is now fixed.

  • #927, #1310: Error messages when attempting to sort incorrectly arenow actually useful.

  • #951: When using GET /{db}/_index, only use a partial filter selector foran index if it is set to something other than the default.

  • #961: Do not prefix _design/ to a Mango index name whose user-specifiedname already starts with _design/.

  • #988, #989: When specifying a use_index value with an invalidindex, correctly return a 400 Bad Request showing that the requested index isinvalid for the request specified.

  • #998: The fix for CVE 2017-12635 presented a breakingchange to Mango’s /{db}/_find, which would evaluate all instances of all JSONfields in a selector. Mango is now tested to ensure it only considers the last instanceof a field, silently ignoring those that appear before it.

  • #1014: Correctly deduce list of indexed fields in a selector when nested$and operators are specified.

  • #1023: Fix an unexpected 500 error if startkey and endkey in aMango selector were reversed.

  • #1067: Prevent an invalid_cast crash when the couch_proc_manager softlimit for processes is reached and mango idle processes are stopped.

  • #1336: The built-in fields _id and rev will always be covered by anyindex, and Mango now correctly ignores their presence in any index that explicitlyincludes them for selector matching purposes.

  • #1376: Mango now appropriately selects some indexes as usable for queries,even if not all columns for an index are added to the query’s sort field list.

  • Multiple fixes related to using Mango as a front-end for full text indexing (a featurenot shipped with couch, but for which support is in place as a compile-time addon).

16.2.2.5. Other

The 2.2.0 release also includes the following minor improvements:

  • Developers can, at build time, enable curl libraries & disable Fauxton and documentationbuilds by specifying the new —dev option to the configure script.

  • The mochiweb dependency was bumped to version 2.17.0, in part to address thedifficult #745 issue.

  • Improved compatibility with newer versions of Erlang (20.x)

  • Improved release process for CouchDB maintainers and PMC members.

  • Multiple test suite improvements, focused on increased coverage, speed, andreliability.

  • Improvements to the Travis CI and Jenkins CI setups, focused on improved long-termproject maintenance and automatability.

  • Related improvements to the CouchDB deb/rpm packaging and Docker repositories tomake deployment even easier.

  • #1007: Move etc/default.ini entries back into [replicator] section(incorrectly moved to [couch_peruser] section)

  • #1245: Increased debug-level logging for shard open errors is now available.

  • #1296: CouchDB by default now always invokes the SMP-enabled BEAM VM, evenon single-processor machines. A future release of Erlang will remove the non-SMP BEAMVM entirely.

  • A pony! OK, no, not really. If you got this far…thank you for reading.

原文: http://docs.couchdb.org/en/stable/whatsnew/2.2.html