양명구
08/31/2026, 1:04 AMRocky
08/31/2026, 1:05 AMaws.s3.enable_path_style_access 속성을 적용하는 기능이 포함되어 있지 않거나, 정상적으로 저장되지 않는 버그가 있을 가능성이 높습니다.
공식 릴리스 노트 및 관련 PR(#62591)에 따르면, *Shared-data 클러스터의 Storage Volume에 대한 S3 Path-style Access 지원*은 v3.5 시리즈의 초기 버전(3.5.0) 이후 패치 버전을 통해 공식적으로 안정화되거나 추가되었습니다.
원인 분석
* 속성 인식 불가: v3.5.0의 CREATE/ALTER STORAGE VOLUME 구문은 SQL 수준에서 오류를 내지 않더라도, 내부적으로 해당 속성을 스토리지 엔진(Starlet) 설정으로 전달하거나 메타데이터에 영구적으로 반영하지 못할 수 있습니다.
* 패치 버전의 차이: 사용자께서 확인하신 것처럼 v3.5.9 및 v4.x.x 버전에서는 해당 PR이 포함되어 aws.s3.enable_path_style_access 속성이 정상적으로 동작하고 메타데이터에 반영됩니다.
해결 방법 및 권장 사항
1. 가장 권장되는 방법: 패치 버전 업그레이드
* 이미 확인하신 대로 *v3.5.9 이상*으로 업그레이드하는 것이 가장 확실한 해결책입니다. v3.5.x 시리즈는 하위 호환성이 유지되는 패치 릴리스이므로 업그레이드 부담이 적습니다.
2. MinIO 측면의 워크아운드 (업그레이드가 불가능할 경우)
* Virtual-host Style 지원 설정: StarRocks에서 Path-style(예: `http://endpoint/bucket`)을 사용하지 못한다면, MinIO에서 Virtual-host style(예: <http://bucket.endpoint>)을 지원하도록 설정할 수 있습니다.
* MinIO의 MINIO_DOMAIN 환경 변수를 설정하고, DNS에서 `<bucket-name>.<minio-endpoint>`가 MinIO 서버를 가리키도록 설정하면 StarRocks가 기본값(Virtual-host style)으로 접근하더라도 정상 동작합니다.
3. 환경 변수 또는 fe.conf 확인 (제한적)
* 간혹 초기 버전에서는 `fe.conf`에 전역 설정을 시도해볼 수 있으나, Storage Volume은 개별 속성을 우선시하므로 fe.conf 설정이 무시될 가능성이 큽니다. (`aws_s3_path_style_access`와 같은 설정은 Storage Volume 객체에는 적용되지 않는 경우가 많습니다.)
요약하자면: v3.5.0에서는 Storage Volume 객체 내부의 Path-style 옵션 처리가 미흡한 상태이므로, 안정적인 운영을 위해 *v3.5.9 이상 버전으로의 업그레이드*를 적극 권장드립니다. v3.5.9는 해당 기능을 포함하여 다양한 클라우드 네이티브 스토리지 관련 버그가 수정된 버전입니다.
References
• sql-reference/sql-statements/cluster-management/storage_volume/CREATE_STORAGE_VOLUME.md
• administration/management/FE_configuration.md
• deployment/shared_data/s3.md양명구
08/31/2026, 4:58 AM