S3

S3 데이터베이스 엔진은 Amazon S3 및 S3 호환 객체 스토리지의 객체를 읽기 전용 테이블로 노출합니다.

S3 데이터베이스 엔진은 Amazon S3 및 S3 호환 객체 스토리지에 있는 객체를 읽기 전용 테이블로 노출합니다. 테이블 이름은 s3 테이블 함수를 통해 객체 URL로 해석됩니다.

​

데이터베이스 생성

CREATE DATABASE s3_data
ENGINE = S3([url[, NOSIGN | access_key_id, secret_access_key]]);

이 엔진은 명명된 컬렉션(named collection)을 인자로 받을 수도 있습니다. 지원되는 구성 키는 url, access_key_id, secret_access_key, no_sign_request, use_environment_credentials입니다.

​

Usage

기준 URL을 지정하면 테이블 이름은 해당 URL을 기준으로 한 상대 객체 경로가 됩니다:

CREATE DATABASE s3_data
ENGINE = S3('https://bucket.s3.amazonaws.com/data/', 'NOSIGN');

SELECT * FROM s3_data.`events.parquet`;

기준 URL이 없으면 전체 객체 URL을 테이블 이름으로 사용하십시오. 스키마와 포맷은 s3 테이블 함수와 동일한 방식으로 추론됩니다. 이 데이터베이스는 테이블 정의를 보유하지 않으며, 테이블 DDL이나 쓰기 작업을 지원하지 않습니다.

​

액세스 제어

S3 URL은 서버의 remote-host filter를 통해 검사됩니다. 이 데이터베이스를 생성하려면 table_engines_require_grant 설정과 무관하게 S3에 대한 READ 및 WRITE source 권한 부여가 필요합니다. 예시는 다음과 같습니다:

GRANT READ, WRITE ON S3 TO user_name;

버전 및 호환성 관련 자세한 내용은 SOURCES 권한을 참조하십시오.

​

관련 항목

• s3 테이블 함수
• ClickHouse와 S3 함께 사용하기
• Filesystem 데이터베이스 엔진
• HDFS 데이터베이스 엔진