Babelfish에서 ANTLR 구문 분석 캐시 사용

Babelfish 버전 5.7.0 및 6.2.0부터는 T-SQL 저장 루틴(프로시저 및 함수)에 지속성 ANTLR 구문 분석 결과 캐시를 사용하여 첫 번째 실행 시 발생하는 지연 시간을 줄일 수 있습니다.

프로시저 구문 분석 캐시 사용 시 알아둘 사항:

성능: 대규모 루틴의 경우 ANTLR 구문 분석에 최대 수초가 걸릴 수 있습니다. ANTLR 구문 분석 캐시를 사용하면 첫 번째 실행 시의 구문 분석 시간이 몇 밀리초 수준으로 줄어듭니다. 동일한 세션 내 후속 실행은 세션 내 캐시에서 처리되므로 1밀리초 미만이 소요되며 이 기능 설정 여부의 영향을 받지 않습니다.

ANTLR 구문 분석 캐시 이해

Babelfish는 세션에서 루틴이 처음 실행될 때 루틴의 본문을 구문 분석하여 T-SQL 구문을 검증해야 합니다. 일반적으로 이 구문 분석 결과는 해당 세션의 수명 동안에만 캐싱되므로, 새로운 연결이 생성될 때마다 매번 처음부터 다시 구문 분석이 수행됩니다. 구문 분석 캐시는 이 구문 분석 결과를 카탈로그에 저장하여 지속적으로 유지하므로 새로운 세션에서도 이를 재사용할 수 있습니다.

작동 방식:

구문 분석 시간 단축 효과 확인

각 배치의 Babelfish T-SQL Batch Parsing Time을 기록하는 SET BABELFISH_STATISTICS PROFILE ON을 사용하여 이 기능의 효과를 측정할 수 있습니다. 먼저, 캐싱을 활성화하여 지속성 캐시를 채우는 대규모 프로시저를 생성합니다. 그 다음, 서로 다른 두 개의 새로운 세션에서 이 프로시저의 첫 번째 실행을 비교합니다. 하나는 캐싱을 비활성화하여 지속성 캐시 항목을 무시하는 세션이고, 다른 하나는 캐싱을 활성화하여 이를 재사용하는 세션입니다. 또는 프로시저가 생성될 당시 캐싱이 활성화되어 있지 않았다면, 캐싱을 활성화한 상태에서 두 개의 독립된 새 세션을 열어 실행해 봅니다. 이 경우 첫 번째 실행 시 지속성 캐시가 채워지며, 두 번째 세션 실행 시 이를 재사용하게 됩니다.

다음 예시에서는 먼저 지속성 캐시를 채우기 위해 캐싱 기능을 ON으로 설정한 상태에서 프로시저를 생성합니다.

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

다음으로, 캐싱이 OFF(기본값) 상태인 새로운 세션에서 해당 프로시저를 실행합니다.

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

통계 프로파일을 확인해 보면 구문 분석 시간이 길게 나타납니다.

Babelfish T-SQL Batch Parsing Time: 20359.465 ms

마지막으로, 캐싱이 활성화된 또 다른 새로운 세션에서 해당 프로시저를 실행합니다.

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

통계 프로파일을 확인해 보면 구문 분석 시간이 현저히 짧아졌습니다.

Babelfish T-SQL Batch Parsing Time: 150.927 ms

새로운 세션에서의 첫 번째 실행 시, 캐싱된 구문 분석 트리를 재사용하게 되면 구문 분석 시간이 약 20초에서 약 0.15초로 단축됩니다. 동일한 세션 내 두 번째 이후의 실행은 두 경우 모두 세션 내 캐시에서 처리되므로 1밀리초 미만이 소요되며 GUC 설정의 영향을 받지 않습니다.

세션 단위 캐시 활성화

이 기능은 세션 수준의 GUC(기본값 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

루틴별 캐시 제어

sys.enable_antlr_parse_cache를 사용하여 개별 루틴에 대한 세션 GUC 설정을 재정의할 수 있으며, 이 함수는 해당 루틴의 객체 ID를 인수로 받습니다.

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

캐시 통계 확인

sys.antlr_parse_cache_stats()는 현재 세션의 구문 분석 캐시 활동 정보를 반환합니다.

SELECT * FROM sys.antlr_parse_cache_stats();
GO

다음 표는 출력 결과의 각 열에 대한 설명입니다.

카운터는 세션별로 집계되며, 새로운 연결이 생성되면 초기화됩니다.

예제 시나리오

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

업그레이드 고려 사항

중요 제한 사항