Cette page a été traduite par l'API Cloud Translation.

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 console Google Cloud .

Bigtable Studio comprend 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ête, dans lequel vous pouvez 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 CLI cbt .

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

L'explorateur vous permet d'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 consultant les insights sur le 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ête
Vue matérialisée	Afficher la définition dans l'éditeur de requête Activer ou désactiver la protection contre la suppression

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

Dans la console Google Cloud , 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 console Google Cloud , 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ête

L'éditeur de requête 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 dans l'ordre dans lequel vous les saisissez dans l'éditeur de requête.

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

Dans la console Google Cloud , 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édiger une requête :
1. Ouvrez un nouvel onglet en cliquant sur , puis sélectionnez Éditeur.
2. Lorsque l'éditeur de requête s'affiche, rédigez votre requête. Si la requête est une requête 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 (with_history => TRUE) à l'ID de la table.
(Facultatif) Pour mettre en forme votre instruction au format 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 le tableau des résultats. Le volet Détails de la ligne s'ouvre. Chaque qualificatif de colonne et sa valeur sont affichés 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 forme de struct qui inclut la valeur et le code temporel de la cellule.
Facultatif : Pour n'exécuter qu'une partie 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 le tableau Résultats.

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

Pour en savoir plus, y compris pour obtenir des exemples, sur la création d'instructions SQL permettant d'interroger vos données Bigtable, consultez la présentation de GoogleSQL pour 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.
Exporter vers Google Sheets
Copier dans le Presse-papiers au format CSV, TSV ou JSON

Pour exporter les résultats d'une requête depuis l'éditeur ou le générateur de requêtes, procédez comme suit :

Dans la console Google Cloud , 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.
Exécutez votre requête depuis l'onglet Générateur ou Éditeur.

Les résultats s'affichent dans le tableau 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 logiques

Bigtable Studio vous permet de créer et d'enregistrer des vues logiques de vos tables Bigtable. Les opérations sur les vues logiques nécessitent des autorisations supplémentaires par rapport à celles accordées dans roles/bigtable.reader. Pour en savoir plus, consultez la documentation de chaque type de vue.

Vues autorisées

Vous pouvez utiliser l'outil de création 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 aux vues autorisées et les supprimer 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

Vous pouvez utiliser l'éditeur de requêtes pour créer une vue matérialisée, c'est-à-dire un résultat précalculé d'une requête SQL exécutée en continu et synchronisée avec sa table source à l'aide de mises à jour incrémentielles. Les vues matérialisées 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ête pour créer une vue logique, c'est-à-dire une requête enregistrée qui peut être interrogée comme une table. Pour en savoir plus, consultez Créer et gérer des vues.