\HeaderA{aRTdb-createTable}{Create an attribute table}{aRTdb.Rdash.createTable}
\aliasA{createTable}{aRTdb-createTable}{createTable}
\methaliasA{createTable}{aRTdb-createTable}{createTable}
\aliasA{createTable,aRTdb-method}{aRTdb-createTable}{createTable,aRTdb.Rdash.method}
\aliasA{createTable,aRTlayer-method}{aRTdb-createTable}{createTable,aRTlayer.Rdash.method}
\keyword{database}{aRTdb-createTable}
\begin{Description}\relax
Creates a new attribute table in the database and returns it.
It the table is created from an \code{aRTdb} its type will be external, when 
creating from layers it can be any type (but external).
\end{Description}
\begin{Usage}
\begin{verbatim}
## S4 method for signature 'aRTdb':
createTable(object, tablename, id, length)
## S4 method for signature 'aRTlayer':
createTable(object, id, length, generateids=F, type="event")
\end{verbatim}
\end{Usage}
\begin{Arguments}
\begin{ldescription}
\item[\code{object}] Object of aRTlayer or aRTdb class.
\item[\code{tablename}] Name of the table.
\item[\code{id}] The name of the unique identifier of the table (default = "id").
\item[\code{length}] The maximum length of id instances.
\item[\code{generateids}] Populate the table ids linking with the layer geometries?
Used with static and dynamic attributes tables only (default = TRUE).
\item[\code{type}] The type of the table. See \code{\LinkA{aRTtable-class}{aRTtable.Rdash.class}} for the
available types.
\end{ldescription}
\end{Arguments}
\begin{Details}\relax
TerraLib uses some tables in the database, and then you cannot create
tables with these names. Names as \dQuote{\code{Points...}}, \dQuote{\code{Polygons...}},
(other geometries), \dQuote{\code{tempTable}} and \dQuote{\code{te\_...}} are reserved.
Note that names with non letters characters are also prohibited.
\end{Details}
\begin{Author}\relax
Pedro Ribeiro de Andrade Neto
\end{Author}
\begin{SeeAlso}\relax
See \code{\LinkA{aRTtable-class}{aRTtable.Rdash.class}} to the description of table types.
\end{SeeAlso}

