executable 테이블 함수는 stdout으로 행을 출력하는 스크립트에서 정의한 사용자 정의 함수(UDF)의 출력을 기반으로 테이블을 생성합니다. 실행형 스크립트는 users_scripts 디렉터리에 저장되며, 모든 데이터 원본에서 데이터를 읽을 수 있습니다. 실행형 스크립트를 실행하는 데 필요한 패키지가 모두 ClickHouse 서버에 설치되어 있는지 확인하십시오. 예를 들어 Python 스크립트인 경우 서버에 필요한 Python 패키지가 설치되어 있어야 합니다.
선택적으로 하나 이상의 입력 쿼리를 포함할 수 있으며, 해당 쿼리의 결과가 스크립트에서 읽을 수 있도록 stdin으로 스트리밍됩니다.
일반 UDF와
executable 테이블 함수 및 Executable 테이블 엔진의 주요 차이점은 일반 UDF는 행 수를 변경할 수 없다는 점입니다. 예를 들어 입력이 100개 행이면 결과도 반드시 100개 행을 반환해야 합니다. executable 테이블 함수 또는 Executable 테이블 엔진을 사용하면 복잡한 집계를 포함해 원하는 형태로 데이터를 변환할 수 있습니다.executable 테이블 함수에는 3개의 매개변수가 필요하며, 선택적으로 입력 쿼리 목록도 받을 수 있습니다.
script_name: 스크립트 파일 이름입니다.user_scripts폴더(user_scripts_path설정의 기본 폴더)에 저장됩니다.format: 생성되는 테이블의 포맷structure: 생성되는 테이블의 스키마input_query: 결과가 stdin을 통해 스크립트로 전달되는 선택적 쿼리(또는 collection이나 여러 쿼리)
동일한 입력 쿼리로 같은 스크립트를 반복 호출할 예정이라면
Executable 테이블 엔진 사용을 고려하십시오.generate_random.py이며 user_scripts 폴더에 저장됩니다. 이 스크립트는 숫자 i를 읽어 i개의 임의 문자열을 출력하며, 각 문자열 앞에는 탭으로 구분된 숫자가 붙습니다:
send_chunk_header- 처리할 데이터 청크를 보내기 전에 행 수를 함께 보낼지 여부를 제어합니다. 기본값은false입니다.pool_size— 풀 크기입니다.pool_size에 0을 지정하면 풀 크기에 제한이 없습니다. 기본값은16입니다.max_command_execution_time— 데이터 블록 처리용 실행형 스크립트 명령의 최대 실행 시간입니다. 초 단위로 지정합니다. 기본값은 10입니다.command_termination_timeout— 실행형 스크립트에는 기본 읽기-쓰기 루프가 포함되어 있어야 합니다. 테이블 함수가 제거되면 파이프가 닫히고, 실행형 파일은 종료를 위해command_termination_timeout초 동안 대기합니다. 이 시간이 지나면 ClickHouse가 자식 프로세스에 SIGTERM 신호를 보냅니다. 초 단위로 지정합니다. 기본값은 10입니다.command_read_timeout- 명령의 stdout에서 데이터를 읽는 timeout이며 밀리초 단위로 지정합니다. 기본값은 10000입니다.command_write_timeout- 명령의 stdin에 데이터를 쓰는 timeout이며 밀리초 단위로 지정합니다. 기본값은 10000입니다.
Executable 테이블 엔진의 예시를 확인하십시오. 아래에서는 executable 테이블 함수를 사용해 해당 예시와 동일한 스크립트를 실행하는 방법을 설명합니다: