확장 가능한 앱을 위해 GraphQL을 MongoDB와 통합하는 방법 | 엠블로깅

현대적이고 확장 가능한 웹 애플리케이션을 구축하려면 유연성과 응답성이 필요합니다. 이를 달성하는 강력한 조합은 GraphQL과 MongoDB의 통합입니다. GraphQL의 효율적인 쿼리는 MongoDB의 NoSQL 구조를 완벽하게 보완하여 신속한 실시간 데이터 검색과 복잡한 데이터 관계 관리가 필요한 애플리케이션에 이상적인 스택을 만듭니다.

이 가이드에서는 스키마 정의를 위해 Mongoose와 같은 라이브러리를 사용하여 MongoDB와 GraphQL 서버의 통합을 자세히 설명하고 대규모 데이터 세트에 대한 성능 최적화를 탐색합니다. 또한 MongoDB를 기반으로 구축된 확장 가능한 GraphQL API에 대한 중요한 설계 고려 사항에 대해서도 논의할 것입니다.

목차

1. GraphQL 및 MongoDB: 소개
2. MongoDB 및 Mongoose 설정
3. GraphQL 스키마 및 유형 정의
4. GraphQL로 MongoDB 쿼리
5. 변이: 데이터 변경 관리
6. 광범위한 데이터세트에 대한 성능 최적화
7. GraphQL 및 MongoDB 통합 모범 사례
8. 결론

1. GraphQL 및 MongoDB: 소개

GraphQL은 사용자 정의 유형 시스템을 사용하는 API용 쿼리 언어 및 런타임 환경입니다. 데이터를 과도하게 또는 적게 가져오는 결과를 가져올 수 있는 REST API와 달리 GraphQL을 사용하면 클라이언트가 필요한 데이터를 정확하게 지정하여 네트워크 오버헤드를 최소화하고 효율성을 높일 수 있습니다.

NoSQL 데이터베이스인 MongoDB는 유연한 JSON 형식(BSON)으로 데이터를 저장합니다. 수평 확장성으로 인해 대량의 비정형 또는 반정형 데이터에 적합합니다.

MongoDB와 GraphQL을 결합하면 유연한 고성능 데이터 액세스 계층이 생성됩니다. MongoDB의 동적 스키마는 GraphQL을 통한 효율적인 데이터 검색 및 수정을 지원하므로 확장 가능한 애플리케이션을 위한 최고의 선택입니다.

2. MongoDB 및 Mongoose 설정

통합하기 전에 MongoDB와 Mongoose 설정이 필요합니다.

1단계: 종속성 설치

npm 또는 Yarn을 사용하여 필수 패키지를 설치하세요.

npm install express graphql express-graphql mongoose

• Express: 서버 생성
• GraphQL: 핵심 GraphQL 패키지
• Express-GraphQL: GraphQL-Express 미들웨어
• Mongoose: MongoDB 스키마 정의를 위한 ODM(객체 데이터 모델링) 라이브러리

2단계: MongoDB와 Mongoose 연결

Node.js 애플리케이션에서 MongoDB를 Mongoose에 연결합니다.

const mongoose = require('mongoose');

mongoose.connect('mongodb://localhost:27017/yourDB', {
  useNewUrlParser: true,
  useUnifiedTopology: true,
})
  .then(() => console.log('MongoDB connected'))
  .catch((err) => console.log('Error connecting to MongoDB:', err));

mongodb://localhost:27017/yourDB를 MongoDB 연결 문자열로 바꾸는 것을 잊지 마세요.

3. GraphQL 스키마 및 유형 정의

중요한 단계는 MongoDB 컬렉션에 매핑되는 GraphQL 스키마와 유형을 정의하는 것입니다.

1단계: 몽구스 모델 정의

MongoDB 컬렉션을 나타내는 Mongoose 모델 만들기:

npm install express graphql express-graphql mongoose

2단계: GraphQL 유형 정의

GraphQLObjectType:

을 사용하여 해당 GraphQL 유형을 생성합니다.

const mongoose = require('mongoose');

mongoose.connect('mongodb://localhost:27017/yourDB', {
  useNewUrlParser: true,
  useUnifiedTopology: true,
})
  .then(() => console.log('MongoDB connected'))
  .catch((err) => console.log('Error connecting to MongoDB:', err));

3단계: 루트 쿼리 생성

