davisp commented on a change in pull request #470: Scheduling Replicator URL: https://github.com/apache/couchdb/pull/470#discussion_r110434390
########## File path: src/couch_replicator/src/couch_replicator_docs.erl ########## @@ -0,0 +1,736 @@ +% Licensed under the Apache License, Version 2.0 (the "License"); you may not +% use this file except in compliance with the License. You may obtain a copy of +% the License at +% +% http://www.apache.org/licenses/LICENSE-2.0 +% +% Unless required by applicable law or agreed to in writing, software +% distributed under the License is distributed on an "AS IS" BASIS, WITHOUT +% WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the +% License for the specific language governing permissions and limitations under +% the License. + +-module(couch_replicator_docs). + +-export([parse_rep_doc/1, parse_rep_doc/2, parse_rep_db/3]). +-export([parse_rep_doc_without_id/1, parse_rep_doc_without_id/2]). +-export([before_doc_update/2, after_doc_read/2]). +-export([ensure_rep_db_exists/0, ensure_rep_ddoc_exists/1]). +-export([ensure_cluster_rep_ddoc_exists/1]). +-export([ + remove_state_fields/2, + update_doc_completed/4, + update_failed/4, + update_rep_id/1 +]). +-export([update_triggered/2, update_error/2]). + + +-define(REP_DB_NAME, <<"_replicator">>). +-define(REP_DESIGN_DOC, <<"_design/_replicator">>). + +-include_lib("couch/include/couch_db.hrl"). +-include_lib("ibrowse/include/ibrowse.hrl"). +-include_lib("mem3/include/mem3.hrl"). +-include("couch_replicator_api_wrap.hrl"). +-include("couch_replicator.hrl"). + +-include("couch_replicator_js_functions.hrl"). + +-import(couch_util, [ + get_value/2, + get_value/3, + to_binary/1 +]). + +-import(couch_replicator_utils, [ + get_json_value/2, + get_json_value/3 +]). + + +-define(OWNER, <<"owner">>). +-define(CTX, {user_ctx, #user_ctx{roles=[<<"_admin">>, <<"_replicator">>]}}). + +-define(replace(L, K, V), lists:keystore(K, 1, L, {K, V})). + +remove_state_fields(DbName, DocId) -> + update_rep_doc(DbName, DocId, [ + {<<"_replication_state">>, undefined}, + {<<"_replication_state_time">>, undefined}, + {<<"_replication_state_reason">>, undefined}, + {<<"_replication_start_time">>, undefined}, + {<<"_replication_id">>, undefined}, + {<<"_replication_stats">>, undefined}]). + +-spec update_doc_completed(binary(), binary(), [_], erlang:timestamp()) -> any(). +update_doc_completed(DbName, DocId, Stats, StartTime) -> + StartTimeBin = couch_replicator_utils:iso8601(StartTime), + update_rep_doc(DbName, DocId, [ + {<<"_replication_state">>, <<"completed">>}, + {<<"_replication_state_reason">>, undefined}, + {<<"_replication_start_time">>, StartTimeBin}, + {<<"_replication_stats">>, {Stats}}]), + couch_stats:increment_counter([couch_replicator, docs, completed_state_updates]). + + +-spec update_failed(binary(), binary(), any(), erlang:timestamp()) -> any(). +update_failed(DbName, DocId, Error, StartTime) -> + Reason = error_reason(Error), + couch_log:error("Error processing replication doc `~s` from `~s`: ~s", + [DocId, DbName, Reason]), + StartTimeBin = couch_replicator_utils:iso8601(StartTime), + update_rep_doc(DbName, DocId, [ + {<<"_replication_state">>, <<"failed">>}, + {<<"_replication_start_time">>, StartTimeBin}, + {<<"_replication_stats">>, undefined}, + {<<"_replication_state_reason">>, Reason}]), + couch_stats:increment_counter([couch_replicator, docs, failed_state_updates]). + + +-spec update_triggered(#rep{}, rep_id()) -> ok. +update_triggered(Rep, {Base, Ext}) -> + #rep{ + db_name = DbName, + doc_id = DocId, + start_time = StartTime + } = Rep, + StartTimeBin = couch_replicator_utils:iso8601(StartTime), + update_rep_doc(DbName, DocId, [ + {<<"_replication_state">>, <<"triggered">>}, + {<<"_replication_state_reason">>, undefined}, + {<<"_replication_id">>, iolist_to_binary([Base, Ext])}, + {<<"_replication_start_time">>, StartTimeBin}, + {<<"_replication_stats">>, undefined}]), + ok. + + +-spec update_error(#rep{}, any()) -> ok. +update_error(#rep{db_name = DbName, doc_id = DocId, id = RepId}, Error) -> + Reason = error_reason(Error), + BinRepId = case RepId of + {Base, Ext} -> + iolist_to_binary([Base, Ext]); + _Other -> + null + end, + update_rep_doc(DbName, DocId, [ + {<<"_replication_state">>, <<"error">>}, + {<<"_replication_state_reason">>, Reason}, + {<<"_replication_stats">>, undefined}, + {<<"_replication_id">>, BinRepId}]), + ok. + + +-spec ensure_rep_db_exists() -> {ok, #db{}}. +ensure_rep_db_exists() -> + Db = case couch_db:open_int(?REP_DB_NAME, [?CTX, sys_db, nologifmissing]) of + {ok, Db0} -> + Db0; + _Error -> + {ok, Db0} = couch_db:create(?REP_DB_NAME, [?CTX, sys_db]), + Db0 + end, + ok = ensure_rep_ddoc_exists(?REP_DB_NAME), + {ok, Db}. + + +-spec ensure_rep_ddoc_exists(binary()) -> ok. +ensure_rep_ddoc_exists(RepDb) -> + case mem3:belongs(RepDb, ?REP_DESIGN_DOC) of + true -> + ensure_rep_ddoc_exists(RepDb, ?REP_DESIGN_DOC); + false -> + ok + end. + + +-spec ensure_rep_ddoc_exists(binary(), binary()) -> ok. +ensure_rep_ddoc_exists(RepDb, DDocId) -> + case open_rep_doc(RepDb, DDocId) of + {not_found, no_db_file} -> + %% database was deleted. + ok; + {not_found, _Reason} -> + DocProps = replication_design_doc_props(DDocId), + DDoc = couch_doc:from_json_obj({DocProps}), + couch_log:notice("creating replicator ddoc", []), + {ok, _Rev} = save_rep_doc(RepDb, DDoc); + {ok, Doc} -> + Latest = replication_design_doc_props(DDocId), + {Props0} = couch_doc:to_json_obj(Doc, []), + {value, {_, Rev}, Props} = lists:keytake(<<"_rev">>, 1, Props0), + case compare_ejson({Props}, {Latest}) of + true -> + ok; + false -> + LatestWithRev = [{<<"_rev">>, Rev} | Latest], + DDoc = couch_doc:from_json_obj({LatestWithRev}), + couch_log:notice("updating replicator ddoc", []), + try + {ok, _} = save_rep_doc(RepDb, DDoc) + catch + throw:conflict -> + %% ignore, we'll retry next time + ok + end + end + end, + ok. + + +-spec ensure_cluster_rep_ddoc_exists(binary()) -> ok. +ensure_cluster_rep_ddoc_exists(RepDb) -> + DDocId = ?REP_DESIGN_DOC, + [#shard{name = DbShard} | _] = mem3:shards(RepDb, DDocId), + ensure_rep_ddoc_exists(DbShard, DDocId). + + +-spec compare_ejson({[_]}, {[_]}) -> boolean(). +compare_ejson(EJson1, EJson2) -> + EjsonSorted1 = couch_replicator_filters:ejsort(EJson1), + EjsonSorted2 = couch_replicator_filters:ejsort(EJson2), + EjsonSorted1 == EjsonSorted2. + + +-spec replication_design_doc_props(binary()) -> [_]. +replication_design_doc_props(DDocId) -> + TerminalViewEJson = {[ + {<<"map">>, ?REP_DB_TERMINAL_STATE_VIEW_MAP_FUN}, + {<<"reduce">>, <<"_count">>} + ]}, + DocProps = [ + {<<"_id">>, DDocId}, + {<<"language">>, <<"javascript">>}, + {<<"validate_doc_update">>, ?REP_DB_DOC_VALIDATE_FUN}, + {<<"views">>, {[ + {<<"terminal_states">>, TerminalViewEJson} + ]}} + ]. + + +% Note: parse_rep_doc can handle filtered replications. During parsing of the +% replication doc it will make possibly remote http requests to the source +% database. If failure or parsing of filter docs fails, parse_doc throws a +% {filter_fetch_error, Error} excation. This exception should be considered transient +% in respect to the contents of the document itself, since it depends on +% netowrk availability of the source db and other factors. +-spec parse_rep_doc({[_]}) -> #rep{}. +parse_rep_doc(RepDoc) -> + {ok, Rep} = try + parse_rep_doc(RepDoc, rep_user_ctx(RepDoc)) + catch + throw:{error, Reason} -> Review comment: Multiple catch patterns should be indented one level beyond the catch ---------------------------------------------------------------- This is an automated message from the Apache Git Service. To respond to the message, please log on GitHub and use the URL above to go to the specific comment. For queries about this service, please contact Infrastructure at: [email protected] With regards, Apache Git Services
