Ruby Hello World
이 코드 샘플은 Ruby에서 실행되는 'hello world' 애플리케이션입니다. 이 샘플은 다음 작업을 완료하는 방법을 보여줍니다.
- 인증 설정
- Bigtable 인스턴스에 연결
- 새 테이블 만들기
- 테이블에 데이터 쓰기
- 데이터 다시 읽기
- 테이블 삭제
인증 설정
이 페이지의 Ruby 샘플을 로컬 개발 환경에서 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
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.
자세한 내용은 다음을 참조하세요: 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()
메서드를 사용하여 테이블을 삭제합니다.
요약 정리
다음은 주석이 없는 전체 코드 샘플입니다.