Gestire i dati utilizzando la console Google Cloud
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Questa pagina spiega come esplorare e gestire i dati di AlloyDB per PostgreSQL
utilizzando AlloyDB Studio nella console Google Cloud .
AlloyDB Studio include un riquadro Explorer che
si integra con un editor di query e una tabella dei risultati delle query SQL.
Puoi eseguire istruzioni DDL, DML e DQL da questa singola interfaccia. Ad esempio, anziché configurare uno strumento di query del database di terze parti, puoi creare una tabella o eseguire query sui dati utilizzando questo editor di query.
Se non hai mai utilizzato AlloyDB per PostgreSQL, consulta la
panoramica di AlloyDB.
Puoi utilizzare il riquadro Explorer in AlloyDB Studio per visualizzare e interagire
con gli oggetti del database. Puoi creare, modificare ed eliminare i seguenti
oggetti di database:
Schemi
Tabelle
Colonne
Indici e chiavi
Trigger
Visualizzazioni
Funzioni
Procedure
Sequenze
Tipi
Estensioni
Ruoli e autorizzazioni richiesti
Per utilizzare AlloyDB Studio, devi disporre delle seguenti autorizzazioni:
Scegliere un metodo di autenticazione del database
Prima di poter accedere a un database in AlloyDB Studio, devi prima selezionare un
metodo di autenticazione del database. Per accedere al database utilizzando
AlloyDB Studio, puoi utilizzare uno dei seguenti tipi di autenticazione:
Autenticazione IAM dei database: utilizza l'autenticazione IAM per gestire l'accesso al database e i privilegi per gli utenti della tua organizzazione. Per utilizzare questa funzionalità, configura l'autenticazione IAM sull'istanza.
Autenticazione del database integrata: connettiti al database in
AlloyDB Studio utilizzando il tuo account utente e le tue credenziali PostgreSQL. Per
maggiori informazioni, consulta
Gestire gli utenti PostgreSQL con l'autenticazione integrata.
Esplora i tuoi dati
Per accedere al riquadro Explorer:
Nella console Google Cloud , apri la pagina AlloyDB.
Fai clic su Authenticate (Autentica). Il riquadro Explorer mostra un elenco degli oggetti nel database.
Creare, modificare ed eseguire query sui dati
Puoi utilizzare l'editor di query per eseguire istruzioni SQL. Le istruzioni devono essere separate
da un punto e virgola. Componi una query o compila l'editor di query con un modello.
L'esecuzione delle istruzioni si basa sull'ordine in cui le inserisci nell'editor di query.
Per creare, interrogare o modificare i dati:
Nella console Google Cloud , apri la pagina AlloyDB.
Nel menu di navigazione, fai clic su AlloyDB Studio.
Accedi ad AlloyDB Studio utilizzando il nome del database, il nome utente e la password.
Componi una query utilizzando uno dei seguenti metodi:
Per comporre la tua query:
Fai clic su addNuova scheda dell'editor SQL o su addNuova scheda per aprire una nuova scheda.
Quando viene visualizzato l'editor di query, scrivi la query.
Per comporre una query che inizia con un modello, segui questi passaggi:
Nel riquadro Explorer, accanto a un oggetto di database,
fai clic su more_vertVisualizza azioni. Vengono visualizzate una o più azioni disponibili.
Fai clic su un'azione. L'editor di query viene compilato con un modello.
Sostituisci i segnaposto nel modello.
Fai clic su Esegui. Vengono eseguite tutte le query nell'editor di query. I risultati della query vengono visualizzati nella tabella Risultati.
Puoi anche selezionare ed eseguire una o più query contemporaneamente.
Per farlo, seleziona una o più query e fai clic su Esegui selezione.
Limitazioni
AlloyDB Studio supporta le query leggere. Le risposte superiori a 10 MB potrebbero
essere troncate. AlloyDB Studio indica quando restituisce risultati parziali.
Le query o le creazioni di indici a esecuzione prolungata su tabelle di grandi dimensioni che superano i cinque
minuti sull'istanza vengono interrotte e annullate.
AlloyDB Studio non mantiene aperta una connessione al database dopo il completamento dell'esecuzione
di uno script SQL. Allo stesso modo, le schede Editor non condividono una
sessione comune e ogni esecuzione avvia una nuova connessione utilizzando una
sessione separata.
Quando esegui più istruzioni di query contemporaneamente e una
delle query genera un errore, l'intera query viene annullata.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Difficile da capire","hardToUnderstand","thumb-down"],["Informazioni o codice di esempio errati","incorrectInformationOrSampleCode","thumb-down"],["Mancano le informazioni o gli esempi di cui ho bisogno","missingTheInformationSamplesINeed","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-04 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)."]]
