From 484189209e65bb81341496aabc9ba53ac23dec9a Mon Sep 17 00:00:00 2001
From: guochao <guochao76@h-partners.com>
Date: Sat, 6 Sep 2025 15:50:16 +0800
Subject: [PATCH] =?UTF-8?q?=E5=88=A0=E9=99=A4=E9=9D=9E=E9=9C=80=E6=B1=82?=
 =?UTF-8?q?=E7=9A=841.2=E6=8E=A5=E5=8F=A3=20Signed-off-by:=20guochao=20<gu?=
 =?UTF-8?q?ochao76@h-partners.com>?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 api/@ohos.data.relationalStore.d.ts | 151 +++++++++-------------------
 1 file changed, 47 insertions(+), 104 deletions(-)

diff --git a/api/@ohos.data.relationalStore.d.ts b/api/@ohos.data.relationalStore.d.ts
index 411cf626b8..bcfb9d97c0 100644
--- a/api/@ohos.data.relationalStore.d.ts
+++ b/api/@ohos.data.relationalStore.d.ts
@@ -268,8 +268,7 @@ declare namespace relationalStore {
    *
    * @typedef { long | string } PRIKeyType
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'10', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   type PRIKeyType = long | string;
 
@@ -278,8 +277,7 @@ declare namespace relationalStore {
    *
    * @typedef { Date } UTCTime
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'10', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   type UTCTime = Date;
 
@@ -288,8 +286,7 @@ declare namespace relationalStore {
    *
    * @typedef { Map<PRIKeyType, UTCTime> } ModifyTime
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'10', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   type ModifyTime = Map<PRIKeyType, UTCTime>;
 
@@ -1138,7 +1135,6 @@ declare namespace relationalStore {
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
    * @crossplatform
    * @since 20
-   * @arkts 1.1&1.2
    */
   interface SqlExecutionInfo {
     /**
@@ -1155,7 +1151,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     sql: Array<string>;
 
@@ -1173,7 +1168,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     totalTime: long;
 
@@ -1191,7 +1185,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     waitTime: long;
 
@@ -1209,7 +1202,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     prepareTime: long;
 
@@ -1227,7 +1219,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     executeTime: long;
   }
@@ -1239,7 +1230,6 @@ declare namespace relationalStore {
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
    * @crossplatform
    * @since 20
-   * @arkts 1.1&1.2
    */
   interface ExceptionMessage {
     /**
@@ -1249,7 +1239,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     code: int;
 
@@ -1260,7 +1249,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     message: string;
 
@@ -1271,7 +1259,6 @@ declare namespace relationalStore {
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
      * @since 20
-     * @arkts 1.1&1.2
      */
     sql: string;
   }
@@ -1366,16 +1353,14 @@ declare namespace relationalStore {
    *
    * @enum { int }
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'9', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 9
    */
   enum SyncMode {
     /**
      * Indicates the data is pushed to remote device from local device.
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'9', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 9
      */
     SYNC_MODE_PUSH = 0,
 
@@ -1383,8 +1368,7 @@ declare namespace relationalStore {
      * Indicates the data is pulled from remote device to local device.
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'9', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 9
      */
     SYNC_MODE_PULL = 1,
 
@@ -1392,8 +1376,7 @@ declare namespace relationalStore {
      * Indicates the data is pulled from remote device to local device.
      *
      * @syscap SystemCapability.DistributedDataManager.CloudSync.Client
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     SYNC_MODE_TIME_FIRST,
 
@@ -1401,8 +1384,7 @@ declare namespace relationalStore {
      * Indicates force push the native data to the cloud.
      *
      * @syscap SystemCapability.DistributedDataManager.CloudSync.Client
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     SYNC_MODE_NATIVE_FIRST,
 
@@ -1410,8 +1392,7 @@ declare namespace relationalStore {
      * Indicates the data is pulled from cloud to local device.
      *
      * @syscap SystemCapability.DistributedDataManager.CloudSync.Client
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     SYNC_MODE_CLOUD_FIRST
   }
@@ -1421,16 +1402,14 @@ declare namespace relationalStore {
    *
    * @enum { int }
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'9', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 9
    */
   enum SubscribeType {
     /**
      * Subscription to remote data changes
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'9', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 9
      */
     SUBSCRIBE_TYPE_REMOTE = 0,
 
@@ -1445,8 +1424,7 @@ declare namespace relationalStore {
      * Subscription to cloud data changes
      *
      * @syscap SystemCapability.DistributedDataManager.CloudSync.Client
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     SUBSCRIBE_TYPE_CLOUD,
 
@@ -1461,8 +1439,7 @@ declare namespace relationalStore {
      * Subscription to cloud data changes details
      *
      * @syscap SystemCapability.DistributedDataManager.CloudSync.Client
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     SUBSCRIBE_TYPE_CLOUD_DETAILS,
 
@@ -1470,8 +1447,7 @@ declare namespace relationalStore {
      * Subscription to local data changes details
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     SUBSCRIBE_TYPE_LOCAL_DETAILS
   }
@@ -1481,8 +1457,7 @@ declare namespace relationalStore {
    *
    * @enum { int }
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'10', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   enum ChangeType {
     /**
@@ -1496,8 +1471,7 @@ declare namespace relationalStore {
      * Means the change type is data change.
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     DATA_CHANGE,
 
@@ -1512,8 +1486,7 @@ declare namespace relationalStore {
      * Means the change type is asset change.
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     ASSET_CHANGE
   }
@@ -1523,8 +1496,7 @@ declare namespace relationalStore {
    *
    * @interface ChangeInfo
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-   * @since arkts {'1.1':'10', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 10
    */
   interface ChangeInfo {
     /**
@@ -1532,8 +1504,7 @@ declare namespace relationalStore {
      *
      * @type { string }
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     table: string;
 
@@ -1542,8 +1513,7 @@ declare namespace relationalStore {
      *
      * @type { ChangeType }
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     type: ChangeType;
 
@@ -1553,8 +1523,7 @@ declare namespace relationalStore {
      *
      * @type { Array<string> | Array<long> }
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     inserted: Array<string> | Array<long>;
 
@@ -1564,8 +1533,7 @@ declare namespace relationalStore {
      *
      * @type { Array<string> | Array<long> }
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     updated: Array<string> | Array<long>;
 
@@ -1575,8 +1543,7 @@ declare namespace relationalStore {
      *
      * @type { Array<string> | Array<long> }
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'10', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 10
      */
     deleted: Array<string> | Array<long>;
   }
@@ -2074,8 +2041,7 @@ declare namespace relationalStore {
    * @enum { int }
    * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
    * @crossplatform
-   * @since arkts {'1.1':'18', '1.2':'20'}
-   * @arkts 1.1&1.2
+   * @since 18
    */
   enum ColumnType {
     /**
@@ -2083,8 +2049,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     NULL,
 
@@ -2095,8 +2060,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     INTEGER,
 
@@ -2105,8 +2069,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     REAL,
 
@@ -2115,8 +2078,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     TEXT,
 
@@ -2125,8 +2087,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     BLOB,
 
@@ -2135,8 +2096,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     ASSET,
 
@@ -2145,8 +2105,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     ASSETS,
 
@@ -2155,8 +2114,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     FLOAT_VECTOR,
 
@@ -2165,8 +2123,7 @@ declare namespace relationalStore {
      *
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     UNLIMITED_INT,
   }
@@ -3393,8 +3350,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     getColumnType(columnIdentifier: int | string): Promise<ColumnType>;
 
@@ -3428,8 +3384,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     getColumnTypeSync(columnIdentifier: int | string): ColumnType;
 
@@ -4394,8 +4349,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800033 - SQLite: Data type mismatch.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     getRows(maxCount: int, position?: int): Promise<Array<ValuesBucket>>;
 
@@ -5091,8 +5045,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800047 - The WAL file size exceeds the default limit.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     batchInsertWithConflictResolution(table: string, values: Array<ValuesBucket>, conflict: ConflictResolution): Promise<long>;
 
@@ -5128,8 +5081,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800047 - The WAL file size exceeds the default limit.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     batchInsertWithConflictResolutionSync(table: string, values: Array<ValuesBucket>, conflict: ConflictResolution): long;
 
@@ -6347,8 +6299,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800033 - SQLite: Data type mismatch.
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     getModifyTime(table: string, columnName: string, primaryKeys: PRIKeyType[]): Promise<ModifyTime>;
 
@@ -6561,8 +6512,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800033 - SQLite: Data type mismatch.
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.CloudSync.Client
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     cleanDirtyData(table: string, cursor?: long): Promise<void>;
 
@@ -7800,8 +7750,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800000 - Inner error.
      * @throws { BusinessError } 14800014 - The RdbStore or ResultSet is already closed.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     sync(mode: SyncMode, predicates: RdbPredicates): Promise<Array<[string, int]>>;
 
@@ -8559,8 +8508,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800033 - SQLite: Data type mismatch.
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     attach(fullPath: string, attachName: string, waitTime?: long) : Promise<int>;
 
@@ -8600,8 +8548,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800033 - SQLite: Data type mismatch.
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     attach(context: Context, config: StoreConfig, attachName: string, waitTime?: long) : Promise<int>;
 
@@ -8633,8 +8580,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800033 - SQLite: Data type mismatch.
      * @throws { BusinessError } 14800034 - SQLite: Library used incorrectly.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     detach(attachName: string, waitTime?: long) : Promise<int>;
 
@@ -8748,8 +8694,7 @@ declare namespace relationalStore {
      * application which is not a system application uses system API.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @systemapi
-     * @since arkts {'1.1':'12', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 12
      */
     lockCloudContainer(): Promise<int>;
 
@@ -9051,8 +8996,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800047 - The WAL file size exceeds the default limit.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     batchInsertWithConflictResolution(table: string, values: Array<ValuesBucket>, conflict: ConflictResolution): Promise<long>;
 
@@ -9086,8 +9030,7 @@ declare namespace relationalStore {
      * @throws { BusinessError } 14800047 - The WAL file size exceeds the default limit.
      * @syscap SystemCapability.DistributedDataManager.RelationalStore.Core
      * @crossplatform
-     * @since arkts {'1.1':'18', '1.2':'20'}
-     * @arkts 1.1&1.2
+     * @since 18
      */
     batchInsertWithConflictResolutionSync(table: string, values: Array<ValuesBucket>, conflict: ConflictResolution): long;
 
-- 
Gitee