Cloud SQL Studio를 사용하여 데이터 관리

이 페이지에서는 Google Cloud 콘솔에서 Cloud SQL Studio를 사용하여 Cloud SQL 데이터를 탐색하고 관리하는 방법을 설명합니다.

Cloud SQL Studio를 사용하면 승인된 사용자가 SQL 데이터베이스와 직접 상호작용하고 Google Cloud 콘솔에서 SQL 쿼리를 실행하여 데이터에 액세스하고 조작할 수 있습니다. 테이블 및 색인 만들기, 테이블 수정, 뷰 설정과 같은 SQL 명령줄 클라이언트에서 수행할 다양한 작업을 수행할 수 있습니다.

Cloud SQL Studio에는 쿼리 편집기 및 SQL 쿼리 결과 테이블과 통합되는 탐색기 창이 포함되어 있습니다. 이 인터페이스 하나에서 DDL, DML, DQL 문을 실행할 수 있습니다. 예를 들어 서드 파티 데이터베이스 쿼리 도구를 구성하는 대신 Cloud SQL Studio의 쿼리 편집기를 사용하여 테이블을 만들고 데이터를 쿼리할 수 있습니다.

탐색기 창을 사용하여 데이터베이스 객체를 보고 상호작용할 수 있습니다. 다음과 같이 데이터베이스 객체를 만들고 변경하고 삭제할 수 있습니다.

• 테이블
• 열
• 색인 및 키
• 함수

또한 탐색기 창을 사용하여 테이블에 대한 SELECT 쿼리를 시드할 수 있습니다.

Cloud SQL을 처음 사용하는 경우 Cloud SQL 개요를 참조하세요.

필수 역할 및 권한

이 문서의 태스크를 완료하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Cloud SQL Studio 사용자(roles/cloudsql.studioUser) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

커스텀 역할이나 다른 사전 정의된 역할을 통해 필요한 권한을 얻을 수도 있습니다.

Cloud SQL Studio를 사용하려면 다음 권한이 있어야 합니다.

• cloudsql.databases.list
• cloudsql.instances.executeSql
• cloudsql.instances.get
• cloudsql.instances.login(IAM 데이터베이스 인증을 사용하는 경우에만 필요)
• cloudsql.users.list

또한 인증에 사용할 데이터베이스에 대한 데이터베이스 수준 권한과 사용하고 있는 권한이 있는 데이터베이스 사용자의 비밀번호가 있는지 확인합니다.

Cloud SQL Studio에 인증

Cloud SQL Studio에서 데이터베이스에 액세스하려면 먼저 데이터베이스 인증 방법을 선택해야 합니다. Cloud SQL Studio를 사용하여 데이터베이스에 로그인하려면 다음 인증 유형 중 하나를 사용하면 됩니다.

• IAM 데이터베이스 인증. 이 인증 유형을 사용하면 추가 비밀번호를 관리하지 않고도 데이터베이스와 Cloud SQL Studio에 로그인할 수 있습니다. IAM 그룹 인증을 활용하여 조직의 여러 사용자에 대한 데이터베이스 액세스 및 권한을 동시에 관리할 수도 있습니다.

• 기본 제공 데이터베이스 인증. MySQL 사용자 계정과 사용자 인증 정보를 사용하여 Cloud SQL Studio에서 데이터베이스에 연결합니다.

데이터 탐색

탐색기 창에 액세스하려면 다음 단계를 수행합니다.

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

   Cloud SQL 인스턴스로 이동

2. 목록에서 인스턴스를 선택합니다.
3. 탐색 메뉴에서 Cloud SQL Studio를 클릭합니다.
4. 데이터베이스 이름, 사용자 이름, 비밀번호를 사용하여 Cloud SQL Studio에 로그인합니다. 탐색기 창에 데이터베이스의 객체 목록이 표시됩니다.

데이터 만들기, 수정, 쿼리

SQL 편집기를 사용하면 DDL, DML, DQL 문의 조합을 실행할 수 있습니다. 쿼리를 직접 작성하거나 탐색기를 사용하여 쿼리 편집기를 템플릿으로 채울 수 있습니다.

데이터를 구조화, 수정 또는 쿼리하려면 다음 단계를 수행합니다.

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

   Cloud SQL 인스턴스로 이동

