3 EF Core Integrations That Work with Couchbase

Couchbase의 새로운 EF 코어 공급자 는 기존에 관계형 데이터베이스에 묶여 있던 강력한 .NET 통합의 문을 열어줍니다. 이 게시물에서는 Identity, GraphQL 및 OData가 모두 Couchbase에서 어떻게 작동하는지 설명합니다.

이 게시물에서는 다음과 같이 안내해 드리겠습니다. 세 가지 고급 EF Core 통합 Couchbase로 성공적으로 테스트했습니다:

1. ASP.NET 핵심 아이덴티티
2. GraphQL(핫 초콜릿을 통한)
3. OData

참고: 이러한 통합 기능은 제한된 테스트를 기반으로 하며 아직 공식적으로 지원되지 않습니다. 마일리지는 다를 수 있지만 지금까지는 많은 가능성을 보여주고 있습니다.

ASP.NET 핵심 아이덴티티

Microsoft.AspNetCore.Identity.EntityFrameworkCore 는 ASP.NET 앱을 위한 플러그 앤 플레이 인증 및 사용자 관리 시스템을 제공합니다.

Couchbase의 EF Core 제공업체가 잘 작동합니다. 한 가지 주의해야 할 점은 적절한 컬렉션이 먼저 존재합니다. (예: AspNetUsers, AspNetRoles 등).

참고: 다음 컬렉션을 미리 만들어야 합니다: AspNetUsers, AspNetRoles, AspNetUserRoles, AspNetUserClaims, AspNetUserLogins, AspNetUserTokens, AspNetRoleClaims.

EF 설정 예시

public class AppDbContext : IdentityDbContext<ApplicationUser>
{
    public AppDbContext(DbContextOptions<AppDbContext> options) : base(options) { }

    protected override void OnModelCreating(ModelBuilder builder)
    {
        base.OnModelCreating(builder);

        builder.Entity<ApplicationUser>().ToCouchbaseCollection(this, "AspNetUsers");
        builder.Entity<IdentityRole>().ToCouchbaseCollection(this, "AspNetRoles");
        builder.Entity<IdentityUserRole<string>>().ToCouchbaseCollection(this, "AspNetUserRoles");
        builder.Entity<IdentityUserClaim<string>>().ToCouchbaseCollection(this, "AspNetUserClaims");
        builder.Entity<IdentityUserLogin<string>>().ToCouchbaseCollection(this, "AspNetUserLogins");
        builder.Entity<IdentityUserToken<string>>().ToCouchbaseCollection(this, "AspNetUserTokens");
        builder.Entity<IdentityRoleClaim<string>>().ToCouchbaseCollection(this, "AspNetRoleClaims");
    }
}

public class ApplicationUser : IdentityUser { }

public 클래스 AppDbContext : IdentityDbContext<애플리케이션 사용자>

