[카테고리:] coding

작성일 작성자 — 댓글 남기기

GraphQL이란?

1. GraphQL이란 무엇인가?

GraphQL은 서버에서 클라이언트에게 데이터를 제공하는 방법 중 하나입니다. REST API를 들어보셨다면, 그와 비슷한 역할을 한다고 보시면 됩니다. 하지만 REST API와 달리 GraphQL은 클라이언트가 원하는 데이터만 정확하게 요청하고 받을 수 있는 쿼리 언어입니다.

왜 GraphQL을 사용하나요?

기존의 REST API는 데이터를 받아올 때 필요한 것보다 더 많은 정보를 가져오거나, 여러 번 요청해야 할 때가 많았습니다. 이 때문에 데이터 전송 효율이 떨어질 수 있죠. GraphQL은 이런 문제를 해결해 필요한 데이터만 효율적으로 받을 수 있도록 해줍니다.

2. GraphQL의 기본 개념

GraphQL의 중요한 개념들을 하나씩 살펴볼게요.

1) 쿼리 (Query)

쿼리는 클라이언트가 서버에서 데이터를 요청할 때 사용하는 언어입니다. 쿼리를 통해 원하는 데이터를 정확하게 요청할 수 있죠. 예를 들어, 사용자 정보 중 이름과 나이만 요청하고 싶을 때 이렇게 쓸 수 있어요:

query {
  user(id: 1) {
    name
    age
  }
}

위의 쿼리에서는 user라는 데이터를 가져오는데, 그 중에서도 name과 age만 요청하고 있습니다. 그러면 서버는 요청한 데이터만 정확하게 반환하게 됩니다.

2) 뮤테이션 (Mutation)

뮤테이션은 데이터를 변경할 때 사용됩니다. 데이터를 추가하거나 수정하거나 삭제하는 등의 작업을 할 때 뮤테이션을 사용합니다.

mutation {
  addUser(name: "John", age: 30) {
    id
    name
  }
}

이 예제에서는 addUser라는 뮤테이션을 통해 새로운 사용자를 추가하고, 그 사용자의 id와 name을 반환받고 있습니다.

3) 스키마 (Schema)

GraphQL의 핵심은 스키마라는 개념입니다. 스키마는 어떤 데이터를 요청할 수 있고, 그 데이터가 어떤 형식인지를 서버가 정의해 둔 설계도 같은 것입니다. 스키마를 통해 클라이언트는 어떤 요청을 할 수 있는지 미리 알 수 있죠.

예를 들어, 스키마에서 user라는 타입이 있고 그 안에 name, age, email 등의 필드가 있다고 정의되어 있으면, 클라이언트는 user 타입에서 해당 필드들만 요청할 수 있습니다.

3. GraphQL과 REST API의 차이점

  • 엔드포인트: REST API에서는 여러 엔드포인트(URL)를 통해 데이터를 요청합니다. 하지만 GraphQL은 하나의 엔드포인트만 사용해 데이터를 요청합니다.
  • 데이터 요청 방식: REST API는 정해진 데이터를 항상 반환하지만, GraphQL은 클라이언트가 원하는 데이터만 정확하게 요청할 수 있습니다. 이로 인해 불필요한 데이터 전송을 줄일 수 있습니다.

4. 간단한 예제

우리가 사용자 정보와 그 사용자가 작성한 게시물 정보를 가져오고 싶다고 해볼게요. REST API에서는 두 번의 요청을 해야 할 수도 있지만, GraphQL에서는 한 번의 요청으로 가능합니다.

query {
  user(id: 1) {
    name
    posts {
      title
    }
  }
}

이렇게 요청하면 서버는 사용자 이름과 그 사용자가 작성한 게시물의 제목들을 반환해 줍니다.

결론

GraphQL은 클라이언트가 필요한 데이터만 요청할 수 있는 효율적인 API입니다. REST API보다 데이터 전송이 최적화되고, 여러 요청을 하나로 통합할 수 있다는 장점이 있습니다.

작성일 작성자 — 댓글 남기기

mongodb 도큐먼트에 ttl 걸기

mongodb 2.2부터 expire 옵션을 쓸 수 있게 되었다.
그래서 일정시간이 지난 후 도큐먼트를 자동으로 삭제할 수 있다.
예를 들어, 네트워크트래픽을 수집해서 시스템을 만들었는데 트래픽데이터를 최근 6개월치만 유지하고 싶을 때
오래된 도큐먼트를 지우는 작업을 따로 하지 않아도 된다.

공식메뉴얼 : http://docs.mongodb.org/manual/tutorial/expire-data/#expire-documents-after-a-certain-number-of-seconds

2가지 방법이 있다.
1. 도큐먼트가 생성된 시각부터 지정된 시간(초)가 지난 후 삭제.
2. 언제 삭제할 지 특정 시각을 도큐먼트에 지정.

지정된 시간이 지난 후 삭제하는 방법을 알아보자.
인덱스를 아래처럼 생성한다.

db.log.events.ensureIndex( { "createdAt": 1 }, { expireAfterSeconds: 3600 } )

 

createdAt 칼럼은 도큐먼트에 들어갈 항목이다.
expireAfterSeconds에서는 도큐먼트가 생성된 후 얼마 지난 후 삭제할 것인지 초단위로 지정한다.

이제 도큐먼트를 생성할 때 createdAt 필드를 추가하면 된다.

db.log.events.insert( {
    "createdAt": new Date(),
    "logEvent": 2,
    "logMessage": "Success!"} )

 

createdAt필드에 지금시각을 지정해주면 된다.
python에서 pymongo를 이용하여 도큐먼트를 생성하는 방법은 아래와 같다.

import datetime
doc['createdAt'] = datetime.datetime.utcnow()