Controlar o acesso com tags

Console

1. No console do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

   Se o painel esquerdo não aparecer, clique em last_page Expandir painel esquerdo para abrir.

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

4. Clique em more_vert Ver ações > Criar conjunto de dados.

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

6. Abra a seção Tags.

   1. Para aplicar uma tag existente, 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.

         Ou clique em Selecionar escopo para pesquisar um recurso ou ver uma lista dos recursos atuais.

      2. Em 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 suspensa 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 o PROJECT_ID ou o ORGANIZATION_ID e clique em Salvar.

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

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

7. Clique em Criar conjunto de dados.

SQL

Use a instrução CREATE SCHEMA.

1. No console do Cloud de Confiance , 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 do 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 em um Cloud de Confiance projeto, siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto Cloud de Confiance 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 seu Cloud de Confiance projeto para conferir os resultados. No console do Cloud de Confiance , 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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda o projeto, clique em Conjuntos de dados e selecione um conjunto de dados.

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

5. Abra a seção Tags.

   1. Para aplicar uma tag existente, 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.

         Ou clique em Selecionar escopo para pesquisar um recurso ou ver uma lista dos recursos atuais.

      2. Em 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 suspensa 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 o PROJECT_ID ou o ORGANIZATION_ID e clique em Salvar.

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

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

6. 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 do Cloud de Confiance , 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 do Cloud de Confiance , 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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda o projeto, clique em Conjuntos de dados 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á o seguinte:

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

É possível listar as tags herdadas por conjuntos de dados do BigQuery usando o gcloud resource-manager tags bindings list. Você também pode usar a opção --filter no atributo namespacedTagValue para filtrar tags de acordo com ID do projeto, valor ou chave da tag.

gcloud resource-manager tags bindings list \
    --parent=//bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID \
    --effective \
    --filter=namespacedTagValue:TAG_FILTER

Substitua o seguinte :

• PROJECT_ID: o ID do projeto que contém seu conjunto de dados.

• DATASET_ID: o código do conjunto de dados.

• TAG_FILTER: especifique um valor para filtrar tags herdadas com base em uma das seguintes opções:

  • Filtre tags por ID do projeto. Por exemplo, myproject

  • Filtre os valores de tag especificando o ID permanente ou o nome do namespace do valor de tag. Por exemplo, tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value.

  • Filtre chaves de tag especificando o nome de exibição delas. Por exemplo, tagkey.

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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda o projeto, clique em Conjuntos de dados e selecione um conjunto de dados.

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

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

6. 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 desvincular todas as tags de um conjunto de dados, especifique tags=NULL ou tags=[].

1. No console do Cloud de Confiance , 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á desvinculando 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á desvinculando.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag que você está desvinculando.

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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda o projeto, clique em Conjuntos de dados e selecione um conjunto de dados.

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

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

6. Abra a seção Tags.

   1. Para aplicar uma tag existente, 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.

         Ou clique em Selecionar escopo para pesquisar um recurso ou ver uma lista dos recursos atuais.

      2. Em 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 suspensa 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 o PROJECT_ID ou o ORGANIZATION_ID e clique em Salvar.

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

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

7. Clique em Criar tabela.

SQL

Use a instrução CREATE TABLE.

1. No console do Cloud de Confiance , 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"

  # 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 em um Cloud de Confiance projeto, siga as etapas nas seções a seguir.

Preparar o Cloud Shell

1. Inicie o Cloud Shell.

2. Defina o projeto Cloud de Confiance 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 seu Cloud de Confiance projeto para conferir os resultados. No console do Cloud de Confiance , 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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda seu projeto e clique em Conjuntos de dados.

4. Clique em Visão geral > Tabelas e selecione uma tabela.

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

6. Abra a seção Tags.

   1. Para aplicar uma tag existente, 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.

         Ou clique em Selecionar escopo para pesquisar um recurso ou ver uma lista dos recursos atuais.

      2. Em 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 suspensa 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 o PROJECT_ID ou o ORGANIZATION_ID e clique em Salvar.

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

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

7. Clique em Salvar.

SQL

Use a instrução ALTER TABLE SET OPTIONS.

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

1. No console do Cloud de Confiance , 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 do Cloud de Confiance , 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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda seu projeto e clique em Conjuntos de dados.

4. Clique em Visão geral > Tabelas e 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á o seguinte:

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

É possível listar as tags herdadas por tabelas do BigQuery usando o gcloud resource-manager tags bindings list. Você também pode usar a opção --filter no atributo namespacedTagValue para filtrar tags de acordo com ID do projeto, valor ou chave da tag.

gcloud resource-manager tags bindings list \
    --parent=//bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID \
    --effective \
    --filter=namespacedTagValue:TAG_FILTER

Substitua o seguinte :

