Cloudflare, Hyperdrive MySQL 지원 정식 출시… 연결 성공률 99.99% 달성

Cloudflare가 Hyperdrive의 MySQL 지원 기능을 정식 출시(GA)했다고 발표했다. 지난해 베타로 출시된 이 서비스는 기존 Postgres 지원 수준에 맞춰 신뢰성을 대폭 개선했다. 베타에서 GA로 전환하는 과정에서 문자 인코딩부터 복잡한 프로토콜 처리까지 약 20건의 버그 수정이 이루어졌다.

희귀한 캐싱 버그

베타 기간 중 한 대량 트래픽 고객이 쿼리 응답이 빈 상태로 반환되는 드문 문제를 보고했다. 발생 확률은 약 **0.001%**였다. 조사 결과, 이 버그는 Client와 Endpoint 노드가 같은 데이터 센터의 CDN 캐시를 공유할 때 Hyperdrive의 캐싱 메커니즘에서 발생했다. 근본 원인은 두 노드 간 MySQL 프로토콜 기능(capability) 불일치였다.

Hyperdrive는 Worker에게는 서버로, 원본 데이터베이스에게는 클라이언트로 동작한다. 결과 집합 종료 방식을 변경하는 CLIENT_DEPRECATE_EOF 같은 특정 기능을 협상한다. 하지만 mysql2 등 일부 인기 클라이언트 라이브러리는 이 기능을 지원하지 않는다. Client 노드가 Worker의 기능에 맞춰 변환된 바이트를 캐시했을 때, Hyperdrive의 고정된 기능을 사용하는 Endpoint 노드가 해당 바이트를 읽으면 프로토콜 동기화 오류로 빈 응답이나 멈춤 현상이 발생했다.

해결 및 가용성

해당 수정 사항으로 Hyperdrive는 캐시에 저장한 노드와 관계없이 항상 자체 기능으로 인코딩된 쿼리 결과 바이트의 표준 버전을 캐시에 기록하도록 보장한다. 이 변경으로 빈 행 문제가 사라졌고, Client 연결 성공률은 **99.99%**로 향상됐다.

사용자는 이제 wrangler CLI 또는 Cloudflare 대시보드를 통해 기존 MySQL 호환 데이터베이스나 새로운 PlanetScale 데이터베이스에 연결할 수 있다. Hyperdrive 인스턴스를 생성하는 명령어는 다음과 같다:

npx wrangler hyperdrive create HYPERDRIVE_NAME --connection-string="mysql://user:[email protected]:3306/dbname"