# 처리 엔진 선택

Pro 처리 엔진은 지원하는 정렬·필터·집계 작업에 가속 경로를 사용합니다. 브라우저·패키지·라이선스·현재 기능 조합에 따라 실제 실행 경로가 결정됩니다.

Canonical: https://grid.syidax.com/ko/docs/features/wasm-acceleration/

<a id="understand"></a>

## 동작 원리와 선택 기준

engine은 요청하는 모드이고 getActiveTier()는 실제 활성화된 엔진을 확인하는 통로입니다. Pro를 요청했다는 사실만으로 모든 연산이 같은 경로에서 처리된다고 표시하지 않습니다.

이 기능을 제품에서 사용하려면 Pro 패키지와 유효한 라이선스가 필요합니다. 설정 이름이 같더라도 Community에서 Pro 기능이 활성화되는 것은 아닙니다.

코드의 grid는 설치와 연결 장에서 준비한 Grid 요소입니다. 예제마다 필요한 데이터·설정을 확인하고, 코드에서 소개하는 앱 함수와 서버 주소는 프로젝트에 맞게 구현하세요.

- [설치와 연결 · 공통 예제 데이터](https://grid.syidax.com/ko/docs/guides/getting-started.md)

<a id="example-1"></a>

## 예제 1. 환경에 맞게 자동 선택

기본 선택과 대체 실행 정책을 사용합니다.

```javascript
grid.engine = 'auto';
grid.unavailable = 'fallback';
console.log(await grid.getActiveTier());
```

결과 확인: 초기화 이후 실제 선택된 tier를 확인합니다. 자동 대체가 허용된 환경에서는 요청 모드와 결과가 다를 수 있습니다.

<a id="example-2"></a>

## 예제 2. Pro 실행을 요구하는 화면

이미 패키지와 라이선스를 준비한 앱에서 사용합니다.

```javascript
grid.engine = 'pro';
grid.unavailable = 'error';
```

결과 확인: 필요한 엔진을 사용할 수 없는 환경에서 조용히 대체 실행하지 않고 오류 경로를 확인할 수 있습니다.

<a id="example-3"></a>

## 예제 3. 가속 효과 비교

같은 데이터·같은 필터·같은 정렬을 standard와 Pro에서 반복 측정합니다. 초기 다운로드와 초기화 시간은 반복 처리 시간과 분리합니다.

결과 확인: 행 개수만으로 가속 효과를 약속하지 않습니다. 사용자 콜백·수식·피벗 등 실제 기능 조합의 지원 범위와 결과 일치 여부도 확인합니다.

<a id="pitfalls"></a>

## 조합할 때와 문제를 해결할 때

엔진 변경만으로 서버 요청·네트워크·사용자 렌더러 비용이 빨라지는 것은 아닙니다. 병목을 먼저 측정하세요.

동적 배열 수식 등 특정 경로에서 거절되는 기능은 반환 보고서를 읽고 지원하는 구성으로 전환합니다.

<a id="related-api"></a>

## 이 기능에 사용하는 API

- [engine](https://grid.syidax.com/ko/docs/options/engine.md) — 자동 선택·표준 JavaScript·Pro 중 요청할 처리 모드를 지정합니다. 실제 결과는 getActiveTier로 확인합니다.
- [proThreshold](https://grid.syidax.com/ko/docs/options/proThreshold.md) — 자동 엔진 선택에서 Pro 경로를 고려할 데이터 규모 기준입니다.
- [unavailable](https://grid.syidax.com/ko/docs/options/unavailable.md) — 요청한 엔진을 사용할 수 없을 때 대체 경로로 실행할지 오류로 처리할지 정합니다.
- [getActiveTier](https://grid.syidax.com/ko/docs/methods/getActiveTier.md) — 실제 활성화된 처리 엔진 등급을 읽습니다. engine에 요청한 모드와 다를 수 있습니다.

<a id="next"></a>

## 함께 읽기

- [행·열·ID의 관계](https://grid.syidax.com/ko/docs/guides/concepts.md)
- [결과와 이벤트 연결](https://grid.syidax.com/ko/docs/guides/data-event-access.md)
- [Features에서 살펴보기](https://grid.syidax.com/grid/wasm-acceleration) — 직접 체험 가능한 범위는 해당 가이드에 안내되어 있습니다.