• PROJECT_ID: o ID do projeto que contém seu conjunto de dados.

• DATASET_ID: o código do conjunto de dados.

• TAG_FILTER: especifique um valor para filtrar tags herdadas com base em uma das seguintes opções:

  • Filtre tags por ID do projeto. Por exemplo, myproject

  • Filtre os valores de tag especificando o ID permanente ou o nome do namespace do valor de tag. Por exemplo, tagValues/4567890123 ou 1234567/my_tag_key/my_tag_value.

  • Filtre chaves de tag especificando o nome de exibição delas. Por exemplo, tagkey.

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 do Cloud de Confiance , acesse a página BigQuery.

   Acessar o BigQuery

2. No painel à esquerda, clique em explore Explorer:

   

3. No painel Explorer, expanda seu projeto e clique em Conjuntos de dados.

4. Clique em Visão geral > Tabelas e selecione uma tabela.

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

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

7. Clique em Salvar.

SQL

Use a instrução ALTER TABLE SET OPTIONS.

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

1. No console do Cloud de Confiance , 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á desvinculando 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á desvinculando.
   • TAG_VALUE_2: o nome abreviado do valor da segunda tag que você está desvinculando.

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.

gcloud

1. Execute o comando gcloud resource-manager tags keys create:

   gcloud resource-manager tags keys create TAG_KEY \
       --parent=projects/PROJECT_ID \
       --purpose=DATA_GOVERNANCE
   

   Substitua:

   • TAG_KEY: o nome abreviado da chave de tag.
   • PROJECT_ID: o ID do seu Cloud de Confiance by S3NS projeto. Para fornecer uma organização em vez de um projeto, use organizations/ORGANIZATION_ID em vez de projects/PROJECT_ID.

API

1. Envie uma solicitação POST para o endpoint tagKeys:

   curl --request POST \
     "https://cloudresourcemanager.googleapis.com/v3/tagKeys" \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '{"shortName":"TAG_KEY","parent":"projects/PROJECT_ID","purpose":"DATA_GOVERNANCE"}' \
     --compressed
   

   Substitua:

   • TAG_KEY: o nome abreviado da chave de tag.
   • PROJECT_ID: o ID do seu Cloud de Confiance by S3NS projeto. Para fornecer uma organização em vez de um projeto, use organizations/ORGANIZATION_ID em vez de projects/PROJECT_ID.

gcloud

1. Para encontrar o nome do namespace da chave de tag, execute o comando gcloud resource-manager tags keys list:

   gcloud resource-manager tags keys list --parent=projects/PROJECT_ID
   

2. Crie um novo valor executando o comando gcloud resource-manager tags values create:

   gcloud resource-manager tags values create TAG_VALUE \
       --parent=PROJECT_ID/TAG_KEY
   

   Substitua:

   • TAG_VALUE: um nome abreviado especificado pelo usuário do valor da tag.
   • PROJECT_ID: o ID do seu Cloud de Confiance by S3NS projeto. Para fornecer uma organização em vez de um projeto, use seu ORGANIZATION_ID.

API

1. Encontre o nome com namespace da chave de tag:

   curl --request GET \
       "https://cloudresourcemanager.googleapis.com/v3/tagKeys/namespaced?name=PROJECT_ID/TAG_KEY" \
       --header "Authorization: Bearer $(gcloud auth print-access-token)" \
       --header 'Accept: application/json'
   

   A resposta contém o campo name, por exemplo, tagKeys/4567890123.

2. Envie uma solicitação POST para o endpoint tagValues com o nome da chave da tag:

   curl --request POST \
     "https://cloudresourcemanager.googleapis.com/v3/tagValues" \
     --header "Authorization: Bearer $(gcloud auth print-access-token)" \
     --header 'Accept: application/json' \
     --header 'Content-Type: application/json' \
     --data '{"shortName":"TAG_VALUE","parent":"tagKeys/TAG_KEY_ID"}' \
     --compressed
   

   Substitua:

   • TAG_VALUE: um nome abreviado especificado pelo usuário do valor da tag.
   • PROJECT_ID: o ID do seu Cloud de Confiance by S3NS projeto. Para fornecer uma organização em vez de um projeto, use seu ORGANIZATION_ID.
   • TAG_KEY_ID: o nome do namespace da chave de tag da etapa 1. Por exemplo, se o nome da chave de tag for tagKeys/4567890123, o ID da chave de tag será 4567890123.

gcloud

Para criar um valor de tag filho, execute o comando gcloud resource-manager tags values create e especifique um valor de tag pai na flag --parent:

gcloud resource-manager tags values create CHILD_TAG_VALUE \
--parent=PROJECT_ID/TAG_KEY/PARENT_TAG_VALUE

Substitua:

