데이터 보존 및 삭제

보유는 이벤트 계약의 일부입니다. 테이블이 얼마나 오랫동안 유용하게 유지되는지, 어떤 식별자가 포함되어 있는지, 법적 또는 고객 약속에 따라 프로덕션 데이터를 보내기 전에 더 짧은 수명 주기가 필요한지 여부를 결정하세요.

테이블별로 보존 설정

목적이 다른 테이블은 하나의 우발적인 정책을 상속해서는 안 됩니다. 대용량 운영 이벤트는 소량 청구 마일스톤이나 감사 기록보다 더 짧은 기간이 필요할 수 있습니다.

보존 기간을 설정하거나 지우려면 테이블 API를 사용하십시오.

curl -X PATCH https://api.telemetry.sh/tables/api_requests/retention \
  -H "Authorization: Bearer $TELEMETRY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "retention_days": 30 }'

테이블 API 참조는 현재 요청 및 응답 계약을 문서화합니다.

행 또는 표 삭제

선택적 삭제는 영향을 받은 저장된 데이터를 비동기식으로 다시 작성합니다. 전체 테이블을 삭제하면 정리가 진행되는 동안 테이블이 정상적으로 사용되지 않습니다. 삭제는 파괴적이므로 먼저 읽기 전용 쿼리를 사용하여 정확한 테이블과 조건자를 확인하세요.

SELECT COUNT(*) AS rows_to_delete
FROM product_events
WHERE account_id = 'account_123';

그런 다음 API 참조 삭제에 설명된 지원되는 삭제 엔드포인트를 사용하세요. 삭제 요청을 담당하는 시스템에는 대상 테이블, 조건자, 요청자, 승인 및 완료 증거를 유지합니다. 개인 행 내용을 해당 레코드에 복사하지 마십시오.

삭제 가능성을 고려한 디자인

테이블이 주체 수준 삭제를 지원해야 하는 경우 안정적이고 불투명한 계정과 사용자 식별자를 사용하세요. 자유 형식 텍스트와 일관되지 않은 식별자로 인해 해당하는 모든 행을 안전하게 찾기가 어렵습니다.

우선 비밀, 결제 데이터, 요청 본문 또는 원시 프롬프트를 보내지 마세요. 삭제는 데이터 최소화를 대체할 수 없습니다.

수명주기 확인

보존 기간을 변경한 후 테이블 메타데이터를 가져오고 저장된 정책을 확인하세요. 삭제 후 작업이 완료될 때까지 정확한 조건자를 쿼리합니다. 제거된 기록이 예상되는 대시보드 및 저장된 쿼리의 유효성을 검사합니다.

새로운 식별자, 이벤트 소스, 지역 또는 고객 약속이 도입되면 보존을 검토하세요. 민감한 데이터 수정 및 파티션 열을 계속 진행하세요.