taurusdb_umn

Reviewed-by: Székely, Ond <ond.szekely@t-systems.com>
Co-authored-by: wangdengke2 <wangdengke2@huawei.com>
Co-committed-by: wangdengke2 <wangdengke2@huawei.com>
This commit is contained in:
2025-08-12 12:28:51 +00:00
committed by zuul
parent a21b995e0a
commit c0bc4c43cf
6 changed files with 182 additions and 44 deletions

File diff suppressed because it is too large Load Diff

File diff suppressed because it is too large Load Diff

View File

@ -8,7 +8,17 @@
</th>
</tr>
</thead>
<tbody><tr id="change_history__row19841155983514"><td class="cellrowborder" valign="top" width="21.85%" headers="mcps1.3.1.1.3.1.1 "><p id="change_history__p17841659123514">2025-03-27</p>
<tbody><tr id="change_history__row1268101920448"><td class="cellrowborder" valign="top" width="21.85%" headers="mcps1.3.1.1.3.1.1 "><p id="change_history__p5936129124417">2025-07-07</p>
</td>
<td class="cellrowborder" valign="top" width="78.14999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="change_history__p5936112915448">Added <a href="en-us_topic_0000002347520144.html">Querying and Downloading Binlogs (OBT)</a>.</p>
</td>
</tr>
<tr id="change_history__row17683133114266"><td class="cellrowborder" valign="top" width="21.85%" headers="mcps1.3.1.1.3.1.1 "><p id="change_history__p16861540152616">2025-06-25</p>
</td>
<td class="cellrowborder" valign="top" width="78.14999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="change_history__p13665504268">Optimized the content in <a href="gaussdb_05_2265.html">Upgrading the Minor Version of a DB Instance</a>.</p>
</td>
</tr>
<tr id="change_history__row19841155983514"><td class="cellrowborder" valign="top" width="21.85%" headers="mcps1.3.1.1.3.1.1 "><p id="change_history__p17841659123514">2025-03-27</p>
</td>
<td class="cellrowborder" valign="top" width="78.14999999999999%" headers="mcps1.3.1.1.3.1.2 "><p id="change_history__p1771021210364">Renamed GaussDB(for MySQL) to TaurusDB.</p>
</td>

View File

