빠른 시작: HBase 셸 사용

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

HBase 셸을 사용하지 않으려면 대신 빠른 시작: cbt 명령어 사용을 따르면 됩니다.

시작하기 전에

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

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

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

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

    API 사용 설정

Cloud Bigtable 인스턴스 만들기

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

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

    '인스턴스 만들기' 페이지의 스크린샷

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

  3. 인스턴스 IDquickstart-instance를 입력합니다.

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

  5. 클러스터 IDquickstart-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
  4. HBase 셸을 시작합니다.

    ./quickstart.sh

이제 연결되었습니다!

데이터 읽기 및 쓰기

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를 입력한 후 삭제를 클릭하여 인스턴스를 삭제합니다.

다음 단계