온라인바카라 Getting Started

https://www.youtube.com/watch?v=NH6WoJHN4UA

해당 동영상은 Neo4j 의 레퍼런스 영상이다.Node 는 Noun(명사)가 되고Relationship 은 Verb(동사) 가 된다. 정리하면 아래와 같다.

Vertex(Node) : 속성을 가지는 엔터티

Arc(Edge) : 노드 사이의 선(연결 link), 방향성(가리키는 방향)을 가질 수 있음.

Property : Node나 Edge에 할당된 값, 이름과 값으로 구성됨

A Vertex represents a "thing"

예를 들어 영화, 사람이 Vertex 가 된다.엽기적인그녀 라는 영화가 있고, 전지현 이라는 사람이 있다면, 영화도 thing 가 되고 사람도 thing 가 된다. 둘다 thing 이면서 Node 인 것이다.

Edges are labeled relationships Edges have direction.

Edge 는 관계를 나타내며 방향이 있다. 양방향일 수도 있다. 동사이면서 행위를 나타낼수도 있고, 소속을 나타낼수도 있고 다양하게 정의가 가능하다.

온라인바카라 에서의 Data Model

Document는 VelocyPack 라고 불리는 바이너리 포맷으로 저장되는데, JSON 과 거의 유사하다.Document는Collection안에 그룹화 된다. 만약, RDBMS에 익숙하다면, 테이블과Document를 비교하는 것이 적합할 것이다. 전통적인 RDMBS 와의 차이는, 테이블에는 정의된 컬럼에 데이터를 넣는다. 스키마라고도 부른다.온라인바카라에는 스키마가 없기 때문에Document를 정의할 필요는 없다. 모든Document는 완전히 다른 구조를 가질 수 있으며, 단일Collection온라인바카라 다른Document와 함께 저장될 수 있다.Collection에는 두가지 타입이 있는데,Document Collection과Edge Collection이다.Edge Collection에는Document도 저장하지만,Document사이의 관계를 만드는 두가지 특별한 속성,_from,_to이 포함되어 있다.

... 라고 한다. 역시 글로 설명을 하기가 참어렵다. 휴...

온라인바카라 설치

이 글을 읽는 사람이 거의 없겠지만,설치 과정은 삽질을 많이 했습니다.설치 과정은 그냥 패스하셔도 됩니다. 온라인바카라 공식 사이트를 참고하세요~

CentOS 6.X

필자는 Cent 6 버전온라인바카라 설치하였다. (사실 7.X 버전온라인바카라 테스트를 하는게 좋을 것 같다.)

cd /etc/yum.repos.d/

curl -OL https://download.온라인바카라.com/온라인바카라33/CentOS_6/온라인바카라.repo yum -y install 온라인바카라3-3.3.4

CentOS 온라인바카라의 설치에 대해서는 아래 링크를 참고하자.

https://www.온라인바카라.com/download-major/centos/

설치를 완료하면 /etc/init.d/ 디렉토리에 온라인바카라3 실행 명령어로 서버를 시작할 수 있다.

/etc/init.d/온라인바카라3 start

or

service 온라인바카라3 start

설치 후에, 포트 확인을 해보자.

netstat -tnlp

8529 포트가 생겼다면 정상적으로 실행된 것이겠지? 맞다.8529포트가 실행되었으니 리눅스 서버온라인바카라 아래와 같이 Curl 때리니깐 정상적으로 Response 가 온다.

curlhttp://127.0.0.1:8529

근데 외부온라인바카라 접근할려니깐 안되더라. 방화벽을 열어야 하겠다.

# 포트 설정, 추가

vi /etc/sysconfig/iptables

-A INPUT -P tcp -m tcp --dport 8529 -j ACCEPT

# iptables 재시작

service iptables restart

근데, 나는 포트 오픈을 했는데도 접속이 안된다. netstat 로 확인해보니온라인바카라 는 127.0.0.1 로 되어있다. 내가 아주 빠르게 생각해낸 방법은 두가지인데

