db.columns(1)

NAME
db.columns - List all columns for a given table.

KEYWORDS
database, attribute table

SYNOPSIS
db.columns
db.columns --help
db.columns [-e] table=name [driver=name] [database=name] [separator=character] format=name [--help] [--verbose] [--quiet] [--ui]

  Flags:

-e
    Print type information about the columns
    Print the name and the type of all the columns for a given table.

--help
    Print usage summary

--verbose
    Verbose module output

--quiet
    Quiet module output

--ui
    Force launching GUI dialog

  Parameters:

table=name [required]
    Name of attribute table

driver=name
    Name of database driver
    Options: dbf, odbc, ogr, pg, sqlite
    Default: sqlite

database=name
    Name of database
    Default: $GISDBASE/$LOCATION_NAME/$MAPSET/sqlite/sqlite.db

separator=character
    Field separator
    Special characters: pipe, comma, space, tab, newline

format=name [required]
    Output format
    Options: plain, csv, json, list
    Default: plain
    plain: Configurable plain text output
    csv: CSV (Comma Separated Values)
    json: JSON (JavaScript Object Notation)
    list: Output in list format

DESCRIPTION
db.columns lists all columns for a give table. Connection to databases are supported through dbf, shp, odbc and pg drivers.

NOTE
If parameters for database connection are already set with db.connect, they are taken as default values and do not need to be specified each time.

EXAMPLES

  List columns of a PostgreSQL attribute table

db.columns table=zipcodes_wake driver=pg database=grassdb

If the database parameters are already set, the columns can be listed directly

db.columns table=zipcodes_wake

  List columns from Shape file with DBF attribute table

db.columns table=zipcodes_wake driver=dbf database=/grassdata/nc_spm_08/PERMANENT/dbf/

  List columns of table in SQLite database
Note that the SQLite backend is the default setting.

db.columns driver=sqlite table=archsites database=’$GISDBASE/$LOCATION_NAME/$MAPSET/sqlite/sqlite.db’

SEE ALSO
db.connect, db.describe, db.drivers, db.droptable, db.execute, db.login, db.tables, GRASS SQL interface

GRASS SQL interface

AUTHOR
Radim Blazek, ITC-Irst, Trento, Italy

SOURCE CODE

Available at: db.columns source code (history)

Latest change: Saturday Jan 31 03:52:33 2026 in commit: 5dd1f9083055d3047f66dba6c3aec01c50dbdf2d

Main index | Database index | Topics index | Keywords index | Graphical index | Full index

© 2003-2026 GRASS Development Team, GRASS 8.5.1dev Reference Manual