Installation

QuestDB พัฒนาด้วย Java จึงต้องการ JDK 17 ขึ้นไป

วิธีติดตั้งบน Windows

ต้องติดตั้งด้วยสิทธิ administrator
ดาวน์โหลด *.tar.gz สำหรับ Windows แล้ว unzip ลงในโฟลเดอร์ เช่น d:\questdb
ตั้งค่า PATH=d:\questdb\bin;%PATH%
root dir คือโฟลเดอร์ที่เก็บข้อมูล, log และคอนฟิกูเรชั่น ซึ่งอยู่ที่ไหนก็ได้
- default root dir บน Windows คือ %SystemRoot%\system32\questdb แต่แนะนำให้เป็นโฟลเดอร์อื่น
- default root dir บน Linux คือ $HOME/.questdb

ในตัวอย่างต่อไปนี้ สันนิษฐานว่าเรา unzip ลงใน d:\questdb และใช้ d:\questdb\qdbroot เป็น root dir สำหรับข้อมูล

(admin) C:\> mkdir d:\questdb\qdbroot
(admin) C:\> questdb.exe install -d D:\questdb\qdbroot
(admin) C:\> questdb.exe start

เปิด command prompt อีกตัว เพื่อตรวจสอบว่า questdb ทำงานหรือยัง และเปิดเบราว์เซอร์เพื่อเข้า web console

C:\> questdb status
C:\> start http://localhost:9000

วิธีติดตั้งบน Linux

TBA

การตั้งค่า

questdb ใช้พอร์ตเหล่านี้ ดังนั้นอย่าลืมอนุญาตพอร์ตดังกล่าว

9000 (TCP)	REST API and Web Console
8812 (TCP)	Postgres Wire Protocol (PGWire)
9003	Min health server

questdb เวอร์ชันฟรี ไม่มีระบบล็อกอินหรือ secure port ใดๆ ดังนั้นอย่า expose พอร์ตเหล่านี้ให้เห็นจาก IP ภายนอก

กรณีที่พอร์ตชนกันกับแอปอื่น ให้แก้ไขพอร์ตที่ไฟล์คอนฟิก <ROOT_DIR>/conf/server.conf

ไฟล์คอนฟิกอยู่ที่ <ROOT_DIR>/server.conf หรือในไฟล์ *.conf ภายใต้ <ROOT_DIR>/conf/

คีย์ต่างๆ ในคอนฟิก สามารถถูก override ด้วยตัวแปรแวดล้อม โดยที่ชื่อตัวแปรแวดล้อมจะนำหน้าด้วย QDB_ , เป็น uppercase และใช้ underscore แทน dot ตัวอย่างเช่น ในคอนฟิกเป็น shared.worker.count=5 เราสามารถ override ด้วยตัวแปรแวดล้อมดังนี้ export QDB_SHARED_WORKER_COUNT=10

ดูรายละเอียดของคีย์ในไฟล์คอนฟิก

ระวัง! server.conf ถูกอ่านหลังจากที่ questdb เริ่มโพรเซสและรู้ว่า root dir ของตนอยู่ที่ไหน ดังนั้น การกำหนด root path ใน conf ~~จึงไม่เกิดผลใดๆต้องไปกำหนดที่~~จึงไม่เกิดผลใดๆ ต้องไปกำหนดที่ command line ตอนเริ่ม process เท่านั้น

Run at start up (Linux)

บน Linux ถ้าต้องการรันอัตโนมัติแบบ systemd ให้สร้างไฟล์ questdb.service แล้วใส่รายละเอียดตามนี้