DB2 Reference

ERserveriSeries

DB2 Universal Database for iSeries SQL ReferenceVersion 5

ERserveriSeries

DB2 Universal Database for iSeries SQL ReferenceVersion 5

Copyright International Business Machines Corporation 1998, 2001. All rights reserved. US Government Users Restricted Rights Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.

ContentsAbout DB2 UDB for iSeries SQL Reference . . . . . Standards Compliance . . . . . . . . . . . . . Who should read the SQL Reference book . . . . . . Assumptions Relating to Examples of SQL Statements How to Read Syntax Diagrams . . . . . . . . . Conventions for Describing Mixed Data Values . . . . Whats new for V5R1 in the SQL Reference book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . xxi . xxi . xxi . xxii . xxii . xxiii . xxiv . . . . . . . . . . . . . . . . . . . 1 . 1 . 1 . 2 . 2 . 2 . 2 . 3 . 3 . 3 . 4 . 4 . 4 . 5 . 6 . 7 . 9 . 9 . 10 . 10 . 10 . 12 . 12 . 16 . 18 . 20 . 21 . 22 . 22 . 24 . 26 . 27 . 28 . 29 . 29 . 29 . 30 . 31 . . . . . . 33 33 34 35 36 36

Chapter 1. Concepts . . . . . . . . . . . . . . . . . . . . . . . . . Relational Database . . . . . . . . . . . . . . . . . . . . . . . . . . Structured Query Language . . . . . . . . . . . . . . . . . . . . . . . Static SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . . Dynamic SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . Extended Dynamic SQL . . . . . . . . . . . . . . . . . . . . . . . Interactive SQL . . . . . . . . . . . . . . . . . . . . . . . . . . . SQL Call Level Interface (CLI) and Open Database Connectivity (ODBC) . . . . . | Java Database Connectivity (JDBC) and Embedded SQL for Java (SQLJ) Programs . Schemas . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Primary Keys and Unique Keys . . . . . . . . . . . . . . . . . . . . . . Referential Integrity . . . . . . . . . . . . . . . . . . . . . . . . . . Check Constraints . . . . . . . . . . . . . . . . . . . . . . . . . . Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Indexes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Aliases . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Packages and Access Plans . . . . . . . . . . . . . . . . . . . . . . Procedures . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Application Processes, Concurrency, and Recovery . . . . . . . . . . . . . . Threads . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Isolation Level. . . . . . . . . . . . . . . . . . . . . . . . . . . . Distributed Relational Database . . . . . . . . . . . . . . . . . . . . . Database Servers . . . . . . . . . . . . . . . . . . . . . . . . . CONNECT (Type 1) and CONNECT (Type 2) . . . . . . . . . . . . . . . Remote Unit of Work . . . . . . . . . . . . . . . . . . . . . . . . Application-Directed Distributed Unit of Work . . . . . . . . . . . . . . . Data Representation Considerations . . . . . . . . . . . . . . . . . . Character Conversion . . . . . . . . . . . . . . . . . . . . . . . . . Character Sets and Code Pages . . . . . . . . . . . . . . . . . . . . Coded Character Sets and CCSIDs . . . . . . . . . . . . . . . . . . . Default CCSID . . . . . . . . . . . . . . . . . . . . . . . . . . Sort Sequence . . . . . . . . . . . . . . . . . . . . . . . . . . . Authorization and Privileges . . . . . . . . . . . . . . . . . . . . . . Storage Structures . . . . . . . . . . . . . . . . . . . . . . . . . . Chapter 2. Language Elements . Characters . . . . . . . . . Tokens . . . . . . . . . . Identifiers . . . . . . . . . SQL Identifiers . . . . . . System identifiers . . . . . Copyright IBM Corp. 1998, 2001

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

. . . . . .

iii

