HBase 셸을 사용한 빠른 시작

이 페이지에서는 HBase 셸을 사용하여 Cloud Bigtable 인스턴스 연결, 기본 관리 작업 수행, 테이블에서 데이터 읽기 및 쓰기를 수행하는 방법에 대해 설명합니다.

참고: HBase 셸 또는 cbt 도구를 사용하여 명령줄에서 Cloud Bigtable 작업을 수행할 수 있습니다. HBase 셸을 잘 알고 선호하는 경우 HBase 셸을 사용하세요. 그렇지 않은 경우 종속 항목 및 설치 단계가 적은 cbt 도구를 사용하는 것이 좋습니다. cbt 도구는 Google Cloud SDK의 구성요소입니다.

HBase 셸을 사용하지 않으려면 대신 빠른 시작: cbt 도구 사용을 따르세요.

이 빠른 시작에서는 Google Cloud Console의 Cloud Shell을 사용하여 HBase 셸을 실행합니다. 성능 향상을 위해 대신 머신에 HBase 셸을 설치할 수 있습니다.

시작하기 전에

1. Google Cloud Console의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.

   참고: 이 절차에서 생성한 리소스를 유지하지 않으려면 기존 프로젝트를 선택하지 말고 프로젝트를 새로 만드세요. 작업이 끝나면 프로젝트를 삭제하여 프로젝트와 관련된 모든 리소스를 삭제할 수 있습니다.

   프로젝트 선택기 페이지로 이동

   중요: 사용할 이름은 4~30자(영문 기준) 사이여야 합니다. 이름을 입력하면 양식에서 추천 프로젝트 ID가 표시됩니다. 이 ID는 편집 가능합니다. 사용할 프로젝트 ID는 6~30자 사이여야 하고, 첫 번째 문자는 소문자여야 합니다. 나머지 문자에는 대시, 소문자 또는 숫자를 사용할 수 있지만, 마지막 문자에 대시를 사용할 수 없습니다. 일부 리소스 식별자(예: 프로젝트 ID)가 해당 프로젝트 종료 이후에도 보존될 수 있다는 점을 유의하세요. 따라서 민감한 정보는 리소스 식별자에 포함하지 않는 것이 좋습니다.
   이름 지정 가이드라인을 참조하세요.

2. Cloud 프로젝트에 결제가 사용 설정되어 있는지 확인합니다. 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.

3. Cloud Bigtable and Cloud Bigtable Admin API를 사용 설정합니다.

   API 사용 설정

Cloud Bigtable 인스턴스 만들기

1. Google Cloud Console에서 인스턴스 만들기 페이지를 엽니다.

   인스턴스 만들기 페이지 열기

   

2. 인스턴스 이름에 Quickstart instance를 입력합니다.

3. 인스턴스 ID에 quickstart-instance를 입력합니다.

4. 스토리지 유형으로 SSD를 선택합니다.

5. 클러스터 ID에 quickstart-instance-c1을 입력합니다.

6. 리전으로 us-east1을 선택합니다.

7. 영역으로 us-east1-c를 선택합니다.

8. 만들기를 클릭하여 인스턴스를 만듭니다.

내 인스턴스에 연결

1. Cloud Shell에서 터미널 창을 엽니다.

   Cloud Shell에서 열기

2. 자바용 Cloud Bigtable HBase 클라이언트에서 HBase 셸을 사용하려면 자바 8 런타임 환경을 설치해야 합니다. 다른 자바 버전은 지원되지 않습니다. 다음 명령어를 실행하여 자바 8 환경을 설치하고 설정합니다.

   sudo apt-get update
   sudo apt-get install openjdk-8-jdk-headless
   export JAVA_HOME=$(update-alternatives --list java | tail -1 | sed -E 's/\/bin\/java//')

3. HBase 셸 파일이 포함된 저장소를 클론한 후 HBase 셸 디렉터리로 변경합니다.

   git clone https://github.com/GoogleCloudPlatform/cloud-bigtable-examples.git
   cd cloud-bigtable-examples/quickstart

   참고: ./quickstart.sh를 실행하기 전에 구성된 hbase-site.xml 파일이 없는지 확인하세요.

4. HBase 셸을 시작합니다.

   ./quickstart.sh

   참고: 인스턴스 ID를 입력하라는 메시지가 표시되면 quickstart-instance 옆에 있는 숫자를 입력하고 Enter 키를 누르세요.

이제 연결되었습니다!

데이터 읽기 및 쓰기

Cloud Bigtable은 행을 포함하는 테이블에 데이터를 저장합니다. 각 행은 row key로 식별됩니다.

행의 데이터는 열의 그룹인 column family로 구성됩니다. column qualifier는 column family 내의 단일 열을 식별합니다.

행과 열의 교차점에는 시간별로 기록된 값이 여러 개 존재할 수 있습니다. 이러한 각 버전을 셀이라고 합니다.

1. cf1인 column family가 하나 포함된 이름이 my-table인 테이블을 만듭니다.

   create 'my-table', 'cf1'
   

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

   0 row(s) in 1.5210 seconds
   
   => Hbase::Table - my-table
   

2. 테이블을 나열합니다.

   list
   

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

   TABLE
   my-table
   1 row(s) in 1.3580 seconds
   
   => ["my-table"]
   

3. column family cf1 및 column qualifier c1을 사용하여 test-value 값을 r1 행에 입력합니다.

   put 'my-table', 'r1', 'cf1:c1', 'test-value'
   

4. scan 명령어를 사용하여 테이블을 스캔하고 추가한 데이터를 읽습니다.

   scan 'my-table'
   

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

   ROW      COLUMN+CELL
    r1      column=cf1:c1, timestamp=1430687836046, value=test-value
   1 row(s) in 0.6260 seconds
   

5. my-table 테이블을 삭제합니다.

   disable 'my-table'
   drop 'my-table'
   

6. exit를 입력하고 Enter 키를 눌러 HBase 셸을 종료합니다. 종료 후 일련의 로그 메시지가 표시되는데, 이는 정상입니다.

삭제

이 빠른 시작에서 사용한 리소스의 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 따르세요.

1. Cloud Console에서 Cloud Bigtable 인스턴스 목록을 엽니다.

   인스턴스 목록 열기

2. 빠른 시작 인스턴스를 클릭합니다.
3. 인스턴스 삭제를 클릭합니다.

   

4. quickstart-instance를 입력한 후 삭제를 클릭하여 인스턴스를 삭제합니다.

다음 단계

• Cloud Bigtable 개요 읽어보기
• Cloud Bigtable Codelab 진행하기
• 코드 샘플 살펴보기
• 스키마 설계 방법에 대해 알아봅니다.
• 머신에 HBase 셸을 설치합니다.