Time-To-Live (TTL): Manage Documents with Couchbase N1QL

RDBMS에 있었으면 하는 기능이 하나 있는데, 바로 데이터 레코드에 대한 타임투라이프 값을 설정할 수 있는 기본 지원 기능입니다. NoSQL 데이터베이스에서는 TTL을 지원하는 것이 매우 일반적입니다. NoSQL 데이터베이스는 RDBMS의 기존 사용 사례에서는 흔히 볼 수 없는 특정 유형의 데이터를 처리하도록 설계되었습니다. 여기에는 로그 및 이벤트 관리가 포함되는데, 이러한 데이터는 비정형 데이터의 특성뿐만 아니라 그 양이 방대하기 때문에 RDBMS에서 관리하기 어렵고 비용이 많이 드는 경우가 많습니다. 이러한 유형의 데이터는 바로 타임 투 라이브(TTL)는 NoSQL 데이터베이스에서 널리 사용되는 기능입니다.

하지만 기존 RDBMS에서 TTL을 빠르게 검색하면 1백만 건 이상의 검색 결과가 나오는데, 이는 개발자가 RDBMS에서 이러한 유형의 지원을 원하는 사용 사례가 많다는 것을 의미합니다. 다음은 제가 본 사용 사례 중 일부입니다:

계산을 목적으로 대량의 임시 데이터를 생성하는 애플리케이션. 예를 들어, 플랜 관리자가 플랜의 효과를 확인하기 위해 가정 분석을 설계하고 수행할 수 있는 인센티브 보상 시스템이 있습니다. 그런 다음 플랜이 배포되면 유효성 검사/사용자 조회 목적으로 계산을 위한 임시 데이터도 보관해야 합니다.
경영 정보 시스템에서는 여러 지역의 소스에서 집계된 데이터를 미리 생성해야 하는 경우가 많으며, 여기에는 복잡한 통화 변환 규칙이 포함되는 경우가 많습니다. 이러한 집계 데이터에 대한 요구 사항은 현재 회계 보고 기간에만 필요한 경우가 많습니다.
데이터를 다른 저장 매체로 옮긴 후 오래된 데이터를 제거하는 자동 보관 프로세스가 포함된 시스템입니다.

위에서 언급한 모든 사용 사례에는 실제 데이터를 삭제하는 추가 단계도 포함됩니다. 그러나 대부분의 경우 시스템에서는 트랜잭션 기반 RDBMS에서 데이터를 삭제하는 데 시간이 오래 걸릴 수 있는 프로세스를 피하기 위해 프로세스를 분리하려고 할 것입니다.

여기서 TTL(Time-to-Live) 기능을 사용하면 애플리케이션이 만료 시간으로 데이터 레코드를 간단히 설정하고 실제 삭제는 다른 데이터베이스 프로세스로 연기할 수 있습니다.

카우치베이스의 경우, TTL 지원은 항상 다음과 같이 사용할 수 있습니다. 카우치베이스 키-값 연산. 하지만 Couchbase 6.5.1이 기능은 이제 사용자가 N1QL 문에서 직접 만료 값을 쿼리하고 설정할 수 있는 N1QL DML에서 사용할 수 있습니다.

옵션이 있는 N1QL TTL

TTL을 지원하기 위해 N1QL 구문은 옵션 매개변수 OPTIONS로 확장되었습니다.

INSERT INTO default (KEY, VALUE [, OPTIONS])
      VALUES (kval, docval [, {"expiration":eval}]);

1 2	삽입 INTO 기본값 (KEY, VALUE [, 옵션]) 가치 (kval, docval [, {"만료":평가}]);

OPTIONS 매개변수는 이전 버전과의 호환성을 보장하기 위해 선택 사항이라는 점에 유의하세요.

삽입/업서트를 클릭하고 10분 후에 문서가 만료되도록 설정합니다.

INSERT INTO default (KEY, VALUE) VALUES ("k01", {"id":"k01"}, {"expiration":10*60});
UPSERT INTO default (KEY, VALUE) VALUES ("k01", {"id":"k01"}, {"expiration":10*60});

1 2	삽입 INTO 기본값 (KEY, VALUE) 가치 ("k01", {"id":"k01"}, {"만료":1060}); UPSERT INTO 기본값 (KEY, VALUE) 가치 ("k01", {"id":"k01"}, {"만료":1060});