Host Identifiers . . . . . . . . . . . . . . . . . . Naming Conventions . . . . . . . . . . . . . . . . . Qualification of Unqualified Object Names . . . . . . . . SQL Names and System Names: Special Considerations . . . Schemas and the SQL Path . . . . . . . . . . . . . . Aliases . . . . . . . . . . . . . . . . . . . . . . Authorization IDs and Authorization-Names . . . . . . . . . Examples . . . . . . . . . . . . . . . . . . . . Data Types . . . . . . . . . . . . . . . . . . . . . Binary Strings . . . . . . . . . . . . . . . . . . . Character Strings . . . . . . . . . . . . . . . . . Character Subtypes . . . . . . . . . . . . . . . . Graphic Strings . . . . . . . . . . . . . . . . . . Graphic Subtypes . . . . . . . . . . . . . . . . . Large Objects (LOBs) . . . . . . . . . . . . . . . . Numbers. . . . . . . . . . . . . . . . . . . . . Datetime Values . . . . . . . . . . . . . . . . . . DataLink Values . . . . . . . . . . . . . . . . . . User-Defined Types . . . . . . . . . . . . . . . . Promotion of Data Types . . . . . . . . . . . . . . . . Casting Between Data Types . . . . . . . . . . . . . . Assignments and Comparisons . . . . . . . . . . . . . Numeric Assignments . . . . . . . . . . . . . . . . String Assignments . . . . . . . . . . . . . . . . . Datetime Assignments . . . . . . . . . . . . . . . . DataLink Assignments . . . . . . . . . . . . . . . . Distinct Type Assignments . . . . . . . . . . . . . . Numeric Comparisons . . . . . . . . . . . . . . . . String Comparisons. . . . . . . . . . . . . . . . . Datetime Comparisons . . . . . . . . . . . . . . . Distinct Type Comparisons . . . . . . . . . . . . . . Rules for Result Data Types . . . . . . . . . . . . . . Binary String Operands . . . . . . . . . . . . . . . Character and Graphic String Operands . . . . . . . . . Numeric Operands . . . . . . . . . . . . . . . . . Datetime Operands . . . . . . . . . . . . . . . . . DATALINK Operands . . . . . . . . . . . . . . . . DISTINCT Type Operands . . . . . . . . . . . . . . Conversion Rules for Operations That Combine Strings . . . . Constants . . . . . . . . . . . . . . . . . . . . . Integer Constants . . . . . . . . . . . . . . . . . Floating-Point Constants . . . . . . . . . . . . . . . Decimal Constants . . . . . . . . . . . . . . . . . Binary-String Constants . . . . . . . . . . . . . . . Character-String Constants . . . . . . . . . . . . . . Graphic-String Constants . . . . . . . . . . . . . . Decimal Point . . . . . . . . . . . . . . . . . . . Delimiters . . . . . . . . . . . . . . . . . . . . Special Registers . . . . . . . . . . . . . . . . . . CURRENT DATE or CURRENT_DATE . . . . . . . . . CURRENT PATH, CURRENT_PATH, or CURRENT FUNCTION CURRENT SERVER or CURRENT_SERVER . . . . . . . CURRENT TIME or CURRENT_TIME . . . . . . . . . . CURRENT TIMESTAMP or CURRENT_TIMESTAMP . . . . CURRENT TIMEZONE or CURRENT_TIMEZONE . . . . . USER . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . PATH . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

37 37 42 44 44 44 45 46 47 49 49 50 50 51 51 53 53 56 57 58 59 61 63 64 66 67 68 69 69 71 71 72 72 72 73 74 74 75 75 76 76 76 77 77 77 78 79 79 80 80 80 81 81 81 82 82

iv

DB2 UDB for iSeries SQL Reference V5R1

Column Names . . . . . . . . . . . . . . . . Qualified Column Names . . . . . . . . . . . . Correlation Names . . . . . . . . . . . . . . Column Name Qualifiers to Avoid Ambiguity . . . . . Column Name Qualifiers in Correlated References . . Unqualified Column Names . . . . . . . . . . . References to Variables . . . . . . . . . . . . . References to Host Variables . . . . . . . . . . Host Structures in C, C++, COBOL, PL/I, and RPG . . . Host Structure Arrays in C, C++, COBOL, PL/I, and RPG . Functions . . . . . . . . . . . . . . . . . . Types of Functions . . . . . . . . . . . . . . Function resolution . . . . . . . . . . . . . . Method of finding the best fit . . . . . . . . . . Function Invocation . . . . . . . . . . . . . . Expressions . . . . . . . . . . . . . . . . . Without Operators . . . . . . . . . . . . . . With the Concatenation Operator . . . . . . . . . With Arithmetic Operators . . . . . . . . . . . Two Integer Operands . . . . . . . . . . . . . Integer and Decimal Operands . . . . . . . . . Two Decimal Operands . . . . . . . . . . . . Decimal Arithmetic in SQL . . . . . . . . . . . Floating-Point Operands . . . . . . . . . . . User-Defined Types as Operands . . . . . . . . Datetime Operands and Durations . . . . . . . . Datetime Arithmetic in SQL . . . . . . . . . . Precedence of Operations . . . . . . . . . . . CASE Expressions . . . . . . . . . . . . . CAST Specification . . . . . . . . . . . . . Predicates . . . . . . . . . . . . . . . . . Basic Predicate . . . . . . . . . . . . . . . Quantified Predicate . . . . . . . . . . . . . BETWEEN Predicate . . . . . . . . . . . . . EXISTS Predicate . . . . . . . . . . . . . . IN Predicate . . . . . . . . . . . . . . . . LIKE Predicate . . . . . . . . . . . . . . . NULL Predicate . . . . . . . . . . . . . . . Search Conditions . . . . . . . . . . . . . . . Examples . . . . . . . . . . . . . . . . . Chapter 3. Built-In Functions Column Functions . . . . . AVG . . . . . . . . . COUNT . . . . . . . COUNT_BIG . . . . . . MAX . . . . . . . . . MIN . . . . . . . . . STDDEV . . . . . . . SUM . . . . . . . . . VARIANCE or VAR . . . Scalar Functions . . . . . ABS or ABSVAL . . . . ACOS . . . . . . . . ANTILOG . . . . . . . ASIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . .

