Managed Service for ClickHouse API, gRPC: ClusterService.GetShardGroup
Returns the specified shard group.
gRPC request
rpc GetShardGroup (GetClusterShardGroupRequest) returns (ShardGroup)
GetClusterShardGroupRequest
{
"cluster_id": "string",
"shard_group_name": "string"
}
|
Field |
Description |
|
cluster_id |
string Required field. ID of the cluster that the shard group belongs to. The maximum string length in characters is 50. |
|
shard_group_name |
string Required field. Name of the shard group to request information about. The maximum string length in characters is 63. |
ShardGroup
{
"name": "string",
"cluster_id": "string",
"description": "string",
"shard_names": [
"string"
],
"external_shards": [
{
"name": "string",
"weight": "google.protobuf.Int64Value",
"replicas": [
{
"host": "string",
"port": "google.protobuf.Int64Value",
"secure": "google.protobuf.BoolValue",
"user": "string",
"password": "string",
"priority": "google.protobuf.Int64Value"
}
]
}
]
}
|
Field |
Description |
|
name |
string Name of the shard group. |
|
cluster_id |
string ID of the ClickHouse cluster that the shard group belongs to. |
|
description |
string Description of the shard group. 0-256 characters long. |
|
shard_names[] |
string List of shard names contained in the shard group. |
|
external_shards[] |
List of external shards contained in the shard group. |
ExternalShard
|
Field |
Description |
|
name |
string Name of the external shard. |
|
weight |
Relative weight of the external shard considered when writing data to the cluster. For details, see ClickHouse documentation. |
|
replicas[] |
List of replicas contained in the external shard. |
Replica
|
Field |
Description |
|
host |
string Name (FQDN) or IP address of the external replica host. |
|
port |
Port to connect to the external replica. If not specified, the default ClickHouse port is used. |
|
secure |
Whether to use a secure (SSL/TLS) connection when connecting to the external replica. |
|
user |
string Name of the user to authenticate with on the external replica. |
|
password |
string Password of the user to authenticate with on the external replica. |
|
priority |
Priority of the external replica for load balancing. |