• CHILD_TAG_VALUE: o nome abreviado do valor da tag filha que você está criando.
• PROJECT_ID: o ID do seu projeto do Cloud de Confiance by S3NS . Para fornecer uma organização em vez de um projeto, use seu ORGANIZATION_ID.
• TAG_KEY: o nome abreviado da chave de tag que é o pai do valor da tag.
• PARENT_TAG_VALUE: o nome abreviado do valor da tag principal.

API

Para criar um valor de tag filho, use o nome do recurso de valor de tag do pai (por exemplo, tagValues/123456789012) no campo parent:

curl --request POST \
  "https://cloudresourcemanager.googleapis.com/v3/tagValues" \
  --header "Authorization: Bearer $(gcloud auth print-access-token)" \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{"shortName":"CHILD_TAG_VALUE","parent":"tagValues/PARENT_TAG_VALUE_ID"}' \
  --compressed

Substitua:

• CHILD_TAG_VALUE: o nome abreviado do valor da tag filha que você está criando.
• PARENT_TAG_VALUE_ID: o ID numérico do valor da tag principal.

SQL

Criar uma tabela com uma coluna de tags

Para anexar tags de governança de dados ao criar uma tabela, use a instrução CREATE TABLE. Defina a opção data_governance_tags na coluna para especificar a tag.

CREATE TABLE PROJECT_ID.DATASET_ID.TABLE_ID (
  COLUMN_NAME INT64 OPTIONS (data_governance_tags=[("PROJECT_ID/TAG_KEY", "TAG_VALUE")])
);

Substitua:

• PROJECT_ID: o ID do seu projeto do Cloud de Confiance by S3NS . Para fornecer uma organização em vez de um projeto como pai da sua tag, use seu ORGANIZATION_ID em vez do formato de chave de tag (ORGANIZATION_ID/TAG_KEY).
• DATASET_ID: o ID do conjunto de dados em que a tabela está localizada.
• TABLE_ID: o ID da tabela que você está criando.
• COLUMN_NAME: o nome da coluna que você quer marcar.
• TAG_KEY: a chave de tag que você quer aplicar.
• TAG_VALUE: o valor da tag que você quer aplicar.

Adicionar uma tag a uma tabela

Para anexar tags de governança de dados a uma coluna em uma tabela existente, use a instrução ALTER TABLE para definir a opção data_governance_tags na coluna.

ALTER TABLE PROJECT_ID.DATASET_ID.TABLE_ID
ALTER COLUMN COLUMN_NAME SET OPTIONS (data_governance_tags=[("PROJECT_ID/TAG_KEY", "TAG_VALUE")]);

CLI bq

Criar uma tabela com uma coluna de tags

1. Para criar um arquivo de esquema JSON local que defina a tag, execute o comando bq mk:

   bq mk \
       --table \
       --project_id=PROJECT_ID \
       --description="description of my table" \
       --schema=SCHEMA_FILE.json \
       DATASET_ID.TABLE_ID
   

   Substitua:

   • PROJECT_ID: o ID do seu Cloud de Confiance by S3NS projeto. Para fornecer uma organização em vez de um projeto como o pai da tag, use ORGANIZATION_ID em vez do formato de chave de tag (ORGANIZATION_ID/TAG_KEY).
   • DATASET_ID: o ID do conjunto de dados em que a tabela está localizada.
   • TABLE_ID: o ID da tabela que você está criando.

Adicionar uma tag a uma tabela

1. Para adicionar uma tag a uma tabela, primeiro exporte o esquema dela para um arquivo local:

   bq show \
       --project_id=PROJECT_ID \
       --schema \
       --format=prettyjson \
       DATASET_ID.TABLE_ID > SCHEMA_FILE.json
   

2. Edite o arquivo de esquema para adicionar o objeto dataGovernanceTagsInfo à coluna. Exemplo:

   [
     {
       "description": "my sensitive column",
       "mode": "NULLABLE",
       "name": "Column_X",
       "type": "INT64",
       "dataGovernanceTagsInfo": {
         "dataGovernanceTags": {
           "PROJECT_ID/TAG_KEY": "TAG_VALUE"
         }
       }
     },
     {
       "mode": "REQUIRED",
       "name": "column2",
       "type": "FLOAT"
     }
   ]
   

3. Atualize a tabela para anexar tags à coluna sensível com o comando bq update:

   bq update \
       --project_id=PROJECT_ID \
       --schema=SCHEMA_FILE.json \
       DATASET_ID.TABLE_ID
   

   Também é possível usar o comando bq update para remover tags atuais e anexar novas tags.

API

Criar uma tabela com uma coluna de tags

Use o método tables.insert. Inclua o campo dataGovernanceTagsInfo no corpo da solicitação.

