Skip to main content

clickhouse_nodes

Creates, updates, deletes, gets or lists a clickhouse_nodes resource.

Overview​

Nameclickhouse_nodes
TypeResource
Idovh.cloud_database.clickhouse_nodes

Fields​

The following fields are returned by SELECT queries:

successful operation

NameDatatypeDescription
idstring (uuid)Node ID
namestringName of the node
created_atstring (date-time)Date of the creation of the node (wire: createdAt)
flavorstringFlavor of the node
portintegerConnection port for the node
regionstringRegion of the node
rolestringRole of the node (ANALYTICS, STANDARD)
statusstringCurrent status of the node (CREATING, DELETING, DRAINED, ERROR, LOCKED, LOCKED_PENDING, LOCKED_UPDATING, PENDING, READY, SHELVED, TO_DRAIN, UPDATING)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselectcluster_id, node_id, service_nameGet clickhouse nodes
listselectcluster_id, service_namex_pagination_modeList nodes of the clickhouse

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
api_hoststringThe OVHcloud API host. Selected by OVH_ENDPOINT (ovh-eu, ovh-ca or ovh-us; default ovh-eu). (default: api.eu.ovhcloud.com, x-stackQL-envVarSelector: {"envVar":"OVH_ENDPOINT","default":"ovh-eu","values":{"ovh-eu":"api.eu.ovhcloud.com","ovh-ca":"api.ca.ovhcloud.com","ovh-us":"api.us.ovhcloud.com"}})
cluster_idstring (uuid)Cluster ID (wire: clusterId)
node_idstring (uuid)Node ID (wire: nodeId)
service_namestringThe Public Cloud project ID. Resolved from OVH_CLOUD_PROJECT_SERVICE when set.
x_pagination_modestringSent as CachedObjectList-Pages by default so the list returns the full objects rather than their identifiers. (wire: X-Pagination-Mode)

SELECT examples​

Get clickhouse nodes

SELECT
id,
name,
created_at,
flavor,
port,
region,
role,
status
FROM ovh.cloud_database.clickhouse_nodes
WHERE cluster_id = '{{ cluster_id }}' -- required
AND node_id = '{{ node_id }}' -- required
AND service_name = '{{ service_name }}' -- required unless OVH_CLOUD_PROJECT_SERVICE is set
;