Ruby Hello World
이 코드 샘플은 Ruby에서 실행되는 'hello world' 애플리케이션입니다. 이 샘플은 다음 작업을 완료하는 방법을 보여줍니다.
- 인증 설정
- Bigtable 인스턴스에 연결
- 새 테이블 만들기
- 테이블에 데이터 쓰기
- 데이터 다시 읽기
- 테이블 삭제
인증 설정
로컬 개발 환경에서 이 페이지의 Ruby 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
Google Cloud CLI를 설치합니다.
외부 ID 공급업체 (IdP)를 사용하는 경우 먼저 제휴 ID로 gcloud CLI에 로그인해야 합니다.
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
If an authentication error is returned, and you are using an external identity provider (IdP), confirm that you have signed in to the gcloud CLI with your federated identity.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
샘플 실행
이 코드 샘플은 Ruby용 Google Cloud 클라이언트 라이브러리의 Bigtable용 Ruby 클라이언트 라이브러리를 사용하여 Bigtable과 통신합니다.
이 샘플 프로그램을 실행하려면 GitHub에서 샘플 안내를 따르세요.
Cloud 클라이언트 라이브러리를 Bigtable과 함께 사용
샘플 애플리케이션을 Bigtable에 연결하여 몇 가지 간단한 작업을 보여줍니다.
클라이언트 라이브러리 필요
샘플에는 Bigtable
모듈을 제공하는 google/cloud/bigtable
이 필요합니다.
Bigtable에 연결
애플리케이션에서 사용할 변수를 설정하고 'YOUR_PROJECT_ID'를 유효한 Google Cloud 프로젝트의 ID로 바꿉니다. 그런 다음 Bigtable에 연결하는 데 사용할 새 Bigtable
객체를 만듭니다.
테이블 만들기
테이블이 이미 있는지 확인합니다. 없는 경우 create_table()
메서드를 호출하여 Table
객체를 만듭니다. 테이블에는 각 값별로 한 버전만 보관하는 column family가 한 개 있습니다.
테이블에 행 쓰기
그런 다음 인사말 문자열 배열을 사용하여 테이블의 새 행을 만듭니다. 각 인사말에 대해 테이블의 new_mutation_entry()
메서드를 사용하여 항목을 만듭니다. 그런 다음 항목의 set_cell()
메서드를 사용하여 column family, column qualifier, 인사말, 타임스탬프를 항목에 할당합니다. 마지막으로 테이블의 mutate_row()
메서드를 사용하여 테이블에 해당 항목을 씁니다.
필터 만들기
작성한 데이터를 읽기 전에 Bigtable이 반환하는 데이터를 제한하는 필터를 생성합니다. 테이블에 가비지로 수집되지 않은 이전 버전이 있더라도 이 필터는 각 값의 최신 버전만 반환하도록 Bigtable에 지시합니다.
row key를 통해 행 읽기
행 객체를 만든 다음 read_row()
메서드를 호출하고 필터를 전달하여 이 행에서 각 값의 버전 하나를 가져옵니다.
모든 테이블 행 검색
read_rows()
메서드를 호출하고 필터를 전달하여 테이블의 모든 행을 가져옵니다. 필터를 전달했으므로 Bigtable은 각 값별로 버전 1개만 반환합니다.
테이블 삭제
테이블의 delete()
메서드를 사용하여 테이블을 삭제합니다.
요약 정리
다음은 주석이 없는 전체 코드 샘플입니다.