Supprimer des libellés

Cette page explique comment supprimer les libellés des ressources BigQuery.

Présentation

Vous pouvez supprimer un libellé d'un ensemble de données de l'une des manières suivantes :

  • En utilisant la console GCP ou l'interface utilisateur Web classique de BigQuery
  • En utilisant la commande bq update de l'outil de ligne de commande
  • En appelant les méthodes API datasets.patch ou tables.patch
  • En utilisant les bibliothèques clientes

Autorisations requises

Pour supprimer un libellé d'ensemble de données, vous devez au minimum disposer des autorisations bigquery.datasets.get et bigquery.datasets.update. Les rôles Cloud IAM prédéfinis suivants incluent les autorisations bigquery.datasets.update et bigquery.datasets.get :

  • bigquery.dataOwner
  • bigquery.admin

En outre, si un utilisateur dispose des autorisations bigquery.datasets.create, lorsqu'il crée un ensemble de données, il obtient également le rôle bigquery.dataOwner qui lui permet d'y accéder. L'accès bigquery.dataOwner donne à l'utilisateur la possibilité de supprimer les libellés des ensembles de données et des tables et vues qu'ils contiennent.

Pour en savoir plus sur les rôles et les autorisations Cloud IAM dans BigQuery, consultez la page Rôles et autorisations prédéfinis.

Supprimer un libellé d'ensemble de données

Pour supprimer un libellé d'un ensemble de données, procédez comme suit :

Console

  1. Dans la console GCP, sélectionnez l'ensemble de données.

  2. Sur la page des détails de l'ensemble de données, cliquez sur l'icône en forme de crayon située à droite de Labels (Libellés).

    Icône en forme de crayon pour modifier un libellé

  3. Dans la boîte de dialogue Edit Labels (Modifier les libellés), effectuez les opérations suivantes :

    • Cliquez sur l'icône de suppression (X) à côté de chaque libellé que vous souhaitez supprimer.
    • Cliquez sur Mettre à jour pour enregistrer vos modifications.

