데이터베이스 만들기 및 연결

이 페이지에서는 PostgreSQL용 AlloyDB에서 첫 번째 데이터베이스를 만들고 이 데이터베이스에 연결하는 과정을 안내합니다.

이 빠른 시작의 끝부분에 제공된 안내에서는 이 새 데이터베이스를 정리하는 방법을 설명합니다. 이 페이지의 마지막 부분에서는 자체 애플리케이션에서 AlloyDB를 사용하는 방법을 자세히 알아볼 수 있는 다음 단계를 설명합니다.

시작하기 전에

콘솔

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  5. Verify that billing is enabled for your Google Cloud project.

  6. PostgreSQL용 AlloyDB를 만들고 여기에 연결하는 데 필요한 Cloud API를 사용 설정합니다.

    API 사용 설정

    1. 프로젝트 확인 단계에서 다음을 클릭하여 변경할 프로젝트의 이름을 확인합니다.

    2. API 사용 설정 단계에서 사용 설정을 클릭하여 다음을 사용 설정합니다.

      • AlloyDB API
      • Compute Engine API
      • Cloud Resource Manager API
      • Service Networking API

      AlloyDB와 동일한 Google Cloud 프로젝트에 있는 VPC 네트워크를 사용하여 AlloyDB에 대한 네트워크 연결을 구성하려면 Service Networking API가 필요합니다.

      다른 Google Cloud 프로젝트에 있는 VPC 네트워크를 사용하여 AlloyDB에 대한 네트워크 연결을 구성하려면 Compute Engine API와 Cloud Resource Manager API가 필요합니다.

  7. AlloyDB에 연결하는 방법 선택

gcloud

  1. Google Cloud 프로젝트를 만들거나 기존 프로젝트를 사용합니다.

    gcloud projects create PROJECT_ID --set-as-default
# For an existing project
gcloud config set project PROJECT_ID

    다음을 바꿉니다.

    • PROJECT_ID: 프로젝트의 영구 식별자입니다.

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

  3. AlloyDB, Compute Engine, Resource Manager API를 사용 설정합니다.

    gcloud services enable alloydb.googleapis.com
gcloud services enable compute.googleapis.com
gcloud services enable cloudresourcemanager.googleapis.com

  4. AlloyDB와 동일한 Google Cloud 프로젝트에 있는 VPC 네트워크를 사용하여 AlloyDB에 대한 네트워크 연결을 구성하려면 프로젝트에서 Service Networking API를 사용 설정합니다.

    gcloud services enable servicenetworking.googleapis.com

  5. 다른 Google Cloud 프로젝트에 있는 VPC 네트워크를 사용하여 AlloyDB에 대한 네트워크 연결을 구성하려면 해당 프로젝트에서 공유 VPC 및 비공개 서비스 액세스를 구성할 수 있도록 프로젝트에서 Compute Engine 및 Service Networking API가 사용 설정되어 있는지 확인합니다.

    gcloud services list

클러스터 및 클러스터의 기본 인스턴스 만들기

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 클러스터 만들기를 클릭합니다.

  3. 클러스터 구성에서 다음 단계를 수행합니다.

    1. 클러스터 ID 필드에 my-cluster를 입력합니다.

    2. 비밀번호를 입력합니다. 이 빠른 시작에서 이 비밀번호를 사용하므로 기록해 둡니다.

    3. 기본 데이터베이스 버전을 유지합니다.

    4. 위치의 리전 드롭다운에서 us-central1 (Iowa) 리전을 선택합니다.

  4. 기본 인스턴스 구성에서 다음 단계를 수행합니다.

    1. 인스턴스 ID 필드에 my-cluster-primary를 입력합니다.

    2. 영역 가용성에서 단일 영역을 클릭합니다.

    3. 머신 유형 드롭다운에서 2 vCPU, 16 GB 머신 유형을 선택합니다.

    4. 연결의 네트워크 드롭다운에서 default 네트워크를 선택합니다.

      비공개 액세스 연결이 있으면 클러스터 만들기 단계로 계속 진행합니다. 그렇지 않은 경우 연결 설정을 클릭하고 다음 단계를 수행합니다.

      1. IP 범위 할당에서 자동 할당된 IP 범위 사용을 클릭합니다.

      2. 계속을 클릭한 후 연결 만들기를 클릭합니다.

    5. 네트워크 보안에서 기본 설정을 유지합니다.

  5. 클러스터 만들기를 클릭합니다. AlloyDB에서 클러스터를 만들고 기본 클러스터 개요 페이지에 표시하는 데 몇 분 정도 걸릴 수 있습니다.

