Bigtable에서 카운터 만들기 및 업데이트

Bigtable 인스턴스를 만듭니다.

1. bigtable instances create 명령어를 사용하여 인스턴스를 만듭니다.

   gcloud bigtable instances create counters-quickstart-instance \
       --display-name="Counters quickstart instance" \
       --cluster-config=id="counters-quickstart-cluster",zone="us-east1-c"
   

내 인스턴스에 연결

1. .cbtrc 파일을 만들어 프로젝트와 인스턴스를 사용하도록 cbt CLI를 구성합니다.

   echo project = PROJECT_ID >> ~/.cbtrc && echo instance = counters-quickstart-instance >> ~/.cbtrc
   

   PROJECT_ID를 사용 중인 프로젝트의 ID로 바꿉니다.

2. .cbtrc 파일을 올바르게 설정했는지 확인합니다.

   cat ~/.cbtrc
   

   터미널에는 .cbtrc 파일의 콘텐츠가 표시됩니다. 이는 다음과 유사합니다.

   project = PROJECT_ID
   instance = counters-quickstart-instance

   이제 인스턴스에서 cbt CLI를 사용할 수 있습니다.

집계 column family가 있는 테이블 만들기

1. cbt createtable 명령어를 사용하여 집계 column family가 3개인 counters_quickstart_table이라는 테이블을 만듭니다. 각 column family를 서로 다른 집계 유형으로 구성합니다.

   • 열 패밀리 max_family는 입력 유형이 Integer인 Max 유형입니다.
   • 열 패밀리 min_family는 입력 유형이 Integer인 Min 유형입니다.
   • 열 패밀리 sum_family는 입력 유형이 Integer인 Sum 유형입니다.

   cbt createtable counters_quickstart_table families=sum_family:never:intsum,min_family:never:intmin,max_family:never:intmax
   

2. cbt ls 명령어를 실행하여 column family를 나열합니다.

   cbt ls counters_quickstart_table
   

   다음과 유사한 출력이 셸에 표시됩니다.

   Family Name     GC Policy
   -----------     ---------
   max_family      <never>
   min_family      <never>
   sum_family      <never>
   

테이블에 카운터 만들기

1. cbt addtocell 명령어를 사용하여 row-key1 행 키와 0 타임스탬프를 사용하여 세 개의 column family 각각의 새 열에 5의 초기 값을 씁니다. 이 작업은 카운터로 사용하는 집계 셀을 만듭니다.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=5@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=5@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=5@0
   

데이터 읽기

1. 카운터 값을 바이트가 아닌 정수로 보려면 cbt CLI에서 출력 형식을 지정하는 데 사용할 수 있는 yaml 파일을 정의합니다. 다음을 실행합니다.

   echo "families:" > cbtformat.yaml
   echo "  max_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  min_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   echo "  sum_family:" >> cbtformat.yaml
   echo "    default_encoding: BigEndian" >> cbtformat.yaml
   echo "    default_type: INT64" >> cbtformat.yaml
   

2. cbtformat.yaml 파일을 올바르게 설정했는지 확인합니다.

   cat ~/cbtformat.yaml
   

   터미널에는 cbtformat.yaml 파일의 콘텐츠가 표시됩니다. 이는 다음과 유사합니다.

   families:
     max_family:
       default_encoding: BigEndian
       default_type: INT64
     min_family:
       default_encoding: BigEndian
       default_type: INT64
     sum_family:
       default_encoding: BigEndian
       default_type: INT64
   

3. cbt read 명령어를 사용하여 yaml 파일을 전달하고 테이블에 추가한 데이터를 읽습니다. 이제 표에 집계 유형이 각각 다른 열 3개가 있습니다.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   다음과 유사한 출력이 셸에 표시됩니다. 값은 정수 형식이며 타임스탬프는 UTC 형식입니다.

   row-key1
     max_family:max_column                    @ 1970/01/01-00:00:00.000000
       5
     min_family:min_column                    @ 1970/01/01-00:00:00.000000
       5
     sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
       5
   

카운터 업데이트

1. 셀을 만들 때 사용한 동일한 타임스탬프를 사용하여 테이블의 각 열에 3 값을 추가합니다. 각 열에서 셀 값은 셀의 집계 유형에 따라 기존 값과 병합됩니다.

   cbt addtocell counters_quickstart_table row-key1 sum_family:sum_column=3@0
   cbt addtocell counters_quickstart_table row-key1 min_family:min_column=3@0
   cbt addtocell counters_quickstart_table row-key1 max_family:max_column=3@0
   

2. cbt read 명령어를 다시 실행하여 테이블의 데이터를 읽습니다. 이제 각 셀에 집계된 값이 포함됩니다.

   cbt read counters_quickstart_table format-file=$HOME/cbtformat.yaml
   

   sum_column에는 5와 3의 합계 (8)가 포함되고, min_column에는 쓰여진 두 값 중 최솟값 (3)이 포함되며, max_column에는 쓰여진 두 값 중 최댓값 (5)이 포함됩니다.

   row-key1
       max_family:max_column                    @ 1970/01/01-00:00:00.000000
           5
       min_family:min_column                    @ 1970/01/01-00:00:00.000000
           3
       sum_family:sum_column                    @ 1970/01/01-00:00:00.000000
           8
   

3. 선택사항: Google Cloud 콘솔에서 SQL을 사용하여 테이블을 쿼리합니다.

   1. Google Cloud 콘솔에서 Bigtable 인스턴스 페이지를 엽니다.

      인스턴스 목록으로 이동

   2. 목록에서 counters-quickstart-instance를 선택합니다.

   3. 탐색 메뉴에서 Bigtable Studio를 클릭합니다.

   4. 편집기 탭을 클릭합니다.

   5. 다음 쿼리를 편집기에 붙여넣습니다.

      SELECT * FROM `counters_quickstart_table`
      

   6. 실행을 클릭합니다. 쿼리 결과는 결과 테이블에 표시되며 다음과 유사합니다.

   _key	max_family	min_family	sum_family
   row-key1	{ "max_column": 5 }	{ "min_column": 5 }	{ "sum_column": 8 }