1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
|
<?xml version="1.0" encoding="ISO-8859-1"?>
<!--
-
- This file is part of the OpenLink Software Virtuoso Open-Source (VOS)
- project.
-
- Copyright (C) 1998-2018 OpenLink Software
-
- This project is free software; you can redistribute it and/or modify it
- under the terms of the GNU General Public License as published by the
- Free Software Foundation; only version 2 of the License, dated June 1991.
-
- This program is distributed in the hope that it will be useful, but
- WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
-
- You should have received a copy of the GNU General Public License along
- with this program; if not, write to the Free Software Foundation, Inc.,
- 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
-
-
-->
<refentry id="fn_repl_init_copy">
<refmeta>
<refentrytitle>REPL_INIT_COPY</refentrytitle>
<refmiscinfo>repl</refmiscinfo>
</refmeta>
<refnamediv>
<refname>REPL_INIT_COPY</refname>
<refpurpose>create initial subscription state</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_repl_init_copy">
<funcprototype id="fproto_repl_init_copy">
<funcdef><function>REPL_INIT_COPY</function></funcdef>
<paramdef>in <parameter>server_name</parameter> varchar</paramdef>
<paramdef>in <parameter>publication</parameter> varchar</paramdef>
<paramdef>in <parameter>errors_mode</parameter> integer</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_repl_init_copy"><title>Description</title>
<para>
This function is called on the subscriber to copy the current state of the
elements of the publication from the publishing server. Copied data can
include DAV collections, tables, procedures etc. Syncing the
subscription using repl_sync will synchronize the subscription
once it has been initialized with this function. The state copied
corresponds to the state of the published data as of the last checkpoint
completed on the publisher.
</para>
</refsect1>
<refsect1 id="params_repl_init_copy"><title>Parameters</title>
<refsect2><title>server_name</title>
<para>target publisher server name.</para>
</refsect2>
<refsect2><title>account</title>
<para>publication account name.</para>
</refsect2>
<refsect2><title>errors_mode</title>
<para>Important: this parameter is valid only for SQL replication data (tables and WebDAV). When set to 1, in case of errors
as result of the replication copy, these errors are return in vector; When set to 0, in case of error,
this error is return and the replication copying is stopped.</para>
</refsect2>
</refsect1>
<!-- 3019
This function doesn't return value
Errors:
TR055 37000 The WebDAV collection <name> already exist
errors on attach table
errors on rexecute
-->
<refsect1 id="examples_repl_init_copy"><title>Example</title>
<example id="ex_repl_pub_copy_1"><title>Loading of the initial data on subscriber</title>
<para>This shows setting on-line of the initial state of the subscription to 'demo_publication' from server 'demo-srv'. The data for items will be transferred thru the VDB connection. Note that on large publications this can take a lot of time.</para>
<screen>
SQL> DB.DBA.REPL_INIT_COPY ('demo-srv', 'demo_publication', 1);
</screen>
</example>
</refsect1>
<refsect1 id="seealso_repl_init_copy"><title>See Also</title>
<para><link linkend="fn_sub_schedule"><function>sub_schedule()</function></link></para>
<para><link linkend="fn_repl_disconnect"><function>repl_disconnect()</function></link></para>
<para><link linkend="fn_repl_grant"><function>repl_grant()</function></link></para>
<para><link linkend="fn_repl_new_log"><function>repl_new_log()</function></link></para>
<para><link linkend="fn_repl_pub_add"><function>repl_pub_add()</function></link></para>
<para><link linkend="fn_repl_pub_init_image"><function>repl_pub_init_image()</function></link></para>
<para><link linkend="fn_repl_pub_remove"><function>repl_pub_remove()</function></link></para>
<para><link linkend="fn_repl_publish"><function>repl_publish()</function></link></para>
<para><link linkend="fn_repl_revoke"><function>repl_revoke()</function></link></para>
<para><link linkend="fn_repl_sched_init"><function>repl_sched_init()</function></link></para>
<para><link linkend="fn_repl_server"><function>repl_server()</function></link></para>
<para><link linkend="fn_repl_server_rename"><function>repl_server_rename()</function></link></para>
<para><link linkend="fn_repl_stat"><function>repl_stat()</function></link></para>
<para><link linkend="fn_repl_status"><function>repl_status()</function></link></para>
<para><link linkend="fn_repl_subscribe"><function>repl_subscribe()</function></link></para>
<para><link linkend="fn_repl_sync"><function>repl_sync()</function></link></para>
<para><link linkend="fn_repl_sync_all"><function>repl_sync_all()</function></link></para>
<para><link linkend="fn_repl_text"><function>repl_text()</function></link></para>
<para><link linkend="fn_repl_this_server"><function>repl_this_server()</function></link></para>
<para><link linkend="fn_repl_unpublish"><function>repl_unpublish()</function></link></para>
<para><link linkend="fn_repl_unsubscribe"><function>repl_unsubscribe()</function></link></para>
</refsect1>
</refentry>
|
