1. 개요
이 Codelab에서는 AlloyDB를 설정하는 간단하고 쉬운 방법을 보여줍니다.

빌드할 항목
이 과정에서 원클릭 설치로 AlloyDB 인스턴스와 클러스터를 만들고 향후 프로젝트에서 빠르게 설정하는 방법도 알아봅니다.
요구사항
2. 시작하기 전에
프로젝트 만들기
- Google Cloud 콘솔의 프로젝트 선택기 페이지에서 Google Cloud 프로젝트를 선택하거나 만듭니다.
- Cloud 프로젝트에 결제가 사용 설정되어 있어야 하므로 프로젝트에 결제가 사용 설정되어 있는지 확인하는 방법을 알아보세요.
- Google Cloud에서 실행되는 명령줄 환경인 Cloud Shell을 사용합니다. Google Cloud 콘솔 상단에서 Cloud Shell 활성화를 클릭합니다.

- Cloud Shell에 연결되면 다음 명령어를 사용하여 인증이 완료되었고 프로젝트가 해당 프로젝트 ID로 설정되었는지 확인합니다.
gcloud auth list
- Cloud Shell에서 다음 명령어를 실행하여 gcloud 명령어가 프로젝트를 알고 있는지 확인합니다.
gcloud config list project
- 프로젝트가 설정되지 않은 경우 다음 명령어를 사용하여 설정합니다.
gcloud config set project <YOUR_PROJECT_ID>
- 필요한 API 사용 설정: 링크를 따라 API를 사용 설정합니다.
또는 gcloud 명령어를 사용할 수 있습니다. gcloud 명령어 및 사용법은 문서를 참조하세요.
3. 비즈니스 데이터 및 AI에 AlloyDB를 사용해야 하는 이유
PostgreSQL용 AlloyDB는 단순한 관리형 Postgres 서비스가 아닙니다. AI 시대를 위해 설계된 엔진의 근본적인 현대화입니다. 표준 데이터베이스와 비교하여 독립적인 이유는 다음과 같습니다.
- 하이브리드 트랜잭션 및 분석 처리 (HTAP)
대부분의 데이터베이스에서는 분석을 위해 데이터를 데이터 웨어하우스로 이동해야 합니다. AlloyDB에는 관련 데이터를 열 스토어 인메모리에 자동으로 보관하는 기본 제공 열 기반 엔진이 있습니다. 따라서 분석 쿼리가 표준 PostgreSQL보다 최대 100배 빨라 복잡한 ETL 파이프라인 없이 운영 데이터에 대해 실시간 비즈니스 인텔리전스를 실행할 수 있습니다.
- 기본 AI 통합:
AlloyDB는 데이터와 생성형 AI 간의 격차를 해소합니다. google_ml_integration 확장 프로그램을 사용하면 SQL 쿼리 내에서 직접 Vertex AI 모델 (예: Gemini)을 호출할 수 있습니다. 즉, 데이터 보안을 보장하고 지연 시간을 최소화하면서 감정 분석, 번역 또는 엔티티 추출을 표준 데이터베이스 트랜잭션으로 실행할 수 있습니다.
- 우수한 벡터 검색:
표준 PostgreSQL은 pgvector를 사용하는 반면 AlloyDB는 Google Research에서 개발한 ScaNN 색인 (확장 가능한 최근접 이웃)을 사용하여 성능을 크게 향상합니다. 이를 통해 다른 Postgres 제품에서 제공되는 표준 HNSW 색인에 비해 대규모로 훨씬 빠른 벡터 유사성 검색과 더 높은 재현율을 제공합니다. 이를 통해 고성능 RAG (검색 증강 생성) 애플리케이션을 네이티브로 빌드할 수 있습니다.
- 규모에 따른 성능:
AlloyDB는 표준 PostgreSQL보다 최대 4배 빠른 트랜잭션 성능을 제공합니다. 컴퓨팅과 스토리지가 분리되어 있으므로 독립적으로 확장할 수 있습니다. 스토리지 레이어는 지능적이며 미리 쓰기 로깅 (WAL) 처리를 처리하여 기본 인스턴스에서 작업을 오프로드합니다.
- 엔터프라이즈 사용 가능 여부:
AlloyDB는 유지보수를 포함하여 99.99% 업타임 SLA를 제공합니다. PostgreSQL 호환 데이터베이스의 이러한 수준의 안정성은 빠른 장애 복구와 스토리지 내구성을 보장하는 클라우드 네이티브 아키텍처를 통해 달성됩니다.
4. AlloyDB 설정
이 실습에서는 AlloyDB를 테스트 데이터의 데이터베이스로 사용합니다. 클러스터를 사용하여 데이터베이스, 로그와 같은 모든 리소스를 보유합니다. 각 클러스터에는 데이터에 대한 액세스 포인트를 제공하는 기본 인스턴스가 있습니다. 테이블에는 실제 데이터가 저장됩니다.
테스트 데이터 세트가 로드될 AlloyDB 클러스터, 인스턴스, 테이블을 만들어 보겠습니다.
- 아래 버튼을 클릭하거나 Google Cloud 콘솔 사용자가 로그인한 브라우저에 링크를 복사합니다.
- 이 단계를 완료하면 저장소가 로컬 Cloud Shell 편집기에 복제되며 프로젝트 폴더에서 아래 명령어를 실행할 수 있습니다 (프로젝트 디렉터리에 있는지 확인하는 것이 중요함).
sh run.sh
- 이제 UI를 사용하여 터미널에서 링크를 클릭하거나 터미널에서 '웹에서 미리보기' 링크를 클릭합니다.
- 시작하려면 프로젝트 ID, 클러스터, 인스턴스 이름을 입력하세요.
- 로그가 스크롤되는 동안 커피를 마시세요. 여기에서 백그라운드에서 어떻게 작동하는지 자세히 알아볼 수 있습니다.
5. 설정 그림

6. 삭제
이 체험판 실습이 끝나면 AlloyDB 클러스터와 인스턴스를 삭제해야 합니다.
인스턴스와 함께 클러스터를 정리해야 합니다.
7. 축하합니다
이제 출발해도 돼!
AlloyDB를 사용하여 데이터를 빠르고 쉽게 설정해 시작하세요.