Create Or Replace DDS with DDL

Size: px

Start display at page:

Download "Create Or Replace DDS with DDL"

Lee Simon
6 years ago
Views:

1 Schaumburg Create Or Replace DDS with DDL Birgitta Hauser / TOOLMAKER Advanced Efficiency GmbH Tel. (+49) Landsberg am Lech Seite 2 1

2 Agenda CREATE OR REPLACE TABLE Reverse Engineering DDS to DDL Conversion Example DDS described physical Files to SQL Tables DDS described keyed logical Files to SQL Indexes What about my (RPG) programs with native I/O? File References in Composition with SQL Tables Seite 3 Create or Replace Table Seite 4 2

CREATE OR REPLACE TABLE OR REPLACE Table replacement the necessary set of ALTER operations is performed Data-Centric Data is preserved Depending on the ON REPLACE clause Dependent and linked objects

3 CREATE OR REPLACE TABLE OR REPLACE Table replacement the necessary set of ALTER operations is performed Data-Centric Data is preserved Depending on the ON REPLACE clause Dependent and linked objects are preserved Primary/Unique Key Constraints, Referential Integrities, Check Constraints Indices, Views, MQTs, DDS described logical files SQL and System Triggers Granted object and access authorities are preserved Row and Column Access Control (RCAC) Comments and Labels preserved Before Multiple ALTER operations required Before Column clause allowed to add new columns on a specific position Existing Columns cannot not be moved ALTER TABLE based on any modification in a reference table not possible Seite 5 CREATE OR REPLACE TABLE Table Replacement the necessary set of ALTER TABLE statements is performed If ALTER TABLE does not support the action table is neither created nor replaced Before: Multiple ALTER/ADD COLUMN Clauses After With OR REPLACE Modifications are directly performed in the stored SQL script Script can be executed after Seite 6 3

CREATE OR REPLACE TABLE ON REPLACE Clause PRESERVE ALL ROWS Data is always preserved Columns can be dropped or altered PRESERVE ROWS Data is preserved, unless a range is eliminated from a partitioned

4 CREATE OR REPLACE TABLE ON REPLACE Clause PRESERVE ALL ROWS Data is always preserved Columns can be dropped or altered PRESERVE ROWS Data is preserved, unless a range is eliminated from a partitioned table If a specified range or partition name matches, the partition is preserved Columns can be dropped or altered DELETE ROWS All rows are deleted Delete triggers are not fired Seite 7 Reverse Engineering Seite 8 4

Reverse Engineer Self-Describing Database Must be possible to generate the SQL source code from the database object itself IBM i Navigator / Access Client

defined or DDS described GENERATE_SQL Stored Procedure Introduced with Release 7.

5 Reverse Engineer Self-Describing Database Must be possible to generate the SQL source code from the database object itself IBM i Navigator / Access Client Solutions (ACS) Wizard IBM i Navigator Database / ACS Schemas include Wizards for retrieving the SQL source code for any database object Independent whether SQL defined or DDS described GENERATE_SQL Stored Procedure Introduced with Release 7.2 TR 1 Provides the same functionality as the IBM i Navigator/ACS Wizard, but can called from within programs or SQL routines Seite 9 Reverse Engineering Generate SQL with ACS Position onto the database object Right Click Select Generate SQL Seite 10 5

6 Reverse Engineering Generate SQL with ACS Generate SQL Options Select OR REPLACE Clause Temporal Tables Release 7.3 Enhancements For keyed physical and logical files Select Generate Additional Indexes or Generate Index instead of view Seite 11 Reverse Engineering GENERATE_SQL (Stored Procedure) 34 Input parameters 3 required parameters: Database_Object_Name Database_Object_Library_Name Database_Object_Type Default Values defined for all other Parameters Optional parameters Can be passed as named parameters (Argument List) Seite 12 6

Reverse Engineering GENERATE_SQL (Stored Procedure) Important parameters for converting DDS described physical and logical files into SQL defined Database Objects CREATE_OR_REPLACE_OPTION Parameter

