B Autonomous Data Warehouse for Experienced Oracle Database Users

This appendix provides information on using Autonomous Data Warehouse for experienced Oracle Database users with Autonomous Database on shared Exadata infrastructure.

For equivalent information about using Oracle Database features and options with Autonomous Database on dedicated Exadata infrastructure, see these resources:

About the Autonomous Data Warehouse Database

Autonomous Data Warehouse configures and optimizes your database for you. You do not need to perform administration operations for configuring the database. SQL commands used for database administration such as CREATE TABLESPACE are not available. Similarly, other administrative interfaces and utilities such as RMAN are not available.

Note:

Some features of Autonomous Data Warehouse are only available with the latest database release, Oracle Database 19c.

You may be using Autonomous Data Warehouse with Oracle Database 18c or Oracle Database 19c. The version you are using depends either on the region where you provision your database, or in regions where both releases are available, your selection of an Oracle Database release when you provision your database (you can also create a database by cloning).

See Oracle Database Versions and Availability by Region for more information.

Characteristics of an Autonomous Data Warehouse database:

  • The default data and temporary tablespaces for the database are configured automatically. Adding, removing, or modifying tablespaces is not allowed. Autonomous Database creates one tablespace or multiple tablespaces automatically depending on the storage size.

  • The database character set is Unicode AL32UTF8.
  • Compression is enabled by default. Autonomous Data Warehouse uses Hybrid Columnar Compression for all tables by default. You can specify different compression methods for your tables using the compression clause in your CREATE TABLE or ALTER TABLE commands.

  • Oracle Database Result Cache is enabled by default for all SQL statements. Changing the result cache mode is not allowed.

Accessing an Autonomous Data Warehouse database:

  • You do not have direct access to the database node. You can create and drop directories with CREATE DIRECTORY and DROP DIRECTORY, as described in Creating and Managing Directories on Autonomous Database. You can use DBMS_CLOUD procedures such as DBMS_CLOUD.DELETE_FILE, DBMS_CLOUD.GET_OBJECT, and DBMS_CLOUD.PUT_OBJECT with files and objects. You do not have direct access to the local file system.

Parallel Execution:

  • Parallelism is enabled by default. Degree of parallelism for SQL statements is set based on the number of OCPUs in the system and the database service the user is connecting to. For more information on database services see Managing Concurrency and Priorities on Autonomous Data Warehouse.

  • Parallel DML is enabled by default. If you do not want to run DML operations in parallel you can disable parallel DML in your session using the following SQL command:

    ALTER SESSION DISABLE PARALLEL DML;

    See VLDB and Partitioning Guide for more information on parallel DML operations.

Autonomous Data Warehouse Oracle Database 19c Features

If you are using Autonomous Data Warehouse with Oracle Database 19c, then there are additional database features available in the database.

Autonomous Data Warehouse with Oracle Database 19c includes features that:

  • Automate index management tasks, such as creating, rebuilding, and dropping indexes based on changes in the application workload.

    See Manage Automatic Indexing on Autonomous Database for more information.

  • Gather real-time statistics automatically while a conventional DML workload is running. Because statistics can go stale between stats gathering jobs, online statistics gathering for conventional DML helps the optimizer generate more optimal plans. Online statistics aim to reduce the possibility of the optimizer being misled by stale statistics.

    See Real-Time Statistics for more information.

  • Gather statistics automatically on a more frequent basis. High-Frequency Automatic Optimizer Statistics Collection complements the standard statistics collection job. By default, the collection occurs every 15 minutes, meaning that statistics have less time in which to be stale. High-Frequency Automatic Optimizer Statistics Collection is enabled by default.

    See Configuring High-Frequency Automatic Optimizer Statistics Collection for more information.

  • Quarantine execution plans for SQL statements, for example, statements that are terminated by the Resource Manager for consuming excessive system resources in an Oracle Database. Automatic SQL Quarantine based on Resource Manager consumption limit violations is disabled by default but any manually quarantined SQL statement will be honored.

    See Quarantine for Execution Plans for SQL Statements Consuming Excessive System Resources for more information.

  • Automatically assess the opportunity for SQL plan changes to improve the performance for known statements.

    See Managing the SPM Evolve Advisor Task for more information.

