{"id":17313,"date":"2025-07-16T10:17:31","date_gmt":"2025-07-16T17:17:31","guid":{"rendered":"https:\/\/www.couchbase.com\/blog\/?p=17313"},"modified":"2025-07-25T12:06:01","modified_gmt":"2025-07-25T19:06:01","slug":"ef-core-couchbase-integrations","status":"publish","type":"post","link":"https:\/\/www.couchbase.com\/blog\/ko\/ef-core-couchbase-integrations\/","title":{"rendered":"\uce74\uc6b0\uce58\ubca0\uc774\uc2a4\uc640 \uc5f0\ub3d9\ub418\ub294 3\uac00\uc9c0 EF \ud575\uc2ec \ud1b5\ud569 \uae30\ub2a5"},"content":{"rendered":"

Couchbase\uc758 \uc0c8\ub85c\uc6b4 EF \ucf54\uc5b4 \uacf5\uae09\uc790<\/a> \ub294 \uae30\uc874\uc5d0 \uad00\uacc4\ud615 \ub370\uc774\ud130\ubca0\uc774\uc2a4\uc5d0 \ubb36\uc5ec \uc788\ub358 \uac15\ub825\ud55c .NET \ud1b5\ud569\uc758 \ubb38\uc744 \uc5f4\uc5b4\uc90d\ub2c8\ub2e4. \uc774 \uac8c\uc2dc\ubb3c\uc5d0\uc11c\ub294 Identity, GraphQL \ubc0f OData\uac00 \ubaa8\ub450 Couchbase\uc5d0\uc11c \uc5b4\ub5bb\uac8c \uc791\ub3d9\ud558\ub294\uc9c0 \uc124\uba85\ud569\ub2c8\ub2e4.<\/p>\n

\uc774 \uac8c\uc2dc\ubb3c\uc5d0\uc11c\ub294 \ub2e4\uc74c\uacfc \uac19\uc774 \uc548\ub0b4\ud574 \ub4dc\ub9ac\uaca0\uc2b5\ub2c8\ub2e4. \uc138 \uac00\uc9c0 \uace0\uae09 EF Core \ud1b5\ud569<\/b> Couchbase\ub85c \uc131\uacf5\uc801\uc73c\ub85c \ud14c\uc2a4\ud2b8\ud588\uc2b5\ub2c8\ub2e4:<\/p>\n

    \n
  1. \n
      \n
    1. ASP.NET \ud575\uc2ec \uc544\uc774\ub374\ud2f0\ud2f0<\/b><\/li>\n
    2. GraphQL(\ud56b \ucd08\ucf5c\ub9bf\uc744 \ud1b5\ud55c)<\/b><\/li>\n
    3. OData<\/b><\/li>\n<\/ol>\n<\/li>\n<\/ol>\n

      \ucc38\uace0:\u00a0<\/strong>\uc774\ub7ec\ud55c \ud1b5\ud569 \uae30\ub2a5\uc740 \uc81c\ud55c\ub41c \ud14c\uc2a4\ud2b8\ub97c \uae30\ubc18\uc73c\ub85c \ud558\uba70 \uc544\uc9c1 \uacf5\uc2dd\uc801\uc73c\ub85c \uc9c0\uc6d0\ub418\uc9c0 \uc54a\uc2b5\ub2c8\ub2e4. \ub9c8\uc77c\ub9ac\uc9c0\ub294 \ub2e4\ub97c \uc218 \uc788\uc9c0\ub9cc \uc9c0\uae08\uae4c\uc9c0\ub294 \ub9ce\uc740 \uac00\ub2a5\uc131\uc744 \ubcf4\uc5ec\uc8fc\uace0 \uc788\uc2b5\ub2c8\ub2e4.<\/p>\n

      ASP.NET \ud575\uc2ec \uc544\uc774\ub374\ud2f0\ud2f0<\/h2>\n

      Microsoft.AspNetCore.Identity.EntityFrameworkCore<\/a><\/em> \ub294 ASP.NET \uc571\uc744 \uc704\ud55c \ud50c\ub7ec\uadf8 \uc564 \ud50c\ub808\uc774 \uc778\uc99d \ubc0f \uc0ac\uc6a9\uc790 \uad00\ub9ac \uc2dc\uc2a4\ud15c\uc744 \uc81c\uacf5\ud569\ub2c8\ub2e4.<\/p>\n

      Couchbase\uc758 EF Core \uc81c\uacf5\uc5c5\uccb4\uac00 \uc798 \uc791\ub3d9\ud569\ub2c8\ub2e4. \ud55c \uac00\uc9c0 \uc8fc\uc758\ud574\uc57c \ud560 \uc810\uc740 \uc801\uc808\ud55c \uceec\ub809\uc158\uc774 \uba3c\uc800 \uc874\uc7ac\ud569\ub2c8\ub2e4.<\/strong> (\uc608: AspNetUsers, AspNetRoles \ub4f1).<\/p>\n

      \ucc38\uace0:\u00a0<\/strong>\ub2e4\uc74c \uceec\ub809\uc158\uc744 \ubbf8\ub9ac \ub9cc\ub4e4\uc5b4\uc57c \ud569\ub2c8\ub2e4: AspNetUsers, AspNetRoles, AspNetUserRoles, AspNetUserClaims, AspNetUserLogins, AspNetUserTokens, AspNetRoleClaims.<\/p>\n

      EF \uc124\uc815 \uc608\uc2dc<\/h3>\n
      public \ud074\ub798\uc2a4 AppDbContext : IdentityDbContext\r\n{\r\n    public AppDbContext(DbContextOptions options) : base(options) { }\r\n\r\n    \ubcf4\ud638\ub41c \uc624\ubc84\ub77c\uc774\ub4dc void OnModelCreating(\ubaa8\ub378 \ube4c\ub354 \ube4c\ub354)\r\n    {\r\n        base.OnModelCreating(builder);\r\n\r\n        builder.Entity().ToCouchbaseCollection(this, \"AspNetUsers\");\r\n        builder.Entity().ToCouchbaseCollection(this, \"AspNetRoles\");\r\n        builder.Entity<IdentityUserRole>().ToCouchbaseCollection(this, \"AspNetUserRoles\");\r\n        builder.Entity<IdentityUserClaim>().ToCouchbaseCollection(this, \"AspNetUserClaims\");\r\n        builder.Entity<IdentityUserLogin>().ToCouchbaseCollection(this, \"AspNetUserLogins\");\r\n        builder.Entity<IdentityUserToken>().ToCouchbaseCollection(this, \"AspNetUserTokens\");\r\n        builder.Entity<IdentityRoleClaim>().ToCouchbaseCollection(this, \"AspNetRoleClaims\");\r\n    }\r\n}\r\n\r\npublic class ApplicationUser : IdentityUser { }<\/pre>\n
      MVC \uc778\uc99d \uc608\uc81c<\/h3>\n
      \ub2e4\uc74c\uc740 \ub4f1\ub85d, \ub85c\uadf8\uc778, \ub85c\uadf8\uc544\uc6c3 \ubc0f \uc0ac\uc6a9\uc790 \uc9c0\uc815 \uc5ed\ud560\uc774 \uc788\ub294 ASP.NET Core MVC \ucee8\ud2b8\ub864\ub7ec\uc785\ub2c8\ub2e4:<\/p>\n
      \uacf5\uc6a9 \ud074\ub798\uc2a4 AuthController : \ucee8\ud2b8\ub864\ub7ec\r\n{\r\n    private \uc77d\uae30 \uc804\uc6a9 \uc0ac\uc6a9\uc790 \uad00\ub9ac\uc790  _\uc0ac\uc6a9\uc790 \uad00\ub9ac\uc790;\r\n    private readonly SignInManager _signInManager;\r\n    private readonly RoleManager _roleManager;\r\n\r\n    public AuthController(UserManager userManager, SignInManager signInManager, RoleManager roleManager)\r\n    {\r\n        _\uc0ac\uc6a9\uc790 \uad00\ub9ac\uc790 = \uc0ac\uc6a9\uc790 \uad00\ub9ac\uc790;\r\n        _signInManager = signInManager;\r\n        _roleManager = roleManager;\r\n    }\r\n\r\n    public IActionResult Register() => View();\r\n\r\n    [HttpPost]\r\n    public async Task Register(RegisterModel model)\r\n    {\r\n        if (!ModelState.IsValid) return View(model);\r\n\r\n        var user = new ApplicationUser { \uc0ac\uc6a9\uc790 \uc774\ub984 = \ubaa8\ub378.\uc774\uba54\uc77c, \uc774\uba54\uc77c = \ubaa8\ub378.\uc774\uba54\uc77c };\r\n        var result = await _userManager.CreateAsync(user, model.Password);\r\n        if (result.Succeeded)\r\n        {\r\n            var roleName = \"CustomRole\";\r\n            if (!await _roleManager.RoleExistsAsync(roleName))\r\n                await _roleManager.CreateAsync(new IdentityRole(roleName));\r\n\r\n            await _userManager.AddToRoleAsync(user, roleName);\r\n            await _signInManager.SignInAsync(user, isPersistent: false);\r\n            return RedirectToAction(\"Index\", \"Home\");\r\n        }\r\n\r\n        foreach (var error in result.Errors) ModelState.AddModelError(\"\", error.Description);\r\n        \ubc18\ud658 \ubdf0(\ubaa8\ub378);\r\n    }\r\n\r\n    public IActionResult Login() => View();\r\n\r\n    [HttpPost]\r\n    public async Task Login(LoginModel model)\r\n    {\r\n        if (!ModelState.IsValid) return View(model);\r\n\r\n        var result = await _signInManager.PasswordSignInAsync(model.Email, model.Password, false, false);\r\n        if (result.Succeeded)\r\n            RedirectToAction(\"Index\", \"Home\")\uc744 \ubc18\ud658\ud569\ub2c8\ub2e4;\r\n\r\n        ModelState.AddModelError(\"\", \"\uc798\ubabb\ub41c \ub85c\uadf8\uc778 \uc2dc\ub3c4\uc785\ub2c8\ub2e4.\");\r\n        \ubc18\ud658 View(model);\r\n    }\r\n\r\n    public async Task Logout()\r\n    {\r\n        await _signInManager.SignOutAsync();\r\n        return RedirectToAction(\"Index\", \"Home\");\r\n    }\r\n}<\/pre>\n
      \ub370\uc774\ud130\ub294 \ud45c\uc900 ID \uad6c\uc870\ub97c \ub530\ub974\uba70, Couchbase \ubb38\uc11c\uc5d0 \uc800\uc7a5\ub429\ub2c8\ub2e4. \uc608\ub97c \ub4e4\uc5b4 AspNetUser<\/em> \uceec\ub809\uc158:<\/p>\n
      \"A<\/p>\n
      \n
      \ud56b \ucd08\ucf5c\ub9bf\uc744 \uc0ac\uc6a9\ud55c \uadf8\ub798\ud504QL<\/h2>\n
      \ud56b \ucd08\ucf5c\ub9bf<\/a> \ub294 \ub110\ub9ac \uc0ac\uc6a9\ub418\ub294 .NET\uc6a9 GraphQL \uc11c\ubc84\uc785\ub2c8\ub2e4. \uc774 \uc11c\ubc84\ub294 \uacf5\uae09\uc790\uc758 LINQ \uae30\ub2a5(Couchbase\uac00 \uc81c\uacf5\ud558\ub294 \uae30\ub2a5)\uc744 \ud65c\uc6a9\ud558\uc5ec EF Core\uc640 \ud1b5\ud569\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uc989, GraphQL \ucffc\ub9ac\uac00 LINQ\ub85c \ubcc0\ud658\ub41c \ub2e4\uc74c Couchbase SQL++\ub85c \ubcc0\ud658\ub429\ub2c8\ub2e4.<\/p>\n
      \uc124\uc815<\/h3>\n
      \uacf5\uc6a9 \ud074\ub798\uc2a4 \uc704\uc82f \ucffc\ub9ac\r\n{\r\n    [UseFiltering]\r\n    [UseSorting]\r\n    public IQueryable GetWidgets([Service] WidgetDbContext dbContext)\r\n        => dbContext.Widgets;\r\n}\r\n\r\n\/\/ Program.cs:\r\n\r\n\ube4c\ub354.\uc11c\ube44\uc2a4\r\n    .AddGraphQLServer()\r\n    .AddQueryType()\r\n    .AddFiltering()\r\n    .AddSorting()\r\n    .AddProjections();\r\n\r\napp.MapGraphQL();<\/pre>\n
      \uc0ac\uc6a9 \uc608<\/h3>\n