Gérer vos données à l'aide de Bigtable Studio

Cette page explique comment explorer et gérer vos données Bigtable à l'aide de Bigtable Studio dans la Google Cloud console.

Bigtable Studio inclut un volet Explorateur qui s'intègre aux éléments suivants :

Générateur de requêtes : formulaire interactif qui vous permet de créer et d'exécuter une requête sans écrire de code
Éditeur de requêtes : vous pouvez y créer et exécuter des commandes SQL
Table des résultats de la requête SQL

Si vous débutez avec Bigtable, découvrez comment créer une instance et écrire des données avec la cbt CLI .

Rôles requis

Pour obtenir les autorisations nécessaires pour interroger une table, demandez à votre administrateur de vous accorder les rôles IAM suivants sur l'instance contenant la table :

Tous : lecteur Bigtable (roles/bigtable.reader)

Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Explorer des données

Vous pouvez utiliser l'explorateur pour effectuer les actions suivantes sur vos ressources Bigtable :

Ressource Bigtable	Actions de l'explorateur
Table	Créer une table Créer une sauvegarde Empêcher la suppression Modifier Supprimer Afficher un exemple de requête Afficher les sauvegardes Surveiller en affichant les insights système Exporter vers Cloud Storage
Familles de colonnes	Ajouter une famille de colonnes à une table
Famille de colonnes spécifique	Modifier une stratégie de récupération de mémoire
Vue autorisée	Ouvrir dans le générateur de requêtes Accorder l'accès Supprimer
Afficher	Afficher la définition dans l'éditeur de requêtes
Vue matérialisée	Afficher la définition dans l'éditeur de requêtes Activer ou désactiver la protection contre la suppression

Pour accéder à l'explorateur, procédez comme suit :

Dans la Google Cloud console, ouvrez la page Instances Bigtable.

Accéder à la liste des instances
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Bigtable Studio. Le volet Explorateur affiche la liste des tables et des vues autorisées dans l'instance.

Interroger vos données dans le générateur de requêtes

Le générateur de requêtes est un formulaire interactif qui vous permet d'envoyer des requêtes de lecture à l' API Bigtable Data depuis la Google Cloud console sans avoir à écrire de code ni d'instructions SQL. Pour en savoir plus, consultez Créer des requêtes dans la console.

Interroger vos données avec SQL dans l'éditeur de requêtes

L'éditeur de requêtes vous permet d'exécuter n'importe quelle combinaison d'instructions SQL SELECT. Les instructions doivent être séparées par un point-virgule.

Les instructions sont exécutées en fonction de l'ordre dans lequel vous les saisissez dans l'éditeur de requêtes.

Pour interroger vos données, procédez comme suit :

Dans la Google Cloud console, ouvrez la page Instances Bigtable.

Accéder à la liste des instances
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Bigtable Studio.
Rédigez une requête :
1. Ouvrez un nouvel onglet en cliquant sur puis en sélectionnant Éditeur.
2. Lorsque l'éditeur de requête s'affiche, rédigez votre requête. Si la requête est un code SQL valide, le message Valide s'affiche.
3. (Facultatif) Pour renvoyer toutes les cellules des colonnes interrogées au lieu de la cellule la plus récente uniquement, ajoutez l'ID de la table avec (with_history => TRUE).
(Facultatif) Pour mettre en forme votre instruction dans le style SQL, cliquez sur Mettre en forme.
Cliquez sur Exécuter. Les résultats de votre requête s'affichent dans la table Résultats.
Pour afficher les données d'une ligne dans un format mis en forme, cliquez sur la ligne dans la table des résultats. Le volet Détails de la ligne s'ouvre. Chaque qualificateur de colonne et sa valeur s'affichent sur une nouvelle ligne. Si vous exécutez la requête à l'aide de (with_history => TRUE), chaque cellule d'une colonne est présentée sous la forme d'une structure qui inclut la valeur et l'horodatage de la cellule.
(Facultatif) Pour n'exécuter qu'une partie sélectionnée du texte dans l'éditeur, mettez-la en surbrillance, puis cliquez sur Exécuter la sélection. Les résultats de la requête mise en surbrillance s'affichent dans la table Résultats.

Pour supprimer tout le texte de l'éditeur de requêtes, cliquez sur Effacer.

Pour en savoir plus, y compris des exemples, sur la création d'instructions SQL pour interroger vos données Bigtable, consultez la présentation de Bigtable.

Exporter des résultats de requête

Vous pouvez exporter les résultats de votre requête de l'une des manières suivantes :

Téléchargez un fichier local au format CSV ou JSON.
Exportez vers Google Sheets.
Copiez dans le presse-papiers au format CSV, TSV ou JSON.

Pour exporter les résultats de requête à partir de l'éditeur de requêtes ou du générateur de requêtes, procédez comme suit :

Dans la Google Cloud console, ouvrez la page Instances Bigtable.

Accéder à la liste des instances
Sélectionnez une instance dans la liste.
Dans le menu de navigation, cliquez sur Bigtable Studio.

Le volet Explorateur affiche la liste des tables, des vues et des requêtes dans l'instance.
Exécutez votre requête à partir de l'onglet Générateur ou Éditeur.

Les résultats s'affichent dans la table Résultats.
Dans la barre d'outils Résultats, cliquez sur Exporter.
Dans le menu, sélectionnez l'une des options d'exportation.

Si vous avez sélectionné Exporter vers Google Sheets, une boîte de dialogue s'affiche. Cliquez sur Ouvrir pour afficher vos résultats dans Google Sheets.

Créer des vues

Bigtable Studio vous permet de créer et d'enregistrer des vues de vos tables Bigtable. Pour en savoir plus, consultez la documentation de chaque type de vue.

Vues autorisées

Vous pouvez utiliser le générateur de requêtes pour créer et enregistrer des vues autorisées, qui sont des sous-ensembles de tables auxquels vous accordez l'accès séparément de l'accès à la table. Vous pouvez également accorder l'accès et supprimer des vues autorisées dans Bigtable Studio à l'aide du menu Action de l'explorateur.

Pour en savoir plus, consultez Créer et gérer des vues autorisées.

Vues matérialisées continues

Vous pouvez utiliser l'éditeur de requêtes pour créer une vue matérialisée continue, un résultat précalculé d'une requête SQL en cours d'exécution qui se synchronise avec sa table source à l'aide de mises à jour incrémentielles. Les vues matérialisées continues contiennent souvent des données agrégées basées sur les valeurs de leurs tables sources.

Pour en savoir plus, consultez la documentation suivante :

Vues logiques

Vous pouvez également utiliser l'éditeur de requêtes pour créer une vue logique, une requête enregistrée qui peut être interrogée comme une table. Les opérations de vue logique nécessitent des autorisations au-delà de celles accordées dans roles/bigtable.reader. Pour en savoir plus, consultez Créer et gérer des vues logiques.

Requêtes enregistrées

Vous pouvez utiliser Bigtable Studio pour créer, enregistrer et gérer des scripts SQL en tant que requêtes enregistrées. Pour en savoir plus, consultez la documentation suivante :