Marcar tabelas, visualizações e conjuntos de dados

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorador, selecione o projeto em que você quer criar o conjunto de dados.

3. Clique em more_vert Conferir ações > Criar conjunto de dados.

4. Insira as informações do novo conjunto de dados. Para mais detalhes, consulte Criar conjuntos de dados.

5. Abra a seção Tags.

   1. Para aplicar uma tag, faça o seguinte:

      1. Clique na seta suspensa ao lado de Selecionar escopo e escolha Escopo atual: Selecionar organização atual ou Selecionar projeto atual.

         Como alternativa, clique em Selecionar escopo para pesquisar um recurso ou conferir uma lista de recursos atuais.

      2. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   2. Para inserir uma nova tag manualmente, faça o seguinte:

      1. Clique na seta para baixo ao lado de Selecionar um escopo e escolha Inserir IDs manualmente > Organização, Projeto ou Tags.

      2. Se você estiver criando uma tag para seu projeto ou organização, na caixa de diálogo, insira PROJECT_ID ou ORGANIZATION_ID e clique em Salvar.

      3. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   3. Opcional: para adicionar outras tags à tabela, clique em Adicionar tag e siga as etapas anteriores.

6. Clique em Criar conjunto de dados.

SQL

Use a instrução CREATE SCHEMA.

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   CREATE SCHEMA PROJECT_ID.DATASET_ID
   OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que você está criando.
   • TAG_KEY_1: o nome da chave com namespace que você quer definir como a primeira tag no conjunto de dados, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Use o comando bq mk --dataset com a sinalização --add_tags.

bq mk --dataset \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID

Substitua:

• TAG: a tag que você está anexando ao novo conjunto de dados. Várias tags são separadas por vírgulas. Por exemplo, 556741164180/env:prod,myProject/department:sales. Cada tag precisa ter o nome da chave com namespace e o nome curto do valor.
• PROJECT_ID: o ID do projeto em que você está criando um conjunto de dados.
• DATASET_ID: o ID do novo conjunto de dados.

Terraform

Use o recurso google_bigquery_dataset.

Para autenticar no BigQuery, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.

O exemplo a seguir cria um conjunto de dados chamado my_dataset e anexa tags a ele preenchendo o campo resource_tags:

# Create tag keys and values
data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env2"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department2"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

# Create a dataset
resource "google_bigquery_dataset" "default" {
  dataset_id                      = "my_dataset"
  default_partition_expiration_ms = 2592000000  # 30 days
  default_table_expiration_ms     = 31536000000 # 365 days
  description                     = "dataset description"
  location                        = "US"
  max_time_travel_hours           = 96 # 4 days

  # Attach tags to the dataset
  resource_tags = {
    (google_tags_tag_key.env_tag_key.namespaced_name) : google_tags_tag_value.env_tag_value.short_name,
    (google_tags_tag_key.department_tag_key.namespaced_name) : google_tags_tag_value.department_tag_value.short_name
  }
}

Para aplicar a configuração do Terraform a um projeto do Google Cloud , siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto Google Cloud padrão em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

   Copie o exemplo de código no main.tf recém-criado.

   Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.

2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Apply complete!".

3. Abra o projeto Google Cloud para conferir os resultados. No console Google Cloud , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.

API

Chame o método datasets.insert e adicione suas tags ao campo resource_tags.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda o projeto e selecione um conjunto de dados.

3. Na seção Informações do conjunto de dados, clique em mode_edit Editar detalhes.

4. Abra a seção Tags.

   1. Para aplicar uma tag, faça o seguinte:

      1. Clique na seta suspensa ao lado de Selecionar escopo e escolha Escopo atual: Selecionar organização atual ou Selecionar projeto atual.

         Como alternativa, clique em Selecionar escopo para pesquisar um recurso ou conferir uma lista de recursos atuais.

      2. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   2. Para inserir uma nova tag manualmente, faça o seguinte:

      1. Clique na seta para baixo ao lado de Selecionar um escopo e escolha Inserir IDs manualmente > Organização, Projeto ou Tags.

      2. Se você estiver criando uma tag para seu projeto ou organização, na caixa de diálogo, insira PROJECT_ID ou ORGANIZATION_ID e clique em Salvar.

      3. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   3. Opcional: para adicionar outras tags à tabela, clique em Adicionar tag e siga as etapas anteriores.

5. Clique em Salvar.

SQL

