이 페이지에서는 저장된 쿼리를 만들고 관리하는 방법을 설명합니다. AlloyDB Studio에서 SQL 스크립트를 작성할 때 해당 SQL 스크립트를 저장하고 관리할 수 있습니다. 자세한 내용은 저장된 쿼리 개요를 참고하세요.
저장된 쿼리 기능은 Google Cloud 콘솔에서만 사용할 수 있습니다.
필요한 역할
저장된 쿼리를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 Identity and Access Management (IAM) 역할을 부여해 달라고 요청하세요.
- 저장된 쿼리를 보려면 Cloud AlloyDB 데이터베이스 사용자 (
roles/alloydb.databaseuser
) 권한이 필요합니다. - 저장된 쿼리 페이지에 대한 액세스를 포함하여 프로젝트에서 저장된 쿼리를 만들고, 수정하고, 보고, 삭제하려면 Cloud AlloyDB 관리자 (
roles/alloydb.admin
) 또는 Studio 쿼리 사용자 (roles/databasesconsole.studioQueryUser
)가 필요합니다. - 저장된 쿼리 페이지에 대한 액세스를 포함하여 프로젝트의 모든 저장된 쿼리를 관리하려면 Studio 쿼리 관리자 (
roles/databasesconsole.studioQueryAdmin
)가 필요합니다.
역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.
이러한 사전 정의된 역할에는 저장된 쿼리를 사용하는 데 필요한 권한이 포함되어 있습니다. 필수 권한에 대해 자세히 알아보려면 필수 권한을 참고하세요.
필수 권한
저장된 쿼리를 만들고, 보고, 수정하고, 삭제하려면 프로젝트 수준에서 다음 IAM 권한이 필요합니다.
작업 | 필수 IAM 권한 |
---|---|
저장된 쿼리 만들기 |
|
저장된 쿼리 보기 |
|
저장된 쿼리 수정 |
|
저장된 쿼리 삭제 |
|
저장된 쿼리 관리 (관리자만 사용) |
|
Studio 쿼리 사용자(roles/databasesconsole.studioQueryUser
) 역할은 저장된 쿼리 만들기, 보기, 쓰기 액세스 권한을 제공합니다. 이 역할은 대부분의 사용자의 요구사항을 충족합니다.
스튜디오 쿼리 관리자(roles/databasesconsole.studioQueryAdmin
) 역할은 관리자에게만 부여합니다. AlloyDB IAM에 대한 자세한 내용은 AlloyDB 역할 및 권한을 참고하세요.
저장된 쿼리 만들기
저장된 쿼리를 만들려면 다음 단계를 수행합니다.
- Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
클러스터로 이동 - 저장된 쿼리를 만들 인스턴스를 선택합니다.
- 탐색 메뉴에서 AlloyDB Studio를 클릭합니다.
- AlloyDB Studio 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.
- 쿼리 편집기에서 SQL 쿼리를 입력합니다.
- 저장을 클릭합니다.
- 쿼리 저장 대화상자에 저장된 쿼리의 이름을 입력합니다.
- 저장을 클릭합니다.
저장된 쿼리 열기 및 실행
저장된 쿼리를 새 쿼리로 열려면 다음 단계를 따르세요.
- AlloyDB Studio 페이지의 탐색기 창에서 쿼리 섹션으로 이동합니다.
- 저장된 쿼리를 클릭하여 새 편집기 탭에서 엽니다. 원하는 경우 저장된 쿼리 옆에 있는 작업 보기를 클릭할 수 있습니다. 그런 다음 쿼리 열기를 클릭하여 새 편집기 탭에서 엽니다.
- 실행을 클릭합니다.
저장된 쿼리 업데이트
기존의 저장된 쿼리를 업데이트하려면 다음 단계를 따르세요.
- AlloyDB Studio 페이지의 탐색기 창에서 쿼리 섹션으로 이동합니다.
- 저장된 쿼리를 클릭하여 새 편집기 탭에서 엽니다. 원하는 경우 저장된 쿼리 옆에 있는 작업 보기를 클릭할 수 있습니다. 그런 다음 쿼리 열기를 클릭하여 새 편집기 탭에서 엽니다.
- 쿼리를 수정합니다.
- 수정된 쿼리를 저장하려면 저장을 클릭합니다.
저장된 모든 쿼리 목록 보기 및 관리
프로젝트의 모든 저장된 쿼리 목록을 보려면 다음 단계를 따르세요.
- Google Cloud 콘솔에서 클러스터 페이지로 이동합니다.
클러스터로 이동 - 클러스터를 선택합니다. 저장된 쿼리는 프로젝트의 하위 요소이므로 필요한 역할이 있는 한 모든 클러스터, 인스턴스 또는 데이터베이스에서 프로젝트에 저장된 모든 쿼리를 볼 수 있습니다.
- 탐색 메뉴에서 AlloyDB Studio를 클릭하고 인증합니다.
- 데이터베이스를 선택합니다.
- AlloyDB Studio 페이지의 탐색기 창에서 쿼리 섹션으로 이동합니다.
- 저장된 쿼리 옆에 있는
저장된 쿼리 페이지가 열립니다. 이 페이지에는 다른 Google Cloud 제품의 저장된 쿼리를 포함하여 이 프로젝트에 저장된 모든 쿼리가 나열됩니다.
작업 보기를 클릭합니다. 그런 다음 쿼리 관리를 클릭합니다.
저장된 쿼리 페이지에서 쿼리를 검색, 필터링, 확인, 삭제할 수 있습니다. 저장된 쿼리 페이지에서 기존 쿼리를 수정할 수는 없습니다.
저장된 쿼리 삭제
AlloyDB Studio 페이지 또는 Google Cloud 콘솔의 저장된 쿼리 페이지에서 저장된 쿼리를 삭제할 수 있습니다.
- AlloyDB Studio 페이지의 탐색기 창에서 'Queries'(쿼리) 섹션으로 이동합니다.
- 삭제하려는 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다. 그런 다음 쿼리 삭제를 클릭하여 저장된 쿼리를 삭제합니다.
- 쿼리 삭제 대화상자에서 삭제를 클릭합니다.
저장된 쿼리 페이지에서 저장된 쿼리를 삭제할 수도 있습니다. 저장된 쿼리 페이지에서 저장된 쿼리를 삭제하려면 다음 단계를 따르세요.
- 저장된 쿼리 페이지로 이동합니다.
- 삭제하려는 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다.
- 쿼리 삭제를 클릭하여 저장된 쿼리를 삭제합니다.
- 쿼리 삭제 대화상자에서 삭제를 클릭합니다.
다음 단계
- 저장된 쿼리에 대해 알아보기