Access Cloud Storage buckets and files in JupyterLab

Access Cloud Storage buckets and files in JupyterLab

This page shows you how to browse files that are stored in Cloud Storage from within the JupyterLab interface of your Vertex AI Workbench managed notebooks instance. You can also open and edit files that are compatible with JupyterLab, such as text files and notebook (IPYNB) files.

Overview

Vertex AI Workbench managed notebooks instances include a Cloud Storage integration that lets you browse buckets and work with compatible files located in Cloud Storage from within the JupyterLab interface.

The Cloud Storage integration lets you access all of the Cloud Storage buckets and files that your instance has access to within the same project as your managed notebooks instance.

Note: Your managed notebooks instance's access to Cloud Storage is determined by the single user or service account that you used to grant access to your instance. For example, if you granted a specific service account access to your instance, you must also grant that service account access to the Cloud Storage buckets that you want to use in JupyterLab.

Before you begin

This guide requires you to have access to at least one Cloud Storage bucket in the same project as your managed notebooks instance.

1. If you need to create a Cloud Storage bucket, see Create buckets.

2. If you haven't already, create a managed notebooks instance in the same project as your Cloud Storage bucket.

Open JupyterLab

1. In the Google Cloud console, go to the Managed notebooks page.

   Go to Managed notebooks

2. Next to your managed notebooks instance's name, click Open JupyterLab.

   Your managed notebooks instance opens JupyterLab.

Access the Cloud Storage buckets and files

To use the Cloud Storage integration to browse the buckets that you have access to, complete the following steps:

1. In JupyterLab, click the  Browse GCS button.

   The Cloud Storage integration lists the available buckets.

2. Double-click a bucket to view the bucket's contents.

3. Double-click to open folders within the bucket.

   Note: As you navigate your bucket, your path appears above the list of folders and files. You can click a folder or bucket in this path to go back to that directory.

4. Double-click to open a compatible file. You can save files by using the File menu in JupyterLab.

What's next

• Learn more about Cloud Storage.

• Learn how to query data in BigQuery from within JupyterLab.