Proc 208e

Base de Datos Oracle: desarrollo de aplicaciones

Oracle Pro-C/C++

Contenidos jul-04

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador Alberto M.F.A. [email protected]

2

Características





jul-04

Se escribe todo en C/C++ Precompila SQL, valida sintaxis antes de ejecutar Se puede emplear cualquier sentencia SQL y PL/SQL Permite Threading Conversión de tipos C a Oracle Alberto M.F.A. [email protected]

3

Características



jul-04

Permite conexión simultanea a varios servidores Control cómodo de errores Soporta tipos objeto, LOBS, CLOBS Puede interactuar con OCI

Alberto M.F.A. [email protected]

4

Contenidos

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador

jul-04

Alberto M.F.A. [email protected]

5

Compilación

Exec

jul-04

Alberto M.F.A. [email protected]

6

Compilación detallada .h

.pc

.h

< >

PROC

Preproceso

.c

Compilación

.tmp

.exe VC++

01010 10101 11001

Linkage

.obj 01010 10101 11001

jul-04

01010 10101 11001

.lib

Alberto M.F.A. [email protected]

7

Compilación MVC++ 6.0



jul-04

Librerías solo para MSVC++ 6.0 El preprocesador proc.exe en %ORA_HOME%\bin Linkar con oraSQL8.lib y oraSQX8.lib en %ORA_HOME%\precomp\lib\msvc

Alberto M.F.A. [email protected]

8

Ficheros de inclusión





jul-04

Es necesario incluir en nuestro código: #include #include <sqlca.h> /*SQL Communications Area*/ está en %ORA_HOME%\oci\include <sqlca.h> está en %ORA_HOME%\precomp\public Alberto M.F.A. [email protected]

9

Invocación de proc.exe proc parse=FULL varios modos iname=$(InputName).pc oname=$(InputName).c include=“%ORA_HOME%\oci\include" include=“%ORA_HOME%\precomp\public" include="$(MSDEVDIR)\..\..\vc98\include“

Tiene más opciones ver: $>proc -h jul-04

Alberto M.F.A. [email protected]

10

Integración con VC++

Sobre .pc Botón derecho ratón Settings... Seleccionar Custom build Cuadro Commands...



Cuadro Outputs...

jul-04

%ORA_HOME%\bin\proc.exe parse=FULL ... $(InputName).c

Así para cada fichero .PC Incluir en el proyecto los generados .C Alberto M.F.A. [email protected]

11

Project Settings en VC++

jul-04

Alberto M.F.A. [email protected]

12

Línea de comando para precompilación sencila %ORA_HOME%\bin\proc.exe parse=FULL iname=$(InputName).pc oname=$(InputName).c include="%ORA_HOME%\oci\include“ include="%ORA_HOME%\precomp\public“ include="$(MSDEVDIR)\..\..\vc98\inc lude“ include="." jul-04

Alberto M.F.A. [email protected]

13

Estructura de ejecución Código .PC Código Pro-C/C++ SQLLIB OCI Net8 Interfaz propietario, no documentado jul-04

Alberto M.F.A. [email protected]

14

Contenidos jul-04

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador Alberto M.F.A. [email protected]

15

Código SQL incrustado



jul-04

Estructura: EXEC SQL <sentencia SQL> ; Se puede insertar en cualquier parte Se pueden referenciar variables del programa host

Alberto M.F.A. [email protected]

16

Código PL/SQL incrustado EXEC SQL EXECUTE DECLARE ... BEGIN ... END; END-EXEC; jul-04

Alberto M.F.A. [email protected]

17

Reglas para código incrustado

ite comentarios C y SQL Strings en SQL con ‘ ’ y NO “ ” Código C (prototipos de función):



jul-04

MODE=P MODE=KR_C MODE=ANSI_C

C++ Kernighan y Ritchie

Continuación strings EXEC SQL .... \ Alberto M.F.A. [email protected]

18

Contenidos

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador

jul-04

Alberto M.F.A. [email protected]

19

Variables host



Cualquier escalar o array Son de lectura/escritura para SQL y el programa host Esta asociación se denomina binding En C se referencian por el <nombre> En SQL por :<nombre>

jul-04

El nombre debe ser idéntico Alberto M.F.A. [email protected]

20

Ejemplo variables host int nEmpleado; //Esto es C ... EXEC SQL SELECT //Esto es PRO-C NVL(MAX(empno), 0) INTO :nEmpleado FROM emp; ... if (nEmpleado <> 0) // Esto es C { ... jul-04

Alberto M.F.A. [email protected]

21

Declare Section Declare Section: EXEC SQL BEGIN DECLARE SECTION; char *uid = "scott/tiger"; ... EXEC SQL END DECLARE SECTION;



