엘라스틱서치와 한국어 형태소 분석기 은전한잎 사용법

들어가며: 검색엔진 엘라스틱서치와 한국어 형태소 분석기 은전한잎

엘라스틱Elastic에서 개발한 엘라스틱서치Elasticsearch는 아파치 루씬Apache Lucene 기반의 검색 서버입니다. 설치도 간편하며 기본 설정으로 사용해도 충분히 강력하지만 기본적으로 한국어 형태소 분석을 지원하지 않습니다. 예를 들어 “아버지가 방에 들어간다”라는 한국어 문장을 인덱스해도 “아버지”로는 검색이 안 되고, 반드시 “아버지가”로 검색해야만 검색이 됩니다. 이는 엘라스틱서치의 기본 토크나이저가 공백이나 특수문자만으로 단어를 분리하기 때문입니다. 이러한 문제를 해결하기 위해서는 n그램 분석이나, 형태소 분석과 같은 인덱스를 추가로 지원해야합니다. 이 글에서는 일본어 형태소 분석기 메카브MeCab를 한국어에 맞춰 수정한 은전한잎mecab-ko을 통해 엘라스틱서치에서 한국어를 인덱스하는 방법에 대해서 다룹니다.

44BITS 소식과 클라우드 뉴스를 전해드립니다. 지금 5,000명 이상의 구독자와 함께 하고 있습니다 📮

TL;DR

도커Docker를 사용해 한글 형태소 분석기가 적용된 엘라스틱서치를 바로 사용해볼 수 있습니다.

$ docker run -p 9200:9200 nacyot/elasticsearch-korean
$ curl -XPUT http://0.0.0.0:9200/korean/ -d '{"settings": {"index":{"analysis":{"analyzer":{"korean":{"type":"custom","tokenizer":"mecab_ko_standard_tokenizer"}}}}}}'
$ curl -XGET http://0.0.0.0:9200/korean/_analyze?analyzer=korean\&pretty=true -d '아버지가 방에 들어간다' | jq '.tokens[] | {token: .token, type: .type}'

# 분석 결과

{
  "token": "아버지가",
  "type": "EOJEOL"
}
{
  "token": "아버지",
  "type": "N"
}
{
  "token": "방에",
  "type": "EOJEOL"
}
{
  "token": "방",
  "type": "N"
}
{
  "token": "들어간다",
  "type": "INFLECT"
}

설치하기

엘라스틱서치에서 한글 형태소 분석기를 사용하려면 은전한잎을 설치해야 합니다. 다음 설치 방법은 우분투 14.04 운영체제에 오라클 자바 8 버전과 엘라스틱서치가 설치되었다는 것을 전제로 작성되었습니다. 은전한잎 플러그인은 엘라스틱서치 1.3 ~ 1.6(2015년 6월 현재 최신버전)에서 사용가능합니다. 테스트에 사용한 버전은 1.6입니다.

은전한잎(mecab-ko) 설치

먼저 은전한잎을 설치합니다. 은전한잎은 일본어 형태소 분석기 메카브MeCab를 한국어에 맞게 수정한 프로젝트로 mecab-ko라는 프로젝트 이름을 가지고 있다. 최신버전 및 자세한 내용은 저장소를 참고하기 바랍니다.

# 의존성 설치
$ apt-get install -y automake perl build-essential

# mecab-ko 다운로드
$ cd /opt
$ wget https://bitbucket.org/eunjeon/mecab-ko/downloads/mecab-0.996-ko-0.9.2.tar.gz
$ tar xvf mecab-0.996-ko-0.9.2.tar.gz

# 빌드 및 설치
$ cd /opt/mecab-0.996-ko-0.9.2
$ ./configure
$ make
$ make check
$ make install
$ ldconfig

mecab-ko-dic 설치

다음으로 형태소 분석을 위한 사전을 설치합니다. 자세한 내용은 저장소를 참조하기 바랍니다.

# mecab-ko-dic 다운로드
$ cd /opt
$ wget https://bitbucket.org/eunjeon/mecab-ko-dic/downloads/mecab-ko-dic-2.0.0-20150517.tar.gz
$ tar xvf mecab-ko-dic-1.6.1-20140814.tar.gz