nginx 온라인바카라 Reverse Proxy 를 적용해서 포트 전환을 시켜준다.

아니면 온라인바카라 컨피그 설정에서 바꿔준다

일단, 둘다 검증되지 않은 방법이지만 두번째 방법을 사용해서 /etc/온라인바카라3 에 있는 arangod.conf 파일에서 endpoint 를 변경한다.

endpoint = tcp://0.0.0.1:8529

적용하면 외부온라인바카라http://119.205.비밀.비밀:8529로 접속하니 온라인바카라 콘솔 화면으로 접속된다. 하지만, 아직 내가 만든 계정이 없으므로 접속할 수는 없다.

DB 생성 및 계정 생성

루트 계정이 있을텐데, 가이드온라인바카라는 패스워드가 empty 라고 하는데 empty가 뭔지 모르겟다. 영어 해석이 안된다.

초기 루트 비번이 뭐냐???

뭔가 설정이 잘못된 것인지 접속이 안된다. 참고로, 접속이 안된다는 의미는 온라인바카라 쉘 에 root 계정으로 접속이 안된다는 의미다. 물론, 쉘 뿐만 아니라 웹UI화면에서도 로그인이 안된다. 일단, 편법이지만 온라인바카라 를 권한 없이 접속할 수 있도록 띄울수 있다.

service 온라인바카라3 stop

#arangod.conf 파일온라인바카라 authentication 을 false 로 설정하자.

/usr/sbin/arangod --server.authentication false

그리고 쉘에 접속을 해보자

arangosh

이제 된다. 나이스!! 이렇게 접속하면 루트 비번을 바꿀수 있다.

require("@온라인바카라/users").replace("root", "my-changed-password");

exit service 온라인바카라3 restart

어쨋든 루트의 계정 비번이 변경이 잘 되었다. 이제 변경된 Root 비번으로 콘솔 화면온라인바카라도 접속이 잘 된다! 가즈아!

Ubuntu 온라인바카라의 설치

참고만 하자. 낮은 버전으로 설치가 되었다.

wget https://www.온라인바카라.com/repositories/온라인바카라2/xUbuntu_14.04/Release.key

sudo apt-key add Release.key

sudo apt-add-repository 'deb https://www.온라인바카라.com/repositories/온라인바카라2/xUbuntu_14.04/ /'

sudo apt-온라인바카라 update

sudo apt-get install 온라인바카라

도커 이미지로 설치

아마 (사람들이 말하는)가장 심플한 방법일 것이다. 하지만 나는 도커가 아직 너무 어려운것 같다. 설정도 이해 안되고, 전반적으로 좀 짜증나는거 같다. 뭐 좋기는 한데.. 아직 익숙하지는 않다.

일단 도커를 설치하자. 아래 방법은 설치 스크립트를 사용하는 설치하는 방법이다. 다른 방법은 난 잘 모른다.

curl -fsSL https://온라인바카라.docker.com/ | sudo sh

그리고 아래 명령어를 실행하자.

docker run -p 8529:8529 -e ARANGO_ROOT_PASSWORD=1234 온라인바카라/온라인바카라:3.3.5

여기서 정말 중요한 것은 포트 연결이다. 8529:8529 이 부분이 로커로스트의 포트와, 도커 컨테이너와의 포트를 연결해준다. 매우 중요하다. 또한 기본 패스워드도 설정할 수 있다. 아까 CentOS 온라인바카라는 비번을 몰라서 쌩쑈를 했지만, 도커로 설치할때는 저렇게 비번을 초기화하면서 셋팅할 수 있다. 참고로 도커로 실행했을 때는 도커 컨테이너로 접속해서 작업이 필요할 수 있다.

docker exec -it 컨테이너id /bin/bash//도커 컨테이너 접속

root@컨테이너ID:/#// 접속하면 이렇게 나온다

docker restart 컨테이너ID// 도커를 재시작할수도 있다. (로컬호스트온라인바카라)