. 82 . 82 . 83 . 84 . 86 . 86 . 87 . 87 . 91 . 92 . 92 . 92 . 93 . 94 . 96 . 96 . 97 . 97 . 99 . 99 . 99 . 99 . 100 . 100 . 100 . 100 . 101 . 104 . 105 . 106 . 109 . 109 . 110 . 111 . 112 . 112 . 113 . 117 . 118 . 118 . . . . . . . . . . . . . . . 119 119 120 121 122 123 123 124 125 126 126 130 131 131 131

Contents

v

|

|

|

|

|

ATAN . . . . . . . . . . . . . . ATANH . . . . . . . . . . . . . . ATAN2 . . . . . . . . . . . . . . BIGINT . . . . . . . . . . . . . . BLOB . . . . . . . . . . . . . . CEILING . . . . . . . . . . . . . CHAR . . . . . . . . . . . . . . CHARACTER_LENGTH or CHAR_LENGTH CLOB . . . . . . . . . . . . . . COALESCE . . . . . . . . . . . . CONCAT . . . . . . . . . . . . . COS . . . . . . . . . . . . . . . COSH . . . . . . . . . . . . . . COT . . . . . . . . . . . . . . . CURDATE . . . . . . . . . . . . CURTIME . . . . . . . . . . . . . DATE . . . . . . . . . . . . . . DAY . . . . . . . . . . . . . . . DAYOFMONTH . . . . . . . . . . . DAYOFWEEK . . . . . . . . . . . DAYOFWEEK_ISO . . . . . . . . . DAYOFYEAR . . . . . . . . . . . DAYS . . . . . . . . . . . . . . DBCLOB . . . . . . . . . . . . . DECIMAL or DEC . . . . . . . . . . DEGREES . . . . . . . . . . . . DIFFERENCE . . . . . . . . . . . DIGITS . . . . . . . . . . . . . . DLCOMMENT . . . . . . . . . . . DLLINKTYPE . . . . . . . . . . . DLURLCOMPLETE . . . . . . . . . DLURLPATH . . . . . . . . . . . . DLURLPATHONLY . . . . . . . . . DLURLSCHEME . . . . . . . . . . DLURLSERVER . . . . . . . . . . DLVALUE . . . . . . . . . . . . . DOUBLE_PRECISION or DOUBLE . . . EXP . . . . . . . . . . . . . . . FLOAT . . . . . . . . . . . . . . FLOOR . . . . . . . . . . . . . . GRAPHIC . . . . . . . . . . . . . HASH . . . . . . . . . . . . . . HEX . . . . . . . . . . . . . . . HOUR . . . . . . . . . . . . . . IFNULL . . . . . . . . . . . . . . INTEGER or INT . . . . . . . . . . JULIAN_DAY . . . . . . . . . . . LAND . . . . . . . . . . . . . . LEFT . . . . . . . . . . . . . . LENGTH . . . . . . . . . . . . . LN . . . . . . . . . . . . . . . LNOT . . . . . . . . . . . . . . LOCATE . . . . . . . . . . . . . LOG or LOG10 . . . . . . . . . . . LOR . . . . . . . . . . . . . . . LOWER or LCASE . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

132 132 132 133 133 134 135 139 140 143 143 143 144 144 144 145 145 146 147 147 148 148 149 149 151 152 153 153 154 155 155 156 157 157 158 158 160 160 161 161 161 163 163 164 165 165 166 166 167 168 169 169 169 170 171 171

vi


|

|

| |

| |

|

|

LTRIM . . . . . . . MAX . . . . . . . . MICROSECOND . . . MIDNIGHT_SECONDS . MIN . . . . . . . . MINUTE . . . . . . MOD . . . . . . . MONTH . . . . . . NODENAME . . . . . NODENUMBER . . . NOW . . . . . . . NULLIF . . . . . . . PARTITION . . . . . PI . . . . . . . . . POSITION or POSSTR . POWER . . . . . . QUARTER . . . . . RADIANS . . . . . . RAND . . . . . . . REAL . . . . . . . ROUND . . . . . . RRN . . . . . . . . RTRIM . . . . . . . SECOND . . . . . . SIGN . . . . . . . SIN . . . . . . . . SINH . . . . . . . SMALLINT . . . . . SOUNDEX . . . . . SPACE . . . . . . . SQRT . . . . . . . STRIP . . . . . . . SUBSTRING or SUBSTR TAN . . . . . . . . TANH . . . . . . . TIME . . . . . . . TIMESTAMP . . . . . TIMESTAMPDIFF . . . TRANSLATE . . . . . TRIM . . . . . . . TRUNCATE or TRUNC . UCASE or UPPER . . VALUE . . . . . . . VARCHAR . . . . . VARGRAPHIC . . . . WEEK . . . . . . . WEEK_ISO . . . . . XOR . . . . . . . . YEAR . . . . . . . ZONED. . . . . . . Chapter 4. Queries Authorization . . . subselect . . . . select-clause . . from-clause . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

172 173 174 174 175 176 176 177 178 178 179 179 180 180 181 182 182 183 183 183 184 185 186 187 187 188 188 188 189 190 190 190 191 192 193 193 194 195 196 197 198 199 200 200 203 205 205 206 207 207 211 211 211 212 215

