====== Rilascio SQL ======

===== Privilegi =====

Spesso accade che l'utente usato per eseguire stored procedures e statements SQL non coincida con l'utente a cui essi appartengono.
Per far si che tutto funzioni è necessario conferire all'utente di esecuzione i diritti su tali oggetti.
Questa operazione si ottiene con il comando **GRANT**.
\\ Tale comando assume sintassi differenti al variare dell'oggetto cui si riferisce. 
Tutte le operazioni seguenti devono essere fatte dall'utente proprietario dell'oggetto o da un utente amministratore.
\\ (Quello che segue è solo un promemoria, i parametri del comando variano al variare delle esigenze)

Per Procedure, Function, Packages è possibile attribuire solo il privilegio di esecuzione.
<code sql |h Procedure, Function, Packages>
Grant Execute on <Nome_Oggetto> to <Utente_di_Esecuzione>;
</code>

\\ Per le Sequence è possibile attribuire il privilegio di esecuzione,
<code sql |h Sequence (Esecuzione)>
Grant Select on <Nome_Oggetto> to <Utente_di_Esecuzione>;
</code>

\\ ed in casi più rari quello di modifica
<code sql |h Sequence (Modifica)>
Grant Alter on <Nome_Oggetto> to <Utente_di_Esecuzione>;
</code>

\\ Per le View solitamente si danno i privilegi di lettura
<code sql |h View (Lettura)>
Grant SELECT, QUERY REWRITE, FLASHBACK on <Nome_Oggetto> to <Utente_di_Esecuzione>;
</code>

\\ ma se la view è aggiornabile è necessario dare anche quelli di editing
<code sql |h View (Editing)>
Grant DELETE, INSERT, UPDATE on <Nome_Oggetto> to <Utente_di_Esecuzione>;
</code>

\\ Per le Table solitamente si danno i privilegi di lettura e di editing
<code sql |h Table>
Grant SELECT, QUERY REWRITE, FLASHBACK on <Nome_Oggetto> to <Utente_di_Esecuzione>;
Grant DELETE, INSERT, UPDATE, ON COMMIT REFRESH on <Nome_Oggetto> to <Utente_di_Esecuzione>;
</code>

\\ Questi comandi devono essere inclusi nell'eventuale script di creazione dell'oggetto.

===== Sinonimi =====
Un **sinonimo** è un nome alternativo per un qualsiasi oggetto del database.

==== Creazione ====
La sintassi è: 
<code sql>
create [or replace] [public] synonym [schema.]synonym_name for [schema.]object_name[@dblink];
</code>

  * **Or Replace**  -- Permette di sostituire un sinonimo senza doverlo prima distruggere con un comando DROP
  * **Public**      -- Rende il sinonimo visibile a tutti gli utenti (schema)
  * **Schema**      -- Indica lo schema, se omesso è quello corrente
  * **Object_Name** -- Il nome dell'oggetto per cui creare il sinonimo. L'oggetto può essere dei seguentri tipo:
    * Tabelle
    * Viste
    * Sequenze
    * Procedure 
    * Funzioni
    * Package
    * Sinonimi
    * Classi Java
    * Oggetti defini dall'utente

**Esempio:**
<code sql>
create public synonym connessioni for applic.connessioni;
</code>

==== Cancellazione ====
Per cancellare un sinonimo si usa il comando Drop.
<code sql>
drop [public] synonym [schema.]synonym_name [force];
</code>

  * **Public** -- Consente di cancellare un sinonimo pubblico
  * **Force**  -- Forza la cancellazione del sinonimo anche se in uso. Gli oggetti che ne facevano uso rimarranno invalidi.  

**Esempio:**
<code sql>
drop public synonym connessioni force;
</code>

===== Scripts =====
Uno script è un insieme di comandi SQL e non che può essere eseguito da strumenti evoluti come il TOAD ma anche dal programma SqlPlus fornito con Oracle.

==== Comandi Particolari ====

In uno script posso attivare la tracciatura dell'output ed il nome del file di log in cui salvarla. \\ Per fare ciò si usa il coamndo **Spool**

<code sql |h Spool (Abilita lo Spool)>
Spool <Nome_File_Log>;
</code>

<code sql |h Spool (Termina lo Spool)>
Spool Off;
</code>

\\ Un altro comando utile è **Prompt** che permette di inviare una stringa nel file di log

<code sql |h Prompt>
Prompt "Testo da inviare al file";
</code>

\\ Poiché all'interno di uno script non possono essere presenti blocchi **Begin**..**End**, l'eventuale esecuzione di una procedura deve avvenire tramite il comando **Execute**

<code sql |h Execute>
Execute <Nome_Procedura>;
</code>

\\ E'utile per quando deve essere lanciata una eventuale procedura di ricompilazione degli oggetti invalidi.
\\ All'interno di uno script possono essere invocati altri script mediante l'operatore **@**

<code sql |h @ (Invocare uno script)>
@<Nome_Script>;
</code>

\\ 
=== Esempio ===
<code sql |h Esempio>
Spool Script_Di_Prova.log

prompt "Questo è uno script di prova"

prompt "Alter table MYTABLE..."
Alter Table MYTABLE Add MYCOLUMN Char(2);

prompt "Compila Oggetti Invalidi..."
Execute CompilaInvalidi; 

prompt "Compila package PK_MYPACKAGE"
@PK_MYPACKAGE.pks
@PK_MYPACKAGE.pkb

prompt "Compila Oggetti Invalidi..."
Execute CompilaInvalidi; 

prompt "Aggiorna MYTABLE"
Update MYTABLE
   Set MYCOLUMN = '**';

COMMIT;

prompt "Fine Script"

Spool off;
</code>

<note important> **Non è** possibile usare blocchi **''Begin End''** in uno script. </note>


==== SqlPlus ====

Aprire SqlPlus:

<code console>
sqlplus <user>/<password>@tnsalias
</code>

Eseguire lo script ed uscire:
<code bash>
@nome_del_file.sql
exit
</code>

Per avere un log dell'esecuzione:
<code bash>
@nome_del_file.sql
spool off
exit
</code>