인스턴스에 연결 및 데이터베이스 만들기

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터 이름 my-cluster를 클릭합니다.

  3. 탐색창에서 AlloyDB Studio를 클릭합니다.

  4. AlloyDB Studio에 로그인 페이지에서 다음 단계를 수행합니다.

    1. 데이터베이스 인증 방법을 선택합니다.

    2. postgres 데이터베이스를 선택합니다.

    3. 인증을 클릭합니다. 탐색기 창에 postgres 데이터베이스의 객체 목록이 표시됩니다.

  5. 데이터베이스를 만들려면 편집기 1 탭에 다음 문을 입력한 후 실행을 클릭합니다.

    CREATE DATABASE guestbook;

    Statement executed successfully 메시지가 결과 창에 표시되면 데이터베이스가 생성된 것입니다.

guestbook 데이터베이스에 연결

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터 이름 my-cluster를 클릭합니다.

  3. 탐색창에서 AlloyDB Studio를 클릭합니다.

  4. AlloyDB Studio에 로그인 페이지에서 다음 단계를 수행합니다.

    1. guestbook 데이터베이스를 선택합니다.

    2. postgres 사용자를 선택합니다.

    3. 클러스터 및 클러스터의 기본 인스턴스 만들기에서 만든 비밀번호를 입력합니다.

    4. 인증을 클릭합니다. 탐색기 창에 guestbook 데이터베이스의 객체 목록이 표시됩니다.

데이터베이스 연결 확인

  1. guestbook 데이터베이스에 연결의 단계를 수행합니다.

  2. guestbook 데이터베이스에 샘플 데이터를 삽입하려면 편집기 1 탭에 다음을 입력합니다.

    CREATE TABLE entries (guestName VARCHAR(255),
                      content VARCHAR(255),
                      entryID SERIAL PRIMARY KEY);
INSERT INTO entries (guestName, content) values ('Alex', 'I got here!');
INSERT INTO entries (guestName, content) values ('Kai', 'Me too!');

  3. 실행을 클릭합니다. 결과 창의 Statement executed successfully 메시지는 데이터가 데이터베이스에 삽입되었음을 나타냅니다.

  4. 다른 명령어를 실행할 수 있도록 편집기 1 탭에서 텍스트를 삭제하려면 지우기를 클릭합니다.

  5. 데이터베이스의 모든 항목을 선택하려면 편집기 1 탭에 다음 쿼리를 입력합니다.

    SELECT * FROM entries;

  6. 실행을 클릭합니다. 다음과 유사한 출력이 결과 창에 표시됩니다.

        guestname     | content     | entryid
    --------------+-------------+---------
    Alex          | I got here! | 1
    Kai           | Me too!     | 2

삭제

이 페이지에서 사용한 리소스 비용이 Google Cloud 계정에 청구되지 않도록 하려면 다음 단계를 수행합니다.

  1. Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터 이름 my-cluster를 클릭합니다.

  3. 클러스터 삭제를 클릭합니다.

  4. my-cluster 클러스터 삭제에서 my-cluster를 입력하여 클러스터를 삭제할 것인지 확인합니다.

  5. 삭제를 클릭합니다.

  6. 클러스터를 만들 때 비공개 연결을 만든 경우 Google Cloud 콘솔의 네트워킹 페이지로 이동하여 VPC 네트워크 삭제를 클릭합니다.

다음 단계