이 페이지는 Cloud Translation API를 통해 번역되었습니다.

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

MySQL | PostgreSQL | SQL Server

이 페이지에서는 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.users.list

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

Cloud SQL Studio에 인증

Cloud SQL 스튜디오에서 데이터베이스에 액세스하려면 먼저 데이터베이스에 인증해야 합니다. Cloud SQL Studio를 사용하여 데이터베이스에 로그인하려면 내장된 데이터베이스 인증을 사용하세요. 자세한 내용은 사용자 만들기 및 관리를 참고하세요.

Cloud SQL Studio는 Active Directory 인증을 지원하지 않습니다.

데이터 탐색

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

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

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

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

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

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

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

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

제한사항

Cloud SQL Studio는 경량형 쿼리를 지원합니다. 10MB를 초과하는 응답은 잘릴 수 있습니다. Cloud SQL Studio에서 부분 결과가 반환된 지점을 표시합니다.
실행 중인 Cloud SQL 인스턴스에 대해서만 쿼리를 실행할 수 있습니다.
Cloud SQL Studio는 외부 서버를 지원하지 않습니다.
5분을 초과하는 요청은 취소됩니다.
Cloud SQL Studio는 SQL 스크립트 실행이 완료된 후 데이터베이스 연결을 열린 상태로 유지하지 않습니다. 마찬가지로 편집기 탭은 공통 세션을 공유하지 않으며 모든 실행이 새 세션을 시작합니다.
DML, DQL, DDL 문을 혼합하여 실행하면 DQL 쿼리의 결과만 표시됩니다.
브라우저 또는 브라우저 탭을 닫아도 Cloud SQL Studio의 쿼리 실행은 중지되지 않습니다. 쿼리는 완료되거나 제한 시간이 될 때까지 실행됩니다.

Cloud SQL Studio에서는 GO 명령어를 지원하지 않습니다. 이 명령어는 Microsoft SQL Server 유틸리티에서 사용되며 문 배치가 종료되어 SQL Server로 전송할 수 있음을 나타냅니다.
쿼리에 바이너리 열이 포함된 경우 Cloud SQL Studio에서 이를 표시할 수 없습니다. 대신 바이너리 값을 문자열로 변환합니다.

예를 들어 다음과 같은 이벤트가 있습니다.
```
SELECT my_binary_column from my_table2;
```
다음 코드로 교체합니다.
```
SELECT CONVERT(NVARCHAR(4000), my_binary_column, 1) from my_table2;
```
여러 쿼리를 실행하는 중에 쿼리 중 하나가 실패하면 처음 발생한 오류가 반환됩니다. 오류 발생 이전 배치에 있는 일부 문은 성공적으로 실행되었을 수 있습니다. transaction 문으로 여러 쿼리를 래핑하여 이 문제를 방지할 수 있습니다.
```
BEGIN TRANSACTION
    YOUR_SQL_STATEMENTS
COMMIT;
```
다음을 바꿉니다.
- YOUR_SQL_STATEMENTS: 이 쿼리의 일부로 실행할 문