> ## 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.

> URL 데이터베이스 엔진은 URL로 지정된 데이터를 테이블 형태로 노출합니다.

# URL

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

## 데이터베이스 생성

```sql theme={null}
CREATE DATABASE web_data
ENGINE = URL([base_url]);
```

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

## Usage

```sql theme={null}
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`](/ko/reference/settings/server-settings/settings/other#table_engines_require_grant) 설정과 무관하게 `URL`에 대한 `READ` 및 `WRITE` 소스 권한 부여가 필요합니다. 테이블을 읽을 때도 해석된 백엔드에 대한 `READ` 소스 권한 부여가 필요하며, 쓰기에는 그에 대응하는 `WRITE` 권한 부여가 필요합니다. 예시:

```sql theme={null}
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`](/ko/reference/settings/server-settings/settings#user_files_path) 범위로 추가 제한됩니다.

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

## 관련 항목

* [`url` 테이블 함수](/ko/reference/functions/table-functions/url)
* [Filesystem 데이터베이스 엔진](/ko/reference/engines/database-engines/filesystem)
* [S3 데이터베이스 엔진](/ko/reference/engines/database-engines/s3)