ArrowFlight 테이블 엔진

​

테이블 생성

CREATE TABLE [IF NOT EXISTS] [db.]table_name (name1 [type1], name2 [type2], ...)
    ENGINE = ArrowFlight('host:port', 'dataset_name' [, 'username', 'password']);

• host:port — 원격 Arrow Flight 서버의 주소입니다. 포트를 생략하면 기본 포트 8815가 사용됩니다. String.
• dataset_name — Flight 서버의 데이터셋 식별자입니다(arrow_flight_request_descriptor_type 설정에 따라 PATH 디스크립터로 사용되거나 SELECT * 쿼리에서 사용됩니다). String.
• username — 기본 HTTP 인증용 사용자 이름입니다. String.
• password — 기본 HTTP 인증용 비밀번호입니다. String.

​

이름이 지정된 컬렉션

CREATE TABLE remote_flight_data
    ENGINE = ArrowFlight(named_collection_name);

​

설정

• arrow_flight_request_descriptor_type — 데이터셋 이름을 Flight 서버로 전송하는 방식을 제어합니다. 가능한 값은 path(기본값, PATH 디스크립터로 전송) 또는 command(SELECT * FROM <dataset>를 포함한 CMD 디스크립터로 전송)입니다. SQL 명령을 기대하는 Flight 서버(예: Dremio)에는 command를 사용하십시오.
• arrow_flight_request_timeout_sec — 단일 Arrow Flight 요청의 타임아웃(초)이며, 기본값은 300입니다. 이 제한은 요청 전체에 적용됩니다. 즉, SELECT의 경우 첫 번째 레코드 배치를 기다리는 시간만이 아니라 전체 결과 스트림을 받는 시간까지 포함됩니다. 0은 타임아웃을 두지 않음을 의미하며, 이 경우 Flight 서버가 요청을 수락한 뒤 응답하지 않으면 연결이 종료될 때까지 쿼리가 블로킹됩니다.

​

사용 예시

CREATE TABLE remote_flight_data
(
    id UInt32,
    name String,
    value Float64
) ENGINE = ArrowFlight('127.0.0.1:9005', 'sample_dataset');

SELECT * FROM remote_flight_data ORDER BY id;

┌─id─┬─name────┬─value─┐
│  1 │ foo     │ 42.1  │
│  2 │ bar     │ 13.3  │
│  3 │ baz     │ 77.0  │
└────┴─────────┴───────┘

INSERT INTO remote_flight_data VALUES (4, 'qux', 99.9);

​

참고 사항

• CREATE TABLE 문에서 컬럼을 지정한 경우, Flight 서버가 반환하는 스키마와 일치해야 합니다.
• 컬럼을 생략한 경우, 스키마는 원격 server에서 자동으로 추론됩니다.
• 읽기(SELECT)와 쓰기(INSERT)를 모두 지원합니다.
• arrow_flight_request_descriptor_type 설정은 데이터셋 이름을 PATH 디스크립터로 보낼지, 또는 SELECT * 쿼리를 감싸는 CMD 디스크립터로 보낼지를 제어합니다.

​

관련 항목

• arrowFlight 테이블 함수
• Arrow Flight 인터페이스
• Apache Arrow Flight SQL
• ClickHouse의 Arrow 형식 통합