Oracle® Cloud

Using Oracle Autonomous Database

Serverless

F61232-31
February 2024
Oracle Cloud Using Oracle Autonomous Database Serverless,

F61232-31

Copyright © 2022, 2024, Oracle and/or its affiliates.

This software and related documentation are provided under a license agreement containing restrictions on
use and disclosure and are protected by intellectual property laws. Except as expressly permitted in your
license agreement or allowed by law, you may not use, copy, reproduce, translate, broadcast, modify, license,
transmit, distribute, exhibit, perform, publish, or display any part, in any form, or by any means. Reverse
engineering, disassembly, or decompilation of this software, unless required by law for interoperability, is
prohibited.

The information contained herein is subject to change without notice and is not warranted to be error-free. If
you find any errors, please report them to us in writing.

If this is software, software documentation, data (as defined in the Federal Acquisition Regulation), or related
documentation that is delivered to the U.S. Government or anyone licensing it on behalf of the U.S.
Government, then the following notice is applicable:

U.S. GOVERNMENT END USERS: Oracle programs (including any operating system, integrated software,
any programs embedded, installed, or activated on delivered hardware, and modifications of such programs)
and Oracle computer documentation or other Oracle data delivered to or accessed by U.S. Government end
users are "commercial computer software," "commercial computer software documentation," or "limited rights
data" pursuant to the applicable Federal Acquisition Regulation and agency-specific supplemental
regulations. As such, the use, reproduction, duplication, release, display, disclosure, modification, preparation
of derivative works, and/or adaptation of i) Oracle programs (including any operating system, integrated
software, any programs embedded, installed, or activated on delivered hardware, and modifications of such
programs), ii) Oracle computer documentation and/or iii) other Oracle data, is subject to the rights and
limitations specified in the license contained in the applicable contract. The terms governing the U.S.
Government's use of Oracle cloud services are defined by the applicable contract for such services. No other
rights are granted to the U.S. Government.

This software or hardware is developed for general use in a variety of information management applications.
It is not developed or intended for use in any inherently dangerous applications, including applications that
may create a risk of personal injury. If you use this software or hardware in dangerous applications, then you
shall be responsible to take all appropriate fail-safe, backup, redundancy, and other measures to ensure its
safe use. Oracle Corporation and its affiliates disclaim any liability for any damages caused by use of this
software or hardware in dangerous applications.

Oracle®, Java, MySQL and NetSuite are registered trademarks of Oracle and/or its affiliates. Other names
may be trademarks of their respective owners.

Intel and Intel Inside are trademarks or registered trademarks of Intel Corporation. All SPARC trademarks are
used under license and are trademarks or registered trademarks of SPARC International, Inc. AMD, Epyc,
and the AMD logo are trademarks or registered trademarks of Advanced Micro Devices. UNIX is a registered
trademark of The Open Group.

This software or hardware and documentation may provide access to or information about content, products,
and services from third parties. Oracle Corporation and its affiliates are not responsible for and expressly
disclaim all warranties of any kind with respect to third-party content, products, and services unless otherwise
set forth in an applicable agreement between you and Oracle. Oracle Corporation and its affiliates will not be
responsible for any loss, costs, or damages incurred due to your access to or use of third-party content,
products, or services, except as set forth in an applicable agreement between you and Oracle.
Contents
Preface
Audience xxv
Documentation Accessibility xxv
Related Documents xxv
Conventions xxvi

1 Overview
What's New 1-1
February 2024 1-2
January 2024 1-2
December 2023 1-3
November 2023 1-3
October 2023 1-4
September 2023 1-4
August 2023 1-5
July 2023 1-6
June 2023 1-7
May 2023 1-8
April 2023 1-9
March 2023 1-11
February 2023 1-12
January 2023 1-13
About Autonomous Database 1-13
What is Oracle Autonomous Database? 1-14
Key features 1-14
About Autonomous Database Workload Types 1-17
About Oracle Autonomous Data Warehouse 1-18
About Oracle Autonomous Transaction Processing 1-19
About Autonomous JSON Database 1-19
About Oracle APEX Application Development 1-20
Autonomous Database Region Availability 1-20
Always Free Autonomous Database 1-20

