AUTO: Sync ScalarDB docs in English to docs site repo

Author: josh-wong

docs/api-guide.mdx

@@ -1150,6 +1150,84 @@ Scan scanUsingSpecifiedNamespace =
         .build();
 ```
 
+##### Operation attributes
+
+The operation attribute is a key-value pair that can be used to store additional information about an operation. You can set operation attributes by using the `attribute()` or `attributes()` method in the operation builder, as shown below:
+
+```java
+// Set operation attributes in the `Get` operation.
+Get get = Get.newBuilder()
+    .namespace("ns")
+    .table("tbl")
+    .partitionKey(partitionKey)
+    .clusteringKey(clusteringKey)
+    .attribute("attribute1", "value1")
+    .attributes(ImmutableMap.of("attribute2", "value2", "attribute3", "value3"))
+    .build();
+
+// Set operation attributes in the `Scan` operation.
+Scan scan = Scan.newBuilder()
+    .namespace("ns")
+    .table("tbl")
+    .partitionKey(partitionKey)
+    .projections("c1", "c2", "c3", "c4")
+    .attribute("attribute1", "value1")
+    .attributes(ImmutableMap.of("attribute2", "value2", "attribute3", "value3"))
+    .build();
+
+// Set operation attributes in the `Insert` operation.
+Insert insert = Insert.newBuilder()
+    .namespace("ns")
+    .table("tbl")
+    .partitionKey(partitionKey)
+    .clusteringKey(clusteringKey)
+    .floatValue("c4", 1.23F)
+    .doubleValue("c5", 4.56)
+    .attribute("attribute1", "value1")
+    .attributes(ImmutableMap.of("attribute2", "value2", "attribute3", "value3"))
+    .build();
+
+// Set operation attributes in the `Upsert` operation.
+Upsert upsert = Upsert.newBuilder()
+    .namespace("ns")
+    .table("tbl")
+    .partitionKey(partitionKey)
+    .clusteringKey(clusteringKey)
+    .floatValue("c4", 1.23F)
+    .doubleValue("c5", 4.56)
+    .attribute("attribute1", "value1")
+    .attributes(ImmutableMap.of("attribute2", "value2", "attribute3", "value3"))
+    .build();
+
+// Set operation attributes in the `Update` operation.
+Update update = Update.newBuilder()
+    .namespace("ns")
+    .table("tbl")
+    .partitionKey(partitionKey)
+    .clusteringKey(clusteringKey)
+    .floatValue("c4", 1.23F)
+    .doubleValue("c5", 4.56)
+    .attribute("attribute1", "value1")
+    .attributes(ImmutableMap.of("attribute2", "value2", "attribute3", "value3"))
+    .build();
+
+// Set operation attributes in the `Delete` operation.
+Delete delete = Delete.newBuilder()
+    .namespace("ns")
+    .table("tbl")
+    .partitionKey(partitionKey)
+    .clusteringKey(clusteringKey)
+    .attribute("attribute1", "value1")
+    .attributes(ImmutableMap.of("attribute2", "value2", "attribute3", "value3"))
+    .build();
+```
+
+:::note
+
+ScalarDB currently has no available operation attributes.
+
+:::
+
 #### Commit a transaction
 
 After executing CRUD operations, you need to commit a transaction to finish it.

docs/scalardb-sql/grammar.mdx

@@ -604,6 +604,7 @@ SELECT projection [, projection] ...
   [WHERE and_predicates [OR and_predicates ...] | or_predicates [AND or_predicates ...]]
   [ORDER BY identifier [order] [, identifier [order]] ...]
   [LIMIT <limit>]
+  [WITH operation_attributes]
 
 projection: * | identifier [AS <alias>]
 join_specification: [INNER] JOIN [<namespace name>.]<table name> [AS <alias>] ON join_predicate [AND join_predicate] ... | {LEFT|RIGHT} [OUTER] JOIN [<namespace name>.]<table name> [AS <alias>] ON join_predicate [AND join_predicate] ...
@@ -614,6 +615,7 @@ predicate: identifier operator <literal> | identifier BETWEEN <literal> AND <lit
 identifier: [[<namespace name>.]<table name>.]<column name> | [alias.]<column name>
 operator: = | <> | != | > | >= | < | <=
 order: ASC | DESC
+operation_attributes: <operation attribute name>=<operation attribute value> [AND <operation attribute name>=<operation attribute value>] ...
 ```
 
 ##### Note
@@ -1084,6 +1086,9 @@ This command returns the following column:
 ```sql
 INSERT INTO [<namespace name>.]<table name> [(<column name> [, <column name>] ...)]
   VALUES (<literal> [, <literal>] ...) [, (<literal> [, <literal>] ...)] ...
+  [WITH operation_attributes]
+
+operation_attributes: <operation attribute name>=<operation attribute value> [AND <operation attribute name>=<operation attribute value>] ...
 ```
 
 - You must specify a full primary key in `INSERT`.
@@ -1154,6 +1159,9 @@ This command returns the following column:
 ```sql
 UPSERT INTO [<namespace name>.]<table name> [(<column name> [, <column name>] ...)]
   VALUES (<literal> [, <literal>] ...) [, (<literal> [, <literal>] ...)] ...
+  [WITH operation_attributes]
+
+operation_attributes: <operation attribute name>=<operation attribute value> [AND <operation attribute name>=<operation attribute value>] ...
 ```
 
 - You must specify a full primary key in `UPSERT`.
@@ -1233,12 +1241,14 @@ This command returns the following column:
 UPDATE [<namespace name>.]<table name> [AS <alias>]
   SET <column identifier> = <literal> [, <column identifier> = <literal>] ...
   [WHERE and_predicates [OR and_predicates ...] | or_predicates [AND or_predicates ...]]
+  [WITH operation_attributes]
 
 identifier: [[<namespace name>.]<table name>.]<column name> | [alias.]<column name>
 and_predicates: predicate | (predicate [AND predicate ...])
 or_predicates: predicate | (predicate [OR predicate ...])
 predicate: <identifier> operator <literal> | <identifier> BETWEEN <literal> AND <literal> | <identifier> [NOT] LIKE <pattern> [ESCAPE <escape character>] | <identifier> IS [NOT] NULL
 operator: = | <> | != | > | >= | < | <=
+operation_attributes: <operation attribute name>=<operation attribute value> [AND <operation attribute name>=<operation attribute value>] ...
 ```
 
 ##### Note
@@ -1460,12 +1470,14 @@ This command returns the following column:
 ```sql
 DELETE FROM [<namespace name>.]<table name> [AS <alias>]
   [WHERE and_predicates [OR and_predicates ...] | or_predicates [AND or_predicates ...]]
+  [WITH operation_attributes]
 
 identifier: [[<namespace name>.]<table name>.]<column name> | [alias.]<column name>
 and_predicates: predicate | (predicate [AND predicate ...])
 or_predicates: predicate | (predicate [OR predicate ...])
 predicate: <identifier> operator <literal> | <identifier> BETWEEN <literal> AND <literal> | <identifier> [NOT] LIKE <pattern> [ESCAPE <escape character>] | <identifier> IS [NOT] NULL
 operator: = | <> | != | > | >= | < | <=
+operation_attributes: <operation attribute name>=<operation attribute value> [AND <operation attribute name>=<operation attribute value>] ...
 ```
 
 ##### Note