@ -0,0 +1,27 @@
<a name="EN-US_TOPIC_0000002347520144"></a><a name="EN-US_TOPIC_0000002347520144"></a>
<h1 class="topictitle1">Querying and Downloading Binlogs (OBT)</h1>
<div id="body0000002347520144"><p id="EN-US_TOPIC_0000002347520144__p13784151094717">Binlogs record all DDL and DML statements (except data query statements). You can download binlogs to a local PC for further analysis.</p>
<p id="EN-US_TOPIC_0000002347520144__en-us_topic_0171122292_p46611462183014">This section describes how to enable binlog, and then query and download binlogs on the <span id="EN-US_TOPIC_0000002347520144__text17402105814518">TaurusDB</span> console.</p>
<div class="section" id="EN-US_TOPIC_0000002347520144__section117411722143912"><h4 class="sectiontitle">Billing</h4><p id="EN-US_TOPIC_0000002347520144__p9847711174510">Binlogs are stored in OBS buckets. </p>
</div>
<div class="section" id="EN-US_TOPIC_0000002347520144__section44231975207"><h4 class="sectiontitle">Prerequisites</h4><ul id="EN-US_TOPIC_0000002347520144__ul247711127205"><li id="EN-US_TOPIC_0000002347520144__li164771612132011">Binlog can only be enabled when the following conditions are met:<ul id="EN-US_TOPIC_0000002347520144__ul1184812116501"><li id="EN-US_TOPIC_0000002347520144__li17557101812503">If the kernel version of your DB instance is earlier than 2.0.45.230900, the value of <span class="parmname" id="EN-US_TOPIC_0000002347520144__parmname563819211912"><b>log-bin</b></span> must be <span class="parmvalue" id="EN-US_TOPIC_0000002347520144__parmvalue1263813211199"><b>ON</b></span>. To view and modify the parameter value, see <a href="gaussdb_08_0112.html">Modifying a Parameter Template</a>.</li><li id="EN-US_TOPIC_0000002347520144__li1561531455111">If the kernel version of your DB instance is 2.0.45.230900 or later, the value of <span class="parmname" id="EN-US_TOPIC_0000002347520144__parmname62371575204"><b>rds_global_sql_log_bin</b></span> must be <span class="parmvalue" id="EN-US_TOPIC_0000002347520144__parmvalue523715713205"><b>ON</b></span>.</li></ul>
</li><li id="EN-US_TOPIC_0000002347520144__li9860184614203">Before viewing and downloading binlogs, you need to enable binlog by referring to <a href="#EN-US_TOPIC_0000002347520144__section20209121620219">Enabling Binlog</a>.</li></ul>
</div>
<div class="section" id="EN-US_TOPIC_0000002347520144__section947302019218"><h4 class="sectiontitle">Constraints</h4><p id="EN-US_TOPIC_0000002347520144__p187971672915">To use binlogs, set the <span class="parmname" id="EN-US_TOPIC_0000002347520144__parmname101412248611"><b>log-bin</b></span> or <span class="parmname" id="EN-US_TOPIC_0000002347520144__parmname1412417323611"><b>rds_global_sql_log_bin</b></span> parameter to <span class="parmvalue" id="EN-US_TOPIC_0000002347520144__parmvalue12268124311617"><b>ON</b></span>. </p>
</div>
<div class="section" id="EN-US_TOPIC_0000002347520144__section20209121620219"><a name="EN-US_TOPIC_0000002347520144__section20209121620219"></a><a name="section20209121620219"></a><h4 class="sectiontitle">Enabling Binlog</h4><ol id="EN-US_TOPIC_0000002347520144__ol3935021104010"><li id="EN-US_TOPIC_0000002347520144__li427521291312"><span>Log in to the management console.</span></li><li id="EN-US_TOPIC_0000002347520144__li152751123137"><span>Click <span><img id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_image192529212293" src="en-us_image_0000001352219100.png"></span> in the upper left corner and select a region and a project.</span></li><li id="EN-US_TOPIC_0000002347520144__li112751012151319"><span>Click <strong id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_b1548312501622">Service List</strong>. Under <strong id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_b1748325012210">Databases</strong>, click <strong id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_b164831501625">TaurusDB</strong>.</span></li><li id="EN-US_TOPIC_0000002347520144__li169361121154016"><span>On the <strong id="EN-US_TOPIC_0000002347520144__b1863934213235">Instances</strong> page, click the instance name.</span></li><li id="EN-US_TOPIC_0000002347520144__li119369217408"><span>In the navigation pane, choose <span class="uicontrol" id="EN-US_TOPIC_0000002347520144__uicontrol9566746112313"><b>Logs</b></span>.</span></li><li id="EN-US_TOPIC_0000002347520144__li6936172117400"><span>Click the <strong id="EN-US_TOPIC_0000002347520144__b1467918264246">Binlog</strong> tab.</span></li><li id="EN-US_TOPIC_0000002347520144__li177865311411"><span>Click <span class="uicontrol" id="EN-US_TOPIC_0000002347520144__uicontrol174091154144115"><b>Configure Binlog</b></span>. In the displayed dialog box, enable <strong id="EN-US_TOPIC_0000002347520144__b137230082513">Binlog</strong> and set <strong id="EN-US_TOPIC_0000002347520144__b1535262115256">Retention Period</strong>.</span><p><div class="p" id="EN-US_TOPIC_0000002347520144__p477475163312"><ul id="EN-US_TOPIC_0000002347520144__ul3452224135510"><li id="EN-US_TOPIC_0000002347520144__li745222412557">The retention period ranges from 1 to 180 days.</li><li id="EN-US_TOPIC_0000002347520144__li0452424185513">After binlog is disabled, the generated logs will be automatically deleted after the retention period expires. Deleted logs cannot be restored. Exercise caution when disabling binlog.</li></ul>
</div>
</p></li></ol>
</div>
<div class="section" id="EN-US_TOPIC_0000002347520144__section1774413186187"><h4 class="sectiontitle">Querying and Downloading Binlogs</h4><ol id="EN-US_TOPIC_0000002347520144__ol4170163310185"><li id="EN-US_TOPIC_0000002347520144__li874617168431"><span>Log in to the management console.</span></li><li id="EN-US_TOPIC_0000002347520144__li57468163434"><span>Click <span><img id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_image192529212293_1" src="en-us_image_0000001352219100.png"></span> in the upper left corner and select a region and a project.</span></li><li id="EN-US_TOPIC_0000002347520144__li274691611439"><span>Click <strong id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_b1548312501622_1">Service List</strong>. Under <strong id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_b1748325012210_1">Databases</strong>, click <strong id="EN-US_TOPIC_0000002347520144__gaussdb_02_0004_b164831501625_1">TaurusDB</strong>.</span></li><li id="EN-US_TOPIC_0000002347520144__li334764218128"><span>On the <strong id="EN-US_TOPIC_0000002347520144__b295634193">Instances</strong> page, click the instance name.</span></li><li id="EN-US_TOPIC_0000002347520144__li83471423121"><span>In the navigation pane, choose <span class="uicontrol" id="EN-US_TOPIC_0000002347520144__uicontrol1805605256"><b>Logs</b></span>.</span></li><li id="EN-US_TOPIC_0000002347520144__li138476211192"><span>Click the <strong id="EN-US_TOPIC_0000002347520144__b141411629152410">Binlog</strong> tab.</span><p><ul id="EN-US_TOPIC_0000002347520144__ul4635151513504"><li id="EN-US_TOPIC_0000002347520144__li1663551545012">View binlogs generated in the last 15 minutes, last 30 minutes, last 1 hour, last 24 hours, last 7 days, last 30 days, or a custom time range.<p id="EN-US_TOPIC_0000002347520144__p1059142614818"><a name="EN-US_TOPIC_0000002347520144__li1663551545012"></a><a name="li1663551545012"></a></p>
</li><li id="EN-US_TOPIC_0000002347520144__li2635615155013">Click <strong id="EN-US_TOPIC_0000002347520144__b1775581350">Download</strong> in the <strong id="EN-US_TOPIC_0000002347520144__b35911115357">Operation</strong> column to download a binlog to a local PC.</li></ul>
</p></li></ol>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="gaussdb_03_0016.html">Logs</a></div>
</div>
</div>