Restrictions for Database Initialization Parameters

Autonomous Data Warehouse configures database initialization parameters automatically when you provision a database. You do not need to set any initialization parameters to start using your service. But, you can modify some parameters if you need to.

List of Initialization Parameters that can be Modified

APPROX_FOR_AGGREGATION
APPROX_FOR_COUNT_DISTINCT
APPROX_FOR_PERCENTILE
AWR_PDB_AUTOFLUSH_ENABLED
CURSOR_SHARING
DDL_LOCK_TIMEOUT
FIXED_DATE
LDAP_DIRECTORY_ACCESS
MAX_IDLE_TIME
MAX_STRING_SIZE (See Restrictions for Data Types for details)
NLS_CALENDAR
NLS_COMP
NLS_CURRENCY
NLS_DATE_FORMAT
NLS_DATE_LANGUAGE
NLS_DUAL_CURRENCY
NLS_ISO_CURRENCY
NLS_LANGUAGE
NLS_LENGTH_SEMANTICS
NLS_NCHAR_CONV_EXCP
NLS_NUMERIC_CHARACTERS
NLS_SORT
NLS_TERRITORY
NLS_TIMESTAMP_FORMAT
NLS_TIMESTAMP_TZ_FORMAT
OPTIMIZER_CAPTURE_SQL_PLAN_BASELINES  (Allowed only with ALTER SESSION)
OPTIMIZER_IGNORE_HINTS
OPTIMIZER_IGNORE_PARALLEL_HINTS
OPTIMIZER_MODE
PLSCOPE_SETTINGS
PLSQL_CCFLAGS
PLSQL_DEBUG
PLSQL_OPTIMIZE_LEVEL
PLSQL_WARNINGS
QUERY_REWRITE_INTEGRITY
STATISTICS_LEVEL (Allowed only with ALTER SESSION)

For more information on initialization parameters see Oracle Database Reference. For more information on TIME_ZONE, see Database SQL Language Reference.

For more information on OPTIMIZER_IGNORE_HINTS and OPTIMIZER_IGNORE_PARALLEL_HINTS, see Manage Optimizer Statistics on Autonomous Data Warehouse.

Restrictions for SQL Commands

Autonomous Data Warehouse allows most of the SQL commands available in the Oracle Database. To ensure the security and the performance of Autonomous Data Warehouse, some SQL commands are restricted.

This section provides a list of SQL command limitations that are required to protect security and for performance integrity in Autonomous Data Warehouse. Most of the standard SQL and PL/SQL syntax and constructs used with the Oracle Database work in Autonomous Data Warehouse.

Note:

If you try to use a restricted SQL command the system reports:

ORA-01031: insufficient privileges

This error indicates that you are not allowed to run the SQL command in Autonomous Data Warehouse.

The following SQL statements are not available in Autonomous Data Warehouse:

SQL Statements with Restrictions in Autonomous Data Warehouse

The following DDL statements are available in Autonomous Data Warehouse with restrictions:

SQL Command Restrictions

ALTER PLUGGABLE DATABASE and ALTER DATABASE

Only the following clauses are allowed:

DATAFILE AUTOEXTEND ON

DATAFILE AUTOEXTEND OFF

DATAFILE RESIZE

DEFAULT EDITION

SET TIME_ZONE

SET CMU_WALLET

ALTER SESSION

Only the following clauses are allowed:

ADVISE COMMIT, ADVISE ROLLBACK, ADVISE NOTHING

CLOSE DATABASE LINK

ENABLE COMMIT IN PROCEDURE, DISABLE COMMIT IN PROCEDURE

ENABLE PARALLEL <QUERY|DDL|DML>, DISABLE PARALLEL <QUERY|DDL|DML>, FORCE PARALLEL <QUERY|DDL|DML>

ENABLE RESUMABLE, DISABLE RESUMABLE

SET DEFAULT_COLLATION

SET EDITION

SET ISOLATION_LEVEL

SET ROW ARCHIVAL VISIBILITY

SET TIME_ZONE

ALTER SYSTEM