{

public AppDbContext(DbContextOptions<AppDbContext> 옵션) : base(옵션) { }

보호됨 오버라이드 void 모델 생성(모델 빌더 빌더)

{

base.모델 생성(빌더);

빌더.엔티티<애플리케이션 사용자>().카우치베이스 컬렉션(이, "AspNetUsers");

빌더.엔티티<신원 역할>().카우치베이스 컬렉션(이, "AspNetRoles");

빌더.엔티티<신원 사용자 역할<문자열>>().카우치베이스 컬렉션(이, "AspNetUserRoles");

빌더.엔티티<신원 사용자 클레임<문자열>>().카우치베이스 컬렉션(이, "AspNetUserClaims");

빌더.엔티티<신원 사용자 로그인<문자열>>().카우치베이스 컬렉션(이, "AspNetUserLogins");

빌더.엔티티<신원 사용자 토큰<문자열>>().카우치베이스 컬렉션(이, "AspNetUserTokens");

빌더.엔티티<신원 역할 클레임<문자열>>().카우치베이스 컬렉션(이, "AspNetRoleClaims");

}

public 클래스 애플리케이션 사용자 : IdentityUser { }

MVC 인증 예제

다음은 등록, 로그인, 로그아웃 및 사용자 지정 역할이 있는 ASP.NET Core MVC 컨트롤러입니다:

public class AuthController : Controller
{
    private readonly UserManager<ApplicationUser> _userManager;
    private readonly SignInManager<ApplicationUser> _signInManager;
    private readonly RoleManager<IdentityRole> _roleManager;

    public AuthController(UserManager<ApplicationUser> userManager, SignInManager<ApplicationUser> signInManager, RoleManager<IdentityRole> roleManager)
    {
        _userManager = userManager;
        _signInManager = signInManager;
        _roleManager = roleManager;
    }

    public IActionResult Register() => View();

    [HttpPost]
    public async Task<IActionResult> Register(RegisterModel model)
    {
        if (!ModelState.IsValid) return View(model);

        var user = new ApplicationUser { UserName = model.Email, Email = model.Email };
        var result = await _userManager.CreateAsync(user, model.Password);
        if (result.Succeeded)
        {
            var roleName = "CustomRole";
            if (!await _roleManager.RoleExistsAsync(roleName))
                await _roleManager.CreateAsync(new IdentityRole(roleName));

            await _userManager.AddToRoleAsync(user, roleName);
            await _signInManager.SignInAsync(user, isPersistent: false);
            return RedirectToAction("Index", "Home");
        }

        foreach (var error in result.Errors) ModelState.AddModelError("", error.Description);
        return View(model);
    }

    public IActionResult Login() => View();

    [HttpPost]
    public async Task<IActionResult> Login(LoginModel model)
    {
        if (!ModelState.IsValid) return View(model);

        var result = await _signInManager.PasswordSignInAsync(model.Email, model.Password, false, false);
        if (result.Succeeded)
            return RedirectToAction("Index", "Home");

        ModelState.AddModelError("", "Invalid login attempt.");
        return View(model);
    }

    public async Task<IActionResult> Logout()
    {
        await _signInManager.SignOutAsync();
        return RedirectToAction("Index", "Home");
    }
}

public 클래스 AuthController : 컨트롤러

{

비공개 읽기 전용 사용자 관리자<애플리케이션 사용자> _userManager;

비공개 읽기 전용 로그인 관리자<애플리케이션 사용자> _signInManager;

비공개 읽기 전용 RoleManager<신원 역할> _roleManager;

public AuthController(사용자 관리자<애플리케이션 사용자> userManager, 로그인 관리자<애플리케이션 사용자> 로그인 관리자, RoleManager<신원 역할> 역할 관리자)

{

_userManager = userManager;

_signInManager = 로그인 관리자;

_roleManager = 역할 관리자;

}

public IActionResult 등록하기() => 보기();

[HttpPost]

public 비동기 작업<IActionResult> 등록하기(등록 모델 모델)

{

만약 (!모델 상태.IsValid) 반환 보기(모델);

var 사용자 = new 애플리케이션 사용자 { 사용자 이름 = 모델.이메일, 이메일 = 모델.이메일 };

var 결과 = 기다림 _userManager.CreateAsync(사용자, 모델.비밀번호);

만약 (결과.성공)

{

var 역할 이름 = "CustomRole";

만약 (!기다림 _roleManager.RoleExistsAsync(역할 이름))

기다림 _roleManager.CreateAsync(new 신원 역할(역할 이름));

기다림 _userManager.추가 역할 동기화(사용자, 역할 이름);

기다림 _signInManager.SignInAsync(사용자, isPersistent: false);

반환 RedirectToAction("색인", "홈");

}

foreach (var 오류 in 결과.오류) 모델 상태.추가 모델 오류("", 오류.설명);

반환 보기(모델);

}

public IActionResult 로그인() => 보기();

[HttpPost]

public 비동기 작업<IActionResult> 로그인(로그인 모델 모델)

{

만약 (!모델 상태.IsValid) 반환 보기(모델);

var 결과 = 기다림 _signInManager.PasswordSignInAsync(모델.이메일, 모델.비밀번호, false, false);

만약 (결과.성공)

반환 RedirectToAction("색인", "홈");

모델 상태.추가 모델 오류("", "잘못된 로그인 시도입니다.");

반환 보기(모델);

}

public 비동기 작업<IActionResult> 로그아웃()

{

기다림 _signInManager.SignOutAsync();

반환 RedirectToAction("색인", "홈");

}

데이터는 표준 ID 구조를 따르며, Couchbase 문서에 저장됩니다. 예를 들어 AspNetUser 컬렉션:

핫 초콜릿을 사용한 그래프QL

핫 초콜릿 는 널리 사용되는 .NET용 GraphQL 서버입니다. 이 서버는 공급자의 LINQ 기능(Couchbase가 제공하는 기능)을 활용하여 EF Core와 통합할 수 있습니다. 즉, GraphQL 쿼리가 LINQ로 변환된 다음 Couchbase SQL++로 변환됩니다.

설정

public class WidgetQuery
{
    [UseFiltering]
    [UseSorting]
    public IQueryable<Widget> GetWidgets([Service] WidgetDbContext dbContext)
        => dbContext.Widgets;
}

// Program.cs:

builder.Services
    .AddGraphQLServer()
    .AddQueryType<WidgetQuery>()
    .AddFiltering()
    .AddSorting()
    .AddProjections();

app.MapGraphQL();

public 클래스 위젯 쿼리

{

[사용필터링]

[사용소팅]

public IQueryable<위젯> GetWidgets([서비스] 위젯Db컨텍스트 dbContext)

=> dbContext.위젯;

}

// Program.cs:

빌더.서비스

.AddGraphQLServer()

.추가 쿼리 유형<위젯 쿼리>()

.필터링 추가()

.추가 정렬()

.프로젝션 추가();

앱.MapGraphQL();

사용 예

다음으로 이동 /graphql 을 클릭합니다(웹 인터페이스가 나타납니다).

다음과 같은 쿼리를 시도해 보세요:

query {
  widgets(where: { name: { contains: "foo" } }, order: { createdDt: DESC }) {
    id
    name
    price
    numInStock
    createdDt
  }
}

쿼리 {

위젯(어디: { 이름: { 포함: "foo" } }, 주문: { createdDt: DESC }) {

이름

가격

눔인스톡

createdDt

}

다음과 같은 결과가 반환됩니다:

{
  "data": {
    "widgets": [
      {
        "id": "b5c494fe-135f-4f01-bf12-6e4ad1eee829",
        "name": "foobar",
        "price": 1.99,
        "numInStock": 50,
        "createdDt": "2025-06-18T18:11:19.149Z"
      }
    ]
  }
}

{

"데이터": {

"위젯": [

{

"id": "b5c494fe-135f-4f01-bf12-6e4ad1eee829",

"name": "foobar",

"가격": 1.99,

"numInStock": 50,

"createdDt": "2025-06-18T18:11:19.149Z"

}

]

}

팁

- GraphQL 쿼리는 GSI 인덱스와 일치해야 합니다(내부적으로는 SQL++ 쿼리일 뿐입니다).
- 다음을 사용할 수 있습니다. 표지 인덱스 및 기타 SQL++ 인덱스를 사용하여 성능을 개선합니다.

OData

Microsoft.AspNetCore.OData 는 EF Core 데이터를 OData 엔드포인트로 노출하므로 Excel, Power BI, Tableau와 같은 도구를 Couchbase에 쉽게 연결할 수 있습니다.

프로그램.cs 샘플

builder.Services.AddControllersWithViews()
  .AddOData(opt =>
  {
    var odataBuilder = new ODataConventionModelBuilder();
    odataBuilder.EntitySet<Widget>("Widgets");

    opt.AddRouteComponents("odata", odataBuilder.GetEdmModel())
      .Filter()
      .OrderBy()
      .Select()
      .Expand()
      .Count()
      .SetMaxTop(100);
  });

빌더.서비스.추가 컨트롤러 위드 뷰()

.데이터 추가(opt =>

{

var 데이터 빌더 = new ODataConvention모델빌더();

데이터 빌더.엔티티 세트<위젯>("위젯");

opt.추가 경로 구성 요소("odata", 데이터 빌더.GetEdmModel())

.필터()

.주문 기준()

.선택()

.확장()

.Count()

.SetMaxTop(100);

});

컨트롤러

[HttpGet("/odata/Widgets")]
[EnableQuery]
public IQueryable<Widget> GetOData() => _context.Widgets;

[HttpGet("/데이터/위젯")]

[EnableQuery]

public IQueryable<위젯> GetOData() => _context.위젯;

OData 쿼리 예제

- https://localhost:7037/odata/Widgets?$filter=price gt 1&$orderby=name
- https://localhost:7037/odata/Widgets?$select=name,price&$top=10

참고: EF Core LINQ 쿼리를 SQL++로 변환할 수 있는지, 필터링/소팅된 필드가 Couchbase에서 인덱싱되는지 확인하세요.

마무리

이러한 모든 통합은 EF Core에 의해 지원되며, 이제 Couchbase 지원을 통해 코드에서 이를 최대한 활용할 수 있습니다. 안전한 웹 애플리케이션을 구축하든, GraphQL API를 구축하든, BI 도구와 통합하든, EF Core와 Couchbase의 조합을 통해 모든 것이 가능합니다.

더 자세히 알고 싶으신가요? 다음에 어떤 통합 기능을 살펴보고 싶은지 알려주세요!

매튜 그로브스

이 문서 공유하기

Platform

Self-Managed

Services

Capabilities

Why Couchbase?

Migrate to Capella

By Use Case

By Industry

By Application Need

Popular Docs

By Developer Role

Quickstart

Resource Center

About

Partnerships

Our Services

Partners: Register a Deal

Ready to register a deal with Couchbase?

Marriott

카우치베이스와 연동되는 3가지 EF 핵심 통합 기능

ASP.NET 핵심 아이덴티티

EF 설정 예시

MVC 인증 예제

핫 초콜릿을 사용한 그래프QL

설정

사용 예

팁

OData

프로그램.cs 샘플

컨트롤러

OData 쿼리 예제

마무리

받은 편지함에서 카우치베이스 블로그 업데이트 받기

작성자

게시자 매튜 그로브스

댓글 남기기 응답 취소

카우치베이스 카펠라를 시작할 준비가 되셨나요?

구축 시작

카펠라 무료 사용

연락하기