Gérer vos données à l'aide d'AlloyDB Studio

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 Explorer 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 Explorer 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 via le 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 via des 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 pour la base de données que vous utilisez pour l'authentification.

Explorer des données

Pour accéder au volet Explorateur, procédez comme suit :

  1. Dans la console Google Cloud, ouvrez la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB Studio.

  4. Sélectionnez une base de données et un utilisateur, puis saisissez le mot de passe de l'utilisateur.

  5. 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êtes 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 en fonction de 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:

  1. Dans la console Google Cloud, ouvrez la page AlloyDB.

    Accéder à AlloyDB

  2. Sélectionnez un cluster dans la liste.

  3. Dans le menu de navigation, cliquez sur AlloyDB Studio.

  4. 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.

  5. Rédigez une requête à l'aide de l'une des méthodes suivantes:

    • Pour composer votre propre requête, procédez comme suit:

      1. Ouvrez un nouvel onglet en cliquant sur Nouvel onglet d'éditeur SQL ou Nouvel onglet.
      2. 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:

      1. 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.
      2. Cliquez sur une action. Un modèle est inséré dans l'éditeur de requête.
      3. Remplacez tous les espaces réservés dans le modèle.

  6. Cliquez sur Exécuter. Toutes les requêtes de l'éditeur de requêtes 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 qui prennent plus de cinq minutes sur l'instance sont annulées.
  • 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.
  • AlloyDB Studio n'est compatible qu'avec l'authentification native PostgreSQL (nom d'utilisateur et mot de passe). Vous ne pouvez pas vous authentifier à l'aide de la gestion de l'authentification et des accès ni utiliser des identifiants enregistrés dans Secret Manager.
  • Lorsque vous exécutez plusieurs instructions de requête en même temps et qu'une d'elles génère une erreur, l'ensemble de la requête est annulé.

Étape suivante