Interface utilisateur classique

  1. Dans l'interface utilisateur Web, sélectionnez l'ensemble de données.

  2. Sur la page Dataset Details (Détails de l'ensemble de données), cliquez sur le bouton Edit (Modifier) situé à droite du champ Labels (Libellés).

  3. Dans la boîte de dialogue Edit Labels (Modifier les libellés), effectuez les opérations suivantes :

    • Cliquez sur l'icône de suppression (X) à côté de chaque libellé que vous souhaitez supprimer.
    • Cliquez sur OK.

      Supprimer le libellé

CLI

Pour supprimer un libellé d'ensemble de données, exécutez la commande bq update en spécifiant l'indicateur clear_label. Répétez le paramètre pour supprimer plusieurs libellés.

Si l'ensemble de données se trouve dans un projet autre que celui par défaut, ajoutez l'ID du projet au nom de l'ensemble de données, en respectant le format suivant : project_id:dataset.

bq update \
--clear_label key \
project_id:dataset

Où :

  • key est la clé d'un libellé que vous souhaitez supprimer.
  • project_id est l'ID du projet.
  • dataset est le nom de l'ensemble de données que vous mettez à jour.

Exemples :

Pour supprimer le libellé department:shipping de mydataset, saisissez la commande bq update en spécifiant le paramètre --clear_label. L'ensemble de données mydataset se trouve dans votre projet par défaut.

    bq update --clear_label department mydataset

Pour supprimer le libellé department:shipping de mydataset dans le projet myotherproject, saisissez la commande bq update en spécifiant le paramètre --clear_label.

    bq update --clear_label department myotherproject:mydataset

Pour supprimer plusieurs libellés d'un ensemble de données, répétez le paramètre clear_label et spécifiez la clé de chaque libellé. Si vous souhaitez par exemple supprimer les libellés department:shipping et cost_center:logistics de l'ensemble de données mydataset dans votre projet par défaut, saisissez la commande suivante :

    bq update \
    --clear_label department \
    --clear_label cost_center \
    mydataset

Pour chacun de ces exemples, le résultat ressemble à ce qui suit :

Dataset 'myproject:mydataset' successfully updated.

API

Pour supprimer un libellé spécifique d'un ensemble de données existant, appelez la méthode datasets.patch, puis mettez à jour la propriété labels de la ressource d'ensemble de données en définissant la valeur de clé du libellé sur null.

Pour supprimer tous les libellés d'un ensemble de données, appelez la méthode datasets.patch, puis supprimez la propriété labels.

Comme la méthode datasets.update remplace la ressource d'ensemble de données dans son intégralité, il est préférable d'utiliser la méthode datasets.patch.

Go

Avant d'essayer l'exemple ci-dessous, suivez la procédure de configuration pour Go décrite dans le guide de démarrage rapide de BigQuery relatif à l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery Go.

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
ds := client.Dataset(datasetID)
meta, err := ds.Metadata(ctx)
if err != nil {
	return err
}
update := bigquery.DatasetMetadataToUpdate{}
update.DeleteLabel("color")
if _, err := ds.Update(ctx, update, meta.ETag); err != nil {
	return err
}

Python

Avant d'essayer l'exemple ci-dessous, suivez la procédure de configuration pour Python décrite dans le guide de démarrage rapide de BigQuery relatif à l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API BigQuery Python.

# from google.cloud import bigquery
# client = bigquery.Client()
# dataset_ref = client.dataset('my_dataset')
# dataset = client.get_dataset(dataset_ref)  # API request

# This example dataset starts with one label
assert dataset.labels == {"color": "green"}
# To delete a label from a dataset, set its value to None
dataset.labels["color"] = None

dataset = client.update_dataset(dataset, ["labels"])  # API request

assert dataset.labels == {}

Supprimer un libellé de table ou de vue

Vous pouvez supprimer un libellé de table ou de vue de l'une des manières suivantes :

  • À l'aide de la console GCP ou de l'UI Web classique de BigQuery
  • En utilisant la commande bq update de l'outil de ligne de commande
  • En appelant la méthode API tables.patch
    • Comme les vues sont traitées comme des ressources de table, la méthode tables.patch permet de modifier à la fois des vues et des tables.
  • En utilisant les bibliothèques clientes

Autorisations requises

Pour supprimer un libellé de table ou de vue, vous devez au minimum disposer des autorisations bigquery.tables.update et bigquery.tables.get. Les rôles Cloud IAM prédéfinis suivants incluent les autorisations bigquery.tables.update et bigquery.tables.get :

  • bigquery.dataEditor
  • bigquery.dataOwner
  • bigquery.admin

En outre, si un utilisateur dispose des autorisations bigquery.datasets.create, lorsqu'il crée un ensemble de données, il obtient également le rôle bigquery.dataOwner qui lui permet d'y accéder. L'accès bigquery.dataOwner donne à l'utilisateur la possibilité de supprimer les libellés des tables et des vues d'un ensemble de données.

Pour en savoir plus sur les rôles et les autorisations Cloud IAM dans BigQuery, consultez la page Rôles et autorisations prédéfinis.

Supprimer un libellé de table ou de vue

Pour supprimer un libellé d'une table ou d'une vue, procédez comme suit :

Console

  1. Dans la console GCP, sélectionnez l'ensemble de données.

  2. Cliquez sur l'onglet Details (Détails), puis sur l'icône représentant un crayon à droite de Labels (Libellés).

    Icône en forme de crayon pour modifier un libellé

  3. Dans la boîte de dialogue Edit Labels (Modifier les libellés), effectuez les opérations suivantes :

    • Cliquez sur l'icône de suppression (X) à côté de chaque libellé que vous souhaitez supprimer.

      Libellé supprimé

    • Cliquez sur Mettre à jour pour enregistrer vos modifications.

Interface utilisateur classique

  1. Dans l'UI Web, sélectionnez la table ou la vue.

  2. Sur la page Détails, cliquez sur le bouton Modifier situé à droite du champ Libellés.

  3. Dans la boîte de dialogue Edit Labels (Modifier les libellés), effectuez les opérations suivantes :

    • Cliquez sur l'icône de suppression (X) à côté de chaque libellé que vous souhaitez supprimer.
    • Cliquez sur OK.

      Supprimer le libellé

CLI

Pour supprimer un libellé d'une table ou d'une vue, exécutez la commande bq update en spécifiant l'indicateur clear_label. Répétez le paramètre pour supprimer plusieurs libellés.

Si la table ou la vue se trouve dans un projet autre que celui par défaut, ajoutez l'ID du projet au nom de l'ensemble de données, en respectant le format suivant : project_id:dataset.

bq update \
--clear_label key \
project_id:dataset.table_or_view

Où :

  • key est la clé d'un libellé que vous souhaitez supprimer.
  • project_id est l'ID du projet.
  • dataset est le nom de l'ensemble de données que vous mettez à jour.
  • table_or_view est le nom de la table ou de la vue que vous mettez à jour.

Exemples :

Pour supprimer le libellé department:shipping de mydataset.mytable, saisissez la commande bq update en spécifiant l'indicateur --clear_label. L'ensemble de données mydataset se trouve dans votre projet par défaut.

    bq update --clear_label department mydataset.mytable

Pour supprimer le libellé department:shipping de mydataset.myview dans le projet myotherproject, saisissez la commande bq update en spécifiant le paramètre --clear_label.

    bq update --clear_label department myotherproject:mydataset.myview

Pour supprimer plusieurs libellés d'une table ou d'une vue, répétez l'indicateur clear_label et spécifiez la clé de chaque libellé. Si vous souhaitez par exemple supprimer les libellés department:shipping et cost_center:logistics de la table mydataset.mytable dans votre projet par défaut, saisissez la commande suivante :

    bq update \
    --clear_label department \
    --clear_label cost_center \
    mydataset.mytable

Pour chacun de ces exemples, le résultat ressemble à ce qui suit :

Table 'myproject:mydataset.mytable' successfully updated.

API

Pour supprimer un libellé spécifique d'une table ou d'une vue existante, appelez la méthode tables.patch, puis mettez à jour la propriété labels de la ressource de table en définissant la valeur de clé du libellé sur null.

Pour supprimer tous les libellés d'une table ou d'une vue, appelez la méthode tables.patch, puis supprimez la propriété labels.

Comme les vues sont traitées comme des ressources de table, la méthode tables.patch permet de modifier à la fois des vues et des tables. En outre, comme la méthode tables.update remplace la ressource d'ensemble de données dans son intégralité, il est préférable d'utiliser la méthode tables.patch.

Go

Avant d'essayer l'exemple ci-dessous, suivez la procédure de configuration pour Go décrite dans le guide de démarrage rapide de BigQuery relatif à l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API BigQuery Go.

// To run this sample, you will need to create (or reuse) a context and
// an instance of the bigquery client.  For example:
// import "cloud.google.com/go/bigquery"
// ctx := context.Background()
// client, err := bigquery.NewClient(ctx, "your-project-id")
tbl := client.Dataset(datasetID).Table(tableID)
meta, err := tbl.Metadata(ctx)
if err != nil {
	return err
}
update := bigquery.TableMetadataToUpdate{}
update.DeleteLabel("color")
if _, err := tbl.Update(ctx, update, meta.ETag); err != nil {
	return err
}

Python

Avant d'essayer l'exemple ci-dessous, suivez la procédure de configuration pour Python décrite dans le guide de démarrage rapide de BigQuery relatif à l'utilisation des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence sur l'API BigQuery Python.

# from google.cloud import bigquery
# client = bigquery.Client()
# table_ref = client.dataset('my_dataset').table('my_table')
# table = client.get_table(table_ref)  # API request

# This example table starts with one label
assert table.labels == {"color": "green"}
# To delete a label from a table, set its value to None
table.labels["color"] = None

table = client.update_table(table, ["labels"])  # API request

assert table.labels == {}

Supprimer des libellés de tâche

Actuellement, il n'est pas possible de supprimer un libellé d'une tâche existante.

Étapes suivantes

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.