Neste documento, descrevemos como atualizar os metadados ou as propriedades de visualização. Depois de criar uma visualização, é possível atualizar as propriedades a seguir:
Permissões necessárias
Para atualizar uma visualização, é preciso ter, no mínimo, as permissões bigquery.tables.update
e bigquery.tables.get
. Se você for atualizar a consulta SQL da visualização, precisará ter também permissões para consultar as tabelas referenciadas pela consulta.
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 bigquery.dataOwner
a ele.
Com o acesso bigquery.dataOwner
, o usuário consegue atualizar tabelas e visualizações no conjunto de dados.
Para mais informações sobre os papéis e as permissões do Cloud IAM no BigQuery, consulte Papéis e permissões predefinidos.
Como atualizar a consulta SQL de uma visualização
Para atualizar a consulta SQL usada para definir uma 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
. - Use bibliotecas de cliente.
É possível alterar o dialeto SQL legado para o padrão por meio da CLI ou da API. No entanto, não é possível atualizar uma visualização de SQL legado para SQL padrão no Console do GCP ou na IU da Web clássica do BigQuery.
Para atualizar a consulta SQL de uma visualização:
Console
No painel Recursos, expanda o projeto e o conjunto de dados e selecione a visualização.
Clique na guia Detalhes.
Acima da caixa Consulta, clique no botão Editar consulta. Clique em Abrir na caixa de diálogo exibida.
Edite a consulta SQL na caixa Editor de consultas e clique em Salvar visualização.
Verifique se todos os campos estão corretos na caixa de diálogo Salvar visualização e clique em Salvar.
IU clássica
Selecione a visualização.
No painel Ver detalhes, clique em Detalhes.
Abaixo da caixa Consulta, clique em Editar consulta.
Edite a consulta SQL na caixa Consulta e clique em Salvar visualização.
CLI
Emita o comando bq update
com a sinalização --view
. Para usar o SQL padrão ou atualizar o dialeto de consulta de SQL legado para padrão, inclua a sinalização --use_legacy_sql
e a defina como false
.
Há recursos de função externos que são definidos pelo usuário. Se a consulta fizer referência a esses recursos e eles estiverem armazenados no Google Cloud Storage ou em arquivos locais, use a sinalização --view_udf_resource
para especificá-los. A sinalização --view_udf_resource
não será demonstrada neste momento. Para mais informações sobre o uso de UDFs, consulte Funções definidas pelo usuário do SQL padrão.
Se você estiver atualizando uma visualização em um projeto diferente do padrão, adicione o código do projeto ao nome do conjunto de dados no formato a seguir: project_id:dataset
.
bq update \ --use_legacy_sql=false \ --view_udf_resource=path_to_file \ --view='query' \ project_id:dataset.view
Em que:
- path_to_file é o URI ou caminho do sistema de arquivos local para um arquivo de código a ser carregado e avaliado imediatamente como recurso de função definido pelo usuário usado pela visualização. Repita a sinalização para especificar vários arquivos;
- query é uma consulta SQL padrão válida;
- project_id é o código do projeto;
- dataset é um conjunto de dados que contém a visualização;
- view é o nome da visualização que você quer atualizar.
Exemplos:
Digite o comando a seguir para atualizar a consulta SQL de uma visualização chamada myview
em mydataset
. mydataset
está no projeto padrão. A consulta de exemplo usada para atualizar a visualização consulta dados do conjunto de dados público USA Name Data.
bq update \
--use_legacy_sql=false \
--view \
'SELECT
name,
number
FROM
`bigquery-public-data.usa_names.usa_1910_current`
WHERE
gender = "M"
ORDER BY
number DESC' \
mydataset.myview
Digite o comando a seguir para atualizar a consulta SQL de uma visualização chamada myview
em mydataset
. mydataset
está em myotherproject
, e não no projeto padrão. A consulta de exemplo usada para atualizar a visualização consulta dados do conjunto de dados público USA Name Data.
bq update \
--use_legacy_sql=false \
--view \
'SELECT
name,
number
FROM
`bigquery-public-data.usa_names.usa_1910_current`
WHERE
gender = "M"
ORDER BY
number DESC' \
myotherproject:mydataset.myview
API
Para atualizar uma visualização, chame o método tables.patch
com um recurso de tabela contendo uma propriedade view
atualizada. Como tables.update
substitui todo o recurso da tabela, o método tables.patch
é recomendado.
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.
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 o prazo de validade de uma visualização
É possível configurar o tempo de expiração padrão da tabela no nível do conjunto de dados (o que afeta tanto as tabelas quanto as visualizações) ou definir o tempo de expiração de uma visualização quando ela é criada. Caso você faça isso durante a criação da visualização, a expiração padrão da tabela do conjunto de dados será ignorada. Se você não definir uma validade padrão de tabela no nível do conjunto de dados nem a validade durante a criação da visualização, a visualização nunca expirará e será necessário excluí-la manualmente.
É possível atualizar o prazo de validade de uma visualização a qualquer momento após criá-la. Para fazer isso:
- Use a IU da Web clássica do BigQuery.
- No momento, não é possível modificar os prazos de validade de visualizações no Console do GCP.
- Use o comando
bq update
da CLI. - Chame o método de API
tables.patch
. - Use bibliotecas de cliente.
Para atualizar o prazo de validade de uma visualização:
Console
No painel de navegação, selecione a visualização.
Na página de detalhes da visualização, clique na guia Detalhes.
À direita de Informações da visualização, clique no ícone de edição (lápis).
Na caixa de diálogo Informações da visualização, em Validade da visualização, clique em Especificar data.
No seletor de data, insira a data e a hora de validade e clique em Ok.
Clique em Atualizar. O prazo de validade atualizado é exibido na seção Informações da visualização.
DDL
Com as instruções da linguagem de definição de dados (DDL, na sigla em inglês), é possível criar e modificar tabelas e visualizações usando a sintaxe de consulta do SQL padrão.
Saiba mais sobre Como usar as instruções de Linguagem de definição de dados.
Para usar uma instrução DDL no Console do GCP:
Clique em Escrever nova consulta.
Digite a instrução DDL na área de texto do Editor de consultas.
ALTER VIEW mydataset.myview SET OPTIONS ( -- Sets view expiration to timestamp 2025-02-03 12:34:56 in the America/Los Angeles time zone expiration_timestamp=TIMESTAMP("2025-02-03 12:34:56", "America/Los Angeles") );
Clique em Executar consulta.
IU clássica
No painel de navegação, selecione a visualização.
Na página Ver detalhes, clique em Detalhes.
Em Tempo de expiração, clique em Editar.
Na caixa de diálogo Atualizar expiração, selecione Em e insira o tempo de expiração em dias.
Clique em OK. O tempo de expiração atualizado é exibido na página Detalhes.
CLI
Emita o comando bq update
com a sinalização --expiration
. Se você estiver atualizando uma visualização em um projeto diferente do padrão, adicione o código do projeto ao nome do conjunto de dados no formato a seguir: project_id:dataset
.
bq update \ --expiration integer \ project_id:dataset.view
Em que:
- integer é a vida útil padrão (em segundos) da tabela. O valor mínimo é de 3.600 segundos (uma hora). O prazo de validade é calculado como a hora atual mais o valor inteiro;
- project_id é o código do projeto;
- dataset é o nome do conjunto de dados que contém a visualização que você está atualizando;
- view é o nome da visualização que você está atualizando.
Exemplos:
Digite o comando a seguir para atualizar o tempo de expiração de myview
em mydataset
como cinco dias (43.200 segundos). mydataset
está no projeto padrão.
bq update --expiration 432000 mydataset.myview
Digite o comando a seguir para atualizar o tempo de expiração de myview
em mydataset
como cinco dias (43.200 segundos). mydataset
está em myotherproject
, e não no projeto padrão.
bq update --expiration 432000 myotherproject:mydataset.myview
API
Chame o método tables.patch
e use a propriedade expirationTime
no recurso de tabela. Como tables.update
substitui todo o recurso da tabela, o método tables.patch
é recomendado. Quando você usa a API REST, a validade da visualização é expressa em milissegundos.
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.
Python
A atualização da expiração de uma visualização é o mesmo processo de atualizar a expiração de uma tabela.
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 a descrição de uma visualização
É possível atualizar a descrição de uma visualização. Para fazer isso:
- Use o Console do GCP ou a IU da Web clássica do BigQuery.
- Use o comando
bq update
da CLI. - Chame o método de API
tables.patch
. - Use bibliotecas de cliente.
Para atualizar a descrição de uma visualização:
Console
Não é possível adicionar uma descrição ao criar uma visualização usando a IU da Web do BigQuery. Depois que a visualização for criada, será possível adicionar uma descrição na página Detalhes.
Na lista Recursos, selecione sua visualização.
Clique na guia Detalhes.
Clique no ícone de lápis ao lado de Descrição.
Insira uma descrição na caixa de diálogo. Clique em Atualizar para salvar a nova descrição.
DDL
Com as instruções da linguagem de definição de dados (DDL, na sigla em inglês), é possível criar e modificar tabelas e visualizações usando a sintaxe de consulta do SQL padrão.
Saiba mais sobre Como usar as instruções de Linguagem de definição de dados.
Para usar uma instrução DDL no Console do GCP:
Clique em Escrever nova consulta.
Digite a instrução DDL na área de texto do Editor de consultas.
ALTER VIEW mydataset.myview SET OPTIONS ( description="Description of myview" );
Clique em Executar consulta.
IU clássica
No painel de navegação, selecione a visualização.
Na página Ver detalhes, clique em Detalhes.
Na seção Descrição, clique em Descrever esta visualização para abrir a caixa de descrição.
Insira uma descrição na caixa. Quando você clica fora da caixa, o texto é salvo.
CLI
Emita o comando bq update
com a sinalização --description
. Se você estiver atualizando uma visualização em um projeto diferente do padrão, adicione o código do projeto ao nome do conjunto de dados no seguinte formato: [PROJECT_ID]:[DATASET]
.
bq update \ --description "description" \ project_id:dataset.view
Em que:
- description é o texto que descreve a visualização entre aspas;
- project_id é o código do projeto;
- dataset é o nome do conjunto de dados que contém a visualização que você está atualizando;
- view é o nome da visualização que você está atualizando.
Exemplos:
Digite o comando a seguir para alterar a descrição de myview
em mydataset
para "Descrição de myview". mydataset
está no projeto padrão.
bq update --description "Description of myview" mydataset.myview
Digite o comando a seguir para alterar a descrição de myview
em mydataset
para "Descrição de myview". mydataset
está no myotherproject
, e não no projeto padrão.
bq update \
--description "Description of myview" \
myotherproject:mydataset.myview
API
Chame o método tables.patch
e use a propriedade description
para atualizar a descrição da visualização no recurso de tabela. Como tables.update
substitui todo o recurso da tabela, o método tables.patch
é recomendado.
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
A atualização da descrição de uma visualização é o mesmo processo de atualizar a descrição de uma tabela.
Antes de testar esta amostra, siga as instruções de configuração do Java no 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
A atualização da descrição de uma visualização é o mesmo processo de atualizar a descrição de uma tabela.
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.
A seguir
- Para mais informações sobre como gerenciar, copiar e excluir visualizações, consulte Como gerenciar visualizações.
- Para informações sobre a criação de visualizações, consulte Como criar visualizações.
- Para informações sobre a criação de uma visualização autorizada, consulte Como criar visualizações autorizadas.
- Para informações sobre a listagem de visualizações, consulte Como listar visualizações.
- Para mais informações sobre como receber metadados de visualizações, consulte Como receber informações sobre visualizações.