CARTO Feature Representation
In addition to the generic FME feature attributes that FME Workbench adds to all features (see About Feature Type Attributes), this format also adds format-specific attributes (Format Attributes).
Features read from a database consist of geometry and a series of attribute values. The feature type of each CARTO feature is defined in CARTO Writer Feature Type Parameters.
Features written to the database have the destination table as their feature type, and attributes as defined in CARTO Writer: User Attributes.
CARTO attributes cannot have names that contain non-ASCII characters; however, the attribute values support full UTF-8.
The CARTO attribute types are listed below.
Field Type |
Contents |
---|---|
string |
String fields store UTF-8 strings of unlimited length. |
boolean |
Boolean fields store true/false data. Data read or written from and to such fields must always have a value of either true or false. FME represents Booleans as Yes and No for true and false respectively, so any logging within FME will reflect this. Round-tripped values will be written as true or false as expected. |
date |
Datetime fields convert datetimes in CARTO to FME datetime string format. YYYYMMDDHHmmSS (Year, Month, Day, Hour, Minute, Second) If a timezone is specified, then the offset from GMT is included at the end of the string in the format: [+/-]HH:mm (Plus or Minus, Hour, Minute) |
number |
Number fields store double precision floating point values. All numeric types are stored as number fields in CARTO. |
The CARTO attribute type mapping is shown below.
CARTO Attribute Type | FME Attribute Type |
---|---|
string | fme_varchar(width) |
string | fme_char(width) |
string | fme_buffer |
string | fme_char |
number | fme_real64 |
number | fme_decimal(width, decimal) |
number | fme_int32 |
number | fme_int64 |
number | fme_uint64 |
number | fme_int16 |
number | fme_uint16 |
number | fme_uint8 |
number | fme_real32 |
number | fme_uint32 |
date | fme_datetime |
date | fme_date |
date | fme_time |
boolean | fme_boolean |
Geometry
carto_type | Description |
---|---|
wkb_none | FME Feature with no geometry |
wkb_point | 2D Point feature |
wkb_line | 2D Linear feature |
wkb_polygon | 2D Simple polygon or donut feature |
wkb_geometry_collection | 2D Feature with multiple geometries |
wkb_multi_point | 2D Feature with multiple heterogeneous point geometries |
wkb_multi_line | 2D Feature with multiple line geometries |
wkb_multi_polygon | 2D Feature with multiple polygon geometries |
wkb_geometry | All geometries allowed |
wkb_unknown | All geometries allowed |