jul-04

Necesaria si CODE=P o MODE=ANSI o PARSE=NONE o PARSE=PARTIAL Alberto M.F.A. [email protected]

22

Indicadores

Avisan de NULL y truncamientos

char emplName[14]; char emplJob[10]; short indJob; // Indicador EXEC SQL FETCH c INTO :emplName, :emplJob:indJob; jul-04

Alberto M.F.A. [email protected]

23

Indicadores

Son de entrada/salida Pueden usarse arrays como variables

Si se necesitan indicadores, otro array de la misma dimensión con solo indicadores

int vector[5]; //Valores int ind[5]; //Indicadores EXEC SQL INSERT INTO tbl (val) VALUES :vector:ind; jul-04

Alberto M.F.A. [email protected]

24

Indicadores, valores

0 Todo correcto -1 Valor leído/escrito es NULL -2 Truncamiento no determinable >0 Truncamiento, la longitud inicial es el valor

jul-04

Alberto M.F.A. [email protected]

25

Cursores



jul-04

Para las SELECT que devuelvan una sola fila no hace falta declararlos Para las SELECT múltiples si

Alberto M.F.A. [email protected]

26

Ejemplo Cursores EXEC SQL DECLARE <nombre> CURSOR FOR <sql>; ... EXEC SQL OPEN c; EXEC SQL WHENEVER NOT FOUND DO break; while(MORE_ROWS) { EXEC SQL FETCH c INTO ... Proceso ... } EXEC SQL CLOSE c; jul-04

Alberto M.F.A. [email protected]

27

Contenidos jul-04

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador Alberto M.F.A. [email protected]

28

Abrir la conexión





EXEC SQL CONNECT :_; EXEC SQL CONNECT : IDENTIFIED BY :; EXEC SQL CONNECT : IDENTIFIED BY : ALTER AUTHORIZATION :new;

jul-04

Alberto M.F.A. [email protected]

29

Conexión automática

OP$<name>



Trata de conectar automáticamente si:



jul-04

<name> en el S.O. Si opción de proc.exe AUTO_CONNECT=YES O en código char *oraid = “/”; Solo 1 char EXEC SQL CONNECT :oraid; Alberto M.F.A. [email protected]

30

Cerrar la conexión EXEC SQL COMMIT RELEASE;

Si el programa acaba sin COMMIT todo el trabajo perdido

EXEC SQL ROLLBACK RELEASE;

jul-04

Si se detecta error grave

Alberto M.F.A. [email protected]

31

Contenidos jul-04

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador Alberto M.F.A. [email protected]

32

Transacciones





Cada sentencia inicia una implícitamente Las sentencias DDL inician y terminan implícitamente Las sentencias DML hacen COMMIT o ROLLBACK cuando:

jul-04

EXEC SQL COMMIT/ROLLBACK [WORK]; Se inicia detrás una sentencia DDL Alberto M.F.A. [email protected]

33

Transacciones

Cuando el programa para por fallo software o hardware...



Todo las escrituras que haga el programa están dentro de una ÚNICA transacción hasta que se hace COMMIT o ROLLBACK Hacerlo con frecuencia

jul-04

Se produce un ROLLBACK automático

Excepción: Si por el medio se mete DDL

Alberto M.F.A. [email protected]

34

SavePoints

Dentro de una transacción compleja:

EXEC SQL SAVEPOINT start_delete; EXEC SQL DELETE FROM ...; EXEC SQL ROLLBACK TO SAVEPOINT start_delete; jul-04

Alberto M.F.A. [email protected]

35

Contenidos jul-04

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador Alberto M.F.A. [email protected]

36

Control de errores

Dos mecanismos:

Uso de la SQLCA



Si es necesaria más información también se usa ORACA

Uso de la sentencia WHENEVER

jul-04

Alberto M.F.A. [email protected]

37

SQLCA



jul-04

Es una struct C que almacena status de operaciones Inclusión, dos alternativas: EXEC SQL INCLUDE SQLCA; #include <sqlca.h>

Alberto M.F.A. [email protected]

38

Contenido de SQLCA

Entre otras cosas...

sqlca.sqlcode

jul-04

0 si OK, >0 NO_DATA, <0 Error grave

sqlca.sqlerrm.sqlerrmc mensaje de error sqlca.sqlerrm.sqlerrml longitud err. mens sqlca.sqlerrd[2] nº de filas procesadas sqlca.sqlerrd[4] nº de columna error parse sqlca.sqlwarm[0..7] varios warms Alberto M.F.A. [email protected]

39

WHENEVER EXEC SQL WHENEVER ;

Condiciones:

jul-04

SQLWARNING consultar SQLCA SQLERROR NOT FOUND última fila, no hay filas

