cbt CLI를 사용하여 인스턴스를 만들고 데이터 쓰기
Bigtable에 대해 알아보려면 빠른 시작을 통해 프로덕션 환경에서 대규모로 사용할 기본 사항을 익힐 수 있습니다.
이 빠른 시작에서는 다음 작업을 수행합니다.
- Bigtable 인스턴스에 연결
- 기본 관리 작업 수행
- 테이블에 데이터 쓰기
- 테이블에서 데이터 읽기
시작하기 전에
- Google Cloud 계정에 로그인합니다. Google Cloud를 처음 사용하는 경우 계정을 만들고 Google 제품의 실제 성능을 평가해 보세요. 신규 고객에게는 워크로드를 실행, 테스트, 배포하는 데 사용할 수 있는 $300의 무료 크레딧이 제공됩니다.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
Google 계정에 역할을 부여합니다. 다음 각 IAM 역할에 대해 다음 명령어를 한 번씩 실행합니다.
roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
PROJECT_ID
를 프로젝트 ID로 바꿉니다.EMAIL_ADDRESS
를 이메일 주소로 바꿉니다.ROLE
을 각 개별 역할로 바꿉니다.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
Create or select a Google Cloud project.
-
Create a Google Cloud project:
gcloud projects create PROJECT_ID
Replace
PROJECT_ID
with a name for the Google Cloud project you are creating. -
Select the Google Cloud project that you created:
gcloud config set project PROJECT_ID
Replace
PROJECT_ID
with your Google Cloud project name.
-
-
Enable the Cloud Bigtable and Cloud Bigtable Admin APIs:
gcloud services enable bigtable.googleapis.com
bigtableadmin.googleapis.com -
Google 계정에 역할을 부여합니다. 다음 각 IAM 역할에 대해 다음 명령어를 한 번씩 실행합니다.
roles/bigtable.admin
gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
PROJECT_ID
를 프로젝트 ID로 바꿉니다.EMAIL_ADDRESS
를 이메일 주소로 바꿉니다.ROLE
을 각 개별 역할로 바꿉니다.
- 다음 명령어를 실행하여
cbt
CLI를 설치합니다.gcloud components install cbt
Bigtable 인스턴스를 만듭니다.
Google Cloud Console에서 인스턴스 만들기 페이지를 엽니다.
인스턴스 이름에
Quickstart instance
를 입력합니다.인스턴스 ID에
quickstart-instance
를 입력합니다.계속을 클릭합니다.
스토리지 유형으로 SSD를 선택합니다.
계속을 클릭합니다.
클러스터 ID에
quickstart-instance-c1
을 입력합니다.리전으로 가까운 리전을 선택합니다.
영역에서 모두를 선택합니다.
노드 확장 모드에서 수동 할당을 선택합니다.
수량에서 1을 선택합니다.
만들기를 클릭하여 인스턴스를 만듭니다.
내 인스턴스에 연결
.cbtrc
파일을 만들고PROJECT_ID
를 Bigtable 인스턴스를 만든 프로젝트의 ID로 바꿔 프로젝트와 인스턴스를 사용하도록cbt
CLI를 구성합니다.echo project = PROJECT_ID >> ~/.cbtrc && echo instance = quickstart-instance >> ~/.cbtrc
.cbtrc
파일을 올바르게 설정했는지 확인합니다.cat ~/.cbtrc
터미널에는
.cbtrc
파일의 콘텐츠가 표시됩니다. 이는 다음과 유사합니다.project = PROJECT_ID instance = quickstart-instance
이제 인스턴스에서
cbt
CLI를 사용할 수 있습니다.
데이터 읽기 및 쓰기
Bigtable은 행을 포함하는 테이블에 데이터를 저장합니다. 각 행은 row key로 식별됩니다.
행의 데이터는 열의 그룹인 column family로 구성됩니다. column qualifier는 column family 내의 단일 열을 식별합니다.
행과 열의 교차점에는 타임스탬프가 지정된 셀이 여러 개 있을 수 있습니다.
이름이
my-table
인 테이블을 만듭니다.cbt createtable my-table
테이블을 나열합니다.
cbt ls
이 명령어는 다음과 비슷한 출력을 표시합니다.
my-table
이름이
cf1
인 column family 1개를 추가합니다.cbt createfamily my-table cf1
column family를 나열합니다.
cbt ls my-table
이 명령어는 다음과 비슷한 출력을 표시합니다.
Family Name GC Policy ----------- --------- cf1 <never>
column family
cf1
및 column qualifierc1
을 사용하여test-value1
및test-value2
값을r1
행에 입력합니다.cbt set my-table r1 cf1:c1=test-value1 cbt set my-table r1 cf1:c1=test-value2
cbt read
명령어를 사용하여 테이블에 추가한 데이터를 읽습니다.cbt read my-table
다음과 유사한 출력이 셸에 표시됩니다.
---------------------------------------- r1 cf1:c1 @ 2023/03/22-06:56:11.323000 "test-value1" cf1:c1 @ 2023/03/22-06:56:04.361000 "test-value2"
r1
행의 동일한 열에 타임스탬프가 지정된 두 개의 값이 저장됩니다.
삭제
이 빠른 시작에서 사용한 리소스의 비용이 Google Cloud 계정에 청구되지 않도록 하려면 인스턴스를 삭제합니다. .cbtrc
파일을 삭제하면 다른 프로젝트에서 작업할 수 있습니다.
my-table
테이블을 삭제합니다.cbt deletetable my-table
인스턴스를 삭제합니다.
cbt deleteinstance quickstart-instance
.cbtrc
파일을 삭제합니다.rm ~/.cbtrc
선택사항: gcloud CLI에서 사용자 인증 정보를 취소합니다.
gcloud auth revoke
다음 단계
- Bigtable Codelab 살펴보기
cbt
CLI 참조 문서 보기- 사기 감지 사용 사례의 샘플 소스 코드 참조하기
- Hello World 애플리케이션을 C#, C++, Go, 자바, Node.js, PHP, Python, Ruby로 또는자바용 HBase 클라이언트를 사용하여 작성