8.8 SDO_GEOR_ADMIN.listGeoRasterObjects

Format

SDO_GEOR_ADMIN.listGeoRasterObjects(
	list_option VARCHAR2 DEFAULT NULL,
        table_name  VARCHAR2 DEFAULT NULL
) RETURN SDO_STRING2_ARRAYSET;

Description

Lists the GeoRaster objects defined in the current schema or in all the schemas in the database.

Parameters

list_option
Type of GeoRaster objects to be listed.

The following STRING values are supported:

  • ALL: Specifies all types (REGISTERED or UNREGISTERED) of GeoRaster objects to be listed.
  • REGISTERED: Specifies only the REGISTERED GeoRaster objects to be listed.
  • UNREGISTERED: Specifies only the UNREGISTERED GeoRaster objects to be listed.
  • NULL (default): Specifies all types (REGISTERED or UNREGISTERED) of GeoRaster objects to be listed.
table_name
Name of the GeoRaster table.
  • The GeoRaster table name to be provided in the format, <schema_name>.<table_name>. If the <schema_name> is omitted, then the current user’s schema name is used.
  • If the table_name parameter is specified, only the GeoRaster objects in the specified table are listed. If this parameter is NULL, all the GeoRaster objects are listed.

Usage Notes

This function returns an array of comma-delimited list of GeoRaster objects with their registration status. The list contains the following information:

  • Schema name (only if you are connected as a user with DBA role)

  • GeoRaster table name

  • GeoRaster column name

  • RDT name

  • Raster ID

  • Status: registered (the GeoRaster object has been registered in the SYSDATA table) or unregistered (the GeoRaster object has not been registered in the SYSDATA table)

If you execute this function as a user with DBA role, then the function lists the GeoRaster objects defined in all the schemas in the database. Otherwise, it only lists the GeoRaster objects defined in the current schema.

Examples

The following example lists the GeoRaster objects defined in the current schema.

SELECT * FROM THE (SELECT SDO_GEOR_ADMIN.listGeoRasterObjects FROM DUAL);
 
COLUMN_VALUE
---------------------------------------------------------------------------------
SDO_STRING2_ARRAY('TEST_TABLE1', 'GEOR', 'RDT_REGULAR_01', '1', 'registered')
SDO_STRING2_ARRAY('TEST_TABLE2', 'GEOR', 'RDT_REGULAR_01', '2', 'registered')

The following example lists the registered GeoRaster objects in the table TEST_TABLE1 in the current schema.

SELECT * FROM THE (SELECT SDO_GEOR_ADMIN.listGeoRasterObjects(‘REGISTERED’, ‘TEST_TABLE1’ FROM DUAL);
 
COLUMN_VALUE
---------------------------------------------------------------------------------
SDO_STRING2_ARRAY('TEST_TABLE1', 'GEOR', 'RDT_REGULAR_01', '1', 'registered')