<Insert Picture Here> PL/SQL Packages nutzen Zeit und Aufwand sparen Carsten Czarski und Ulrike Schwinn

Transkript

1 <Insert Picture Here> PL/SQL Packages nutzen Zeit und Aufwand sparen Carsten Czarski und Ulrike Schwinn

2 PL/SQL Packages nutzen Zeit und Aufwand sparen Daten und Metadaten bewegen DBMS_METADATA, DBMS_DATAPUMP, DBMS_REDEFINITION Hilfsmittel für Programmierer DBMS_ASSERT, DBMS_UTILITY, DBMS_XPLAN, CTX_QUERY

3 Tabellen verändern: Online! DBMS_REDEFINITION Online-Änderungen an Speichereigenschaften (Komprimierung, Tablespace, IOT) Spalten (Datentyp, Löschen, Hinzufügen) Partitionierung... Enterprise Edition erforderlich Transformation Quelle Ziel Logge und Speichere DML Transformation

4 DBMS_REDEFINITION: Ablauf I 1. Überprüfe, ob die Tabelle "Redefinition-Fähig" ist DBMS_REDEFINITION.CAN_REDEF_TABLE( uname =>'SCOTT', tname =>'EMP1', options_flag => dbms_redefinition.cons_use_pk) 2. Erzeuge leere Interimstabelle mit neuen Eigenschaften 3. Starte den Redefinition-Prozeß DBMS_REDEFINITION.START_REDEF_TABLE( uname =>'SCOTT', orig_table =>'EMP1', int_table => 'EMP1_ZIEL', col_mapping =>'empno empno, ename ename, job job, to_lob(cv) cv, deptno+10 deptno, 0 bonus', orderby_cols =>'EMPNO')

5 DBMS_REDEFINITION: Ablauf II 4. Automatische Kopie der Triggern, Indizes etc. DBMS_REDEFINITION.COPY_TABLE_DEPENDENTS( uname =>'SCOTT', orig_table =>'EMP1', int_table =>'EMP1_INT', copy_indexes => dbms_redefinition.cons_orig_params, copy_triggers => true, copy_constraints => true, copy_privileges => true, ignore_errors => false, num_errors => error_count, copy_statistics => TRUE, copy_mvlog => FALSE); 5. Resync (optional) DBMS_REDEFINITION.SYNC_INTERIM_TABLE(uname =>'SCOTT', orig_table =>'EMP1', int_table =>'EMP1_INT') 6. Abschließen des Redefinition-Prozeß DBMS_REDEFINITION.FINISH_REDEF_TABLE(uname =>'SCOTT', orig_table =>'EMP1', int_table =>'EMP1_INT')

6 Beachte Einschränkungen: Tabellen von SYS und SYSTEM, keine Teilmengen... Mehr im Handbuch: ables007.htm#admin01510 Ausreichenden Speicherplatz reservieren Parallelisierung für Performance Mögliche Invalidierung von abhängigen Programmen Verbesserungen ab 11g Community Tipp:

7 Metadaten generieren DBMS_METADATA Genutzt von Data Pump, SQL Developer und anderen GET-Funktionen für einfaches Abrufen GET_DDL, GET_DEPENDENT_DDL, GET_GRANTED_DDL Beispiel für PL/SQL-Zugang 1.Handle öffnen 2.Filter setzen 3.Transformation festlegen 4.Fetch durchführen 5.Handle schließen Community Tipp:

8 DBMS_METADATA Codebeispiel für GET-Funktionen Einstellungen für Skript-Formatierung DBMS_METADATA.SET_TRANSFORM_PARAM(TRANSFORM_HANDLE=> DBMS_METADATA.SESSION_TRANSFORM, name=>'storage', value=>false); DBMS_METADATA.SET_TRANSFORM_PARAM(TRANSFORM_HANDLE=> DBMS_METADATA.SESSION_TRANSFORM, name=>'sqlterminator', value=>true); DBMS_METADATA.SET_TRANSFORM_PARAM(TRANSFORM_HANDLE=> DBMS_METADATA.SESSION_TRANSFORM,name=>'SEGMENT_ATTRIBUTES', value=>false); Table-Definition SELECT DBMS_METADATA.GET_DDL(object_type=>'TABLE', name=>'emp') FROM dual; CREATE TABLE "SCOTT"."EMP" ( "EMPNO" NUMBER(4,0), "ENAME" VARCHAR2(10), "JOB" VARCHAR2(9),..."DEPTNO" NUMBER(2,0), CONSTRAINT "PK_EMP" PRIMARY KEY ("EMPNO") ENABLE, CONSTRAINT "FK_DEPTNO" FOREIGN KEY ("DEPTNO") REFERENCES "SCOTT"."DEPT" ("DEPTNO") ENABLE ) ;