Alberto M.F.A. [email protected]

40

Acciones WHENEVER

jul-04

CONTINUE DO <expresion_lenguaje> DO BREAK DO CONTINUE GOTO STOP

Alberto M.F.A. [email protected]

41

Ejemplos WHENEVER EXEC SQL WHENEVER NOT FOUND DO handle_error(); EXEC SQL WHENEVER SQLWARNING CONTINUE; EXEC SQL WHENEVER SQLERROR GOTO finaliza;

jul-04

Alberto M.F.A. [email protected]

42

Ejemplos WHENEVER EXEC SQL WHENEVER NOT FOUND DO break; while(MORE_ROWS) { EXEC SQL FETCH c INTO :emplName, :emplJob:indJob; ... Proceso ... } jul-04

Alberto M.F.A. [email protected]

43

Ámbito WHENEVER





jul-04

Su ámbito es posicional, no lógico Vigila todas las sentencias que físicamente siguen en el código ¡No vigila el flujo del programa! Una WHENEVER está activa hasta que otra la revoca Buena práctica: Una antes de cada SQL a vigilar Alberto M.F.A. [email protected]

44

Contenidos

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador

jul-04

Alberto M.F.A. [email protected]

45

Llamada a P/F almacenados

Dos métodos





jul-04

CALL BEGIN ... END

CALL cómodo para llamar a procedimientos y funciones BEGIN ... END única forma si el procedimiento devuelve un cursor Alberto M.F.A. [email protected]

46

CALL EXEC SQL CALL [schema.] [package.]stored_proc[@db_link]( arg1, ...) [INTO :ret_var [[INDICATOR]:ret_ind]] ;

jul-04

Alberto M.F.A. [email protected]

47

Ejemplo call ... int num, fact; ... EXEC SQL CALL mathpkge.fact(:num) INTO :fact ; ... jul-04

Alberto M.F.A. [email protected]

48

BEGIN ... END EXEC SQL EXECUTE BEGIN raise_salary(:emp, :increase); END; END-EXEC;

jul-04

Alberto M.F.A. [email protected]

49

Procedimientos y cursores

jul-04

Variable de tipo SQL_CURSOR Se inicializa (allocate) Se le pasa el proc almacenado Se recorren todas las filas Se cierra Se libera

Alberto M.F.A. [email protected]

50

Ejemplo Procs y cursores (1) SQL_CURSOR crsr; EXEC SQL ALLOCATE :crsr; EXEC SQL EXECUTE BEGIN proc(:id, :crsr); END; END-EXEC;

jul-04

Alberto M.F.A. [email protected]

51

Ejemplo Procs y cursores (y 2) EXEC SQL WHENEVER NOT FOUND ... while(MORE_ROWS) { EXEC SQL FETCH :crsr INTO ... } EXEC SQL CLOSE :crsr; EXEC SQL FREE :crsr; jul-04

Alberto M.F.A. [email protected]

52

Contenidos

Introducción Compilación Código incrustado Comunicación de variables Conexión Transacciones Control de errores Llamadas a procedimientos almacenados Más sobre el pre-compilador

jul-04

Alberto M.F.A. [email protected]

53

Compilación detallada #INCLUDE

.h

.pc

.h

.exe

PROC .c

Preproceso

Compilación

.tmp

01010 10101 11001

Linkage

.obj 01010 10101 11001

jul-04

01010 10101 11001

VC++

Alberto M.F.A. [email protected]

.lib 54

Precompilación condicional

Como la precompilación normal del compilador pero para Pro-C

jul-04

Alberto M.F.A. [email protected]

55

Ficheros de inclusión C

Pro-C interpreta la mayoría de las directivas del preprocesador C del compilador.



NO interpreta:

jul-04

#define, #ifdef, ... #pragma, #error, #line, #, ##

Alberto M.F.A. [email protected]

56

Opciones del precompilador

Muchas opciones se pueden dar desde la línea de comandos de proc.exe

También se pueden ajustar en código EXEC ORACLE OPTION( = );





jul-04

Está en efecto hasta que aparece otra OPTION en el mismo fichero. No pasan de un fichero a otro. Alberto M.F.A. [email protected]

57

Opciones si se usa PL/SQL ... ... o se desea chequeo estricto Más opciones en la línea de comandos: %ORA_HOME%\proc.exe ... SQLCHECK=SEMANTICS ID=/@instance Para solo algunas partes de código: EXEC ORACLE OPTION(SQLCHECK=SEMANTICS) PROC chequea contra el diccionario de datos



Se conecta con el servidor para precompilar ¡El servidor debe estar on-line!

jul-04

Alberto M.F.A. [email protected]

58

Algunas opciones

jul-04

Alberto M.F.A. [email protected]

59