Enabling and disabling Studio in Looker

Preview

This product or feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the Service Specific Terms. Pre-GA products and features are available "as is" and might have limited support. For more information, see the launch stage descriptions.

This document provides guidance for enabling the Studio in Looker feature within your Looker (original) or Looker (Google Cloud core) instance.

Important: By enabling Studio in Looker, you agree to the Google Cloud Platform Terms of Service. Use of Studio in Looker is subject to the agreement under which you use Google Cloud, not your Looker agreement.

Requirements and limitations

Before you enable Studio in Looker, ensure that your Looker (original) or Looker (Google Cloud core) instance meets the following requirements:

• Your Looker instance must be running Looker 24.18 or later and be Looker-hosted.
• You must have the Admin Looker role within your Looker instance.
• For Looker (Google Cloud core) instances and for Looker (original) instances that use Google OAuth for authentication, you must submit the sign-up form for the preview.

Additional requirements for Google OAuth

If your Looker instance uses Google OAuth for authentication, then you'll also need to create a new Google Cloud project that meets the following requirements:

• The project must be a new Google Cloud project.
• The project can't be linked to an existing Looker Studio Pro subscription.
• The project must belong to your organization.
• You must have the Looker Studio Pro Manager Identity and Access Management (IAM) role on the project.

Warning: To avoid losing any Studio in Looker reports, don't change the Google Cloud project once you've enabled Studio in Looker with Google OAuth. If you change the project, then all reports that are associated with the original Google Cloud project will be permanently deleted.

Limitations

Studio in Looker is in preview, and the following limitations apply:

• Studio in Looker isn't currently compatible with Looker (Google Cloud core) instances that are configured to use CMEK, VPC-SC, or private IP.
• Users won't be able to use Studio in Looker if they log in to their Looker instance by using secondary authentication.

Enabling Studio in Looker

To enable Studio in Looker, follow the instructions for Looker (original) or Looker (Google Cloud core), depending on your authentication method:

• Looker (original) with Google OAuth
• Looker (original) with all other authentication methods
• Looker (Google Cloud core) with Google OAuth
• Looker (Google Cloud core) with all other authentication methods

Looker (original) with Google OAuth

To enable Studio in Looker for a Looker (original) instance that uses Google OAuth for authentication, follow these steps:

1. Submit the sign-up form for the preview, and Looker will enable the feature for your instance.
2. In Looker, navigate to Admin > Labs, and enable the Access Studio in Looker Labs feature.
3. In Looker, navigate to Admin > Platform > BI Connectors, and enable the Looker Studio BI Connector.
4. In Looker, navigate to Admin > Platform > Studio in Looker, and enable the Studio in Looker option.
5. On the Studio in Looker page, fill out the following fields:
   1. Customer ID: Enter the customer ID for your Google Workspace or Cloud Identity account. This is the unique identifier that was assigned to your account when you signed up for Google Workspace or Cloud Identity.
   2. Service account email ID: Enter the service account email ID that was created during the pre-setup process for Studio in Looker. You can find this email ID in the welcome email that you received after you signed up for the preview.
   3. Google Cloud project number: Enter the Google Cloud project number for the Google Cloud project that you created for use with Studio in Looker. This is a unique identifier for that specific project.

Looker (original) with all other authentication methods

To enable Studio in Looker for a Looker (original) instance that uses any authentication method aside from Google OAuth, follow these steps:

1. In Looker, navigate to Admin > Labs, and enable the Studio in Looker Labs feature.
2. In Looker, navigate to Admin > Platform > BI Connectors, and enable the Looker Studio BI connector.
3. In Looker, navigate to Admin > Platform > Studio in Looker, and enable the Studio in Looker option.

Looker (Google Cloud core) with Google OAuth

To enable Studio in Looker for a Looker (Google Cloud core) instance that uses Google OAuth for authentication, follow these steps:

1. Submit the sign-up form for the preview, and Looker will enable the feature for your instance.
2. In Looker, navigate to Admin > Platform > BI Connectors, and enable the Looker Studio BI Connector.
3. In Looker, navigate to Admin > Platform > Studio in Looker, and enable the Studio in Looker option.
4. On the Studio in Looker page, fill out the following fields:
   1. Customer ID: Enter the customer ID for your Google Workspace or Cloud Identity account. This is a unique identifier that was assigned to your account when you signed up for Google Workspace or Cloud Identity.
   2. Service account email ID: Enter the service account email ID that was created during the pre-setup process for Studio in Looker. You can find this email ID in the welcome email that you received after you signed up for the preview.
   3. Google Cloud project number: Enter the Google Cloud project number for the Google Cloud project that you created for use with Studio in Looker. This is a unique identifier for that specific project.

Looker (Google Cloud core) with all other authentication methods

To enable Studio in Looker for a Looker (Google Cloud core) instance that uses any authentication method aside from Google OAuth, follow these steps:

1. Submit the sign-up form for the preview, and Looker will enable the feature on your instance.
2. In Looker, navigate to Admin > Platform > BI Connectors, and enable the Looker Studio BI connector.
3. In Looker, navigate to Admin > Platform > Studio in Looker, and enable the Studio in Looker option.

Disabling Studio in Looker

Warning: Disabling Studio in Looker permanently deletes all the Studio in Looker reports that were created on this Looker instance. This action cannot be undone.

To disable Studio in Looker, follow these steps:

1. Navigate to Admin > Platform > Studio in Looker.
2. Disable the Enable Studio in Looker option.
3. Confirm your understanding of the data loss by selecting the box.
4. Click Disable Studio in Looker.