Oracle Database implements the object-type model as an extension of the relational model, while continuing to support standard relational database functionality, such as queries, fast commits, backup and recovery, scalable connectivity, row-level locking, read consistency, and more.
SQL and various programmatic interfaces and languages, including PL/SQL, Java, Oracle Call Interface, Pro*C/C++, and C# have been enhanced with extensions to support Oracle objects. The result is an object-relational model that offers the intuitiveness and economy of an object interface while preserving the high concurrency and throughput of a relational database.
1.3.1 Database Features of Oracle Objects
There are certain features and concepts of the object-relational model that are related to the database.
Running Examples: Many examples in this guide can be run using the
HR sample schema. Comments at the beginning of most examples indicate if any previous example code is required.
Refer to Oracle Database Sample Schemas for information on how these schemas were created and how you can use them yourself.
220.127.116.11 About Object Types
An object type is a kind of data type.
You can use an object in the same ways that you use standard data types such as
VARCHAR2. For example, you can specify an object type as the data type of a column in a relational table, and you can declare variables of an object type. The value is a variable or an instance of that type. An object instance is also called an object.
Figure 1-1 shows an object type,
person_typ, and two instances of the object type.
Figure 1-1 Object Type and Object Instances
Description of "Figure 1-1 Object Type and Object Instances"
Object types serve as blueprints or templates that define both structure and behavior. Object types are database schema objects, subject to the same kinds of administrative control as other schema objects. Application code can retrieve and manipulate these objects. See Managing Oracle Objects.
You use the
TYPE SQL statement to define object types.
Example 1-1 shows how to create an object type named
person_typ. In the example, an object specification and object body are defined. For information on the
TYPE SQL statement and on the
BODY SQL statement, see Oracle Database PL/SQL Language Reference.
Note:Running Examples: Many examples on this subject can be run using the
HRsample schemas. Comments at the beginning of most examples indicate if any previous example code is required.
Refer to Oracle Database Sample Schemas for information on how these schemas were created and how you can use them yourself.
Example 1-1 Creating the person_typ Object Type
CREATE TYPE person_typ AS OBJECT ( idno NUMBER, first_name VARCHAR2(20), last_name VARCHAR2(25), email VARCHAR2(25), phone VARCHAR2(20), MAP MEMBER FUNCTION get_idno RETURN NUMBER, MEMBER PROCEDURE display_details ( SELF IN OUT NOCOPY person_typ )); / CREATE TYPE BODY person_typ AS MAP MEMBER FUNCTION get_idno RETURN NUMBER IS BEGIN RETURN idno; END; MEMBER PROCEDURE display_details ( SELF IN OUT NOCOPY person_typ ) IS BEGIN -- use the PUT_LINE procedure of the DBMS_OUTPUT package to display details DBMS_OUTPUT.PUT_LINE(TO_CHAR(idno) || ' ' || first_name || ' ' || last_name); DBMS_OUTPUT.PUT_LINE(email || ' ' || phone); END; END; /
Object types differ from the standard data types that are native to a relational database:
Oracle Database does not supply predefined object types. You define the object types you want by combining built-in types with user-defined ones as shown in Example 1-1.
Object types are composed of attributes and methods as illustrated in Figure 1-2.
Attributes hold the data about an object. Attributes have declared data types which can, in turn, be other object types.
Methods are procedures or functions that applications can use to perform operations on the attributes of the object type. Methods are optional. They define the behavior of objects of that type.
Figure 1-2 Object Attributes and Methods
Figure 1-2 shows the relationship of attributes and methods in the spec.
Description of "Figure 1-2 Object Attributes and Methods"
18.104.22.168 About Object Instances
A variable of an object type is an instance of the type, or an object.
An object has the attributes and methods defined for its type. Because an object instance is a concrete thing, you can assign values to its attributes and call its methods.
Defining an object type does not allocate any storage. After they are defined, object types can be used in SQL statements in most of the same places you use types such as
VARCHAR2. Storage is allocated once you create an instance of the object type.
Example 1-2 Creating the contacts Table with an Object Type Column
-- requires existing person_typ fr. Ex 1-1 CREATE TABLE contacts ( contact person_typ, contact_date DATE ); INSERT INTO contacts VALUES ( person_typ (65, 'Verna', 'Mills', 'firstname.lastname@example.org', '1-650-555-0125'), to_date('24 Jun 2003', 'dd Mon YYYY'));
contacts table is a relational table with an object type as the data type of its contact column. Objects that occupy columns of relational tables are called column objects.
22.214.171.124 About Object Methods
Object methods are functions or procedures that you can declare in an object type definition to implement behavior that you want objects of that type to perform.
The general kinds of methods that can be declared in a type definition are:
Using member methods, you can provide access to the data of an object, and otherwise define operations that an application performs on the data. To perform an operation, the application calls the appropriate method on the appropriate object.
Static methods compare object instances and perform operations that do not use the data of any particular object, but, instead, are global to an object type.
A default constructor method is implicitly defined for every object type, unless it is overwritten with a user-defined constructor. A constructor method is called on a type to construct or create an object instance of the type.
Example 1-3 Using the get_idno Object Method
-- requires Ex 1-1 and Ex 1-2 SELECT c.contact.get_idno() FROM contacts c;
126.96.36.199 How Objects are Stored in Tables
Objects can be stored in two types of tables:
Object tables: store only objects
In an object table, each row represents an object, which is referred to as a row object.
Relational tables: store objects with other table data
Objects that are stored as columns of a relational table, or are attributes of other objects, are called column objects. Example 1-2 shows the
contactstable which stores an instance of the
Objects that have meaning outside of the relational database in which they are contained, or objects that are shared among more than one relational database object, should be made referenceable as row objects. That is, such objects should be stored as a row object in an object table instead of in a column of a relational table.
188.8.131.52.1 Creating and Using Object Tables
You create object tables using a
Example 1-4 shows a
TABLE statement that creates an object table for
Example 1-4 Creating the person_obj_table Object Table
-- requires Ex. 1-1 CREATE TABLE person_obj_table OF person_typ;
You can view this table in two ways:
As a single-column table, in which each row is a
person_typobject, allowing you to perform object-oriented operations.
As a multi-column table, in which each attribute of the object type
last_name, and so on, occupies a column, allowing you to perform relational operations.
184.108.40.206.2 Performing Operations on Object Tables
You can perform various operations on object tables such as inserting objects into the table or selecting objects from the table.
Example 1-5 illustrates several operations on an object table.
Example 1-5 Operations on the person_obj_table Object Table
-- requires Ex. 1-1 and 1-4 INSERT INTO person_obj_table VALUES ( person_typ(101, 'John', 'Smith', 'email@example.com', '1-650-555-0135') ); SELECT VALUE(p) FROM person_obj_table p WHERE p.last_name = 'Smith'; DECLARE person person_typ; BEGIN -- PL/SQL block for selecting a person and displaying details SELECT VALUE(p) INTO person FROM person_obj_table p WHERE p.idno = 101; person.display_details(); END; /
INTO SQL statement in Example 1-5inserts a
person_typ object into the
person_obj_table as a multi-column table.
SELECT SQL statement selects from
person_obj_table as a single-column table, using the
VALUE function to return rows as object instances.
The PL/SQL block selects a specific person and executes a member function of
person_typ to display details about the specified person.
220.127.116.11 Object Identifiers Used to Identify Row Objects
Object identifiers (OIDs) uniquely identify row objects in object tables.
You cannot directly access object identifiers, but you can make references (
REFs) to the object identifiers and directly access the
REFs, as discussed in "References to Row Objects".
There are two types of object identifiers.
System-Generated Object Identifiers (default)
Oracle automatically creates system-generated object identifiers for row objects in object tables unless you choose the primary-key based option.
Primary-Key Based Object Identifiers
You have the option to create primary-key based OIDs when you create the table using the
Column objects are identified by the primary key of the row, and, therefore, do not need a specific object identifier.
18.104.22.168 References to Row Objects
REF is a logical pointer or reference to a row object that you can construct from an object identifier (OID).
You can use the
REF to obtain, examine, or update the object. You can change a
REF so that it points to a different object of the same object type hierarchy or assign it a null value.
REFs are Oracle Database built-in data types.
REFs and collections of
REFs model associations among objects, particularly many-to-one relationships, thus reducing the need for foreign keys.
REFs provide an easy mechanism for navigating between objects.
Example 1-6 illustrates a simple use of a
Example 1-6 Using a REF to the emp_person_typ Object
CREATE TYPE emp_person_typ AS OBJECT ( name VARCHAR2(30), manager REF emp_person_typ ); / CREATE TABLE emp_person_obj_table OF emp_person_typ; INSERT INTO emp_person_obj_table VALUES ( emp_person_typ ('John Smith', NULL)); INSERT INTO emp_person_obj_table SELECT emp_person_typ ('Bob Jones', REF(e)) FROM emp_person_obj_table e WHERE e.name = 'John Smith';
This example first creates the
emp_person_typ John Smith, with
NULL value for a manager. Then it adds the
emp_person_typ Bob Jones as John Smith's supervisee.
The following query and its output show the effect:
COLUMN name FORMAT A10 COLUMN manager FORMAT A50 select * from emp_person_obj_table e;
NAME MANAGER ---------- -------------------------------------------------- John Smith Bob Jones 0000220208424E801067C2EABBE040578CE70A0707424E8010 67C1EABBE040578CE70A0707
Example 1-10 shows how to dereference the object, so that
Manager appears as a name rather than an object identifier.
22.214.171.124.1 Using Scoped REFs
REF types require less storage space and allow more efficient access than unscoped
You can constrain a column type, collection element, or object type attribute to reference a specified object table. Use the SQL constraint subclause
IS when you declare the
Example 1-7 shows
contact_ref scoped to
person_obj_table which is an object table of type
Example 1-7 Creating the contacts_ref Table Using a Scoped REF
-- requires Ex. 1-1, 1-4, and 1-5 CREATE TABLE contacts_ref ( contact_ref REF person_typ SCOPE IS person_obj_table, contact_date DATE );
To insert a row in the table, you could issue the following:
INSERT INTO contacts_ref SELECT REF(p), '26 Jun 2003' FROM person_obj_table p WHERE p.idno = 101;
REF can be scoped to an object table of the declared type (
person_typ in the example) or of any subtype of the declared type. If a
REF is scoped to an object table of a subtype, the
REF column is effectively constrained to hold only references to instances of the subtype (and its subtypes, if any) in the table..
126.96.36.199.2 Checking for Dangling REFs
REFs where the object identified by the
REF becomes unavailable. Objects are unavailable if they have been deleted or some privilege necessary to them has been deleted.
Use the Oracle Database SQL predicate
DANGLING to test
REFs for dangling
You can avoid dangling
REFs by defining referential integrity constraints.
188.8.131.52 Dereferencing REFs
Accessing the object that the
REF refers to is called dereferencing the
184.108.40.206.1 Dereferencing a REF with the DEREF Command
This example shows how to use the
DEREF command to derefence a
Example 1-8 Using DEREF to Dereference a REF
SELECT DEREF(e.manager) FROM emp_person_obj_table e; DEREF(E.MANAGER)(NAME, MANAGER) ------------------------------------------------------------- --- EMP_PERSON_TYP('John Smith', NULL)
This example shows that dereferencing a dangling
REF returns a null object.
220.127.116.11.2 Dereferencing a Dangling REF
You can dereference a dangling
REF with the
Dereferencing a dangling
REF returns a null object.
Example 1-9 Dereferencing a Dangling Ref
DELETE from person_obj_table WHERE idno = 101; / SELECT DEREF(c.contact_ref), c.contact_date FROM contacts_ref c;
18.104.22.168.3 Dereferencing a REF Implicilty
Oracle Database provides implicit dereferencing of
For example, to access the manager's name for an employee, you can use a
Example 1-10 follows the pointer from the person's name and retrieves the manager's name
Example 1-10 Implicitly Dereferencing a REF
-- requires Ex. 1-6 SELECT e.name, e.manager.name FROM emp_person_obj_table e WHERE e.name = 'Bob Jones';
REF in this manner is allowed in SQL, but PL/SQL requires the
DEREF keyword as in Example 1-8.
22.214.171.124 Obtaining a REF to a Row Object
You obtain a
REF to a row object by selecting the object from its object table and applying the
Select the object from its object table and apply the
Example 1-11 shows how to obtain a
REF to the person with an
idno equal to
The query returns exactly one row.
Example 1-11 Obtaining a REF to a Row Object
-- requires Ex. 1-1, 1-4, and 1-5 DECLARE person_ref REF person_typ; person person_typ; BEGIN SELECT REF(p) INTO person_ref FROM person_obj_table p WHERE p.idno = 101; select deref(person_ref) into person from dual; person.display_details(); END; /
126.96.36.199 REF Variables Compared
REF variables can be compared if, and only if, the targets that they reference are both of the same declared type, or one is a subtype of the other.
REF variables can only be compared for equality.
188.8.131.52 Oracle Collections Data Types
For modeling multi-valued attributes and many-to-many relationships, Oracle Database supports these two collection data types:
You can use collection types anywhere other data types are used. You can have object attributes of a collection type in addition to columns of a collection type. For example, a purchase order object type might contain a nested table attribute that holds the collection of line items for the purchase order.
To define a collection type, use the
Example 1-12 shows
TYPE statements that define a collection and an object type.
Example 1-12 Creating the people_typ Collection Data Type
-- requires Ex. 1-1 CREATE TYPE people_typ AS TABLE OF person_typ; / CREATE TYPE dept_persons_typ AS OBJECT ( dept_no CHAR(5), dept_name CHAR(20), dept_mgr person_typ, dept_emps people_typ); /
Note the following about this example:
The collection type,
people_typ, is specifically a nested table type.
dept_persons_typobject type has an attribute
people_typ. Each row in the
dept_empsnested table is an object of type
person_typwhich was defined in Example 1-1.
184.108.40.206 Object Views Used to Access Relational Data
An object view is a way to access relational data using object-relational features.
An object view lets you develop object-oriented applications without changing the underlying relational schema.
You can access objects that belong to an object view in the same way that you access row objects in an object table. Oracle Database also supports materialized view objects of user-defined types from data stored in relational schemas and tables.
Object views let you exploit the polymorphism that a type hierarchy makes possible. A polymorphic expression takes a value of the expression's declared type or any of that type's subtypes. If you construct a hierarchy of object views that mirrors some or all of the structure of a type hierarchy, you can query any view in the hierarchy to access data at just the level of specialization you are interested in. If you query an object view that has subviews, you can get back polymorphic data—rows for both the type of the view and for its subtypes.
220.127.116.11 Use of Type Inheritance
Type inheritance enables you to create type hierarchies.
A type hierarchy is a set of successive levels of increasingly specialized subtypes that derive from a common ancestor object type, which is called a supertype. Derived subtypes inherit the features of the parent object type and can extend the parent type definition. The specialized types can add new attributes or methods, or redefine methods inherited from the parent. The resulting type hierarchy provides a higher level of abstraction for managing the complexity of an application model. For example, specialized types of persons, such as a student type or a part-time student type with additional attributes or methods, might be derived from a general person object type.
Figure 1-3 illustrates two subtypes,
Employee_t, created under
Person_t, and the
PartTimeStudent_t, a subtype under
Figure 1-3 A Type Hierarchy
Description of "Figure 1-3 A Type Hierarchy"
18.104.22.168 Type Evolution Used to Change an Existing Object Type
Type evolution enables you to modify, or evolve, an existing object type, even those already used in tables.
Type evolution works through the
TYPE statement, enabling you to propagate changes through all instances of the object type.
TYPE statement checks for dependencies of the type to be altered, using essentially the same validations as a
TYPE statement. If a type or any of its dependent types fails the type validations, the
TYPE statement rolls back.
Metadata for all tables and columns that use an altered type are updated for the new type definition so that data can be stored in the new format. Existing data can be converted to the new format either all at once or piecemeal, as it is updated. In either case, data is always presented in the new type definition even if it is still stored in the format of the older one.
1.3.2 Language Binding Features of Oracle Objects
Certain key features of the object-relational model are related to languages and application programming interfaces (APIs).
Related languages and application programming interfaces (APIs):
SQL Object Extensions
To support object-related features, Oracle Database provides SQL extensions, including DDL, to create, alter, or drop object types; to store object types in tables; and to create, alter, or drop object views. There are DML and query extensions to support object types, references, and collections.
PL/SQL Object Extensions
PL/SQL can operate on object types seamlessly. Thus, application developers can use PL/SQL to implement logic and operations on user-defined types that execute in the database server.
Java Support for Oracle Objects
Oracle Java VM is tightly integrated with Oracle Database and supports access to Oracle Objects through object extensions to Java Database Connectivity (JDBC). This provides dynamic SQL, and SQLJ, which provides static SQL. Thus, application developers can use Java to implement logic and operations on object types that execute in the database. You can map SQL types to existing Java classes to provide persistent storage for Java objects.
You can implement database functions, procedures, or member methods of an object type in PL/SQL, Java, C, or .NET as external procedures. External procedures are best suited for tasks that are more quickly or easily done in a low-level language such as C. External procedures are always run in a safe mode outside the address space of the database. Generic external procedures can be written that declare one or more parameters to be of a system-defined generic type. Thus, an external procedure can use the system-defined generic type to work with data of any built-in or user-defined type.
Object Type Translator
Object Type Translator (OTT) provides client-side mappings to object type schemas by using schema information from the Oracle data dictionary to generate header files containing Java classes and C structures and indicators. You can use these generated header files in host-language applications for transparent access to database objects.
Oracle Database provides an object cache for efficient access to persistent objects stored in the database. Copies of objects can be brought into the object cache. Once the data has been cached in the client, the application can traverse through these at memory speed. Any changes made to objects in the cache can be committed to the database by using the object extensions to Oracle Call Interface programmatic interfaces.
Oracle Call Interface and Oracle C++ Call Interface
Oracle Call Interface (OCI) and Oracle C++ Call Interface provide a comprehensive application programming interface for application and tool developers. Oracle Call Interface provides a run-time environment with functions to connect to an Oracle Database, and control transactions that access objects in the database. It allows application developers to access and manipulate objects and their attributes in the client-side object cache either navigationally, by traversing a graph of inter-connected objects, or associatively by specifying the nature of the data through declarative SQL DML. Oracle Call Interface provides a number of functions to access metadata about object types defined in the database at run-time.
Pro*C/C++ Object Extensions
The Oracle Pro*C/C++ precompiler provides an embedded SQL application programming interface and offers a higher level of abstraction than Oracle Call Interface. Like Oracle Call Interface, the Pro*C/C++ precompiler allows application developers to use the Oracle client-side object cache and the Object Type Translator Utility. Pro*C/C++ supports the use of C bind variables for Oracle object types. Pro*C/C++ also provides simplified syntax to allocate and free objects of SQL types and access them using SQL DML or the navigational interface.
.NET Object Extensions
Oracle Developer Tools for Visual Studio (ODT) and Oracle Data Provider for .NET (ODP.NET) support .NET custom objects that map to Oracle object-relational data types, collections, and REFs. ODT is a set of tools incorporated into a Visual Studio integrated development environment, which allow managing these data types inside the Oracle database. Through the ODT Custom Class Wizard, Oracle objects can be automatically mapped to .NET custom types to ease data sharing between Oracle databases and .NET applications. Data access to these .NET custom types occur through ODP.NET.
Oracle Developer Tools for Visual Studio Help