db.copy(1)

NAME
db.copy - Copy a table. Either 'from_table' (optionaly with 'where') can be used or 'select' option, but not 'from_table' and 'select' at the same time.

KEYWORDS
database, SQL

SYNOPSIS
db.copy
db.copy help
db.copy [from_driver=string] [from_database=string] [from_table=string] [to_driver=string] [to_database=string] to_table=string [where=string] [select=string]

  Parameters:

from_driver=string
    Input driver name Options: dbf,pg,ogr

from_database=string
    Input database name

from_table=string
    Input table name (only, if 'select' is not used)

to_driver=string
    Output driver name Options: dbf,pg,ogr

to_database=string
    Output database name

to_table=string
    Output table name

where=string
    Optional where condition (without WHERE key word), e.g.:
            obec = 'Liptakov'

select=string
    Full select statement (only, if 'from_table' and 'where' is not used), e.g.:
            SELECT dedek FROM starobince WHERE obec = 'Frimburg'

DESCRIPTION
db.copy allows the user to copy a table between two databases. Databases can be connected through different drivers (see example).

NOTES
Attribute tables can be copied manually using db.copy and v.db.connect. Current connection settings are saved in $LOCATION/vector_map/dbln.

EXAMPLES

  DBF -> PG
Storing table 'markveggy.dbf' (in current directory) into PostgreSQL through ODBC:
db.copy from_driver=dbf from_database=$HOME/grassdata/spearfish60/user1/dbf \
  from_table=markveggy to_driver=pg to_database="host=pgserver,dbname=grass6test" \
  to_table=markveggy

  PG -> DBF
db.copy from_driver=pg from_database="host=pgserver.itc.it,dbname=testdb" \
  from_table=origtable to_driver=dbf \
  to_database=$HOME/grassdata/spearfish60/user1/dbf to_table=origtable

  PG -> PG with condition
db.copy from_driver=pg from_database="host=localhost,dbname=meteo" \
  from_table=ukraine to_driver=pg to_database="host=localhost,dbname=meteo" \
  to_table=selection where="cat < 500"

  DBF -> SQLite
db.copy from_driver=dbf from_database=$HOME/grassdata/spearfish60/user1/dbf \
   from_table=ammprv to_driver=sqlite \
   to_database=$HOME/grassdata/spearfish60/user1/mysqlite.db to_table=ammprv
# convenient viewer:
sqlitebrowser $HOME/grassdata/spearfish60/user1/mysqlite.db

  SQLite -> DBF
db.copy from_driver=sqlite from_database=$HOME/grassdata/spearfish60/user1/mysqlite.db \
   from_table=ammprv to_driver=dbf to_database=$HOME/grassdata/spearfish60/user1/dbf \
   to_table=ammprv

SEE ALSO
v.db.connect, db.drivers, db.login, v.clean, GRASS SQL interface

AUTHOR
Radim Blazek, ITC-irst, Trento, Italy

Last changed: $Date: 2006/03/21 17:29:39 $

Full index