저장된 쿼리 만들기 및 관리

이 페이지에서는 저장된 쿼리를 만들고 관리하는 방법을 설명합니다. Spanner 스튜디오에서 SQL 스크립트를 작성하면 이러한 SQL 스크립트를 저장하고 관리할 수 있습니다. 자세한 내용은 저장된 쿼리 개요를 참고하세요.

저장된 쿼리 기능은 Google Cloud 콘솔에서만 사용할 수 있습니다.

필요한 역할

저장된 쿼리를 사용하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 다음 IAM 역할을 부여해 달라고 요청하세요.

  • 저장된 쿼리를 만들고 삭제하려면 다음을 실행합니다. Studio 쿼리 사용자 (roles/databasesConsole.studioQueryUser)
  • 저장된 쿼리 페이지에 대한 액세스를 포함하여 프로젝트의 모든 저장된 쿼리를 관리하려면 다음을 실행합니다. 스튜디오 쿼리 관리자 (roles/databasesConsole.studioQueryAdmin)

역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이러한 사전 정의된 역할에는 저장된 쿼리를 사용하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

저장된 쿼리를 사용하려면 다음 권한이 필요합니다.

  • 저장된 쿼리를 만들고 삭제하려면 다음 안내를 따르세요.
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
  • 프로젝트의 모든 저장된 쿼리를 관리하려면 다음 안내를 따르세요.
    • databasesConsole.studioQuery.create
    • databasesConsole.studioQuery.update
    • databasesConsole.studioQuery.delete
    • databasesConsole.studioQuery.search
    • databasesConsole.studioQuery.list
    • databasesConsole.studioQuery.get

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

스튜디오 쿼리 사용자 (roles/databasesConsole.studioQueryUser) 역할은 저장된 쿼리를 만들고, 보고, 작성할 수 있는 액세스 권한을 제공합니다. 대부분의 사용자에게는 충분합니다.

스튜디오 쿼리 관리자 (roles/databasesConsole.studioQueryAdmin) 역할은 관리자에게만 부여해야 합니다. Spanner Identity and Access Management (IAM)에 대한 자세한 내용은 IAM 개요를 참고하세요.

권한

저장된 쿼리를 만들려면 프로젝트 수준에서 다음 IAM 권한이 필요합니다.

  • databasesConsole.locations.get
  • databasesConsole.locations.list
  • databasesConsole.studioQueries.create

저장된 쿼리를 보려면 프로젝트 수준에서 다음 권한이 필요합니다.

  • databasesConsole.studioQueries.search

저장된 쿼리를 수정하고 삭제하려면 프로젝트 수준에서 다음 권한이 필요합니다.

  • databasesConsole.studioQueries.update

쿼리 실행 권한은 데이터베이스에서 상속됩니다. 쿼리를 볼 권한은 있지만 실행할 권한은 없는 경우도 있습니다.

저장된 검색어 만들기

저장된 쿼리를 만들려면 다음 단계를 수행합니다.

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

    인스턴스

  2. 저장된 쿼리를 만들 인스턴스를 선택합니다.

  3. 저장된 쿼리를 만들 데이터베이스를 선택합니다.

  4. 탐색 메뉴에서 Spanner 스튜디오를 클릭합니다.

    1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 비어 있는 편집기 탭을 사용합니다.
  5. 쿼리 편집기에서 유효한 SQL 쿼리를 입력합니다.

  6. 저장을 클릭합니다.

  7. 쿼리 저장 대화상자에 저장된 쿼리의 이름을 입력합니다.

  8. 저장을 클릭합니다.

저장된 쿼리 열기 및 실행

기존 저장된 쿼리를 새 쿼리로 열려면 다음 단계를 따르세요.

  1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 빈 편집기 탭을 사용합니다.
  2. 탐색기 창에서 쿼리 섹션으로 이동합니다. 저장된 쿼리를 클릭하여 새 편집기 탭에서 엽니다. 또는 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다. 그런 다음 쿼리 열기를 클릭하여 새 편집기 탭에서 쿼리를 엽니다.
  3. 실행을 클릭합니다.

저장된 쿼리 업데이트

기존에 저장된 쿼리를 업데이트하려면 다음 단계를 따르세요.

  1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 빈 편집기 탭을 사용합니다.
  2. 탐색기 창에서 쿼리 섹션으로 이동합니다. 저장된 쿼리를 클릭하여 새 편집기 탭에서 엽니다. 또는 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다. 그런 다음 쿼리 열기를 클릭하여 새 편집기 탭에서 쿼리를 엽니다.
  3. 쿼리를 수정합니다.
  4. 수정된 쿼리를 저장하려면 저장을 클릭합니다.

저장된 모든 쿼리 목록 보기 및 관리

프로젝트의 모든 저장된 쿼리 목록을 보려면 다음 단계를 따르세요.

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

    인스턴스

  2. 인스턴스를 선택합니다. 저장된 쿼리는 프로젝트의 하위 요소이므로 필요한 역할이 있는 한 모든 인스턴스 또는 데이터베이스에서 프로젝트의 모든 저장된 쿼리를 볼 수 있습니다.

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

  4. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 빈 편집기 탭을 사용합니다.

  5. 탐색기 창에서 쿼리 섹션으로 이동합니다. 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다. 그런 다음 쿼리 관리를 클릭합니다.

    저장된 쿼리 페이지가 열립니다. 이 프로젝트의 모든 저장된 쿼리 (다른 제품의 저장된 쿼리 포함)가 표시됩니다. Google Cloud

저장된 검색어 페이지에서 검색어를 검색, 필터링, 확인, 삭제할 수 있습니다. 저장된 쿼리 페이지에서는 기존 쿼리를 수정할 수 없습니다.

저장된 쿼리 페이지에서 저장된 쿼리를 삭제하려면 다음 단계를 따르세요.

  1. 삭제하려는 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다.
  2. 검색어 삭제를 클릭하여 저장된 검색어를 삭제합니다.
  3. 검색어 삭제 대화상자에서 삭제를 클릭합니다.

저장된 쿼리 삭제

  1. Spanner 스튜디오 페이지에서 새 탭을 클릭하거나 빈 편집기 탭을 사용합니다.
  2. 탐색기 창에서 쿼리 폴더를 펼칩니다. 삭제하려는 저장된 쿼리 옆에 있는 작업 보기를 클릭합니다. 그런 다음 쿼리 삭제를 클릭하여 저장된 쿼리를 삭제합니다.
  3. 검색어 삭제 대화상자에서 삭제를 클릭합니다.

다음 단계