Contents

vii

where-clause . . . . . . . group-by-clause . . . . . . having-clause . . . . . . . Examples of a subselect . . . fullselect . . . . . . . . . . Examples of a fullselect . . . . select-statement . . . . . . . common-table-expression . . . order-by-clause . . . . . . . | fetch-first-clause . . . . . . update-clause . . . . . . . read-only-clause . . . . . . optimize-clause . . . . . . . isolation-clause . . . . . . . Examples of a select-statement .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

219 219 220 221 222 223 224 224 225 226 227 227 228 228 229 231 233 233 234 234 234 235 235 235 236 236 236 237 237 237 239 242 242 246 246 247 247 249 249 250 251 253 254 254 254 254 254 255 255 255 255 256 256 258 259

Chapter 5. Statements . . . . . . . . How SQL Statements Are Invoked . . . . Embedding a Statement in an Application Dynamic Preparation and Execution . . Static Invocation of a select-statement . Dynamic Invocation of a select-statement Interactive Invocation . . . . . . . SQL Return Codes . . . . . . . . . SQLCODE . . . . . . . . . . . SQLSTATE . . . . . . . . . . . SQL Comments . . . . . . . . . . Example . . . . . . . . . . . . ALTER TABLE . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . ADD COLUMN . . . . . . . . . . ALTER COLUMN . . . . . . . . . DROP COLUMN . . . . . . . . . ADD unique-constraint . . . . . . . ADD referential-constraint . . . . . . ADD check-constraint . . . . . . . DROP . . . . . . . . . . . . . Notes . . . . . . . . . . . . . Cascaded Effects . . . . . . . . . Examples . . . . . . . . . . . . BEGIN DECLARE SECTION . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Examples . . . . . . . . . . . . CALL . . . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Example . . . . . . . . . . . .

. . . . . . . . Program . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

viii


| | | | |

CLOSE . . . . . . . . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . . Example . . . . . . . . COMMENT ON . . . . . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Examples . . . . . . . . COMMIT . . . . . . . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . . Example . . . . . . . . CONNECT (Type 1) . . . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . . Examples . . . . . . . . CONNECT (Type 2) . . . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . . Examples . . . . . . . . CREATE ALIAS. . . . . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . . Examples . . . . . . . . CREATE DISTINCT TYPE . . . Invocation . . . . . . . . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . . Examples . . . . . . . . CREATE FUNCTION. . . . . Invocation . . . . . . . . Notes . . . . . . . . . CREATE FUNCTION (External) . Authorization . . . . . . . Syntax . . . . . . . . . Description . . . . . . . Notes . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

259 259 259 259 260 260 260 261 261 261 263 265 269 269 269 269 269 270 270 271 272 272 272 272 272 274 275 276 276 276 276 276 278 278 279 279 279 279 280 280 281 281 281 281 282 282 284 286 286 286 287 288 288 289 291 300

Contents

ix

| |

| | | | | |

| | | | | | | | | | | | | |

Example 1 . . . . . . . . . . Example 2 . . . . . . . . . . CREATE FUNCTION (Sourced) . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example 1 . . . . . . . . . . Example 2 . . . . . . . . . . CREATE FUNCTION (SQL) . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example 1 . . . . . . . . . . CREATE INDEX . . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Examples . . . . . . . . . . . CREATE PROCEDURE (External) . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . CREATE PROCEDURE (SQL) . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . CREATE SCHEMA . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . CREATE SCHEMA (Schema Processor) Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Examples . . . . . . . . . . . CREATE TABLE . . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . column-definition . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

300 301 301 301 303 305 307 307 308 308 308 308 310 314 314 315 315 315 315 316 317 317 317 317 317 318 320 325 326 326 327 327 327 329 332 332 333 333 333 333 333 333 334 334 334 334 334 335 336 336 337 337 337 339 342 343

x


|

| | | | | | |

LIKE . . . . . . . . . . . . unique-constraint . . . . . . . referential-constraint . . . . . . check-constraint . . . . . . . nodegroup-clause . . . . . . . Notes . . . . . . . . . . . Rules for System Name Generation Examples . . . . . . . . . . CREATE TRIGGER . . . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . Notes . . . . . . . . . . . Examples . . . . . . . . . . CREATE VIEW . . . . . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . Notes . . . . . . . . . . . Examples . . . . . . . . . . DECLARE CURSOR . . . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . Notes . . . . . . . . . . . Examples . . . . . . . . . . DECLARE PROCEDURE . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . Notes . . . . . . . . . . . Example . . . . . . . . . . DECLARE STATEMENT . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . Example . . . . . . . . . . DECLARE VARIABLE . . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . Notes . . . . . . . . . . . Example . . . . . . . . . . DELETE . . . . . . . . . . . Invocation . . . . . . . . . . Authorization . . . . . . . . . Syntax . . . . . . . . . . . Description . . . . . . . . . DELETE Rules . . . . . . . . Notes . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

