This page describes how to explore and manage your Cloud SQL data usingCloud SQL Studio in the Google Cloud console.

Cloud SQL Studio lets authorized users interact directly with the SQL databaseand run SQL queries from the Google Cloud console to access and manipulate data.You can perform a range of actions thatyou would perform on a SQL command line client,such as creating tables and indexes, modifying tables, or setting up views.

Cloud SQL Studio includes anExplorer pane that integrates with a queryeditor and a SQL query results table. You can run DDL, DML, and DQL statementsfrom this one interface. For example, instead of configuring a third-partydatabase query tool, you can create a table and query your data using the queryeditor in Cloud SQL Studio.

You can use theExplorer pane to view and interact with your database objects.You create, alter, and delete the database objects, such as the following:

• Tables
• Columns
• Indexes and keys
• Functions

You can also use theExplorer pane to seedSELECT queries for tables.

If you're new to Cloud SQL, seeCloud SQL overview.

Required roles and permissions

To get the permissions that you need to complete the tasks in this document, ask your administrator to grant you theCloud SQL Studio User (roles/cloudsql.studioUser) IAM role on the project. For more information about granting roles, seeManage access to projects, folders, and organizations.

You might also be able to get the required permissions throughcustom roles or otherpredefined roles.

To use Cloud SQL Studio, you must have the following permissions:

• cloudsql.databases.list
• cloudsql.instances.executeSql
• cloudsql.instances.get
• cloudsql.instances.login (only required if you're using IAM database authentication)
• cloudsql.users.list

Additionally, ensure that you have database-level permissions for the databasethat you're using for authentication, and the password for the privilegeddatabase user that you're using.

Authenticate to Cloud SQL Studio

Before you can access a database in Cloud SQL Studio,you must first select a database authentication method. To sign in to yourdatabase using Cloud SQL Studio, you can use one of the following types of authentication:

• IAM database authentication. Using this type of authentication lets you sign in to your database and Cloud SQL Studio without having to manage an extra password. You can also take advantage ofIAM group authentication and manage the database access and privileges for multiple users in your organization at the same time.

• Built-in database authentication. You connect to the database in Cloud SQL Studio by using your PostgreSQL user account and credentials.

Explore your data

To access theExplorer pane, follow these steps:

1. In the Google Cloud console, go to theCloud SQL Instances page.

   Go to Cloud SQL Instances

2. Select an instance from the list.
3. In the navigation menu, clickCloud SQL Studio.
4. Sign in to Cloud SQL Studio using the name of your database, username,and password. TheExplorer pane displays a list of the objects in yourdatabase.

Create, modify, and query your data

Using the SQL editor, you can run a combination of DDL, DML, and DQL statements.You can compose a query yourself, or you can populate the query editor with atemplate using the explorer.

To structure, modify, or query your data, follow these steps:

1. In the Google Cloud console, go to theCloud SQL Instances page.

   Go to Cloud SQL Instances

2. Select an instance from the list.
3. In the navigation menu, clickCloud SQL Studio.
4. Sign in to Cloud SQL Studio using the name of your database, username, and password.
5. Compose a query using one of the following methods:
   • To compose your own query, follow these steps:
     1. Open a new tab by clickingadd.
     2. When the query editor appears, write your query.
   • To compose a query starting with a template, follow these steps:
     1. In theExplorer pane, next to a database object or collection,clickmore_vertView actions. One or more available actions appear.
     2. Click an action. The query editor populates with a template.
     3. Replace any placeholders in the template.
6. Run your queries using either of the following approaches:
   • To execute all the statements in the query editor, clickRun.
   • To run specific statements, select one or multiple statements, and clickRun selected.
7. The results of your queries appear in theResults tab. If multiple resultsets are available, select a result from theAll results drop-down list.

Limitations

• Cloud SQL Studio supports lightweight queries. Responses over 10MB mightbe truncated. Cloud SQL Studio indicates when partial results are returned.
• You can only run queries for Cloud SQL instances that are running.
• Cloud SQL Studio doesn't support external servers.
• Requests taking longer than five minutes are canceled. Setting a higherquery timeout usingSET STATEMENT_TIMEOUT isn't supported.
• Cloud SQL Studio doesn't keep a database connection open after executionof a SQL script is completed. Similarly, editor tabs don't share a commonsession and every execution starts a new session.
• When you run a mix of DML, DQL, and DDL statements, only results from theDQL queries will be displayed.
• Closing your browser or browser tab doesn't stop the query execution inCloud SQL Studio. The query will run until it completes or times out.

• If you're running multiple statements in the query editorat the same time and one or more statements result inan error, then the execution of all statements is abortedand the first encountered error is displayed.