문제 해결

이 문서에서는 Antigravity IDE용 데이터 에이전트 키트 확장 프로그램에서 캡처하고 표시하는 표시되는 오류를 나열합니다. 이러한 오류는 일반적으로 IDE에서 알림(팝업) 또는 상태 표시줄 경고로 표시됩니다. 이 가이드를 사용하여 문제를 식별하고 해결하세요.

여기에 나열된 가능한 오류를 검토한 후에도 문제의 원인을 파악할 수 없는 경우 로그아웃했다가 다시 로그인해 보세요.

인증 및 gcloud CLI 오류

이러한 오류는 확장 프로그램의 기본 연결에 영향을 미칩니다.

오류 메시지

가능한 원인

해결

Google Cloud CLI is required... but was not found.

gcloud 바이너리가 시스템 경로에 없습니다.

Google Cloud CLI를 설치하고 Antigravity IDE를 다시 시작합니다.

You must be logged in to both the Google Cloud CLI and ADC...

gcloud auth login 또는 gcloud auth application-default login이 실행되지 않았습니다.

상태 표시줄 또는 알림을 클릭하여 터미널에서 로그인 흐름을 트리거합니다.

상태 표시줄에 계정 이름 옆에 $(warning) 아이콘이 표시됩니다.

로그인한 확장 프로그램 계정이 활성 gcloud CLI 계정과 다릅니다.

Google Cloud에 로그인하는 데 사용한 것과 동일한 계정으로 gcloud auth login 및 gcloud auth application-default login을 실행합니다.

상태 표시줄에 $(warning) 아이콘이 표시됩니다.

프로젝트 ID, 리전, 결제 프로젝트 ID와 같은 확장 프로그램 설정이 gcloud CLI 설정과 일치하지 않습니다.

프로젝트 상태 표시줄에서 경고 아이콘을 클릭하여 확장 프로그램과 gcloud CLI 간에 설정을 동기화합니다. 또는 두 도구의 구성을 수동으로 업데이트하여 일치하도록 합니다.

Cannot sync settings: gcloud CLI or ADC account does not match extension account개

계정이 일치하지 않는 상태에서 설정을 동기화하려고 시도합니다.

gcloud CLI와 확장 프로그램 간에 계정을 정렬합니다. 동일한 사용자 계정, 프로젝트, 리전, 결제 프로젝트를 사용하고 있는지 확인합니다.

Cannot sync settings: Google Cloud CLI is not installed.

gcloud CLI가 설치되지 않은 상태에서 설정을 동기화하려고 시도합니다.

gcloud CLI 설치

탐색기 및 API 가져오기 오류

다음은 Google Cloud 데이터 에이전트 키트 메뉴 트리에서 클라우드 리소스를 탐색할 때 발생하는 일반적인 오류입니다.

오류 메시지

가능한 원인

해결

Failed to load ${itemKind}: ${error.message}

서버에서 요청을 승인할 수 없거나 (HTTP 403 Forbidden 상태 코드) 서버에서 리소스를 찾을 수 없거나 (HTTP 404 Not Found 상태 코드) API가 사용 설정되지 않았습니다.

ID 및 액세스 관리 (IAM) 권한을 확인하고 설정에서 BigQuery와 같은 관련 API가 사용 설정되어 있는지 확인합니다.

No Google Cloud project selected.

활성 프로젝트 없이 기능이 트리거되었습니다.

상태 표시줄의 프로젝트 선택기를 사용하여 프로젝트를 선택합니다.

Invalid table name format: ${tableName}

잘못된 이름 지정 규칙 (프로젝트 ID 또는 데이터 세트 ID가 누락됨)

정규화된 이름(project.dataset.table)을 사용합니다.

BigQuery 및 Dataform 오류

다음 오류는 SQL 변환 및 Dataform 프로젝트 관리와 관련이 있습니다.

오류 메시지

가능한 원인

해결

Dataform CLI is not installed. Dataform features will not work.

Dataform npm 패키지가 전역으로 설치되지 않았습니다.

대화상자에서 Dataform CLI 설치를 클릭하여 설치를 자동화합니다.

Failed to compile project in folder...: ${stderr}

.sqlx 파일의 구문 오류 또는 잘못된 workflow_settings.yaml