ALTER SYSTEM is not allowed except ALTER SYSTEM SET and ALTER SYSTEM KILL SESSION. SET can only be used to set parameters listed in Restrictions for Database Initialization Parameters.

ALTER USER

The following clauses are ignored:

  • DEFAULT TABLESPACE

  • PROFILE

IDENTIFIED with the EXTERNALLY clause is not supported.

ALTER TABLE

For restrictions, see ALTER TABLE Restrictions.

CREATE TABLE

For restrictions, see CREATE TABLE Restrictions.

CREATE USER

The following clauses are ignored:

  • DEFAULT TABLESPACE

  • PROFILE

IDENTIFIED with the EXTERNALLY clause is not supported.

CREATE TABLE Restrictions

XMLType tables are not allowed.

The clauses not in this list are allowed.

Clause Comment

physical_properties

Ignored

logging_clause

Ignored

inmemory_table_clause

Ignored

ilm_clause

Ignored

organization index

Ignored

organization external

Ignored

cluster

Ignored

LOB_storage_clause

Ignored

Note:

For more information on CREATE TABLE, see Database SQL Language Reference.

ALTER TABLE Restrictions

The clauses not in this list are allowed.

Clause Comment

physical_attributes_clause

Ignored

logging_clause

Ignored

inmemory_table_clause

Ignored

ilm_clause

Ignored

allocate_extent_clause

Ignored

deallocate_unused_clause

Ignored

shrink_clause

Ignored

alter_iot_clauses

Ignored

modify_LOB_storage_clause

Ignored

Note:

For more information on ALTER TABLE, see Database SQL Language Reference.

Restrictions for Data Types

Autonomous Data Warehouse allows most of the data types available in the Oracle Database. To ensure the security and the performance of Autonomous Data Warehouse, some data types are restricted.

The following data types are not supported or have limited support in Autonomous Data Warehouse:

By default Autonomous Data Warehouse uses Hybrid Columnar Compression (HCC), and the following types are not supported for columns in tables created with HCC:

  • LONG

  • LONG RAW

Note:

If you create tables without compression, with NOCOMPRESS, or use another compression method other than HCC, then LONG and LONG RAW are supported.

Checking and Setting MAX_STRING_SIZE

By default Autonomous Data Warehouse uses extended data types and the value of MAX_STRING_SIZE is set to the value EXTENDED. With this setting you can specify a maximum size of 32767 bytes for the VARCHAR2, NVARCHAR2, and RAW data types. The default, EXTENDED, is the recommended setting and allows Autonomous Database to take full advantage of database capabilities.

Use DBMS_MAX_STRING_SIZE subprograms to check usage of extended data types and to change Autonomous Data Warehouse database to revert to the older style STANDARD, supporting a maximum size of 4000 bytes for VARCHAR2, NVARCHAR2, and RAW data types.

Note:

Using DBMS_MAX_STRING_SIZE.MODIFY_MAX_STRING_SIZE is a one-way change that cannot be reverted. After a database is switched back to the STANDARD style of supporting a maximum length of 4000 bytes for the VARCHAR2, NVARCHAR2, and RAW data types, you cannot re-enable EXTENDED data types.

The ADMIN user is granted EXECUTE privilege WITH GRANT OPTION clause on DBMS_MAX_STRING_SIZE. Oracle recommends that you do not GRANT EXECUTE on this package to other users.

  1. Check whether your environment can be reverted to the old style, STANDARD behavior:

    SELECT * FROM TABLE(DBMS_MAX_STRING_SIZE.CHECK_MAX_STRING_SIZE('STANDARD'));

    See CHECK_MAX_STRING_SIZE Function for more information.

  2. Check and correct all reported violations from Step 1, if applicable.

  3. After fixing any reported violations found in Step 1, if you want to revert to a maximum length of 4000 bytes for VARCHAR2, NVARCHAR2, and RAW data types, use DBMS_MAX_STRING_SIZE.MODIFY_MAX_STRING_SIZE as follows:

    EXEC DBMS_MAX_STRING_SIZE.MODIFY_MAX_STRING_SIZE('STANDARD');

    See MODIFY_MAX_STRING_SIZE Procedure for more information.

See Extended Data Types for details on extended data types.

