데이터 쿼리

Google Cloud Data Agent Kit IDE 확장 프로그램의 통합 SQL 편집기를 사용하면 IDE에서 직접 Google Cloud 데이터에 대해 SQL 쿼리를 실행할 수 있습니다.

지원되는 코딩 에이전트와 함께 Data Agent Kit 플러그인을 사용하는 경우 에이전트에서 SQL 쿼리를 실행하거나 자연어 프롬프트를 사용하여 SQL 쿼리를 생성할 수 있습니다.

지원되는 데이터 소스

Data Agent Kit를 사용하면 다음Google Cloud 데이터 서비스에서 테이블과 뷰를 쿼리할 수 있습니다.

  • BigQuery
  • Bigtable
  • Spanner
  • PostgreSQL용 AlloyDB
  • MySQL용 Cloud SQL
  • PostgreSQL용 Cloud SQL

Cloud SQL의 경우 Identity and Access Management (IAM) 데이터베이스 인증 및 기본 제공 데이터베이스 인증 (비밀번호가 Secret Manager에 지역별 비밀로 저장됨)을 사용하는 쿼리가 지원됩니다. Cloud SQL이 Secret Manager를 사용하여 내장 사용자를 인증하는 방법에 관한 자세한 내용은 MySQL용 Cloud SQL 및 PostgreSQL용 Cloud SQL의 Data API를 사용하여 SQL 문 실행을 참고하세요. AlloyDB의 경우 IAM 데이터베이스 인증을 사용하는 쿼리만 지원됩니다.

시작하기 전에

데이터를 쿼리하기 전에 다음을 수행하세요.

  1. 확장 프로그램을 설치합니다.
  2. 확장 프로그램 설정 구성
  3. 데이터 찾기 및 탐색의 안내를 검토하세요.

새 SQL 파일 만들기

SQL 편집기는 여러 방법으로 열 수 있습니다.

파일 메뉴에서 새 SQL 파일 만들기

  1. VS Code 메뉴 바에서 파일, 새 텍스트 파일을 차례로 클릭합니다. 편집기에 제목이 없는 파일이 표시됩니다.
  2. .sql 확장자로 새 파일을 저장합니다.
  3. 편집기 탭에서 연결 선택을 클릭합니다.
  4. 쿼리 설정 구성의 단계를 완료합니다.

카탈로그에서 새 쿼리 만들기

  1. 활동 표시줄의 Google Cloud Data Agent Kit 탭에서 Catalog를 펼쳐 쿼리할 데이터 세트를 찾습니다.
  2. 데이터 세트 이름을 마우스 오른쪽 버튼으로 클릭하거나 Ctrl+클릭한 다음 쿼리를 선택하여 해당 데이터 세트에 맞게 사전 구성된 새 SQL 파일을 엽니다.

BigQuery 섹션에서 새 쿼리 만들기

  1. 활동 표시줄의 Google Cloud 데이터 에이전트 키트 탭에서 BigQuery를 펼칩니다.
  2. + 새 쿼리를 클릭합니다. BigQuery가 데이터 소스로 구성된 제목이 없는 SQL 파일이 편집기에 표시됩니다.

쿼리 설정 구성

SQL 쿼리에 필요한 설정은 Google Cloud 서비스에 따라 다릅니다.

AlloyDB

  1. SQL 편집기에서 쿼리 설정 열기를 클릭합니다.
  2. 데이터베이스를 선택합니다.
  3. AlloyDB를 선택합니다.
  4. 클러스터를 선택합니다.
  5. 인스턴스를 선택합니다. 쿼리가 이 인스턴스로 라우팅됩니다.
  6. 데이터베이스를 선택합니다.
  7. 저장을 클릭합니다.

BigQuery

  1. SQL 편집기에서 쿼리 설정 열기를 클릭합니다.
  2. BigQuery를 선택합니다.
  3. 저장을 클릭합니다.

Bigtable

  1. SQL 편집기에서 쿼리 설정 열기를 클릭합니다.
  2. 데이터베이스를 선택합니다.
  3. Bigtable을 선택합니다.
  4. 인스턴스를 선택합니다.
  5. 선택사항: 기본 앱 프로필이 아닌 다른 앱 프로필을 사용하려면 선택합니다.
  6. 쿼리를 작성합니다.
  7. 저장을 클릭합니다.