Dataform Compiled Query 뷰에서 구체적인 문법 오류를 확인합니다.

Failed to run Dataform project: ${message}

BigQuery 작업 실행 실패

BigQuery 작업 기록에서 자세한 실행 로그를 검토합니다.

No content found for saved query: ${label}

Knowledge Catalog 또는 BigQuery 항목이 있지만 NoSQL 콘텐츠가 있습니다.

Google Cloud 콘솔에서 쿼리를 실행하여 쿼리 콘텐츠를 확인합니다.

Managed Service for Apache Spark 및 Spark 오류

다음 오류는 클러스터 관리 및 Spark 실행과 관련이 있습니다.

오류 메시지

가능한 원인

해결

Error starting/stopping/restarting cluster ${name}: ${message}

IAM 권한이 부족하거나 클러스터가 전환 중입니다.

roles/dataproc.editor 역할이 있는지 확인하고 클러스터 상태가 이미 UPDATING인지 확인합니다.

Error: No cluster name found.

트리 뷰의 내부 참조 오류입니다.

Spark 리소스 탐색기 보기를 새로고침합니다.

Failed to redirect to Spark UI: ${message}

클러스터가 중지되었거나 구성요소 게이트웨이가 사용 중지되었습니다.

클러스터를 시작하고 클러스터 구성에서 구성요소 게이트웨이가 사용 설정되어 있는지 확인합니다.

Failed to load [clusters/jobs/sessions/session templates]: [message]

API 오류

Spark 리소스 탐색기 보기를 새로고침합니다.

Failed to start Jupyter process / Pip install failed.

로컬 Jupyter 서버 시작에 실패했거나 필수 패키지 설치에 실패했습니다.

원격 커널을 사용하여 새 Spark 노트북을 엽니다.

No sample notebooks found for the selected kernel type.

선택한 커널 유형 (로컬 또는 원격)의 샘플 노트북을 사용할 수 없습니다.

해당 없음

This system does not have Windows Long Path support enabled. Please enable long paths and restart Antigravity IDE to work with Spark Notebooks on remote kernels. Learn More

이는 머신에서 긴 경로가 사용 설정되지 않은 Windows 사용자를 위한 것입니다.

알림의 링크를 참조하여 긴 경로를 사용 설정합니다.

google-cloud-jupyter-config and jupyter_server are required to connect to remote kernels on Managed Service for Apache Spark. Install them?

이 메시지는 사용자가 처음으로 원격 커널을 사용하려고 할 때 표시됩니다.

알림을 클릭하고 확인 대화상자에서 예를 선택하여 종속 항목을 설치합니다.

Requires package installation

Jupyter 종속 항목이 누락된 경우 커널 선택기 설명의 원격 커널 옆에 표시됩니다.

알림을 클릭하고 확인 대화상자에서 예를 선택하여 종속 항목을 설치합니다.

Install dependencies for remote Spark kernels. Require google-cloud-jupyter-config and jupyter_server

사용자가 원격 커널에서 기존 노트북을 실행할 때 커널 선택기 설명에 표시됩니다.

알림을 클릭하고 확인 대화상자에서 예를 선택하여 종속 항목을 설치합니다.

Cloud Storage 오류

버킷과 객체를 관리하는 동안 다음 오류가 표시됩니다.

오류 메시지

가능한 원인

해결

A folder with the name... already exists.

버킷의 이름 충돌입니다.

고유한 폴더 이름을 선택합니다.

Upload/Download failed: ${message}

권한이 거부되었거나 네트워크 시간 제한이 발생했습니다.

Storage Object Admin 또는 Creator 역할을 확인합니다.

Failed to create bucket: ${message}

이름이 이미 전역적으로 사용 중이거나 잘못된 문자가 있습니다.

Cloud Storage 버킷 이름 지정 규칙을 따릅니다.

일반 인터페이스 오류

이 오류는 UI 수준의 실패를 나타냅니다.

오류 메시지

가능한 원인

해결

No workspace folder open.

사용자가 Antigravity IDE에서 폴더 없음 모드에 있습니다.

File > Open Folder를 사용하여 폴더를 엽니다.

No active notebook editor found.

열려 있는 노트북 없이 Spark 또는 SQL 명령어를 실행하고 있습니다.

