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.
Si vous débutez avec AlloyDB pour PostgreSQL, consultez la présentation d'AlloyDB.
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 :
alloydb.clusters.get
alloydb.databases.list
alloydb.instances.executeSql
alloydb.instances.list
alloydb.users.list
Vous pouvez obtenir ces autorisations grâce au rôle roles/alloydb.admin
ou en combinant les rôles roles/alloydb.viewer
et roles/alloydb.databaseUser
. Si vous ne disposez pas de ce rôle, contactez l'administrateur de votre organisation pour demander l'accès. Vous pouvez également obtenir les autorisations requises grâce aux rôles personnalisés ou à d'autres rôles prédéfinis.
En outre, assurez-vous de disposer des autorisations au niveau de la base de données que vous utilisez pour l'authentification.
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 : ce type d'authentification vous permet de profiter de l'authentification de groupe IAM et de gérer l'accès à la base de données et les droits de plusieurs utilisateurs de votre organisation en même temps. 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.
Explorer des données
Pour accéder au volet Explorateur, procédez comme suit :
Dans la console Google Cloud , ouvrez la page AlloyDB.
Sélectionnez un cluster dans la liste.
Dans le menu de navigation, cliquez sur AlloyDB Studio.
Sélectionnez une méthode d'authentification de la base de données.
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.
Sélectionnez un cluster dans la liste.
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 Nouvel onglet de l'éditeur SQL ou Nouvel 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_vert Afficher 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é.
Étapes suivantes
- Découvrez comment Gemini peut vous aider à écrire du code SQL ou à analyser vos données.