iii
 Get Help and Contact Support 1-25
Post Questions on Forums 1-25
Open a Support Ticket 1-25
Service Level Objectives (SLOs) 1-26
RTO and RPO Objectives 1-26
Built-In Tool Availability 1-27
Zero-Regression Service Level Objective 1-28
How Is Autonomous Database Billed? 1-29
Autonomous Database Billing Summary 1-29
Compute Models in Autonomous Database 1-31
ECPU Compute Model Billing Information 1-31
OCPU Compute Model Billing Information 1-36
Oracle Autonomous Database Serverless Features Billing 1-41
Oracle Autonomous Database Serverless Billing for Database Tools 1-47

2 Quick Start
Before You Begin 2-1
Autonomous Database 15 Minute Quick Start 2-2

3 Tasks
Provision an Autonomous Database 3-2
Connect to Autonomous Database 3-2
About Connecting to an Autonomous Database Instance 3-3
Secure Connections to Autonomous Database 3-4
Connect to Autonomous Database Through a Firewall 3-7
Using Application Continuity 3-7
Connect to Autonomous Database Using a Client Application 3-8
About Connecting to Autonomous Database Using a Client Application 3-9
Prepare for Oracle Call Interface, ODBC, and JDBC OCI Connections with Wallets
(mTLS) 3-9
Prepare for Oracle Call Interface, ODBC, and JDBC OCI Connections Using TLS
Authentication 3-12
Prepare for JDBC Thin Connections 3-13
Connect Microsoft .NET, Visual Studio Code, and Visual Studio with a Wallet
(mTLS) 3-14
Connect Microsoft .NET, Visual Studio Code, and Visual Studio Without a Wallet 3-15
Connect Node.js and other Scripting Languages (mTLS) 3-17
Connect Node.js, and Other Scripting Languages Without a Wallet 3-20
Connect Power BI and Microsoft Data Tools to Autonomous Database 3-22
Connect Python Applications to Autonomous Database 3-23

iv
 Download Database Connection Information 3-33
Download Client Credentials (Wallets) 3-34
Wallet README File 3-37
View TNS Names and Connection Strings for an Autonomous Database Instance 3-38
Connect to Autonomous Database Using Oracle Database Tools 3-40
Connect Oracle SQL Developer with a Wallet (mTLS) 3-41
Connect Oracle SQL Developer Without a Wallet 3-43
Connect Oracle SQL Developer (earlier than Version 18.2) with a Wallet (mTLS) 3-45
Connect SQL*Plus with a Wallet (mTLS) 3-47
Connect SQL*Plus Without a Wallet 3-47
Connect Oracle SQLcl Cloud with a Wallet (mTLS) 3-49
Connect Oracle SQLcl Cloud Without a Wallet 3-51
Connect with Built-In Oracle Database Actions 3-53
About Database Actions (SQL Developer Web) 3-53
Access Database Actions as ADMIN 3-54
Provide Database Actions Access to Database Users 3-55
Required Roles to Access Tools from Database Actions 3-56
Access Database Actions, Oracle APEX, Oracle REST Data Services, and
Developer Tools Using a Vanity URL 3-57
Connect with JDBC Thin Driver 3-57
JDBC Thin Connections with a Wallet (mTLS) 3-58
JDBC Thin TLS Connections Without a Wallet 3-66
Preparing for Oracle Call Interface Connections 3-67
Oracle Call Interface (OCI) Connections and Wallets (mTLS) 3-68
Oracle Call Interface (OCI) Connections with TLS Authentication 3-68
Predefined Database Service Names for Autonomous Database 3-68
Connect with Oracle Analytics Desktop 3-69
Connect with Oracle Analytics Cloud 3-69
Connection and Networking Options and Features 3-69
Using ACLs, VCNs, and Private Endpoints with Autonomous Database 3-70
Connect with Oracle Cloud Infrastructure FastConnect 3-73
Access Autonomous Database with VCN Transit Routing 3-73
Access Autonomous Database with Service Gateway 3-73
Use Database Resident Connection Pooling with Autonomous Database 3-73
Manage Users 3-74
Create Users on Autonomous Database 3-75
Create Users on Autonomous Database with Database Actions 3-76
Create Users on Autonomous Database - Connecting with a Client Tool 3-77
Unlock User Accounts on Autonomous Database 3-78
About User Passwords on Autonomous Database 3-78
Manage the Administrator Account on Autonomous Database 3-79

