paimon

Amazon S3, Azure, HDFS 또는 로컬에 저장된 Apache Paimon 테이블에 읽기 전용 테이블과 유사한 인터페이스를 제공합니다.

구문

paimon(url [,access_key_id, secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

paimonS3(url [,access_key_id, secret_access_key] [,format] [,structure] [,compression] [,extra_credentials])

paimonAzure(connection_string|storage_account_url, container_name, blobpath, [,account_name], [,account_key] [,format] [,compression_method])

paimonHDFS(path_to_table, [,format] [,compression_method])

paimonLocal(path_to_table, [,format] [,compression_method])

인수

인수 설명은 각각 테이블 함수 s3, azureBlobStorage, HDFS, file의 인수 설명과 동일합니다. format은 Paimon 테이블의 데이터 파일 포맷을 나타냅니다. paimonS3에서는 선택적 extra_credentials 매개변수를 사용해 ClickHouse Cloud에서 역할 기반 접근을 위한 role_arn을 전달할 수 있습니다. 구성 단계는 Secure S3를 참조하십시오.

반환 값

지정된 Paimon 테이블의 데이터를 읽기 위한, 지정된 구조의 테이블입니다.

제한 사항

읽기 시 병합(merge-on-read)이 구현되지 않아 기본 키 테이블은 읽을 수 없습니다. 리더가 스냅샷의 데이터 파일을 가공 없이 합쳐 반환하므로, 이후 업서트로 대체된 이전 행 버전도 포함됩니다. 따라서 스키마에 primary-key가 선언된 테이블을 읽으면 예외가 발생합니다.

명명된 컬렉션 정의

다음은 URL과 자격 증명을 저장할 명명된 컬렉션을 구성하는 예시입니다:

<clickhouse>
    <named_collections>
        <paimon_conf>
            <url>http://test.s3.amazonaws.com/clickhouse-bucket/</url>
            <access_key_id>test</access_key_id>
            <secret_access_key>test</secret_access_key>
            <format>auto</format>
            <structure>auto</structure>
        </paimon_conf>
    </named_collections>
</clickhouse>

SELECT * FROM paimonS3(paimon_conf, filename = 'test_table')
DESCRIBE paimonS3(paimon_conf, filename = 'test_table')

별칭

테이블 함수 paimon은 이제 paimonS3의 별칭으로 사용됩니다.

가상 컬럼

_path — 파일 경로. 유형: LowCardinality(String).
_file — 파일 이름. 유형: LowCardinality(String).
_size — 파일 크기(바이트). 유형: Nullable(UInt64). 파일 크기를 알 수 없으면 값은 NULL입니다.
_time — 파일의 마지막 수정 시각. 유형: Nullable(DateTime). 시각을 알 수 없으면 값은 NULL입니다.
_etag — 파일의 etag 값. 유형: LowCardinality(String). etag를 알 수 없으면 값은 NULL입니다.

지원되는 데이터 타입

Paimon 데이터 타입	ClickHouse 데이터 타입
BOOLEAN	Bool
TINYINT	Int8
SMALLINT	Int16
INTEGER	Int32
BIGINT	Int64
FLOAT	Float32
DOUBLE	Float64
STRING,VARCHAR,BYTES,VARBINARY	String
DATE	Date
TIME(p),TIME	Time(‘UTC’)
TIMESTAMP(p) WITH LOCAL TIME ZONE	DateTime64
TIMESTAMP(p)	DateTime64(‘UTC’)
CHAR	FixedString(1)
BINARY(n)	FixedString(n)
DECIMAL(P,S)	Decimal(P,S)
ARRAY	Array
MAP	Map

파티션에서 지원되는 데이터 타입

Paimon 파티션 키에서 지원되는 데이터 타입:

CHAR
VARCHAR
BOOLEAN
DECIMAL
TINYINT
SMALLINT
INTEGER
DATE
TIME
TIMESTAMP
TIMESTAMP WITH LOCAL TIME ZONE
BIGINT
FLOAT
DOUBLE

SQL 참고

데이터 타입

엔진

함수

포맷

설정

시스템 테이블

데이터 레이크

구문

인수

반환 값

제한 사항

명명된 컬렉션 정의

별칭

가상 컬럼

지원되는 데이터 타입

파티션에서 지원되는 데이터 타입

관련 항목

​구문

​인수

​반환 값

​제한 사항

​명명된 컬렉션 정의

​별칭

​가상 컬럼

​지원되는 데이터 타입

​파티션에서 지원되는 데이터 타입

​관련 항목

구문

인수

반환 값

제한 사항

명명된 컬렉션 정의

별칭

가상 컬럼

지원되는 데이터 타입

파티션에서 지원되는 데이터 타입

관련 항목