Como excluir rótulos

Nesta página, explicamos como remover rótulos de recursos do BigQuery.

Visão geral

Para remover um rótulo de um conjunto de dados, tabela ou visualização:

  • Use o Console do GCP ou a IU da Web clássica.
  • Use o comando bq update da ferramenta de linha de comando.
  • Chame os métodos da API datasets.patch ou tables.patch.
  • Use as bibliotecas de cliente.

Permissões necessárias

No mínimo, para remover um rótulo de conjunto de dados, é necessário ter as permissões bigquery.datasets.get e bigquery.datasets.update. Os papéis predefinidos do Cloud IAM a seguir incluem permissões bigquery.datasets.update e bigquery.datasets.get:

  • bigquery.dataOwner
  • bigquery.admin

Além disso, quando um usuário com permissões bigquery.datasets.create cria um conjunto de dados, recebe o acesso de bigquery.dataOwner ao conjunto. O acesso bigquery.dataOwner oferece ao usuário a capacidade de remover rótulos dos respectivos conjuntos de dados e de tabelas e visualizações contidas nesses conjuntos de dados.

Para mais informações sobre papéis e permissões do Cloud IAM no BigQuery, consulte Controle de acesso.

Como excluir um rótulo de conjunto de dados

Para remover um rótulo de um conjunto de dados, faça o seguinte:

Console

  1. No Console do GCP, selecione o conjunto de dados.

  2. Na página de detalhes do conjunto de dados, clique no ícone de lápis à direita de Rótulos.

    Lápis de rótulo

  3. Na caixa de diálogo Editar rótulos:

    • Clique no ícone de exclusão (X) para cada rótulo que você quer remover.
    • Clique em Atualizar para salvar as alterações.

IU clássica

  1. Na IU da Web, selecione o conjunto de dados.

  2. Na página Detalhes do conjunto de dados, à direita de Rótulos, clique em Editar.

  3. Na caixa de diálogo Editar rótulos:

    • Clique no ícone de exclusão (X) para cada rótulo que você quer remover.
    • Clique em OK.

      Excluir rótulo

CLI

Para remover um rótulo de conjunto de dados, insira o comando bq update com a sinalização clear_label. Repita a sinalização para remover vários rótulos.

Se o conjunto de dados estiver em um projeto diferente do padrão, adicione o código do projeto ao conjunto neste formato: project_id:dataset.

bq update \
--clear_label key \
project_id:dataset

Em que:

  • key é a chave de um rótulo que você quer remover;
  • project_id é o código do projeto;
  • dataset é o conjunto de dados que você está atualizando.

Exemplos:

Para remover o rótulo department:shipping de mydataset, insira o comando bq update com a sinalização --clear_label. mydataset está no projeto padrão.

    bq update --clear_label department mydataset

Para remover o rótulo department:shipping de mydataset em myotherproject, insira o comando bq update com a sinalização --clear_label.

    bq update --clear_label department myotherproject:mydataset

Para remover vários rótulos de um conjunto de dados, repita a sinalização clear_label e especifique a chave de cada rótulo. Por exemplo, para remover os rótulos department:shipping e cost_center:logistics de mydataset no projeto padrão, digite:

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

Para cada um desses exemplos, tem esta aparência:

Dataset 'myproject:mydataset' successfully updated.

API

Para remover um rótulo específico de um conjunto de dados atual, chame o método datasets.patch e atualize a propriedade labels do recurso do conjunto de dados definindo o valor da chave do rótulo como null.

Para remover todos os rótulos de um conjunto de dados, chame o método datasets.patch e remova a propriedade labels.

Como o método datasets.update substitui todo o recurso do conjunto de dados, recomenda-se usar o datasets.patch.

Go

Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da 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

Antes de testar esta amostra, siga as instruções de configuração do Python em Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da 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 == {}

Como excluir um rótulo de visualização ou tabela

