구문
- 연결 문자열
- 스토리지 계정 URL
- 명명된 컬렉션
자격 증명이 연결 문자열에 포함되어 있으므로
account_name/account_key를 별도로 지정할 필요가 없습니다:인수
이름이 지정된 컬렉션
명명된 컬렉션의 키 이름은 위치 함수 인수 이름과 다릅니다.
container는 container_name이 아니며, blob_path는 blobpath가 아닙니다.반환 값
예시
storage_account_url 방식으로 읽기
connection_string 형식으로 읽기
파티션을 사용한 쓰기
compatibility가 26.6 이상으로 설정되어 있거나 현재 기본값이 적용되는 경우, HIVE가 기본 파티션 전략으로 사용됩니다. 따라서 {_partition_id}를 포함하는 경로에는 WILDCARD 전략을 명시적으로 지정해야 합니다.
가상 컬럼
_path— 파일 경로입니다. 유형:LowCardinality(String)._file— 파일 이름입니다. 유형:LowCardinality(String)._size— 파일 크기(바이트)입니다. 유형:Nullable(UInt64). 파일 크기를 알 수 없으면 값은NULL입니다._time— 파일의 마지막 수정 시간입니다. 유형:Nullable(DateTime). 시간을 알 수 없으면 값은NULL입니다.
파티션별 쓰기
파티션 전략
INSERT 쿼리에서만 지원됩니다.
WILDCARD: 파일 경로의 {_partition_id} 와일드카드를 실제 파티션 키(파티션 키)로 대체합니다. compatibility 설정이 26.6보다 이전일 때만 기본값으로 선택됩니다. compatibility가 26.6 이상으로 설정되어 있거나 현재 기본값이 적용되는 경우 기본값은 HIVE이므로, {_partition_id}를 포함하는 경로에서는 WILDCARD를 명시적으로 선택해야 합니다(file_like_engine_default_partition_strategy 설정 참조).
HIVE는 읽기와 쓰기에서 Hive 스타일 파티셔닝을 사용합니다. 다음 포맷으로 파일을 생성합니다: <prefix>/<key1=val1/key2=val2...>/<snowflakeid>.<toLower(file_format)>.
HIVE 파티션 전략 예시
use_hive_partitioning 설정
partition_strategy 인수를 사용하십시오.
use_hive_partitioning 설정을 1로 지정하면 ClickHouse가 경로(/name=value/)에서 Hive 스타일 파티셔닝을 감지하고, 쿼리에서 파티션 컬럼을 가상 컬럼으로 사용할 수 있습니다. 이러한 가상 컬럼은 파티셔닝된 경로의 이름과 동일한 이름을 가집니다.
예시
Hive 스타일 파티셔닝으로 생성된 가상 컬럼 사용
azureBlobStorage 함수는 Shared Access Signatures(SAS)를 지원합니다.
Blob SAS 토큰에는 대상 blob, 권한, 유효 기간을 포함해 요청을 인증하는 데 필요한 모든 정보가 포함되어 있습니다. blob URL을 구성하려면 blob 서비스 endpoint에 SAS 토큰을 추가하십시오. 예를 들어 endpoint가 https://clickhousedocstest.blob.core.windows.net/이면 요청은 다음과 같습니다.