9 DBMS_METADATA Codebeispiel: II SELECT DBMS_METADATA.GET_DEPENDENT_DDL(object_type=>'TRIGGER', base_object_name=>'demo_users', base_object_schema=>'partner') FROM dual CREATE OR REPLACE TRIGGER "PARTNER"."BI_DEMO_USERS" BEFORE insert on "DEMO_USERS" for each row begin begin for c1 in ( select DEMO_USERS_SEQ.nextval next_val from dual ) loop :new.user_id := c1.next_val; :new.admin_user := 'N'; :new.created_on := sysdate; end loop; end; end; ALTER TRIGGER "PARTNER"."BI_DEMO_USERS" ENABLE

10 DBMS_METADATA API Codebeispiel: III CREATE OR REPLACE TYPE schema_info AS OBJECT(schema_zeile clob); / CREATE OR REPLACE TYPE schema_tabelle AS TABLE OF schema_info; / CREATE OR REPLACE FUNCTION get_schema_ddl return schema_tabelle pipelined is h NUMBER; -- Handle fuer OPEN th NUMBER; -- Handle fuer ADD_TRANSFORM doc clob; -- Metadata fuer CLOB PRAGMA AUTONOMOUS_TRANSACTION; begin h := DBMS_METADATA.OPEN(object_type=>'SCHEMA_EXPORT'); DBMS_METADATA.SET_FILTER(h,'SCHEMA','PARTNER'); DBMS_METADATA.SET_FILTER(h,'INCLUDE_PATH_EXPR','=''PROCEDURE'''); th := DBMS_METADATA.ADD_TRANSFORM(handle=>h, name=>'ddl'); LOOP doc := DBMS_METADATA.FETCH_CLOB(handle=>h);... END LOOP; RETURN; DBMS_METADATA.CLOSE(handle=>h); END;

11 DBMS_METADATA API Das Ergebnis set pagesize 0 long SELECT * FROM table(get_schema_ddl); CREATE OR REPLACE PROCEDURE "PARTNER"."DISPLAY_INTMEDIA_AUDIO" (p_id in varchar2) is v_mimetype varchar2(100); v_datei blob; v_groesse number; begin... CREATE OR REPLACE PROCEDURE "PARTNER"."SET_FONT_PATH" (p_fontpath in varchar2) is language java name 'SetFontPathHelper.setFontPath(java.lang.String)'; /... GRANT EXECUTE ON "PARTNER"."DISPLAY_INTMEDIA_AUDIO" TO PUBLIC /

12 Daten mit PL/SQL bewegen DBMS_DATAPUMP Data Pump = Neues, serverbasiertes Export / Import Eingeführt mit Oracle 10g Langfristig: Ablösung von "klassischem" exp/imp Schneller, mehr Möglichkeiten Serverbasiert Teil der Datenbank! PL/SQL-Zugang mit DBMS_DATAPUMP 1.Handle öffnen 2.DIRECTORY-Objekt festlegen und Datei allokieren 3.Metadaten-Filter einrichten 4.Datenfilter einrichten 5.Export-Job starten

13 DBMS_DATAPUMP Codebeispiel: I create or replace procedure export_table( p_table_name in varchar2 ) is v_dp_handle number; v_tname varchar2(30) := p_table_name; pragma AUTONOMOUS_TRANSACTION; begin -- Data Pump Handle allokieren v_dp_handle := dbms_datapump.open( operation => 'EXPORT', job_mode => 'TABLE' ); -- Verzeichnis-Objekt und Datei festlegen dbms_datapump.add_file( handle => v_dp_handle, filename => v_tname '_export.dmp', directory => 'DP_TEST_DIR' );

14 DBMS_DATAPUMP Codebeispiel: II : -- Nur die im Parameter angegebene Tabelle exportieren dbms_datapump.metadata_filter( handle => v_dp_handle, name => 'NAME_LIST', value => v_tname ); -- Export durchführen! dbms_datapump.start_job( handle => v_dp_handle ); -- Data Pump API erwartet COMMIT und autonome Transaktion commit; end;

15 DBMS_DATAPUMP am Beispiel 1. Tabelle auswählen

16 DBMS_DATAPUMP am Beispiel 2. Export läuft...

17 DBMS_DATAPUMP am Beispiel 3. Exportfile-Download per Browser! Community Tipp:

18 SQL Injection: DBMS_ASSERT Hilfspaket zum Vermeiden von SQL Injection-Löchern Bei dynamischem SQL immer(!) nutzen DBMS_SQL EXECUTE IMMEDIATE Stellt sicher, dass ein SQL-Parameter keine SQL Injection-Gefahr darstellt Nutzung vor dem "Einbau" in das SQL-Kommando Bei SQL Injection-Gefahr: Fehlermeldung

