跳转到主要内容
PUT
更新 ClickPipe 设置

授权

Authorization
string
header
必填

使用在 ClickHouse Cloud 控制台中获取的 key ID 和 key secret:https://clickhouse.com/docs/cloud/manage/openapi

路径参数

organizationId
string<uuid>
必填

拥有该服务的组织 ID。

serviceId
string<uuid>
必填

拥有该 ClickPipe 的服务 ID。

clickPipeId
string<uuid>
必填

要更新其设置的 ClickPipe ID。

请求体

application/json
clickhouse_max_download_threads
integer | null

最大下载线程数。最大并发下载线程数。

必填范围: 0 <= x <= 32
示例:

4

clickhouse_max_insert_threads
integer | null

最大插入线程数。最大并发插入线程数。

必填范围: 0 <= x <= 16
示例:

1

clickhouse_max_threads
integer | null

最大线程数。文件处理的最大并发线程数。

必填范围: 0 <= x <= 64
示例:

8

clickhouse_min_insert_block_size_bytes
integer | null

最小插入数据块大小(字节)。插入所需的数据块最小大小(以字节为单位)。

必填范围: 0 <= x <= 10737418240
示例:

1073741824

clickhouse_parallel_distributed_insert_select
integer | null

并行分布式 insert select。并行分布式 insert select 设置。

必填范围: 0 <= x <= 2
示例:

2

clickhouse_parallel_view_processing
boolean | null

并行视图处理。是否启用并发推送到已附加视图,而不是按顺序推送。

示例:

false

object_storage_concurrency
integer | null

对象存储并发度。并发文件处理线程数。

必填范围: 1 <= x <= 35
示例:

1

object_storage_max_file_count
integer | null

最大文件数。单个插入批次中可处理的最大文件数。

必填范围: 1 <= x <= 10000
示例:

100

object_storage_max_insert_bytes
integer | null

最大插入字节数。单个插入批次中处理的字节数。

必填范围: 10485760 <= x <= 53687091200
示例:

10737418240

object_storage_polling_interval_ms
integer | null

对象存储轮询时间间隔。配置连续摄取查询新对象存储数据的刷新时间间隔。

必填范围: 100 <= x <= 3600000
示例:

30000

object_storage_use_cluster_function
boolean | null

使用 cluster 函数。是否使用 ClickHouse cluster 函数进行分布式处理。

示例:

true

streaming_max_insert_wait_ms
integer | null

流式最大插入等待时间。配置将数据插入 ClickHouse 前的最长等待时间。

必填范围: 500 <= x <= 60000
示例:

5000

响应

成功响应

requestId
string<uuid>

分配给每个请求的唯一 ID。UUIDv4

result
object
status
number

HTTP 状态码。

示例:

200

最后修改于 2026年6月19日