History: 검색 색인

            ! 검색 색인

^티키의 검색 엔진은 ((Tiki7|티키7)) 을 위하여 다시 제작되었으며 본 문서는 버전 7 및 그 이후에만 적용됩니다.^

티키에서의 검색 능력은, ((PluginList)) 혹은 ((Unified Search|통합 검색)) 등에서 사용되며, 검색 색인에 의존합니다.


티키는 내부적으로 여러 개의 검색엔진들을 지원할 수 있습니다. 각각의 검색엔진은 다른 능력과 제한을 가지게 될 것입니다. 기본 엔진은 중소규모의 사이트에 대하여 충분한 능력을 제공하여야 합니다. 대형 사이트는 최대한의 성능을 얻기 위하여 추가 인프라스트럭쳐가 필요할 수도 있습니다.

!! Lucene (PHP 적용)
기본 구현은 [http://framework.zend.com/manual/en/zend.search.lucene.html|Zend_Search_Lucene] 에 기반하고 있으며, 이는 자바의 PHP 구현입니다 [http://lucene.apache.org/|Lucene index engine]. 엔진은 외부 의존도가 없으며 모든 호스트에서 실행될 수 잇씁니다. 하지만, 수용할만한 성능에 도달하기 위해서는 몇몇 구성설정이 요구될 수도 있습니다.

완벽한 색인을 빌드하기 위하여 필요한 시간은 사이트의 컨텐츠에 따라 다양할 것입니다. 참고로,

* doc.tiki.org (이 사이트), 는 1400개가 넘는 페이지가 있으며, 재인덱싱에 3분 정도 걸립니다
* themes.tiki.org, 는 몇몇 페이지와 수백게가 넘는 게시판 게시물이 있으며, 재인덱싱에 15초 정도 걸립니다
* 회사 인트라넷으로써 파일 갤러리에 수 기가바이트의 데이터는 한 시간 넘게 걸릴 수 있습니다

하지만, 증분적 색인이 사용될 수 있으며, 이 경우 완전 재인덱스는 특정 기간마다 혹은 업그레이드 시에만 필요합니다.

Alexander Veremy, 는 컴포넌트의 저자로써 [http://zend-framework-community.634137.n4.nabble.com/Zend-Search-Lucene-Large-amount-of-data-tp643668p643669.html|변수를 조절에 대한 몇몇 이해] 을 제공하고 있습니다.

!! 필드

아래는 필드와 개체 유형간의 행렬입니다.

범례:
* 토큰화됨, 전체 텍스트 검색을 위한 단어들로 분해된 방식으로..
* 정렬가능

|| | __토큰화됨__|__정렬가능__|__위키 페이지__|__게시판 게시물__|__블로그 게시물__|__기사__|__파일__|__트래커항목__|__시트__|__댓글__|__사용자__|제공되는 티키 버전
::Generic::| |  |  |  |  |  |  |  |  |  | 
__object_type__| | X|X|X|X|X|X|X|X|X|X|7
__object_id__| | X|X|X|X|X|X|X|X|X|X|7
__title__|X|X|X|X|X|X|X|X|X|?|X|7
__language__| | X|X|/|/|X|/|?|/|/| |7
__modification_date__| | X|X|X|X|X|X|X|X|X| |7
__contributors__| |  | X|X|X|X|X|X|X|X| |7
__description__|X| | X| |  | X|X| | X| | |7
__contents__|X| | X|X|X|X|X|X|X|X|X|7
::Specific::| |  |  |  |  |  |  |  |  |  | 
__wiki_content__| |  | X| |  |  |  |  |  |  |X|7
__wiki_uptodateness__| | X|X| |  |  |  |  |  |  | |7
__wiki_approval_state__| |  |X| |  |  |  |  |  |  | |11
__post_content__| |  |  | X| |  |  |  |  | X| |7
__parent_thread_id__ (not to be confused with parent_object_id)| |  |  | X| |  |  |  |  |  | |8
__blog_id__| | X| |  | X| |  |  |  |  | |7
__blog_excerpt__| |  |  |  | X| |  |  |  |  | |7
__blog_content__| |  |  |  | X| |  |  |  |  | |7
__topic_id__| | X| |  |  | X| |  |  |  | |7
__article_content__| |  |  |  |  | X| |  |  |  | |7
__article_topline__| |  |  |  |  | X| |  |  |  | |7
__article_subtitle__| |  |  |  |  | X| |  |  |  | |7
__article_author__| |  |  |  |  | X| |  |  |  | |9
__article_type__| |  |  |  |  | X| |  |  |  | |9
__gallery_id__| | X| |  |  |  | X| |  |  | |7
__filename_id__| | X| |  |  |  | X| |  |  | |7
__filetype__|X|X| |  |  |  | X| |  |  | |7
__file_comment__| |  |  |  |  |  | X| |  |  | |7
__file_content__| |  |  |  |  |  | X| |  |  | |7
__tracker_id__| | X| |  |  |  |  | X| |  | |7
__tracker_status__| | X| |  |  |  |  | X| |  | |7
__tracker_field_''ID''__|X|?| |  |  |  |  | X| |  | |7
__sheet_content__| |  |  |  |  |  |  |  | X| | |7
__comment_content__|X| |  |  |  |  |  |  |  | X| |7
__user_country__|X|X|  |  |  |  |  |  |  |  |X|10
::Internal::| |  |  |  |  |  |  |  |  |  | |
__view_permission__| |  | X| |  | X| |  | X| | |7
__parent_object_type__| | X| | X|X|X|X|X| | X| |7
__parent_object_id__| | X| | X|X|X|X|X| | X| |7
__parent_view_permission__| |  |  | X|X|X|X|X| | X| |7
__global_view_permission__| |  |  |  |  |  |  |  |  | X| |7
__hash__| |  | X| |  |  |  |  |  |  | |7
__url__| |  | X| |  |  |  |  |  | X| |7
::Global::| |  |  |  |  |  |  |  |  |  |  |
__categories__| |  | X|X|X|X|X|X|X|X| |7
__deep_categories__| |  | X|X|X|X|X|X|X|X| |7
__allowed_groups__| |  | X|X|X|X|X|X|X|X| |7
__freetags__| |  | X|X|X|X|X|X|X|X| |7
__freetags_text__| |  | X|X|X|X|X|X|X|X| |7
__adv_rating_''ID''__| | X|X|X|X|X|X|X|X|X|X|7
__comment_count__| | X|X|X|X|X|X|X|X|X| |8
__relations__| |  | X|X|X|X|X|X|X|X|X|8
__attachments__| |  | X|X|X|X|X|X|X|X| |7
__attachment_contents__|X| | X|X|X|X|X|X|X|X| |7
__geo_located__| |  | X|X|X|X|X|X|X|X|X|9
__geo_location__| |  | X|X|X|X|X|X|X|X|X|9
__visits__| | X|X| |  |  | X| |  |  | |9.2||

^X 제공됨
/ 정적값
? 데이터에 의존적^

트래커 필드에 대한 색인은 필드 종류에 따라 다양할 것입니다. 일반적인 규칙으로써, tracker_field_''ID'' 가 필드로써 사용될 것이며 정렬 가능할 것입니다. 하지만, 몇몇 예외가 있습니다:
* 이미지와 파일 필드는 색인되지 않습니다
* 텍스트영역(TextArea) 은 정렬 가능하지 않습니다
* 다국어 필드는 복수 필드로 색인됩니다:
** 보통의 경우 모든 언어를 포함합니다
** tracker_field_''ID''_''lang'' 은 하나의 언어만을 포함합니다  (예들 들면 tracker_field_12_fr 처럼)
* 등급과 관련 필드는 복수의 필드를 저장합니다
** tracker_field_''ID'' 는 평균을 포합합니다
** tracker_field_''ID''_sum 은 투표 총합을 포함합니다
** tracker_field_''ID''_count 는 투표수를 포함합니다
* 항목목록과 항목 링크 필드
** tracker_field_''ID''_text 는 ID 대신에 텍스트를 포함합니다
*만약 언어 필드가 트래커 항목에 대하여 설정되어있다면, 해당 언어는 아이템 언어로 색인됩니다.

__buildQuery/tiki-searchindex.php 에 사용되는 일부(이들이 실제 필드인지 혹은 도우미인지에 대한 설명 필요):__
__type__: 는 __object_type__ 를 참조합니다
__deep__: 만약 이것이 설정되었다면, __categories__ 나  __deep-categories__ 로 고려될 것입니다
__autocomplete__: 은 해당내용으로 시작되는 제목을 가진 항목들을 찾을 것입니다


!! 검색 색인 재빌드

색인은 temp/unified-index/ 에 저장됩니다. 재빌드가 진행되는 동안, 디렉터리  temp/unified-index-new/ 가 나타날 것입니다. (이는 새 것이 준비될 때까지 기존의 색인이 사용되는 것을 허용하기 위함입니다) 만약 temp/unified-index-new/ 가 색인작업의 종료 후 사라지지 않는다면, 무엇인가 잘 못된 것입니다. 이를 삭제하고 색인을 다시 시도해 보실 수 있습니다. 권한이 모두 OK 이라는 확신을 가지려면 "sh setup.sh" 를 실행하실 수도 있습니다

!!! 티키 인터페이스에서
다음 url 을 방문하실 수 있습니다: __tiki-admin.php?page=search&rebuild=now__ 그리고 사이트가 소규묘라면 검색 색인이 다시 빌드 될 것입니다. 로드가 중급에서 높은 사이트라면, 명령어에서 진행하실 수 있습니다.

!!! 명령어에서
검색 색인은 다음 명령어를 사용하여 명령입력에서 재빌드될 수 있습니다:
{CODE(colors="bash")}
cd path_to_tiki/; php lib/search/shell.php rebuild;sh setup.sh -n
{CODE}

위 명령어를 cron job 에 위차하여 트키 표준 사이트에서 보다 적은 사용자가 활동적인 밤 시간에 진행되도롤 할 수 있습니다.  ((Cron)) 을 살펴보십시오.

문제가 발생하였고 기록을 남기고 싶으시다면,

{CODE(colors="bash")}
php lib/search/shell.php rebuild log
{CODE}

이 기록(로그)은 temp/Search_Indexer.log 에 있을 것입니다.

관련:
* ((PluginList))
* ((PluginCustomSearch))
* ((dev:Unified Search))