> ## 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`](/ja/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

base URL を指定した場合、テーブル名はその URL からの相対的なオブジェクトパスとなります。

```sql theme={null}
CREATE DATABASE s3_data
ENGINE = S3('https://bucket.s3.amazonaws.com/data/', 'NOSIGN');

SELECT * FROM s3_data.`events.parquet`;
```

base URL を指定しない場合は、オブジェクトの完全な URL をテーブル名として使用します。スキーマとフォーマットは、`s3` テーブル関数と同じ方法で推論されます。このデータベースはテーブル定義を保持せず、テーブルの DDL や書き込みもサポートしません。

## アクセス制御

S3 URL は、サーバーの remote-host フィルターによってチェックされます。このデータベースを作成するには、[`table_engines_require_grant`](/ja/reference/settings/server-settings/settings/other#table_engines_require_grant) の設定にかかわらず、`S3` に対する `READ` および `WRITE` のソース権限が必要です。例:

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

バージョンおよび互換性の詳細については、[`SOURCES` 権限](/ja/reference/statements/grant#sources)を参照してください。

## 関連項目

* [`s3` テーブル関数](/ja/reference/functions/table-functions/s3)
* [ClickHouse で S3 を使用する](/ja/integrations/connectors/data-ingestion/AWS/integrating-s3-with-clickhouse)
* [Filesystem データベースエンジン](/ja/reference/engines/database-engines/filesystem)
* [HDFS データベースエンジン](/ja/reference/engines/database-engines/hdfs)