Instala la extensión

La extensión Google Cloud Data Agent Kit para Visual Studio Code te permite trabajar con tus Google Cloud recursos de datos en tu IDE preferido.

Antes de comenzar

Antes de instalar la extensión Data Agent Kit para VS Code, haz lo siguiente.

Instala VS Code y Python

En tu máquina local, instala Visual Studio Code y Python.

  1. Instala y configura Visual Studio Code. Si ya lo instalaste, actualízalo a la versión más reciente.
  2. Instala Python.

Configure Google Cloud

  1. Si aún no tienes uno, crea un Google Cloud proyecto.
  2. Habilita la facturación.

Instala gcloud CLI

Debes instalar Google Cloud CLI y acceder a ella. La extensión usa credenciales de gcloud CLI y credenciales predeterminadas de la aplicación (ADC).

  1. Abre la terminal en tu máquina local o en VS Code.
  2. Si no instalaste gcloud CLI anteriormente, sigue los pasos que se indican en Instala gcloud CLI para descargar e instalar gcloud CLI.

  3. En la terminal, ejecuta gcloud init para inicializar gcloud CLI:

    gcloud init

  4. Ejecuta el siguiente comando y sigue las instrucciones para autenticar y configurar las credenciales predeterminadas de la aplicación:

    gcloud auth login && gcloud auth application-default login

  5. Actualiza gcloud CLI a la versión más reciente:

    gcloud components update

Roles obligatorios

Para obtener los permisos que necesitas para usar la extensión Data Agent Kit para VS Code, pídele a tu administrador que te otorgue los siguientes roles de Identity and Access Management (IAM) en el proyecto. Para obtener más información, consulta Revisa los roles obligatorios.

Según tu caso de uso, es posible que necesites roles adicionales, pero estos roles te permiten instalar y configurar la extensión. La lista completa está disponible en la configuración de la extensión del IDE.

  • Visualizador de datos de BigQuery (roles/bigquery.dataViewer)
  • Usuario de trabajo de BigQuery (roles/bigquery.jobUser)
  • Visualizador de metadatos de BigQuery (roles/bigquery.metadataViewer)
  • Usuario de sesión de lectura de BigQuery (roles/bigquery.readSessionUser)
  • Editor de Dataproc (roles/dataproc.editor)

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Los roles predefinidos contienen los permisos necesarios para usar la extensión. Para ver los permisos exactos que son necesarios, expande la sección Permisos necesarios:

Permisos necesarios

  • 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

Instala la extensión

  1. En VS Code, haz clic en Extensiones o presiona Ctrl/Cmd+Shift+X.
  2. Busca Google Cloud Data Agent Kit.
  3. Haz clic en Instalar.
  4. Si se te solicita, reinicia VS Code. Una vez que la extensión se haya instalado correctamente, se agregará el ícono de Google Cloud Data Agent Kit a la barra de actividades.

Accede a Google Cloud Data Agent Kit

A continuación, debes autenticarte en Google Cloud Data Agent Kit con la misma cuenta que usaste para acceder a gcloud CLI.

  1. Si el diálogo de acceso no se abre automáticamente, busca un vínculo de acceso a Google Cloud Data Agent Kit en la barra de estado cerca de la parte inferior de la ventana del IDE y haz clic en él.

    Como alternativa, puedes presionar Ctrl/Cmd+Shift+P para abrir la paleta de comandos, buscar y seleccionar Google Cloud Data Agent Kit: Sign in.

  2. Sigue las instrucciones y completa el acceso.

    Se mostrará una página web que confirma que se completó la autenticación.

  3. Cierra la página y vuelve al IDE.

Habilita las APIs

Después de acceder a tu Cuenta de Google, debes habilitar las APIs en tu Google Cloud proyecto para todos los servicios que usas en tus flujos de trabajo de ciencia de datos o ingeniería de datos.

Para ver la lista de APIs y las que ya están habilitadas, haz lo siguiente:

  1. En la barra de actividades, haz clic en el ícono de Google Cloud Data Agent Kit.
  2. Expande Configuración y, luego, haz clic en Configuración.
  3. Selecciona Común.
  4. Haz clic en APIs obligatorias.

APIs para habilitar

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

Solucionar problemas

Si tienes problemas, intenta salir de Google Cloud Data Agent Kit y gcloud CLI, y luego volver a acceder. Para encontrar métodos adicionales para diagnosticar y resolver errores de instalación, consulta Soluciona problemas de la extensión Data Agent Kit para VS Code.

¿Qué sigue?