v
Remove Users 3-81
Manage User Profiles with Autonomous Database 3-82
Manage Password Complexity on Autonomous Database 3-84
Gradual Database Password Rollover for Applications 3-85
Manage User Roles and Privileges 3-86
Manage Users and User Roles on Autonomous Database - Connecting with
Database Actions 3-86
Manage User Privileges on Autonomous Database - Connecting with a Client Tool 3-87
Create and Update User Accounts for Oracle Machine Learning 3-89
Create User 3-89
Add Existing Database User Account to Oracle Machine Learning Components 3-90
Use Identity and Access Management (IAM) Authentication with Autonomous
Database 3-91
About Identity and Access Management (IAM) Authentication with Autonomous
Database 3-92
Prerequisites for Identity and Access Management (IAM) Authentication on
Autonomous Database 3-94
Enable Identity and Access Management (IAM) Authentication on Autonomous
Database 3-95
Create Identity and Access Management (IAM) Groups and Policies for IAM Users 3-96
Add IAM Users on Autonomous Database 3-98
Add IAM Roles on Autonomous Database 3-99
Create IAM Database Password for IAM Users 3-100
Connect to Autonomous Database with Identity and Access Management (IAM)
Authentication 3-101
Configure IAM Proxy Authentication 3-106
Disable Identity and Access Management (IAM) Authentication on Autonomous
Database 3-108
Notes for Using Autonomous Database Tools with Identity and Access
Management (IAM) Authentication 3-109
Use Azure Active Directory (Azure AD) with Autonomous Database 3-109
About Integrating Oracle Autonomous Database with Microsoft Azure AD 3-109
Enable Azure AD Authentication on Autonomous Database 3-115
Map Oracle Database Schemas and Roles for Azure AD 3-124
Azure AD Client Configuration and Access for Autonomous Database 3-125
Use Microsoft Active Directory with Autonomous Database 3-125
Prerequisites to Configure CMU with Microsoft Active Directory on Autonomous
Database 3-126
Configure CMU with Microsoft Active Directory on Autonomous Database 3-128
Kerberos Authentication for CMU with Microsoft Active Directory 3-130
Add Microsoft Active Directory Roles on Autonomous Database 3-134
Add Microsoft Active Directory Users on Autonomous Database 3-135
Tools Restrictions with Active Directory on Autonomous Database 3-136

vi
 Connect to Autonomous Database with Active Directory User Credentials 3-136
