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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
|
<?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_pub_init_image">
<refmeta>
<refentrytitle>REPL_PUB_INIT_IMAGE</refentrytitle>
<refmiscinfo>repl</refmiscinfo>
</refmeta>
<refnamediv>
<refname>REPL_PUB_INIT_IMAGE</refname>
<refpurpose>create initial image of publication on publisher</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_repl_pub_init_image">
<funcprototype id="fproto_repl_pub_init_image">
<funcdef><function>REPL_PUB_INIT_IMAGE</function></funcdef>
<paramdef>in <parameter>publication</parameter> varchar</paramdef>
<paramdef>in <parameter>image_file_path</parameter> varchar</paramdef>
<paramdef>in <parameter>bytes_per_file</parameter> integer</paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_repl_pub_init_image"><title>Description</title>
<para>The image creation process forces checkpoint and runs
in atomic mode.
</para>
<para>If <emphasis>image_file_path</emphasis> does not contain
path components (slashes or backslashes), image slices are stored in
one of backup directories defined in virtuoso.ini using round-robin
strategy.
</para>
<para>This function is used to create image of publication to be replayed on a subscribed
upon initial setup. This can be used when publication data is so large to be
copied via repl_init_copy() which uses VDB operations.
The image file(s) created by this function must be loaded on subscriber with replay() function in order
of their creation (if image is split on to a several files).</para>
</refsect1>
<refsect1 id="params_repl_pub_init_image"><title>Parameters</title>
<refsect2><title>publication</title>
<para> publication account name.</para>
</refsect2>
<refsect2><title>image_file_path</title>
<para> full path to the image file
where to store the initial image of publication.</para>
</refsect2>
<refsect2><title>bytes_per_file</title>
<para>at which bytes count to split
file into next slice.</para>
</refsect2>
</refsect1>
<!-- 3019
This function doesnt return value
Errors:
TR016 37000 The publication <name> does not exist
TR017 37000 The publication <name> doesn't exists
TR018 37000 The WebDAV collection <name> doesn't exists.
TR019 37000 The DAV collection <name> must added before checkpoint.
-->
<refsect1 id="examples_repl_pub_init_image"><title>Example</title>
<example id="ex_repl_pub_init_image_1"><title>Creating and loading of the initial image</title>
<para>This shows creating a image with inital data of the published items and store in the 'tbl_pub.log' file.</para>
<screen>
SQL> DB.DBA.REPL_PUB_INIT_IMAGE ('table_publication', 'tbl_pub.log', 1000000);
</screen>
<para>Furthermore the image can be loaded on a subscriber. Note that this command MUST be issued on the subscriber side. Note that REPL_PUB_INIT_IMAGE() will make more files when size of the initial file is greater than 1Mb, so in that case the additional files will be named tbl_pub.log.N where N is a sequence beginning from 1 and they also need to be loaded.</para>
<screen>
SQL> replay 'tbl_pub.log';
... if there a more than one image file load sequentially ...
SQL> replay 'tbl_pub.log.1';
...
</screen>
</example>
</refsect1>
<refsect1 id="seealso_repl_pub_init_image"><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_init_copy"><function>repl_init_copy()</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_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>
|
