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
|
<?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_publish">
<refmeta>
<refentrytitle>REPL_PUBLISH</refentrytitle>
<refmiscinfo>repl</refmiscinfo>
</refmeta>
<refnamediv>
<refname>REPL_PUBLISH</refname>
<refpurpose>create publication on publisher</refpurpose>
</refnamediv>
<refsynopsisdiv>
<funcsynopsis id="fsyn_repl_publish">
<funcprototype id="fproto_repl_publish">
<funcdef><function>REPL_PUBLISH</function></funcdef>
<paramdef>in <parameter>publication</parameter> varchar</paramdef>
<paramdef>in <parameter>log_path</parameter> varchar</paramdef>
<paramdef><optional>in <parameter>is_updateable</parameter> integer</optional></paramdef>
<paramdef><optional>in <parameter>sync_user</parameter> varchar</optional></paramdef>
</funcprototype>
</funcsynopsis>
</refsynopsisdiv>
<refsect1 id="desc_repl_publish"><title>Description</title>
<para>
This function starts a publication and associates a file system file to it. The file
will be used to log transaction records associated to the publication. The server will
periodically start new files, so that replication log files do not grow indefinitely.
New files will go to the same directory as the initial one and will have names suffixed with
the date and time of their creation.
</para>
</refsect1>
<refsect1 id="params_repl_publish"><title>Parameters</title>
<refsect2><title>publication</title>
<para>Publication name. It must not contain spaces or special symbols.</para></refsect2>
<refsect2><title>log_path</title>
<para>Full path and filename to the file where transactions to this account will be stored.</para></refsect2>
<refsect2><title>is_updateable</title>
<para>If this parameter is specified and it is non-zero an updateable
publication is created.</para></refsect2>
<refsect2><title>sync_user</title>
<para>Local DB account used to replay replication feeds from subscribers (when publication is updateable).</para></refsect2>
</refsect1>
<!-- 3019
This function doesn't return value
Errors:
TR002 37000 Replication not enabled on this server
-->
<refsect1 id="examples_repl_publish"><title>Example</title>
<example id="ex_repl_publish_1"><title>Creating an updateable publication</title>
<para>This will create an updateable publication'demo-publication'
with log 'demo-publication.log'. Replication feeds from subscribers
will be replayed by used 'demo'.</para>
<screen>
SQL> DB.DBA.REPL_PUBLISH ('demo-publication', 'demo-publication.log', 1, 'demo');
</screen>
</example>
</refsect1>
<refsect1 id="seealso_repl_publish"><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_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_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>
|
