Keyset tables in a geodatabase in Oracle
A keyset table is used to store a list of selected rows when an ArcGIS Desktop client executes a geodatabase relationship query that joins tables using attributes that are type integer, number, date, or string.
As discussed in ArcSDE log file table configuration options for Oracle, log file tables store the OBJECTIDs of the selected features. Keyset tables are used to accommodate joins using attributes other than the OBJECTID.
One keyset table is created per connection per session when there are more than 99 rows in the source selection set in the database query.
Keyset tables in ArcGIS Desktop
You cannot see keyset tables in ArcGIS Desktop. However, you cause a keyset table to be created and populated when you select more than 99 records in a feature class involved in a relationship class in ArcMap, then open the attribute table, and use the Related Tables list in the Options menu to retrieve the related table. You also cause a keyset table to be created when you start an edit session.
Keyset tables in an Oracle database
No keyset tables are present in the geodatabase until one of two things happens:
- A qualifying selection is made via ArcGIS Desktop
- You begin an edit session
When a user who has CREATE TABLE privileges causes a keyset table to be created, the keyset table is created in that user's schema. If a user does not have CREATE TABLE privileges, a procedure is invoked to create a keyset table in the ArcSDE administrator's schema. When a keyset table is created as a result of a qualifying selection being made in ArcGIS Desktop, the keyset table is created and populated. When you begin an edit session, the keyset table is created but not populated until a qualifying selection set is made. The keyset table is deleted when the user disconnects from the database.
Keyset table names are in this format:
<user_schema>.keyset_<process_id>
The keyset table stores a keyset ID number for each selection set and values for the field on which the relationship between the feature classes is based.
The following is a keyset table for a selection made between the related tables LATERALS and CONTRACTORS. In this case, the LONG_VAL field would be populated and contain the values of the CONTRACTOR_ID field on which the relationship class between LATERALS and CONTRACTORS is based.
 |
<user_schema>.keyset_<process_id>
The following is the definition for a keyset table in Oracle:
|
Field name |
Field type |
Description |
Null? |
|---|---|---|---|
|
KEYSET_ID |
NUMBER(38) |
Identifier for the keyset selection |
NOT NULL |
|
LONG_VAL |
NUMBER |
Value of the field on which the relationship class is based, if that field is a number field |
|
|
STR_VAL |
NVARCHAR2(256) |
Value of the field on which the relationship class is based, if that field is a string field |
|
|
DBL_VAL |
DOUBLE |
Value of the field on which the relationship class is based, if that field is a double precision field |
|
|
DATE_VAL |
DATE |
Value of the field on which the relationship class is based, if that field is a date field |
Keyset tables in an XML document
Keyset tables do not get stored in an XML document because they are temporary tables.