XCLIP

표기법 규칙

• 괄호 ()는 리터럴 괄호를 나타냅니다.
• 중괄호 {}는 옵션 조합을 묶는 데 사용됩니다.
• 대괄호 []는 선택적 절을 나타냅니다.
• 대괄호 [ , ... ] 안에 있는 쉼표 다음에 오는 줄임표는 앞의 항목이 쉼표로 구분된 목록으로 반복될 수 있음을 의미합니다.
• 세로 막대 |는 논리 OR를 나타냅니다.
• VALUE는 값을 의미합니다.

• 리터럴: 고정되거나 변경할 수 없는 값을 의미하며 상수(Constant)라고도 불립니다.

  각 리터럴은 테이블에서 컬럼과 같은 특별한 자료형을 가지고 있습니다.

CONVERT 구문

"CONVERT" 구문은 데이터를 수치화한 벡터로 변환하고 이를 사용할 데이터 테이블에 추가합니다.

query_statement:
    query_expr

CONVERT USING (model_name_expression)
OPTIONS (
    expression [ , ...]
    )
AS
(query_expr)

OPTIONS 절

OPTIONS (
    (video_col=column_name),
    (text_col=column_name),
    (convert_type={'video'|'text'}),
    [batch_size=VALUE],
    [result_col=column_name]
    )

"OPTIONS" 절에서 매개변수의 값을 기본값으로부터 변경할 수 있습니다. 각 매개변수의 의미는 아래와 같습니다.

• "video_col": 데이터 테이블에서 비디오의 경로를 담은 컬럼의 이름입니다. (str, default: 'video_path')
• "text_col": 데이터 테이블에서 텍스트를 담은 컬럼의 이름입니다. (str, default: 'text')
• "convert_type": 수치화할 파일의 종류를 설정합니다. (str, 'video'|'text', default: 'video')
• "batch_size": 한 번의 학습에서 읽는 데이터 세트 묶음의 크기입니다. (int, optional, default: 16)
• "result_col": 데이터 테이블에서 수치화 결과를 담을 컬럼 이름을 설정합니다. (str, optional, default: 'convert_result')

CONVERT 예시

텍스트로 비디오 검색하기에서 "CONVERT" 구문 사용 예시를 확인하실 수 있습니다.

%%thanosql
CONVERT USING tutorial_search_xclip
OPTIONS (
    video_col='video_path',
    result_col='convert_result'
    )
AS
SELECT *
FROM kinetics700

SEARCH VIDEO 구문

"SEARCH VIDEO" 구문을 사용하여 원하는 비디오를 검색할 수 있습니다.

query_statement:
    query_expr

SEARCH VIDEO 
USING (model_name_expression)
OPTIONS (
    expression [ , ...]
    )
AS
(query_expr)

OPTIONS 절

OPTIONS (
    (search_by={image|text|audio|video}),
    (search_input=expression),
    (emb_col=column_name),
    [result_col=expression],
    [top_k=VALUE]
    )

"OPTIONS" 절에서 매개변수의 값을 기본값으로부터 변경할 수 있습니다. 각 매개변수의 의미는 아래와 같습니다.

• "search_by": 검색할 때 사용할 이미지|텍스트|오디오|비디오 타입을 설정합니다. (str)
• "search_input": 검색할 때 사용할 입력값입니다. (str)
• "emb_col": 데이터 테이블에서 수치화된 결과를 담은 컬럼의 이름입니다. (str)
• "result_col": 데이터 테이블에서 검색 결과를 담을 컬럼 이름을 설정합니다. (str, optional, default: 'search_result')
• "top_k": 반환할 행의 수를 설정합니다. None을 입력할 시 데이터 테이블 전체를 반환합니다. (int, optional, default: 1000)

SEARCH VIDEO 예시

텍스트로 비디오 검색하기에서 "SEARCH VIDEO" 구문 사용 예시를 확인하실 수 있습니다.

%%thanosql
SEARCH VIDEO
USING tutorial_search_xclip
OPTIONS (
    search_by='text',
    search_input='bench press',
    emb_col='convert_result',
    result_col='score',
    top_k=10
    )
AS
SELECT *
FROM kinetics700

---

Last update: 2023-08-09