Gerenciar seus dados usando o console do Google Cloud
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Nesta página, explicamos como analisar e gerenciar seus dados do AlloyDB para PostgreSQL usando o AlloyDB Studio no console Google Cloud .
O AlloyDB Studio inclui um painel do Explorer que se integra a um editor de consultas e a uma tabela de resultados de consulta SQL.
É possível executar instruções DDL, DML e DQL nessa única interface. Por exemplo, em vez de configurar uma ferramenta de consulta de banco de dados de terceiros, é possível criar uma tabela ou consultar seus dados usando esse editor de consultas.
Use o painel Explorer no AlloyDB Studio para visualizar e interagir com seus objetos do banco de dados. Você pode criar, alterar e excluir os seguintes objetos de banco de dados:
Esquemas
Tabelas
Colunas
Índices e chaves
Gatilhos
Visualizações
Funções
Procedimentos
Sequências
Tipos
Extensões
Papéis e permissões necessárias
Para usar o AlloyDB Studio, você precisa das seguintes permissões:
Escolher um método de autenticação de banco de dados
Antes de acessar um banco de dados no AlloyDB Studio, você precisa selecionar um método de autenticação. Para fazer login no banco de dados usando o AlloyDB Studio, use um dos seguintes tipos de autenticação:
Autenticação do banco de dados do IAM: com a autenticação do IAM, é possível gerenciar o acesso e os privilégios do banco de dados para usuários na sua organização. Para usar isso, configure a autenticação do IAM na instância.
Autenticação de banco de dados integrada: você se conecta ao banco de dados no AlloyDB Studio usando sua conta de usuário e credenciais do PostgreSQL. Para mais informações, consulte Gerenciar usuários do PostgreSQL com autenticação padrão.
Explore seus dados
Para acessar o painel Explorer, siga estas etapas:
No console do Google Cloud , abra a página AlloyDB.
Clique em Autenticar. O painel Explorer mostra uma lista dos objetos no seu banco de dados.
Criar, modificar e consultar seus dados
É possível usar o editor de consultas para executar instruções SQL. As instruções precisam ser separadas por ponto e vírgula. Você pode criar uma consulta por conta própria ou preencher o editor com um modelo.
As instruções são executadas com base na ordem em que são inseridas no editor de consultas.
Para criar, consultar ou modificar seus dados, siga estas etapas:
No console do Google Cloud , abra a página AlloyDB.
Faça login no AlloyDB Studio usando o nome do seu banco de dados, nome de usuário e senha.
Crie uma consulta usando um dos seguintes métodos:
Para criar sua consulta, siga estas etapas:
Abra uma nova guia clicando em addNova guia do editor de SQL ou addNova guia.
Quando o editor de consultas aparecer, crie sua consulta.
Para criar uma consulta começando com um modelo, siga estas etapas:
No painel Explorer, ao lado de um objeto do banco de dados, clique em Ver ações de more_vert. Uma ou mais ações disponíveis são exibidas.
Clique em uma ação. O editor de consultas é preenchido com um modelo.
Substitua os marcadores de posição no modelo.
Clique em Executar. Isso executa todas as consultas no editor. Os resultados da consulta aparecem na tabela Resultados.
Você também pode selecionar e executar uma ou várias consultas ao mesmo tempo. Para fazer isso, selecione uma ou várias consultas e clique em Executar selecionadas.
Limitações
O AlloyDB Studio oferece suporte a consultas leves. Respostas com mais de 10 MB podem ficar truncadas. O AlloyDB Studio indica quando resultados parciais são retornados.
Consultas de longa duração ou criações de índice em tabelas grandes que excedam 5 minutos na instância vão atingir o tempo limite e serão canceladas.
O AlloyDB Studio não mantém uma conexão de banco de dados aberta após a execução de um script SQL ser concluída. Da mesma forma, as guias do Editor não compartilham uma sessão em comum, e cada execução inicia uma nova conexão usando uma sessão separada.
Quando você executa várias instruções de consulta ao mesmo tempo e uma delas resulta em um erro, toda a consulta é cancelada.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-25 UTC."],[[["\u003cp\u003eAlloyDB Studio, accessible via the Google Cloud console, provides a unified interface to explore and manage your AlloyDB for PostgreSQL data, including a query editor and results table.\u003c/p\u003e\n"],["\u003cp\u003eThe Explorer pane within AlloyDB Studio allows users to create, alter, and delete various database objects like schemas, tables, columns, indexes, and functions, among others.\u003c/p\u003e\n"],["\u003cp\u003eTo access AlloyDB Studio, you need specific permissions, such as \u003ccode\u003ealloydb.clusters.get\u003c/code\u003e and \u003ccode\u003ealloydb.instances.executeSql\u003c/code\u003e, which can be granted through predefined or custom roles, along with necessary database-level permissions.\u003c/p\u003e\n"],["\u003cp\u003eUsers can compose SQL queries directly in the query editor or use templates provided for specific database actions, then run these queries and view the results in the Results table.\u003c/p\u003e\n"],["\u003cp\u003eAlloyDB Studio is subject to some limitations, including support for lightweight queries only, responses over 10MB being truncated, no persistent connections or shared sessions between editor tabs, and only supporting username and password authentication.\u003c/p\u003e\n"]]],[],null,["# Manage your data using the Google Cloud console\n\nThis page explains how to explore and manage your AlloyDB for PostgreSQL data\nusing AlloyDB Studio in the Google Cloud console.\n\nAlloyDB Studio includes an **Explorer** pane that\nintegrates with a query editor and a SQL query results table.\nYou can run DDL, DML, and DQL statements from this single interface. For\nexample, instead of configuring a third-party database query tool, you can\ncreate a table or query your data using this query editor.\n\nIf you're new to AlloyDB for PostgreSQL, see\n[AlloyDB overview](/alloydb/docs/overview).\n\nYou can use the **Explorer** pane in AlloyDB Studio to view and interact\nwith your database objects. You can create, alter, and delete the following\ndatabase objects:\n\n- Schemas\n- Tables\n- Columns\n- Indexes and keys\n- Triggers\n- Views\n- Functions\n- Procedures\n- Sequences\n- Types\n- Extensions\n\nRequired roles and permissions\n------------------------------\n\n\n| **Caution:** Users with broad database access could experience data loss when using Gemini. We recommend that you use an account with fewer database privileges when using Gemini.\n\n\u003cbr /\u003e\n\nTo use AlloyDB Studio, you need the following permissions:\n\n- `alloydb.clusters.get`\n- `alloydb.databases.list`\n- `alloydb.instances.executeSql`\n- `alloydb.instances.list`\n- `alloydb.users.list`\n\nYou can get these permissions through the\n[`roles/alloydb.admin`](/alloydb/docs/reference/iam-roles-permissions#roles)\nrole, or using a combination of\n[`roles/alloydb.viewer`](/alloydb/docs/reference/iam-roles-permissions#roles)\nand\n[`roles/alloydb.databaseUser`](/alloydb/docs/reference/iam-roles-permissions#roles)\nroles. If you don't have these roles, contact your Organization Administrator to\nrequest access. You might also be able to get the required permissions through\n[custom roles](/iam/docs/creating-custom-roles) or other\n[predefined roles](/iam/docs/understanding-roles).\n\nAdditionally, ensure that\nyou have [database-level permissions](/alloydb/docs/database-users/about)\nfor the database that you use for authentication.\n\nChoose a database authentication method\n---------------------------------------\n\nBefore you can access a database in AlloyDB Studio, you must first select a\ndatabase authentication method. To sign in to your database using\nAlloyDB Studio, you can use one of the following types of authentication:\n\n- IAM database authentication: use IAM\n authentication to manage the database access and privileges for users in your\n organization. To use this, set up\n [IAM authentication](/alloydb/docs/database-users/manage-iam-auth)\n on the instance.\n\n- Built-in database authentication: connect to the database in\n AlloyDB Studio by using your PostgreSQL user account and credentials. For\n more information, see\n [Manage PostgreSQL users with built-in authentication](/alloydb/docs/database-users/manage-roles).\n\nExplore your data\n-----------------\n\nTo access the **Explorer** pane, follow these steps:\n\n1. In the Google Cloud console, open the **AlloyDB** page.\n\n [Go to AlloyDB](https://console.cloud.google.com/alloydb)\n2. Select a cluster from the list.\n\n3. In the navigation menu, click **AlloyDB Studio**.\n\n4. Select a [database authentication method](#authentication).\n\n5. Click **Authenticate** . The **Explorer** pane displays a list of the objects\n in your database.\n\nCreate, modify, and query your data\n-----------------------------------\n\nYou can use the query editor to run SQL statements. Statements must be separated\nby a semicolon. Compose a query yourself, or populate the query editor with a\ntemplate.\n\nStatement execution is based on the order in which you enter them in the query\neditor.\n\nTo create, query, or modify your data, follow these steps:\n\n1. In the Google Cloud console, open the **AlloyDB** page.\n\n [Go to AlloyDB](https://console.cloud.google.com/alloydb)\n2. Select a cluster from the list.\n\n3. In the navigation menu, click **AlloyDB Studio**.\n\n4. Sign in to AlloyDB Studio using the name of your database, username,\n and password.\n\n5. Compose a query using one of the following methods:\n\n - To compose your own query, follow these steps:\n\n 1. Click add **New SQL editor tab** or add **New tab** to open a new tab.\n 2. When the query editor appears, write your query.\n - To compose a query that starts with a template, follow these steps:\n\n 1. In the **Explorer** pane, next to a database object, click more_vert **View actions**. One or more available actions appear.\n 2. Click an action. The query editor populates with a template.\n 3. Replace any placeholders in the template.\n6. Click **Run** . This executes all the queries in the query editor. The\n results of your query appear in the **Results** table.\n\n You can also select and execute one or multiple queries at the same time.\n To do this, select a query or multiple queries and click **Run selected**.\n\nLimitations\n-----------\n\n- AlloyDB Studio supports lightweight queries. Responses over 10MB might be truncated. AlloyDB Studio indicates when it returns partial results.\n- Long-running queries or index creations on large tables that exceed five minutes on the instance are timed-out and cancelled.\n- AlloyDB Studio doesn't keep a database connection open after execution of a SQL script is complete. Similarly, the **Editor** tabs don't share a common session and every execution starts a new connection using a separate session.\n- When you run multiple query statements at the same time, and one of the queries results in an error, then the whole query is cancelled.\n\nWhat's next\n-----------\n\n- Learn more about how [Gemini can help you write SQL or analyze your data](/alloydb/docs/write-sql-gemini)."]]
