Skip to content

Commit

Permalink
[Doc] Remove enable_async_write_back (backport #51793) (#51798)
Browse files Browse the repository at this point in the history
Signed-off-by: 絵空事スピリット <[email protected]>
Co-authored-by: 絵空事スピリット <[email protected]>
  • Loading branch information
mergify[bot] and EsoragotoSpirit authored Oct 12, 2024
1 parent 2f40172 commit 1164fc7
Show file tree
Hide file tree
Showing 3 changed files with 3 additions and 22 deletions.
9 changes: 1 addition & 8 deletions docs/en/_assets/commonMarkdown/sharedDataUse.md
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,7 @@ DISTRIBUTED BY HASH(recruit_date, region_num)
PROPERTIES (
"storage_volume" = "def_volume",
"datacache.enable" = "true",
"datacache.partition_duration" = "1 MONTH",
"enable_async_write_back" = "false"
"datacache.partition_duration" = "1 MONTH"
);
```

Expand Down Expand Up @@ -66,12 +65,6 @@ The validity duration of the hot data. When the local disk cache is enabled, all
>
> This property is available only when `datacache.enable` is set to `true`.
#### enable_async_write_back

Whether to allow data to be written into object storage asynchronously. Default: `false`.
- `true` When this property is set to `true`, the load task returns success as soon as the data is written into the local disk cache, and the data is written into the object storage asynchronously. This allows better loading performance, but it also risks data reliability under potential system failures.
- `false` (Default) When this property is set to `false`, the load task returns success only after the data is written into both object storage and the local disk cache. This guarantees higher availability but leads to lower loading performance.

### View table information

You can view the information of tables in a specific database using `SHOW PROC "/dbs/<db_id>"`. See [SHOW PROC](../../sql-reference/sql-statements/cluster-management/nodes_processes/SHOW_PROC.md) for more information.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -601,8 +601,7 @@ To [use your StarRocks Shared-data cluster](../../../deployment/shared_data/s3.m
PROPERTIES (
"storage_volume" = "<storage_volume_name>",
"datacache.enable" = "{ true | false }",
"datacache.partition_duration" = "<string_value>",
"enable_async_write_back" = "{ true | false }"
"datacache.partition_duration" = "<string_value>"
)
```

Expand All @@ -623,11 +622,6 @@ PROPERTIES (
>
> This property is available only when `datacache.enable` is set to `true`.

- `enable_async_write_back`: Whether to allow data to be written into object storage asynchronously. Default: `false`.

- When this property is set to `true`, the load task returns success as soon as the data is written into the local disk cache, and the data is written into the object storage asynchronously. This allows better loading performance, but it also risks data reliability under potential system failures.
- When this property is set to `false`, the load task returns success only after the data is written into both object storage and the local disk cache. This guarantees higher availability but leads to lower loading performance.

## Examples

### Create an Aggregate table that uses Hash bucketing and columnar storage
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -709,8 +709,7 @@ PROPERTIES (
PROPERTIES (
"storage_volume" = "<storage_volume_name>",
"datacache.enable" = "{ true | false }",
"datacache.partition_duration" = "<string_value>",
"enable_async_write_back" = "{ true | false }"
"datacache.partition_duration" = "<string_value>"
)
```

Expand All @@ -731,11 +730,6 @@ PROPERTIES (
>
> 仅当 `datacache.enable` 设置为 `true` 时,此属性可用。

* `enable_async_write_back`:是否允许数据异步写入对象存储。默认值:`false`

* 当该属性设置为 `true` 时,导入任务在数据写入本地磁盘缓存后立即返回成功,数据将异步写入对象存储。允许数据异步写入可以提升导入性能,但如果系统发生故障,可能会存在一定的数据可靠性风险。
* 当该属性设置为 `false` 时,只有在数据同时写入对象存储和本地磁盘缓存后,导入任务才会返回成功。禁用数据异步写入保证了更高的可用性,但会导致较低的导入性能。

## 示例

### 创建 Hash 分桶表并根据 key 列对数据进行聚合
Expand Down

0 comments on commit 1164fc7

Please sign in to comment.