SELECT에 삽입/업서트를 하고 문서를 만료 시간으로 1시간으로 설정합니다.

INSERT INTO default (KEY key, VALUE doc, OPTIONS {"expiration": 60*60}) 
       SELECT META(t).id AS key, t AS doc FROM `travel-sample` AS t;
UPSERT INTO default (KEY key, VALUE doc, OPTIONS {"expiration": 60*60}) 
       SELECT META(t).id AS key, t AS doc FROM `travel-sample` AS t;

삽입 INTO 기본값 (KEY 키, VALUE doc, 옵션 {"만료": 60*60})

선택 메타(t).id AS 키, t AS doc FROM `여행-샘플` AS t;

UPSERT INTO 기본값 (KEY 키, VALUE doc, 옵션 {"만료": 60*60})

선택 메타(t).id AS 키, t AS doc FROM `여행-샘플` AS t;

업데이트/업로드 중 TTL을 유지하려면 다음과 같이 하세요.

Couchbase 6.5.1 이전 버전에서는 N1QL 업데이트 문이 문서의 기존 값을 보존하지 않습니다. 이 동작은 변경되지 않으며, 사용자가 TTL을 유지하려면 N1QL 업데이트 문에서 명시적으로 만료를 동일한 값으로 설정해야 합니다.

UPDATE default AS d SET d.comment = "xyz" , META(d).expiration = META(d).expiration;

1	업데이트 기본값 AS d SET d.댓글 = "xyz" , 메타(d).만료 = 메타(d).만료;

SELECT에 삽입/업셋하고 문서 만료 시간 유지

INSERT INTO default (KEY key, VALUE doc, OPTIONS {"expiration": exptime}) 
       SELECT META(t).id AS key, t AS doc, META(t).expiration AS exptime FROM `travel-sample` AS t;
UPSERT INTO default (KEY key, VALUE doc, OPTIONS {"expiration": exptime}) 
       SELECT META(t).id AS key, t AS doc, META(t).expiration AS exptime FROM `travel-sample` AS t;

삽입 INTO 기본값 (KEY 키, VALUE doc, 옵션 {"만료": 예외 시간})

선택 메타(t).id AS 키, t AS doc, 메타(t).만료 AS 예외 시간 FROM `여행-샘플` AS t;

UPSERT INTO 기본값 (KEY 키, VALUE doc, 옵션 {"만료": 예외 시간})

선택 메타(t).id AS 키, t AS doc, 메타(t).만료 AS 예외 시간 FROM `여행-샘플` AS t;

문서를 병합하고 만료 시간을 보존하세요.

MERGE INTO `travel-sample` AS route
   USING `travel-sample` AS airport
ON route.sourceairport = airport.faa
WHEN MATCHED THEN
   UPDATE SET route.old_equipment = route.equipment,
              route.equipment = ""797"",
              route.updated = true,
              META(route).expiration = META(route).expiration
          WHERE airport.country = ""France""
            AND route.airline = ""BA""
            AND CONTAINS(route.equipment, ""319"");"

MERGE INTO `여행-샘플` AS 경로

사용 `여행-샘플` AS 공항

켜기 경로.소스공항 = 공항.faa

언제 일치 그때

업데이트 SET 경로.old_equipment = 경로.장비,

경로.장비 = ""797"",

경로.업데이트 = true,

메타(경로).만료 = 메타(경로).만료

어디 공항.국가 = ""프랑스""

AND 경로.항공사 = ""BA""

AND 포함(경로.장비, ""319"");"

META().만료 필드

META().expiration 필드는 항상 N1QL에서 사용할 수 있었습니다. 하지만 N1QL TTL을 사용하면 사용자가 필드 값을 직접 변경할 수 있습니다.

술어에서 만료를 선택하고 사용하려면 다음과 같이 하세요.

SELECT META(d).id, META(d).expiration FROM default d WHERE META(d).expiration > 0;

1	선택 메타(d).id, 메타(d).만료 FROM 기본값 d 어디 메타(d).만료 > 0;

모든 문서를 업데이트하고 댓글 및 만료 시간을 10분으로 설정합니다.

UPDATE default AS d SET d.comment = "xyz" , META(d).expiration = 10*60;

1	업데이트 기본값 AS d SET d.댓글 = "xyz" , 메타(d).만료 = 10*60;

