Cloud Shell에서 PostgreSQL용 Cloud SQL에 연결

이 페이지에서는 PostgreSQL 인스턴스를 만들고 연결하는 방법과 Google Cloud 콘솔과 클라이언트를 사용하여 기본 SQL 작업을 수행하는 방법을 설명합니다. 이 빠른 시작에서 만든 리소스는 정리 단계까지 모든 단계를 적시에 완료한다고 가정할 때 1달러 미만의 비용이 소요됩니다.

시작하기 전에

  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.

    Go to project selector

  3. Make sure 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.

    Go to project selector

  5. Make sure that billing is enabled for your Google Cloud project.

  6. 필요한 Google Cloud API를 사용 설정합니다.

    콘솔

    Google Cloud 콘솔에서 API 페이지로 이동합니다.

    API로 이동

    Cloud SQL Admin API를 사용 설정합니다.

    gcloud

    다음 버튼을 클릭하여 브라우저에서 직접 Google Cloud 리소스에 대해 명령줄 액세스를 제공하는 Cloud Shell을 엽니다. Cloud Shell을 사용하여 이 빠른 시작 전체에 표시된 gcloud 명령어를 실행할 수 있습니다.

    Cloud Shell 열기

    Cloud Shell을 사용하여 다음과 같이 gcloud services enable 명령어를 실행해 이 빠른 시작에 필요한 API를 사용 설정합니다.

    gcloud services enable sqladmin.googleapis.com

    이 명령어는 다음 API를 사용 설정합니다.

    • Cloud SQL Admin API

Cloud SQL 인스턴스 만들기

이 빠른 시작에서는 Google Cloud 콘솔을 사용합니다. gcloud CLI, cURL 또는 PowerShell을 사용하려면 인스턴스 만들기를 참조하세요.

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. 인스턴스 만들기를 클릭합니다.
  3. PostgreSQL 선택을 클릭합니다.
  4. 인스턴스 ID 필드에 myinstance을 입력합니다.
  5. 비밀번호 필드에 postgres 사용자의 비밀번호를 입력합니다.
  6. 인스턴스 만들기를 클릭합니다.

    인스턴스 목록으로 돌아갑니다. 새 인스턴스를 바로 클릭하면 세부정보를 볼 수 있지만 초기화 및 시작 전에는 다른 작업을 사용할 수 없습니다.

내 인스턴스에 연결

이 빠른 시작에서는 Cloud Shell의 psql 클라이언트를 사용하여 인스턴스에 연결합니다. Cloud Shell은 원격 샌드박스 환경입니다.

  1. 선택사항: PostgreSQL의 로컬 인스턴스를 실행하는 경우 Cloud SQL 인스턴스에 연결하기 전에 중지하세요. 그렇지 않으면 address already in use와 같은 오류가 발생할 수 있습니다.
  2. Google Cloud 콘솔의 오른쪽 상단 모서리에 있는 Cloud Shell 아이콘(Cloud Shell 아이콘)을 클릭합니다.

    Cloud Shell 초기화가 완료되면 다음과 같은 메시지가 표시됩니다.

    Welcome to Cloud Shell! Type "help" to get started.
    Your Cloud Platform project in this session is set to sample-project.
    Use "gcloud config set project [PROJECT_ID]" to change to a different project.
    username@sample-project:~ (sample-project)$
    

  3. 선택사항: Google 사용자 인증 정보로 Google Cloud Platform에 액세스하도록 gcloud CLI를 승인하지 않은 경우 gcloud auth login 명령어를 사용합니다.
  4. Cloud Shell 프롬프트에서 Cloud SQL 인스턴스에 연결합니다. 다음과 같이 gcloud sql connect 명령어를 사용합니다. 인스턴스 이름이 다르면 인스턴스 이름을 바꿉니다.

    gcloud sql connect myinstance --user=postgres
  5. 대화상자에서 승인을 클릭하여 Cloud Shell에서 API를 호출할 수 있도록 승인합니다.

    다음 메시지가 표시됩니다.

    Allowlisting your IP for incoming connection for 5 minutes...done.
    

    이 메시지는 Cloud SQL 인스턴스의 공개 IP 주소에 수신 연결이 허용되고 있음을 나타냅니다. 이 메시지가 표시되면 비밀번호를 입력하라는 메시지가 표시됩니다.

  6. postgres 비밀번호를 입력합니다.

    psql 프롬프트가 표시됩니다.

데이터베이스 만들기 및 데이터 업로드

  1. Cloud SQL 인스턴스에 SQL 데이터베이스를 만듭니다.
    CREATE DATABASE guestbook;
  2. 다음 명령어를 입력하고 비밀번호를 지정하여 데이터베이스에 연결합니다.
    \connect guestbook;
  3. 데이터베이스에 샘플 데이터를 삽입합니다.
    CREATE TABLE entries (guestName VARCHAR(255), content VARCHAR(255),
                            entryID SERIAL PRIMARY KEY);
    INSERT INTO entries (guestName, content) values ('first guest', 'I got here!');
    INSERT INTO entries (guestName, content) values ('second guest', 'Me too!');
  4. 데이터를 검색합니다.
    SELECT * FROM entries;
    결과는 다음과 같습니다.
      guestname   |   content   | entryid
    --------------+-------------+---------
     first guest  | I got here! |       1
     second guest | Me too!     |       2
    (2 rows)
    postgres=>
    

삭제

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

  1. Google Cloud 콘솔에서 Cloud SQL 인스턴스 페이지로 이동합니다.

    Cloud SQL 인스턴스로 이동

  2. myinstance 인스턴스를 선택하여 인스턴스 세부정보 페이지를 엽니다.
  3. 페이지 상단의 아이콘 표시줄에서 삭제를 클릭합니다.
  4. 인스턴스 삭제 창에서 인스턴스 이름을 입력한 후 삭제를 클릭합니다.

선택적인 삭제 단계

이 빠른 시작을 진행하는 동안 사용 설정된 API를 사용하지 않을 때는 이를 사용 중지할 수 있습니다.

  • 이 빠른 시작 내에서 사용 설정된 API:
    • Cloud SQL Admin API
  1. Google Cloud 콘솔에서 API 페이지로 이동합니다.

    API로 이동

  2. Cloud SQL Admin API를 선택한 후 API 사용 중지 버튼을 클릭합니다.

다음 단계