동의어 정의

조직에는 고유한 용어나 동일한 개념을 지칭하는 여러 가지 방법이 있는 경우가 많습니다. 동의어를 정의하면 용어의 유사성이 정립되어 사용자가 검색 중에 항목을 찾는 데 도움이 됩니다.

참고: 서드 파티 데이터 소스에 대해서만 맞춤 동의어를 정의할 수 있습니다. Drive 또는 Gmail과 같은 Google Workspace 데이터 소스에서는 지원되지 않습니다.

_dictionaryEntry 잘 알려진 스키마를 사용하여 항목의 색인을 생성하여 동의어를 정의합니다.

_dictionaryEntry 유형의 항목에는 다음 속성이 있을 수 있습니다.

속성	유형	설명	필수 여부
_term	string	정의할 용어. 권장 값은 구두점과 하이픈이 없는 단어 또는 구입니다.	필수
_synonym	string (repeated)	_term에 정의된 문자열과 일치하며, 쿼리에 포함되는 대체 용어	필수
_onlyApplicableForAttachedSearchApplications	boolean	데이터 소스 및 검색 애플리케이션별로 동의어를 그룹화할 수 있습니다. 자세한 내용은 데이터 소스별 동의어 정의를 참고하세요.	선택사항

참고: _dictionaryEntry 스키마로 색인이 생성된 항목은 검색 애플리케이션의 데이터 소스 한도에 포함되지 않습니다.

사용자가 쿼리에 _term 값을 포함하면 유효한 쿼리가 'term OR synonyms'가 됩니다. 예를 들어 동의어 "science fiction"로 "scifi"를 정의하면 "scifi"에 대한 쿼리가 두 용어 중 하나를 포함하는 항목과 일치합니다.

동의어는 기본적으로 양방향이 아닙니다. "science fiction"에 대한 쿼리는 "scifi"을 동의어로 사용하여 용어로 정의하지 않는 한 정확한 구문과만 일치합니다. 용어를 서로 바꿔서 사용할 수 있게 하려면 각 용어를 별도로 정의하세요.

용어	동의어
scifi	science fiction
science fiction	scifi

쿼리 처리에서는 동의어를 적용하기 전에 하이픈과 구두점을 삭제합니다. "sci-fi"에 대한 쿼리는 "sci fi" 검색어와 일치합니다. 하이픈이 포함된 용어를 지원하려면 하이픈 대신 공백을 사용하도록 _term을 정규화하세요.

상호 교환 가능한 예:

용어	동의어
scifi	science fiction, sci fi
sci fi	science fiction, scifi
science fiction	scifi, sci fi

참고: Cloud Search에서 새 동의어를 처리하고 적용하는 데 최대 5시간이 걸릴 수 있습니다.

기본적으로 동의어는 전체 도메인과 모든 검색 애플리케이션에 적용됩니다. 이를 제한하려면 데이터 소스별 동의어 정의를 참고하세요.

SDK를 사용하여 전역 동의어 정의

콘텐츠 커넥터 SDK를 사용하여 용어와 동의어를 정의합니다. 자세한 내용은 콘텐츠 커넥터 만들기를 참고하세요.

이 스니펫은 CSV 레코드에서 RepositoryDoc를 빌드합니다.

DictionaryConnector.java

GitHub에서 보기

/**
 * Creates a document for indexing.
 *
 * For this connector sample, the created document is domain public
 *  searchable. The content is a simple text string.
 *
 * @param record The current CSV record to convert
 * @return the fully formed document ready for indexing
 */
private ApiOperation buildDocument(CSVRecord record) {
  // Extract term and synonyms from record
  String term = record.get(0);
  List<String> synonyms = StreamSupport.stream(record.spliterator(), false)
      .skip(1) // Skip term
      .collect(Collectors.toList());

  Multimap<String, Object> structuredData = ArrayListMultimap.create();
  structuredData.put("_term", term);
  structuredData.putAll("_synonym", synonyms);

  if (Configuration.getBoolean("dictionary.attachedToSearchApp", false).get()) {
    structuredData.put("_onlyApplicableForAttachedSearchApplications", true);
  }

  String itemName = String.format("dictionary/%s", term);

  // Using the SDK item builder class to create the item
  Item item =
      IndexingItemBuilder.fromConfiguration(itemName)
          .setItemType(IndexingItemBuilder.ItemType.CONTENT_ITEM)
          .setObjectType("_dictionaryEntry")
          .setValues(structuredData)
          .setAcl(DOMAIN_PUBLIC_ACL)
          .build();

  // Create the fully formed document
  return new RepositoryDoc.Builder()
      .setItem(item)
      .build();
}

중요 고려사항:

• 동의어 항목은 도메인 공용이어야 합니다. 예를 들어 ACL을 DOMAIN_PUBLIC_ACL로 설정할 수 있습니다.
• 구성 파일에서 defaultAcl.mode=FALLBACK 또는 defaultAcl.public=true와 같이 이 값을 재정의하는 설정은 피하세요.

검색 애플리케이션별 동의어 정의

팀별 동의어 (예: 엔지니어링팀과 영업팀)를 제공하려면 각 동의어를 _onlyApplicableForAttachedSearchApplications=true로 색인합니다. 이렇게 하면 특정 데이터 소스를 포함하는 검색 애플리케이션으로 동의어가 제한됩니다.

예:

structuredData.put("_onlyApplicableForAttachedSearchApplications", true);