# 빌드 및 설치
$ cd /opt/mecab-ko-dic-1.6.1-20140814
$ ./autogen.sh
$ ./configure
$ make
$ make install

mecab-java 설치

다음므로 taggerlexicon의 메모리 누수가 해결된 mecab-java 버전을 설치합니다.

# 환경 변수 설정
$ export JAVA_TOOL_OPTIONS -Dfile.encoding=UTF8

# mecab-java 다운로드
$ cd /opt
$ wget https://mecab.googlecode.com/files/mecab-java-0.996.tar.gz
$ tar xvf mecab-java-0.996.tar.gz

# 빌드 및 설치
$ cd /opt/mecab-java-0.996
$ sed -i 's|/usr/lib/jvm/java-6-openjdk/include|/usr/lib/jvm/java-8-oracle/include|' Makefile
$ make

# 빌드된 파일 이동(elasticsearch 실행시 참조해주어야 함)
$ cp libMeCab.so /usr/local/lib

엘라스틱서치 mecab-ko 플러그인 설치

마지막으로 엘라스틱서치에서 사용할 수 있도록 mecab-ko를 설치한다. <ELASTICSEARCH_PATH>에는 엘라스틱서치가 설치된 경로를 넣어줍니다.

<ELASTICSEARCH_PATH>/bin/plugin --install analysis-mecab-ko-0.17.0 --url https://bitbucket.org/eunjeon/mecab-ko-lucene-analyzer/downloads/elasticsearch-analysis-mecab-ko-0.17.0.zip

형태소 분석을 통한 한국어 문장 검색

먼저 엘라스틱서치를 앞서 빌드한 mecab-java를 참조시켜서 실행합니다.

$ elasticsearch -Djava.library.path=/usr/local/lib

한글 분석기가 정상적으로 작동하는 지 확인하기 위해 우선 기본 분석기를 통해서 문장을 분석해봅니다.

$ curl -XGET http://0.0.0.0:9200/_analyze?pretty=true -d '아버지가 방에 들어간다.'

# 분석 결과

{
  "tokens": [
    {
      "token": "아버지가",
      "start_offset": 0,
      "end_offset": 4,
      "type": "<HANGUL>",
      "position": 1
    },
    {
      "token": "방에",
      "start_offset": 5,
      "end_offset": 7,
      "type": "<HANGUL>",
      "position": 2
    },
    {
      "token": "들어간다",
      "start_offset": 8,
      "end_offset": 12,
      "type": "<HANGUL>",
      "position": 3
    }
  ]
}

처음에 이야기한 대로 문장이 공백을 기준으로 “아버지가”가 통째로 인덱스됩니다. 이렇게 되면 “아버지”로는 이 문장을 검색할 수 없습니다.

# 데이터 입력
$ curl -XPUT 'http://0.0.0.0:9200/default/text/1' -d '{"text": "아버지가 방에 들어간다"}'

# '아버지'로 검색
$ curl -XGET 'http://0.0.0.0:9200/default/_search' -d '{"query":{"term": {"text": "아버지"}}}}' | jq .hits
{
  "total": 0,
  "max_score": null,
  "hits": []
}

# '아버지가'로 검색
$ curl -XGET 'http://0.0.0.0:9200/default/_search' -d '{"query":{"term": {"text": "아버지가"}}}}' | jq .hits
{
  "total": 1,
  "max_score": 0.15342641,
  "hits": [
    {
      "_index": "default",
      "_type": "text",
      "_id": "1",
      "_score": 0.15342641,
      "_source": {
        "text": "아버지가 방에 들어간다"
      }
    }
  ]
}

이번에는 korean이라는 이름으로 mecab_ko_standard_tokenizer가 적용된 인덱스를 생성합니다.

$ curl -XPUT http://0.0.0.0:9200/korean/ -d '{
  "settings" : {
    "index":{
      "analysis":{
        "analyzer":{
          "korean":{
            "type":"custom",
            "tokenizer":"mecab_ko_standard_tokenizer"
          }
        }
      }
    }
  },
  "mappings": {
    "text" : {
      "properties" : {
        "text" : {
          "type" : "string",
          "analyzer": "korean"
        }
      }
    }
  }
}'

