GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
v.db.renamecolumn(1) Grass User's Manual v.db.renamecolumn(1)

v.db.renamecolumn - Renames a column in the attribute table connected to a given vector map.

vector, attribute table, database, rename

v.db.renamecolumn
 
v.db.renamecolumn --help
 
v.db.renamecolumn map=name [layer=string] column= oldcol,newcol [--help] [--verbose] [--quiet] [-- ui]

--help
 
Print usage summary
--verbose
 
Verbose module output
--quiet
 
Quiet module output
--ui
 
Force launching GUI dialog

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
Last changed: $Date: 2011-11-08 22:24:20 +0100 (Tue, 08 Nov 2011) $

Available at: v.db.renamecolumn source code (history)
Main index | Vector index | Topics index | Keywords index | Graphical index | Full index
© 2003-2018 GRASS Development Team, GRASS GIS 7.4.3 Reference Manual
GRASS 7.4.3

Search for    or go to Top of page |  Section 1 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.