Modifier les données d'une table
Utilisez la grille d'aperçu de la table pour ajouter, modifier et supprimer des lignes directement — avec une pagination en direct sur les grandes tables et une protection automatique des colonnes masquées et gouvernées.
La page d'aperçu de la table (Analytics → Tables → [table] → Preview) affiche une grille de données en direct pour toute table gérée active. Preview est l'onglet sur lequel une table s'ouvre par défaut : les données sont donc la première chose que vous voyez. Au-delà de la consultation en lecture seule, elle vous permet d'apporter des modifications au niveau des lignes directement depuis l'interface — sans SQL.
Ce que vous pouvez faire
Les possibilités de modification dépendent de la présence d'une clé primaire sur la table.
| Type de table | Modifier une cellule | Supprimer une ligne | Ajouter un enregistrement |
|---|---|---|---|
| Table avec clé primaire | Oui | Oui | Oui |
| Table sans clé primaire | Non | Non | Oui (ajout) |
StarRocks — le moteur OLAP sous-jacent — exige une clé primaire pour cibler une ligne précise lors d'une mise à jour ou d'une suppression. Les tables sans clé primaire acceptent de nouvelles lignes (mode ajout) mais ne peuvent pas mettre à jour ni supprimer les lignes existantes.
Modifier une cellule
Cliquez sur n'importe quelle cellule d'une colonne modifiable pour l'ouvrir en édition. Saisissez votre valeur et appuyez sur Entrée (ou cliquez ailleurs) pour enregistrer. La plateforme envoie un upsert partiel — seule la cellule modifiée change ; le reste de la ligne reste intact. Appuyez sur Échap pour annuler.
Ajouter un enregistrement
Cliquez sur + Add record dans la barre d'outils. Une ligne vide apparaît en haut de la grille pour que vous la remplissiez. Vous pouvez passer d'une cellule à l'autre avec la touche Tab. Cliquez sur Save (ou appuyez sur Entrée dans la dernière cellule) pour valider la ligne. La ligne est ajoutée lorsque la table n'a pas de clé primaire ; elle fait l'objet d'un upsert sur la clé primaire lorsqu'une clé est définie.
Supprimer des lignes
Sur une table avec clé primaire, survolez une ligne pour faire apparaître l'icône de suppression dans la marge de la ligne. Confirmez pour supprimer définitivement la ligne. Les suppressions ne sont pas groupées — chaque ligne est supprimée individuellement.
Afficher le détail d'une ligne
Cliquez sur n'importe quelle ligne de la grille pour ouvrir le panneau de détail de la ligne — un panneau latéral qui affiche toutes les valeurs de colonne de cette ligne, y compris les colonnes masquées sous leur forme stylisée. Vous pouvez aussi l'ouvrir depuis le menu ⋯ de la ligne → View details.
Le panneau de détail est en lecture seule. Utilisez-le pour inspecter une ligne sans quitter la page, copier des valeurs de champ individuelles ou examiner les métadonnées de gouvernance (masque, type) de chaque colonne.
Actions par ligne
Chaque ligne dispose d'un menu ⋯ (actions) dans la dernière colonne. Les actions par défaut pour les tables gérées sont :
- View details — ouvre le panneau de détail de la ligne.
- Copy row — copie les valeurs de la ligne dans le presse-papiers au format JSON.
- Delete row — supprime définitivement la ligne (tables avec clé primaire uniquement).
Le menu ⋯, la case à cocher et les cellules modifiables arrêtent tous la propagation, de sorte qu'un clic sur ces éléments ne déclenche jamais le panneau de détail associé au clic sur la ligne.
Colonnes masquées
Les colonnes auxquelles un masque de gouvernance est appliqué affichent leur valeur fournie par le serveur (par exemple, une révélation partielle telle que les quatre derniers chiffres d'un numéro de carte) avec un style de texte atténué et une icône de bouclier. La valeur n'est pas soustraite à l'interface — le serveur a déjà décidé de ce qu'il fallait révéler. Le traitement visuel signale que la colonne est gouvernée ; la cellule n'est pas modifiable, quel que soit le statut de clé primaire de la table.
Si vous pensez qu'une colonne devrait afficher une valeur plus complète mais que ce n'est pas le cas, vérifiez votre rôle dans l'espace de travail et les paramètres de gouvernance de la colonne sous Classification & masking.
- Colonnes cachées — les colonnes que votre politique d'accès exclut entièrement. Elles n'apparaissent pas du tout dans la grille.
L'autorisation est appliquée côté serveur. L'interface reflète vos permissions, mais la route d'écriture les vérifie de manière indépendante — vous ne pouvez pas contourner le masquage ou les restrictions de colonnes par des appels d'API directs.
État de chargement
Pendant le chargement de la première page de données, la grille affiche des lignes squelettes — des cellules d'espace réservé animées qui reprennent la forme de l'ensemble de colonnes. La page présente ainsi une structure visible immédiatement, avant même qu'aucune ligne ne soit arrivée de l'entrepôt.
Pagination sur les grandes tables
La grille utilise le défilement infini pour parcourir les grandes tables dans l'aperçu. Les lignes sont chargées par lots de 100. Lorsque vous approchez du bas de la grille, le lot suivant est récupéré automatiquement et ajouté à la grille sans saut de page. Un indicateur de chargement apparaît en bas pendant la récupération du lot suivant.
La barre d'outils affiche le nombre de lignes chargées (par ex. 100 of 24 830 rows). Le nombre total est un COUNT(*) calculé sur le serveur et peut mettre un moment à apparaître sur les très grandes tables.
La ligne d'en-tête est fixe — elle reste épinglée en haut de la zone de défilement pendant que vous parcourez les lignes, de sorte que les libellés de colonne sont toujours visibles.
- Refresh — recharge à partir de la première page. Utilisez-le après une écriture pour voir votre modification prise en compte.
Le défilement infini sert à la consultation. La pagination par clé (curseur) sous-jacente s'applique toujours — la grille n'envoie jamais l'ensemble complet des lignes au client. Chaque lot est une nouvelle requête serveur à partir d'un curseur stable.
Indicateur de temps de requête
La barre d'outils affiche une pastille de temps de requête (par ex. 42 ms) indiquant la durée de la récupération de la page côté serveur. Il s'agit de l'aller-retour complet au sein de l'entrepôt : le chiffre reflète le temps d'exécution de StarRocks et n'inclut pas la latence réseau entre votre navigateur et le serveur d'API.
Limitations
- Tables au format Iceberg : la grille d'aperçu est en lecture seule pour les tables migrées vers le lakehouse Iceberg. La modification des tables Iceberg n'est pas prise en charge dans cette version.
- Pagination arrière : le curseur ne va que vers l'avant. Cliquer sur Previous revient en arrière via une pile de curseurs côté client — revenir loin en arrière puis avancer à nouveau recharge les pages intermédiaires.
- Requêtes ad hoc / complexes : le filtrage, le tri et l'affichage/masquage des colonnes sont disponibles dans la barre d'outils de l'aperçu. Pour les jointures multi-tables, les agrégations ou les requêtes qui dépassent le générateur de règles, utilisez la surface SQL (
Analytics → SQL).
Voir aussi
- Tables gérées — cycle de vie, écritures et modes d'écriture.
- Classification et masquage — fonctionnement des masques et des politiques d'accès.
- Requêtes — lecture depuis les workflows, les notebooks et SQL.