351 351 352 353 354 354 356 357 357 357 358 359 360 364 367 368 368 368 369 369 371 372 373 373 373 374 374 376 377 379 379 379 380 381 386 386 386 386 386 386 386 386 387 387 387 388 388 388 389 389 390 390 391 391 392 392

Contents

xi

Examples . . . . . . DESCRIBE . . . . . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Notes . . . . . . . Example . . . . . . DESCRIBE TABLE . . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Notes . . . . . . . Example . . . . . . DISCONNECT . . . . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Notes . . . . . . . Examples . . . . . . DROP . . . . . . . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Examples . . . . . . END DECLARE SECTION . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Examples . . . . . . EXECUTE . . . . . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Notes . . . . . . . Example . . . . . . EXECUTE IMMEDIATE . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . Note . . . . . . . . Example . . . . . . FETCH . . . . . . . . Invocation . . . . . . Authorization . . . . . Syntax . . . . . . . Description . . . . . single-fetch . . . . . multiple-row-fetch . . . Notes . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

393 393 394 394 394 394 395 396 397 397 397 397 397 399 399 399 399 400 400 400 400 401 401 401 401 403 405 410 411 411 411 411 411 412 412 412 412 412 412 413 413 414 414 414 414 415 415 415 416 416 416 416 417 418 418 420

xii


Example . . . . . . . . . . . . FREE LOCATOR . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Example . . . . . . . . . . . . GRANT (Function or Procedure Privileges) Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Note . . . . . . . . . . . . . . Example . . . . . . . . . . . . GRANT (Package Privileges) . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Note . . . . . . . . . . . . . . Example . . . . . . . . . . . . GRANT (Table Privileges) . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . GRANT (User-Defined Type Privileges) . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Note . . . . . . . . . . . . . . Example . . . . . . . . . . . . INCLUDE . . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Example . . . . . . . . . . . . INSERT . . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . insert-multiple-rows . . . . . . . . INSERT Rules . . . . . . . . . . Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . LABEL ON . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

420 421 422 422 422 422 422 422 422 422 423 424 427 427 427 428 428 428 428 429 429 429 429 430 430 430 432 433 433 434 434 434 434 435 435 435 435 436 436 436 436 436 437 437 437 438 438 440 440 441 441 442 442 442 443 443

Contents

xiii

Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . LOCK TABLE . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Example . . . . . . . . . . . . OPEN . . . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Parameter Marker Replacement . . . Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . PREPARE . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Parameter markers . . . . . . . . Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . RELEASE . . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . RENAME . . . . . . . . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Examples . . . . . . . . . . . . REVOKE (Function or Procedure Privileges) Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Example . . . . . . . . . . . . REVOKE (Package Privileges) . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . . Description . . . . . . . . . . . Notes . . . . . . . . . . . . . Example . . . . . . . . . . . . REVOKE (Table Privileges) . . . . . . Invocation . . . . . . . . . . . . Authorization . . . . . . . . . . . Syntax . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

444 444 444 444 444 445 445 445 446 446 446 446 446 447 448 448 449 449 449 450 450 452 455 456 457 457 457 457 458 458 459 459 459 459 459 459 460 460 461 461 461 461 463 466 466 466 466 466 466 467 467 467 467 468 468 468

xiv


Description . . . . . . . . . . Notes . . . . . . . . . . . . Examples . . . . . . . . . . . REVOKE (User-Defined Type Privileges) Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . ROLLBACK . . . . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . SELECT INTO . . . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Examples . . . . . . . . . . . SET CONNECTION . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . SET OPTION . . . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Examples . . . . . . . . . . . SET PATH . . . . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . SET RESULT SETS . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . SET TRANSACTION . . . . . . . . Invocation . . . . . . . . . . . Authorization . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

468 469 470 470 470 470 470 471 471 471 471 472 472 472 472 472 473 473 473 473 474 474 475 475 475 475 475 476 477 477 477 477 477 477 481 489 489 489 489 490 490 490 490 491 491 491 491 491 491 492 492 492 492 492 493 493

Contents

xv

| | | | | | |

Notes . . . . Examples . . . SET variable . . . Invocation . . . Authorization . . Syntax . . . . Description . . Notes . . . . Examples . . . UPDATE . . . . Invocation . . . Authorization . . Syntax . . . . Description . . UPDATE Rules . Notes . . . . Examples . . . VALUES . . . . Invocation . . . Authorization . . Syntax . . . . Description . . Notes . . . . Examples . . . VALUES INTO . . Invocation . . . Authorization . . Syntax . . . . Description . . Notes . . . . Examples . . . WHENEVER . . . Invocation . . . Authorization . . Syntax . . . . Description . . Notes . . . . Example . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

493 494 494 494 494 494 495 496 496 496 496 496 497 498 500 501 501 502 502 502 503 503 503 503 504 504 504 504 504 505 506 506 506 506 506 506 507 507 509 510 510 511 511 512 512 512 513 513 513 513 514 514 514 514 514