Verify Active Directory User Connection Information with Autonomous Database 3-137
Remove Active Directory Users and Roles on Autonomous Database 3-138
Disable Active Directory Access on Autonomous Database 3-138
Configure Kerberos Authentication with Autonomous Database 3-139
About Kerberos Authentication 3-139
Components of the Kerberos Authentication System 3-140
Enable Kerberos Authentication on Autonomous Database 3-141
Disable Kerberos Authentication on Autonomous Database 3-143
Notes for Kerberos Authentication on Autonomous Database 3-143
Create Credentials or Configure Policies and Roles 3-144
Manage Credentials 3-144
Create Credentials to Access Cloud Services 3-144
List Credentials 3-145
Delete Credentials 3-146
Configure Policies and Roles to Access Resources 3-146
Use Resource Principal to Access Oracle Cloud Infrastructure Resources 3-146
Use Amazon Resource Names (ARNs) to Access AWS Resources 3-152
Use Azure Service Principal to Access Azure Resources 3-161
Use Google Service Account to Access Google Cloud Platform Resources 3-167
Use Vault Secret Credentials 3-175
Load Data 3-186
View Data Pump Jobs and Import Data with Data Pump 3-187
About Data Loading 3-187
Load Data with Oracle Database Actions 3-188
Load Data from Files in the Cloud 3-189
Create Credentials and Copy Data into an Existing Table 3-190
Create Credentials and Load Data Pump Dump Files into an Existing Table 3-192
Load JSON on Autonomous Database 3-194
Monitor and Troubleshoot Loads 3-206
Examples for Loading Data into Autonomous Database 3-207
Import Data Using Oracle Data Pump on Autonomous Database 3-211
Export Your Existing Oracle Database to Import into Autonomous Database 3-211
Import Data Using Oracle Data Pump Version 18.3 or Later 3-212
Import Data Using Oracle Data Pump (Versions 12.2.0.1 and Earlier) 3-216
Access Log Files for Data Pump Import 3-219
Oracle Data Pump Import and Table Compression 3-220
Load Data from Local Files with Oracle Database Actions 3-220
Load Data into Existing Autonomous Database Table with Oracle Database Actions 3-221
Load Data or Query Data from Files in a Directory 3-224
Load Data from Local Files Using SQL*Loader 3-225

vii
 Use Data Pipelines for Continuous Load and Export 3-226
About Data Pipelines on Autonomous Database 3-226
Create and Configure Pipelines 3-230
Test Pipelines 3-236
Control Pipelines (Start, Stop, Drop, or Reset a Pipeline) 3-237
Monitor and Troubleshoot Pipelines 3-240
Use Oracle Maintained Pipelines 3-244
The Data Load Page 3-245
The Data Load Page 3-245
Transform Data Using Data Studio 3-327
The Data Transforms Page 3-327
Link Data 3-384
Link to Object Storage Data 3-384
Query External Data 3-386
Access ORC, Parquet or Avro file types 3-388
Access partitioned object storage data 3-391
Querying External Partitioned Data 3-404
Query Hybrid Partitioned Data 3-406
Query External Data Pump Dump Files 3-409
Query Big Data Service Hadoop (HDFS) Data from Autonomous Database 3-410
Integrate Data Lake metadata with Data Catalog 3-411
Query External Data with AWS Glue Data Catalog 3-433
Validate External Data 3-441
Validate External Partitioned Data 3-442
Validate Hybrid Partitioned Data 3-443
View Logs for Data Validation 3-444
Use Database Links 3-445
Create Database Links from Autonomous Database to Another Autonomous
Database 3-446
Create Database Links to an Oracle Database that is not an Autonomous
Database 3-459
Create Database Links to Non-Oracle Databases 3-474
Create Database Links from Other Databases to Autonomous Database 3-494
Drop Database Links 3-496
Call Web Services 3-496
Submit an HTTP Request to a Public Host with UTL_HTTP 3-497
Submit an HTTP Request to a Private Host with UTL_HTTP 3-498
Use Credential Objects to Set HTTP Authentication 3-500
Move Files 3-501
Create and Manage Directories 3-501
Create Directory in Autonomous Database 3-502
Drop Directory in Autonomous Database 3-503

viii
 List Contents of Directory in Autonomous Database 3-504
