Fusion 데이터셋 조회와 검색 조건 함수

Lookup 함수는 인덱싱한 Foundry 데이터셋에서 값을 가져옵니다. 데이터셋 준비와 2,000개 결과 한도는 조회 가이드를 따릅니다. 아래 예시의 /Users/me/myData는 가상 경로이며 실제 경로와 열 이름으로 바꿉니다.

새로 인덱싱한 데이터셋이 조회 목록에 없으면 페이지를 새로 고치거나 Find and use data > Indexed datasets의 새로 고침 버튼을 선택합니다.

Lookup 공통 인수

조회값은 exact 또는 fuzzy로 감싸 일치 방식을 정할 수 있습니다. 지원하는 조회에서 첫 인수의 경로를 branch로 감싸 데이터셋 브랜치를 지정할 수 있습니다. 인수에는 셀 참조도 사용할 수 있습니다.

lookup

lookup(dataset_path: string, result_column: string, [column: string, value: string, ...]): any

필터 열과 값의 쌍을 모두 만족하는 행에서 결과 열의 값을 가져옵니다. 결과 하나는 단일 값, 여러 개는 배열입니다.

=lookup('/Users/me/myData', 'my_column', 'first_name', 'John', 'last_name', 'Doe')

이 예시는 first_name이 John이고 last_name이 Doe인 행들의 my_column을 반환합니다.

lookup_array

lookup_array(dataset_path: string, result_column: string, [column: string, value: string, ...]): any

일치 결과를 배열로 반환하며 결과가 하나여도 배열입니다. 순서는 행의 전역 순서를 따릅니다. 결과 열 값의 오름차순 정렬이 필요하면 lookup_sorted로 정렬 기준을 명시합니다.

=lookup_array('/Users/me/myData', 'my_column', 'first_name', 'John', 'last_name', 'Doe')

lookup_distinct

lookup_distinct(dataset_path: string, result_column: string, [column: string, value: string, ...]): any

필터에 맞는 결과 열 값 중 고유값만 반환합니다.

=lookup_distinct('/Users/me/myData', 'my_column', 'first_name', 'John')

lookup_dropdown

lookup_dropdown(
  dataset_path: string,
  result_column: string,
  [selected_value: string],
  [column: string, value: string, ...]
): any

조회한 고유값을 선택지로 사용하는 드롭다운입니다. selected_value는 현재 선택값이며 null을 지정하면 선택하지 않은 상태입니다.

=lookup_dropdown('/Users/me/myData', 'my_column', null, 'first_name', 'John')

lookup_sorted

lookup_sorted(
  dataset_path: string,
  result_column: string,
  sort_column: string,
  sort_direction: string,
  [column: string, value: string, ...]
): any

sort_column으로 정렬한 결과 열의 값을 반환합니다. sort_direction은 ASC 또는 DESC입니다. 결과 열, 정렬 열과 필터 열은 모두 지정한 데이터셋에 존재하는 열이어야 합니다.

lookup_schema

lookup_schema(datasource_path: string, [branch: string]): array

데이터소스의 열 이름을 배열로 반환합니다. branch를 선택적으로 지정할 수 있습니다.

lookup_set

lookup_set(dataset_path: string, result_column: string, [column: string, value: string, ...]): any

Deprecated 함수입니다. 필터에 맞는 결과 열 값을 순서 없는 set으로 반환합니다. exact 및 fuzzy 조회값을 지원합니다.

=lookup_set('/Users/me/myData', 'my_column', 'first_name', 'John', 'last_name', 'Doe')

기존 set을 다루는 함수는 배열과 set 참조에 설명되어 있습니다.

브랜치 지정

branch(dataset_path: string, branch_name: string): same_as_first_argument

dataset_path에 브랜치 이름 태그를 붙입니다. Lookup의 첫 인수에 적용하여 검색할 브랜치를 지정합니다.

검색 일치 방식

fuzzy의 distance는 0, 1, 2만 지원하며 기본값은 2입니다. 거리는 한 문자열을 다른 문자열로 바꾸는 단일 문자 편집 횟수인 Levenshtein 거리입니다.

비교 조건 태그

다음 함수는 조회값을 비교 연산으로 표시하여 lookup의 검색 동작을 바꿉니다. 반환형은 입력과 같은 값에 조건 태그를 붙인 same_as_first_argument입니다.

문서 메타데이터

document_metadata(key: string): string

Fusion 문서의 메타데이터를 반환합니다.

=document_metadata('creator')
=document_metadata('document_identifier')

각 줄은 별도의 셀에 입력하는 예시입니다.