My Oracle Support Banner

Collection, Iterator and Table Functions in PL/SQL and OCI (Doc ID 47957.1)

Last updated on FEBRUARY 03, 2022

Applies to:

Oracle Database - Enterprise Edition - Version to [Release 8.0.3 to 11.1]
Oracle Database Cloud Schema Service - Version N/A and later
Oracle Database Exadata Cloud Machine - Version N/A and later
Oracle Cloud Infrastructure - Database Service - Version N/A and later
Oracle Database Cloud Exadata Service - Version N/A and later
Information in this document applies to any platform.


A VARRAY or TABLE is considered a single unit as far as binds and defines are concerned, and OCI will just return an opaque pointer to a collection. It is up to you to navigate through a collection, updating and inserting as necessary.

There are three sets of routines to support navigation :

  • OCIColl... General Collection routines
  • OCIIter... Iterator routines.
  • OCITable... Routines to handle additional properties of TABLE collections.

It is possible to manipulate collections by just using the OCIColl routines, but this would be impractical for TABLES with many 'holes', or deleted elements.

The basic argument lists are documented in the OCI8 manuals. The following gives a broader overview of how to use the collection routines.


To view full details, sign in with your My Oracle Support account.

Don't have a My Oracle Support account? Click to get started!

In this Document

My Oracle Support provides customers with access to over a million knowledge articles and a vibrant support community of peers and Oracle experts.