7 Reverse Engineering GENERATE_SQL (Stored Procedure) Important parameters for converting DDS described physical and logical files into SQL defined Database Objects CREATE_OR_REPLACE_OPTION Parameter ADDITIONAL_INDEX_OPTION Parameter INDEX_INSTEAD_OF_VIEW_OPTION Parameter Seite 13 DDS to SQL Example GENERATE_SQL (Stored Procedure) Database Object Information: Object, Object Library, Object Type Source File Information: Source File, Source File Library, Member Attention: Member must exist! Generate a CREATE OR REPLACE Statement Create additional indexes for keyed physical and logical files Attention: Parameters without Default Values cannot be passed as argumentlist element (i.e. ParmName => Value not allowed) must be specified directly (ParameterName or hardcoded!) Seite 14 7

8 DDS to SQL Conversion Example Seite 15 Create or Replace Table DDS to SQL - Example DDS described physical and logical files SALESL01 SALESP SALESL02 SALESL03 Seite 16 8

9 Samples Program consuming the SALESL02 logical File SALESL02 Program: Reads and aggregates the total sales for custno in 2009 Seite 17 Reverse Engineering Generate the SQL Code Generate SQL Statement Using IBM i Navigator Using the GENERATE_SQL stored procedure Important (when converting DDS to SQL) CREATE OR REPLACE clause must be selected / set IBM i Navigator: CREATE OR REPLACE Clause GENERATE_SQL: CREATE_OR_REPLACE_OPTION Parameter For keyed physical files additional indexes should be created: IBM i Navigator: Generate additional indexes (for keyed physical and logcial files) Option GENERATE_SQL: ADDITIONAL_INDEX_OPTION Parameter Seite 18 9

Additional Index Seite 19 DDS to SQL Example Generated/Modified SQL Script Generated SQL

10 DDS to SQL Example Generated SQL Script SQL Script DDS Description of the physical File Create or Replace Table Field/Colum Definition Format Column Heading and Textes Keys / Additional Index Seite 19 DDS to SQL Example Generated/Modified SQL Script Generated SQL Script Modified SQL Script Run the modified SQL Script Long SQL Names added Different Index Name Seite 20 10

DDS to SQL Example Convert logical Files into Indexes DDS described logical files are interpreted as Views View: Logical files: SQL indexes: unkeyed logical files traditionally used with native I/O

11 DDS to SQL Example Convert logical Files into Indexes DDS described logical files are interpreted as Views View: Logical files: SQL indexes: unkeyed logical files traditionally used with native I/O for keyed data access Most logical files include solely key information Join information and/or SELECT/OMIT clauses are less often used Key Information Can be used with native I/O like any keyed log. file Conversion logical files into SQL indexes better solution IBM i Navigator: Generate index instead of view (for keyed LF) GENERATE_SQL: Index_Instead_Of_View_Option Parameter Seite 21 DDS to SQL Example Convert logical Files into SQL Indexes SALESL01 Keyed logical files only Without any join Clause Without any SELECT/OMIT clause SALESL02 SALESL03 Create Index instead of view (for logical files) Option or Parameter Seite 22 11

12 IBM i Navigator Wizard Convert DDS described logical Files Select Option: Generate Index instead of view (for keyded logical files) Seite 23 DDS to SQL Example Convert logical Files into SQL Indexes Generated SQL Script All logical files converted into SQL Indexes Seite 24 12

Indexes Seite 25 Catalog-Views After logical Files Conversion SQL Indexes are not

13 DDS to SQL Example Convert logical Files into SQL Indexes Traditional Indexes Key Fields Record Format Run the SQL Script for converting the logical files into SQL Indexes Seite 25 Catalog-Views After logical Files Conversion SQL Indexes are not included in the SYSTABLES Catalog View SQL Indexes can be found in the SYSINDEXES Catalog View Seite 26 13

14 References and Create or Replace Table Seite 27 Creating Tables based on References SQL does not support Field Reference Files (directly) Contrary to DDS Can be circumvented with the OR REPLACE TABLE clause Creating Tables using an Select-Statement as Result Table Column Definition (i.e. Data Type, Length, Scale, Column Heading, Nullability, Field Procedures) is copied from the reference column Default Values and Attributes (such as Identity, Hidden or Row Change Timestamp Attribes) are not copied per default Copy Options can be specified to include default values and attributes INCLUDING COLUMN DEFAULTS or USING TYPE DEFAULTS INCLUDING IDENTITY COLUMN ATTRIBUTES INCLUDING IMPLICITLY HIDDEN COLUMN ATTRIBUTES INCLUDING ROW CHANGE TIMESTAMP COLUMN ATTRIBUTES Seite 28 14

