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à.

Utilizzo della cache di analisi ANTLR in Babelfish

A partire dalle versioni 5.7.0 e 6.2.0 di Babelfish, puoi utilizzare una cache persistente dei risultati di analisi ANTLR per le routine memorizzate (procedure e funzioni) per ridurre la latenza della prima esecuzione. T-SQL

Con la cache di analisi delle procedure:

Prestazioni: per routine di grandi dimensioni, l'analisi ANTLR può richiedere fino a diversi secondi. Con la cache di analisi ANTLR, il tempo di analisi della prima esecuzione è ridotto a pochi millisecondi. Le esecuzioni successive nella stessa sessione vengono servite dalla cache in sessione (inferiore al millisecondo) e non sono influenzate.

Comprensione della cache di analisi ANTLR

Babelfish deve convalidare la T-SQL sintassi analizzando il corpo di una routine la prima volta che viene eseguita in una sessione. Questo risultato di analisi viene normalmente memorizzato nella cache solo per la durata di quella sessione, quindi ogni nuova connessione viene nuovamente analizzata da zero. La cache di analisi mantiene il risultato dell'analisi nel catalogo in modo che le nuove sessioni possano riutilizzarlo.

Come si comporta:

Osservazione del miglioramento del tempo di analisi

È possibile misurare l'effetto utilizzandoSET BABELFISH_STATISTICS PROFILE ON, che riporta il valore Babelfish T-SQL Batch Parsing Time per ogni batch. Innanzitutto, create una procedura di grandi dimensioni con la memorizzazione nella cache abilitata per popolare la cache persistente. Quindi confrontate la prima esecuzione della procedura in due nuove sessioni separate: una con la memorizzazione nella cache disabilitata, che ignora la voce persistente, e una con la memorizzazione nella cache abilitata, che la riutilizza. In alternativa, se la memorizzazione nella cache non era abilitata al momento della creazione della procedura, eseguila in due nuove sessioni separate con la memorizzazione nella cache abilitata: la prima esecuzione popola la cache persistente e la seconda la riutilizza.

Nell'esempio seguente, create innanzitutto la procedura con caching ON per popolare la cache persistente:

-- New session 0: caching ON (at CREATE PROCEDURE time)
SELECT set_config('babelfishpg_tsql.enable_antlr_parse_cache', 'on', false);
GO
CREATE PROCEDURE dbo.updateInformation @region VARCHAR(50)
AS
BEGIN
    ...
END;
GO

Successivamente, in una nuova sessione con caching OFF (impostazione predefinita), esegui la procedura:

-- New session 1: caching OFF (default)
SET BABELFISH_STATISTICS PROFILE ON;
GO
EXEC dbo.updateInformation @region = 'EMEA';   -- first call in this session
GO

Il profilo delle statistiche riporta un tempo di analisi elevato:

Babelfish T-SQL Batch Parsing Time: 20359.465 ms

Infine, in un'altra nuova sessione con caching attivo, esegui la procedura:

-- New session 2: caching ON
SELECT set_config('babelfishpg_tsql.enable_antlr_parse_cache', 'on', false);
GO
SET BABELFISH_STATISTICS PROFILE ON;
GO
EXEC dbo.updateInformation @region = 'EMEA';   -- first call in this session
GO

Il profilo delle statistiche riporta un tempo di analisi significativamente inferiore:

Babelfish T-SQL Batch Parsing Time: 150.927 ms

La prima esecuzione in una nuova sessione passa da ~20 s di analisi a ~0,15 s una volta riutilizzato l'albero di analisi memorizzato nella cache. Le esecuzioni secondarie e successive all'interno della stessa sessione vengono eseguite dalla cache in sessione in entrambi i casi (inferiori al millisecondo) e non sono influenzate dal GUC.

Abilitazione della cache per una sessione

La funzionalità è controllata da un GUC a livello di sessione (impostazione predefinita OFF):

-- Enable parse caching for the current session
SELECT set_config('babelfishpg_tsql.enable_antlr_parse_cache', 'on', false);
GO

-- Disable for the current session
SELECT set_config('babelfishpg_tsql.enable_antlr_parse_cache', 'off', false);
GO

Controllo della cache per routine

È possibile sovrascrivere il GUC della sessione per una singola routine utilizzandosys.enable_antlr_parse_cache, che accetta l'id dell'oggetto della routine:

-- Force caching ON for a specific routine (even if the session GUC is OFF)
SELECT sys.enable_antlr_parse_cache(sys.object_id('dbo.my_proc'), true);
GO

-- Force caching OFF for a specific routine — "kill switch"
-- (clears any cached data and blocks caching even if the session GUC is ON)
SELECT sys.enable_antlr_parse_cache(sys.object_id('dbo.my_proc'), false);
GO

-- Reset to default; the routine follows the session GUC
SELECT sys.enable_antlr_parse_cache(sys.object_id('dbo.my_proc'), NULL);
GO

Controllo delle statistiche sulla cache

sys.antlr_parse_cache_stats()restituisce l'attività di parse-cache per la sessione corrente:

SELECT * FROM sys.antlr_parse_cache_stats();
GO

La tabella seguente descrive ogni colonna dell'output.

I contatori sono per sessione e vengono ripristinati in base a una nuova connessione.

Scenario di esempio

-- Enable caching for this session
SELECT set_config('babelfishpg_tsql.enable_antlr_parse_cache', 'on', false);
GO

CREATE PROCEDURE dbo.report_proc @region VARCHAR(50)
AS
BEGIN
    -- large multi-statement T-SQL body ...
    SELECT @region;
END;
GO

-- First execution in a brand-new session: served from the persistent cache (fast)
EXEC dbo.report_proc @region = 'APAC';
GO

-- Inspect cache activity for this session
SELECT * FROM sys.antlr_parse_cache_stats();
GO

-- Opt this routine out of caching regardless of the session setting
SELECT sys.enable_antlr_parse_cache(sys.object_id('dbo.report_proc'), false);
GO

Considerazioni sugli aggiornamenti

Limitazioni importanti