Gestisci le impostazioni

Utilizzare le impostazioni per memorizzare e gestire le informazioni di log per i componenti aggiuntivi foglio di calcolo.

Nel menu Oracle Database fare clic su Impostazioni per configurare le opzioni riportate di seguito.

Descrizione dell'illustrazione log-settings.png

Sebbene la maggior parte delle opzioni sia disponibile per i fogli di calcolo in generale, alcune opzioni sono specifiche solo per Microsoft Excel o Google Sheets.

Mostra selezione gruppo di consumer

Questa opzione consente di impostare la priorità per l'esecuzione delle query da un foglio di calcolo.

Per impostazione predefinita, le query vengono eseguite con priorità LOW. Se abilitato, l'add-in fornisce un'opzione per selezionare la priorità MEDIUM o HIGH per la query. Le query che utilizzano la priorità ALTO consumano più risorse e possono recuperare i risultati più velocemente.

Livello di log

Ogni messaggio di log è associato a un livello di severità che indica l'importanza e l'urgenza del log.

Un livello di log può avere valori che vanno dall'impatto più basso al più alto. Nella tabella riportata di seguito vengono descritti i livelli di log in ordine decrescente del relativo impatto.

Livello di log	Descrizione
STOP	Non registra alcuna informazione. Questo ha il minor impatto.
ERROR	Registra gli eventi che possono richiedere azioni correttive, ad esempio un componente non è disponibile.
WARNING	Registra i problemi che potrebbero causare un errore o richiedere azioni correttive in futuro. Questo è il livello di log predefinito.
INFORMATION	Registra le azioni completate o lo stato corrente di un componente, ad esempio il componente è in fase di inizializzazione.
DESCRIZIONE DETTAGLIATA	Visualizza informazioni dettagliate sull'elaborazione, inclusi errori, avvertenze e informazioni. Questo ha il massimo impatto.

Ogni livello è cumulativo, cioè contiene tutti i dati generati dai livelli inferiori. Ad esempio, un log delle avvertenze contiene tutti i dati generati dai log degli errori, inclusi gli eventi specifici della categoria degli errori.

Formato messaggio di log

Le impostazioni di log scrivono un messaggio nel file di log specificato. Un file di log contiene informazioni quali modulo, indicatore orario, severità, nome server, connessione e messaggio, insieme a un eventuale stack trace. Ogni attributo viene specificato tra parentesi graffe.

Di seguito è riportato un esempio di file di log del server.

{
  "module": "ServerHelper",
  "logMessage": "New settings saved",
  "timestamp": 1688901058020,
  "level": 3,
  "payload": {
    "conAlias": "Excel Connection",
    "status": 400
  },
  "id": 161,
  "timeString": "19 Jun 20XX 16:40:58"
},
{
  "module": "ServerHelper",
  "logMessage": "serverRequest - success",
  "timestamp": 1688901059724,
  "level": 3
}

Ore di conservazione del log

È possibile impostare il limite di tempo per la memorizzazione delle informazioni di log nei file di log. I log precedenti al valore specificato in questo campo vengono cancellati automaticamente. Il valore predefinito è 12 ore. Significa che i record più vecchi di 12 ore vengono eliminati.

Cancella log

Questa opzione elimina tutti i log.

Log di esportazione

È possibile esportare il log per salvare le informazioni in un file in formato JSON. In Windows, l'opzione di esportazione salva il file di log direttamente in una cartella, ad esempio Downloads. In Mac, le informazioni di log vengono copiate negli appunti. È possibile incollarlo in un file e salvare il log.

I log vengono memorizzati localmente sul sistema in cui è in esecuzione il componente aggiuntivo. Non risiedono in un server o in una posizione remota.

È quindi possibile condividere il file di log con il team di supporto per la diagnosi e la risoluzione degli errori.

Nota

Il file di log JSON può contenere informazioni personali o dati riservati. Assicurarsi di proteggere le informazioni riservate prima di condividere il file di log.

URL di reindirizzamento

È possibile utilizzare l'opzione Copia PL/SQL e creare una connessione manualmente. Questa opzione è disponibile in Excel.