Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current manual page.
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 access this is the layer name.
- Default: 1
- column=oldcol,newcol [required]
- Old and new name of the column (old,new)
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.
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 dropping 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.
Renaming a column:
g.copy vect=roadsmajor,myroads
v.info -c myroads
v.db.renamecolumn myroads column=ROAD_NAME,roadname
v.info -c myroads
db.execute,
v.db.addcolumn,
v.db.addtable,
v.db.connect,
v.db.dropcolumn,
v.db.droptable,
v.db.select,
v.db.update
GRASS SQL interface
Markus Neteler
SOURCE CODE
Available at:
v.db.renamecolumn source code
(history)
Latest change: Thursday Feb 03 11:10:06 2022 in commit: 547ff44e6aecfb4c9cbf6a4717fc14e521bec0be
Note: This document is for an older version of GRASS GIS that will be discontinued soon. You should upgrade, and read the current manual page.
Main index |
Vector index |
Topics index |
Keywords index |
Graphical index |
Full index
© 2003-2023
GRASS Development Team,
GRASS GIS 8.2.2dev Reference Manual