vpruthi/doc-exports
1
0
Fork 0
forked from docs/doc-exports
Code Pull Requests Activity
doc-exports/docs/dws/dev/dws_06_0287.html
Lu, Huayi ef0ada5a59 DWS DEV 20240716 version 
Reviewed-by: Pruthi, Vineet <vineet.pruthi@t-systems.com>
Co-authored-by: Lu, Huayi <luhuayi@huawei.com>
Co-committed-by: Lu, Huayi <luhuayi@huawei.com>
2024-11-02 09:07:47 +00:00

59 lines
11 KiB
HTML
Raw Blame History

<a name="EN-US_TOPIC_0000001460880908"></a><a name="EN-US_TOPIC_0000001460880908"></a>
<h1 class="topictitle1">ALTER SUBSCRIPTION</h1>
<div id="body0000001442353378"><div class="section" id="EN-US_TOPIC_0000001460880908__se300da7053554cb58cc5988526228ed0"><h4 class="sectiontitle">Function</h4><p id="EN-US_TOPIC_0000001460880908__ace403db5736840f08d3e8a83b362a1a0">Modifies subscription attributes.</p>
</div>
<div class="section" id="EN-US_TOPIC_0000001460880908__s9264977dc26a4c7f8993cc31dd59c965"><h4 class="sectiontitle">Precautions</h4><ul id="EN-US_TOPIC_0000001460880908__u376c43d0bff54635af4347cf838af540"><li id="EN-US_TOPIC_0000001460880908__li16402647679">This statement is supported by clusters of version 8.2.0.100 or later.</li><li id="EN-US_TOPIC_0000001460880908__li873035012187">Only the owner of a subscription can execute <strong id="EN-US_TOPIC_0000001460880908__b1756916459485">ALTER SUBSCRIPTION</strong>, and the new owner must be a system administrator.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001460880908__sba7861b1289b443a9ce4f3f5c63c3b75"><h4 class="sectiontitle">Syntax</h4><ul id="EN-US_TOPIC_0000001460880908__u63e03f7051194d6b9b24114f6bfd0e47"><li id="EN-US_TOPIC_0000001460880908__l7019d52a46aa40e1b3a31c5d9df0e5f6">Update the connection information of a subscription.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__sa5e6878264054aee81e7ef940725639c"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">CONNECTION</span><span class="w"> </span><span class="s1">'conninfo'</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001460880908__l902ad79032f1473387936d1fce0d5dcf">Update the name of the publication on the publisher side.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__sdff0b53455b348eeb414529c6a2fd172"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">SET</span><span class="w"> </span><span class="n">PUBLICATION</span><span class="w"> </span><span class="n">publication_name</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...]</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001460880908__l2328b9a023324c99b1527d5a98fbc657"><p id="EN-US_TOPIC_0000001460880908__p188561449142516"><a name="EN-US_TOPIC_0000001460880908__l2328b9a023324c99b1527d5a98fbc657"></a><a name="l2328b9a023324c99b1527d5a98fbc657"></a>Enable a subscription.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__s5c5a8f5ff1464915bb8672748b9f2289"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="n">ENABLE</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001460880908__li6840836155414"><p id="EN-US_TOPIC_0000001460880908__p084013675414"><a name="EN-US_TOPIC_0000001460880908__li6840836155414"></a><a name="li6840836155414"></a>Disable a subscription.</p>
<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__screen148401736165415"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="n">DISABLE</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001460880908__l22abade4313c4daf83f3e4f761ce0fbd">Set subscription parameters.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__s7eba3cc08b8b418286729d633112367b"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">SET</span><span class="w"> </span><span class="p">(</span><span class="w"> </span><span class="n">subscription_parameter</span><span class="w"> </span><span class="p">[</span><span class="o">=</span><span class="w"> </span><span class="n">value</span><span class="p">]</span><span class="w"> </span><span class="p">[,</span><span class="w"> </span><span class="p">...</span><span class="w"> </span><span class="p">]</span><span class="w"> </span><span class="p">)</span>
</pre></div></td></tr></table></div>
</div>
</li><li id="EN-US_TOPIC_0000001460880908__lc1ad4a77c809441fa995be048343b24c">Change the subscription owner.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__sc1e494c759e149868dde3be30d0b2e96"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">OWNER</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_owner</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
</div>
<ul id="EN-US_TOPIC_0000001460880908__ul174377201539"><li id="EN-US_TOPIC_0000001460880908__li1437192045311">Rename the subscription.<div class="codecoloring" codetype="Sql" id="EN-US_TOPIC_0000001460880908__screen1629214428263"><div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span class="normal">1</span></pre></div></td><td class="code"><div><pre><span></span><span class="k">ALTER</span><span class="w"> </span><span class="n">SUBSCRIPTION</span><span class="w"> </span><span class="n">name</span><span class="w"> </span><span class="k">RENAME</span><span class="w"> </span><span class="k">TO</span><span class="w"> </span><span class="n">new_name</span>
</pre></div></td></tr></table></div>
</div>
</li></ul>
<div class="section" id="EN-US_TOPIC_0000001460880908__s4dd504151fa34b0cb75ad8ff975e1d7f"><h4 class="sectiontitle">Parameter Description</h4><ul id="EN-US_TOPIC_0000001460880908__uce6e8b3a80854100ac72c9f9f04f6a45"><li id="EN-US_TOPIC_0000001460880908__l0871fc3385d54be98452e84435aafc75"><strong id="EN-US_TOPIC_0000001460880908__b719454373014">name</strong><p id="EN-US_TOPIC_0000001460880908__afa6218e04cc94a2895b3509333098086">Specifies the name of the subscription you want to modify.</p>
<p id="EN-US_TOPIC_0000001460880908__a8d8ceee9db584d5199c9755947a557dd">Value range: A string. It must comply with the naming convention.</p>
</li><li id="EN-US_TOPIC_0000001460880908__lbba72815a2724c6498dafa4bcd22d783"><strong id="EN-US_TOPIC_0000001460880908__b11832535115014">CONNECTION 'conninfo'</strong><p id="EN-US_TOPIC_0000001460880908__a80fc1590e09140f4a4d876f94a851010">Alters the connection attributes initially set by <strong id="EN-US_TOPIC_0000001460880908__b122856135524647">CREATE SUBSCRIPTION</strong>.</p>
<p id="EN-US_TOPIC_0000001460880908__p9587195735013">For details about the parameters, see <a href="dws_06_0288.html#EN-US_TOPIC_0000001510520997__li17392131613264">conninfo</a> in the parameter description.</p>
</li><li id="EN-US_TOPIC_0000001460880908__li116410347586"><strong id="EN-US_TOPIC_0000001460880908__b1764103415588">publication_name</strong><p id="EN-US_TOPIC_0000001460880908__p664834135812">Specifies the name of a new publication.</p>
<p id="EN-US_TOPIC_0000001460880908__p14399545125912">Value range: A string. It must comply with the naming convention.</p>
</li><li id="EN-US_TOPIC_0000001460880908__li3651192005218"><strong id="EN-US_TOPIC_0000001460880908__b171662711528">ENABLE</strong><p id="EN-US_TOPIC_0000001460880908__p36511320105219">Enables a previously disabled subscription and starts logical replication at the end of a transaction.</p>
</li><li id="EN-US_TOPIC_0000001460880908__li17296353165514"><strong id="EN-US_TOPIC_0000001460880908__b11296453115514">DISABLE</strong><p id="EN-US_TOPIC_0000001460880908__p1729614531550">Disables a running subscription and stops logical replication at the end of a transaction.</p>
</li><li id="EN-US_TOPIC_0000001460880908__l1b3c3a1d30024252af23e6622a44cf0e"><strong id="EN-US_TOPIC_0000001460880908__ae77fb773f36e46779f43ed6d31de5f99">SET ( publication_parameter [= value] [, ... ] )</strong><p id="EN-US_TOPIC_0000001460880908__a6a972606a8f84d00b96200534c211842">Modifies the publication parameters initially set by <strong id="EN-US_TOPIC_0000001460880908__b123495872624647">CREATE PUBLICATION</strong>. For details about the parameters, see <a href="dws_06_0288.html#EN-US_TOPIC_0000001510520997__section1549681213574">Parameter description</a> of CREATE SUBSCRIPTION.</p>
</li><li id="EN-US_TOPIC_0000001460880908__l3eb8abf1d8294654a04e38315314a074"><strong id="EN-US_TOPIC_0000001460880908__a84f174c78574490897108924376f07e4">new_owner</strong><p id="EN-US_TOPIC_0000001460880908__a8ae31462851343808c6fbb253b2d485e">Specifies the name new subscription owner.</p>
</li><li id="EN-US_TOPIC_0000001460880908__l802fd9fadd614d468574f699b75ba825"><strong id="EN-US_TOPIC_0000001460880908__a298348d8ef084dd3bbe59eee56637fc7">new_name</strong><p id="EN-US_TOPIC_0000001460880908__a83a4e8fde85742b2868c2721e5ae6d22">Specifies the new name of the subscription.</p>
</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000001460880908__s7d7b3396e68c4011b95c1e02a254a932"><h4 class="sectiontitle">Examples</h4><div class="p" id="EN-US_TOPIC_0000001460880908__p123151371313">Modify subscription connection information.<pre class="screen" id="EN-US_TOPIC_0000001460880908__screen109329124468">ALTER SUBSCRIPTION mysub CONNECTION 'host=192.168.1.51 port=5432 user=foo dbname=foodb password=xxxx';</pre>
</div>
</div>
<div class="section" id="EN-US_TOPIC_0000001460880908__s727775a9b4004b4dbef41d0d3a428719"><h4 class="sectiontitle">Helpful Links</h4><p id="EN-US_TOPIC_0000001460880908__a88a3942f38cc47dbb84fd5eeefe6c115"><a href="dws_06_0288.html">CREATE SUBSCRIPTION</a>, <a href="dws_06_0289.html">DROP SUBSCRIPTION</a></p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="dws_06_0118.html">DDL Syntax</a></div>
</div>
</div>
View Git Blame Copy Permalink