Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # Analisi delle query con la scheda SQL principale in Approfondimenti sulle prestazioni Nel pannello di controllo di Amazon RDS Performance Insights è possibile trovare informazioni relative alle query in esecuzione e recenti nella scheda **Top SQL (Prime istruzioni SQL)** nella tabella **Top dimensions (Dimensioni principali)**. Queste informazioni possono essere utilizzate per ottimizzare le query. **Topics** + [Panoramica della scheda Prime istruzioni SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL) + [Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md) + [Visualizzazione delle statistiche SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.AnalyzeDBLoad.AdditionalMetrics.AnalyzingSQLLevel.md) ## Panoramica della scheda Prime istruzioni SQL Per impostazione predefinita, la scheda **Top SQL** (Prime istruzioni SQL) mostra le 25 query che contribuiscono di più al carico del database. Per ottimizzare le query puoi analizzare le informazioni, ad esempio il testo della query e le statistiche SQL. È inoltre possibile scegliere le statistiche che desideri visualizzare nella scheda **Top SQL** (Prime istruzioni SQL). **Topics** + [Testo SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.text) + [Statistiche SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.statistics) + [Caricamento per attesa (AAS)](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Load-by-waits) + [Visualizzazione delle informazioni SQL](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.SQL-information) + [Scelta delle preferenze statistiche](#USER_PerfInsights.UsingDashboard.Components.AvgActiveSessions.TopLoadItemsTable.TopSQL.Preferences) ### Testo SQL Per impostazione predefinita, ciascuna riga nella tabella **Top SQL** (Prime istruzioni SQL) mostra 500 byte di testo per ogni istruzione. ![\[Testo SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/sql-text-oracle.png) Per informazioni su come visualizzare più dei 500 byte di testo SQL di default, consulta [Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights](USER_PerfInsights.UsingDashboard.SQLTextSize.md). Un *digest SQL* è un composito di più query effettive strutturalmente simili ma potrebbero avere valori letterali diversi. Il digest sostituisce i valori codificati con un punto interrogativo. Ad esempio, un digest potrebbe essere `SELECT * FROM emp WHERE lname= ?`. Questo digest può includere le seguenti query figlio: ``` SELECT * FROM emp WHERE lname = 'Sanchez' SELECT * FROM emp WHERE lname = 'Olagappan' SELECT * FROM emp WHERE lname = 'Wu' ``` Per visualizzare le istruzioni SQL letterali in un digest, selezionare la query, quindi scegliere il simbolo più (\$1). Nell'esempio seguente, la query selezionata è un sunto. ![\[Digest SQL selezionato\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_4b.png) **Nota** Un sunto SQL raggruppa istruzioni SQL simili, ma non oscura le informazioni riservate. Performance Insights può mostrare il testo Oracle SQL come **Unknown (Sconosciuto)**. Il testo ha questo stato nelle seguenti situazioni: + Un utente di database Oracle diverso da `SYS` è attivo ma non esegue al momento SQL. Ad esempio, quando una query parallela viene completata, il coordinatore della query attende che i processi helper inviino le statistiche della sessione. Per tutta la durata dell'attesa, il testo della query risulta **Unknown (Sconosciuto)**. + Per un'istanza RDS per Oracle in Standard Edition 2, Oracle Resource Manager limita il numero di thread paralleli. Il processo in background che esegue questa attività fa sì che il testo della query venga visualizzato come **Unknown (Sconosciuto)**. ### Statistiche SQL *Statistiche SQL* sono parametri relativi alle prestazioni relative alle query SQL. Ad esempio, Performance Insights potrebbe mostrare esecuzioni al secondo o righe elaborate al secondo. Performance Insights raccoglie statistiche solo per le query più comuni. In genere, queste query corrispondono alle prime query per carico mostrate nel dashboard di Performance Insights. Tutte le righe della tabella **Top SQL** (Prime istruzioni SQL) mostra le statistiche rilevanti per l'istruzione SQL o il digest, come illustrato nell'esempio seguente. ![\[Prime istruzioni SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_4.png) Performance Insights può segnalare `0.00` e `-` (sconosciuto) per le statistiche SQL. Questa situazione si verifica nelle seguenti condizioni: + Esiste un solo campione. Ad esempio, Performance Insights calcola i tassi di variazione per le query PostgreSQL di RDS sulla basa di molteplici campioni della vista `pg_stat_statements`. Quando un carico di lavoro viene eseguito per un breve periodo, Performance Insights potrebbe raccogliere solo un campione, il che significa che non è in grado di calcolare un tasso di varaizione. Il valore sconosciuto è rappresentato da un trattino (`-`). + Due campioni hanno gli stessi valori. Performance Insights non è in grado di calcolare un tasso di variazione perché non si è verificata alcuna variazione, quindi riporta il tasso come `0.00`. + Un'istruzione SQL RDS manca di un identificatore valido. PostgreSQL crea un identificatore per un'istruzione solo dopo la parsificazione e l'analisi. Pertanto, può esistere nelle strutture interne in memoria di PostgreSQL un'istruzione senza identificatore. Poiché Performance Insights esegue il campionamento delle strutture interne in memoria una volta al secondo, le query a bassa latenza potrebbero apparire solo in un singolo campione. Se l'identificatore della query non è disponibile per questo campione, Performance Insights non può associare questa istruzione alle relative statistiche. Il valore sconosciuto è rappresentato da un trattino (`-`). Per una descrizione delle statistiche SQL per i motori Amazon RDS, consulta [Statistiche SQL per Performance Insights](sql-statistics.md). ### Caricamento per attesa (AAS) In **Top SQL**, la colonna **Load by waits (AAS)** illustra la percentuale del carico del database associato a ciascun elemento di caricamento superiore. Questa colonna indica il carico per questo elemento in base a qualunque raggruppamento attualmente selezionato nel **grafico DB Load**. Per ulteriori informazioni sulle sessioni attive medie (AAS), consulta [Media delle sessioni attive](USER_PerfInsights.Overview.ActiveSessions.md#USER_PerfInsights.Overview.ActiveSessions.AAS). Ad esempio, è possibile raggruppare il **Carico DB** in base agli stati di attesa. Esaminare le query SQL nella tabella degli elementi di caricamento superiore. In questo caso, la barra **DB Load by Waits (Carico del database in base alle attese)** è dimensionata, segmentata e rappresentata da un colore per mostrare qual è il contributo della query a un dato stato di attesa. Mostra anche quali stati di attesa stanno influenzando la query selezionata. ![\[Caricamento DB per attesa\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_6.png) ### Visualizzazione delle informazioni SQL Nella tabella **Top SQL (Prime istruzioni SQL)** è possibile aprire un'istruzione per visualizzarne le informazioni. Le informazioni vengono visualizzate nel riquadro inferiore. ![\[Tabella SQL superiore con query letterale selezionata\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-open.png) Puoi visualizzare i seguenti tipi di identificatori (ID) associati alle istruzioni SQL: + **ID SQL di supporto** –– Un valore hash dell'ID SQL. Questo valore serve solo come riferimento a un ID SQL quando si utilizza AWS Support. AWS Support non dispone dell'accesso agli ID SQL effettivi e al testo SQL. + **ID Digest di supporto** – Un valore hash dell'ID Digest. Questo valore serve solo come riferimento a un ID Digest quando si utilizza AWS Support. AWS Support non dispone dell'accesso agli ID Digest effettivi e al testo SQL. ### Scelta delle preferenze statistiche È possibile controllare le statistiche visualizzate nella scheda **Top SQL** (Prime istruzioni SQL) scegliendo l'icona **Preferenze**. ![\[Preferenze statistiche\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences-icon.png) Quando scegli l'icona **Preferences (Preferenze)**, viene visualizzata la finestra **Preferences (Preferenze)**. La schermata seguente è un esempio della finestra **Preferences** (Preferenze). ![\[Finestra Preferenze\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-sql-ids-preferences.png) Abilitare le statistiche che si desidera visualizzare nella scheda **Top SQL (Prime istruzioni SQL)**, utilizzare il mouse per scorrere fino alla fine della finestra, quindi scegliere **Continua**. Per ulteriori informazioni sulle statistiche per secondo o per chiamata per i motori Amazon RDS, consulta la sezione delle statistiche SQL specifiche del motore in [Statistiche SQL per Performance Insights](sql-statistics.md) # Accesso a una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights Per impostazione predefinita, ciascuna riga nella tabella **Top SQL** (Prime istruzioni SQL) mostra 500 byte di testo SQL per ciascuna istruzione SQL. ![\[500 byte di SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png) Quando un'istruzione SQL supera i 500 byte, puoi visualizzare più testo nella sezione **SQL text (Testo SQL)** sotto la tabella **Top SQL** (Prime istruzioni SQL). In questo caso, la lunghezza massima per il testo visualizzato in **SQL text (Testo SQL)** è 4 KB. Questo limite viene introdotto dalla console ed è soggetto ai limiti impostati dal motore del database. Per salvare il testo visualizzato in **SQL text** (Testo SQL), scegli **Download** (Scarica). **Topics** + [Limiti delle dimensioni del testo per i motori Amazon RDS](#sql-text-engine-limits) + [Impostazione del limite di testo SQL per le istanze database Amazon RDS per PostgreSQL](USER_PerfInsights.UsingDashboard.SQLTextLimit.md) + [Visualizzazione e download del testo SQL nella dashboard di Approfondimenti sulle prestazioni.](view-download-text.md) ## Limiti delle dimensioni del testo per i motori Amazon RDS Durante il download di testo SQL, il motore del database determina la sua lunghezza massima. Puoi scaricare il testo SQL fino ai seguenti limiti per motore. | Motore database | Lunghezza massima del testo scaricato | | --- | --- | | Amazon RDS per MySQL e MariaDB | La lunghezza è fissata a 4.096 byte quando lo schema delle prestazioni è abilitato. Se lo schema delle prestazioni non è abilitato, la lunghezza è fissata a 65.535 byte. | | Amazon RDS for Microsoft SQL Server | 4,096 caratteri | | Amazon RDS per Oracle | 1.000 byte | La sezione **SQL Text** (Testo SQL) della console Performance Insights visualizza fino al massimo restituito dal motore. Ad esempio, se MySQL restituisce al massimo 1 KB a Performance Insights, può raccogliere e mostrare solo 1 KB, anche se la query originale è più grande. Pertanto, quando la query viene visualizzata in **SQL text** (Testo SQL) o scaricata, Performance Insights restituisce lo stesso numero di byte. Se si utilizza AWS CLI o l’API, Approfondimenti sulle prestazioni non ha il limite di 4 KB applicato dalla console. `DescribeDimensionKeys` e `GetResourceMetrics` restituiscono al massimo 500 byte. **Nota** `GetDimensionKeyDetails` restituisce la query completa, ma la dimensione è soggetta al limite del motore. # Impostazione del limite di testo SQL per le istanze database Amazon RDS per PostgreSQL Amazon RDS per PostgreSQL gestisce il testo in modo diverso. È possibile impostare il limite delle dimensioni del testo con il parametro di istanza database `track_activity_query_size`. Questo parametro presenta le caratteristiche seguenti: Dimensione di default del testo Su Aurora Amazon RDS per PostgreSQL versione 9.6, l’impostazione di default per il parametro `track_activity_query_size` è 1.024 byte. Su Amazon RDS per PostgreSQL versione 10 o successive, l’impostazione di default per il parametro è 4.096 byte. Dimensione massima del testo Il limite per `track_activity_query_size` è 102.400 byte per Amazon RDS per PostgreSQL versione 12 e versioni precedenti. Il massimo è di 1 MB per la versione 13 e quelle successive. Se il motore restituisce 1 MB a Performance Insights, la console visualizza solo i primi 4 KB. Se si scarica la query, si ottiene 1 MB per intero. In questo caso, la visualizzazione e il download restituiscono un numero diverso di byte. Per ulteriori informazioni sul parametro dell’istanza database `track_activity_query_size`, consulta [Run-time Statistics](https://www.postgresql.org/docs/current/runtime-config-statistics.html) nella documentazione di PostgreSQL. Per aumentare la dimensione del testo SQL, aumenta il limite di `track_activity_query_size`. Per modificare il parametro, modifica l’impostazione del parametro nel gruppo di parametri associato all’istanza database Amazon RDS per PostgreSQL. **Modifica dell’impostazione quando l’istanza utilizza il gruppo di parametri di default** 1. Crea un nuovo gruppo di parametri dell’istanza database per il motore del database e la versione del motore del database appropriati. 1. Imposta il parametro nel nuovo gruppo di parametri. 1. Associa il nuovo gruppo di parametri all’istanza database. Per ulteriori informazioni sull’impostazione di un parametro dell’istanza database, consulta [Modifica dei parametri in un gruppo di parametri database in Amazon RDS](USER_WorkingWithParamGroups.Modifying.md). # Visualizzazione e download del testo SQL nella dashboard di Approfondimenti sulle prestazioni. Nel pannello di controllo di Performance Insights è possibile visualizzare e scaricare il testo SQL. **Per visualizzare una maggiore quantità di testo SQL nel pannello di controllo di Performance Insights** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Approfondimenti sulle prestazioni**. 1. Scegli un'istanza database. 1. Scorri verso il basso fino alla scheda **SQL principale** nella dashboard di Approfondimenti sulle prestazioni. 1. Scegli il segno più per espandere un digest SQL e scegli una delle query secondarie del digest. Le istruzioni SQL con testo superiore a 500 byte sono simili a quelle nell'immagine seguente. ![\[Istruzioni SQL con testo ampio\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png) 1. Scorri verso il basso fino alla scheda **Testo SQL**. ![\[La sezione Informazioni SQL mostra più del testo SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png) Il pannello di controllo di Performance Insights può visualizzare fino a 4.096 byte per ciascuna istruzione SQL. 1. (Facoltativo) Scegliere **Copia** per copiare l'istruzione SQL visualizzata oppure scegliere **Scarica** per scaricare l'istruzione SQL e visualizzare il testo SQL fino al limite del motore database. **Nota** Per copiare o scaricare l'istruzione SQL, disattiva i sistemi di blocco popup. # Visualizzazione delle statistiche SQL nel pannello di controllo di Performance Insights Nel pannello di controllo di Performance Insights, le statistiche SQL sono disponibili nella scheda **Top SQL (Prime istruzioni SQL)** del grafico **Database load (Carico database)**. **Per visualizzare le statistiche SQL** 1. Aprire la console Amazon RDS all'indirizzo [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/). 1. Nel pannello di navigazione scegli **Performance Insights**. 1. Nella parte superiore della pagina, scegli il database di cui desideri visualizzare le statistiche SQL. 1. Scorrere fino alla parte inferiore della pagina e scegli **Top SQL (Prime istruzioni SQL)**. 1. Scegli una specifica istruzione o un sunto di una query. ![\[Visualizzazione dei parametri delle query in esecuzione\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_sql.png) 1. Scegliere le statistiche da visualizzare selezionando l'icona a forma di ingranaggio nell'angolo in alto a destra del grafico. Per le descrizioni delle statistiche SQL per i motori Amazon RDS, consulta [Statistiche SQL per Performance Insights](sql-statistics.md). L'esempio seguente mostra le preferenze per statistiche per le istanze database Oracle. ![\[Preferenze dei parametri per l'esecuzione di query per le istanze database Oracle\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_oracle.png) Il seguente esempio mostra le preferenze per le istanze database MariaDB e MySQL. ![\[Preferenze dei parametri per l'esecuzione di query per le istanze database MariaDB e MySQL.\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_pref_ams.png) 1. Per salvare le preferenze, scegli Save (Salva). La tabella **Top SQL (Prime istruzioni SQL)** si aggiorna. L'esempio seguente mostra le statistiche per una query Oracle SQL. ![\[Statistiche per una query SQL\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/UserGuide/images/perf_insights_per_sql_stats_oracle.png)