Nesta página, você aprende a atualizar rótulos em recursos do BigQuery.
Como atualizar rótulos de conjuntos de dados
Para atualizar o rótulo de um conjunto de dados:
- use o Console do GCP ou a IU clássica da Web do BigQuery;
- Use o comando
bq update
da ferramenta de linha de comando. - Chame o método de API
datasets.patch
. - Use bibliotecas de cliente
Permissões necessárias
Para atualizar um rótulo de conjunto de dados, é necessário ter, no mínimo, as permissões bigquery.datasets.update
. Os papéis predefinidos do Cloud IAM a seguir incluem permissões bigquery.datasets.update
:
bigquery.dataOwner
bigquery.admin
Além disso, quando um usuário com permissões bigquery.datasets.create
cria um conjunto de dados, ele recebe o acesso de bigquery.dataOwner
ao conjunto.
Com o acesso de bigquery.dataOwner
, o usuário consegue atualizar rótulos em um conjunto de dados.
Para mais informações sobre os papéis e as permissões do IAM no BigQuery, consulte Papéis e permissões predefinidos.
Como atualizar um rótulo de conjunto de dados
Para atualizar rótulos em um conjunto de dados:
Console
No Console do GCP, selecione o conjunto de dados.
Na página de detalhes do conjunto de dados, clique no ícone de lápis à direita de Rótulos.
Na caixa de diálogo Editar rótulos:
- Para aplicar outros rótulos, clique em Adicionar rótulo. Cada chave pode ser usada apenas uma vez para cada conjunto de dados, mas é possível usar a mesma chave em conjuntos de dados diferentes dentro do mesmo projeto.
- Modifique as chaves ou valores para atualizar um rótulo.
- Clique em Atualizar para salvar as alterações.
IU clássica
Na IU da Web, selecione o conjunto de dados.
Na página Detalhes do conjunto de dados, à direita de Rótulos, clique em Editar.
Na caixa de diálogo Editar rótulos:
- Para aplicar outros rótulos, clique em Adicionar rótulo. Cada chave pode ser usada apenas uma vez para cada conjunto de dados, mas é possível utilizar a mesma chave em conjuntos de dados diferentes dentro do mesmo projeto.
- Modifique as chaves ou valores para atualizar um rótulo.
Clique em OK.
CLI
Para adicionar ou atualizar um rótulo de conjunto de dados, emita o comando bq update
com a sinalização set_label
. Repita a sinalização para adicionar ou atualizar vários rótulos.
Se o conjunto de dados estiver em um projeto diferente do padrão, adicione o ID do projeto ao conjunto neste formato: [PROJECT_ID]:[DATASET]
.
bq update \ --set_label key:value \ project_id:dataset
Em que:
- key:value corresponde a um par de chave-valor para um rótulo que você quer adicionar ou atualizar. Se você especificar a mesma chave que a de um rótulo atual, seu valor será atualizado. A chave precisa ser exclusiva;
- project_id é o ID do projeto;
- dataset é o conjunto de dados que você está atualizando.
Por exemplo:
Para atualizar o rótulo department
em mydataset
, insira o comando bq update
e especifique department
como a chave do rótulo. Por exemplo, para atualizar o rótulo department:shipping
para department:logistics
, insira o comando abaixo. mydataset
está em myotherproject
, e não no projeto padrão.
bq update \
--set_label department:logistics \
myotherproject:mydataset
O resultado será semelhante ao mostrado a seguir.
Dataset 'myotherproject:mydataset' successfully updated.
API
Para atualizar um rótulo em um conjunto de dados atual ou adicionar outros rótulos, chame o método datasets.patch
e adicione ou atualize a propriedade labels
do recurso de conjunto de dados.
Como o método datasets.update
substitui todo o recurso do conjunto de dados, recomenda-se usar o datasets.patch
.
Go
Antes de testar este exemplo, 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.
Java
Nesta amostra, a biblioteca de cliente HTTP do Google para Java é usada para enviar uma solicitação à API do BigQuery.
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para saber mais informações, consulte a documentação de referência da API BigQuery Java.
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.
Como atualizar rótulos de tabelas e visualizações
Para atualizar um rótulo depois que uma tabela ou visualização é criada:
- use o Console do GCP ou a IU clássica da Web 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 da tabela, use o método
tables.patch
para modificar as visualizações e tabelas.
- Como as visualizações são tratadas como recursos da tabela, use o método
- use bibliotecas de cliente.
Permissões necessárias
Para atualizar um rótulo de visualização ou de tabela, é necessário ter, no mínimo, as permissões bigquery.tables.update
. Os papéis predefinidos do Cloud IAM a seguir incluem permissões bigquery.tables.update
:
bigquery.dataEditor
bigquery.dataOwner
bigquery.admin
Além disso, quando um usuário com permissões bigquery.datasets.create
cria um conjunto de dados, ele recebe o acesso de bigquery.dataOwner
ao conjunto.
Com o acesso de bigquery.dataOwner
, o usuário consegue atualizar rótulos nos respectivos conjuntos de dados e nas tabelas e visualizações nesses conjuntos.
Para mais informações sobre os papéis e as permissões do Cloud IAM no BigQuery, consulte Permissões e papéis predefinidos.
Como atualizar um rótulo de visualização ou de tabela
Para atualizar um rótulo de visualização ou de tabela, faça o seguinte:
Console
No Console do GCP, selecione a tabela ou a visualização.
Clique na guia Detalhes e no ícone de lápis à direita de Rótulos.
Na caixa de diálogo Editar rótulos:
- Para aplicar outros rótulos, clique em Adicionar rótulo. Cada chave pode ser usada apenas uma vez por tabela ou visualização, mas é possível utilizar a mesma chave em tabelas ou visualizações em conjuntos de dados diferentes.
- Modifique as chaves ou valores para atualizar um rótulo.
- Clique em Atualizar para salvar as alterações.
IU clássica
Na IU da Web, selecione a tabela ou a visualização.
Na página de detalhes, à direita de Rótulos, clique em Editar. Este exemplo mostra os detalhes de uma tabela.
Na caixa de diálogo Editar rótulos:
- Para incluir mais rótulos, clique em Adicionar rótulo. Cada chave pode ser usada apenas uma vez por tabela ou visualização, mas é possível utilizar a mesma chave em tabelas ou visualizações em conjuntos de dados diferentes.
- Modifique as chaves ou valores para atualizar um rótulo.
Clique em OK.
CLI
Para adicionar ou atualizar um rótulo de visualização ou tabela, emita o comando bq
update
com a sinalização set_label
. Repita a sinalização para adicionar ou atualizar vários rótulos.
Se a tabela ou visualização estiver em um projeto diferente do padrão, adicione o ID do projeto ao conjunto neste formato: project_id:dataset
.
bq update \ --set_label key:value \ project_id:dataset.table_or_view
Em que:
- key:value corresponde a um par de chave-valor para um rótulo que você quer adicionar ou atualizar. Se você especificar a mesma chave que a de um rótulo atual, seu valor será atualizado. A chave precisa ser exclusiva;
- project_id é o ID do projeto;
- dataset é o conjunto de dados que contém a tabela ou a visualização que você está atualizando;
- table_or_view é o nome da tabela ou visualização que você está atualizando.
Por exemplo:
Para atualizar o rótulo department
em mytable
, insira o comando bq update
e especifique department
como a chave do rótulo. Por exemplo, para atualizar o rótulo department:shipping
para department:logistics
em mytable
, insira o comando a seguir. mytable
está em myotherproject
, e não no projeto padrão.
bq update \
--set_label department:logistics \
myotherproject:mydataset.mytable
O resultado será semelhante ao mostrado a seguir:
Table 'myotherproject:mydataset.mytable' successfully updated.
API
Para atualizar um rótulo em uma tabela ou visualização atual ou adicionar outros rótulos, chame o método tables.patch
e adicione ou atualize a propriedade labels
do recurso de tabela.
Como as visualizações são tratadas como recursos da tabela, use o método tables.patch
para modificar as visualizações e tabelas.
Como o método tables.update
substitui todo o recurso do conjunto de dados, recomenda-se usar o tables.patch
.
Go
Antes de testar este exemplo, 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.
Java
Nesta amostra, a biblioteca de cliente HTTP do Google para Java é usada para enviar uma solicitação à API do BigQuery.
Antes de testar esta amostra, siga as instruções de configuração do Java no Guia de início rápido do BigQuery: como usar bibliotecas de cliente. Para saber mais informações, consulte a documentação de referência da API BigQuery Java.
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.
Como atualizar rótulos de job
Atualmente, não é possível atualizar um rótulo de job. Para atualizar o rótulo de um job, reenvie o job com um novo rótulo especificado.
Como converter rótulos em tags
Um rótulo que tem uma chave com um valor vazio é usado como tag. É possível criar um rótulo sem valor ou transformar um atual em uma tag em um conjunto de dados, tabela ou visualização. Não é possível converter um rótulo de job em uma tag.
As tags são úteis nas situações em que você está rotulando um recurso, mas não precisa do formato key:value
. Por exemplo, se você tem uma tabela que contém dados de teste usados por vários grupos (suporte, desenvolvimento e assim por diante), é possível adicionar uma tag test_data
à tabela para identificá-la.
Permissões necessárias
Para converter um rótulo em uma tag, você precisa ter, no mínimo, as mesmas permissões exigidas para atualizar rótulos.
bigquery.datasets.update
para converter um rótulo de conjunto de dados.bigquery.tables.update
para converter um rótulo de tabela ou visualização.
Os papéis predefinidos do Cloud IAM a seguir incluem permissões bigquery.datasets.update
:
bigquery.dataOwner
bigquery.admin
Os papéis predefinidos do Cloud IAM a seguir incluem permissões bigquery.tables.update
:
bigquery.dataEditor
bigquery.dataOwner
bigquery.admin
Além disso, quando um usuário com permissões bigquery.datasets.create
cria um conjunto de dados, ele recebe o acesso de bigquery.dataOwner
ao conjunto.
Com o acesso de bigquery.dataOwner
, o usuário consegue atualizar rótulos nos respectivos conjuntos de dados e nas tabelas e visualizações nesses conjuntos.
Para mais informações sobre os papéis e as permissões do Cloud IAM no BigQuery, consulte Permissões e papéis predefinidos.
Como converter um rótulo em uma tag
Para converter um rótulo em uma tag:
Console
No Console do GCP, selecione o conjunto de dados, a tabela ou a visualização.
No caso dos conjuntos de dados, a página "Detalhes do conjunto de dados" é aberta automaticamente. Para tabelas e visualizações, clique em Detalhes para abrir essa página.
Na página de detalhes, clique no ícone de lápis à direita de Rótulos.
Na caixa de diálogo Editar rótulos, faça o seguinte:
- Exclua o valor de um rótulo existente.
- Clique em Atualizar.
IU clássica
Na IU da Web, selecione o conjunto de dados, a tabela ou a visualização.
No caso dos conjuntos de dados, a página Detalhes do conjunto de dados é aberta automaticamente. Para tabelas e visualizações, clique em Detalhes para abrir essa página.
Na página de detalhes, à direita de Rótulos, clique em Editar.
Na caixa de diálogo Editar rótulos:
- Exclua o valor de um rótulo existente.
Clique em OK.
CLI
Para converter um rótulo em uma tag, use o comando bq update
com a sinalização set_label
. Determine a chave, seguida por dois-pontos, mas deixe o valor sem especificação. Isso atualiza um rótulo atual para uma tag.
bq update \ --set_label key: \ resource_id
Em que:
- key: é a chave de rótulo que você quer atualizar para uma tag;
- resource_id é um nome válido do conjunto de dados, tabela ou visualização. Se o recurso estiver em um projeto diferente do padrão, adicione o ID do projeto neste formato:
project_id:dataset
.
Por exemplo:
Insira o comando a seguir para alterar o rótulo test_data:development
atual em mydataset
para uma tag. mydataset
está em myotherproject
, e não no projeto padrão.
bq update --set_label test_data: myotherproject:mydataset
O resultado será semelhante ao mostrado a seguir:
Dataset 'myotherproject:mydataset' successfully updated.
API
Para transformar um rótulo atual em uma tag, chame o método datasets.patch
ou tables.patch
e substitua os valores do rótulo pela string vazia (""
) no recurso de conjunto de dados ou de tabela.
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
.
A seguir
- Saiba como adicionar rótulos a recursos do BigQuery.
- Saiba como visualizar rótulos nos recursos do BigQuery.
- Saiba como filtrar recursos usando rótulos.
- Saiba como excluir rótulos em recursos do BigQuery.
- Leia Como usar rótulos na documentação do Resource Manager.