Chapter 6. SQL Procedures, Functions, SQL procedure statement . . . . . . Syntax . . . . . . . . . . . . SQL control statements . . . . . . . Syntax . . . . . . . . . . . . assignment-statement . . . . . . . Syntax . . . . . . . . . . . . | Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . call-statement . . . . . . . . . . Syntax . . . . . . . . . . . . Description . . . . . . . . . . Notes . . . . . . . . . . . . Example . . . . . . . . . . . case-statement . . . . . . . . . . Syntax . . . . . . . . . . . .

and . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

xvi


| | | | |

| | | | |

| | | | | | |

Description . . . . Notes . . . . . . Examples . . . . . compound-statement . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . for-statement. . . . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . get-diagnostics-statement Syntax . . . . . . Description . . . . Example . . . . . goto-statement . . . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . if-statement . . . . . Syntax . . . . . . Description . . . . Example . . . . . leave-statement . . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . loop-statement . . . . Syntax . . . . . . Description . . . . Example . . . . . repeat-statement . . . Syntax . . . . . . Description . . . . Example . . . . . resignal-statement . . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . return-statement . . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . signal-statement . . . Syntax . . . . . . Description . . . . Notes . . . . . . Example . . . . . while-statement . . . . Syntax . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

515 515 515 516 516 517 519 519 520 520 520 520 521 521 521 521 522 523 523 523 523 523 524 524 524 524 525 525 525 525 525 525 525 526 526 526 526 526 526 527 527 527 527 528 529 529 529 529 529 530 530 530 531 531 532 532

Contents

xvii

Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 532 Appendix A. SQL Limits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 533 Appendix B. SQL Communication Area . . . . . . . . . . . . . . . . . . . . . . . 537 Field Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 537 INCLUDE SQLCA Declarations . . . . . . . . . . . . . . . . . . . . . . . . . . . 542 Appendix C. SQL Descriptor Area (SQLDA) . Field Descriptions . . . . . . . . . . . . Field Descriptions in an Occurrence of SQLVAR . Determining How Many SQLVAR Occurrences SQLTYPE and SQLLEN . . . . . . . . . SQLDATA or SQLNAME . . . . . . . . . Unrecognized and Unsupported SQLTYPES . . INCLUDE SQLDA Declarations . . . . . . . For C and C++ . . . . . . . . . . . . For COBOL . . . . . . . . . . . . . For ILE COBOL . . . . . . . . . . . For PL/I . . . . . . . . . . . . . . For ILE RPG/400 . . . . . . . . . . . . . . . . . . . . . . . . . . are Needed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 547 547 548 550 552 554 554 555 555 557 557 558 559

Appendix D. Reserved Words . . . . . . . . . . . . . . . . . . . . . . . . . . . 561 Appendix E. CCSID Values . . . . . . . . . . . . . . . . . . . . . . . . . . . . 563 Appendix F. Considerations for Using Distributed Relational Database. CONNECT (Type 1) and CONNECT (Type 2) Differences . . . . . . . Determining the CONNECT rules that apply . . . . . . . . . . . Connecting to Servers That Only Support Remote Unit of Work . . . . Appendix G. DB2 UDB for Notes . . . . . . . . SQL_LANGUAGES . . . SYSCHKCST . . . . . SYSCOLUMNS . . . . . SYSCST . . . . . . . SYSCSTCOL . . . . . SYSCSTDEP . . . . . SYSFUNCS . . . . . . SYSINDEXES . . . . . SYSJARCONTENTS . . . SYSJAROBJECTS . . . SYSKEYCST . . . . . SYSKEYS . . . . . . . SYSPACKAGE . . . . . SYSPARMS . . . . . . SYSPROCS . . . . . . SYSREFCST . . . . . SYSROUTINES. . . . . SYSTABLES . . . . . . SYSTRIGCOL . . . . . SYSTRIGDEP . . . . . SYSTRIGGERS . . . . SYSTRIGUPD . . . . . iSeries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Catalog . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . Views . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 577 582 582 582 585 587 588 589 589 595 596 596 597 601 602 602 602 603 604 605 608 611 611 616 618 618 619 622

| |

| | | |

xviii


SYSTYPES . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 622 SYSVIEWDEP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 626 SYSVIEWS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 627 Bibliography . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 629 Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 631

Contents

xix

xx


About DB2 UDB for iSeries SQL ReferenceThis book defines Structured Query Language (SQL) as supported by DB2 Query Manager and SQL Development Kit. It contains reference information for the tasks of system administration, database administration, application programming, and operation. This manual includes syntax, usage notes, keywords, and examples for each of the SQL statements used on the system.

Standards ComplianceDB2 UDB for iSeries Version 5 Release 1 complies with the following IBM and Industry SQL Standards: v ISO (International Standards Organization) 9075: 1992, Database Language SQL - Entry Level v ISO (International Standards Organization) 9075-4: 1996, Database Language SQL - Part 4: Persistent Stored Modules (SQL/PSM) v ANSI (American National Standards Institute) X3.135-1992, Database Language SQL - Entry Level v ANSI (American National Standards Institute) X3.1354: 1996, Database Language SQL - Part 4: Persistent Stored Modules (SQL/PSM) v IBM SQL Reference Version 2, SC26-8416.