Access Network File System from Autonomous Database 3-504
Load Data from Directories in Autonomous Database 3-509
Copy Files Between Object Store and a Directory in Autonomous Database 3-510
Bulk Operations for Files in the Cloud 3-511
About Bulk File Operations 3-511
Bulk Copy Files in Cloud Object Storage 3-512
Bulk Move Files Across Cloud Object Storage 3-513
Bulk Download Files from Cloud Object Storage 3-514
Bulk Upload Files to Cloud Object Storage 3-515
Bulk Delete Files from Cloud Object Storage 3-515
Monitor and Troubleshoot Bulk File Loads 3-516
Notes for Bulk File Operations 3-518
Replicate Data 3-518
Replicate Data with Oracle GoldenGate 3-519
Export Data 3-519
Export Data to Object Store as CSV, JSON, or XML using EXPORT_DATA 3-520
Export JSON Data to Cloud Object Storage 3-521
Export Data as CSV to Cloud Object Storage 3-523
Export Data as Parquet to Cloud Object Storage 3-524
Export Data as XML to Cloud Object Storage 3-526
File Naming for Text Output (CSV, JSON, Parquet, or XML) 3-528
Export Data to a Directory Location 3-531
Export Data as CSV to a Directory 3-532
Export Data as JSON a Directory 3-533
Export Data as Parquet to a Directory 3-535
Export Data as XML to a Directory 3-537
Export Data to a Directory as Oracle Data Pump Files 3-538
Export Data with Data Pump to an Autonomous Database Directory 3-540
Use Data Pump to Create a Dump File Set on Autonomous Database 3-541
Move Dump File Set from Autonomous Database to Your Cloud Object Store 3-543
Export Data with Data Pump to Object Store 3-544
Use Oracle Data Pump to Export Data to Object Store Using CREDENTIAL
Parameter (Version 19.9 or Later) 3-545
Use Oracle Data Pump to Export Data to Object Store Setting
DEFAULT_CREDENTIAL Property 3-548
Export Data to Object Store as Oracle Data Pump Files using EXPORT_DATA 3-551
Download Dump Files, Run Data Pump Import, and Clean Up Object Store 3-553
Access Log Files for Data Pump Export 3-554
Oracle GoldenGate Capture for Oracle Autonomous Database 3-554
Data Sharing 3-555
Use Cloud Links for Read Only Data Access on Autonomous Database 3-555

ix
 About Cloud Links on Autonomous Database 3-556
Grant Cloud Links Access for Database Users 3-560
Register or Unregister a Data Set 3-561
Register a Data Set with Authorization Required 3-564
Register a Data Set with Offload Targets for Data Set Access 3-566
Find Data Sets and Use Cloud Links 3-569
Revoke Cloud Links Access for Database Users 3-571
Monitor and View Cloud Links Information 3-571
Define a Virtual Private Database Policy to Secure a Registered Data Set 3-572
Notes for Cloud Links 3-573
Share Data with Data Studio 3-575
The Data Share Tool 3-575
Develop 3-602
Create Applications with Oracle APEX 3-603
About Oracle APEX 3-604
Access Oracle APEX Administration Services 3-605
Create Oracle APEX Workspaces in Autonomous Database 3-606
Access Oracle APEX App Builder 3-607
Create Oracle APEX Developer Accounts 3-608
Load Data from the Cloud into Oracle APEX 3-609
Use JSON Data with Oracle APEX 3-610
Use Web Services with Oracle APEX 3-611
Send Email from Oracle APEX 3-612
Control Oracle APEX Upgrades 3-614
Access Oracle APEX, Oracle REST Data Services, and Developer Tools Using a
Vanity URL 3-618
Oracle APEX Limitations on Autonomous Database 3-618
Use JSON with Autonomous Database 3-620
Work with Simple Oracle Document Access (SODA) in Autonomous Database 3-621
Work with JSON Documents Using SQL and PL/SQL APIs on Autonomous
Database 3-623
Load JSON Documents with Autonomous Database 3-623
Import SODA Collection Data Using Oracle Data Pump Version 19.6 or Later 3-624
Develop RESTful Services in Autonomous Database 3-627
About Oracle REST Data Services in Autonomous Database 3-628
Access RESTful Services and SODA for REST 3-628
Develop with Oracle REST Data Services on Autonomous Database 3-629
Use SODA for REST with Autonomous Database 3-630
Access Oracle REST Data Services, Oracle APEX, and Developer Tools Using a
Vanity URL 3-636
About Customer Managed Oracle REST Data Services on Autonomous Database 3-636
Use Oracle Database API for MongoDB 3-637