Oracle® Multimedia User's Guide 12c Release 2 (12.2) E85857-01 July 2017 Oracle Multimedia User's Guide, 12c Release 2 (12.2) E85857-01 Copyright © 1999, 2017, Oracle and/or its affiliates. All rights reserved. Primary Author: Sue Pelski Contributors: Robert Abbott, Melliyal Annamalai, Susan Mavris, Valarie Moore, David Noblet, James Steiner, Manjari Yalavarthy, Jie Zhang 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 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 installed on the hardware, and/or documentation, delivered to U.S. Government end users are "commercial computer software" pursuant to the applicable Federal Acquisition Regulation and agency- specific supplemental regulations. As such, use, duplication, disclosure, modification, and adaptation of the programs, including any operating system, integrated software, any programs installed on the hardware, and/or documentation, shall be subject to license terms and license restrictions applicable to the programs. 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 and Java are registered trademarks of Oracle and/or its affiliates. Other names may be trademarks of their respective owners. Intel and Intel Xeon 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, Opteron, the AMD logo, and the AMD Opteron 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 xi Documentation Accessibility xi Related Documents xii Conventions xiii Changes in This Release for Oracle Multimedia User's Guide Changes in Oracle Database 12c Release 2 (12.2) xiv 1 Introduction to Oracle Multimedia 1.1 Oracle Multimedia Architecture 1-2 1.2 Object Relational Technology 1-3 1.3 Oracle Multimedia Capabilities 1-4 1.3.1 Oracle Multimedia Support for CDBs 1-7 1.3.2 Data Guard Rolling Upgrade Support for Oracle Multimedia 1-7 1.4 Audio Concepts 1-8 1.4.1 Digitized Audio 1-8 1.4.2 Audio Components 1-8 1.5 ORDDoc or Heterogeneous Media Data Concepts 1-9 1.5.1 Digitized Heterogeneous Media Data 1-9 1.5.2 Heterogeneous Media Data Components 1-9 1.6 Image Concepts 1-10 1.6.1 Digitized Images 1-10 1.6.2 Image Components 1-10 1.6.3 Metadata in Images 1-11 1.6.4 Medical Imaging (Deprecated) 1-11 1.6.5 Metadata Extraction 1-12 1.6.6 Image Processing 1-12 1.7 Video Concepts 1-13 1.7.1 Digitized Video 1-13 1.7.2 Video Components 1-13 iii 1.8 Loading Multimedia Data 1-14 1.9 Multimedia Storage and Querying 1-14 1.9.1 Storing Multimedia Data 1-15 1.9.2 Querying Multimedia Data 1-16 1.10 Accessing Multimedia Data 1-16 2 Oracle Multimedia Application Development 2.1 Developing Multimedia Applications Using SQL Developer 2-2 2.2 Developing Multimedia Applications Using Application Express 2-2 2.3 Developing Multimedia Applications Using Java and JDBC 2-2 2.3.1 Setting Up Your Environment for Java 2-3 2.3.2 Media Upload in Java 2-5 2.3.3 Retrieval of Image Properties in Java 2-7 2.3.4 Thumbnail Image Creation in Java 2-8 2.3.5 Handling Oracle Multimedia Exceptions in Java 2-9 2.3.5.1 Handling the Setting of Properties for Unknown Image Formats in Java 2-10 2.3.5.2 Handling Image Processing for Unknown Image Formats in Java 2-11 2.4 Developing Multimedia Applications Using PL/SQL 2-11 2.4.1 Setting Up Your Environment for PL/SQL 2-12 2.4.2 Media Upload in PL/SQL 2-12 2.4.3 Media Query in PL/SQL 2-13 2.4.4 Media Download in PL/SQL 2-14 2.4.5 Handling Oracle Multimedia Exceptions in PL/SQL 2-14 2.4.5.1 Handling the Setting of Properties for Unknown Image Formats in PL/SQL 2-15 2.4.5.2 Handling Image Processing for Unknown Image Formats in PL/SQL 2-16 2.5 Developing PL/SQL Web Applications 2-16 2.5.1 Using the PL/SQL Gateway and PL/SQL Web Toolkit 2-17 3 Oracle Multimedia PL/SQL Photo Album Sample Application 3.1 Overview of the PL/SQL Photo Album Sample Application 3-2 3.2 Running the PL/SQL Photo Album Sample Application 3-4 3.3 Description of the PL/SQL Photo Album Sample Application 3-5 3.3.1 Browsing the Photo Album 3-6 3.3.2 Adding Images to the Photo Album 3-10 3.3.3 Searching for Images by Keyword or Phrase 3-14 3.3.4 Viewing Full-Size Images 3-15 3.3.5 Examining Image Metadata 3-17 iv 3.3.6 Writing New XMP Metadata to Images 3-18 3.3.7 Searching for Images That Contain Specific Metadata Attributes 3-21 4 Oracle Multimedia Code Wizard Sample Application for the PL/SQL Gateway 4.1 Running the Code Wizard Sample Application 4-1 4.2 Description of the Code Wizard Sample Application 4-2 4.2.1 Creating a New DAD or Choosing an Existing DAD 4-2 4.2.2 Authorizing a DAD 4-4 4.2.3 Creating and Testing Media Upload and Retrieval Procedures 4-6 4.2.4 Creating a Media Upload Procedure 4-8 4.2.5 Creating a Media Retrieval Procedure 4-13 4.2.6 Using the PL/SQL Gateway Document Table 4-17 4.2.7 How Time Zone Information Is Used to Support Browser Caching 4-18 4.3 Sample Session: Using Images 4-19 4.4 Known Restrictions of the Oracle Multimedia Code Wizard 4-28 5 Working with Metadata in Oracle Multimedia Images 5.1 Metadata Concepts 5-1 5.2 Oracle Multimedia Image Metadata Concepts 5-2 5.3 Image File Formats 5-2 5.4 Image Metadata Formats 5-2 5.4.1 EXIF 5-2 5.4.2 IPTC–IIM 5-3 5.4.3 XMP 5-3 5.5 Representing Metadata Outside Images 5-3 5.6 Oracle Multimedia Image Metadata Examples 5-4 5.6.1 Creating a Table for Metadata Storage 5-4 5.6.2 Extracting Image Metadata 5-5 5.6.3 Embedding Image Metadata 5-6 5.7 Metadata References 5-8 6 Oracle Multimedia Tuning Tips for DBAs 6.1 Understanding the Performance Profile of Oracle Multimedia Operations 6-1 6.2 Choosing LOB Storage Parameters for Multimedia LOBs 6-4 6.2.1 SecureFiles LOBs 6-5 6.2.2 TABLESPACE 6-5 6.2.3 CACHE, NOCACHE, and CACHE READS 6-5 v 6.2.4 LOGGING and NOLOGGING 6-5 6.2.5 Example of Setting LOB Storage Options 6-6 6.3 Setting Database Initialization Parameters 6-7 A Managing Oracle Multimedia Installations A.1 Oracle Multimedia Installed Users and Privileges A-1 A.2 Installing and Configuring Oracle Multimedia A-2 A.2.1 Preinstallation Steps A-3 A.2.2 Installation and Configuration Steps A-4 A.3 Verifying an Installed Version of Oracle Multimedia A-5 A.4 Upgrading an Installed Version of Oracle Multimedia A-5 A.5 Downgrading an Installed Version of Oracle Multimedia A-5 B Extending Oracle Multimedia B.1 Supporting Other External Sources B-1 B.1.1 External Source Packages B-2 B.1.1.1 ORDPLUGINS.ORDX_FILE_SOURCE Package B-2 B.1.1.2 ORDPLUGINS.ORDX_HTTP_SOURCE Package B-4 B.1.1.3 Extending Oracle Multimedia to Support a New Data Source B-6 B.2 Supporting Other Media Data Formats B-8 B.2.1 Supporting Other ORDAudio Data Formats B-9 B.2.1.1 ORDPLUGINS.ORDX_DEFAULT_AUDIO Package B-9 B.2.1.2 Extending Oracle Multimedia to Support a New Audio Data Format B-10 B.2.2 Supporting Other ORDDoc Data Formats B-12 B.2.2.1 ORDPLUGINS.ORDX_DEFAULT_DOC Package B-12 B.2.2.2 Extending Oracle Multimedia to Support a New ORDDoc Data Format B-12 B.2.3 Supporting Other Video Data Formats B-13 B.2.3.1 ORDPLUGINS.ORDX_DEFAULT_VIDEO Package B-13 B.2.3.2 Extending Oracle Multimedia to Support a New Video Data Format B-15 B.2.4 Supporting Other Image Data Formats B-17 B.3 Supporting Media Data Processing B-17 B.3.1 Supporting Audio Data Processing B-17 B.3.2 Supporting Video Data Processing B-17 C Oracle Multimedia Sample Applications C.1 Oracle Multimedia