db.test(1grass)

📦
version 8.5.0 · 10 versions
, in alpine 3.24, ubuntu stonking

💾 db.test — the GRASS User's Manual, bestie edition 🎀

okay so you found db.test in the manual and you're like "what is this tiny little thing" — it's from the GRASS manual, and I'm gonna walk you through it like we're texting at 2am. no cap. 🦋

✨ NAME ✨

db.test — it's a test database driver, and the database has gotta exist and be set by db.connect. that's the whole vibe. if it's not connected, it's giving nothing. 💅

🏷️ KEYWORDS 🏷️

  • database
  • attribute table

📜 SYNOPSIS 📜

db.test
db.test --help
db.test test=string  [--help]  [--verbose]  [--quiet]  [--ui]

🚩 Flags 🚩

  • --help — prints the usage summary, i.e. the little "here's how you use me" moment ✨
  • --verbose — verbose module output, aka it tells you more, bestie 🗣️
  • --quiet — quiet module output, aka it shuts up politely 🤫
  • --ui — forces launching the GUI dialog 👑

🎛️ Parameters 🎛️

  • test=string — [required] the test name. your options here are literally just: test1. and yes, test=string means you hand it a string. periodt. 🍓

📖 DESCRIPTION 📖

so true story: db.test tests the database driver and the database server by running a set of SQL queries. that's it, that's the job. 🫶

and the one non-negotiable: the database must exist, and the connection must be set by db.connect. no connection, no test. it's not rude, it's just boundaries. 💀

🌸 EXAMPLE 🌸

want to test your current SQL backend driver? say less:

db.connect -p
db.test test=test1

first you peek at the connection with db.connect -p, then you run the test. chefs kiss. 😭

👀 SEE ALSO 👀

  • GRASS SQL interface
  • db.connect
  • db.describe
  • db.drivers

👑 AUTHOR 👑

Radim Blazek — icon behavior, we love to see it. 💖

🔧 SOURCE CODE 🔧

  • Available at: db.test source code (history)
  • Latest change: Friday Oct 10 10:16:04 2025 in commit: 85fa0b484faeb8ae27841cfbee90231c704a5272
  • Main index | Database index | Topics index | Keywords index | Graphical index | Full index
okay bestie, wrap-up time 🎀 this little page is straight out of GRASS 8.5.0 Reference Manual, © 2003-2026 GRASS Development Team, and the whole thing lives under db.test(1grass) in GRASS 8.5.0. slay, go test that database, and remember — db.connect first or it's not happening. ✨💅🦋
📦 where this page comes from