Controla el acceso con etiquetas

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

   Si no ves el panel izquierdo, haz clic en last_page Expandir panel izquierdo para abrirlo.

3. En el panel Explorador, selecciona el proyecto en el que deseas crear tu conjunto de datos.

4. Haz clic en more_vert Ver acciones > Crear conjunto de datos.

5. Ingresa la información de tu nuevo conjunto de datos. Para obtener más información, consulta Crea conjuntos de datos.

6. Expande la sección Etiquetas.

   1. Para aplicar una etiqueta existente, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar permiso y elige Permiso actual: Seleccionar organización actual o Seleccionar proyecto actual.

         Como alternativa, haz clic en Seleccionar alcance para buscar un recurso o ver una lista de los recursos actuales.

      2. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   2. Para ingresar manualmente una etiqueta nueva, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Selecciona un permiso y elige Ingresar IDs manualmente > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto u organización, ingresa el PROJECT_ID o el ORGANIZATION_ID en el diálogo y, luego, haz clic en Guardar.

      3. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   3. Opcional: Para agregar etiquetas adicionales a la tabla, haz clic en Agregar etiqueta y sigue los pasos anteriores.

7. Haz clic en Crear conjunto de datos.

SQL

Usa la sentencia CREATE SCHEMA.

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que crearás.
   • TAG_KEY_1: Es el nombre de la clave con espacio de nombres que deseas establecer como la primera etiqueta en el conjunto de datos, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres para la segunda etiqueta.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Usa el comando bq mk --dataset con la marca --add_tags:

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

Reemplaza lo siguiente:

• TAG: Es la etiqueta que estás adjuntando al conjunto de datos nuevo. Si hay varias etiquetas, estas están separadas por comas. Por ejemplo, 556741164180/env:prod,myProject/department:sales. Cada etiqueta debe tener el nombre de clave con espacio de nombres y el nombre corto del valor.
• PROJECT_ID: el ID del proyecto en el que creas un conjunto de datos.
• DATASET_ID: Es el ID del conjunto de datos nuevo.

Terraform

Usa el recurso google_bigquery_dataset.

Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

En el siguiente ejemplo, se crea un conjunto de datos llamado my_dataset y, luego, se le adjuntan etiquetas; para ello, se completa el 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 tu configuración de Terraform en un proyecto de Cloud de Confiance , completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto Cloud de Confiance predeterminado en el que deseas aplicar tus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.

Prepara el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

1. En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf.

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

2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

   Copia el código de muestra en el main.tf recién creado.

   De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo debes hacerlo una vez por directorio.

   terraform init

   De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google:

   terraform init -upgrade

Aplica los cambios

1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:

   terraform plan

   Corrige la configuración según sea necesario.

2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:

   terraform apply

   Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

3. Abre tu proyecto Cloud de Confiance para ver los resultados. En la consola de Cloud de Confiance , navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

API

Llama al método datasets.insert y agrega tus etiquetas al campo resource_tags.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto, haz clic en Conjuntos de datos y, luego, selecciona un conjunto de datos.

4. En la sección Información del conjunto de datos, haz clic en mode_edit Editar detalles.

5. Expande la sección Etiquetas.

   1. Para aplicar una etiqueta existente, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar permiso y elige Permiso actual: Seleccionar organización actual o Seleccionar proyecto actual.

         Como alternativa, haz clic en Seleccionar alcance para buscar un recurso o ver una lista de los recursos actuales.

      2. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   2. Para ingresar manualmente una etiqueta nueva, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Selecciona un permiso y elige Ingresar IDs manualmente > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto u organización, ingresa el PROJECT_ID o el ORGANIZATION_ID en el diálogo y, luego, haz clic en Guardar.

      3. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   3. Opcional: Para agregar etiquetas adicionales a la tabla, haz clic en Agregar etiqueta y sigue los pasos anteriores.

6. Haz clic en Guardar.

SQL

Usa la sentencia ALTER SCHEMA SET OPTIONS.

En el siguiente ejemplo, se reemplazan todas las etiquetas de un conjunto de datos existente.

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que contiene la tabla.
   • TABLE_ID: Es el nombre de la tabla que etiquetarás.
   • TAG_KEY_1: El nombre de la clave con espacio de nombres que deseas establecer como la primera etiqueta en la tabla, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres para la segunda etiqueta.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta.

3. Haz clic en play_circle Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

