API de ClickHouse Cloud

La API de ClickHouse Cloud es una API REST diseñada para que los desarrolladores administren fácilmente organizaciones y servicios en ClickHouse Cloud. Con nuestra API de Cloud, puede crear y administrar servicios, aprovisionar claves API y agregar o eliminar miembros de su organización, entre otras cosas.

Aprenda a crear su primera clave API y comience a usar la API de ClickHouse Cloud.

La API de ClickHouse Cloud se basa en la especificación OpenAPI de código abierto para permitir un consumo predecible desde el cliente. Si necesita acceder mediante programación a la documentación de la API de ClickHouse Cloud, ofrecemos un endpoint de Swagger basado en JSON en https://api.clickhouse.cloud/v1. También puede encontrar la documentación de la API en la Swagger UI.

Los desarrolladores pueden tener hasta 100 claves de API por organización. Cada clave de API tiene un límite de 10 solicitudes por cada ventana de 10 segundos. Si deseas aumentar la cantidad de claves de API o de solicitudes por cada ventana de 10 segundos para tu organización, ponte en contacto con support@clickhouse.com

El proveedor oficial de Terraform de ClickHouse te permite usar infraestructura como código para crear configuraciones predecibles y controladas por versiones, lo que hace que las implementaciones sean mucho menos propensas a errores.

Puedes consultar la documentación del proveedor de Terraform en el registro de Terraform.

Si quieres contribuir al proveedor de Terraform de ClickHouse, puedes consultar el código fuente en el repositorio de GitHub.

ClickHouse mantiene dos proveedores oficiales de Terraform: el proveedor de ClickHouse Cloud para la infraestructura en la nube y el proveedor de DBops para objetos a nivel de base de datos. Ambos siguen el mismo modelo de lanzamiento.

Cada lanzamiento es una única compilación que contiene todos los recursos. Los recursos de funcionalidades que aún no han alcanzado la disponibilidad general se distribuyen junto con los de GA, marcados como beta; no hay una compilación independiente ni es necesario fijar nada para usarlos.

Un recurso beta se identifica en dos lugares:

• Durante el plan y la aplicación, mediante una advertencia Beta Resource. Terraform nunca falla por advertencias, por lo que la ejecución continúa con normalidad.
• En su documentación, con un aviso que indica "Este recurso está en beta".

Beta significa que el schema y el comportamiento pueden cambiar en una futura versión del provider. Todo lo que no tenga este marcador es GA y está cubierto por las garantías de compatibilidad habituales.

Ambos proveedores usan versionado semántico (MAJOR.MINOR.PATCH). La versión principal se incrementa para cambios incompatibles, la versión secundaria para nuevas características o recursos, y la versión de parche para correcciones de errores. Los lanzamientos se publican según sea necesario, en lugar de seguir un calendario fijo.

Las versiones con el sufijo -alphaN (p. ej., 3.15.0-alpha3) son anteriores al modelo de compilación única. Siguen estando disponibles, pero ya no se generan.

Cuando una funcionalidad alcanza la disponibilidad general, su recurso deja de incluir el marcador beta en el siguiente lanzamiento del proveedor: deja de mostrarse la advertencia durante el plan y se elimina la nota destacada de la documentación. No cambia nada más: no se modifica la configuración, no hay migración de estado ni cambios entre compilaciones.

La cantidad de réplicas con la que se creará cada servicio es, de forma predeterminada, de 3 para los niveles Scale y Enterprise, mientras que para el nivel Basic es de 1. En los niveles Scale y Enterprise, es posible ajustarla pasando un campo numReplicas en la solicitud de creación del servicio. El valor del campo numReplicas debe estar entre 2 y 20 para el primer servicio de un warehouse. Los servicios que se crean en un warehouse existente pueden tener un número de réplicas de tan solo 1.

Le recomendamos visitar primero nuestro canal de Slack para obtener ayuda rápidamente. Si desea ayuda adicional o más información sobre nuestra API y sus funcionalidades, póngase en contacto con el soporte de ClickHouse en https://console.clickhouse.cloud/support