View File

@ -12,6 +12,8 @@
</li>
<li class="ulchildlink"><strong><a href="gaussdb_03_0152.html">Enabling or Disabling SQL Explorer</a></strong><br>
</li>
<li class="ulchildlink"><strong><a href="en-us_topic_0000002347520144.html">Querying and Downloading Binlogs (OBT)</a></strong><br>
</li>
</ul>
<div class="familylinks">

View File

@ -1,11 +1,84 @@
<a name="gaussdb_05_2265"></a><a name="gaussdb_05_2265"></a>
<h1 class="topictitle1">Upgrading the Minor Version of a DB Instance</h1>
<div id="body0000001456725748"><div class="section" id="gaussdb_05_2265__section0297192412404"><h4 class="sectiontitle">Scenarios</h4><p id="gaussdb_05_2265__p9356731145518">You can manually upgrade minor versions of your instances to improve performance, add new functions, and fix bugs.</p>
<div id="body0000001456725748"><div class="section" id="gaussdb_05_2265__en-us_topic_0000001928567729_section0297192412404"><h4 class="sectiontitle">Scenarios</h4><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p9356731145518">You can upgrade the minor version of your DB instance to improve performance, optimize functions, and fix bugs.</p>
</div>
<div class="section" id="gaussdb_05_2265__section16560101913301"><h4 class="sectiontitle">Precautions</h4><ul id="gaussdb_05_2265__ul845382217301"><li id="gaussdb_05_2265__li13453192217308">The upgrade will cause the instance to reboot and interrupt services intermittently. To limit the impact of the upgrade, perform the upgrade during off-peak hours, or ensure that your applications support automatic reconnection.</li><li id="gaussdb_05_2265__li183371713154615">If an instance contains a large number of table partitions (more than 1 million), it may take more than 2 hours to reboot the instance.</li><li id="gaussdb_05_2265__li208281275913">If the primary node and read replicas of an instance are deployed in the same AZ, a minor version upgrade will trigger a failover. If they are in different AZs, a minor version upgrade will trigger two failovers. A failover means that the system fails over to a read replica in case the primary node is unavailable.</li><li id="gaussdb_05_2265__li393824419450">When you upgrade a minor version of an instance, minor versions of read replicas (if any) will also be upgraded automatically. Minor versions of read replicas cannot be upgraded separately. A minor version upgrade cannot be rolled back after the upgrade is complete.</li><li id="gaussdb_05_2265__li1136162113239">DDL operations, such as CREATE EVENT, DROP EVENT, and ALTER EVENT, are not allowed during a minor version upgrade.</li></ul>
<div class="section" id="gaussdb_05_2265__en-us_topic_0000001928567729_section1564311561348"><h4 class="sectiontitle">Upgrade Scenarios</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_05_2265__en-us_topic_0000001928567729_table15978105613484" frame="border" border="1" rules="all"><caption><b>Table 1 </b>Upgrade scenarios</caption><thead align="left"><tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row59781656124810"><th align="left" class="cellrowborder" valign="top" width="13.8%" id="mcps1.3.2.2.2.4.1.1"><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p3978115616480"><strong id="gaussdb_05_2265__b2086111404219">Upgrade Information</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="49.08%" id="mcps1.3.2.2.2.4.1.2"><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p99784569484"><strong id="gaussdb_05_2265__b17920135912139">Upgrade Scenario</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="37.12%" id="mcps1.3.2.2.2.4.1.3"><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p15788154385213"><strong id="gaussdb_05_2265__b115209340111216">Description</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row199781156184810"><td class="cellrowborder" valign="top" width="13.8%" headers="mcps1.3.2.2.2.4.1.1 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p109781356104811">Kernel version</p>
</td>
<td class="cellrowborder" valign="top" width="49.08%" headers="mcps1.3.2.2.2.4.1.2 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p17608141535016">There are three scenarios for upgrading a minor version based on different kernel versions:</p>
<ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul186081815155019"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li760813158500">Scenario 1: If the instance's kernel version is below 2.0.51.240305, it will be upgraded to 2.0.51.240305 first, followed by a minor version pre-upgrade and then a minor version upgrade.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li7608141510502">Scenario 2: If the instance's kernel version is 2.0.51.240305, it will undergo a minor version pre-upgrade first. After that, you need to click <strong id="gaussdb_05_2265__b783112453553">Upgrade</strong> again to start a minor version upgrade. <strong id="gaussdb_05_2265__b6114134362119">The following operations use this upgrade method as an example.</strong></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li16081615195012">Scenario 3: If the instance's kernel version is above 2.0.51.240305, clicking <strong id="gaussdb_05_2265__b15299202231">Upgrade</strong> will directly trigger a minor version upgrade.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.2.2.2.4.1.3 "><ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul9712183471417"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li107124341145">If the kernel version is 2.0.51.240305 or earlier, the upgrade involves changes to the underlying data dictionary and may take a long time.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li15194418192416">For scenario 2, binlog needs to be enabled before the upgrade. Ensure that the value of <strong id="gaussdb_05_2265__b4843181222718">rds_global_sql_log_bin</strong> is <strong id="gaussdb_05_2265__b133919157273">ON</strong>, the value of <strong id="gaussdb_05_2265__b197522519277">binlog_expire_logs_seconds</strong> is at least <strong id="gaussdb_05_2265__b1257020372274">86400</strong>, and the value of <strong id="gaussdb_05_2265__b9933244152717">default_collation_for_utf8mb4</strong> is <strong id="gaussdb_05_2265__b223574912715">utf8mb4_0900_ai_ci</strong>.</li></ul>
</td>
</tr>
<tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row997814565481"><td class="cellrowborder" valign="top" width="13.8%" headers="mcps1.3.2.2.2.4.1.1 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p497813565485">Upgrade time</p>
</td>
<td class="cellrowborder" valign="top" width="49.08%" headers="mcps1.3.2.2.2.4.1.2 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p28232347502">There are two ways to upgrade a minor version based on different upgrade times.</p>
<ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul282312348506"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1382343410500">Upon submission: The system upgrades the minor version immediately after your manual submission of the upgrade request on the <strong id="gaussdb_05_2265__b1163023191819">Basic Information</strong> page of the instance.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1982313414501">In maintenance window: The system upgrades the minor version during the maintenance window you have specified.</li></ul>
</td>
<td class="cellrowborder" valign="top" width="37.12%" headers="mcps1.3.2.2.2.4.1.3 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p9789243205218">If the kernel version of your instance has potential risks or major defects, has expired, or has been brought offline, the system will notify you by SMS message or email and deliver an upgrade task during the maintenance window.</p>
</td>
</tr>
</tbody>
</table>
</div>
<div class="section" id="gaussdb_05_2265__section2057112994214"><h4 class="sectiontitle">Procedure</h4><ol id="gaussdb_05_2265__ol6724161419271"><li id="gaussdb_05_2265__en-us_topic_0171122646_lbbb80ba312054cfca3a8b1e4c3d016fa"><span>Log in to the management console.</span></li><li id="gaussdb_05_2265__en-us_topic_0171122646_l541898ae0beb476b8d4ba4e68723bbe9"><span>Click <span><img id="gaussdb_05_2265__gaussdb_02_0004_image192529212293" src="en-us_image_0000001352219100.png"></span> in the upper left corner and select a region and a project.</span></li><li id="gaussdb_05_2265__en-us_topic_0171122646_li16913104111"><span>Click <strong id="gaussdb_05_2265__gaussdb_02_0004_b1548312501622">Service List</strong>. Under <strong id="gaussdb_05_2265__gaussdb_02_0004_b1748325012210">Databases</strong>, click <strong id="gaussdb_05_2265__gaussdb_02_0004_b164831501625">TaurusDB</strong>.</span></li><li id="gaussdb_05_2265__li61161897172844"><span>On the <strong id="gaussdb_05_2265__b1515555142215">Instances</strong> page, click the target instance to go to the <strong id="gaussdb_05_2265__b31558510226">Basic Information</strong> page.</span></li><li id="gaussdb_05_2265__li34958503397"><span>In the <span class="uicontrol" id="gaussdb_05_2265__uicontrol14836226104111"><b>DB Instance Information</b></span> area, click <strong id="gaussdb_05_2265__b198365265415">Upgrade</strong> in the <strong id="gaussdb_05_2265__b1283782674117">DB Engine Version</strong> field.</span></li><li id="gaussdb_05_2265__li36398892172958"><span>In the displayed dialog box, select a scheduled time and click <strong id="gaussdb_05_2265__b2991103064114">OK</strong>.</span><p><p id="gaussdb_05_2265__p16445141355211">Upon submission: The system upgrades the minor version immediately after your submission of the upgrade request. After the operation is complete, in the <strong id="gaussdb_05_2265__b19463113734119">Task Center</strong> page, click <strong id="gaussdb_05_2265__b74631137154112">Instant Tasks</strong> and view the information about the upgrade task.</p>
</div>
<div class="section" id="gaussdb_05_2265__en-us_topic_0000001928567729_section16560101913301"><h4 class="sectiontitle">Constraints</h4>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" id="gaussdb_05_2265__en-us_topic_0000001928567729_table6988522172013" frame="border" border="1" rules="all"><caption><b>Table 2 </b>Constraints</caption><thead align="left"><tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row4988132215205"><th align="left" class="cellrowborder" valign="top" width="14.17%" id="mcps1.3.3.2.2.3.1.1"><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p20988132211201"><strong id="gaussdb_05_2265__b144118576819">Phase</strong></p>
</th>
<th align="left" class="cellrowborder" valign="top" width="85.83%" id="mcps1.3.3.2.2.3.1.2"><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p198892212012"><strong id="gaussdb_05_2265__b335855919811">Constraint</strong></p>
</th>
</tr>
</thead>
<tbody><tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row199886225200"><td class="cellrowborder" valign="top" width="14.17%" headers="mcps1.3.3.2.2.3.1.1 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p109883223201">Before the upgrade</p>
</td>
<td class="cellrowborder" valign="top" width="85.83%" headers="mcps1.3.3.2.2.3.1.2 "><ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul17421335210"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li9415359218">To upgrade the kernel version from 2.0.51.240305 to 2.0.54.240600 or later, ensure that the value of <span class="parmname" id="gaussdb_05_2265__parmname8691711918"><b>rds_global_sql_log_bin</b></span> is <span class="parmvalue" id="gaussdb_05_2265__parmvalue970871494"><b>ON</b></span> and the value of <span class="parmname" id="gaussdb_05_2265__parmname20701679919"><b>binlog_expire_logs_seconds</b></span> is at least <span class="parmvalue" id="gaussdb_05_2265__parmvalue16701071299"><b>86400</b></span>. For details about how to set these parameters, see <a href="gaussdb_08_0112.html">Modifying a Parameter Template</a>.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li4998174111212">If the <strong id="gaussdb_05_2265__b4175443143619">rds_global_sql_log_bin</strong> parameter was recently set to <strong id="gaussdb_05_2265__b194165310378">ON</strong>, you need to connect to the database and run the following command to check whether binlog is enabled for all threads.<pre class="screen" id="gaussdb_05_2265__en-us_topic_0000001928567729_screen48101643121217">select @@session.rds_sql_log_bin_inconsistent_count;</pre>
</li></ul>
</td>
</tr>
<tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row298882217202"><td class="cellrowborder" valign="top" width="14.17%" headers="mcps1.3.3.2.2.3.1.1 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p898842215204">During the upgrade</p>
</td>
<td class="cellrowborder" valign="top" width="85.83%" headers="mcps1.3.3.2.2.3.1.2 "><ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul3485111432213"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li46281928141411">Scenario 1 or 3: If the primary node and read replicas of an instance are deployed in the same AZ, a minor version upgrade will trigger a failover. If they are in different AZs, a minor version upgrade will trigger two failovers. A failover means that the system fails over to a read replica in case the primary node is unavailable.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li192105198227">Scenario 1 or 3: The upgrade will cause the instance to reboot and briefly interrupt workloads for about 30 to 90 seconds. To minimize the impact of the upgrade, perform the upgrade during off-peak hours, or ensure that your applications support automatic reconnection.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1865917194143">Scenario 2: During the minor version pre-upgrade, the instance will not reboot, which means workloads will not be affected.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li5659161917147">Scenario 2: The minor version upgrade will cause the instance to reboot, so workloads will be interrupted. The upgrade takes 15 to 20 minutes, and workloads are intermittently interrupted for 1 to 2 minutes. To minimize the impact, perform the upgrade during off-peak hours.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li182103198229">If an instance contains a large number of table partitions (more than 1 million), it may take more than 2 hours to reboot the instance.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li13890125520224">When you upgrade the minor version of an instance, minor versions of read replicas (if any) will also be upgraded. During the upgrade, the read replicas will reboot. To minimize the impact, perform the upgrade during off-peak hours. Minor versions of read replicas cannot be upgraded separately. Once you upgrade the minor version, the instance will be upgraded to the latest minor version. A minor version upgrade cannot be rolled back after the upgrade is complete.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li25781312162312">DDL operations on events, such as CREATE EVENT, DROP EVENT, and ALTER EVENT, are not allowed during a minor version upgrade.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li14515165316548">If the message "Upgrade failed. Reduce the service load of the instance and click Retry" is displayed on the console, the upgrade fails due to heavy service load. Reduce the service load or retry the upgrade during off-peak hours.</li></ul>
</td>
</tr>
<tr id="gaussdb_05_2265__en-us_topic_0000001928567729_row19158965215"><td class="cellrowborder" valign="top" width="14.17%" headers="mcps1.3.3.2.2.3.1.1 "><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p131581364217">After the upgrade</p>
</td>
<td class="cellrowborder" valign="top" width="85.83%" headers="mcps1.3.3.2.2.3.1.2 "><ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul16524823122711"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li11301228192720">Scenario 2: If the upgrade fails, the instance will be rolled back to a previous version and its data will be restored to a new instance named <em id="gaussdb_05_2265__i32751617134919">original_instance_name</em><strong id="gaussdb_05_2265__b527513174497">_copy</strong>. The original instance will become unavailable after the rollback, and the new instance will start to incur charges once the original instance is deleted.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li73002862711">Data cannot be restored to a point in time when a data dictionary upgrade was in progress. By default, the system searches for the most recent available point in time instead.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1930142814275">During the period between a data dictionary upgrade and the next full backup, data of the instance cannot be restored to the original instance or an existing instance.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li730122818271">When restoring backups, ensure that the data dictionary version of the target instance is the same as that of the source instance.</li></ul>
</td>
</tr>
</tbody>
</table>
</div>
</div>
<div class="section" id="gaussdb_05_2265__en-us_topic_0000001928567729_section2059714272261"><h4 class="sectiontitle">Upgrading the Minor Version of a Single DB Instance</h4><ol id="gaussdb_05_2265__en-us_topic_0000001928567729_ol6724161419271"><li id="gaussdb_05_2265__en-us_topic_0171122646_lbbb80ba312054cfca3a8b1e4c3d016fa"><span>Log in to the management console.</span></li><li id="gaussdb_05_2265__en-us_topic_0171122646_l541898ae0beb476b8d4ba4e68723bbe9"><span>Click <span><img id="gaussdb_05_2265__gaussdb_02_0004_image192529212293" src="en-us_image_0000001352219100.png"></span> in the upper left corner and select a region and a project.</span></li><li id="gaussdb_05_2265__en-us_topic_0171122646_li16913104111"><span>Click <strong id="gaussdb_05_2265__gaussdb_02_0004_b1548312501622">Service List</strong>. Under <strong id="gaussdb_05_2265__gaussdb_02_0004_b1748325012210">Databases</strong>, click <strong id="gaussdb_05_2265__gaussdb_02_0004_b164831501625">TaurusDB</strong>.</span></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li61161897172844"><span>On the <strong id="gaussdb_05_2265__b179731439201916">Instances</strong> page, click the instance name to go to the <strong id="gaussdb_05_2265__b89730395197">Basic Information</strong> page.</span></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li34958503397"><span>In the <span class="uicontrol" id="gaussdb_05_2265__uicontrol1716513375514"><b>DB Instance Information</b></span> area, click <strong id="gaussdb_05_2265__b416603325518">Upgrade</strong> in the <span class="uicontrol" id="gaussdb_05_2265__uicontrol0166233185517"><b>Kernel Version</b></span> field.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p179869202517"></p>
<p id="gaussdb_05_2265__en-us_topic_0000001928567729_p68591661233">Alternatively, go to the <strong id="gaussdb_05_2265__b09661228142817">Instances</strong> page and click <strong id="gaussdb_05_2265__b101971513192913">Upgrade</strong> in the <strong id="gaussdb_05_2265__b16174101742910">DB Engine Version</strong> column.</p>
<p id="gaussdb_05_2265__en-us_topic_0000001928567729_p523973616267"></p>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li36398892172958"><span>In the displayed dialog box, set <strong id="gaussdb_05_2265__b123761642613">Scheduled Time</strong> and click <strong id="gaussdb_05_2265__b165561554554">OK</strong>.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p7962945142315"></p>
<ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul14619144685518"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1762064619556"><strong id="gaussdb_05_2265__b13804257133311">Upon submission</strong>: The system upgrades the minor version immediately after your submission of the upgrade request. On the <strong id="gaussdb_05_2265__b46411818619">Task Center</strong> page, click <strong id="gaussdb_05_2265__b196581812618">Instant Tasks</strong> and view the task progress.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1864085015516"><strong id="gaussdb_05_2265__b1847892903918">In maintenance window</strong>: The system upgrades the minor version during the maintenance window you have specified. After the operation is complete, go to the <strong id="gaussdb_05_2265__b1162317001218">Task Center</strong> page, click <strong id="gaussdb_05_2265__b4628502124">Scheduled Tasks</strong>, and view the upgrade task details.</li></ul>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li101963915012"><span>The system will automatically conduct a pre-upgrade check.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p1037114411508">In the displayed dialog box, read the message carefully and click <span class="uicontrol" id="gaussdb_05_2265__uicontrol372042361215"><b>OK</b></span> to proceed with the upgrade.</p>
<p id="gaussdb_05_2265__en-us_topic_0000001928567729_p16959185216212"></p>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1016224210457"><span>After the pre-upgrade is complete, the instance status becomes <span class="uicontrol" id="gaussdb_05_2265__uicontrol1474915340512"><b>Pre-upgrade completed</b></span>, which means no other operations are allowed. On the <strong id="gaussdb_05_2265__b2663734122319">Basic Information</strong> page, click <strong id="gaussdb_05_2265__b19663203472319">Upgrade</strong> in the <strong id="gaussdb_05_2265__b106632034162310">Kernel Version</strong> field again.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p72881241"></p>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li243314218248"><span>In the displayed dialog box, click <span class="uicontrol" id="gaussdb_05_2265__uicontrol111895428451"><b>OK</b></span>. The system will automatically conduct a pre-upgrade check.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p791114092615"></p>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li17558292000"><span>Confirm the check results and click <span class="uicontrol" id="gaussdb_05_2265__uicontrol460920291301"><b>OK</b></span>.</span></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1233224820542"><span>After the upgrade is complete, the instance status becomes <strong id="gaussdb_05_2265__b2332185514431">Kernel version upgrade to be confirmed</strong>, which means no other operations are allowed. To make the instance available again, go to the <strong id="gaussdb_05_2265__b1912318507247">Basic Information</strong> page and click <strong id="gaussdb_05_2265__b212315501249">Apply Upgrade</strong> in the <strong id="gaussdb_05_2265__b1712365052419">Kernel Version</strong> field.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p83541020151518"></p>
<p id="gaussdb_05_2265__en-us_topic_0000001928567729_p9306155117169"></p>
</p></li></ol>
</div>
<div class="section" id="gaussdb_05_2265__en-us_topic_0000001928567729_section29148367337"><h4 class="sectiontitle">Upgrading the Minor Versions of Multiple DB Instances at Once</h4><ol id="gaussdb_05_2265__en-us_topic_0000001928567729_ol1328783717913"><li id="gaussdb_05_2265__li11522141120433"><span>Log in to the management console.</span></li><li id="gaussdb_05_2265__li6522711134319"><span>Click <span><img id="gaussdb_05_2265__gaussdb_02_0004_image192529212293_1" src="en-us_image_0000001352219100.png"></span> in the upper left corner and select a region and a project.</span></li><li id="gaussdb_05_2265__li18522411184310"><span>Click <strong id="gaussdb_05_2265__gaussdb_02_0004_b1548312501622_1">Service List</strong>. Under <strong id="gaussdb_05_2265__gaussdb_02_0004_b1748325012210_1">Databases</strong>, click <strong id="gaussdb_05_2265__gaussdb_02_0004_b164831501625_1">TaurusDB</strong>.</span></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li3956349594"><span>On the <span class="uicontrol" id="gaussdb_05_2265__uicontrol495615491096"><b>Instances</b></span> page, select the desired DB instances and click <span class="uicontrol" id="gaussdb_05_2265__uicontrol176081643111217"><b>Upgrade</b></span> in the upper left corner of the list.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p1376214644814"></p>
<div class="notice" id="gaussdb_05_2265__en-us_topic_0000001928567729_note491814411576"><span class="noticetitle"><img src="public_sys-resources/notice_3.0-en-us.png"> </span><div class="noticebody"><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p15919641576">A maximum of 100 DB instances can be selected at once.</p>
</div></div>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li46561121139"><span>In the displayed dialog box, confirm the information about the DB instances to be upgraded and set <span class="uicontrol" id="gaussdb_05_2265__uicontrol147621131101517"><b>Scheduled Time</b></span>.</span><p><p id="gaussdb_05_2265__en-us_topic_0000001928567729_p1933175924819"></p>
<ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul18975421191613"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li1897512113162"><strong id="gaussdb_05_2265__b49756121312">Upon submission</strong>: The system upgrades the minor version immediately after your submission of the upgrade request. On the <strong id="gaussdb_05_2265__b330863364">Task Center</strong> page, click <strong id="gaussdb_05_2265__b172334897">Instant Tasks</strong> and view the task progress.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li3975132117166"><strong id="gaussdb_05_2265__b2049838643">In maintenance window</strong>: The system upgrades the minor version during the maintenance window you have specified. After the operation is complete, go to the <strong id="gaussdb_05_2265__b18896172181814">Task Center</strong> page, click <strong id="gaussdb_05_2265__b16896124186">Scheduled Tasks</strong>, and view the upgrade task details.</li></ul>
</p></li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li461011111165"><span>Confirm the information, enter <span class="uicontrol" id="gaussdb_05_2265__uicontrol2011011128176"><b>YES</b></span> in the text box as prompted, and click <span class="uicontrol" id="gaussdb_05_2265__uicontrol7700152510171"><b>OK</b></span>.</span><p><div class="caution" id="gaussdb_05_2265__en-us_topic_0000001928567729_note191898389815"><span class="cautiontitle"><img src="public_sys-resources/caution_3.0-en-us.png"> </span><div class="cautionbody"><ul id="gaussdb_05_2265__en-us_topic_0000001928567729_ul14406133513536"><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li13406835125311">Wait for 2 to 5 minutes and check whether the upgrade has been started for the DB instance. If the upgrade has not been started, check whether the value of <span class="parmname" id="gaussdb_05_2265__parmname7239175613550"><b>rds_global_sql_log_bin</b></span> is <span class="parmvalue" id="gaussdb_05_2265__parmvalue10334185912553"><b>ON</b></span> and the value of <span class="parmname" id="gaussdb_05_2265__parmname5634355613"><b>binlog_expire_logs_seconds</b></span> is at least <span class="uicontrol" id="gaussdb_05_2265__uicontrol16559955617"><b>86400</b></span>. If the parameters are not correctly configured, the upgrade cannot be performed.</li><li id="gaussdb_05_2265__en-us_topic_0000001928567729_li83541938195315">If the parameters are correctly configured but the upgrade has not started, it could be due to that the value of <span class="parmname" id="gaussdb_05_2265__parmname113601425115620"><b>rds_sql_log_bin_inconsistent_count</b></span> is not <span class="parmvalue" id="gaussdb_05_2265__parmvalue972212296563"><b>0</b></span>. Wait until this value becomes <span class="parmvalue" id="gaussdb_05_2265__parmvalue14261832161519"><b>0</b></span> before proceeding with the upgrade.</li></ul>
</div></div>
</p></li></ol>
</div>
</div>