Use a instrução ALTER SCHEMA SET OPTIONS.

O exemplo a seguir substitui todas as tags de um conjunto de dados.

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   ALTER SCHEMA PROJECT_ID.DATASET_ID
   SET OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que contém a tabela.
   • TABLE_ID: o nome da tabela que você está marcando.
   • TAG_KEY_1: o nome da chave com namespace que você quer definir como a primeira tag na tabela, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

O exemplo a seguir usa o operador += para anexar tags a um conjunto de dados sem substituir as tags atuais. Se uma tag tiver a mesma chave, ela será substituída.

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   ALTER SCHEMA PROJECT_ID.DATASET_ID
   SET OPTIONS (
     tags += [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que contém a tabela.
   • TABLE_ID: o nome da tabela que você está marcando.
   • TAG_KEY_1: o nome da chave com namespace que você quer definir como a primeira tag na tabela, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Use o comando bq update com a sinalização --add_tags.

bq update \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID

Substitua:

• TAG: a tag que você está anexando ao conjunto de dados. Várias tags são separadas por vírgulas. Por exemplo, 556741164180/env:prod,myProject/department:sales. Cada tag precisa ter o nome da chave com namespace e o nome curto do valor.
• PROJECT_ID: o ID do projeto em que o conjunto de dados existente está localizado.
• DATASET_ID: o ID do conjunto de dados.

gcloud

Para anexar uma tag a um conjunto de dados usando a linha de comando, crie um recurso de vinculação de tag usando o comando gcloud resource-manager tags bindings create:

gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua:

• TAG_VALUE_NAME: o ID permanente ou o nome do namespace do valor da tag a ser anexado, como tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: o ID completo do conjunto de dados, incluindo o nome de domínio da API (//bigquery.googleapis.com/) para identificar o tipo de recurso. Exemplo: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
• LOCATION: o local do conjunto de dados.

Terraform

Adicione tags ao campo resource_tags do conjunto de dados e aplique a configuração atualizada usando o recurso google_bigquery_dataset. Para mais informações, consulte o exemplo do Terraform em Anexar tags ao criar um novo conjunto de dados.

API

Chame o método datasets.get para receber o recurso do conjunto de dados, incluindo o campo resource_tags. Adicione suas tags no campo resource_tags e transmita o recurso do conjunto de dados atualizado usando método datasets.update.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda o projeto e selecione um conjunto de dados.

   As tags aparecem na seção Informações do conjunto de dados.

bq

Para listar as tags anexadas a um conjunto de dados, use o método comando bq show.

bq show PROJECT_ID:DATASET_ID

Substitua:

• PROJECT_ID: o ID do projeto que contém esse conjunto de dados.
• DATASET_ID: o ID do conjunto de dados para o qual você quer listar as tags.

gcloud

Para ver uma lista de vinculações de tags anexadas a um recurso, use o comando gcloud resource-manager tags bindings list:

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua:

• RESOURCE_ID: o ID completo do conjunto de dados, incluindo o nome de domínio da API (//bigquery.googleapis.com/) para identificar o tipo de recurso. Por exemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset.

• LOCATION: o local do conjunto de dados.

O resultado será assim:

name: tagBindings/%2F%2Fbigquery.googleapis.com%2Fprojects%2Fmy_project%2Fdatasets%2Fmy_dataset/tagValues/4567890123
parent: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
tagValue: tagValues/4567890123

Terraform

Use o comando terraform state show para listar os atributos do conjunto de dados, incluindo o campo resource_tags. Execute esse comando no diretório em que o arquivo de configuração do Terraform do conjunto de dados foi executado.

terraform state show google_bigquery_dataset.default

API

Chame o Método datasets.get para receber o recurso do conjunto de dados. O recurso do conjunto de dados inclui tags anexadas ao conjunto de dados no campo resource_tags.

Visualizações

Use a visualização INFORMATION_SCHEMA.SCHEMATA_OPTIONS:

Por exemplo, a consulta a seguir mostra todas as tags anexadas a todos os conjuntos de dados de uma região. Esta consulta retorna uma tabela com colunas, incluindo schema_name (os nomes dos conjuntos de dados), option_name (sempre 'tags'), object_type (sempre ARRAY<STRUCT<STRING, STRING>>) e option_value, que contém matrizes de objetos STRUCT que representam tags associadas a cada conjunto de dados. Para conjuntos de dados sem tags atribuídas, a coluna option_value retorna uma matriz vazia.

SELECT * from region-REGION.INFORMATION_SCHEMA.SCHEMATA_OPTIONS
WHERE option_name='tags'

Substitua:

• REGION: a região em que seus conjuntos de dados estão localizados.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda o projeto e selecione um conjunto de dados.

3. Na seção Informações do conjunto de dados, clique em mode_edit Editar detalhes.

4. Na seção Tags, clique em deleteExcluir item ao lado da tag que você quer excluir.

5. Clique em Salvar.

SQL

Use a instrução ALTER SCHEMA SET OPTIONS.

O exemplo a seguir remove tags de um conjunto de dados usando o operador -=. Para separar todas as tags de um conjunto de dados, especifique tags=NULL ou tags=[].

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags -= [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que contém a tabela.
   • TABLE_ID: o nome da tabela de que você está desanexando as tags.
   • TAG_KEY_1: o nome da chave com namespace da primeira tag que você quer desanexar, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag que você quer desanexar, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag que você está desconectando.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag que você está desconectando.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Use o comando bq update com a sinalização --remove_tags.

bq update \
    --remove_tags=REMOVED_TAG \
    PROJECT_ID:DATASET_ID

Substitua:

• REMOVED_TAG: a tag que você está removendo do conjunto de dados. Várias tags são separadas por vírgulas. Aceita apenas chaves sem pares de valor. Por exemplo, 556741164180/env,myProject/department. Cada tag deve ter o nome da chave com namespace.
• PROJECT_ID: o ID do projeto que contém seu conjunto de dados.
• DATASET_ID: o ID do conjunto de dados do qual remover as tags. .

Como alternativa, para remover todas as tags de um conjunto de dados, use o método comando bq update com a flag --clear_all_tags:

bq update \
    --clear_all_tags
    PROJECT_ID:DATASET_ID

gcloud

Para remover uma tag de um conjunto de dados usando a linha de comando, exclua a vinculação de tag usando o comando gcloud resource-manager tags bindings delete:

gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua:

• TAG_VALUE_NAME: o ID permanente ou o nome do namespace do valor da tag a ser removido ,como tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: o ID completo do conjunto de dados, incluindo o nome de domínio da API para identificar o tipo de recurso (//bigquery.googleapis.com/). Por exemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset.
• LOCATION: o local do conjunto de dados.

Terraform

Remova as tags do campo resource_tags do conjunto de dados e aplique a configuração atualizada usando o recurso google_bigquery_dataset.

API

Chame o método datasets.get para receber o recurso do conjunto de dados, incluindo o campo resource_tags. Remova suas tags do campo resource_tags e transmita o recurso de conjunto de dados atualizado usando o método datasets.update.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda seu projeto e selecione um conjunto de dados.

3. Na seção Informações do conjunto de dados, clique em add_box Criar tabela.

4. Insira as informações da nova tabela. Para mais detalhes, consulte Criar e usar tabelas.

5. Abra a seção Tags.

   1. Para aplicar uma tag, faça o seguinte:

      1. Clique na seta suspensa ao lado de Selecionar escopo e escolha Escopo atual: Selecionar organização atual ou Selecionar projeto atual.

         Como alternativa, clique em Selecionar escopo para pesquisar um recurso ou conferir uma lista de recursos atuais.

      2. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   2. Para inserir uma nova tag manualmente, faça o seguinte:

      1. Clique na seta para baixo ao lado de Selecionar um escopo e escolha Inserir IDs manualmente > Organização, Projeto ou Tags.

      2. Se você estiver criando uma tag para seu projeto ou organização, na caixa de diálogo, insira PROJECT_ID ou ORGANIZATION_ID e clique em Salvar.

      3. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   3. Opcional: para adicionar outras tags à tabela, clique em Adicionar tag e siga as etapas anteriores.

6. Clique em Criar tabela.

SQL

Use a instrução CREATE TABLE.

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   CREATE TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados em que você está criando a tabela.
   • TABLE_ID: o nome da nova tabela.
   • TAG_KEY_1: o nome da chave com namespace que você quer definir como a primeira tag na tabela, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Use o comando bq mk --table com a sinalização --add_tags.

bq mk --table \
    --schema=SCHEMA \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID.TABLE_ID

Substitua:

• SCHEMA: a definição do esquema in-line.
• TAG: a tag que você está anexando à nova tabela. Várias tags são separadas por vírgulas. Por exemplo, 556741164180/env:prod,myProject/department:sales. Cada tag precisa ter o nome da chave com namespace e o nome curto do valor.
• PROJECT_ID: o ID do projeto em que você está criando uma tabela.
• DATASET_ID: o ID do conjunto de dados em que você está criando uma tabela.
• TABLE_ID: o ID da nova tabela.

Terraform

Use o recurso google_bigquery_table.

Para autenticar no BigQuery, configure o Application Default Credentials. Para mais informações, acesse Configurar a autenticação para bibliotecas de cliente.

O exemplo a seguir cria uma tabela chamada mytable e anexa tags a ela preenchendo o campo resource_tags:

# Create tag keys and values
data "google_project" "default" {}

resource "google_tags_tag_key" "env_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "env3"
}

resource "google_tags_tag_key" "department_tag_key" {
  parent     = "projects/${data.google_project.default.project_id}"
  short_name = "department3"
}

resource "google_tags_tag_value" "env_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.env_tag_key.name}"
  short_name = "prod"
}

resource "google_tags_tag_value" "department_tag_value" {
  parent     = "tagKeys/${google_tags_tag_key.department_tag_key.name}"
  short_name = "sales"
}

# Create a dataset
resource "google_bigquery_dataset" "default" {
  dataset_id                      = "MyDataset"
  default_partition_expiration_ms = 2592000000  # 30 days
  default_table_expiration_ms     = 31536000000 # 365 days
  description                     = "dataset description"
  location                        = "US"
  max_time_travel_hours           = 96 # 4 days
}

# Create a table
resource "google_bigquery_table" "default" {
  dataset_id          = google_bigquery_dataset.default.dataset_id
  table_id            = "mytable"
  description         = "table description"
  deletion_protection = false # set to "true" in production

  # Attach tags to the table
  resource_tags = {
    (google_tags_tag_key.env_tag_key.namespaced_name) : google_tags_tag_value.env_tag_value.short_name,
    (google_tags_tag_key.department_tag_key.namespaced_name) : google_tags_tag_value.department_tag_value.short_name
  }
}

Para aplicar a configuração do Terraform a um projeto do Google Cloud , siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto Google Cloud padrão em que você quer aplicar as configurações do Terraform.

   Você só precisa executar esse comando uma vez por projeto, e ele pode ser executado em qualquer diretório.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   As variáveis de ambiente serão substituídas se você definir valores explícitos no arquivo de configuração do Terraform.

Preparar o diretório

Cada arquivo de configuração do Terraform precisa ter o próprio diretório, também chamado de módulo raiz.

1. No Cloud Shell, crie um diretório e um novo arquivo dentro dele. O nome do arquivo precisa ter a extensão .tf, por exemplo, main.tf. Neste tutorial, o arquivo é chamado de main.tf.

   mkdir DIRECTORY && cd DIRECTORY && touch main.tf

2. Se você estiver seguindo um tutorial, poderá copiar o exemplo de código em cada seção ou etapa.

   Copie o exemplo de código no main.tf recém-criado.

   Se preferir, copie o código do GitHub. Isso é recomendado quando o snippet do Terraform faz parte de uma solução de ponta a ponta.

3. Revise e modifique os parâmetros de amostra para aplicar ao seu ambiente.
4. Salve as alterações.
5. Inicialize o Terraform. Você só precisa fazer isso uma vez por diretório.

   terraform init

   Opcionalmente, para usar a versão mais recente do provedor do Google, inclua a opção -upgrade:

   terraform init -upgrade

Aplique as alterações

1. Revise a configuração e verifique se os recursos que o Terraform vai criar ou atualizar correspondem às suas expectativas:

   terraform plan

   Faça as correções necessárias na configuração.

2. Para aplicar a configuração do Terraform, execute o comando a seguir e digite yes no prompt:

   terraform apply

   Aguarde até que o Terraform exiba a mensagem "Apply complete!".

3. Abra o projeto Google Cloud para conferir os resultados. No console Google Cloud , navegue até seus recursos na UI para verificar se foram criados ou atualizados pelo Terraform.

API

Chame o método tables.insert com um recurso de tabela definido e inclua as tags no campo resource_tags.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda seu projeto e conjunto de dados e, em seguida, selecione uma tabela.

3. Clique na guia Detalhes e em mode_edit Editar detalhes.

4. Abra a seção Tags.

   1. Para aplicar uma tag, faça o seguinte:

      1. Clique na seta suspensa ao lado de Selecionar escopo e escolha Escopo atual: Selecionar organização atual ou Selecionar projeto atual.

         Como alternativa, clique em Selecionar escopo para pesquisar um recurso ou conferir uma lista de recursos atuais.

      2. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   2. Para inserir uma nova tag manualmente, faça o seguinte:

      1. Clique na seta para baixo ao lado de Selecionar um escopo e escolha Inserir IDs manualmente > Organização, Projeto ou Tags.

      2. Se você estiver criando uma tag para seu projeto ou organização, na caixa de diálogo, insira PROJECT_ID ou ORGANIZATION_ID e clique em Salvar.

      3. Para Chave 1 e Valor 1, escolha os valores adequados nas listas.

   3. Opcional: para adicionar outras tags à tabela, clique em Adicionar tag e siga as etapas anteriores.

5. Clique em Salvar.

SQL

Use a instrução ALTER TABLE SET OPTIONS.

O exemplo a seguir substitui todas as tags de uma tabela.

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags = [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que contém a tabela.
   • TABLE_ID: o nome da tabela que você está marcando.
   • TAG_KEY_1: o nome da chave com namespace que você quer definir como a primeira tag na tabela, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

O exemplo a seguir usa o operador += para anexar uma tag a uma tabela sem substituir as tags atuais. Se uma tag tiver a mesma chave, ela será substituída.

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags += [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que contém a tabela.
   • TABLE_ID: o nome da tabela que você está marcando.
   • TAG_KEY_1: o nome da chave com namespace que você quer definir como a primeira tag na tabela, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Use o comando bq update com a sinalização --add_tags.

bq update \
    --add_tags=TAG \
    PROJECT_ID:DATASET_ID.TABLE_ID

Substitua:

• TAG: a tag que você está anexando à tabela. Várias tags são separadas por vírgulas. Por exemplo, 556741164180/env:prod,myProject/department:sales. Cada tag precisa ter o nome da chave com namespace e o nome curto do valor.
• PROJECT_ID: o ID do projeto que contém seus artefatos.
• DATASET_ID: o ID do conjunto de dados que contém a tabela.
• TABLE_ID: o ID da tabela que você está atualizando.

gcloud

Para anexar uma tag a uma tabela usando a linha de comando, crie um recurso de vinculação de tag usando o comando gcloud resource-manager tags bindings create:

gcloud resource-manager tags bindings create \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua:

• TAG_VALUE_NAME: o ID permanente ou o nome do namespace do valor da tag a ser anexado, como tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: o ID completo da tabela, incluindo o nome de domínio da API (//bigquery.googleapis.com/) para identificar o tipo de recurso. Exemplo: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table.
• LOCATION: o local da sua tabela.

Terraform

Adicione tags ao campo resource_tags da tabela e aplique a configuração atualizada usando o recurso google_bigquery_table. Para mais informações, consulte o exemplo do Terraform em Anexar tags ao criar uma nova tabela.

API

Chame o método tables.update com um recurso de tabela definido e inclua as tags no campo resource_tags.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda seu projeto e conjunto de dados e, em seguida, selecione uma tabela.

   As tags aparecem na guia Detalhes.

bq

Use o comando bq show e procure a coluna tags. Se não houver tags na tabela, a coluna tags não será exibida.

bq show \
    PROJECT_ID:DATASET_ID.TABLE_ID

Substitua:

• PROJECT_ID: o ID do projeto que contém seus artefatos.
• DATASET_ID: o ID do conjunto de dados que contém a tabela.
• TABLE_ID: o ID da tabela.

gcloud

Para ver uma lista de vinculações de tags anexadas a um recurso, use o comando gcloud resource-manager tags bindings list:

gcloud resource-manager tags bindings list \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua:

• RESOURCE_ID: o ID completo da tabela, incluindo o nome de domínio da API (//bigquery.googleapis.com/) para identificar o tipo de recurso. Por exemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table.

• LOCATION: o local do conjunto de dados.

O resultado será assim:

name: tagBindings/%2F%2Fbigquery.googleapis.com%2Fprojects%2Fmy_project%2Fdatasets%2Fmy_dataset/tagValues/4567890123
parent: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
tagValue: tagValues/4567890123

Terraform

Use o comando terraform state show para listar os atributos da tabela, incluindo o campo resource_tags. Execute esse comando no diretório em que o arquivo de configuração do Terraform da tabela foi executado.

terraform state show google_bigquery_table.default

API

Chame o método tables.get com um recurso de tabela definido e procure o campo resource_tags.

Visualizações

Use a visualização INFORMATION_SCHEMA.TABLE_OPTIONS:

Por exemplo, a consulta a seguir mostra todas as tags anexadas a todas as tabelas em um conjunto de dados. Esta consulta retorna uma tabela com colunas, incluindo schema_name (o nome dos conjuntos de dados), option_name (sempre 'tags'), object_type (sempre ARRAY<STRUCT<STRING, STRING>>) e option_value, que contém matrizes de objetos STRUCT que representam tags associadas a cada conjunto de dados. Para tabelas de dados sem tags atribuídas, a coluna option_value retorna uma matriz vazia.

SELECT * from DATASET_ID.INFORMATION_SCHEMA.TABLE_OPTIONS
WHERE option_name='tags'

Substitua DATASET_ID pelo ID do conjunto de dados que contém sua tabela.

Console

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel Explorer, expanda seu projeto e conjunto de dados e, em seguida, selecione uma tabela.

3. Clique na guia Detalhes e em mode_edit Editar detalhes.

4. Na seção Tags, clique em deleteExcluir item ao lado da tag que você quer excluir.

5. Clique em Salvar.

SQL

Use a instrução ALTER TABLE SET OPTIONS.

O exemplo a seguir remove as tags de uma tabela usando o operador -=. Para separar todas as tags de uma tabela, especifique tags=NULL ou tags=[].

1. No console Google Cloud , acesse a página BigQuery.

   Acessar o BigQuery

2. No editor de consultas, digite a seguinte instrução:

   ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
   SET OPTIONS (
     tags -= [('TAG_KEY_1', 'TAG_VALUE_1'), ('TAG_KEY_2', 'TAG_VALUE_2')];)

   Substitua:

   • PROJECT_ID: o ID do projeto.
   • DATASET_ID: o ID do conjunto de dados que contém a tabela.
   • TABLE_ID: o nome da tabela de que você está desanexando as tags.
   • TAG_KEY_1: o nome da chave com namespace da primeira tag que você quer desanexar, por exemplo, 'my-project/env' ou '556741164180/department'.
   • TAG_VALUE_1: o nome abreviado do valor da tag que você quer desanexar, por exemplo, 'prod' ou 'sales'.
   • TAG_KEY_2: o nome da chave com namespace da segunda tag que você está desconectando.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag que você está desconectando.

3. Clique em play_circle Executar.

Para mais informações sobre como executar consultas, acesse Executar uma consulta interativa.

bq

Para remover algumas tags de uma tabela, use o comando bq update com a sinalização --remove_tags:

bq update \
    --remove_tags=TAG_KEYS \
    PROJECT_ID:DATASET_ID.TABLE_ID

Substitua:

• TAG_KEYS: as chaves de tag que você está removendo da tabela, separados por vírgulas. Por exemplo, 556741164180/env,myProject/department. Cada chave de tag precisa ter o nome de chave com namespace.
• PROJECT_ID: o ID do projeto que contém seus artefatos.
• DATASET_ID: o ID do conjunto de dados que contém a tabela.
• TABLE_ID: o ID da tabela que você está atualizando.

Para remover todas as tags de uma tabela, use o comando bq update com a sinalização --clear_all_tags:

bq update \
    --clear_all_tags \
    PROJECT_ID:DATASET_ID.TABLE_ID

gcloud

Para remover uma associação de tag de uma tabela usando a linha de comando, exclua a vinculação de tags usando comando gcloud resource-manager tags bindings delete:

gcloud resource-manager tags bindings delete \
    --tag-value=TAG_VALUE_NAME \
    --parent=RESOURCE_ID \
    --location=LOCATION

Substitua:

• TAG_VALUE_NAME: o ID permanente ou o nome do namespace do valor da tag a ser excluído, como tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: o ID completo da tabela, incluindo o nome de domínio da API (//bigquery.googleapis.com/) para identificar o tipo de recurso. Por exemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table.
• LOCATION: o local do conjunto de dados.

Terraform

Remova as tags do campo resource_tags da tabela e aplique a configuração atualizada usando o recurso google_bigquery_table.

API

Chame o método tables.update com um recurso de tabela definido e remova as tags no campo resource_tags. Para remover todas as tags, remova o campo resource_tags.