Interroger les données

L'éditeur SQL unifié de l'extension IDE Google Cloud Data Agent Kit vous permet d'exécuter des requêtes SQL sur vos données Google Cloud directement depuis votre IDE.

Si vous utilisez le plug-in Data Agent Kit avec un agent de codage compatible, vous pouvez exécuter des requêtes SQL dans l'agent ou utiliser des requêtes en langage naturel pour générer des requêtes SQL.

Sources de données prises en charge

Le kit d'agent de données vous permet d'interroger des tables et des vues dans les services de donnéesGoogle Cloud suivants :

• BigQuery
• Bigtable
• Spanner
• AlloyDB pour PostgreSQL
• Cloud SQL pour MySQL
• Cloud SQL pour PostgreSQL

Pour Cloud SQL, les requêtes utilisant Identity and Access Management#39;authentification IAM pour les bases de données et l'authentification intégrée pour les bases de données (avec des mots de passe stockés en tant que secrets régionaux dans Secret Manager) sont acceptées. Pour en savoir plus sur la façon dont Cloud SQL authentifie les utilisateurs intégrés avec Secret Manager, consultez la section "Exécuter des instructions SQL à l'aide de l'API Data" pour Cloud SQL pour MySQL et Cloud SQL pour PostgreSQL. Pour AlloyDB, seules les requêtes utilisant l'authentification IAM pour les bases de données sont acceptées.

Avant de commencer

Avant d'interroger vos données, procédez comme suit :

1. Installez l'extension.
2. Configurez les paramètres de l'extension.
3. Consultez les conseils de la section Rechercher et explorer des données.

Créer un fichier SQL

Vous pouvez ouvrir l'éditeur SQL de plusieurs façons.

Créer un fichier SQL à partir du menu "Fichier"

1. Dans la barre de menu VS Code, cliquez sur Fichier, puis sur Nouveau fichier texte. Un fichier sans titre s'affiche dans l'éditeur.
2. Enregistrez le nouveau fichier avec l'extension .sql.
3. Cliquez sur Sélectionner une connexion dans l'onglet de l'éditeur.
4. Suivez la procédure décrite dans Configurer les paramètres de requête.

Créer une requête à partir du catalogue

1. Dans l'onglet Google Cloud Data Agent Kit de la barre d'activité, développez Catalogue pour trouver l'ensemble de données que vous souhaitez interroger.
2. Effectuez un clic droit ou Ctrl+clic sur le nom de l'ensemble de données, puis sélectionnez Requête pour ouvrir un fichier SQL préconfiguré pour cet ensemble de données.

Créer une requête dans la section BigQuery

1. Dans l'onglet Google Cloud Data Agent Kit de la barre d'activité, développez BigQuery.
2. Cliquez sur + Nouvelle requête. Un fichier SQL sans titre configuré avec BigQuery comme source de données s'affiche dans l'éditeur.

Configurer les paramètres de requête

Les paramètres requis pour votre requête SQL varient en fonction du service Google Cloud .

AlloyDB

1. Dans l'éditeur SQL, cliquez sur Ouvrir les paramètres de la requête.
2. Sélectionnez Bases de données.
3. Sélectionnez AlloyDB.
4. Sélectionnez un cluster.
5. Sélectionnez une instance. Votre requête est alors redirigée vers cette instance.
6. Sélectionnez une base de données.
7. Cliquez sur Enregistrer.

BigQuery

1. Dans l'éditeur SQL, cliquez sur Ouvrir les paramètres de la requête.
2. Sélectionnez BigQuery.
3. Cliquez sur Enregistrer.

Bigtable

1. Dans l'éditeur SQL, cliquez sur Ouvrir les paramètres de la requête.
2. Sélectionnez Bases de données.
3. Sélectionnez Bigtable.
4. Sélectionnez une instance.
5. Facultatif : Pour utiliser un profil d'application autre que celui par défaut, sélectionnez-le.
6. Rédigez votre requête.
7. Cliquez sur Enregistrer.

Cloud SQL

