Connect to a ClickHouse database
Integrate ClickHouse into the workflow. Query and insert data, manage databases and tables, inspect schemas, monitor mutations and running queries, manage partitions, and execute raw SQL over the ClickHouse HTTP interface.
Execute a SELECT query on a ClickHouse database
| パラメータ | 型 | 必須 | 説明 |
|---|
host | string | はい | ClickHouse server hostname (e.g., your-instance.clickhouse.cloud) |
port | number | はい | ClickHouse HTTP interface port (8443 for HTTPS, 8123 for HTTP) |
database | string | はい | Database name to connect to |
username | string | はい | ClickHouse username |
password | string | いいえ | ClickHouse password |
secure | boolean | いいえ | Use a secure HTTPS connection (default: true) |
query | string | はい | SQL SELECT query to execute |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
rows | array | Array of rows returned from the query |
rowCount | number | Number of rows returned |
Execute raw SQL (DDL, mutations, or queries) on a ClickHouse database
| パラメータ | 型 | 必須 | 説明 |
|---|
host | string | はい | ClickHouse server hostname (e.g., your-instance.clickhouse.cloud) |
port | number | はい | ClickHouse HTTP interface port (8443 for HTTPS, 8123 for HTTP) |
database | string | はい | Database name to connect to |
username | string | はい | ClickHouse username |
password | string | いいえ | ClickHouse password |
secure | boolean | いいえ | Use a secure HTTPS connection (default: true) |
query | string | はい | Raw SQL statement to execute |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
rows | array | Array of rows returned from the statement |
rowCount | number | Number of rows returned or affected |
Insert a row into a ClickHouse table
| パラメータ | 型 | 必須 | 説明 |
|---|
host | string | はい | ClickHouse server hostname (e.g., your-instance.clickhouse.cloud) |
port | number | はい | ClickHouse HTTP interface port (8443 for HTTPS, 8123 for HTTP) |
database | string | はい | Database name to connect to |
username | string | はい | ClickHouse username |
password | string | いいえ | ClickHouse password |
secure | boolean | いいえ | Use a secure HTTPS connection (default: true) |
table | string | はい | Table name to insert data into |
data | object | はい | Data object to insert (key-value pairs mapping column names to values) |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
rows | array | Inserted rows (empty for ClickHouse inserts) |
rowCount | number | Number of rows inserted |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
Update rows in a ClickHouse table via an ALTER TABLE ... UPDATE mutation
| パラメータ | 型 | 必須 | 説明 |
|---|
host | string | はい | ClickHouse server hostname (e.g., your-instance.clickhouse.cloud) |
port | number | はい | ClickHouse HTTP interface port (8443 for HTTPS, 8123 for HTTP) |
database | string | はい | Database name to connect to |
username | string | はい | ClickHouse username |
password | string | いいえ | ClickHouse password |
secure | boolean | いいえ | Use a secure HTTPS connection (default: true) |
table | string | はい | Table name to update data in |
data | object | はい | Data object with fields to update (key-value pairs) |
where | string | はい | WHERE clause condition (without the WHERE keyword) |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
rows | array | Updated rows (empty for ClickHouse mutations) |
rowCount | number | Number of rows written by the mutation |
Delete rows from a ClickHouse table via an ALTER TABLE ... DELETE mutation
| パラメータ | 型 | 必須 | 説明 |
|---|
host | string | はい | ClickHouse server hostname (e.g., your-instance.clickhouse.cloud) |
port | number | はい | ClickHouse HTTP interface port (8443 for HTTPS, 8123 for HTTP) |
database | string | はい | Database name to connect to |
username | string | はい | ClickHouse username |
password | string | いいえ | ClickHouse password |
secure | boolean | いいえ | Use a secure HTTPS connection (default: true) |
table | string | はい | Table name to delete data from |
where | string | はい | WHERE clause condition (without the WHERE keyword) |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
rows | array | Deleted rows (empty for ClickHouse mutations) |
rowCount | number | Number of rows affected by the mutation |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
Introspect a ClickHouse database to retrieve table structures, columns, and engines
| パラメータ | 型 | 必須 | 説明 |
|---|
host | string | はい | ClickHouse server hostname (e.g., your-instance.clickhouse.cloud) |
port | number | はい | ClickHouse HTTP interface port (8443 for HTTPS, 8123 for HTTP) |
database | string | はい | Database name to introspect |
username | string | はい | ClickHouse username |
password | string | いいえ | ClickHouse password |
secure | boolean | いいえ | Use a secure HTTPS connection (default: true) |
| パラメータ | 型 | 説明 |
|---|
message | string | Operation status message |
tables | array | Array of table schemas with columns and engines |
↳ name | string | Table name |
↳ database | string | Database the table belongs to |
↳ engine | string | Table engine (e.g., MergeTree, Log) |
↳ totalRows | number | Approximate total number of rows in the table |
↳ columns | array | Table columns |
↳ name | string | Column name |
↳ type | string | ClickHouse data type (e.g., UInt32, String, DateTime) |
↳ defaultKind | string | Kind of default expression (DEFAULT, MATERIALIZED, ALIAS) |
↳ defaultExpression | string | Default value expression for the column |
↳ isInPrimaryKey | boolean | Whether the column is part of the primary key |
↳ isInSortingKey | boolean | Whether the column is part of the sorting key |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |
| パラメータ | 型 | 説明 |
|---|
message | string | Success or error message describing the operation outcome |
rows | array | Array of rows returned from the operation |
rowCount | number | Number of rows returned or affected by the operation |
count | number | Row count (count rows operation) |
ddl | string | CREATE TABLE statement (show create table operation) |
tables | array | Array of table schemas with columns and engines (introspect operation) |