Menginstal ekstensi

Ekstensi Google Cloud Data Agent Kit untuk Visual Studio Code memungkinkan Anda menggunakan resource data di IDE pilihan Anda. Google Cloud

Sebelum memulai

Sebelum menginstal ekstensi Data Agent Kit untuk VS Code, lakukan hal berikut.

Menginstal VS Code dan Python

Di komputer lokal Anda, instal Visual Studio Code dan Python.

  1. Instal dan siapkan Visual Studio Code. Jika Anda telah menginstalnya, update ke versi terbaru.
  2. Instal Python.

Siapkan Google Cloud

  1. Jika belum memilikinya, buat Google Cloud project.
  2. Aktifkan penagihan.

Menginstal gcloud CLI

Anda harus menginstal dan login ke Google Cloud CLI. Ekstensi ini menggunakan kredensial dari gcloud CLI dan kredensial default aplikasi (ADC).

  1. Buka terminal di komputer lokal Anda atau di VS Code.
  2. Jika Anda belum pernah menginstal gcloud CLI, ikuti langkah-langkah di Menginstal gcloud CLI untuk mendownload dan menginstal gcloud CLI.

  3. Di terminal, jalankan gcloud init untuk melakukan inisialisasi gcloud CLI:

    gcloud init

  4. Jalankan perintah berikut dan ikuti perintah untuk melakukan autentikasi dan menyiapkan kredensial default aplikasi:

    gcloud auth login && gcloud auth application-default login

  5. Update gcloud CLI ke versi terbaru:

    gcloud components update

Peran yang diperlukan

Untuk mendapatkan izin yang Anda perlukan untuk menggunakan ekstensi Data Agent Kit untuk VS Code, minta administrator untuk memberi Anda peran Identity and Access Management (IAM) berikut di project. Untuk mengetahui informasi selengkapnya, lihat Meninjau peran yang diperlukan.

Bergantung pada kasus penggunaan Anda, Anda mungkin memerlukan peran tambahan, tetapi peran ini memungkinkan Anda menginstal dan menyiapkan ekstensi. Daftar lengkapnya tersedia di setelan ekstensi IDE.

  • BigQuery Data Viewer (roles/bigquery.dataViewer)
  • BigQuery Job User (roles/bigquery.jobUser)
  • BigQuery Metadata Viewer (roles/bigquery.metadataViewer)
  • BigQuery Read Session User (roles/bigquery.readSessionUser)
  • Editor Dataproc (roles/dataproc.editor)

Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Anda mungkin juga bisa mendapatkan izin yang diperlukan melalui peran khusus atau peran bawaan lainnya.

Peran bawaan berisi izin yang diperlukan untuk menggunakan ekstensi. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

  • bigquery.config.get
  • bigquery.datasets.get
  • bigquery.datasets.getIamPolicy
  • bigquery.jobs.create
  • bigquery.readsessions.create
  • bigquery.readsessions.getData
  • bigquery.readsessions.update
  • bigquery.tables.createSnapshot
  • bigquery.tables.export
  • bigquery.tables.get
  • bigquery.tables.getIamPolicy
  • bigquery.tables.list
  • bigquery.tables.replicateData
  • dataform.locations.get
  • dataform.locations.list
  • dataform.repositories.create
  • dataform.repositories.list
  • dataplex.projects.search
  • dataproc.clusters.use
  • dataproc.operations.get
  • dataproc.sessions.create
  • dataproc.sessions.delete
  • dataproc.sessions.get
  • dataproc.sessions.list
  • dataproc.sessions.terminate
  • dataproc.sessionTemplates.create
  • dataproc.sessionTemplates.delete
  • dataproc.sessionTemplates.get
  • dataproc.sessionTemplates.list
  • dataproc.sessionTemplates.update
  • resourcemanager.projects.get

Menginstal ekstensi

  1. Di VS Code, klik Extensions atau tekan Ctrl/Cmd+Shift+X.
  2. Telusuri Google Cloud Data Agent Kit.
  3. Klik Install.
  4. Jika diminta, mulai ulang VS Code. Setelah ekstensi berhasil diinstal, ikon Google Cloud Data Agent Kit akan ditambahkan ke panel aktivitas.

Login ke Google Cloud Data Agent Kit

Selanjutnya, Anda harus melakukan autentikasi ke Google Cloud Data Agent Kit menggunakan akun yang sama dengan yang Anda gunakan untuk login ke gcloud CLI.

  1. Jika dialog sign-in tidak terbuka secara otomatis, cari link login Google Cloud Data Agent Kit di status bar di dekat bagian bawah jendela IDE, lalu klik.

    Atau, Anda dapat menekan Ctrl/Cmd+Shift+P untuk membuka command palette, menelusuri dan memilih Google Cloud Data Agent Kit: Sign in.

  2. Ikuti perintah dan selesaikan proses login.

    Halaman web yang mengonfirmasi bahwa autentikasi telah selesai akan ditampilkan.

  3. Tutup halaman dan kembali ke IDE.

Mengaktifkan API

Setelah login ke Akun Google, Anda harus mengaktifkan API di Google Cloud project Anda untuk semua layanan yang Anda gunakan untuk alur kerja ilmu data atau rekayasa data.

Untuk melihat daftar API dan melihat API yang sudah diaktifkan, lakukan hal berikut:

  1. Di panel aktivitas, klik ikon Google Cloud Data Agent Kit.
  2. Luaskan Settings, lalu klik Settings.
  3. Pilih Common.
  4. Klik Required APIs.

API yang akan diaktifkan

  • AlloyDB API
  • BigLake API
  • BigQuery API
  • Cloud Composer API
  • Cloud Dataplex API
  • Cloud Resource Manager API
  • Cloud Spanner API
  • Cloud SQL
  • Cloud SQL Admin API
  • Cloud Storage API
  • Dataproc API
  • Dataproc Release Manager API
  • Vertex AI API

Memecahkan masalah

Jika Anda mengalami masalah, coba logout dari Google Cloud Data Agent Kit dan gcloud CLI, lalu login lagi. Untuk menemukan metode tambahan dalam mendiagnosis dan menyelesaikan error penginstalan, lihat Memecahkan masalah ekstensi Data Agent Kit untuk VS Code.

Langkah berikutnya