En el siguiente ejemplo, se usa el operador += para adjuntar etiquetas a un conjunto de datos sin reemplazar las etiquetas existentes. Si una etiqueta existente tiene la misma clave, se reemplaza.

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que contiene la tabla.
   • TABLE_ID: Es el nombre de la tabla que etiquetarás.
   • TAG_KEY_1: El nombre de la clave con espacio de nombres que deseas establecer como la primera etiqueta en la tabla, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres para la segunda etiqueta.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Usa el comando bq update con la marca --add_tags:

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

Reemplaza lo siguiente:

• TAG: Es la etiqueta que adjuntas al conjunto de datos. Si hay varias etiquetas, estas están separadas por comas. Por ejemplo, 556741164180/env:prod,myProject/department:sales. Cada etiqueta debe tener el nombre de clave con espacio de nombres y el nombre corto del valor.
• PROJECT_ID: El ID del proyecto en el que se encuentra el conjunto de datos existente.
• DATASET_ID: el ID del conjunto de datos existente.

gcloud

Para adjuntar una etiqueta a un conjunto de datos mediante la línea de comandos, crea un recurso de vinculación de etiquetas con el comando gcloud resource-manager tags bindings create:

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

Reemplaza lo siguiente:

• TAG_VALUE_NAME: El ID permanente o el nombre con espacio de nombres del valor de la etiqueta que se adjuntará, como tagValues/4567890123 o 1234567/my_tag_key/my_tag_value.
• RESOURCE_ID: el ID completo del conjunto de datos, incluido el nombre de dominio de la API (//bigquery.googleapis.com/) para identificar el tipo de recurso. Por ejemplo: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset.
• LOCATION: Es la ubicación de tu conjunto de datos.

Terraform

Agrega etiquetas al campo resource_tags del conjunto de datos y, luego, aplica la configuración actualizada con el recurso google_bigquery_dataset. Para obtener más información, consulta el ejemplo de Terraform en Adjunta etiquetas cuando crees un conjunto de datos nuevo.

API

Llama al método datasets.get para obtener el recurso del conjunto de datos, incluido el campo resource_tags. Agrega las etiquetas al campo resource_tags y pasa el recurso del conjunto de datos actualizado mediante el método datasets.update.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto, haz clic en Conjuntos de datos y, luego, selecciona un conjunto de datos.

   Las etiquetas aparecen en la sección Información del conjunto de datos.

bq

Para enumerar las etiquetas adjuntas a un conjunto de datos, usa el comando bq show.

bq show PROJECT_ID:DATASET_ID

Reemplaza lo siguiente:

• PROJECT_ID: El ID del proyecto que contiene este conjunto de datos.
• DATASET_ID: El ID del conjunto de datos cuyas etiquetas deseas enumerar.

gcloud

Para obtener una lista de vinculaciones de etiquetas adjuntas a un recurso, usa el comando gcloud resource-manager tags bindings list:

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

Reemplaza lo siguiente:

• RESOURCE_ID: el ID completo del conjunto de datos, incluido el nombre de dominio de la API (//bigquery.googleapis.com/) para identificar el tipo de recurso. Por ejemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset.

• LOCATION: La ubicación de tu conjunto de datos.

El resultado es similar a lo siguiente:

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

Puedes enumerar las etiquetas heredadas por los conjuntos de datos de BigQuery con gcloud resource-manager tags bindings list. También puedes usar la opción --filter en el atributo namespacedTagValue para filtrar etiquetas según el ID del proyecto, el valor de la etiqueta o la clave de la etiqueta.

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

Reemplaza lo siguiente :

• PROJECT_ID: Es el ID del proyecto que contiene tu conjunto de datos.

• DATASET_ID: el ID del conjunto de datos.

• TAG_FILTER: Especifica un valor para filtrar las etiquetas heredadas según una de las siguientes opciones:

  • Filtra las etiquetas por ID del proyecto. Por ejemplo, myproject.

  • Filtra los valores de la etiqueta especificando el ID permanente o el nombre con espacio de nombres del valor de la etiqueta. Por ejemplo, tagValues/4567890123 o 1234567/my_tag_key/my_tag_value.

  • Filtra las claves de etiquetas especificando el nombre visible de la clave de etiqueta. Por ejemplo: tagkey.

Terraform

Usa el comando terraform state show para enumerar los atributos del conjunto de datos, incluido el campo resource_tags. Ejecuta este comando en el directorio en el que se ejecutó el archivo de configuración de Terraform del conjunto de datos.

terraform state show google_bigquery_dataset.default

API

Llama al método datasets.get para obtener el recurso del conjunto de datos. El recurso de conjunto de datos incluye etiquetas adjuntas al conjunto de datos en el campo resource_tags.

Vistas

Usa la vista INFORMATION_SCHEMA.SCHEMATA_OPTIONS.

Por ejemplo, en la siguiente consulta, se muestran todas las etiquetas adjuntas a todos los conjuntos de datos de una región. Esta consulta muestra una tabla con columnas que incluyen schema_name (los nombres de los conjuntos de datos), option_name (siempre 'tags'), object_type (siempre ARRAY<STRUCT<STRING, STRING>>) y option_value, que contiene arreglos de objetos STRUCT que representan etiquetas asociadas con cada conjunto de datos. Para los conjuntos de datos sin etiquetas asignadas, la columna option_value muestra un array vacío.

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

Reemplaza lo siguiente:

• REGION: la región en la que se encuentran los conjuntos de datos.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto, haz clic en Conjuntos de datos y, luego, selecciona un conjunto de datos.

4. En la sección Información del conjunto de datos, haz clic en mode_edit Editar detalles.

5. En la sección Etiquetas, haz clic en deleteBorrar elemento junto a la etiqueta que deseas borrar.

6. Haz clic en Guardar.

SQL

Usa la sentencia ALTER SCHEMA SET OPTIONS.

En el siguiente ejemplo, se separan etiquetas de un conjunto de datos con el operador -=. Para separar todas las etiquetas de un conjunto de datos, puedes especificar tags=NULL o tags=[].

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que contiene la tabla.
   • TABLE_ID: Es el nombre de la tabla de la que desvinculas las etiquetas.
   • TAG_KEY_1: El nombre de clave con espacio de nombres de la primera etiqueta que deseas desconectar, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta que deseas desconectar, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres de la segunda etiqueta que desvinculas.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta que desvinculas.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Usa el comando bq update con la marca --remove_tags:

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

Reemplaza lo siguiente:

• REMOVED_TAG: la etiqueta que quitas del conjunto de datos. Si hay varias etiquetas, estas están separadas por comas. Solo acepta claves sin pares de valores. Un ejemplo es 556741164180/env,myProject/department. Cada clave de etiqueta debe tener el nombre de clave con espacio de nombres.
• PROJECT_ID: es el ID del proyecto que contiene tu conjunto de datos.
• DATASET_ID: el ID del conjunto de datos del que se desconectarán las etiquetas.

Como alternativa, si deseas quitar todas las etiquetas de un conjunto de datos, usa el comando bq update con la marca --clear_all_tags:

bq update \
    --clear_all_tags
    PROJECT_ID:DATASET_ID

gcloud

Para desvincular una etiqueta de un conjunto de datos mediante la línea de comandos, borra la vinculación de la etiqueta con el comando gcloud resource-manager tags bindings delete:

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

Reemplaza lo siguiente:

• TAG_VALUE_NAME: El ID permanente o el nombre con espacio de nombres del valor de la etiqueta que se desconectará, como tagValues/4567890123 o 1234567/my_tag_key/my_tag_value.
• RESOURCE_ID: el ID completo del conjunto de datos, incluido el nombre de dominio de la API (//bigquery.googleapis.com/) para identificar el tipo de recurso. Por ejemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset.
• LOCATION: La ubicación de tu conjunto de datos.

Terraform

Quita tus etiquetas del campo resource_tags del conjunto de datos y, luego, aplica la configuración actualizada con el recurso google_bigquery_dataset.

API

Llama al método datasets.get para obtener el recurso del conjunto de datos, incluido el campo resource_tags. Quita tus etiquetas del campo resource_tags y pasa el recurso del conjunto de datos actualizado mediante el método datasets.update.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto, haz clic en Conjuntos de datos y, luego, selecciona un conjunto de datos.

4. En la sección Información del conjunto de datos, haz clic en add_box Crear tabla.

5. Ingresa la información de la nueva tabla. Para obtener más información, consulta Crea y usa tablas.

6. Expande la sección Etiquetas.

   1. Para aplicar una etiqueta existente, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar permiso y elige Permiso actual: Seleccionar organización actual o Seleccionar proyecto actual.

         Como alternativa, haz clic en Seleccionar alcance para buscar un recurso o ver una lista de los recursos actuales.

      2. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   2. Para ingresar manualmente una etiqueta nueva, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Selecciona un permiso y elige Ingresar IDs manualmente > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto u organización, ingresa el PROJECT_ID o el ORGANIZATION_ID en el diálogo y, luego, haz clic en Guardar.

      3. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   3. Opcional: Para agregar etiquetas adicionales a la tabla, haz clic en Agregar etiqueta y sigue los pasos anteriores.

7. Haz clic en Crear tabla.

SQL

Usa la sentencia CREATE TABLE.

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos en el que crearás la tabla.
   • TABLE_ID: Es el nombre de la tabla nueva.
   • TAG_KEY_1: El nombre de la clave con espacio de nombres que deseas establecer como la primera etiqueta en la tabla, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres para la segunda etiqueta.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Usa el comando bq mk --table con la marca --add_tags:

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

Reemplaza lo siguiente:

• SCHEMA: es la definición de esquema intercalado.
• TAG: Es la etiqueta que estás adjuntando a la tabla nueva. Si hay varias etiquetas, estas están separadas por comas. Por ejemplo, 556741164180/env:prod,myProject/department:sales. Cada etiqueta debe tener el nombre de clave con espacio de nombres y el nombre corto del valor.
• PROJECT_ID: el ID del proyecto en el que creas una tabla.
• DATASET_ID: el ID del conjunto de datos en el que creas una tabla.
• TABLE_ID: Es el ID de la tabla nueva.

Terraform

Usa el recurso google_bigquery_table.

Para autenticarte en BigQuery, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para bibliotecas cliente.

En el siguiente ejemplo, se crea una tabla llamada mytable y, luego, se le adjuntan etiquetas; para ello, se completa el 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 tu configuración de Terraform en un proyecto de Cloud de Confiance , completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto Cloud de Confiance predeterminado en el que deseas aplicar tus configuraciones de Terraform.

   Solo necesitas ejecutar este comando una vez por proyecto y puedes ejecutarlo en cualquier directorio.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Las variables de entorno se anulan si configuras valores explícitos en el archivo de configuración de Terraform.

Prepara el directorio

Cada archivo de configuración de Terraform debe tener su propio directorio (también llamado módulo raíz).

1. En Cloud Shell, crea un directorio y un archivo nuevo dentro de ese directorio. El nombre del archivo debe tener la extensión .tf, por ejemplo, main.tf. En este instructivo, el archivo se denomina main.tf.

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

2. Si sigues un instructivo, puedes copiar el código de muestra en cada sección o paso.

   Copia el código de muestra en el main.tf recién creado.

   De manera opcional, copia el código de GitHub. Esto se recomienda cuando el fragmento de Terraform es parte de una solución de extremo a extremo.

3. Revisa y modifica los parámetros de muestra que se aplicarán a tu entorno.
4. Guarda los cambios.
5. Inicializa Terraform. Solo debes hacerlo una vez por directorio.

   terraform init

   De manera opcional, incluye la opción -upgrade para usar la última versión del proveedor de Google:

   terraform init -upgrade

Aplica los cambios

1. Revisa la configuración y verifica que los recursos que creará o actualizará Terraform coincidan con tus expectativas:

   terraform plan

   Corrige la configuración según sea necesario.

2. Para aplicar la configuración de Terraform, ejecuta el siguiente comando y, luego, escribe yes cuando se te solicite:

   terraform apply

   Espera hasta que Terraform muestre el mensaje “¡Aplicación completa!”.

3. Abre tu proyecto Cloud de Confiance para ver los resultados. En la consola de Cloud de Confiance , navega a tus recursos en la IU para asegurarte de que Terraform los haya creado o actualizado.

API

Realiza una llamada al método tables.insert con un recurso de tabla definido. Incluye las etiquetas en el campo resource_tags.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto y, luego, haz clic en Conjuntos de datos.

4. Haz clic en Overview > Tables y, luego, selecciona una tabla.

5. Haz clic en la pestaña Detalles y, luego, en mode_edit Editar detalles.

6. Expande la sección Etiquetas.

   1. Para aplicar una etiqueta existente, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar permiso y elige Permiso actual: Seleccionar organización actual o Seleccionar proyecto actual.

         Como alternativa, haz clic en Seleccionar alcance para buscar un recurso o ver una lista de los recursos actuales.

      2. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   2. Para ingresar manualmente una etiqueta nueva, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Selecciona un permiso y elige Ingresar IDs manualmente > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto u organización, ingresa el PROJECT_ID o el ORGANIZATION_ID en el diálogo y, luego, haz clic en Guardar.

      3. En Clave 1 y Valor 1, elige los valores adecuados de las listas.

   3. Opcional: Para agregar etiquetas adicionales a la tabla, haz clic en Agregar etiqueta y sigue los pasos anteriores.

7. Haz clic en Guardar.

SQL

Usa la sentencia ALTER TABLE SET OPTIONS.

En el siguiente ejemplo, se reemplazan todas las etiquetas de una tabla existente.

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que contiene la tabla.
   • TABLE_ID: Es el nombre de la tabla que etiquetarás.
   • TAG_KEY_1: El nombre de la clave con espacio de nombres que deseas establecer como la primera etiqueta en la tabla, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres para la segunda etiqueta.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta.

3. Haz clic en play_circle Ejecutar.

Para obtener más información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

En el siguiente ejemplo, se usa el operador += para adjuntar una etiqueta a una tabla sin reemplazar las etiquetas existentes. Si una etiqueta existente tiene la misma clave, se reemplaza.

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que contiene la tabla.
   • TABLE_ID: Es el nombre de la tabla que etiquetarás.
   • TAG_KEY_1: El nombre de la clave con espacio de nombres que deseas establecer como la primera etiqueta en la tabla, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres para la segunda etiqueta.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Usa el comando bq update con la marca --add_tags:

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

Reemplaza lo siguiente:

• TAG: Es la etiqueta que adjuntas a la tabla. Si hay varias etiquetas, estas están separadas por comas. Por ejemplo, 556741164180/env:prod,myProject/department:sales. Cada etiqueta debe tener el nombre de clave con espacio de nombres y el nombre corto del valor.
• PROJECT_ID: el ID del proyecto que contiene tu tabla.
• DATASET_ID: el ID del conjunto de datos que contiene tu tabla.
• TABLE_ID: el ID de la tabla que deseas actualizar.

gcloud

Para adjuntar una etiqueta a una tabla mediante la línea de comandos, crea un recurso de vinculación de etiquetas con el comando gcloud resource-manager tags bindings create:

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

Reemplaza lo siguiente:

• TAG_VALUE_NAME: El ID permanente o el nombre con espacio de nombres del valor de la etiqueta que se adjuntará, como tagValues/4567890123 o 1234567/my_tag_key/my_tag_value.
• RESOURCE_ID: el ID completo de la tabla, incluido el nombre de dominio de la API (//bigquery.googleapis.com/) para identificar el tipo de recurso. Por ejemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table
• LOCATION: La ubicación de tu tabla.

Terraform

Agrega etiquetas al campo resource_tags de la tabla y, luego, aplica la configuración actualizada con el recurso google_bigquery_table. Para obtener más información, consulta el ejemplo de Terraform en Adjunta etiquetas cuando crees una tabla nueva.

API

Realiza una llamada al método tables.update con un recurso de tabla definido. Incluye las etiquetas en el campo resource_tags.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto y, luego, haz clic en Conjuntos de datos.

4. Haz clic en Overview > Tables y, luego, selecciona una tabla.

   Las etiquetas se pueden ver en la pestaña Detalles.

bq

Usa el comando bq show y busca la columna tags. Si no hay etiquetas en la tabla, no se muestra la columna tags.

bq show \
    PROJECT_ID:DATASET_ID.TABLE_ID

Reemplaza lo siguiente:

• PROJECT_ID: el ID del proyecto que contiene tu tabla.
• DATASET_ID: el ID del conjunto de datos que contiene tu tabla.
• TABLE_ID: el ID de tu tabla.

gcloud

Para obtener una lista de vinculaciones de etiquetas adjuntas a un recurso, usa el comando gcloud resource-manager tags bindings list:

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

Reemplaza lo siguiente:

• RESOURCE_ID: el ID completo de la tabla, incluido el nombre de dominio de la API (//bigquery.googleapis.com/) para identificar el tipo de recurso. Por ejemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table.

• LOCATION: La ubicación de tu conjunto de datos.

El resultado es similar a lo siguiente:

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

Puedes enumerar las etiquetas heredadas por las tablas de BigQuery con gcloud resource-manager tags bindings list. También puedes usar la opción --filter en el atributo namespacedTagValue para filtrar etiquetas según el ID del proyecto, el valor de la etiqueta o la clave de la etiqueta.

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

Reemplaza lo siguiente :

• PROJECT_ID: Es el ID del proyecto que contiene tu conjunto de datos.

• DATASET_ID: el ID del conjunto de datos.

• TAG_FILTER: Especifica un valor para filtrar las etiquetas heredadas según una de las siguientes opciones:

  • Filtra las etiquetas por ID del proyecto. Por ejemplo, myproject.

  • Filtra los valores de la etiqueta especificando el ID permanente o el nombre con espacio de nombres del valor de la etiqueta. Por ejemplo, tagValues/4567890123 o 1234567/my_tag_key/my_tag_value.

  • Filtra las claves de etiquetas especificando el nombre visible de la clave de etiqueta. Por ejemplo: tagkey.

Terraform

Usa el comando terraform state show para enumerar los atributos de la tabla, incluido el campo resource_tags. Ejecuta este comando en el directorio en el que se ejecutó el archivo de configuración de Terraform de la tabla.

terraform state show google_bigquery_table.default

API

Realiza una llamada al método tables.get con un recurso de tabla definido y busca el campo resource_tags.

Vistas

Usa la vista INFORMATION_SCHEMA.TABLE_OPTIONS.

Por ejemplo, en la siguiente consulta, se muestran todas las etiquetas adjuntas a todas las tablas en un conjunto de datos. Esta consulta muestra una tabla con columnas que incluyen schema_name (el nombre del conjunto de datos), option_name (siempre 'tags'), object_type (siempre ARRAY<STRUCT<STRING, STRING>>) y option_value, que contiene arreglos de objetos STRUCT que representan etiquetas asociadas con cada conjunto de datos. Para las tablas sin etiquetas asignadas, la columna option_value muestra un array vacío.

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

Reemplaza DATASET_ID por el ID del conjunto de datos que contiene tu tabla.

Console

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel de la izquierda, haz clic en exploreExplorar.

   

3. En el panel Explorador, expande tu proyecto y, luego, haz clic en Conjuntos de datos.

4. Haz clic en Overview > Tables y, luego, selecciona una tabla.

5. Haz clic en la pestaña Detalles y, luego, en mode_edit Editar detalles.

6. En la sección Etiquetas, haz clic en deleteBorrar elemento junto a la etiqueta que deseas borrar.

7. Haz clic en Guardar.

SQL

Usa la sentencia ALTER TABLE SET OPTIONS.

En el siguiente ejemplo, se separan etiquetas de una tabla con el operador -=. Para separar todas las etiquetas de una tabla, puedes especificar tags=NULL o tags=[].

1. En la consola de Cloud de Confiance , ve a la página BigQuery.

   Ir a BigQuery

2. En el editor de consultas, escribe la siguiente oración:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: el ID de tu proyecto
   • DATASET_ID: Es el ID del conjunto de datos que contiene la tabla.
   • TABLE_ID: Es el nombre de la tabla de la que desvinculas las etiquetas.
   • TAG_KEY_1: El nombre de clave con espacio de nombres de la primera etiqueta que deseas desconectar, por ejemplo, 'my-project/env' o '556741164180/department'.
   • TAG_VALUE_1: El nombre corto del valor de la etiqueta que deseas desconectar, por ejemplo, 'prod' o 'sales'.
   • TAG_KEY_2: Es el nombre de la clave con espacio de nombres de la segunda etiqueta que desvinculas.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta que desvinculas.

3. Haz clic en play_circle Ejecutar.

Si deseas obtener información sobre cómo ejecutar consultas, visita Ejecuta una consulta interactiva.

bq

Para quitar algunas etiquetas de una tabla, usa el comando bq update con la marca --remove_tags:

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

Reemplaza lo siguiente:

• TAG_KEYS: las claves de etiqueta que desconectas de la tabla, separadas por comas. Por ejemplo, 556741164180/env,myProject/department. Cada clave de etiqueta debe tener el nombre de clave con espacio de nombres.
• PROJECT_ID: el ID del proyecto que contiene tu tabla.
• DATASET_ID: el ID del conjunto de datos que contiene tu tabla.
• TABLE_ID: el ID de la tabla que deseas actualizar.

Para quitar todas las etiquetas de una tabla, usa el comando bq update con la marca --clear_all_tags:

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

gcloud

Para quitar una asociación de etiqueta de una tabla mediante la línea de comandos, borra la vinculación de etiqueta con el comando gcloud resource-manager tags bindings delete:

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

Reemplaza lo siguiente:

• TAG_VALUE_NAME: El ID permanente o el nombre con espacio de nombres del valor de la etiqueta que se eliminará, como tagValues/4567890123 o 1234567/my_tag_key/my_tag_value.
• RESOURCE_ID: el ID completo de la tabla, incluido el nombre de dominio de la API (//bigquery.googleapis.com/) para identificar el tipo de recurso. Por ejemplo, //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table.
• LOCATION: La ubicación de tu conjunto de datos.

Terraform

Quita tus etiquetas del campo resource_tags de la tabla y, luego, aplica la configuración actualizada con el recurso google_bigquery_table.

API

Realiza una llamada al método tables.update con un recurso de tabla definido y quita las etiquetas en el campo resource_tags. Para quitar todas las etiquetas, quita el campo resource_tags.

gcloud

1. Ejecuta el comando gcloud resource-manager tags keys create:

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

   Reemplaza lo siguiente:

   • TAG_KEY: Es el nombre corto de la clave de etiqueta.
   • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS. Para proporcionar una organización en lugar de un proyecto, usa organizations/ORGANIZATION_ID en lugar de projects/PROJECT_ID.

API

1. Envía una solicitud POST al extremo 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
   

   Reemplaza lo siguiente:

   • TAG_KEY: Es el nombre corto de la clave de etiqueta.
   • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS. Para proporcionar una organización en lugar de un proyecto, usa organizations/ORGANIZATION_ID en lugar de projects/PROJECT_ID.

gcloud

1. Ejecuta el comando gcloud resource-manager tags keys list para obtener el nombre con espacio de nombres de la clave de etiqueta:

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

2. Ejecuta el comando gcloud resource-manager tags values create para crear un valor nuevo:

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

   Reemplaza lo siguiente:

   • TAG_VALUE: Es el nombre corto especificado por el usuario del valor de la etiqueta.
   • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS. Para proporcionar una organización en lugar de un proyecto, usa tu ORGANIZATION_ID.

API

1. Obtén el nombre con espacio de nombres para la clave de etiqueta:

   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'
   

   La respuesta contiene el campo name, por ejemplo, tagKeys/4567890123.

2. Envía una solicitud POST al extremo tagValues con el nombre de la clave de la etiqueta:

   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
   

   Reemplaza lo siguiente:

   • TAG_VALUE: Es el nombre corto especificado por el usuario del valor de la etiqueta.
   • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS. Para proporcionar una organización en lugar de un proyecto, usa tu ORGANIZATION_ID.
   • TAG_KEY_ID: Es el nombre con espacio de nombres de la clave de la etiqueta del paso 1. Por ejemplo, si el nombre de la clave de la etiqueta es tagKeys/4567890123, el ID de la clave de la etiqueta es 4567890123.

gcloud

Para crear un valor de etiqueta secundario, ejecuta el comando gcloud resource-manager tags values create y especifica un valor de etiqueta principal en la marca --parent:

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

Reemplaza lo siguiente:

• CHILD_TAG_VALUE: Es el nombre corto del valor de la etiqueta secundaria que creas.
• PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS . Para proporcionar una organización en lugar de un proyecto, usa tu ORGANIZATION_ID.
• TAG_KEY: Es el nombre corto de la clave de etiqueta que es principal del valor de la etiqueta.
• PARENT_TAG_VALUE: Es el nombre corto del valor de la etiqueta principal.

API

Para crear un valor de etiqueta secundaria, usa el nombre del recurso del valor de etiqueta principal (por ejemplo, tagValues/123456789012) en el 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

Reemplaza lo siguiente:

• CHILD_TAG_VALUE: Es el nombre corto del valor de la etiqueta secundaria que creas.
• PARENT_TAG_VALUE_ID: Es el ID numérico del valor de la etiqueta principal.

SQL

Crea una tabla nueva con una columna etiquetada

Para adjuntar etiquetas de administración de datos cuando crees una tabla nueva, usa la declaración CREATE TABLE. Para especificar la etiqueta, configura la opción data_governance_tags en la columna.

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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS . Para proporcionar una organización en lugar de un proyecto como elemento superior de tu etiqueta, usa tu ORGANIZATION_ID en lugar del formato de clave de etiqueta (ORGANIZATION_ID/TAG_KEY).
• DATASET_ID: Es el ID del conjunto de datos en el que reside la tabla.
• TABLE_ID: Es el ID de la tabla que estás creando.
• COLUMN_NAME: Es el nombre de la columna que deseas etiquetar.
• TAG_KEY: Es la clave de la etiqueta que deseas aplicar.
• TAG_VALUE: Es el valor de la etiqueta que deseas aplicar.

Agrega una etiqueta a una tabla existente

Para adjuntar etiquetas de administración de datos a una columna en una tabla existente, usa la declaración ALTER TABLE para establecer la opción data_governance_tags en la columna.

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

CLI de bq

Crea una tabla nueva con una columna etiquetada

1. Para crear un archivo de esquema JSON local que defina la etiqueta, ejecuta el comando bq mk:

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

   Reemplaza lo siguiente:

   • PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS. Para proporcionar una organización en lugar de un proyecto como elemento superior de tu etiqueta, usa tu ORGANIZATION_ID en lugar del formato de clave de etiqueta (ORGANIZATION_ID/TAG_KEY).
   • DATASET_ID: Es el ID del conjunto de datos en el que reside la tabla.
   • TABLE_ID: Es el ID de la tabla que estás creando.

Agrega una etiqueta a una tabla existente

1. Para agregar una etiqueta a una tabla existente, primero exporta su esquema a un archivo local:

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

2. Edita el archivo de esquema para agregar el objeto dataGovernanceTagsInfo a la columna. Por ejemplo:

   [
     {
       "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. Actualiza la tabla para adjuntar etiquetas a la columna sensible con el comando bq update:

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

   También puedes usar el comando bq update para quitar etiquetas existentes y adjuntar etiquetas nuevas.

API

Crea una tabla nueva con una columna etiquetada

Usa el método tables.insert. Incluye el campo dataGovernanceTagsInfo en el cuerpo de la solicitud.

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

Agrega una etiqueta a una tabla existente

1. Recupera el recurso de tabla actual con el método tables.get.

2. Modifica el recurso de la tabla para incluir el campo dataGovernanceTagsInfo de la columna de destino.

3. Llama al método tables.update o tables.patch con el recurso de tabla actualizado.

API

Crea una política de datos que use una regla de enmascaramiento SHA256 predefinida o crea una política de acceso a los datos sin procesar.

Crea una política de datos con una regla de enmascaramiento SHA256 predefinida

Para crear una política de datos con una regla de enmascaramiento SHA256 predefinida, envía una solicitud POST al extremo 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

Reemplaza lo siguiente:

• PROJECT_ID: Es el ID de tu proyecto de Cloud de Confiance by S3NS. Para proporcionar una organización en lugar de un proyecto como elemento superior de tu etiqueta, usa tu ORGANIZATION_ID en lugar del formato dataGovernanceTag.key (ORGANIZATION_ID/TAG_KEY).
• LOCATION: Es la región en la que crearás la política de datos. Para obtener más información, consulta las ubicaciones de las políticas de datos.
• EMAIL_ADDRESS: Es la dirección de correo electrónico del usuario al que se le otorgará acceso.
• TAG_KEY: Es el nombre corto de la clave de etiqueta.
• TAG_VALUE: Es un nombre corto especificado por el usuario para el valor de la etiqueta.
• POLICY_ID: Es el ID de la política de datos.

Crea una política de acceso a los datos sin procesar

Para crear una política de acceso a los datos sin procesar, establece dataPolicyType en 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 agregar usuarios actualizando directamente una política, primero obtén la política actual y su etag:

   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. Envía una solicitud PATCH con la lista actualizada de beneficiarios y el etag del paso 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"
   

   Reemplaza ETAG por el valor etag que devolvió la solicitud GET en el paso anterior.

   También puedes usar el método addGrantees para agregar usuarios a una 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 quitar usuarios de una política, usa el 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 borrar una política de datos, envía una solicitud DELETE al extremo 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 enumerar las políticas de datos que hacen referencia a una clave de etiqueta, envía una solicitud GET al extremo dataPolicies con un 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