2. 목록에서 인스턴스를 선택합니다.
3. 탐색 메뉴에서 Cloud SQL Studio를 클릭합니다.
4. 데이터베이스 이름, 사용자 이름, 비밀번호를 사용하여 Cloud SQL Studio에 로그인합니다.
5. 다음 방법 중 하나를 사용하여 쿼리를 작성합니다.
   • 자체 쿼리를 작성하려면 다음 단계를 수행합니다.
     1. add를 클릭하여 새 탭을 엽니다.
     2. 쿼리 편집기가 나타나면 쿼리를 작성합니다.
   • 템플릿으로 시작하는 쿼리를 작성하려면 다음 단계를 수행합니다.
     1. 탐색기 창의 데이터베이스 객체 또는 컬렉션 옆에 있는 more_vert 작업 보기를 클릭합니다. 사용 가능한 작업이 하나 이상 표시됩니다.
     2. 작업을 클릭합니다. 쿼리 편집기는 템플릿으로 채워집니다.
     3. 템플릿의 자리표시자를 바꿉니다.
6. 다음 방법 중 하나를 사용하여 쿼리를 실행합니다.
   • 쿼리 편집기에서 모든 문을 실행하려면 실행을 클릭합니다.
   • 특정 문을 실행하려면 하나 또는 여러 문을 선택하고 선택한 문 실행을 클릭합니다.
7. 쿼리 결과가 결과 탭에 표시됩니다. 여러 개의 결과 세트를 사용할 수 있는 경우 모든 결과 드롭다운 목록에서 결과를 선택합니다.

제한사항

• Cloud SQL Studio는 경량형 쿼리를 지원합니다. 10MB를 초과하는 응답은 잘릴 수 있습니다. Cloud SQL Studio에서 부분 결과가 반환된 지점을 표시합니다.
• 실행 중인 Cloud SQL 인스턴스에 대해서만 쿼리를 실행할 수 있습니다.
• Cloud SQL Studio는 외부 서버를 지원하지 않습니다.
• 5분을 초과하는 요청은 취소됩니다. SET SESSION MAX_EXECUTION_TIME을 사용하여 더 긴 쿼리 제한 시간을 설정하는 것은 지원되지 않습니다. MySQL용 Cloud SQL 5.6 및 5.7의 경우 장기 실행 DDL 문 타임아웃으로 인해 분리된 파일이나 테이블이 안전하게 롤백될 수 없습니다. 큰 테이블에서 ALTER TABLE와 같은 쿼리를 사용할 때는 주의해야 합니다.
• Cloud SQL Studio는 SQL 스크립트 실행이 완료된 후 데이터베이스 연결을 열린 상태로 유지하지 않습니다. 마찬가지로 편집기 탭은 공통 세션을 공유하지 않으며 모든 실행이 새 세션을 시작합니다.
• DML, DQL, DDL 문을 혼합하여 실행하면 DQL 쿼리의 결과만 표시됩니다.
• 브라우저 또는 브라우저 탭을 닫아도 Cloud SQL Studio의 쿼리 실행은 중지되지 않습니다. 쿼리는 완료되거나 제한 시간이 될 때까지 실행됩니다.

• Cloud SQL Studio는 BLOB 데이터에 대한 SELECT 쿼리 실행을 지원하지 않습니다. SQL 스크립트가 출력에 BLOB 열을 생성하면 SQL 스크립트가 오류와 함께 실패합니다.
• MySQL용 Cloud SQL 클라이언트 명령어는 지원되지 않으며 Cloud SQL Studio에서 실행할 수 없습니다.
• Cloud SQL Studio에서는 root 사용자가 지원되지 않습니다.
• MySQL용 Cloud SQL에 데이터베이스를 연결할 필요가 없더라도 Cloud SQL Studio에는 항상 데이터베이스가 필요합니다.
• 비밀번호가 비어 있는 사용자는 Cloud SQL Studio에서 지원되지 않습니다.
• USE database는 활성 쿼리 실행에서만 스테이트풀(Stateful)이며 gcloud CLI에서와 같이 작동하지 않습니다.
• 데이터베이스 사용자에게 localhost에서 연결할 수 있는 권한이 있어야 합니다.

• 여러 쿼리를 실행하는 중에 쿼리 중 하나가 실패하면 처음 발생한 오류가 반환됩니다. 오류 발생 이전 배치에 있는 일부 문은 성공적으로 실행되었을 수 있습니다. transaction 문으로 여러 쿼리를 래핑하여 이 문제를 방지할 수 있습니다.

  START TRANSACTION;
      YOUR_SQL_STATEMENTS
  COMMIT;
  

  다음을 바꿉니다.

  • YOUR_SQL_STATEMENTS: 이 쿼리의 일부로 실행할 문