```json
{
  "schema": {
    "fields": [
      {
        "name": "Column_X",
        "type": "INT64",
        "description": "sensitive column",
        "dataGovernanceTagsInfo": {
          "dataGovernanceTags": {
            "PROJECT_ID/TAG_KEY": "TAG_VALUE"
          }
        }
      }
    ]
  }
}
```

Adicionar uma tag a uma tabela

1. Recupere o recurso de tabela atual com o método tables.get.

2. Modifique o recurso de tabela para incluir o campo dataGovernanceTagsInfo da coluna de destino.

3. Chame o método tables.update ou tables.patch com o recurso de tabela atualizado.

API

Crie uma política de dados que use uma regra de mascaramento SHA256 predefinida ou uma política de acesso aos dados brutos.

Criar uma política de dados com uma regra de mascaramento SHA256 predefinida

Para criar uma política de dados com uma regra de mascaramento SHA256 predefinida, envie uma solicitação POST para o endpoint dataPolicies:

curl --request POST \
    "https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies" \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{"dataPolicy":{"dataPolicyType":"DATA_MASKING_POLICY","dataMaskingPolicy":{"predefinedExpression":"SHA256"},"grantees": ["principal://goog/subject/EMAIL_ADDRESS"],"dataGovernanceTag":{"key":"PROJECT_ID/TAG_KEY","value":"TAG_VALUE"}},"dataPolicyId":"POLICY_ID"}' \
    --compressed

Substitua:

• PROJECT_ID: o ID do seu Cloud de Confiance by S3NS projeto. Para fornecer uma organização em vez de um projeto como o pai da sua tag, use seu ORGANIZATION_ID em vez do formato dataGovernanceTag.key (ORGANIZATION_ID/TAG_KEY).
• LOCATION: a região em que você está criando a política de dados. Para mais informações, consulte locais da política de dados.
• EMAIL_ADDRESS: o endereço de e-mail do usuário a quem o acesso será concedido.
• TAG_KEY: o nome abreviado da chave de tag.
• TAG_VALUE: um nome abreviado especificado pelo usuário do valor da tag.
• POLICY_ID: o ID da política de dados.

Criar uma política de acesso aos dados brutos

Para criar uma política de acesso aos dados brutos, defina dataPolicyType como RAW_DATA_ACCESS_POLICY:

curl --request POST \
    "https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies" \
    --header "Authorization: Bearer $(gcloud auth print-access-token)" \
    --header 'Accept: application/json' \
    --header 'Content-Type: application/json' \
    --data '{"dataPolicy":{"dataPolicyType":"RAW_DATA_ACCESS_POLICY","grantees": ["principal://goog/subject/EMAIL_ADDRESS"],"dataGovernanceTag":{"key":"PROJECT_ID/TAG_KEY","value":"TAG_VALUE"}},"dataPolicyId":"POLICY_ID"}' \
    --compressed

API

1. Para adicionar usuários atualizando diretamente uma política, primeiro receba a política atual e o etag dela:

   curl --request GET \
       "https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies/POLICY_ID" \
       --header "Authorization: Bearer $(gcloud auth print-access-token)" \
       --header 'Accept: application/json' \
       --header 'Content-Type: application/json' \
       --compressed
   

2. Envie uma solicitação PATCH com a lista atualizada de beneficiários e o etag da etapa anterior:

   curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
       "grantees": ["principal://goog/subject/user1@example.com","principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS"],
       "etag": "ETAG"
     }'  \
   "https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies/POLICY_ID?updateMask=grantees"
   

   Substitua ETAG pelo valor etag retornado pela solicitação GET na etapa anterior.

   Como alternativa, use o método addGrantees para adicionar usuários a uma política:

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
       "grantees": ["principal://goog/subject/user1@example.com","principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS"]
     }'  \
   "https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies/POLICY_ID:addGrantees"
   

3. Para remover usuários de uma política, use o método removeGrantees:

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
       "grantees": ["principal://goog/subject/user1@example.com","principal://iam.googleapis.com/projects/-/serviceAccounts/SA_EMAIL_ADDRESS"]
     }'  \
   "https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies/POLICY_ID:removeGrantees"
   

API

Para excluir uma política de dados, envie uma solicitação DELETE ao endpoint dataPolicies:

curl --request DELETE \
"https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies/POLICY_ID" \
--header "Authorization: Bearer $(gcloud auth print-access-token)" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--compressed

API

Para listar políticas de dados que fazem referência a uma chave de tag, envie uma solicitação GET para o endpoint dataPolicies com um parâmetro filter:

curl --request GET \
"https://bigquerydatapolicy.googleapis.com/v2/projects/PROJECT_ID/locations/LOCATION/dataPolicies?filter=dataGovernanceTag:PROJECT_ID/TAG_KEY" \
--header "Authorization: Bearer $(gcloud auth print-access-token)" \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--compressed