v.db.renamecolumn(1grass) GRASS GIS User's Manual v.db.renamecolumn(1grass)
NAME
v.db.renamecolumn - Renames a column in the attribute table connected
to a given vector map.
KEYWORDS
vector, attribute table, database, rename
SYNOPSIS
v.db.renamecolumn
v.db.renamecolumn --help
v.db.renamecolumn map=name [layer=string] column=oldcol,newcol
[--help] [--verbose] [--quiet] [--ui]
Flags:
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog
Parameters:
map=name [required]
Name of vector map
Or data source for direct OGR access
layer=string
Layer number or name
Vector features can have category values in different layers. This
number determines which layer to use. When used with direct OGR ac-
cess this is the layer name.
Default: 1
column=oldcol,newcol [required]
Old and new name of the column (old,new)
DESCRIPTION
v.db.renamecolumn renames a column in the attribute table connected to
a given vector map. It automatically checks the connection for the
specified layer.
NOTES
If the map table is connected through the DBF or SQLite drivers, the
renaming is internally done by adding a new column with new name,
transferring the contents of the old column to the new column and drop-
ping the old column. This is needed as DBF or SQLite do not support
"ALTER TABLE" command to rename columns. Due to this the renamed column
is found as last column of the table, it’s original position cannot be
maintained.
The SQLite driver will exit with an error if the column rename involves
only a change of case, i.e., upper-to-lowercase, or lower-to-uppercase.
The SQLite protocol considers "NAME" and "name" to be identical column
names. In cases like these, the user should rename the original column
to an intermediary name, then rename the intermediary to the final
name.
EXAMPLES
Renaming a column:
g.copy vect=roadsmajor,myroads
v.info -c myroads
v.db.renamecolumn myroads column=ROAD_NAME,roadname
v.info -c myroads
SEE ALSO
db.execute, v.db.addcolumn, v.db.addtable, v.db.connect, v.db.dropcol-
umn, v.db.droptable, v.db.select, v.db.update
GRASS SQL interface
AUTHOR
Markus Neteler
SOURCE CODE
Available at: v.db.renamecolumn source code (history)
Accessed: unknown
Main index | Vector index | Topics index | Keywords index | Graphical
index | Full index
© 2003-2022 GRASS Development Team, GRASS GIS 7.8.7 Reference Manual
GRASS 7.8.7 v.db.renamecolumn(1grass)
Generated by dwww version 1.14 on Fri Jan 24 09:32:22 CET 2025.