https://github.com/metrico/clickhouse-node-url-engine
Example NodeJS URL Engine for Clickhouse
https://github.com/metrico/clickhouse-node-url-engine
clickhouse example insert node select server url-engine
Last synced: 10 months ago
JSON representation
Example NodeJS URL Engine for Clickhouse
- Host: GitHub
- URL: https://github.com/metrico/clickhouse-node-url-engine
- Owner: metrico
- License: mit
- Created: 2022-02-19T22:27:53.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2022-02-21T10:02:09.000Z (almost 4 years ago)
- Last Synced: 2025-03-26T12:51:09.693Z (10 months ago)
- Topics: clickhouse, example, insert, node, select, server, url-engine
- Language: JavaScript
- Homepage:
- Size: 18.6 KB
- Stars: 6
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ClickHouse NodeJS URL Engine
This basic example illustrates a simple NodeJS [URL Table Engine](https://clickhouse.com/docs/en/engines/table-engines/special/url/) server for Clickhouse
##### ⏱️ Why
> Clickhouse is super fast and already has all the functions one could dream. What is this for?
This example is designed to understand the underlying formats and unleash imagination for integrators.
```mermaid
sequenceDiagram
autonumber
ClickHouse->>NodeJS: POST Request
loop Javascript
NodeJS->>NodeJS: INSERT
end
NodeJS-->>ClickHouse: POST Response
ClickHouse->>NodeJS: GET Request
loop Javascript
NodeJS->>NodeJS: SELECT
end
NodeJS-->>ClickHouse: GET Response
```
##### Features
- [x] INSERT to JS array
- [x] SELECT from JS array
#### Setup
Install and run the example service :
```
npm install
npm start
```
#### 📦 Clickhouse
Create a `url_engine_table` table pointed at our service :
```sql
CREATE TABLE url_engine_node
(
`key` String,
`value` UInt64
)
ENGINE = URL('http://127.0.0.1:3123/', JSONEachRow)
```
##### ▶️ INSERT
```sql
INSERT INTO url_engine_node VALUES ('hello',1), ('world', 2)
```
##### ◀️ SELECT
```sql
SELECT * FROM url_engine_node
Query id: d65b429e-76aa-49f3-b376-ebd3fbc9cd1a
┌─key───┬─value─┐
│ hello │ 1 │
│ world │ 2 │
└───────┴───────┘
2 rows in set. Elapsed: 0.005 sec.
```