Who should read the SQL Reference bookThis book is intended for programmers who want to write applications that will use SQL to access an iSeries database. It is assumed that you possess an understanding of system administration, database administration, or application programming for the iSeries server, as provided by the SQL Programming Concepts book and that you have some knowledge of the following: v COBOL for iSeries v ILE C compiler v VisualAge C++ for OS/400 v ILE COBOL compiler v Toolbox for Java or Developer Kit for Java v v v v v ILE RPG compiler iSeries PL/I REXX RPG III (part of RPG for iSeries) Structured Query Language (SQL)

References in this book to RPG and COBOL refer to the RPG or COBOL language in general. References to COBOL for iSeries, ILE COBOL for iSeries, RPG for iSeries, or RPG III (part of RPG for iSeries) refer to specific elements of the product where they differ from each other. This manual is a reference rather than a tutorial. It assumes you are already familiar with SQL programming. This manual also assumes that you will be writing applications solely for the iSeries server. If you need more information about using SQL statements, statement syntax, and parameters, see the SQL Programming Concepts book. If you are planning applications that are portable to other IBM environments, it will be necessary for you to refer to books for those environments in addition to this one (such as IBM SQL Reference Version 2, SC26-8416).

Copyright IBM Corp. 1998, 2001

xxi

Assumptions Relating to Examples of SQL StatementsThe examples of SQL statements shown in this guide are based on the sample tables in Appendix A of the SQL Programming Concepts book and assume the following: v They are shown in the interactive SQL environment or written in COBOL. EXEC SQL and END-EXEC are used to delimit an SQL statement in a COBOL program. A description of how to use SQL statements in a COBOL program is provided in the SQL Programming with Host Languages book. v Each SQL example is shown on several lines, with each clause of the statement on a separate line. v SQL keywords are highlighted. | v Table names used in the examples are the sample tables provided in Appendix A of the SQL Programming Concepts book and use the schema CORPDATA. Table names that are not provided in | that appendix should use schemas that you create. You can create a set of sample tables in your own | schema by issuing the following: | CALL QSYS.CREATE_SQL_SAMPLE (your-schema-name) | v Calculated columns are enclosed in parentheses, (). v The SQL naming convention is used. v The APOST and APOSTSQL precompiler options are assumed (although they are not the default in COBOL). Character-string constants within SQL and host language statements are delimited by apostrophes (). v A sort sequence of *HEX is used. Whenever the examples vary from these assumptions, it is stated.

How to Read Syntax DiagramsThroughout this book, syntax is described using the structure defined as follows: v Read the syntax diagrams from left to right, from top to bottom, following the path of the line. The symbol indicates the beginning of a statement. The symbol indicates that the statement syntax is continued on the next line. The symbol indicates that a statement is continued from the previous line. The symbol indicates the end of a statement. Diagrams of syntactical units other than complete statements start with the symbol and end with the symbol. v Required items appear on the horizontal line (the main path).required_item

v Optional items appear below the main path.required_item optional_item

If an optional item appears above the main path, that item has no effect on the execution of the statement and is used only for readability.optional_item required_item

v If you can choose from two or more items, they appear vertically, in a stack. If you must choose one of the items, one item of the stack appears on the main path.required_item required_choice1 required_choice2

If choosing one of the items is optional, the entire stack appears below the main path.

xxii


required_item optional_choice1 optional_choice2

If one of the items is the default, it will appear above the main path and the remaining choices will be shown below.default_choice required_item optional_choice optional_choice

v An arrow returning to the left, above the main line, indicates an item that can be repeated.

required_item

repeatable_item

If the repeat arrow contains a comma, you must separate repeated items with a comma., required_item repeatable_item

A repeat arrow above a stack indicates that you can repeat the items in the stack. v Keywords appear in uppercase (for example, FROM). They must be spelled exactly as shown. Variables appear in all lowercase letters (for example, column-name). They represent user-supplied names or values. v If punctuation marks, parentheses, arithmetic operators, or other such symbols are shown, you must enter them as part of the syntax.

Conventions for Describing Mixed Data ValuesWhen mixed data values are shown in the examples, the following conventions apply:

About DB2 UDB for iSeries SQL Reference

xxiii

Whats new for V5R1 in the SQL Reference book| | | | | | | | | | | | | | | | | The major new features covered in this book include: v SQL triggers v Expressions in LIKE patterns and Escape characters v CREATE TABLE LIKE v RIGHT OUTER JOIN v Allow ORs, LIKE predicates, IS NULL predicates, and BETWEEN predicates in an OUTER JOIN v FETCH FIRST N ROWS ONLY v VALUES statement in a trigger v Java functions v TIMESTAMPDIFF, PI, SPACE, GRAPHIC, MIDNIGHT_SECONDS, JULIAN_DAY, DAYOFWEEK_ISO, and WEEK_ISO scalar functions v Application-directed Distributed Unit of Work over TCP/IP v DRDA application server support of procedures with result sets v 2 gigabyte LOBs and 1 terabyte non-distributed tables v Scalar subselect in a select-list v The terms collection and schema are synonymous. In prior versions of this book, the term collection was generally used. This and future versions of this book will generally use the term schema, because it is the standard term used by most database products.