For a list of Oracle data types see Oracle Database SQL Language Reference.

Managing Partitions, Indexes, and Materialized Views

Autonomous Data Warehouse allows manual creation of partitioned tables, indexes, and materialized views using the partitioning clause in the CREATE TABLE statement, the CREATE INDEX statement, and the CREATE MATERIALIZED VIEW statement respectively.

Oracle recommends that you do not manually create these structures, and leave performance optimizations to the Autonomous Data Warehouse. If you're a highly skilled Oracle Database tuning expert and decide to manually create these access structures, please be advised to test the impact of your manual tuning efforts on your full workload.

Restrictions and Notes for Database PL/SQL Packages

Lists Oracle Database PL/SQL packages with restrictions and notes in Autonomous Data Warehouse database.

Removed PL/SQL Packages

  • UTL_TCP

PL/SQL Packages Restrictions

  • UTL_HTTP Restrictions

    • Connections through IP addresses are not allowed.

    • Only HTTPS connections are allowed (HTTP and HTTP_PROXY are disallowed).

    • All web services must be secured. The only allowed ports are 443 and 8443. Your instance is preconfigured with an Oracle Wallet that contains more than 90 of the most commonly trusted root and intermediate SSL certificates. This Oracle Wallet is centrally managed and therefore you cannot consume 3rd party web services that are protected using self-signed SSL certificates.

    • The SET_AUTHENTICATION_FROM_WALLET procedure is disallowed.

    • The WALLET_PATH and WALLET_PASSWORD arguments for the CREATE_REQUEST_CONTEXT, REQUEST, and REQUEST_PIECES APIs are ignored.

    • Oracle Wallet configuration cannot be altered. All arguments for SET_WALLET API are ignored.

    • UTL_HTTP usage is audited by default. You cannot disable auditing for UTL_HTTP.

  • UTL_SMTP Restrictions

    • The only supported email provider is Oracle Cloud Infrastructure Email Delivery service. See Overview of the Email Delivery Service for more information.

    • Mail with an IP address in the host name is not allowed.

    • The only allowed ports are 25 and 587.

    • UTL_SMTP usage is audited by default. You cannot disable auditing for UTL_SMTP.

  • DBMS_NETWORK_ACL_ADMIN Restrictions

    • Granting ACL privileges on IP addresses is not allowed.

    • The http_proxy and use_passwords ACL privileges are not allowed.

See UTL_HTTP, UTL_SMTP, and DBMS_NETWORK_ACL_ADMIN in PL/SQL Packages and Types Reference for more information.

PL/SQL Packages Notes

  • UTL_HTTP Errors

    The following table shows error messages and possible causes for these error messages when using UTL_HTTP:

    Error Message Potential Cause

    ORA-12545: Connect failed because target host or object does not exist

    Target host or object does not exist or it is private.

    ORA-24247: network access denied by access control list (ACL)

    Access control list (ACL) for the specified host could not be found.

    ORA-29024: Certificate validation failure

    Certificate of the host does not exist or is not among the supported certificates.

  • UTL_HTTP Example

    Submit an HTTP request for the host www.example.com:

    -- Create an Access Control List for the host
    BEGIN
      DBMS_NETWORK_ACL_ADMIN.CREATE_ACL(acl         => 'http.xml',
                                        description => 'HTTP ACL',
                                        principal   => 'ADMIN',
                                        is_grant    => true,
                                        privilege   => 'connect');
     
      DBMS_NETWORK_ACL_ADMIN.ADD_PRIVILEGE(acl       => 'http.xml',
                                           principal => 'ADMIN',
                                           is_grant  => true,
                                           privilege => 'resolve');
     
      DBMS_NETWORK_ACL_ADMIN.ASSIGN_ACL(acl  => 'http.xml',
                                        host => 'www.example.com');
    END;
    /
    
    -- Set Oracle Wallet location (no arguments needed)
    BEGIN
       UTL_HTTP.SET_WALLET('');
    END;
    /
    
    -- Submit an HTTP request
    SELECT UTL_HTTP.REQUEST('https://www.example.com/') FROM dual;
    
    

Restrictions for Database Features