Cloud SQL

  1. SQL 편집기에서 쿼리 설정 열기를 클릭합니다.
  2. 데이터베이스를 선택합니다.
  3. Cloud SQL을 선택합니다.
  4. 인스턴스를 선택합니다. 쿼리가 이 인스턴스로 라우팅됩니다.
  5. 쿼리할 데이터베이스를 선택합니다.

  6. 인증 방법에서 인증 방법을 선택합니다.

    • IAM 데이터베이스 인증: Google Cloud 계정을 사용하여 인증합니다.

    • 기본 제공 데이터베이스 인증: 비밀번호가 Secret Manager에 리전 보안 비밀로 저장된 기본 제공 데이터베이스 사용자로 인증합니다.

      1. 사용자 목록에서 데이터베이스 사용자를 선택합니다. 목록을 로드할 수 없는 경우 사용자 필드에 사용자 이름을 입력합니다. MySQL용 Cloud SQL의 경우 기본 root 사용자는 지원되지 않습니다.
      2. 비밀번호 (Secret Manager에 저장됨) 목록에서 사용자 비밀번호를 저장하는 리전 보안 비밀을 선택합니다. 아직 보안 비밀이 없으면 REGION 리전에 새 보안 비밀 만들기를 선택하고 이름과 비밀번호를 입력한 후 보안 비밀 만들기를 클릭합니다. 보안 비밀은 인스턴스와 동일한 리전에 생성됩니다.
      3. (선택사항) 보안 비밀 버전 목록에서 특정 버전을 선택합니다. 기본적으로 latest가 선택되며, 이는 항상 최신 버전의 보안 비밀을 사용합니다.

      기본 제공 사용자 및 리전 보안 비밀 요구사항에 관한 자세한 내용은 MySQL용 Cloud SQL 및 PostgreSQL용 Cloud SQL의 Data API를 사용하여 SQL 문 실행을 참고하세요.

  7. 저장을 클릭합니다.

Spanner

  1. SQL 편집기에서 쿼리 설정 열기를 클릭합니다.
  2. 데이터베이스를 선택합니다.
  3. Spanner를 선택합니다.
  4. 인스턴스를 선택합니다. 쿼리가 이 인스턴스로 라우팅됩니다.
  5. 쿼리할 데이터베이스를 선택합니다.
  6. 저장을 클릭합니다.

쿼리 설정 변경

쿼리 설정은 각 SQL 파일에 따라 다릅니다. SQL 파일을 연 후 설정을 변경할 수 있습니다.

  1. 편집기에서 표시된 데이터 소스를 클릭합니다. 쿼리 설정 편집기가 표시됩니다.
  2. 쿼리 설정 구성의 단계를 완료합니다.

쿼리 실행

쿼리 파일을 만들고 쿼리를 작성한 후 ▷ 쿼리 실행을 클릭합니다.

쿼리 결과 창의 결과 탭에 쿼리 결과가 표시됩니다.

쿼리 편집기에서 SQL 문의 일부를 실행하려면 ▷ 쿼리 실행을 클릭하기 전에 해당 부분을 강조 표시합니다.

SQL 편집기 기능

모든 데이터 소스 유형에 대해 모든 SQL 편집기 기능이 지원되는 것은 아닙니다. 다음 표에는 미리보기 중에 데이터 소스 유형별로 지원되는 SQL 편집기 기능이 나열되어 있습니다.

기능

BigQuery

Bigtable

Spanner

Cloud SQL

PostgreSQL용 AlloyDB

쿼리 결과

✅

✅

✅

✅

✅

작업 정보

해당 없음

해당 사항 없음

해당 사항 없음

해당 사항 없음

해당 없음

실행 세부정보

✅

✅

경과 시간

❌

지원되지 않음

❌

지원되지 않음

❌

지원되지 않음

시각화

✅

✅

✅

✅

✅

쿼리 설정

✅

✅

✅

✅

✅

멀티 문 쿼리 지원

✅

✅

✅

✅

✅

카탈로그: 편집기에 리소스 이름 삽입

✅

✅

✅

✅

✅

다음 단계