Gérer vos données à l'aide de la console Google Cloud
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Cette page explique comment explorer et gérer vos données AlloyDB pour PostgreSQL à l'aide d'AlloyDB Studio dans la console Google Cloud .
AlloyDB Studio comprend un volet Explorateur qui s'intègre à un éditeur de requêtes et à une table de résultats de requête SQL.
Vous pouvez exécuter des instructions LDD, LMD et DQL à partir de cette interface unique. Par exemple, au lieu de configurer un éditeur de requêtes de base de données tiers, vous pouvez créer une table ou interroger vos données à l'aide de cet éditeur de requêtes.
Vous pouvez utiliser le volet Explorateur d'AlloyDB Studio pour afficher les objets de votre base de données et interagir avec eux. Vous pouvez créer, modifier et supprimer les objets de base de données suivants :
Schémas
Tables
Colonnes
Index et clés
Déclencheurs
Vues
distantes
Procédures
Séquences
Types
Extensions
Rôles et autorisations requis
Pour utiliser AlloyDB Studio, vous devez disposer des autorisations suivantes :
Choisir une méthode d'authentification de la base de données
Avant de pouvoir accéder à une base de données dans AlloyDB Studio, vous devez d'abord sélectionner une méthode d'authentification de la base de données. Pour vous connecter à votre base de données à l'aide d'AlloyDB Studio, vous pouvez utiliser l'un des types d'authentification suivants :
Authentification IAM pour les bases de données : l'authentification IAM vous permet de gérer les accès et les droits d'accès aux bases de données pour les utilisateurs de votre organisation. Pour l'utiliser, configurez l'authentification IAM sur l'instance.
Authentification intégrée à la base de données : vous vous connectez à la base de données dans AlloyDB Studio à l'aide de votre compte et de vos identifiants PostgreSQL. Pour en savoir plus, consultez Gérer les utilisateurs PostgreSQL avec l'authentification standard.
Explorer des données
Pour accéder au volet Explorateur, procédez comme suit :
Dans la console Google Cloud , ouvrez la page AlloyDB.
Cliquez sur Authentifier. Le volet Explorateur affiche la liste des objets de votre base de données.
Créer, modifier et interroger vos données
Vous pouvez utiliser l'éditeur de requête pour exécuter des instructions SQL. Les instructions doivent être séparées par un point-virgule. Vous pouvez composer une requête vous-même ou insérer un modèle dans l'éditeur de requête.
Les instructions sont exécutées dans l'ordre dans lequel vous les saisissez dans l'éditeur de requêtes.
Pour créer, interroger ou modifier vos données, procédez comme suit :
Dans la console Google Cloud , ouvrez la page AlloyDB.
Dans le menu de navigation, cliquez sur AlloyDB Studio.
Connectez-vous à AlloyDB Studio à l'aide du nom de votre base de données, de votre nom d'utilisateur et de votre mot de passe.
Rédigez une requête en utilisant l'une des méthodes suivantes :
Pour composer votre propre requête, procédez comme suit :
Ouvrez un nouvel onglet en cliquant sur addNouvel onglet de l'éditeur SQL ou addNouvel onglet.
Lorsque l'éditeur de requête s'affiche, rédigez votre requête.
Pour composer une requête à partir d'un modèle, procédez comme suit :
Dans le volet Explorateur, à côté d'un objet de base de données, cliquez sur more_vertAfficher les actions. Une ou plusieurs actions disponibles s'affichent.
Cliquez sur une action. Un modèle est inséré dans l'éditeur de requête.
Remplacez tous les espaces réservés dans le modèle.
Cliquez sur Exécuter. Toutes les requêtes de l'éditeur de requête sont alors exécutées. Les résultats de votre requête s'affichent dans le tableau Résultats.
Vous pouvez également sélectionner et exécuter une ou plusieurs requêtes en même temps. Pour ce faire, sélectionnez une ou plusieurs requêtes, puis cliquez sur Exécuter la sélection.
Limites
AlloyDB Studio accepte les requêtes légères. Les réponses de plus de 10 Mo peuvent être tronquées. AlloyDB Studio indique à quel moment les résultats partiels sont renvoyés.
Les requêtes de longue durée ou les créations d'index sur de grandes tables qui dépassent cinq minutes sur l'instance sont annulées en raison du délai avant expiration.
AlloyDB Studio ne maintient pas de connexion à une base de données ouverte une fois l'exécution d'un script SQL terminée. De même, les onglets de l'éditeur ne partagent pas de session commune, et chaque exécution démarre une nouvelle connexion à l'aide d'une session distincte.
Lorsque vous exécutez plusieurs instructions de requête en même temps et que l'une d'elles génère une erreur, l'ensemble de la requête est annulé.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/25 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Difficile à comprendre","hardToUnderstand","thumb-down"],["Informations ou exemple de code incorrects","incorrectInformationOrSampleCode","thumb-down"],["Il n'y a pas l'information/les exemples dont j'ai besoin","missingTheInformationSamplesINeed","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 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)."]]