테스트 데이터 입력

웹UI 온라인바카라 데이터 입력해보기

Collection 은 단순하게 테이블과 유사하다고 생각하면 된다. Type 은 Document 와 Edge 가 있다. Document 는 JSON 형태의 데이터를 저장하는 NO-SQL Collection 이다. Collection 이 생성이 되었다. 이제 쿼리를 작성해보자. 좌측 쿼리 메뉴를 클릭하고 아래와 같이 작성한 다음에, Explain 버튼을 클릭하자. 참고로 AQL 구문이라는 온라인바카라에서만 사용할 수 있는 쿼리문이다. coffee 라는 콜렉션을 만들고 아래와 같이 AQL 구문으로 데이터를 입력해보자.

INSERT {name: "모카", price: 1200} INTO coffee

AQL 구문에 대한 가이드는 레퍼런스를 참고하자. 필자는 AQL 구문이 매우 어색하기 때문에 나중에 공부하기로 했다.

영화배우, 영화, 영상 데이터를 만들어보자.

위온라인바카라 설명한 Graph 개념을 한번 더 생각해보자.

Vertex(Node) : 속성을 가지는 엔터티

Arc(Edge) : 노드 사이의 선(연결 link), 방향성(가리키는 방향)을 가질 수 있음.

Property : Node나 Edge에 할당된 값, 이름과 값으로 구성됨

영화배우 또는 영화, 영상 등은 Node 가 된다. 온라인바카라 에서는 Document 타입의 콜렉션이 되는 것이다. 그리고 "영화배우가 어떤 영화에 출연했다" 라는 관계를 나타내는 것이 바로Edge 라고 하는데 온라인바카라 에서는 Edge 타입의 콜렉션이 된다. actors, movies 라는 document 타입의 콜렉션을 생성한다. 그리고 actedin 이라는 edge 를 생성한다.actors Document에 송강호 와 임시완 이라는 데이터를 만들고, movies 에는 변호인이라는 데이터를 만든다. 그 다음에 송강호, 임시완을 변호인를 가리키도록 edge 에 데이터를 넣는다.이런식으로 영화 배우와 영화, 그리고 추가로 각 영화들의 영상 데이터를 입력해서 넣어봤다.

Spring Data 온라인바카라 - Select

디펜던시

먼저 Gradle 디펜던시를 추가한다.

compile('com.온라인바카라:온라인바카라-spring-data:2.0.3')

Config 설정

Property 와 Config 설정을 추가 한다.

import com.온라인바카라.온라인바카라;

import com.온라인바카라.springframework.annotation.EnableArangoRepositories;

import com.온라인바카라.springframework.config.AbstractArangoConfiguration;

import org.springframework.context.annotation.Configuration;

@Configuration

@EnableArangoRepositories(basePackages = { "spring.data.온라인바카라" })

public class ArangoConfiguration extends AbstractArangoConfiguration {

@Override

public 온라인바카라.Builder arango() {

return new 온라인바카라.Builder();

}

@Override

public String database() {

// Name of the database to be used

return "Cafe";

}

}

온라인바카라.host=119.205.***.***

온라인바카라.port=8529

온라인바카라.user=root

온라인바카라.password=****

필자는 아래와 같이 작성하였다.참고로, property 파일에 작성하는게 더 깔끔하지만, 필자는 테스트 소스라서 아래와 같이 간단하게 연동한다.

@Configuration

@EnableArangoRepositories(basePackages = { "spring.data.온라인바카라.entity" })

public class ArangoConfiguration extends AbstractArangoConfiguration {

@Override

public 온라인바카라.Builder arango() {

온라인바카라.Builder arango = new 온라인바카라.Builder()

.host("***.205.***.42")

.port(8529)

.user("root")

.password("$$$$$$$");

return arango;

}

@Override

public String database() {

// Name of the database to be used

return "Cafe";

}

}

Entity 와 Repository 선언

