> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-vortex-format.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

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

# S3

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

## 데이터베이스 생성

```sql theme={null}
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을 기준으로 한 상대 객체 경로가 됩니다:

```sql theme={null}
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`](/ko/reference/settings/server-settings/settings/other#table_engines_require_grant) 설정과 무관하게 `S3`에 대한 `READ` 및 `WRITE` source 권한 부여가 필요합니다. 예시는 다음과 같습니다:

```sql theme={null}
GRANT READ, WRITE ON S3 TO user_name;
```

버전 및 호환성 관련 자세한 내용은 [`SOURCES` 권한](/ko/reference/statements/grant#sources)을 참조하십시오.

## 관련 항목

* [`s3` 테이블 함수](/ko/reference/functions/table-functions/s3)
* [ClickHouse와 S3 함께 사용하기](/ko/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)
* [Filesystem 데이터베이스 엔진](/ko/reference/engines/database-engines/filesystem)
* [HDFS 데이터베이스 엔진](/ko/reference/engines/database-engines/hdfs)