문제 해결

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

여기에 나열된 가능한 오류를 검토한 후 문제의 소스를 식별할 수 없는 경우 로그아웃한 후 다시 로그인해 보세요.

인증 및 gcloud CLI 오류

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

오류 메시지

가능한 원인

해결 방법

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

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

Google Cloud CLI를 설치하고 VS Code를 다시 시작합니다.

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

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

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

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

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

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

상태 표시줄에 $(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 Data Agent Kit 메뉴 트리에서 클라우드 리소스를 탐색할 때 발생하는 일반적인 오류입니다.

오류 메시지

가능한 원인

해결 방법

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

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

Identity and Access Management (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 역할이 있는지 확인하고 클러스터 상태가 이미 업데이트 중 인지 확인합니다.

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 VS Code 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.

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

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 사용자에게 객체에 대한 권한이 없습니다.

객체에 대한 권한을 부여하려면 Grant 적절한 데이터베이스 권한을 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" }}. Data API 액세스가 사용 설정되지 않았습니다. 쿼리 설정에서 Data API 액세스를 사용 설정하거나 Cloud SQL Data 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" }}. Data API 액세스가 사용 설정되지 않았습니다. 쿼리 설정에서 Data API 액세스를 사용 설정하거나 Cloud SQL Data API를 사용하여 SQL 문 실행을 참조하여 콘솔 또는 gcloud CLI에서 사용 설정합니다. Google Cloud
Invalid request: IAM authentication is not enabled for the instance [PROJECT_ID]:[INSTANCE_NAME]. IAM 인증 플래그가 사용 설정되지 않았습니다. 쿼리 설정에서 IAM 인증 플래그를 사용 설정하거나 IAM 인증을 참조하여 콘솔 또는 gcloud CLI에서 사용 설정합니다. Google Cloud
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을 참조하세요.

다음 단계