1. Dans l'éditeur SQL, cliquez sur Ouvrir les paramètres de la requête.
2. Sélectionnez Bases de données.
3. Sélectionnez Cloud SQL.
4. Sélectionnez une instance. Votre requête est alors redirigée vers cette instance.
5. Sélectionnez une base de données à interroger.

6. Sous Méthode d'authentification, sélectionnez la méthode d'authentification :

   • Authentification IAM pour les bases de données : authentifiez-vous à l'aide de votre compte Google Cloud .

   • Authentification intégrée à la base de données : authentifiez-vous en tant qu'utilisateur de base de données intégré dont le mot de passe est stocké en tant que secret régional dans Secret Manager.

     1. Dans la liste Utilisateur, sélectionnez un utilisateur de base de données. Si la liste ne peut pas être chargée, saisissez le nom d'utilisateur dans le champ Utilisateur. Pour Cloud SQL pour MySQL, l'utilisateur root par défaut n'est pas pris en charge.
     2. Dans la liste Mot de passe (stocké dans Secret Manager), sélectionnez le secret régional qui stocke le mot de passe de l'utilisateur. Si vous n'avez pas encore de secret, sélectionnez Créer un secret dans la région REGION, saisissez un Nom et un Mot de passe, puis cliquez sur Créer un secret. Le secret est créé dans la même région que votre instance.
     3. Facultatif : Dans la liste Version du secret, sélectionnez une version spécifique. Par défaut, latest est sélectionné, ce qui utilise toujours la dernière version du secret.

     Pour en savoir plus sur les exigences concernant les utilisateurs intégrés et les secrets régionaux, consultez la section "Exécuter des instructions SQL à l'aide de l'API Data" pour Cloud SQL pour MySQL et Cloud SQL pour PostgreSQL.

7. Cliquez sur Enregistrer.

Spanner

1. Dans l'éditeur SQL, cliquez sur Ouvrir les paramètres de la requête.
2. Sélectionnez Bases de données.
3. Sélectionnez Spanner.
4. Sélectionnez une instance. Votre requête est alors redirigée vers cette instance.
5. Sélectionnez une base de données à interroger.
6. Cliquez sur Enregistrer.

Modifier les paramètres des requêtes

Les paramètres de requête sont spécifiques à chaque fichier SQL. Une fois que vous avez ouvert un fichier SQL, vous pouvez modifier les paramètres.

1. Dans l'éditeur, cliquez sur la source de données affichée. L'éditeur Paramètres de la requête s'affiche.
2. Suivez la procédure décrite dans Configurer les paramètres de requête.

Exécuter une requête

Une fois que vous avez créé un fichier de requête et rédigé votre requête, cliquez sur ▷ Exécuter la requête.

L'onglet Résultats du volet Résultats de la requête affiche les résultats de la requête.

Pour exécuter un sous-ensemble d'instructions SQL dans l'éditeur de requête, mettez-le en surbrillance avant de cliquer sur ▷ Exécuter la requête.

Fonctionnalités de l'éditeur SQL

Toutes les fonctionnalités de l'éditeur SQL ne sont pas compatibles avec tous les types de sources de données. Le tableau suivant liste les fonctionnalités de l'éditeur SQL compatibles par type de source de données pendant la version Preview.

Fonctionnalité	BigQuery	Bigtable	Spanner	Cloud SQL	AlloyDB pour PostgreSQL
Résultats de la requête	✅	✅	✅	✅	✅
Informations sur le poste	Non applicable	Non applicable	Non applicable	Non applicable	Non applicable
Détails de l'exécution	✅	✅ Temps écoulé	❌ Non compatible	❌ Non compatible	❌ Non compatible
Visualisation	✅	✅	✅	✅	✅
Paramètres de requête	✅	✅	✅	✅	✅
Compatibilité avec les requêtes à plusieurs instructions	✅	✅	✅	✅	✅
Catalogue : insérer le nom de la ressource dans l'éditeur	✅	✅	✅	✅	✅

Étapes suivantes

• Transformer les données
• Résoudre les problèmes