Esecuzione del codice SQL, PL/SQL e JavaScript nell'editor del foglio di lavoro

È possibile eseguire le istruzioni SQL, gli script PL/SQL e il codice JavaScript nell'editor del foglio di lavoro SQL. Alcune caratteristiche salienti dell'editor sono il completamento del codice contestuale, l'evidenziazione della sintassi e il debug degli errori.

Nota

Le modalità editor PL/SQL e JavaScript non sono disponibili per i servizi di database MySQL.

È possibile immettere istruzioni SQL o blocchi di codice PL/SQL per specificare azioni quali la creazione di una tabella, l'inserimento di dati, la selezione di dati o l'eliminazione di dati da una tabella. Le parole chiave SQL vengono evidenziate automaticamente. Per più istruzioni, è necessario terminare:

  • Ogni istruzione non PL/SQL con punto e virgola (;) o barra (/) su una nuova riga
  • Ogni istruzione PL/SQL con una barra (/) su una nuova riga

Per le istruzioni SQL*Plus e SQLcl supportate nel foglio di lavoro, vedere Comandi SQL*Plus e SQLcl supportati in SQL Worksheet.

La modalità editor PL/SQL viene attivata nel foglio di lavoro quando si aprono i seguenti tipi di oggetto: Funzioni, Procedure, Package e Tipi. Questo editor consente di rilevare gli errori nel codice PL/SQL durante la compilazione. L'output include dettagli di errore come la riga e la colonna specifiche in cui viene rilevato l'errore, insieme a un collegamento per andare alla posizione pertinente nel blocco di codice.

La modalità JavaScript foglio di lavoro supporta la funzione Multilingual Engine introdotta in Oracle Database release 21c. Per ulteriori informazioni, vedere Supporto per Multilingual Engine.

Assistenza per l'editor di codice

Se si preme Ctrl+Space, l'editor fornisce un elenco dei possibili completamenti nel punto di inserimento che è possibile utilizzare per completare automaticamente il codice che si sta modificando. Questo elenco si basa sul contesto del codice nel punto di inserimento.

Questa immagine mostra un elenco dei possibili completamenti che è possibile utilizzare per il completamento automatico del codice.

L'editor offre anche un elenco completo dei comandi disponibili tramite la tavolozza dei comandi. Per aprire la tavolozza dei comandi, premere Ctrl+Shift+P. Per un elenco dei tasti di scelta rapida, vedere Keyboard Shortcuts.

Un errore nel codice è indicato da un punto rosso nel margine sinistro e da una linea di squiggle sotto il testo specifico. Quando si passa il puntatore del mouse su di esso, viene visualizzato un popup che visualizza le possibili correzioni per la risoluzione dell'errore.

Questa immagine mostra come viene identificato un errore nel codice insieme a un elenco di suggerimenti su come risolvere l'errore.

Trascinare e rilasciare gli oggetti per generare automaticamente le istruzioni SQL

Nota

Questa funzione non è disponibile per i servizi di database MySQL.

È possibile trascinare gli oggetti dal riquadro sinistro e rilasciarli nell'editor dei fogli di lavoro nel riquadro destro.

  • Se si trascina una tabella o una vista, viene richiesto di selezionare una delle seguenti istruzioni SQL: Inserisci, Aggiorna, Seleziona o Elimina.

    Ad esempio, se si sceglie Seleziona, un'istruzione Select viene creata con tutte le colonne della tabella o della vista. È quindi possibile modificare l'istruzione, ad esempio modificando l'elenco di colonne o aggiungendo una clausola WHERE.

    Questa immagine mostra il codice SQL generato per un oggetto nell'editor dei fogli di lavoro quando viene selezionata l'istruzione SELECT.

    Se si sceglie Nome oggetto, il nome dell'oggetto preceduto dal nome dello schema viene aggiunto al foglio di lavoro.

  • Se si trascina una funzione o una procedura, è possibile scegliere di inserire il nome o il codice PL/SQL della funzione o della procedura nel foglio di lavoro. Se si seleziona il codice PL/SQL, è possibile immettere i parametri prima di inserire il codice nel foglio di lavoro.

Imposta preferenze editor

È possibile impostare le preferenze dell'editor di codice utilizzando l'opzione Preferenze disponibile nella barra laterale sinistra. Alcune delle opzioni dell'editor di codice che è possibile personalizzare sono Tema (luce, scuro e contrasto elevato scuro), Dimensione e famiglia dei caratteri, Dimensione tabulazione, A capo automatico, Righello, Numeri di riga e così via.

Icone della barra degli strumenti

La barra degli strumenti dell'editor di fogli di lavoro SQL contiene icone per le seguenti operazioni:

  • Elenco a discesa Foglio di lavoro

    • Apri: apre un file dal browser, dal dispositivo o dallo storage degli oggetti.
    • Apri recenti: visualizza i file a cui si è avuto accesso di recente. Se l'elenco recente contiene più di cinque file, viene visualizzato un collegamento Altro per la visualizzazione dei file aggiuntivi.
    • Salva con nome: salva un file nello storage del browser, del dispositivo o degli oggetti.
  • Nuovo file
    • Selezionare Worksheet: creare un foglio di lavoro.
    • Selezionare PL/SQL: creare un object type PL/SQL. L'editor passa a una modalità PL/SQL.
  • Apri: consente di aprire un file dal browser, dal dispositivo o dallo storage degli oggetti. Per aprire un file dal dispositivo, nel dispositivo di scorrimento Apri file fare clic su Apri file e selezionare il file oppure trascinarlo nel dispositivo di scorrimento.
  • Esegui istruzione: esegue le istruzioni selezionate o l'istruzione con il puntatore del mouse nell'editor dei fogli di lavoro. Le istruzioni SQL possono includere bind variable e variabili di sostituzione di tipo VARCHAR2. Viene visualizzata una finestra di dialogo per l'immissione dei valori delle variabili.

  • Esegui script: esegue tutte le istruzioni nell'editor di fogli di lavoro utilizzando il programma di esecuzione script. Le istruzioni SQL possono includere bind variable (ma non variabili di sostituzione) di tipo VARCHAR2. Viene visualizzata una finestra di dialogo per l'immissione dei valori delle bind variable.

  • Compila (per la barra degli strumenti PL/SQL): eseguire una compilazione PL/SQL del sottoprogramma.

    Nota

    L'icona Compila non è disponibile per i servizi di database MySQL.
  • Spiega piano: genera il piano di esecuzione per il rendiconto. L'output viene visualizzato nella scheda Explain plan del riquadro di output. Vedere Utilizzo del diagramma Explain Plan

    Nota

    L'icona Explain Plan non è disponibile per i servizi di database MySQL.
  • Autotracciamento: esegue l'istruzione e mostra le statistiche di esecuzione dell'istruzione SQL e il piano di esecuzione effettivo. L'output viene visualizzato nella scheda Autotracciamento nel riquadro di output.

    Nota

    L'icona Traccia automatica non è disponibile per i servizi di database MySQL.
  • Scarica contenuto editor: scaricare il contenuto del foglio di lavoro come file SQL nel sistema locale.

  • Formato: formattare l'istruzione SQL nell'editor, ad esempio utilizzando le maiuscole per i nomi di istruzioni, clausole, parole chiave e aggiungendo interruzioni di riga e rientro.

  • Cancella: rimuove le istruzioni dall'editor.

  • Apri a schermo intero: consente di aprire l'editor in modalità a schermo intero.

  • Caricamento dati: apre la procedura guidata Caricamento dati. Vedere Caricamento dei dati.

    Nota

    L'icona Caricamento dati non è disponibile per i servizi di database MySQL.