Etiqueta tablas, vistas y conjuntos de datos

Console

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

   Ir a BigQuery

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

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

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

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 alcance y elige Alcance actual: Seleccionar la organización actual o Seleccionar el 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 una etiqueta nueva de forma manual, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar un alcance y elige Ingresar IDs de forma manual > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto o organización, en el diálogo, ingresa PROJECT_ID o ORGANIZATION_ID 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 Crear conjunto de datos.

SQL

Usa la sentencia CREATE SCHEMA.

1. En la consola de Google Cloud , 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: El nombre de 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 clave con espacio de nombres de 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 Google Cloud , completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto Google Cloud 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 Google Cloud proyecto para ver los resultados. En la consola de Google Cloud , 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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y elige un conjunto de datos.

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

4. Expande la sección Etiquetas.

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

      1. Haz clic en la flecha desplegable junto a Seleccionar alcance y elige Alcance actual: Seleccionar la organización actual o Seleccionar el 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 una etiqueta nueva de forma manual, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar un alcance y elige Ingresar IDs de forma manual > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto o organización, en el diálogo, ingresa PROJECT_ID o ORGANIZATION_ID 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.

5. 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 Google Cloud , 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 deseas etiquetar.
   • TAG_KEY_1: Es el nombre de clave con espacio de nombres que deseas establecer como la primera etiqueta de 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 clave con espacio de nombres de 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 reemplazará.

1. En la consola de Google Cloud , 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 deseas etiquetar.
   • TAG_KEY_1: Es el nombre de clave con espacio de nombres que deseas establecer como la primera etiqueta de 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 clave con espacio de nombres de 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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y elige 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 este:

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

Terraform

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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y elige un conjunto de datos.

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

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

5. 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 desvincular todas las etiquetas de un conjunto de datos, puedes especificar tags=NULL o tags=[].

1. En la consola de Google Cloud , 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 deseas desvincular 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 clave con espacio de nombres de la segunda etiqueta que deseas separar.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta que deseas quitar.

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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande tu proyecto y elige un conjunto de datos.

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

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

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 alcance y elige Alcance actual: Seleccionar la organización actual o Seleccionar el 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 una etiqueta nueva de forma manual, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar un alcance y elige Ingresar IDs de forma manual > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto o organización, en el diálogo, ingresa PROJECT_ID o ORGANIZATION_ID 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 Crear tabla.

SQL

Usa la sentencia CREATE TABLE.

1. En la consola de Google Cloud , 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: Es el nombre de clave con espacio de nombres que deseas establecer como la primera etiqueta de 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 clave con espacio de nombres de 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"
  deletion_protection = false # set to "true" in production

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

Para aplicar tu configuración de Terraform en un proyecto de Google Cloud , completa los pasos de las siguientes secciones.

Prepara Cloud Shell

1. Inicia Cloud Shell

2. Establece el proyecto Google Cloud 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 Google Cloud proyecto para ver los resultados. En la consola de Google Cloud , 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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande el proyecto y el conjunto de datos y, luego, selecciona una tabla.

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

4. Expande la sección Etiquetas.

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

      1. Haz clic en la flecha desplegable junto a Seleccionar alcance y elige Alcance actual: Seleccionar la organización actual o Seleccionar el 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 una etiqueta nueva de forma manual, haz lo siguiente:

      1. Haz clic en la flecha desplegable junto a Seleccionar un alcance y elige Ingresar IDs de forma manual > Organización, Proyecto o Etiquetas.

      2. Si creas una etiqueta para tu proyecto o organización, en el diálogo, ingresa PROJECT_ID o ORGANIZATION_ID 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.

5. 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 Google Cloud , 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 deseas etiquetar.
   • TAG_KEY_1: Es el nombre de clave con espacio de nombres que deseas establecer como la primera etiqueta de 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 clave con espacio de nombres de 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 reemplazará.

1. En la consola de Google Cloud , 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 deseas etiquetar.
   • TAG_KEY_1: Es el nombre de clave con espacio de nombres que deseas establecer como la primera etiqueta de 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 clave con espacio de nombres de 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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande el proyecto y el conjunto de datos 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 este:

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

Terraform

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 Google Cloud , ve a la página BigQuery.

   Ir a BigQuery

2. En el panel Explorador, expande el proyecto y el conjunto de datos y, luego, selecciona una tabla.

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

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

5. 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 desvincular todas las etiquetas de una tabla, puedes especificar tags=NULL o tags=[].

1. En la consola de Google Cloud , 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 deseas desvincular 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 clave con espacio de nombres de la segunda etiqueta que deseas separar.
   • TAG_VALUE_2: Es el nombre corto del valor de la segunda etiqueta que deseas quitar.

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.