paimon
paimon
Amazon S3, Azure, HDFS 또는 로컬에 저장된 Apache Paimon 테이블에 읽기 전용의 테이블 같은 인터페이스를 제공하는 테이블 함수예요.
출처: 문서
본문
Amazon S3, Azure, HDFS 또는 로컬에 저장된 Apache Paimon 테이블에 읽기 전용 테이블 같은 인터페이스를 제공해요.
문법 (Syntax)
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])
인자 (Arguments)
인자의 설명은 각각 s3, azureBlobStorage, HDFS, file 테이블 함수의 인자 설명과 일치해요.
format은 Paimon 테이블의 데이터 파일 포맷을 뜻해요.
paimonS3의 경우 선택 사항인 extra_credentials 파라미터로 ClickHouse Cloud에서 역할 기반 접근을 위한 role_arn을 전달할 수 있어요. 구성 단계는 Secure S3를 참고하세요.
반환값 (Returned value)
지정된 Paimon 테이블의 데이터를 읽을 수 있는, 지정된 구조를 가진 테이블이에요.
네임드 컬렉션 정의 (Defining a named collection)
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')
별칭 (Aliases)
테이블 함수 paimon은 이제 paimonS3의 별칭이에요.
가상 컬럼 (Virtual Columns)
_path— 파일의 경로예요. 타입:LowCardinality(String)._file— 파일의 이름이에요. 타입:LowCardinality(String)._size— 바이트 단위의 파일 크기예요. 타입:Nullable(UInt64). 파일 크기를 알 수 없으면 값은NULL이에요._time—