변경 내역 구성

Bigtable 테이블의 데이터 변경사항을 추적하려면 테이블의 변경 내역을 사용 설정한 다음 Dataflow와 같은 애플리케이션을 사용하여 읽으면 됩니다. 이 문서를 읽기 전에 변경 내역 개요를 읽어보세요. 특히 변경사항을 스트리밍할 때 발생하는 비용을 숙지해야 합니다.

이 페이지에서는 변경 내역의 보관 기간을 사용 설정, 중지, 변경하는 방법을 설명합니다.

변경 내역이 사용 설정된 새 테이블을 만드는 방법은 테이블 만들기를 참조하세요.

필요한 역할

Bigtable 변경 내역을 사용 설정, 중지, 수정하는 데 필요한 권한을 얻으려면 관리자에게 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 변경사항을 스트리밍해올 테이블이 포함된 Bigtable 인스턴스의 Bigtable 관리자(roles/bigtable.admin)

변경 내역 사용 설정

기존 테이블에 변경 내역을 사용 설정하려면 다음 단계를 완료합니다.

콘솔

  1. Google Cloud 콘솔에서 Bigtable 인스턴스 목록을 엽니다.

    인스턴스 목록 열기

  2. 변경 내역을 사용 설정할 테이블이 포함된 인스턴스를 클릭합니다.

  3. 왼쪽 창에서 테이블을 클릭합니다.

    테이블 페이지에는 인스턴스의 테이블 목록이 표시됩니다.

  4. 변경 내역을 사용 설정할 테이블에서 수정을 클릭합니다.

  5. 변경 내역 사용 설정을 클릭합니다.

  6. 만료 시간 필드에 1에서 7 사이의 숫자를 입력하여 데이터 스트림 레코드를 보관해야 하는 일수를 구성합니다.

  7. 저장을 클릭합니다.

gcloud

테이블에 변경 내역을 사용 설정하려면 gcloud bigtable instances tables update 명령어를 사용합니다.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

다음을 바꿉니다.

  • TABLE_ID: 변경사항을 스트리밍하려는 테이블의 ID
  • INSTANCE_ID: 테이블이 포함된 인스턴스
  • PROJECT_ID: 인스턴스가 포함된 프로젝트
  • CHANGE_STREAM_RETENTION_PERIOD: Bigtable이 테이블의 변경 내역 데이터를 유지해야 하는 기간. 1일~7일이고 숫자와 문자 단위로 표현되어야 합니다. 사용 가능한 단위는 일(d), 시간(h), 분(m), 초(s)입니다. 예를 들면 5d입니다.

변경 내역 중지

언제든지 테이블의 변경 내역을 중지할 수 있습니다. 변경 내역을 중지하기 전에 만든 데이터 스트림 레코드는 다음 압축까지 계속 스토리지를 사용하지만 더 이상 해당 스토리지에 대한 요금은 청구되지 않습니다. 중지한 후에는 변경 내역을 중지하기 전에 기록된 변경사항을 포함한 변경 내역을 읽을 수 없습니다.

콘솔

  1. Google Cloud 콘솔에서 Bigtable 인스턴스 목록을 엽니다.

    인스턴스 목록 열기

  2. 테이블을 보려는 인스턴스를 클릭합니다.

  3. 왼쪽 창에서 테이블을 클릭합니다.

    테이블 페이지에는 인스턴스의 테이블 목록이 표시됩니다.

  4. 변경 내역 구성을 중지하려는 테이블에서 수정을 클릭합니다.

  5. 변경 내역 사용 설정에서 체크표시를 선택 취소합니다.

  6. 저장을 클릭합니다.

gcloud

테이블에서 변경 내역을 중지하려면 gcloud bigtable instances tables update 명령어를 사용합니다.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --clear-change-stream-retention-period

다음을 바꿉니다.

  • TABLE_ID: 변경사항을 스트리밍하려는 테이블의 ID
  • INSTANCE_ID: 테이블이 포함된 인스턴스
  • PROJECT_ID: 인스턴스가 포함된 프로젝트

변경 내역의 보관 기간 수정

Bigtable에서 변경 내역 레코드를 보관하는 일수를 수정할 수 있습니다. 일수를 줄여도 구성 변경 전에 스트리밍된 레코드가 다음 압축까지 계속 스토리지를 사용합니다. 구성이 변경되면 새로 지정된 기간의 변경사항만 스트리밍할 수 있습니다.

보관 기간을 늘려도 소급 적용되지 않습니다. 즉, 구성을 수정할 때부터 시작된 늘어난 일수 동안 변경 내역이 유지됩니다.

콘솔

  1. Google Cloud 콘솔에서 Bigtable 인스턴스 목록을 엽니다.

    인스턴스 목록 열기

  2. 테이블을 보려는 인스턴스를 클릭합니다.

  3. 왼쪽 창에서 테이블을 클릭합니다.

    테이블 페이지에는 인스턴스의 테이블 목록이 표시됩니다.

  4. 변경 내역 구성을 수정하려는 테이블에서 수정을 클릭합니다.

  5. 만료 시간 필드에 데이터 스트림 레코드를 보관해야 하는 일수를 1에서 7 사이의 숫자로 입력합니다.

  6. 저장을 클릭합니다.

gcloud

테이블 변경 내역 보관 기간을 변경하려면 gcloud bigtable instances tables update 명령어를 사용합니다.

  gcloud bigtable instances tables update TABLE_ID \
        --instance=INSTANCE_ID \
        --project=PROJECT_ID \
        --change-stream-retention-period=CHANGE_STREAM_RETENTION_PERIOD

다음을 바꿉니다.

  • TABLE_ID: 변경사항을 스트리밍하려는 테이블의 ID
  • INSTANCE_ID: 테이블이 포함된 인스턴스
  • PROJECT_ID: 인스턴스가 포함된 프로젝트
  • CHANGE_STREAM_RETENTION_PERIOD: Bigtable이 테이블의 변경 내역 데이터를 유지해야 하는 기간. 1일~7일이고 숫자와 문자 단위로 표현되어야 합니다. 사용 가능한 단위는 일(d), 시간(h), 분(m), 초(s)입니다. 예를 들면 5d입니다.

다음 단계