만료 시간을 지우려면 문서가 삭제되지 않도록 합니다.

UPDATE default AS d SET META(d).expiration = 0;

1	업데이트 기본값 AS d SET 메타(d).만료 = 0;

하루 이상 후에 문서가 만료되는 모든 문서를 삭제하려면 다음과 같이 하세요.

DELETE default d WHERE META(d).expiration > <span style="font-weight: 400">(NOW_MILLIS()/1000)+ (60*60*24);</span>

1	삭제 기본값 d 어디 메타(d).만료 > <span 스타일="글꼴 무게: 400">(NOW_MILLIS()/1000)+ (606024);</span>

상대값은 INSERT/UPDATE/UPSERT에만 사용된다는 점에 유의하세요. 그 외의 모든 경우에는 절대 만료 값을 사용해야 합니다.

만료 시간 값

향후 30일 미만의 만료 시간을 초 단위로 설정할 수 있습니다. 60*60*24*14의 값은 14일 후에 문서가 삭제되도록 표시합니다. 향후 30일 이상은 유닉스 시간을 사용해야 합니다. Couchbase 만료 시간에 대한 자세한 내용은 다음 문서를 참조하세요. 카우치베이스 문서.

만료 필드에 인덱스 생성

쿼리 기능 및 META().expiration을 색인화합니다. 필드에서 항상 가능했습니다.

CREATE INDEX idx_expir ON `travel-sample` ( META().expiration );

SELECT META().id, META().expiration FROM `travel-sample` WHERE META().expiration = 0 ORDER BY META().id LIMIT 2;

만들기 INDEX IDX_EXPIR 켜기 `여행-샘플` ( 메타().만료 );

선택 메타().id, 메타().만료 FROM `여행-샘플` 어디 메타().만료 = 0 주문 BY 메타().id LIMIT 2;

문서가 삭제된 시점과 삭제가 색인 서비스에 전파되는 시점 사이에 지연이 발생할 수 있습니다. 이러한 이유로 만료가 있는 인덱스에 완전히 포함된 쿼리는 오래된 데이터를 반환할 수 있습니다. 하지만 이 동작은 일시적인 현상일 뿐입니다.

성능 고려 사항

N1QL 를 사용하여 TTL 정보에 액세스합니다. SUBDOC API 이 API는 전체 문서를 반환하며 요청 패킷 크기에 약간의 오버헤드가 있습니다. 추가 오버헤드로 인해 쿼리 대기 시간이 추가로 발생할 수 있습니다. 그러나 SUBDOC API는 쿼리에서 META().expiration 필드가 참조되는 경우에만 사용됩니다.

추가 리소스

TTL에 대한 카우치베이스 지원: https://docs.couchbase.com/server/current/learn/buckets-memory-and-storage/expiration.html
만료 시간을 설정하는 방법 https://docs.couchbase.com/server/current/learn/buckets-memory-and-storage/expiration.html
카우치베이스 서브닥 API: https://docs.couchbase.com/server/5.0/developer-guide/sub-doc-api.html
만료 필드 색인화: https://docs.couchbase.com/server/current/n1ql/n1ql-language-reference/indexing-meta-info.html

Binh Le

이 문서 공유하기

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

Couchbase N1QL로 TTL(Time-To-Live) 문서 관리하기

옵션이 있는 N1QL TTL

삽입/업서트를 클릭하고 10분 후에 문서가 만료되도록 설정합니다.

SELECT에 삽입/업서트를 하고 문서를 만료 시간으로 1시간으로 설정합니다.

업데이트/업로드 중 TTL을 유지하려면 다음과 같이 하세요.

SELECT에 삽입/업셋하고 문서 만료 시간 유지

문서를 병합하고 만료 시간을 보존하세요.

META().만료 필드

술어에서 만료를 선택하고 사용하려면 다음과 같이 하세요.

모든 문서를 업데이트하고 댓글 및 만료 시간을 10분으로 설정합니다.

만료 시간을 지우려면 문서가 삭제되지 않도록 합니다.

하루 이상 후에 문서가 만료되는 모든 문서를 삭제하려면 다음과 같이 하세요.

만료 시간 값

만료 필드에 인덱스 생성

성능 고려 사항

추가 리소스

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

작성자

게시자 Binh Le

댓글 남기기 응답 취소

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

구축 시작

카펠라 무료 사용

연락하기