Autonomous Data Warehouse is built for data warehouse workloads. In some cases, features which are present in Oracle Database Enterprise Edition are not available in Autonomous Data Warehouse. Additionally, database features designed for administration are not available.

Restrictions for Oracle XML DB

The following describes support for Oracle XML DB features in Autonomous Data Warehouse databases. To ensure the security and the performance of Autonomous Data Warehouse, some Oracle XML DB features are restricted.

The following is supported, in addition to the features listed:

  • Full support for XMLQuery, XMLTable, and other SQL/XML standard functions

  • Indexing schema including functional indexes using SQL/XML expressions, Structured XMLIndex and XQuery Full Text Index

Note:

If you migrate tables containing XMLType columns to Autonomous Data Warehouse using Oracle Data Pump, you need to convert to Non-Schema Binary XML prior to using Oracle Data Pump Export (expdp).
Area XML DB Feature Supported in Autonomous Database More Information
Repository XML DB Protocol No Repository Access Using Protocols
Repository XML DB Resources No Oracle XML DB Repository Resources
Repository XML DB ACLs No Repository Access Control
Storage XML Schema Registration No XML Schema Registration with Oracle XML DB
Storage CLOB No Deprecated
Storage Object Relational No XML Schema and Object-Relational XMLType
Storage Binary XML Yes (Non schema-based only) XMLType Storage Models
Index Structured XML Index Yes XMLIndex Structured Component
Index XQuery Full Text Index Yes Indexing XML Data for Full-Text Queries
Index Unstructured XMLIndex No XMLIndex Unstructured Component
Packages XML DOM package Yes PL/SQL DOM API for XMLType (DBMS_XMLDOM)
Packages XML Parser Package Yes PL/SQL Parser API for XMLType (DBMS_XMLPARSER)
Packages XSL Processor (DBMS_XSLPROCESSOR) Yes PL/SQL XSLT Processor for XMLType (DBMS_XSLPROCESSOR)

For details on Oracle XML DB, see Oracle XML DB Developer's Guide.

Restrictions for Oracle Text

The following describes support for Oracle Text features in Autonomous Data Warehouse databases. To ensure the security and the performance of Autonomous Data Warehouse, some Oracle Text features are restricted.

Oracle Text Feature Supported in Autonomous Database More Information
All logging, and APIs which perform logging such as ctx_report.query_log_summary Not Supported QUERY_LOG_SUMMARY
File and URL datastore Not Supported Datastore Type
CREATE INDEX with BIG_IO option Not supported by default.Foot 1 Improved Response Time Using the BIG_IO Option of CONTEXT Index
OPTIMIZE_INDEX in rebuild mode Not supported by default.(see Footnote 1). OPTIMIZE_INDEX

Footnote 1 This is supported if you grant the privilege to create a trigger to the user (GRANT CREATE TRIGGER). You must also disable parallel DML at the session level (ALTER SESSION DISABLE PARALLEL DML).

For details on Oracle Text, see Oracle Text Application Developer's Guide.

Restrictions for Oracle Spatial and Graph

The following describes support for Oracle Spatial and Graph features in Autonomous Data Warehouse databases. To ensure the security and the performance of Autonomous Data Warehouse, some Oracle Spatial and Graph features are restricted.

Note:

Autonomous Database does not include Oracle Spatial and Graph 3-Dimensional geometry types and related operators, functions, or utilities.
Spatial Graph Feature Supported in Autonomous Database More Information
2D Geometry data types Yes SDO_GEOMETRY Object Type
2D Spatial operators Yes Spatial Operators
2D Spatial functions Yes SDO_GEOM Package (Geometry)
Coordinate Transformation Yes SDO_CS Package (Coordinate System Transformation)
Spatial Utility Functions (except GML and KML conversion functions) Yes SDO_UTIL Package (Utility)
Spatial Aggregate Functions Yes Spatial Aggregate Functions
Spatial indexing and querying features Yes

SQL Statements for Indexing Spatial Data

Spatial Query

2D Linear Referencing System Yes SDO_LRS Package (Linear Referencing System)
GeoJSON and JSON support for Spatial data types Yes

JSON and GeoJSON Support in Oracle Spatial and Graph

JSSDO_UTIL.TO_GEOJSON

