이 ASP.NET Core CRUD 시리즈가 곧 끝납니다. 지금까지 다룬 내용은 다음과 같습니다. 설정(1부), SQL++로 읽기(2부), 키-값으로 읽기(3부)및 생성/업데이트(4부). 이 마지막 게시물에서는 다음과 같이 D in CRUD: 삭제.
SQL++ 또는 키-값으로 삭제하기
패턴을 눈치채셨길 바랍니다. 읽기, 만들기, 업데이트와 마찬가지로 삭제에도 여러 가지 경로가 있습니다. SQL++를 사용할 수 있습니다. 삭제 문을 사용합니다:
|
1 2 |
삭제 FROM 데모._기본값.위시리스트 w 어디 메타(w).id = "1c3de2e7-70ea-4ee2-803b-425bbf6251cb" |
또는 키-값 삭제 작업(일명 "제거“):
|
1 |
기다림 컬렉션.RemoveAsync("1c3de2e7-70ea-4ee2-803b-425bbf6251cb"); |
그리고 이전과 마찬가지로 어떤 것을 사용할지 결정하는 데 도움이 되는 매우 유사한 가이드라인이 있습니다:
| 사용 사례 | 키 값? | 왜 또는 왜 안 될까요? |
| 키 "73892"로 사용자 삭제하기 | 예 | 직접 액세스 |
| 키가 "73892", "47212", "90491"인 사용자 그룹을 삭제합니다. | 예 | 이 경우 여러 키-값 연산이 필요할 수 있지만 여전히 SQL을 사용하는 것보다 빠를 수 있습니다. 삭제 ... 어디서 ... 에서 쿼리. |
| "Ohio"에서 모든 사용자 삭제 | 아니요 | 사용자의 상태는 키가 아닌 '보조' 속성일 가능성이 높습니다(여러 사용자가 오하이오에 있을 수 있음). 이는 SQL++의 좋은 사용 사례입니다. 삭제 |
ASP.NET Core용 엔드포인트 삭제
이를 염두에 두고 다음과 같이 삭제 엔드포인트를 만드세요:
|
1 2 3 4 5 6 7 8 9 10 11 |
[HttpDelete] [경로("API/삭제")] public 비동기 작업<IActionResult> 삭제(Guid id) { var 버킷 = 기다림 _버킷 공급자.GetBucketAsync("demo"); var 컬렉션 = 기다림 버킷.CollectionAsync("위시리스트"); 기다림 컬렉션.RemoveAsync(id.ToString()); 반환 확인(new { 성공 = true }); } |
이 엔드포인트를 OpenAPI/Swagger와 함께 사용해 보면 예상대로 작동합니다.
정말 삭제해야 하나요?
많은 사용 사례에서 다음을 원하지 않을 수 있습니다. 실제로 데이터를 삭제합니다. '소프트' 삭제라고 하는 작업을 수행할 수 있습니다. 여기에는 데이터베이스에 여전히 존재하지만 최종 사용자에게 더 이상 표시되지 않도록 데이터를 이동하거나 표시하는 작업이 포함됩니다. 이 방법은 검색, 복구 및 보고가 가능하다는 장점이 있습니다.
또한 JSON NoSQL 데이터베이스의 유연성을 보여줄 수 있는 좋은 기회이기도 합니다.
소프트 삭제
위시리스트 항목에 '삭제됨' 필드를 도입해 보겠습니다. 이 필드에는 항목이 삭제된 날짜/시간이 포함됩니다. 이 필드가 존재하면 나머지 엔드포인트는 이 항목을 삭제된 것으로 간주해야 합니다. 그러나 필요한 경우 여전히 해당 항목을 쿼리하고, 보고하고, 복구할 수 있습니다.
관계형 데이터베이스의 경우, 이 작업을 수행하려면 ALTER. 데이터의 크기에 따라 약간의 다운타임이 필요하거나 많은 NULL 값이 필요할 수 있습니다. JSON 데이터베이스에서는 새 필드에 대해 데이터베이스에 아무 것도 알릴 필요가 없습니다.
사용해보겠습니다. 하위 문서 API 를 추가하려면 "삭제됨' 필드를 문서에 추가합니다. 하위 문서는 문서에 대한 부분 을 제거하고 나머지는 그대로 둡니다.
|
1 2 3 4 5 6 7 8 9 10 11 12 |
[HttpDelete] [경로("api/softDelete")] public 비동기 작업<IActionResult> 소프트삭제(Guid id) { var 버킷 = 기다림 _버킷 공급자.GetBucketAsync("demo"); var 컬렉션 = 기다림 버킷.CollectionAsync("위시리스트"); 기다림 컬렉션.MutateInAsync(id.ToString(), 옵션 => 옵션.Upsert("삭제됨", 날짜/시간.지금)); 반환 확인(new { 성공 = true }); } |
(다음 사항을 확인하세요. 사용 Couchbase.KeyValue; 가 맨 위에 있습니다. 선물 컨트롤러 파일)
이 코드는 Couchbase에 명령을 보냅니다: 라는 필드를 삽입하여 해당 ID를 가진 문서에 대해 "삭제됨"를 입력하고 현재 날짜/시간을 값으로 지정합니다..
하위 문서를 사용하면 기존 문서를 먼저 로드할 필요가 없고, 수정된 문서 전체를 유선으로 다시 보낼 필요도 없습니다.
소프트 삭제된 데이터
최종 결과는 다음과 같은 문서가 됩니다:
|
1 2 3 4 |
{ "name": "디지털 액자", "삭제됨": "2022-04-21T11:05:26.1766248-04:00" } |
위시리스트에 있는 다른 문서들은 not 를 삭제됨 필드입니다. 여전히 다음과 같이 보입니다:
|
1 2 3 |
{ "name": "스카이라인 칠리 2XL 티셔츠" } |
그리고
|
1 2 3 |
{ "name": "조이 보토 유니폼" } |
이들은 "삭제됨": null 필드에 “삭제됨“ 필드를 전혀 사용하지 않습니다.
소프트 삭제된 SELECT
데이터는 다음과 같습니다. 표시 가 삭제된 것으로 표시되지만 여전히 데이터베이스에 남아 있습니다. 데이터베이스에서 GetAll 엔드포인트 (자세한 내용은 2부를 참조하세요. GetAll)를 사용하여 이를 고려합니다:
|
1 2 3 |
선택 메타(w).id, w.* FROM 데모._기본값.위시리스트 w 어디 w.삭제됨 IS 누락 |
여기에 SQL++ 구문을 몇 가지 더 소개했습니다: 누락. 이것은 관계형 데이터베이스에는 존재하지 않는 개념입니다. 관계형에서는 쿼리에 지정된 모든 열이 정의되어야 하며 값이 있어야 합니다(null인 경우에도). JSON NoSQL 문서 데이터베이스에서는 이러한 제약이 없습니다.
색인 개선
마지막으로 논의해야 할 사항은 인덱싱입니다. 다시 파트 2를 사용하여 시작하기 위해 기본 인덱스를 만들었습니다. 하지만 이 인덱스가 가장 효율적이지는 않습니다. 인덱스 생성 및 조정 는 관계형 데이터베이스 세계에서와 마찬가지로 심도 있는 주제입니다.
다행히도 Couchbase Capella에는 내장된 조언 도구 를 클릭하면 더 나은 인덱스를 추천할 수 있습니다. 클릭하기만 하면 조언 을 사용하거나, 쿼리 워크벤치에서 조언 구문).
이 경우 다음과 같은 권장 사항을 제공합니다:
|
1 2 3 4 5 6 7 8 9 10 11 |
"권장_인덱스": { "인덱스": [ { "index_statement": "`default`:`데모`.`_default`.`위시리스트`(`삭제`가 누락된) `deleted`가 누락된`에 인덱스 adv_deletedISMISSING 생성", "index_statement_relative": "`위시리스트`(`삭제됨`이 누락됨) `삭제됨`이 누락된 `위시리스트`에 인덱스 adv_deletedISMISSING 생성", "키스페이스_알리어스": "wishlist_w", "쿼리_컨텍스트": "기본값:데모._기본값", "추천_규칙": "인덱스 키는 술어 유형의 순서를 따릅니다: 2. 같음/없음/누락." } ] } |
위시리스트 데이터의 양이 매우 적은 경우에는 이 인덱스를 만들 가치가 없을 수도 있습니다. 하지만 예를 들어 전체 전자상거래 사이트의 위시리스트를 관리하는 경우라면 이 인덱스가 좋은 출발점이 될 수 있습니다.
CRUD의 종말
Couchbase를 사용하여 매우 간단한 ASP.NET Core CRUD 애플리케이션을 만드는 작업이 끝났습니다. 최종 API 표면은 다음과 같습니다:
다음은 이 시리즈의 개념에 대한 분석이며, 더 자세히 알아볼 수 있는 문서 링크도 함께 제공됩니다:
-
- 아카펠라 설정
- NET 종속성 주입 설정
- SQL++ (여전히 "N1QL"이라고도 함)
-
-
- 키-값 CRUD 연산
- 하위 문서 작업
-
이 시리즈의 전체 소스 코드는 GitHub에서 확인할 수 있습니다..
다음 단계는 무엇인가요?
아카펠라 무료 체험 신청하기. Couchbase Capella DBaaS는 Couchbase를 시작하는 가장 쉬운 방법이며 신용 카드가 필요하지 않습니다.
다음 내용을 확인하세요. .NET용 카우치베이스 플레이그라운드 브라우저에서 바로 실행할 수 있는 예제입니다.
가입하기 카우치베이스 디스코드 를 통해 CouchBase 엔지니어 및 다른 CouchBase 커뮤니티 구성원들과 질문하고 의견을 교환할 수 있습니다.
