URL - ClickHouse Documentation

URL 데이터베이스 엔진은 테이블 이름을 URL로 취급하며, 해당 URL의 데이터를 테이블로 노출합니다. 이 엔진은 url 테이블 함수를 사용하며, 이 함수는 각 URL을 file, s3, HDFS, Azure Blob Storage, HTTP 등 적절한 백엔드로 전달합니다.

데이터베이스 생성

CREATE DATABASE web_data
ENGINE = URL([base_url]);

base_url을 지정하면 상대 테이블 이름이 이 값을 기준으로 해석됩니다. 기준 URL이 없으면 모든 테이블 이름을 완전한 URL로 지정해야 합니다.

Usage

CREATE DATABASE web_data
ENGINE = URL('https://example.com/data/');

SELECT * FROM web_data.`daily.csv`;

이 데이터베이스는 테이블 정의를 보유하지 않습니다. 각 테이블은 사용되는 시점에 해당 URL로부터 해석되므로, 스키마는 현재 데이터로부터 추론됩니다. 테이블 이름에 전체 URL을 사용할 수도 있습니다. 예를 들어 web_data.s3://bucket/data/events.parquet“와 같이 지정합니다.

액세스 제어

이 데이터베이스를 생성하려면 table_engines_require_grant 설정과 무관하게 URL에 대한 READ 및 WRITE 소스 권한 부여가 필요합니다. 테이블을 읽을 때도 해석된 백엔드에 대한 READ 소스 권한 부여가 필요하며, 쓰기에는 그에 대응하는 WRITE 권한 부여가 필요합니다. 예시:

GRANT READ, WRITE ON URL TO user_name;
GRANT READ, WRITE ON S3 TO user_name;

file:// 기준 URL을 사용하는 데이터베이스에는 READ ON FILE 권한이 필요합니다. ClickHouse 서버에서는 로컬 파일 접근이 user_files_path 범위로 추가 제한됩니다. 버전 및 호환성 관련 자세한 내용은 SOURCES 권한을 참고하십시오.

관련 항목

마지막 수정일 2026년 9월 26일