Reference Table Example Identity Column Row Change Timestamp Column Reference Table with Identity Column and Row Change Timestamp Column Seite 29 Create or Replace Table based on the Reference

15 Reference Table Example Identity Column Row Change Timestamp Column Reference Table with Identity Column and Row Change Timestamp Column Seite 29 Create or Replace Table based on the Reference Table Create ADDRESSNEW Table based on an SELECT-Statement Based on the Reference Table Existing data is not replaced Identity Column and Row Change Timestamp Column Attributes are inherited Seite 30 15

Create Table based on Reference Table Column Information Long SQL and Short

Column Properties Row Change Timestamp Column Properties Seite 31 Populate

Timestamp Column (LASTUPD) and the Indentity Column (ADID) are populated

16 Create Table based on Reference Table Column Information Long SQL and Short System Column Names Data Type, Length, CCSID, Decimal Positions Identity Column Properties Row Change Timestamp Column Properties Seite 31 Populate the ADDRESSNEW Table Add data from the ADDRESSX Table The Row Change Timestamp Column (LASTUPD) and the Indentity Column (ADID) are populated automatically defined as GENERATED ALWAYS Extract from the ADDRESSNEW Table Seite 32 16

17 ADDRESSNEW Table Add new Columns Original CREATE OR REPLACE TABLE statement New column definitions added to the original CREATE OR REPLACE TABLE statement Seite 33 Table/Column Description after Enhancement New Columns Enhanced Table Seite 34 17

Adopting the Reference-Column Modifications The CREATE OR REPLACE TABLE Statement is simply

18 Reference Table Modification Varying Single Byte Character Columns are converted into varying Double Byte Character Columns with a different length (80 instead of 50 characters) Seite 35 Adopting the Reference-Column Modifications The CREATE OR REPLACE TABLE Statement is simply re-executed Column description after the rerun of the CREATE OR REPLACE TABLE statement Seite 36 18

Any Questions? Seite 37 Special Thanks to Deon (Kit) von Blerk For proof-reading/correcting the English translation of these presentations www.changefit.

19 Any Questions? Seite 37 Special Thanks to Deon (Kit) von Blerk For proof-reading/correcting the English translation of these presentations Holger Scherer For providing an AS/400 (IBM i-system) enabling the creation of the samples/code used in these presentations Your data is save! in the bunker Seite 38 19

20 References IBM i information center SQL Reference Database Embedded SQL Programming Database SQL Programming IBM developer works IBM i The Power of User Defined Table Functions Seite 39 Speaker s Biography Birgitta Hauser has been a Software and Database Engineer since 2008, focusing on RPG, SQL and Web development on IBM i at Toolmaker Advanced Efficiency GmbH in Germany. She graduated with a business economics diploma, and started programming on the AS/400 in She also works in consulting and education as a trainer for RPG and SQL developers. Since 2002 she has frequently spoken at the COMMON User Groups and other IBM i and Power Conferences in Germany, other European Countries, USA and Canada. In addition, she is co-author of two IBM Redbooks and also the author of several articles and papers focusing on RPG and SQL for a German publisher, ipro Developer and IBM DeveloperWorks. In 2015 she received the John Earl Speaker Scholarship Award. Seite 40 20

Create Or Replace DDS with SQL?! Yes i can! Tack så mycket! Birgitta Hauser Birgitta Hauser bha@toolmaker.de bha@toolmaker.de Hauser@SSS-Software.de Hauser@SSS-Software.de 09.10.

21 Create Or Replace DDS with SQL?! Yes i can! Tack så mycket! Birgitta Hauser Birgitta Hauser bha@toolmaker.de bha@toolmaker.de Hauser@SSS-Software.de Hauser@SSS-Software.de Seite 41 Data3 - Höstkonferensen Create Or Replace... DDS with DDL Birgitta Hauser Toolmaker Advanced Efficiency GmbH Westendstrasse Kaufering Tel. (+49)

SQL Let s Join Together

Schaumburg SQL Let s Join Together Birgitta Hauser bha@toolmaker.de / Hauser@SSS-Software.de TOOLMAKER Advanced Efficiency GmbH Tel. (+49) 08191 968-0 www.toolmaker.de Landsberg am Lech - Bayertor Seite