SDO_UTIL.TO_JSON

SDO_UTIL.TO_JSON_VARCHAR

Location Tracking Server Yes SDO_TRKR Package (Location Tracking)
Spatial Analysis and Mining features Yes

Spatial Analysis and Mining

SDO_SAM Package (Spatial Analysis and Mining)

Flat Model for Point Cloud data Yes DO_PC_PKG.CLIP_PC_FLAT
RDF Graph No RDF Semantic Graph Overview
Property Graph Yes Spatial and Graph Property Graph Support Overview
Network Data Model No Network Data Model
GeoRaster No SDO_GEOR Package Reference
Routing Engine No Routing Engine
Geocoder No Geocoding Address Data
Spatial Visualization No Introduction to the Map Visualization Component
Topology Data Model No Topology Data Model Overview
Open Geospatial Consortium Web Services (WMS, WFS-T, C-SW, WCS, OpenLS) No

SDO_WFS_PROCESS Package (WFS Processing)

SDO_OLS Package (OpenLS)

GML No SDO_UTIL.TO_GMLGEOMETRY
Point Cloud Object Type No SDO_PC_PKG Package (Point Clouds)
Triangulated Irregular Network (TIN) types No SDO_TIN_PKG Package (TINs)

For details on Oracle Spatial and Graph, see Oracle Spatial and Graph Developer's Guide.

Restrictions for Oracle Application Express

Autonomous Data Warehouse supports Oracle Application Express. To ensure the security and the performance of Autonomous Data Warehouse, some Oracle Application Express features are restricted.

Restrictions for Oracle Flashback

Oracle Flashback Technology is a group of Oracle Database features that let you view past states of database objects or to return database objects to a previous state without using point-in-time media recovery.

To restore and recover your database to a point in time, see Restore and Recover your Autonomous Data Warehouse Database.

Oracle Flashback Feature Supported in Autonomous Database

DBMS_FLASHBACK

Yes except the procedure:

DBMS_FLASHBACK.TRANSACTION_BACKOUT

Flashback Data Archive

No

Flashback Drop

Yes

Flashback Query

Yes

Flashback Table

Yes

Flashback Transaction

No

Flashback Transaction Query

Yes

Flashback Version Query

Yes

See About Oracle Flashback Technology for information on using Flashback features.

Restrictions for Fast Application Notification (FAN)

Subscribing to Fast Application Notification (FAN) events is not supported with Autonomous Database and is not needed. The functionality provided by FAN is provided out of the box with Autonomous Database. You do not need to enable your application for FAN or subscribe to FAN events.

You can use Application Continuity to mask outages from your applications. See Enable and Disable Application Continuity for more information.

Recommended Client Settings for Common Drivers

  • ODP.Net: The Oracle Data Provider for .NET (ODP.Net) unmanaged provider supports Application Continuity out of the box. When connecting an ODP.Net application to your Autonomous Database, do not explicitly set HA events, application continuity, or onsConfig; accept the default settings.

  • JDBC (thin) driver: When using the Universal Connection Pool (UCP), disable Fast Connection Failover. For example:

    PoolDataSource.setFastConnectionFailoverEnabled(false)
  • Oracle Call Interface (OCI): Do not configure ONS servers in oraaccess.xml:

    <ons>
       <servers> 
       <!—Do not enter any values --> 
       </servers> 
    </ons>

    Also, do not configure the <fan> section:

    <fan>  
    <!-- only possible values are "trace" or "error" -->  
        <subscription_failure_action>
       </subscription_failure_action>  
    </fan>

List of Restricted and Removed Oracle Features

Lists the Oracle Database features that are not available in Autonomous Data Warehouse. Additionally, database features designed for administration are not available.

List of Removed Oracle Features

  • Oracle Real Application Testing

  • Oracle OLAP

  • Oracle R capabilities of Oracle Advanced Analytics

  • Oracle Industry Data Models

  • Oracle Tuning Pack

  • Oracle Database Lifecycle Management Pack

  • Oracle Data Masking and Subsetting Pack

  • Oracle Cloud Management Pack for Oracle Database

  • Oracle Multimedia

  • Java in DB

  • Oracle Workspace Manager