Instala la extensión

La extensión Google Cloud Data Agent Kit para Visual Studio Code te permite trabajar con tus recursos de datos Google Cloud 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 la instalaste, actualízala a la versión más reciente.
  2. Instala Python.

Configura 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 de las 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 la CLI de gcloud 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 autenticarte 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 requeridos.

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 a través de 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 requeridos:

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 del kit de agentes de datos de Google Cloud 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 al kit de Google Cloud Data Agent 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.

    Aparecerá 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 proyecto deGoogle Cloud para todos los servicios que uses 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 requeridas.

APIs que se habilitarán

  • 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 de la gcloud CLI, y luego vuelve a acceder. Para encontrar métodos adicionales para diagnosticar y resolver errores de instalación, consulta Solución de problemas.

¿Qué sigue?