.ipynb 또는 .sql 파일을 엽니다.

Cannot insert item: unsupported resource type.

NoSQL 문자열 표현이 있는 리소스를 드래그 앤 드롭하려고 시도합니다.

테이블, 뷰, 열만 편집기에 삽입할 수 있습니다.

데이터베이스 오류

Google Cloud 데이터베이스를 쿼리할 때 다음 오류가 반환됩니다.

AlloyDB

오류 메시지

가능한 원인

해결

postgresql error: role "[USER_EMAIL]" does not exist

확장에 로그인한 사용자가 인스턴스에 IAM 사용자로 추가되지 않았습니다.

IAM 인증 관리를 참고하여 사용자를 IAM 사용자로 추가하세요.

postgresql error: permission denied for table [TABLE_NAME]

IAM 사용자에게 객체에 대한 권한이 없습니다.

객체에 대한 IAM 사용자의 권한을 부여하려면 IAM 사용자에게 적절한 데이터베이스 권한 부여를 참고하세요.

MySQL용 Cloud SQL

오류 메시지 가능한 원인 해결
Invalid request: Some of your SQL statements failed to execute. Details: Error 1045 (28000): Access denied for user '[USER]'@'localhost' (using password: YES). 확장에 로그인한 사용자가 인스턴스에 IAM 사용자로 추가되지 않았습니다. IAM 인증을 참고하여 사용자를 인스턴스의 IAM 사용자로 추가하세요.
Invalid request: Some of your SQL statements failed to execute. Details: Error 1044 (42000): Access denied for user '[USER]'@'%' to database '[DB_NAME]'. IAM 사용자에게 데이터베이스에 액세스할 수 있는 권한이 없습니다. 데이터베이스에 대한 IAM 사용자 권한을 부여하려면 개별 IAM 사용자 또는 서비스 계정에 데이터베이스 권한 부여를 참고하세요.
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }}. 데이터 API 액세스가 사용 설정되지 않았습니다. 쿼리 설정에서 데이터 API 액세스를 사용 설정하거나 Cloud SQL 데이터 API를 사용하여 SQL 문 실행을 참고하여 Google Cloud 콘솔 또는 gcloud CLI에서 사용 설정하세요.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. IAM 인증 플래그가 사용 설정되어 있지 않습니다. 쿼리 설정에서 IAM 인증 플래그를 사용 설정하거나 IAM 인증을 참고하여 Google Cloud 콘솔 또는 gcloud CLI에서 사용 설정합니다.

PostgreSQL용 Cloud SQL

오류 메시지 가능한 원인 해결
Invalid request: The instance doesn't allow using ExecuteSql to access this instance. You can allow it by patching the instance with {settings: { dataApiAccess: "ALLOW_DATA_API" }}. 데이터 API 액세스가 사용 설정되지 않았습니다. 쿼리 설정에서 데이터 API 액세스를 사용 설정하거나 Cloud SQL 데이터 API를 사용하여 SQL 문 실행을 참고하여 Google Cloud 콘솔 또는 gcloud CLI에서 사용 설정하세요.
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. IAM 인증 플래그가 사용 설정되어 있지 않습니다. 쿼리 설정에서 IAM 인증 플래그를 사용 설정하거나 IAM 인증을 참고하여 Google Cloud 콘솔 또는 gcloud CLI에서 사용 설정하세요.
Invalid request: Some of your SQL statements failed to execute. Details: pq: password authentication failed for user "[USER_EMAIL]". 확장에 로그인한 사용자가 인스턴스에 IAM 사용자로 추가되지 않았습니다. IAM 인증을 참고하여 사용자를 인스턴스의 IAM 사용자로 추가하세요.
Execution failed. All statements are aborted. Details: pq: permission denied for table [TABLE_NAME] IAM 사용자에게 객체에 액세스할 권한이 없습니다. IAM 데이터베이스 인증으로 사용자 관리를 참고하여 데이터베이스의 IAM 사용자에게 권한을 부여하세요.

Spanner

오류 메시지

가능한 원인

해결

Result set too large. Result sets larger than 10.00M can only be yielded through the streaming API.

결과 크기가 10.00MiB보다 큰 경우는 지원되지 않습니다.

executeSql을 참고하세요.

다음 단계