Spring 온라인바카라 먼저 @Document 어노테이션이 선언된 Actors 클래스를 만들자.

@Document("actors")

public class Actors {

@Id

private String id;

private String name;

public String 온라인바카라Name() {

return name;

}

@Relations(edges = Actedin.class)

private Collection<Movies movies;

public Collection<Movies 온라인바카라Movies() {

return movies;

}

}

@Edge("actedin")

public class Actedin {

@From

private Actors actor;

@To

private Movies movies;

public Actedin(final Actors actors, final Movies movies){

super();

this.actor = actors;

this.movies = movies;

}

}

@Document("movies")

public class Movies {

private String name;

public String 온라인바카라Name() {

return name;

}

}

온라인바카라-spring-data 에서는 ArangoRepository 를 제공한다. 해당 Repository 는 PagingAndSortingRepository 와 QueryByExampleExecutor 를 상속받는다. 다들 아시겠지만, PagingAndSortingRepository 는 CrudRepository 를 상속받는다.

ArangoRepository 를 사용하면 CRUD 를 심플하게 구현할 수 있다.

import com.온라인바카라.springframework.repository.ArangoRepository;

import java.util.Optional;

public interface ActorsRepository extends ArangoRepository<Actors {

Optional<Actors findByName(String name);

Iterable<Actors findByMoviesName(String name);

}

findByName 는 이름으로 조회한다.

findByMoviesName 는 Edge 를 참고하여 영화 리스트를 조회한다.

findBy**** 등으로 선언하여 조회할 수 있고 Order , Between 등 도 구현할 수 있다. Spring Data 를 다들 잘 안다는 가정하에 이정도로 설명하고 패스한다. 아래와 같이 Between 구문은 아래와 같이 구현하면 된다.

public interface CoffeeRepository extends ArangoRepository<Coffee { Iterable<Coffee findByChildsAgeBetween(int lowerBound, int upperBound); }

리스트 조회 샘플 테스트

모든 영화 배우를 조회해보자. Spring Data 온라인바카라 에서 제공하는 ArangoRepository는 PagingAndSortingRepository 를 상속받기 때문에, paging 기능도 제공할 것이다.

@온라인바카라Mapping("/actors")

public Page<Actors list(Pageable pageable) {

Page<Actors actors = actorsRepository.findAll(pageable);

return actors;

}

http://localhost:8080/actors?page=0&size=5

파라미터로 page는 해당 페이지, size 는 페이지의 사이즈 값을 넘겨주면 된다. 리턴 값은 Page 로 구현하면 된다. 참고로, ActorsRepository 를 선언하지 않았더라도 SimpleArangoRepository를 바로 사용해서 아래와 같이 구현할 수도 있다.

@온라인바카라Mapping("/actors") public Page<Actors list(Pageable pageable) {

Page<Actors actors = (new SimpleArangoRepository(arangoOperations, Actors.class).findAll(pageable));

return actors;

}

이번에는 특정 영화에 출연했던 배우를 모두 조회해보자. findByMoviesName 메소드를 활용한다.

Repository 에 아래와 같이 메소드를 선언이 되어있다.

Iterable<Actors findByMoviesName(String name);

@온라인바카라Mapping("/actors") public Collection<Actors listActorsByMovie(@RequestParam(name="movie") String movieName) {

return StreamSupport.stream(actorsRepository.findByMoviesName(movieName).spliterator(), true) .collect(Collectors.toList()); }

반대로 특정 배우가 출연했던 영화를 모두 조회해보자. 임시완배우가 출연한 영화는 아래와 같다.

@온라인바카라Mapping("/movies") public Collection<Movies listByActedin(@RequestParam(name="name") String name) { return actorsRepository.findByName("임시완").온라인바카라().온라인바카라Movies(); }

간단하게 다양한 조건온라인바카라 테스트를 해봤다. 근데, 뭔가 아쉽다. 관계형 조회를 조금 더 복잡하게 해보자.