MongoDB를 쿼리하기 위해 RootQuery 및 find()과 같은 Mongoose 메서드를 사용하여 GraphQL에 대한 findById()을 정의합니다.

const mongoose = require('mongoose');

const UserSchema = new mongoose.Schema({
  name: String,
  email: String,
  age: Number,
});

const User = mongoose.model('User', UserSchema);

4. GraphQL로 MongoDB 쿼리

스키마 설정을 통해 MongoDB와 상호 작용하도록 GraphQL 쿼리를 정의할 수 있습니다. 예를 들어 사용자 검색은 다음과 같습니다.

const { GraphQLObjectType, GraphQLString, GraphQLInt } = require('graphql');

const UserType = new GraphQLObjectType({
  name: 'User',
  fields: {
    id: { type: GraphQLString },
    name: { type: GraphQLString },
    email: { type: GraphQLString },
    age: { type: GraphQLInt },
  },
});

모든 사용자를 검색하여 id, name, email 및 age을 표시합니다.

대규모 데이터 세트에 대한 쿼리 최적화

대규모 데이터세트의 경우 성능을 위해서는 페이지 매김과 정렬이 필수적입니다.

페이지 매김 예

const { GraphQLObjectType, GraphQLSchema, GraphQLList } = require('graphql');
const UserType = require('./models/UserType');
const User = require('./models/User');

const RootQuery = new GraphQLObjectType({
  name: 'RootQueryType',
  fields: {
    users: {
      type: new GraphQLList(UserType),
      resolve(parent, args) {
        return User.find();
      },
    },
    user: {
      type: UserType,
      args: { id: { type: GraphQLString } },
      resolve(parent, args) {
        return User.findById(args.id);
      },
    },
  },
});

페이지 매김은 쿼리당 레코드를 제한하고 데이터 페이지 탐색을 허용합니다.

5. 돌연변이: 데이터 변경 관리

GraphQL 돌연변이를 사용하면 MongoDB에서 데이터 수정(생성, 업데이트, 삭제)이 가능합니다.

1단계: 사용자 생성을 위한 변형 정의

query {
  users {
    id
    name
    email
    age
  }
}

2단계: 업데이트 및 삭제에 변형 사용

사용자 업데이트 및 삭제를 위해 유사한 변형을 정의할 수 있습니다.

users: {
  type: new GraphQLList(UserType),
  args: {
    limit: { type: GraphQLInt },
    page: { type: GraphQLInt },
  },
  resolve(parent, args) {
    return User.find()
      .skip(args.page * args.limit)
      .limit(args.limit);
  },
}

6. 광범위한 데이터세트에 대한 성능 최적화

대규모 MongoDB 데이터세트의 경우 다음 최적화를 고려하세요.

1. 인덱싱: 특히 필터 및 정렬에 사용되는 필드의 경우 더 빠른 쿼리를 위한 인덱스 컬렉션입니다. UserSchema.index({ name: 1 });
2. 데이터 투영: 필요한 필드만 검색합니다.
3. 캐싱: 자주 쿼리하는 경우 캐싱(예: Redis)을 사용하세요.
4. N 1 쿼리 문제 방지: 효율적인 조인을 위해 MongoDB의 populate 방법을 사용하세요. User.find().populate('posts').exec();

7. GraphQL 및 MongoDB 통합 모범 사례

• 스키마 디자인: 잘 구성된 스키마를 유지합니다.
• 오류 처리: 강력한 오류 처리를 구현합니다.
• 보안: 인증 및 권한 부여(예: JWT)를 사용합니다.
• 모니터링: 모니터링 도구(예: Apollo Studio)를 사용합니다.

8. 결론

GraphQL을 MongoDB와 통합하면 애플리케이션 성능과 확장성이 크게 향상됩니다. MongoDB의 유연성과 GraphQL의 효율적인 쿼리를 결합하면 복잡한 데이터 관계를 처리할 수 있는 빠르고 강력한 애플리케이션을 구축할 수 있습니다. 모범 사례를 따르고 성능을 최적화하면 대규모 데이터 세트에서도 애플리케이션의 응답성이 유지됩니다.

(FAQ 및 관련 블로그 섹션은 이미 제공된 정보와 대부분 반복되므로 간결성을 위해 생략했습니다.)

위 내용은 확장 가능한 앱을 위해 GraphQL을 MongoDB와 통합하는 방법 | 엠블로깅의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!