Database:Documentation
From OpenSimulator
 |
Languages: |
|
|
|
This article or section contains incomplete information. Please help us by completing the content on this page. |
Please note, a large amount of the information is now out of date for OpenSim 0.7 and later. All this needs updating.
This is a running start at documenting the tables in the MySQL instances used on both grid and regions, and describing how they relate to each other in the context of an OpenSim grid.
SQLite is generally not considered appropriate for this use case and will not be covered here; however the table structures are very similar and most of what is here will be useful in that context as well.
Note that some of these tables may be relics, some may be planned for future use, and some may see heavy use but have columns which are relics, not yet properly updated or not yet used at all. Alpha code FTW!! :D
OpenSim 0.7.2
General
Tables are split up into Common, Services and Simulator sections.
On a grid, the grid services will contain the Services and Common tables, whilst each simulator instance will access the Simulator tables.
A standalone will contain Common, Services and Simulator tables, with the exception of the regions table, which is not currently persisted for standalones.
Common
| migrations | Supports automatic upgrade to new database formats |
Services
| Avatars | Persistence of the visual appearance of avatars between logins and attached objects |
| Friends | Friends list registration |
| GridUser | Information about a user in this particular grid. This is distinct from auth information |
| UserAccounts | User account information, such as name, user level and e-mail |
| assets | Grid assets including such things as textures and sounds |
| auth | User authentication information |
| inventoryfolders | Inventory folder-related details *excepting contents* |
| Contents are in the inventoryitems table and point back to inventoryfolders | |
| inventoryitems | All inventory item details (including folder associations) except contents - contents are referenced in the assets table |
| regions | Regions known to the grid |
| tokens | Unused. |
Simulator
| estate_groups | Narrowly purposed at present. Appears to associate UUIDs under an Estate ID |
| estate_managers | Associates UUIDs with Estate ID |
| estate_map | Associates Regions with Estates By Estate ID |
| estate_settings | Settings for Estates |
| estate_users | Users allowed on the Estate |
| estateban | Users banned from the Estate |
| land | Parcel Properties |
| landaccesslist | Parcel Access List |
| primitems | contains the prim's inventory, which is not at all unlike the avatars' inventory with the exception of folders |
| prims | All rezzed prim details *excepting shape and contents* |
| primshapes | Properties of all rezzed prims |
| regionban | Per-Region ban list |
| regionsettings | Per-Region settings |
| regionwindlight | Windlight region settings |
| terrain | Terrain mesh revision history |
Older information
This mainly pertains to OpenSim 0.6.9.
| Grid: | |
| agents | Records agent (Avatar/User) login details |
| assets | Comprehensive grid assets including textures and avatar inventories |
| avatarappearance | Persistence of the visual appearance of avatars between logins |
| avatarattachments | Items attached to avatars |
| inventoryfolders | Inventory folder-related details *excepting contents* |
| Contents are in the inventoryitems table and point back to inventoryfolders | |
| inventoryitems | All inventory item details (including folder associations) except contents - contents are referenced |
| in the assets table |
|
| *** it would appear neither of these log tables is currently used *** |
|
| migrations | Supports 'automagic' migration to new database formats |
| regions | Regions known to the grid |
| userfriends | Friends list registration |
| users | Stored user profile |
| Region: | |
| estate_groups | Narrowly purposed at present. Appears to associate UUIDs under an Estate ID |
| estate_managers | Associates UUIDs with Estate ID |
| estate_map | Associates Regions with Estates By Estate ID |
| estate_settings | Settings for Estates |
| estate_users | Users allowed on the Estate |
| estateban | Users banned from the Estate |
| land | Parcel Properties |
| landaccesslist | Parcel Access List |
| migrations | Supports 'automagic' upgrade to new database formats |
| primitems | contains the prim's inventory, which is not at all unlike the avatars' inventory with the exception of folders |
| prims | All rezzed prim details *excepting shape and contents* |
| primshapes | Properties of all rezzed prims |
| regionban | Per-Region ban list |
| regionsettings | Per-Region settings |
| terrain | Terrain mesh revision history |