임시완이 출연한 영화들의 영상들을 조회하고 싶다면, 어떻게 할까? 아래와 같은 구조이다.

배우(임시완) --- 영화 <--- 영상

일단 영상 클래스(Document)와 영상과영화를 연결해주는 Edge 를 선언한다.

@Document("videos") public class Videos { private String name; public String 온라인바카라Name() { return name; } @Relations(edges = VideoGroup.class) //중요!! 영화,영상 의 Edge 연결한다. private Collection<Movies movies; }

@Edge("videoGroup") public class VideoGroup { @Id private String id; @From private Videos videos; @To private Movies movies; public VideoGroup(final Videos videos, final Movies movies){ super(); this.videos = videos; this.movies = movies; } }

public interface VideosRepository extends ArangoRepository<Videos { Iterable<Videos findByMoviesName(String name); //영화 이름으로 영상을 찾는다. }

검색 방법은 일단 임시완이 출연한 영화를 먼저 검색하고, 영화를 기준으로 해당 영화에 포함되어있는 영상을 찾으면 될까?? 맞는 방법인지는 모르겠지만, 이렇게 해보자. 참고로 Stream 이 중복으로 들어가서 깔끔하지가 않다.

Collection<Videos videos = new ArrayList<(); actorsRepository.findByName(actorName).온라인바카라().온라인바카라Movies().stream().forEach(ar - { StreamSupport.stream(videosRepository.findByMoviesName(ar.온라인바카라Name()).spliterator(), true).forEach(az - { videos.add(az); }); }); return videos;

Spring Data 온라인바카라 - Insert, Update

생략... 글이 너무 길어져서 일단 생략한다. 일반적인 Spring Data 와 거의 유사하기 때문에 굳이 설명을 안해도 개발자 대부분 잘 알것이다.

업계온라인바카라 사용하는 Graph DB

현재 가장 많이 사용중인 GraphDB는 Neo4j 이고 온라인바카라, OrientDB 등 다양한 솔루션이 유료 또는 오픈소스로 사용 중이다. 근데, 이런 GraphDB 들 간에 사용하는 용어가 조금씩 다르다. 또한, 기능도 완전히 같지는 않다. 참고로 이런 이유로 인해서 미들웨어 단에 적용할 수 있는 인터페이스를 제공해주는 라이브러리도 있다. 이런 인터페이스 들은, GraphDB 를 바꿔야할 상황이 생길 경우에 적합할 것이다.

https://github.com/tinkerpop/blueprints

참고로 그래프DB 랭킹은 2018년 4월 기준으로 아래와 같다. db-engines.com 이라는 사이트를 참고하였다. 참고로 Neo4j가 압도적인 1등이다.

1.Neo4j

2.Microsoft Azure Cosmos DB

3.Datastax Enterprise

4.OrientDB

5.온라인바카라

6.Virtuoso

7.Giraph

8.Amazon Neptune

9.AllegroGraph

10.Stardog

참고로 제일 많이 사용하는 Neo4j 와 Giraph 두 솔루션만 Only Graph Model 이고 나머지는 Multi-Model 이다.

정리

간단하게 Spring 에서 온라인바카라 를 연동하여 테스트를 진행하였다. 생각보다는 너무 재밌게 테스트를 진행했다. RDMBS 에서 복잡하게 Relation 으로 구현해야 하는 요구사항을 GraphDB를 활용한다면 정말 직관적이고 심플하게 구현이 가능할 것 같다. 온라인바카라 역시 문서가 부족하다는 단점이 있지만 생각보다는 매우 괜찮은 오픈소스인 것 같다. 물론 실서비스에서 사용은 안했기 때문에 검증이 되진 않았다. 그냥 느낌이 나쁘진 않다는 의미다. 어쨋든, 나중에 시간이 된다면 AQL 구문을 더 상세하게공부할 예정이다. 이번 글에서는 이정도로 마무리한다. 관련정보는 아래 레퍼런스를 참고하자.

https://github.com/온라인바카라/spring-data