คู่มือการติดตั้ง Databricks CLI (dbx) ด้วย Homebrew บน macOS

dbx เป็นเครื่องมือ CLI ยอดนิยมสำหรับนักพัฒนา Databricks ที่ช่วยจัดการวงจรการพัฒนาโปรเจกต์ เช่น การทดสอบ (Testing), การทำ Packaging และการทำ CI/CD สำหรับ Databricks Jobs

การติดตั้งผ่าน Homebrew บน macOS หรือ Linux เป็นวิธีที่สะดวก รวดเร็ว และจัดการเวอร์ชันได้ง่ายที่สุด

สิ่งที่ต้องเตรียมก่อนเริ่มต้น (Prerequisites)

• ติดตั้ง Homebrew เรียบร้อยแล้ว (หากยังไม่มี ติดตั้งผ่าน /bin/bash -c "$(curl -fsSL [https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh](https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh))")
• สิทธิ์การใช้งานหรือ Token จาก Databricks Workspace (Personal Access Token – PAT)

ขั้นตอนที่ 1: ติดตั้ง dbx ผ่าน Homebrew

โดยทั่วไป Databricks มี Formula/Tap สำหรับเครื่องมือ CLI ต่าง ๆ ให้เรียกใช้งานได้ทันที ให้เปิด Terminal แล้วรันคำสั่ง

Bash

brew tap databricks/tap
brew install dbx

ข้อควรรู้
หากต้องการติดตั้งผ่าน Pipx หรือ Homebrew’s Python environment ในกรณีที่ Formula แยกมีปัญหา สามารถสั่งผ่าน tap ทางการหรือใช้ pipx ได้เช่นกัน แต่การติดตั้งผ่าน tap ของ databricks/tap คือวิธีมาตรฐานสำหรับ Homebrew

ขั้นตอนที่ 2: ตรวจสอบการติดตั้ง

หลังจากรันคำสั่งเสร็จสิ้น ให้ตรวจสอบว่าระบบตรวจพบคำสั่ง dbx และเช็กเวอร์ชันที่ติดตั้ง

Bash

dbx --version

หากติดตั้งสำเร็จ Terminal จะแสดงเลขเวอร์ชันของ dbx ออกมา

ขั้นตอนที่ 3: กำหนดค่าเชื่อมต่อ (Configuration)

dbx จะใช้การตั้งค่า Authentication ร่วมกับ Databricks CLI (.databrickscfg)

1. สร้างหรือกำหนดโปรไฟล์เชื่อมต่อด้วยคำสั่ง
   dbx configure
2. ระบบจะถามข้อมูลสำคัญ 2 อย่าง
   • Databricks Host
     URL ของ Workspace (เช่น [https://adb-xxxxxxxxx.xx.azuredatabricks.net](https://adb-xxxxxxxxx.xx.azuredatabricks.net))
   • Token
     Personal Access Token ที่ได้จากเมนู User Settings > Developer > Access tokens ใน Databricks Workspace
3. ข้อมูลจะถูกบันทึกไว้ที่ไฟล์ ~/.databrickscfg โดยอัตโนมัติ

คำสั่งพื้นฐานที่ควรรู้

การอัปเดตและถอนการติดตั้ง

• อัปเดตเป็นเวอร์ชันล่าสุด
  brew update brew upgrade dbx
• ถอนการติดตั้ง
  brew uninstall dbx