This preface contains:
The following are changes in Oracle Database PL/SQL Packages and Types Reference for Oracle Database 12c Release 2 (12.2).
The following features are new in this release:
Data Guard Database Compare
The new DBMS_DBCOMP
package lets you perform block comparison to detect lost writes or database inconsistencies between a primary database and one or more physical standby databases.
See DBMS_DBCOMP
Enhanced Java Debug Wire Protocol
Enhanced support for unified auditing, fine-grained auditing, and Transparent Data Encryption (TDE) column encryption for the creation of transparent sensitive data protection policies.
New package to perform Oracle File System operations (make, mount, and unmount)
See DBMS_FS
New package to manage foreground prespawned processes.
See DBMS_PROCESS
New package to identify interconnected databases and trace the system change number (SCN) flow across distributed databases.
See DBMS_TNS
New DBMS_HADOOP
package that provides a PL/SQL procedure called CREATE_EXTDDL_FOR_HIVE(),
that creates an Oracle external table for a given hive table.
See DBMS_HADOOP
New DBMS_HANG_MANAGER
package provides a method of changing some Hang Manager configuration parameters.
New package to validate data in tables used by analytic views and hierarchies.
See DBMS_HIERARCHY
New DBMS_JSON
package provides an interface for data-guide operations.
See DBMS_JSON
New package to format the output of queries to the DBA_FGA_AUDIT_TRAIL
, DBA_AUDIT_TRAIL
, UNIFIED_AUDIT_TRAIL
, and V$XML_AUDIT_TRAIL
auditing views
See DBMS_AUDIT_UTIL
New DBMS_INMEMORYADMIN
package to manage In-Memory FastStart (IM FastStart)
New DBMS_PDB_ALTER_SHARING
Error Handling Improvements for Oracle GoldenGate Integrated Replication
See DBMS_APPLY_ADM
Materialized Views: Refresh Statistics History
See DBMS_MVIEW_STATS
Enhancements for DBMS_DATA_MINING
package
Enhancements to the DBMS_DST
package:
See FIND_AFFECTED_TABLES Procedure (new parameter: parallel
)
Enhancements to the DBMS_LOB
package:
See
ISREMOTE Function (new)
CLOB2FILE Procedure (this procedure is removed from the DBMS_XSLPROCESSOR
package and added to the DBMS_LOB
package)
The transfer of the DBMS_XSLPROCESSOR
subprogram CLOB2FILE
to the DBMS_LOB
package.
New DBMS_PLSQL_CODE_COVERAGE package to collect PL/SQL Basic Block Coverage data
New Oracle Multimedia packages
New SDO_NFE package
See SDO_NFE
The following enhancements for the DBMS_REDACT
package:
Addition of the DBMS_REDACT.NULLIFY
function to create or alter Data Redaction policies that return null values, using DBMS_REDACT.ADD_POLICY
or DBMS_REDACT.ALTER_POLICY
. Also, the expression
parameter for these procedures supports more functions.
See
New procedures to support the management of named policy expressions:
See
Enhancements to the DBMS_PRIVILEGE_CAPTURE
package, to enable you to create a capture run to define the period of time during which a privilege capture takes place:
See
ENABLE_CAPTURE Procedure (updated)
DELETE_RUN Procedure (new)
Enhancements to the DBMS_SERVICE
package:
See
CREATE_SERVICE Procedure (new parameters: FAILOVER_RESTORE
, DRAIN_TIMEOUT
, and STOP_OPTION
)
MODIFY_SERVICE Procedure (new parameters: DRAIN_TIMEOUT
, FAILOVER_RESTORE
, and STOP_OPTION
)
STOP_SERVICE Procedure (new parameters: DRAIN_TIMEOUT
and STOP_OPTION
)
DBMS_SERVICE
new constants (FAILOVER_RESTORE_NONE
, FAILOVER_RESTORE_BASIC
, STOP_OPTION_NONE
, STOP_OPTION_IMMEDIATE
, and STOP_OPTION_TRANSACTIONAL
)
Enhancements to the DBMS_SPM
package:
See
CONFIGURE Procedure (new)
SET_EVOLVE_TASK_PARAMETER Procedure (new parameter FIND_ALTERNATE_PLANS
added to the procedure)
The DBMS_SQL
package has been enhanced to support more bind variable types. The DESC_REC4
RECORD Type and DESC_TAB4
TABLE Type are introduced to support longer identifiers.
See
Enhancements to the DBMS_SQLDIAG
package:
Enhancements to the DBMS_SQLPA
package:
See SET_ANALYSIS_TASK_PARAMETER Procedures (new parameters: EXECUTE_TRIGGERS
, NUM_ROWS_TO_FETCH
, and REPLACE_SYSDATE_WITH
)
Enhancements to the DBMS_XDB_CONFIG
package, to enable you to get and set remote HTTP and HTTPS port values, and to enable a global port value.
See
DBMS_XDB_CONFIG Constants (new constants: XDB_ENDPOINT_RHTTP
and XDB_ENDPOINT_RHTTPS
)
Enhancements to the DBMS_XMLSTORAGE_MANAGE
package:
See
The transfer of the DBMS_XSLPROCESSOR
subprograms CLOB2FILE
and READ2CLOB
to the DBMS_LOB
package.
DBMS_STATS
preference for automatic column group statistics
Scan rate and In-Memory Column Store (IM column store) statistics
New DBMS_STATS
preference to override preference settings
DBMS_STATS
monitoring statistics no longer need to be saved to disk
Active Data Guard support for SQL Tuning Advisor
Real-Time Database Operations monitoring enhancements
Optimizer Statistics Advisor, which diagnoses problems in the existing practices for gathering statistics, and then generates a report of findings and recommendations.
New DBMS_STATS
preference APPROXIMATE_NDV_ALGORITHM
New plsql_mode
parameter, which allows you to specify a PL/SQL capture mode with the DBMS_WORKLOAD_CAPTURE
package
New plsql_mode
parameter, which allows you to specify a PL/SQL replay mode with the DBMS_WORKLOAD_REPLAY
package
See
New rac_inst_list
parameter for the DBMS_WORKLOAD_REPLAY
package, which enables you to specify a list of Oracle Real Application Clusters (Oracle RAC) instances that will be used for replay
New parameters for the DBMS_WORKLOAD_REPLAY
package
See
rac_mode
: This parameter specifies replay options in an Oracle RAC environment.
query_only
: This parameter replays only the read-only queries of a workload capture.
New procedure for the DBMS_WORKLOAD_REPLAY
package that enables you to modify the DBA_WORKLOAD_GROUP_ASSIGNMENTS
view, which provides information about workload captures and their assigned instances
New procedure for the DBMS_WORKLOAD_REPLAY
package that enables you to specify SQL statements to be skipped or replaced during database replay
New procedures for the DBMS_AUDIT_MGMT
package. TRANSFER_UNIFIED_AUDIT_RECORDS
enables you to transfer unified audit records from the common logging interface (CLI) swap table to an internal unified audit relational table. This internal table, new for this release, is required for better read performance of the unified audit trail. ALTER_PARTITION_INTERVAL
changes the unified audit internal relational table’s partition interval.
See the following topics for more information:
New load_details
parameter for the DBMS_WORKLOAD_REPLAY
package that enables you to load the divergence and track commits data for a replay
Enhancements to DBMS_AQADM
package:
See
ALTER_QUEUE_TABLE Procedure (updated)
ALTER_SHARDED_QUEUE Procedure (updated)
CREATE_QUEUE_TABLE Procedure (updated)
CREATE_SHARDED_QUEUE Procedure (updated)
DROP_SHARDED_QUEUE Procedure (updated)
See DBMS_AQADM
New procedure for the DBMS_DBFS_CONTENT
package
Enhancements to DBMS_DBFS_CONTENT
package:
LOCKPATH Procedure (updated)
UNLOCKPATH Procedure (updated)
New procedure for the DBMS_DBFS_CONTENT_SPI
package
Enhancements to DBMS_DBFS_CONTENT_SPI
package:
LOCKPATH Procedure (updated)
UNLOCKPATH Procedure (updated)
Modification for the DBMS_RLS.ADD_POLICY
procedure. If you plan to include the INSERT
statement type, then you must ensure that the update_check
parameter is set to TRUE
.
See
List of deprecated features in Oracle Database 12c Release 2 (12.2) PL/SQL Packages and Types Reference.
The following features are deprecated in Oracle Database 12c Release 2 (12.2), and may be desupported in a future release:
Deprecation of the DBMS_DEBUG
package
Use DBMS_DEBUG_JDWP
instead.
Deprecation of the DBMS_JOB
package
Oracle recommends that you migrate to DBMS_SCHEDULER
, which provides a richer set of features and capabilities.
Deprecation of the following form DBMS_LOB.LOADFROMFILE
Procedure.
Use DBMS_LOB.LoadClobFromFile
or DBMS_LOB.LoadBlobFromFile
instead.
Deprecation of the UTL_FILE_DIR
initialization parameter
Use directory objects instead.
Deprecation of Oracle Multimedia SQL/MM Still Image Standard Support, including the Oracle Multimedia SQL/MM Still Image TYPES
Oracle recommends that you replace SQL/MM still image with ORDImage for image processing.
Deprecation of Oracle Multimedia DICOM support, including the ORDDicom TYPE, the ORD_DICOM package, and the ORD_DICOM_ADMIN package
There is no replacement for DICOM support in Oracle Database.
Deprecation of the following from the DBMS_UTILITY package:
DBMS_UTILITY.GET_PARAMETER_VALUE
function
DBMS_UTILITY.ANALYZE_PART_OBJECT
procedure
There are no replacements for these subprograms.
Deprecation of the DBMS_XSLPROCESSOR.CLOB2FILE
procedure
Use DBMS_LOB.CLOB2FILE
instead.
Deprecation of the DBMS_XSLPROCESSOR.READ2CLOB
function
Use DBMS_LOB.LOADCLOBFROMFILE
instead.
Deprecation of the following from the DBMS_AUDIT_MGMT
package:
DBMS_AUDIT_MGMT.FLUSH_UNIFIED_AUDIT_TRAIL
procedure
AUDIT_TRAIL_WRITE
mode of the AUDIT_TRAIL_PROPERTY
parameter of the DBMS_AUDIT_MGMT.SET_AUDIT_TRAIL_PROPERTY
procedure
There is no replacement because there is no longer any need to manually write audit records to disk. Starting with this release, audit records are written directly to an internal relational table, bypassing the common logging infrastructure queues.
List of desupported features in Oracle Database 12c Release 2 (12.2) PL/SQL Packages and Types Reference.
The following features are desupported in Oracle Database 12c Release 2 (12.2):
Desupport of Advanced Replication
The Oracle Database Advanced Replication feature is desupported in its entirety. The desupport of this feature includes all functionality associated with this feature: multimaster replication, updateable materialized views, hierarchical materialized views, and deployment templates. Read-only materialized views are still supported with basic replication.
Oracle recommends that you replace your use of Advanced Replication with Oracle GoldenGate.
Desupport of the following subprograms from the DBMS_XDB_ADMIN
package:
CREATEREPOSITORYXMLINDEX
XMLINDEXADDPATH
XMLINDEXREMOVEPATH
DROPREPOSITORYXMLINDEX
There is no replacement.