이 인덱스를 통해서 한국어 문장을 분석해보겠습니다.

$ curl -XGET http://0.0.0.0:9200/korean/_analyze?analyzer=korean\&pretty=true -d '아버지가 방에 들어간다' | jq '.tokens[] | {token: .token, type: .type}'

{
  "token": "아버지가",
  "type": "EOJEOL"
}
{
  "token": "아버지",
  "type": "N"
}
{
  "token": "방에",
  "type": "EOJEOL"
}
{
  "token": "방",
  "type": "N"
}
{
  "token": "들어간다",
  "type": "INFLECT"
}

이번에는 “아버지”나 “방”이 명사로 분석된 것을 알 수 있습니다. 이렇게 인덱스가 되면 정상적으로 검색이 가능합니다.

# 데이터 입력
$ curl -XPUT 'http://0.0.0.0:9200/korean/text/1' -d '{"text": "아버지가 방에 들어간다"}'

# '아버지'로 검색
$ curl -XGET 'http://0.0.0.0:9200/korean/_search' -d '{"query":{"term": {"text": "아버지"}}}}' | jq .hits
{
  "total": 1,
  "max_score": 0.15342641,
  "hits": [
    {
      "_index": "korean",
      "_type": "text",
      "_id": "1",
      "_score": 0.15342641,
      "_source": {
        "text": "아버지가 방에 들어간다"
      }
    }
  ]
}

앞서 확인한 분석 결과대로 검색이 되는 것을 알 수 있습니다.

결론

일반적으로 동적으로 풀텍스트 서치를 하는 경우 원하는 결과가 검색될 가능성은 높지만, 매우 비효율적이고 검색 대상이 많아질수록 느려집니다. 검색엔진으로 분류되는 도구들은 미리 텍스트를 분석해 인덱스를 만들기 때문에 매우 효율적으로 키워드 검색이 가능합니다. 단, 인덱스를 의도한대로 만들어야만 원하는 검색결과를 얻을 수 있습니다. 앞서 살펴보았듯이 한글 문장을 검색하고자 한다면, 적절히 형태소 분석을 통한 한글 인덱스나 n그램 인덱스를 만들어줄 필요가 있습니다. 엘라스틱서치에서는 analyzermapping을 통해서 각 인덱스와 타입들에 대해서 섬세하고 풍부한 인덱스 기능을 지원하고 있습니다. 이러한 기능들을 잘 활용한다면 의도한 대로 검색 결과를 얻을 수 있을 것입니다.

아마존 웹서비스 커맨드라인 인터페이스(AWS CLI) 기초

🗒 기사, 2018-06-25 - 아마존 웹 서비스에서는 공식 커맨드라인 인터페이스 클라이언트 AWSCLI를 제공합니다. AWSCLI를 사용하면 명령줄에서 직접 AWS의 기능을 호출하는 것이 가능합니다. AWSCLI를 설치 및 설정하고 기본적인 사용법에 대해서 알아봅니다.

AWS 람다 레이어(AWS Lambda Layers)를 다른 계정이나 조직과 공유하기

🗒 기사, 2019-01-03 - 리인벤트(re:Invent) 2018에서는 AWS 람다의 새로운 기능으로 람다 함수들 간의 공통 부분을 공유할 수 있는 람다 레이어를 발표했습니다. 람다 레이어는 하나의 계정에서 공통 부분을 분리하는 데 사용할 수도 있지만 다른 조직이나 계정과 공유해서 사용하는 것도 가능합니다. 이 글에서는 람다 레이어를 다른 계정과 공유하는 방법에 대해서 알아봅니다.

AWS RDS for PostgreSQL에서 S3 데이터 임포트 기능 지원

🗞 새소식, 2019-04-26 - 4월 24일 AWS에서는 PostgreSQL Amazon S3에 있는 데이터를 Amazon RDS for 에 가져오는(import) 기능을 발표했습니다. 이 기능을 사용하면 S3에 저장되어있는 text, csv, binary 형식의 데이터를 RDS에서 직접 임포트하는 것이 가능합니다.