19 PL/SQL Paket DBMS_ASSERT Wie funktioniert es...? SQL> select dbms_assert.enquote_name('emp') from dual; DBMS_ASSERT.ENQUOTE_NAME('EMP' "EMP" SQL> select dbms_assert.enquote_name('emp" or 1=1') 2 from dual; select dbms_assert.enquote_name('emp" or 1=1') from dual * ERROR at line 1: ORA-06502: PL/SQL: numeric or value error ORA-06512: at "SYS.DBMS_ASSERT", line 308

20 DBMS_ASSERT: Funktionen Verschiedene Anwendungsfälle Einfacher Test von Literalen (einfaches Anführungszeichen) Einfacher Test von Objektnamen (doppeltes Anführungszeichen) Test, ob Objekte oder Schemas existieren Arbeitsweise: Rückgabe des Parameters, wenn OK PL/SQL-Exception, wenn nicht OK FUNCTION ENQUOTE_LITERAL RETURNS VARCHAR2 FUNCTION ENQUOTE_NAME RETURNS VARCHAR2 FUNCTION QUALIFIED_SQL_NAME RETURNS VARCHAR2 FUNCTION SCHEMA_NAME RETURNS VARCHAR2 FUNCTION SIMPLE_SQL_NAME RETURNS VARCHAR2 FUNCTION SQL_OBJECT_NAME RETURNS VARCHAR2

21 Dokumente umwandeln CTX_QUERY.POLICY_FILTER Wandelt in Binärformat (Office) in HTML um Vorschau in einer Webanwendung bereitstellen Bestandteil von Oracle TEXT begin ctx_ddl.create_policy( policy_name => 'filter_policy', ); end; filter => 'CTXSYS.AUTO_FILTER' begin ctx_doc.policy_filter( policy_name => 'filter_policy', document => p_document, restab => l_data ); return l_data; end;

22 Binärdokumente umwandeln Original...

23 Binärdokumente umwandeln... und HTML-Ansicht Community Tipp:

24 Ausführungspläne: Wie? Werkzeuge EXPLAIN PLAN SQL*Plus SET AUTOTRACE ON EXPLAIN SQL*Developer DBMS_XPLAN Erzeugt Ausführungspläne aus unterschiedlichen Quellen Parametrierung möglich Wird genutzt von Oracle Skripten aus $ORACLE_HOME/rdbms/admin utlxplp.sql für parallele Ausführung utlxpls.sql für serielle Ausführung

25 DBMS_XPLAN: einige Funktionen DISPLAY Voraussetzung: EXPLAIN PLAN DISPLAY_CURSOR Zeigt Informationen aus dem Cursor Cache DISPLAY_SQLSET DISPLAY_SQL_PLAN_BASELINE Einstellungen (BASIC, TYPICAL, ALL) Filterkriterien (MEMSTATS, IOSTATS etc.) möglich Voraussetzung: SELECT_CATALOG_ROLE

26 Verwendung von DISPLAY_CURSOR SQL> select * from table (dbms_xplan.display_cursor(sql_id=>null, cursor_child_no=>null, format =>'TYPICAL')); SQL_ID 4vgzr2d2ut0c2, child number select * from partner.basic_lob where ort='almeria' Plan hash value: Id Operation Name Rows Bytes Cost (%CPU) Time SELECT STATEMENT 2 (100) 1 TABLE ACCESS BY INDEX ROWID BASIC_LOB (0) 00:00:01 * 2 INDEX RANGE SCAN I_ORT 1 1 (0) 00:00: Predicate Information (identified by operation id): access("ort"='almeria') Note dynamic sampling used for this statement (level=2) - SQL plan baseline SQL_PLAN_5thm1dtkf3bmcd899dcfa used for this statement 24 rows selected.

27 DBMS_UTILITY Ein Package - viele Anwendungen Beispiele für Unterprogramme: Formatierung Messungen Informationen Kompilierung Warten auf Transaktionen COMMA_TO_TABLE TABLE_TO_COMMA GET_TIME GET_CPU_TIME DB_VERSION GET_DEPENDENCY GET_ENDIANNESS OLD_CURRENT_SCHEMA(USER) COMPILE_SCHEMA VALIDATE WAIT_ON_PENDING_DML

28 WAIT_ON_PENDING_DML Beispiel Wartet auf das Ende aller Transaktionen, die vor der SCN gestartet wurden und Locks auf den angegeben Tabellen halten CREATE OR REPLACE PROCEDURE wait_test AS v_bool BOOLEAN; v_scn NUMBER; BEGIN v_bool := dbms_utility.wait_on_pending_dml (tables => 'SCOTT.T',timeout => 10,scn => v_scn ); dbms_output.put_line( 'scn: ' v_scn ); IF v_bool THEN dbms_output.put_line( 'true' ); ELSE dbms_output.put_line( 'false' ); END IF; END; /

29 WAIT_ON_PENDING_DML Beispiel Fortsetzung Ohne Timeout Rückgabe "TRUE", wenn Transaktion zu Ende Mit Timeout TRUE für COMMIT oder ROLLBACK; sonst FALSE Session 1: Transaktion mit Lock auf Tabelle starten SQL> execute insert_test; Session 2: Monitoring der Session Timeout 10s "False": Transaktion in Session 1 noch nicht beendet SQL> execute wait_test scn: false

30 Weitere Informationen... Communities DBA Community APEX Community Handbücher PL/SQL Packages and Types Reference Tipp: Kapitel 1: What's new?

31 Fragen A n t w o r t e n