xxiv


Chapter 1. ConceptsDB2 UDB for iSeries SQL Reference describes the following concepts: v Relational Database v v v v v v v v v v v v v v v v v v v v v v v Structured Query Language Schemas on page 3 Tables on page 4 Keys on page 4 Primary Keys and Unique Keys on page 4 Referential Integrity on page 5 Check Constraints on page 6 Triggers on page 7 Indexes on page 9 Views on page 9 Aliases on page 10 Packages and Access Plans on page 10 Procedures on page 10 Catalog on page 12 Application Processes, Concurrency, and Recovery on page 12 Threads on page 16 Isolation Level on page 18 Distributed Relational Database on page 20 Application-Directed Distributed Unit of Work on page 24 Character Conversion on page 27 Sort Sequence on page 29 Authorization and Privileges on page 30 Storage Structures on page 31

Relational DatabaseA relational database is a database that can be perceived as a set of tables and can be manipulated in accordance with the relational model of data. The relational database contains a set of objects used to store, access, and manage data. The set of objects includes tables, views, indexes, and packages. There is only one relational database on any iSeries system. It consists of all the database objects stored locally on the iSeries system. The name of the local relational database can be assigned through the use of the ADDRDBDIRE (Add RDB Directory Entry) command. Other relational databases on other systems can be accessed remotely. The database manager is the name used generically to identify the iSeries Licensed Internal Code and the DB2 UDB for iSeries portion of the code that manages the relational database.

Structured Query LanguageStructured Query Language (SQL) is a standardized language for defining and manipulating data in a relational database. In accordance with the relational model of data, the database is perceived as a set of tables, relationships are represented by values in tables, and data is retrieved by specifying a result table that can be derived from one or more base tables. Copyright IBM Corp. 1998, 2001

1

SQL statements are executed by a database manager. One of the functions of the database manager is to transform the specification of a result table into a sequence of internal operations that optimize data retrieval. This transformation occurs when the SQL statement is prepared. This transformation is also known as binding. All executable SQL statements must be prepared before they can be executed. The result of preparation is the executable or operational form of the statement. The method of preparing an SQL statement and the persistence of its operational form distinguish static SQL from dynamic SQL. For more details, see the following topics: v Static SQL v Dynamic SQL v Extended Dynamic SQL v Interactive SQL v SQL Call Level Interface (CLI) and Open Database Connectivity (ODBC) on page 3 v Java Database Connectivity (JDBC) and Embedded SQL for Java (SQLJ) Programs on page 3

Static SQLThe source form of a static SQL statement is embedded within an application program written in a host language such as COBOL. The statement is prepared before the program is executed and the operational form of the statement persists beyond the execution of the program. A source program containing static SQL statements must be processed by an SQL precompiler before it is compiled. The precompiler checks the syntax of the SQL statements, turns them into host language comments, and generates host language statements to call the database manager. The preparation of an SQL application program includes precompilation, the preparation of its static SQL statements, and compilation of the changed source program.

Dynamic SQLA dynamic SQL statement is prepared during the execution of an SQL application. The operational form of the statement persists until the last SQL program leaves the call stack. The source form of the statement is a character string that is passed to the database manager by the program using the static SQL statement PREPARE or EXECUTE IMMEDIATE. SQL statements embedded in a REXX application are dynamic SQL statements. SQL statements submitted to the interactive SQL facility are also dynamic SQL statements.

Extended Dynamic SQLAn extended dynamic SQL statement is neither fully static nor fully dynamic. The QSQPRCED API provides users with extended dynamic SQL capability. Like dynamic SQL, statements can be prepared, described, and executed using this API. Unlike dynamic SQL, SQL statements prepared into a package by this API persist until the package or statement is explicitly dropped. For more information, see the OS/400 APIs information in the Programming category of the iSeries Information Center.

Interactive SQLAn interactive SQL facility is associated with every database manager. Essentially, every interactive SQL facility is an SQL application program that reads statements from a terminal, prepares and executes them dynamically, and displays the results to the user. Such SQL statements are said to be issued interactively. The interactive facilities for DB2 UDB for iSeries are invoked by the STRSQL command, the STRQM command, or the SQL Script support of Operations Navigator. For more information about the interactive facilities for SQL, see the Query Manager Use and SQL Programming Concepts books.

2


SQL Call Level Interface (CLI) and Open Database Connectivity (ODBC)| | | | | | | | | The DB2 Call Level Interface is an application programming interface in which functions are provided to application programs to process dynamic SQL statements. DB2 CLI allows users of any of the ILE languages to access SQL functions directly through procedure calls to a service program provided by DB2 UDB for iSeries. CLI programs can also be compiled using an Open Database Connectivity (ODBC) Software Developers Kit, available from Microsoft or other vendors, enabling access to ODBC data sources. Unlike using embedded SQL, no precompilation is required. Applications developed using this interface may

Documents

DB2 Reference