Para remover o rótulo de uma tabela ou visualização:

  • use o Console do GCP ou a IU da Web clássica do BigQuery;
  • Use o comando bq update da ferramenta de linha de comando.
  • Chame o método de API tables.patch.
    • Como as visualizações são tratadas como recursos de tabela, tables.patch é usado para modificar as visualizações e as tabelas.
  • Use bibliotecas de cliente.

Permissões necessárias

No mínimo, para remover um rótulo de tabela ou visualização, é necessário ter permissões bigquery.tables.update e bigquery.tables.get. Os papéis predefinidos do Cloud IAM a seguir incluem as permissões bigquery.tables.update e bigquery.tables.get:

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

Além disso, quando um usuário com permissões bigquery.datasets.create cria um conjunto de dados, recebe o acesso de bigquery.dataOwner ao conjunto. Com o acesso bigquery.dataOwner, o usuário consegue remover rótulos de tabelas e visualizações em um conjunto de dados.

Para mais informações sobre papéis e permissões do Cloud IAM no BigQuery, consulte Controle de acesso.

Como excluir um rótulo de visualização ou tabela

Para remover um rótulo de uma tabela ou visualização, faça o seguinte:

Console

  1. No Console do GCP, selecione o conjunto de dados.

  2. Clique na guia Detalhes, em seguida clique no ícone de lápis à direita de Rótulos.

    Lápis de rótulo

  3. Na caixa de diálogo Editar rótulos:

    • Clique no ícone de exclusão (X) para cada rótulo que você quer remover.

      Rótulo de exclusão

    • Clique em Atualizar para salvar as alterações.

IU clássica

  1. Na IU da Web, selecione a tabela ou a visualização.

  2. Na página Detalhes, à direita de Rótulos, clique em Editar.

  3. Na caixa de diálogo Editar rótulos:

    • Clique no ícone de exclusão (X) para cada rótulo que você quer remover.
    • Clique em OK.

      Excluir rótulo

CLI

Para remover um rótulo de visualização ou tabela, insira o comando bq update com a sinalização clear_label. Repita a sinalização para remover vários rótulos.

Se a tabela ou visualização estiver em um projeto diferente do padrão, adicione o código do projeto ao conjunto neste formato: project_id:dataset.

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

Em que:

  • key é a chave de um rótulo que você quer remover.
  • project_id é o código do projeto.
  • dataset é o conjunto de dados que você está atualizando.
  • table_or_view é o nome da tabela ou visualização que você está atualizando.

Exemplos:

Para remover o rótulo department:shipping demydataset.mytable, insira o comando bq update com a sinalização --clear_label. mydataset está no projeto padrão.

    bq update --clear_label department mydataset.mytable

Para remover o rótulo department:shipping de mydataset.myview em myotherproject, insira o comando bq update com a sinalização --clear_label.

    bq update --clear_label department myotherproject:mydataset.myview

Para remover vários rótulos de uma tabela ou visualização, repita a sinalização clear_label e especifique a chave de cada rótulo. Por exemplo, para remover os rótulos department:shipping e cost_center:logistics de mydataset.mytable no projeto padrão, digite:

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

Para cada um desses exemplos, tem esta aparência:

Table 'myproject:mydataset.mytable' successfully updated.

API

Para remover um rótulo específico de uma tabela ou visualização atual, chame o método tables.patch e atualize a propriedade labels do recurso de tabela definindo o valor da chave do rótulo como null.

Para remover todos os rótulos de uma tabela ou visualização, chame o método tables.patch e remova a propriedade labels.

Como as visualizações são tratadas como recursos da tabela, use o método tables.patch para modificar as visualizações e tabelas. Além disso, como tables.update substitui todo o recurso do conjunto de dados, recomenda-se o método tables.patch.

Go

Antes de testar esta amostra, siga as instruções de configuração do Go no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery Go (em inglês).

// 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

Antes de testar esta amostra, siga as instruções de configuração do Python no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para mais informações, consulte a documentação de referência da API BigQuery Python (em inglês).

# 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 == {}

Como excluir rótulos de job

No momento, não é possível excluir um rótulo de um job atual.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.