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 Google Cloud données 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 invites en langage naturel pour générer des requêtes SQL.

Sources de données prises en charge

Data Agent Kit vous permet d'interroger des tables et des vues dans les services de données suivants Google Cloud :

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

Pour AlloyDB et Cloud SQL, les requêtes utilisant l'authentification IAM sont prises en charge. Vous ne pouvez pas interroger les bases de données configurées pour utiliser Auth Proxy ou l'authentification par mot de passe.

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 manières.

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

  1. Dans la barre de menu VS Code, cliquez sur File (Fichier), puis sur New Text File (Nouveau fichier texte). Un fichier sans titre s'affiche dans l'éditeur.
  2. Enregistrez le nouveau fichier avec l'extension .sql.
  3. Cliquez sur Select Connection (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és, développez Catalog (Catalogue) pour trouver l'ensemble de données que vous souhaitez interroger.
  2. Faites un clic droit ou ctrl+clic sur le nom de l'ensemble de données, puis sélectionnez Query (Requête) pour ouvrir un fichier SQL préconfiguré pour cet ensemble de données.

Créer une requête à partir de la section BigQuery

  1. Dans l'onglet Google Cloud Data Agent Kit de la barre d'activités, développez BigQuery.
  2. Cliquez sur + New Query (+ 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 Google Cloud service.

AlloyDB

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

BigQuery

  1. Dans l'éditeur SQL, cliquez sur Open Query Settings (Ouvrir les paramètres de requête).
  2. Sélectionnez BigQuery.
  3. Cliquez sur Save (Enregistrer).

Cloud SQL

  1. Dans l'éditeur SQL, cliquez sur Open Query Settings (Ouvrir les paramètres de requête).
  2. Sélectionnez Databases (Bases de données).
  3. Sélectionnez Cloud SQL.
  4. Sélectionnez une instance. Votre requête est acheminée vers cette instance.
  5. Sélectionnez une base de données à interroger.
  6. Cliquez sur Save (Enregistrer).

Spanner

  1. Dans l'éditeur SQL, cliquez sur Open Query Settings (Ouvrir les paramètres de requête).
  2. Sélectionnez Databases (Bases de données).
  3. Sélectionnez Spanner.
  4. Sélectionnez une instance. Votre requête est acheminée vers cette instance.
  5. Sélectionnez une base de données à interroger.
  6. Cliquez sur Save (Enregistrer).

Modifier les paramètres de requête

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 Settings (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 ▷ Run Query (Exécuter la requête).

L'onglet Results (Résultats) du volet Query Results (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 ▷ Run Query (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 répertorie les fonctionnalités de l'éditeur SQL compatibles par type de source de données pendant la preview.

Fonctionnalité

BigQuery

Spanner

Cloud SQL

AlloyDB pour PostgreSQL

Onglets du volet "Résultats de la requête"

Résultats de la requête

✅

✅

✅

✅

Informations sur la tâche

✅

Non applicable

Non applicable

Non applicable

Détails de l'exécution

✅

❌

Non compatible

❌

Non compatible

❌

Non compatible

Visualisation

✅

✅

✅

✅

Configuration de l'éditeur SQL

Paramètres de requête

✅

✅

✅

✅

Autres fonctionnalités

Compatibilité avec les requêtes à plusieurs instructions

✅

✅

✅

✅

Catalogue : insérer le nom de la ressource dans l'éditeur

✅

✅

✅

✅

Étape suivante