Zugriff mit Tags steuern

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

   Wenn der linke Bereich nicht angezeigt wird, klicken Sie auf last_page Linken Bereich maximieren, um ihn zu öffnen.

3. Wählen Sie im Bereich Explorer das Projekt aus, in dem Sie das Dataset erstellen möchten.

4. Klicken Sie auf more_vert Aktionen ansehen > Dataset erstellen.

5. Geben Sie die Informationen für das neue Dataset ein. Weitere Informationen finden Sie unter Datasets erstellen.

6. Maximieren Sie den Bereich Tags.

   1. So wenden Sie ein vorhandenes Tag an:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie Aktueller Bereich – Aktuelle Organisation auswählen oder Aktuelles Projekt auswählen aus.

         Alternativ können Sie auf Bereich auswählen klicken, um nach einer Ressource zu suchen oder eine Liste der aktuellen Ressourcen aufzurufen.

      2. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   2. So geben Sie ein neues Tag manuell ein:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie IDs manuell eingeben > Organisation, Projekt oder Tags aus.

      2. Wenn Sie ein Tag für Ihr Projekt oder Ihre Organisation erstellen, geben Sie im Dialogfeld die PROJECT_ID oder die ORGANIZATION_ID ein und klicken Sie dann auf Speichern.

      3. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   3. Optional: Wenn Sie der Tabelle weitere Tags hinzufügen möchten, klicken Sie auf Tag hinzufügen und folgen Sie der Anleitung oben.

7. Klicken Sie auf Dataset erstellen.

SQL

Verwenden Sie die Anweisung CREATE SCHEMA.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des zu erstellenden Datasets.
   • TAG_KEY_1: der Namespace-Schlüsselname, den Sie als erstes Tag für das Dataset festlegen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: der Kurzname für den Wert des Tags, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Führen Sie den Befehl bq mk --dataset mit dem Flag --add_tags aus:

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

Ersetzen Sie Folgendes:

• TAG: das Tag, das Sie an das neue Dataset anhängen. Mehrere Tags werden durch Kommas getrennt. Beispiel: 556741164180/env:prod,myProject/department:sales Jedes Tag muss den Parameter Kurzname des Namespace-Schlüssels und des Namespace haben.
• PROJECT_ID: die ID des Projekts, in dem Sie ein Dataset erstellen.
• DATASET_ID: die ID des neuen Datasets.

Terraform

Verwenden Sie die Ressource google_bigquery_dataset:

Richten Sie zur Authentifizierung bei BigQuery die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Im folgenden Beispiel wird ein Dataset mit dem Namen my_dataset erstellt und dann mit Tags versehen, indem das Feld resource_tags ausgefüllt wird:

# 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
  }
}

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Standardprojekt Cloud de Confiance fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

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

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

API

Rufen Sie die Methode datasets.insert auf und fügen Sie Ihre Tags in das Feld resource_tags ein.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt, klicken Sie auf Datasets und wählen Sie dann ein Dataset aus.

4. Klicken Sie im Abschnitt Dataset-Informationen auf mode_edit Details bearbeiten.

5. Maximieren Sie den Bereich Tags.

   1. So wenden Sie ein vorhandenes Tag an:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie Aktueller Bereich – Aktuelle Organisation auswählen oder Aktuelles Projekt auswählen aus.

         Alternativ können Sie auf Bereich auswählen klicken, um nach einer Ressource zu suchen oder eine Liste der aktuellen Ressourcen aufzurufen.

      2. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   2. So geben Sie ein neues Tag manuell ein:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie IDs manuell eingeben > Organisation, Projekt oder Tags aus.

      2. Wenn Sie ein Tag für Ihr Projekt oder Ihre Organisation erstellen, geben Sie im Dialogfeld die PROJECT_ID oder die ORGANIZATION_ID ein und klicken Sie dann auf Speichern.

      3. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   3. Optional: Wenn Sie der Tabelle weitere Tags hinzufügen möchten, klicken Sie auf Tag hinzufügen und folgen Sie den vorherigen Schritten.

6. Klicken Sie auf Speichern.

SQL

Verwenden Sie die Anweisung ALTER SCHEMA SET OPTIONS.

Im folgenden Beispiel werden alle Tags für ein vorhandenes Dataset überschrieben.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, das die Tabelle enthält.
   • TABLE_ID: der Name der Tabelle, die Sie taggen.
   • TAG_KEY_1: der Namespace-Schlüsselname, den Sie als erstes Tag für die Tabelle festlegen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: der Kurzname für den Wert des Tags, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

Im folgenden Beispiel wird der Operator += verwendet, um einem Dataset Tags zuzuweisen, ohne vorhandene Tags zu überschreiben. Wenn ein vorhandenes Tag denselben Schlüssel hat, wird dieses Tag überschrieben.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, das die Tabelle enthält.
   • TABLE_ID: der Name der Tabelle, die Sie taggen.
   • TAG_KEY_1: der Namespace-Schlüsselname, den Sie als erstes Tag für die Tabelle festlegen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: der Kurzname für den Wert des Tags, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Führen Sie den Befehl bq update mit dem Flag --add_tags aus:

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

Ersetzen Sie Folgendes:

• TAG: Das Tag, das Sie dem Dataset zuweisen. Mehrere Tags werden durch Kommas getrennt. Beispiel: 556741164180/env:prod,myProject/department:sales Jedes Tag muss den Parameter Kurzname des Namespace-Schlüssels und des Namespace haben.
• PROJECT_ID: die ID des Projekts, in dem sich das vorhandene Dataset befindet.
• DATASET_ID: die ID des vorhandenen Datasets.

gcloud

Zum Anhängen eines Tags an ein Dataset über die Befehlszeile erstellen Sie mit dem Befehl gcloud resource-manager tags bindings create eine Tag-Bindungsressource:

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

Ersetzen Sie Folgendes:

• TAG_VALUE_NAME: die permanente ID oder der Namespace-Name des Tag-Werts, der angehängt werden soll, z. B. tagValues/4567890123 oder 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: die vollständige ID des Datasets, einschließlich des API-Domainnamens (//bigquery.googleapis.com/), um den Ressourcentyp zu identifizieren. Beispiel: //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
• LOCATION: der Standort Ihres Datasets.

Terraform

Fügen Sie dem Feld resource_tags des Datasets Tags hinzu und wenden Sie dann die aktualisierte Konfiguration mit der Ressource google_bigquery_dataset an. Weitere Informationen finden Sie im Terraform-Beispiel unter Tags beim Erstellen eines neuen Datasets anhängen.

API

Rufen Sie die Methode datasets.get auf, um die Dataset-Ressource einschließlich des Felds resource_tags abzurufen. Fügen Sie Ihre Tags dem Feld resource_tags hinzu und übergeben Sie die aktualisierte Dataset-Ressource mit der Methode datasets.update zurück.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt, klicken Sie auf Datasets und wählen Sie dann ein Dataset aus.

   Die Tags werden im Bereich Dataset-Informationen angezeigt.

bq

Verwenden Sie den Befehl bq show, um Tags aufzulisten, die an ein Dataset angehängt sind.

bq show PROJECT_ID:DATASET_ID

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID des Projekts, das Ihr Dataset enthält.
• DATASET_ID: die ID des Datasets, für das Sie die Tags auflisten möchten.

gcloud

Verwenden Sie den Befehl gcloud resource-manager tags bindings list, um eine Liste der Tag-Bindungen abzurufen, die an eine Ressource angehängt sind:

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

Ersetzen Sie Folgendes:

• RESOURCE_ID: die vollständige ID des Datasets, einschließlich des API-Domainnamens (//bigquery.googleapis.com/), um den Ressourcentyp zu identifizieren, z. B. //bigquery.googleapis.com/projects/my_project/datasets/my_dataset

• LOCATION: der Standort Ihres Datasets

Die Ausgabe sieht etwa so aus:

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

Sie können die von BigQuery-Datasets übernommenen Tags mit gcloud resource-manager tags bindings list auflisten. Sie können auch die Option --filter für das Attribut namespacedTagValue verwenden, um Tags nach Projekt-ID, Tag-Wert oder Tag-Schlüssel zu filtern.

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

Ersetzen Sie Folgendes :

• PROJECT_ID: die ID des Projekts, das Ihr Dataset enthält.

• DATASET_ID: Die ID des Datasets.

• TAG_FILTER: Geben Sie einen Wert an, um nach übernommenen Tags zu filtern. Verwenden Sie dazu eine der folgenden Optionen:

  • Nach Tags nach Projekt-ID filtern. Beispiel: myproject.

  • Filtern Sie nach Tag-Werten, indem Sie die permanente ID oder den Namespace-Namen des Tag-Werts angeben. Beispiel: tagValues/4567890123 oder 1234567/my_tag_key/my_tag_value.

  • Filtern Sie nach Tag-Schlüsseln, indem Sie den Anzeigenamen für den Tag-Schlüssel angeben. Beispiel: tagkey

Terraform

Verwenden Sie den Befehl terraform state show, um die Attribute des Datasets aufzulisten, einschließlich des Felds resource_tags. Führen Sie diesen Befehl in dem Verzeichnis aus, in dem die Terraform-Konfigurationsdatei des Datasets ausgeführt wurde.

terraform state show google_bigquery_dataset.default

API

Rufen Sie die Methode datasets.get auf, um die Dataset-Ressource abzurufen. Die Dataset-Ressource enthält Tags, die dem Dataset im Feld resource_tags zugeordnet sind.

Aufrufe

Wählen Sie das Dropdown-Menü INFORMATION_SCHEMA.SCHEMATA_OPTIONS Ansicht aus:

Die folgende Abfrage zeigt beispielsweise alle Tags, die allen Datasets in einer Region zugewiesen sind. Diese Abfrage gibt eine Tabelle mit Spalten zurück, wie schema_name (die Dataset-Namen), option_name (immer 'tags'), object_type (immer ARRAY<STRUCT<STRING, STRING>>) und option_value, das Arrays von STRUCT-Objekten enthält, die Tags darstellen, die mit jedem Dataset verknüpft sind. Für Datasets ohne zugewiesene Tags gibt die Spalte option_value ein leeres Array zurück.

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

Ersetzen Sie Folgendes:

• REGION: die Region, in der sich Ihre Datasets befinden.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt, klicken Sie auf Datasets und wählen Sie dann ein Dataset aus.

4. Klicken Sie im Abschnitt Dataset-Informationen auf mode_edit Details bearbeiten.

5. Klicken Sie im Bereich Tags neben dem Tag, das Sie löschen möchten, auf deleteElement löschen.

6. Klicken Sie auf Speichern.

SQL

Verwenden Sie die Anweisung ALTER SCHEMA SET OPTIONS.

Im folgenden Beispiel werden Tags mithilfe des Operators -= von einem Dataset getrennt. Wenn Sie alle Tags von einem Dataset trennen möchten, können Sie tags=NULL oder tags=[] angeben.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, das die Tabelle enthält.
   • TABLE_ID: der Name der Tabelle, aus der Sie die Tags entfernen.
   • TAG_KEY_1: der Namespace-Schlüsselname des ersten Tags, das Sie trennen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: Der Kurzname des Werts für das Tag, das Sie trennen möchten, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: der Namespace-Schlüsselname für das zweite Tag, das Sie trennen.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags, das Sie trennen.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Führen Sie den Befehl bq update mit dem Flag --remove_tags aus:

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

Ersetzen Sie Folgendes:

• REMOVED_TAG: das Tag, das Sie aus dem Dataset entfernen. Mehrere Tags werden durch Kommas getrennt. Akzeptiert nur Schlüssel ohne Wertepaare. Beispiel: 556741164180/env,myProject/department. Jeder Tag muss den Namespace-Schlüsselnamen haben.
• PROJECT_ID: Die ID des Projekts, das Ihr Dataset enthält.
• DATASET_ID: die ID des Datasets, aus dem Tags getrennt werden sollen.

Wenn Sie alle Tags aus einem Dataset entfernen möchten, verwenden Sie alternativ den Befehl bq update mit dem Flag --clear_all_tags:

bq update \
    --clear_all_tags
    PROJECT_ID:DATASET_ID

gcloud

Zum Trennen eines Tags von einem Dataset über die Befehlszeile löschen Sie die Tag-Bindung mit dem Befehl gcloud resource-manager tags bindings delete:

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

Ersetzen Sie Folgendes:

• TAG_VALUE_NAME: die permanente ID oder der Namespace-Name des Tag-Werts, der angehängt werden soll, z. B. tagValues/4567890123 oder 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: die vollständige ID des Datasets, einschließlich des API-Domainnamens (//bigquery.googleapis.com/), um den Ressourcentyp zu identifizieren, z. B. //bigquery.googleapis.com/projects/my_project/datasets/my_dataset
• LOCATION: der Standort Ihres Datasets

Terraform

Entfernen Sie die Tags aus dem Feld resource_tags des Datasets und wenden Sie dann die aktualisierte Konfiguration mit der Ressource google_bigquery_dataset an.

API

Rufen Sie die Methode datasets.get auf, um die Dataset-Ressource einschließlich des Felds resource_tags abzurufen. Entfernen Sie Ihre Tags aus dem Feld resource_tags und übergeben Sie die aktualisierte Dataset-Ressource mit der Methode datasets.update zurück.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt, klicken Sie auf Datasets und wählen Sie dann ein Dataset aus.

4. Klicken Sie im Abschnitt Dataset-Informationen auf add_box Tabelle erstellen.

5. Geben Sie die Informationen für die neue Tabelle ein. Weitere Informationen finden Sie unter Tabellen erstellen und verwenden.

6. Maximieren Sie den Bereich Tags.

   1. So wenden Sie ein vorhandenes Tag an:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie Aktueller Bereich – Aktuelle Organisation auswählen oder Aktuelles Projekt auswählen aus.

         Alternativ können Sie auf Bereich auswählen klicken, um nach einer Ressource zu suchen oder eine Liste der aktuellen Ressourcen aufzurufen.

      2. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   2. So geben Sie ein neues Tag manuell ein:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie IDs manuell eingeben > Organisation, Projekt oder Tags aus.

      2. Wenn Sie ein Tag für Ihr Projekt oder Ihre Organisation erstellen, geben Sie im Dialogfeld die PROJECT_ID oder die ORGANIZATION_ID ein und klicken Sie dann auf Speichern.

      3. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   3. Optional: Wenn Sie der Tabelle weitere Tags hinzufügen möchten, klicken Sie auf Tag hinzufügen und folgen Sie der Anleitung oben.

7. Klicken Sie auf Tabelle erstellen.

SQL

Verwenden Sie die Anweisung CREATE TABLE.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, in dem Sie die Tabelle erstellen.
   • TABLE_ID ist der Name der neuen Tabelle.
   • TAG_KEY_1: der Namespace-Schlüsselname, den Sie als erstes Tag für die Tabelle festlegen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: der Kurzname für den Tag-Wert, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Führen Sie den Befehl bq mk --table mit dem Flag --add_tags aus:

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

Ersetzen Sie Folgendes:

• SCHEMA: Die Inline-Schemadefinition.
• TAG: das Tag, das Sie an die neue Tabelle anhängen. Mehrere Tags werden durch Kommas getrennt. Beispiel: 556741164180/env:prod,myProject/department:sales Jedes Tag muss den Parameter Kurzname des Namespace-Schlüssels und des Namespace haben.
• PROJECT_ID: die ID des Projekts, in dem Sie eine Tabelle erstellen.
• DATASET_ID: der Name des Datasets, in dem Sie eine Tabelle erstellen.
• TABLE_ID: Die ID der neuen Tabelle.

Terraform

Verwenden Sie die Ressource google_bigquery_table:

Richten Sie zur Authentifizierung bei BigQuery die Standardanmeldedaten für Anwendungen ein. Weitere Informationen finden Sie unter Authentifizierung für Clientbibliotheken einrichten.

Im folgenden Beispiel wird eine Tabelle mit dem Namen mytable erstellt und dann mit Tags versehen, indem das Feld resource_tags ausgefüllt wird:

# 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
  }
}

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Standardprojekt Cloud de Confiance fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

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

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance -Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

API

Rufen Sie die Methode tables.insert mit einer definierten Tabellenressource auf und fügen Sie die Tags in das Feld resource_tags ein.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt und klicken Sie dann auf Datasets.

4. Klicken Sie auf Übersicht > Tabellen und wählen Sie dann eine Tabelle aus.

5. Klicken Sie auf den Tab Details und dann auf mode_edit Details bearbeiten.

6. Maximieren Sie den Bereich Tags.

   1. So wenden Sie ein vorhandenes Tag an:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie Aktueller Bereich – Aktuelle Organisation auswählen oder Aktuelles Projekt auswählen aus.

         Alternativ können Sie auf Bereich auswählen klicken, um nach einer Ressource zu suchen oder eine Liste der aktuellen Ressourcen aufzurufen.

      2. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   2. So geben Sie ein neues Tag manuell ein:

      1. Klicken Sie auf den Drop-down-Pfeil neben Bereich auswählen und wählen Sie IDs manuell eingeben > Organisation, Projekt oder Tags aus.

      2. Wenn Sie ein Tag für Ihr Projekt oder Ihre Organisation erstellen, geben Sie im Dialogfeld die PROJECT_ID oder die ORGANIZATION_ID ein und klicken Sie dann auf Speichern.

      3. Wählen Sie für Schlüssel 1 und Wert 1 die entsprechenden Werte aus den Listen aus.

   3. Optional: Wenn Sie der Tabelle weitere Tags hinzufügen möchten, klicken Sie auf Tag hinzufügen und folgen Sie den vorherigen Schritten.

7. Klicken Sie auf Speichern.

SQL

Verwenden Sie die Anweisung ALTER TABLE SET OPTIONS.

Im folgenden Beispiel werden alle Tags für eine vorhandene Tabelle überschrieben.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, das die Tabelle enthält.
   • TABLE_ID: der Name der Tabelle, die Sie taggen.
   • TAG_KEY_1: der Namespace-Schlüsselname, den Sie als erstes Tag für die Tabelle festlegen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: der Kurzname für den Tag-Wert, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

Im folgenden Beispiel wird der Operator += verwendet, um einer Tabelle ein Tag zuzuweisen, ohne vorhandene Tags zu überschreiben. Wenn ein vorhandenes Tag denselben Schlüssel hat, wird es überschrieben.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, das die Tabelle enthält.
   • TABLE_ID: der Name der Tabelle, die Sie taggen.
   • TAG_KEY_1: der Namespace-Schlüsselname, den Sie als erstes Tag für die Tabelle festlegen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: der Kurzname für den Wert des Tags, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Führen Sie den Befehl bq update mit dem Flag --add_tags aus:

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

Ersetzen Sie Folgendes:

• TAG: das Tag, das Sie an die Tabelle anhängen. Mehrere Tags werden durch Kommas getrennt. Beispiel: 556741164180/env:prod,myProject/department:sales Jedes Tag muss den Parameter Kurzname des Namespace-Schlüssels und des Namespace haben.
• PROJECT_ID: Die ID des Projekts, das Ihre Tabelle enthält.
• DATASET_ID: die ID des Datasets, das Ihre Tabelle enthält.
• TABLE_ID: Die ID der Tabelle, die Sie aktualisieren.

gcloud

Zum Anhängen eines Tags an ein Dataset über die Befehlszeile erstellen Sie mit dem Befehl gcloud resource-manager tags bindings create eine Tag-Bindungsressource:

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

Ersetzen Sie Folgendes:

• TAG_VALUE_NAME: die permanente ID oder der Namespace-Name des Tag-Werts, der angehängt werden soll, z. B. tagValues/4567890123 oder 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: die vollständige ID des Datasets, einschließlich des API-Domainnamens (//bigquery.googleapis.com/), um den Ressourcentyp zu identifizieren, z. B. //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table
• LOCATION: der Standort Ihrer Tabelle.

Terraform

Fügen Sie dem Feld resource_tags der Tabelle Tags hinzu und wenden Sie dann die aktualisierte Konfiguration mit der Ressource google_bigquery_table an. Weitere Informationen finden Sie im Terraform-Beispiel unter Tags beim Erstellen einer neuen Tabelle anhängen.

API

Rufen Sie die Methode tables.update mit einer definierten Tabellenressource auf und fügen Sie die Tags in das Feld resource_tags ein.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt und klicken Sie dann auf Datasets.

4. Klicken Sie auf Übersicht > Tabellen und wählen Sie eine Tabelle aus.

   Die Tags werden auf dem Tab Details angezeigt.

bq

Verwenden Sie den Befehl bq show und suchen Sie nach der Spalte tags. Wenn die Tabelle keine Tags enthält, wird die Spalte tags nicht angezeigt.

bq show \
    PROJECT_ID:DATASET_ID.TABLE_ID

Ersetzen Sie Folgendes:

• PROJECT_ID: Die ID des Projekts, das Ihre Tabelle enthält.
• DATASET_ID: die ID des Datasets, das Ihre Tabelle enthält.
• TABLE_ID: Die ID Ihrer Tabelle

gcloud

Verwenden Sie den Befehl gcloud resource-manager tags bindings list, um eine Liste der Tag-Bindungen abzurufen, die an eine Ressource angehängt sind:

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

Ersetzen Sie Folgendes:

• RESOURCE_ID: die vollständige ID der Tabelle, einschließlich des API-Domainnamens (//bigquery.googleapis.com/), um den Ressourcentyp zu identifizieren, z. B. //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table

• LOCATION: der Standort Ihres Datasets

Die Ausgabe sieht etwa so aus:

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

Sie können die geerbten Tags nach BigQuery-Tabellen mit der gcloud resource-manager tags bindings list auflisten. Sie können auch die Option --filter für das Attribut namespacedTagValue verwenden, um Tags nach Projekt-ID, Tag-Wert oder Tag-Schlüssel zu filtern.

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

Ersetzen Sie Folgendes :

• PROJECT_ID: die ID des Projekts, das Ihr Dataset enthält.

• DATASET_ID: Die ID des Datasets.

• TAG_FILTER: Geben Sie einen Wert an, um nach übernommenen Tags zu filtern. Verwenden Sie dazu eine der folgenden Optionen:

  • Nach Tags nach Projekt-ID filtern. Beispiel: myproject.

  • Filtern Sie nach Tag-Werten, indem Sie die permanente ID oder den Namespace-Namen des Tag-Werts angeben. Beispiel: tagValues/4567890123 oder 1234567/my_tag_key/my_tag_value.

  • Filtern Sie nach Tag-Schlüsseln, indem Sie den Anzeigenamen für den Tag-Schlüssel angeben. Beispiel: tagkey

Terraform

Verwenden Sie den Befehl terraform state show, um die Attribute der Tabelle aufzulisten, einschließlich des Felds resource_tags. Führen Sie diesen Befehl in dem Verzeichnis aus, in dem die Terraform-Konfigurationsdatei der Tabelle ausgeführt wurde.

terraform state show google_bigquery_table.default

API

Rufen Sie die Methode tables.get mit einer definierten Tabellenressource auf und suchen Sie nach dem Feld resource_tags.

Aufrufe

Wählen Sie das Dropdown-Menü INFORMATION_SCHEMA.TABLE_OPTIONS Ansicht aus:

Die folgende Abfrage zeigt beispielsweise alle Tags, die allen Tabellen in einem Dataset zugewiesen sind. Diese Abfrage gibt eine Tabelle mit Spalten zurück, wie schema_name (der Dataset-Name), option_name (immer 'tags'), object_type (immer ARRAY<STRUCT<STRING, STRING>>) und option_value, das Arrays von STRUCT-Objekten enthält, die Tags darstellen, die mit jedem Dataset verknüpft sind. Für Tabellen ohne zugewiesene Tags gibt die Spalte option_value ein leeres Array zurück.

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

Ersetzen Sie DATASET_ID durch die ID des Datasets, das Ihre Tabelle enthält.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im linken Bereich auf explore Explorer:

   

3. Maximieren Sie im Bereich Explorer Ihr Projekt und klicken Sie dann auf Datasets.

4. Klicken Sie auf Übersicht > Tabellen und wählen Sie dann eine Tabelle aus.

5. Klicken Sie auf den Tab Details und dann auf mode_edit Details bearbeiten.

6. Klicken Sie im Bereich Tags neben dem Tag, das Sie löschen möchten, auf deleteElement löschen.

7. Klicken Sie auf Speichern.

SQL

Verwenden Sie die Anweisung ALTER TABLE SET OPTIONS.

Im folgenden Beispiel werden Tags mithilfe des Operators -= von einer Tabelle getrennt. Wenn Sie alle Tags aus einer Tabelle entfernen möchten, können Sie tags=NULL oder tags=[] angeben.

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

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

   Dabei gilt:

   • PROJECT_ID: Ihre Projekt-ID.
   • DATASET_ID: die ID des Datasets, das die Tabelle enthält.
   • TABLE_ID: der Name der Tabelle, aus der Sie die Tags entfernen.
   • TAG_KEY_1: der Namespace-Schlüsselname des ersten Tags, das Sie trennen möchten, z. B. 'my-project/env' oder '556741164180/department'.
   • TAG_VALUE_1: Der Kurzname des Werts für das Tag, das Sie trennen möchten, z. B. 'prod' oder 'sales'.
   • TAG_KEY_2: Der Namespace-Schlüsselname für das zweite Tag, das Sie trennen.
   • TAG_VALUE_2: Der Kurzname für den Wert des zweiten Tags, das Sie trennen.

3. Klicken Sie auf play_circle Ausführen.

Informationen zum Ausführen von Abfragen finden Sie unter Interaktive Abfrage ausführen.

bq

Verwenden Sie zum Entfernen einiger Tags aus einer Tabelle den Befehl bq update mit dem Flag --remove_tags:

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

Ersetzen Sie Folgendes:

• TAG_KEYS: die Tag-Schlüssel, die Sie aus der Tabelle trennen, durch Kommas getrennt. Beispiel: 556741164180/env,myProject/department Jeder Tag-Schlüssel muss den Namespace-Schlüsselnamen haben.
• PROJECT_ID: Die ID des Projekts, das Ihre Tabelle enthält.
• DATASET_ID: die ID des Datasets, das Ihre Tabelle enthält.
• TABLE_ID: Die ID der Tabelle, die Sie aktualisieren.

Verwenden Sie zum Entfernen aller Tags aus einer Tabelle den Befehl bq update mit dem Flag --clear_all_tags:

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

gcloud

Zum Entfernen einer Tag-Verknüpfung aus einer Tabelle über die Befehlszeile löschen Sie die Tag-Bindung mit dem Befehl gcloud resource-manager tags bindings delete:

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

Ersetzen Sie Folgendes:

• TAG_VALUE_NAME: die permanente ID oder der Namespace-Name des Tag-Werts, der angehängt werden soll, z. B. tagValues/4567890123 oder 1234567/my_tag_key/my_tag_value
• RESOURCE_ID: die vollständige ID der Tabelle, einschließlich des API-Domainnamens (//bigquery.googleapis.com/), um den Ressourcentyp zu identifizieren, z. B. //bigquery.googleapis.com/projects/my_project/datasets/my_dataset/tables/my_table
• LOCATION: der Standort Ihres Datasets

Terraform

Entfernen Sie Ihre Tags aus dem Feld resource_tags der Tabelle und wenden Sie dann die aktualisierte Konfiguration mit der Ressource google_bigquery_table an.

API

Rufen Sie die Methode tables.update mit einer definierten Tabellenressource auf und entfernen Sie die Tags im Feld resource_tags. Wenn Sie alle Tags entfernen möchten, entfernen Sie das Feld resource_tags.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im BigQuery-Navigationsmenü auf Governance und dann auf Sicherheitscenter.

3. Klicken Sie auf den Tab Data-Governance-Tags.

4. Klicken Sie auf Erstellen.

5. Geben Sie im Bereich Tag-Schlüssel erstellen die Details zum Tag-Schlüssel an:

   • Geben Sie im Feld Name der Tags für die Data Governance einen Namen für den Tag-Schlüssel ein.
   • Optional: Geben Sie im Feld Beschreibung eine Beschreibung für den Tag-Schlüssel ein.

6. Klicken Sie auf Erstellen.

gcloud

1. Zum Abrufen der aktuellen Richtlinie führen Sie den Befehl gcloud resource-manager tags keys create aus:

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

   Ersetzen Sie Folgendes:

   • TAG_KEY: Der Kurzname für den Tag-Schlüssel.
   • PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts angeben möchten, verwenden Sie organizations/ORGANIZATION_ID anstelle von projects/PROJECT_ID.

Terraform

Wenn Sie einen Tag-Schlüssel für Data Governance erstellen möchten, verwenden Sie die Ressource google_tags_tag_key im Anbieter google-beta und legen Sie das Argument purpose auf DATA_GOVERNANCE fest:

resource "google_tags_tag_key" "dg_key" {
  provider   = google-beta
  parent     = "projects/PROJECT_ID"
  short_name = "TAG_KEY"
  purpose    = "DATA_GOVERNANCE"
}

Ersetzen Sie Folgendes:

• TAG_KEY: Der Kurzname für den Tag-Schlüssel.
• PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts angeben möchten, verwenden Sie organizations/ORGANIZATION_ID anstelle von projects/PROJECT_ID.

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Cloud de Confiance -Standardprojekt fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

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

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

API

1. Senden Sie eine POST-Anfrage an den tagKeys-Endpunkt:

   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
   

   Ersetzen Sie Folgendes:

   • TAG_KEY: Der Kurzname für den Tag-Schlüssel.
   • PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts angeben möchten, verwenden Sie organizations/ORGANIZATION_ID anstelle von projects/PROJECT_ID.

Console

1. Rufen Sie in der Cloud de Confiance Console die Seite BigQuery auf.

   BigQuery aufrufen

2. Klicken Sie im BigQuery-Navigationsmenü auf Governance und dann auf Sicherheitscenter.

3. Klicken Sie auf den Tab Data-Governance-Tags.

4. Suchen Sie in der Liste der Tag-Schlüssel nach dem Tag-Schlüssel, dem Sie einen Wert hinzufügen möchten, klicken Sie auf more_vert Aktionen und dann auf Tag-Werte hinzufügen.

5. Geben Sie im Bereich Tag-Werte hinzufügen einen Kurznamen für den Tag-Wert ein.

6. Optional: Geben Sie im Feld Beschreibung eine Beschreibung ein.

7. Klicken Sie auf Speichern.

gcloud

1. Rufen Sie den Namen des Tag-Schlüssel-Namespaces ab, indem Sie den Befehl gcloud resource-manager tags keys list ausführen:

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

2. Erstellen Sie mit dem Befehl gcloud resource-manager tags values create einen neuen Wert:

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

   Ersetzen Sie Folgendes:

   • TAG_VALUE: Ein vom Nutzer angegebener Kurzname des Tag-Werts.
   • PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts angeben möchten, verwenden Sie stattdessen ORGANIZATION_ID.

Terraform

Verwenden Sie zum Erstellen eines Tag-Werts die Ressource google_tags_tag_value im google-beta-Anbieter:

resource "google_tags_tag_value" "dg_value" {
  provider   = google-beta
  parent     = "tagKeys/${google_tags_tag_key.dg_key.name}"
  short_name = "TAG_VALUE"
}

Ersetzen Sie Folgendes:

• TAG_VALUE: Ein vom Nutzer angegebener Kurzname des Tag-Werts.

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Standardprojekt Cloud de Confiance fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

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

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

API

1. Rufen Sie den Namen des Tag-Schlüssels mit Namespace ab:

   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'
   

   Die Antwort enthält das Feld name, z. B. tagKeys/4567890123.

2. Senden Sie eine POST-Anfrage an den tagValues-Endpunkt mit dem Namen des Tag-Schlüssels:

   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
   

   Ersetzen Sie Folgendes:

   • TAG_VALUE: ein vom Nutzer angegebener Kurzname des Tag-Werts.
   • PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts angeben möchten, verwenden Sie stattdessen Ihre ORGANIZATION_ID.
   • TAG_KEY_ID: der Namespace-Name für den Tag-Schlüssel aus Schritt 1. Wenn der Tag-Schlüsselname beispielsweise tagKeys/4567890123 lautet, ist die Tag-Schlüssel-ID 4567890123.

gcloud

Führen Sie den Befehl gcloud resource-manager tags values create aus und geben Sie im Flag --parent einen übergeordneten Tag-Wert an, um einen untergeordneten Tag-Wert zu erstellen:

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

Ersetzen Sie Folgendes:

• CHILD_TAG_VALUE: Der Kurzname für den untergeordneten Tag-Wert, den Sie erstellen.
• PROJECT_ID: die ID Ihres Projekts in Cloud de Confiance by S3NS . Wenn Sie eine Organisation anstelle eines Projekts angeben möchten, verwenden Sie stattdessen ORGANIZATION_ID.
• TAG_KEY: der Kurzname des Tag-Schlüssels, der dem Tag-Wert übergeordnet ist.
• PARENT_TAG_VALUE: der Kurzname des übergeordneten Tag-Werts.

API

Wenn Sie einen untergeordneten Tag-Wert erstellen möchten, verwenden Sie den Ressourcennamen des Tag-Werts des übergeordneten Elements (z. B. tagValues/123456789012) im Feld 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

Ersetzen Sie Folgendes:

• CHILD_TAG_VALUE: der Kurzname für den untergeordneten Tag-Wert, den Sie erstellen.
• PARENT_TAG_VALUE_ID: Die numerische ID des übergeordneten Tag-Werts.

SQL

Neue Tabelle mit einer getaggten Spalte erstellen

Verwenden Sie die Anweisung CREATE TABLE, um beim Erstellen einer Tabelle Data Governance-Tags anzuhängen. Geben Sie das Tag an, indem Sie die Option data_governance_tags für die Spalte festlegen.

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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID Ihres Projekts in Cloud de Confiance by S3NS . Wenn Sie eine Organisation anstelle eines Projekts als übergeordnetes Element Ihres Tags angeben möchten, verwenden Sie stattdessen Ihre ORGANIZATION_ID für das Tag-Schlüsselformat (ORGANIZATION_ID/TAG_KEY).
• DATASET_ID: die ID des Datasets, in dem sich die Tabelle befindet.
• TABLE_ID: Die ID der Tabelle, die Sie erstellen.
• COLUMN_NAME: Der Name der Spalte, die Sie taggen möchten.
• TAG_KEY: der Tag-Schlüssel, den Sie anwenden möchten.
• TAG_VALUE: der Tag-Wert, den Sie anwenden möchten.

Einer vorhandenen Tabelle ein Tag hinzufügen

Wenn Sie Data-Governance-Tags an eine Spalte in einer vorhandenen Tabelle anhängen möchten, verwenden Sie die Anweisung ALTER TABLE, um die Option data_governance_tags für die Spalte festzulegen.

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

bq-Befehlszeile

Neue Tabelle mit einer getaggten Spalte erstellen

1. Führen Sie den Befehl bq mk aus, um eine lokale JSON-Schemadatei zu erstellen, die das Tag definiert:

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

   Ersetzen Sie Folgendes:

   • PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts als übergeordnetes Element Ihres Tags angeben möchten, verwenden Sie ORGANIZATION_ID anstelle des Tag-Schlüsselformats (ORGANIZATION_ID/TAG_KEY).
   • DATASET_ID: die ID des Datasets, in dem sich die Tabelle befindet.
   • TABLE_ID: die ID der Tabelle, die Sie erstellen.

Tag zu einer vorhandenen Tabelle hinzufügen

1. Wenn Sie einer vorhandenen Tabelle ein Tag hinzufügen möchten, exportieren Sie zuerst das zugehörige Schema in eine lokale Datei:

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

2. Bearbeiten Sie die Schemadatei, um der Spalte das dataGovernanceTagsInfo-Objekt hinzuzufügen. Beispiel:

   [
     {
       "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. Aktualisieren Sie die Tabelle, um mit dem Befehl bq update Tags an die vertrauliche Spalte anzuhängen:

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

   Sie können auch den Befehl bq update verwenden, um vorhandene Tags zu entfernen und neue anzuhängen.

Terraform

Neue Tabelle mit einer getaggten Spalte erstellen

Wenn Sie beim Erstellen einer Tabelle Tags für die Datenverwaltung an eine Spalte anhängen möchten, verwenden Sie die Ressource google_bigquery_table im Anbieter google-beta. Legen Sie das dataGovernanceTagsInfo-Objekt in der Schemadefinition der Spalte fest.

Im folgenden Beispiel wird eine Tabelle erstellt und ein Data Governance-Tag an eine Spalte angehängt:

resource "google_bigquery_table" "table" {
  provider   = google-beta
  dataset_id = "DATASET_ID"
  table_id   = "TABLE_ID"
  schema     = <<EOF
[
{
"name": "COLUMN_NAME",
"type": "STRING",
"mode": "NULLABLE",
"dataGovernanceTagsInfo": {
  "dataGovernanceTags": {
    "PROJECT_ID/TAG_KEY": "TAG_VALUE"
  }
}
}
]
EOF
  deletion_protection = false
}

Ersetzen Sie Folgendes:

• DATASET_ID: die ID des Datasets, in dem sich die Tabelle befindet.
• TABLE_ID: die ID der Tabelle, die Sie erstellen.
• COLUMN_NAME: Der Name der Spalte, die Sie taggen möchten.
• PROJECT_ID: die ID Ihres Projekts in Cloud de Confiance by S3NS . Wenn Sie eine Organisation anstelle eines Projekts als übergeordnetes Element Ihres Tags angeben möchten, verwenden Sie stattdessen Ihre ORGANIZATION_ID für das Tag-Schlüsselformat (ORGANIZATION_ID/TAG_KEY).
• TAG_KEY: Der Kurzname für den Tag-Schlüssel.
• TAG_VALUE: der Kurzname des Tag-Werts, den Sie anhängen möchten.

Tag zu einer vorhandenen Tabelle hinzufügen

Wenn Sie einer Spalte in einer vorhandenen Tabelle Data Governance-Tags anfügen oder aktualisieren möchten, aktualisieren Sie das Schema der Spalte in der google_bigquery_table-Ressource, um das dataGovernanceTagsInfo-Objekt einzufügen oder zu ändern, und wenden Sie dann die aktualisierte Konfiguration an.

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Cloud de Confiance -Standardprojekt fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

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

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

API

Neue Tabelle mit einer getaggten Spalte erstellen

Verwenden Sie die Methode tables.insert. Fügen Sie das Feld dataGovernanceTagsInfo in den Anfragetext ein.

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

Einer vorhandenen Tabelle ein Tag hinzufügen

1. Rufen Sie die aktuelle Tabellenressource mit der Methode tables.get ab.

2. Ändern Sie die Tabellenressource, um das Feld dataGovernanceTagsInfo für die Zielspalte einzufügen.

3. Rufen Sie die Methode tables.update oder tables.patch mit der aktualisierten Tabellenressource auf.

Terraform

Wenn Sie eine Datenrichtlinie erstellen möchten, die auf ein Data Governance-Tag verweist, verwenden Sie die Ressource google_bigquery_datapolicyv2_data_policy im google-beta-Provider. Geben Sie den data_governance_tag-Block an, um die Richtlinie an einen Schlüssel und Wert für ein Data-Governance-Tag zu binden.

Datenrichtlinie mit einer vordefinierten SHA256-Maskierungsregel erstellen

Im folgenden Beispiel wird eine Datenmaskierungsrichtlinie erstellt, die eine vordefinierte SHA256-Maskierungsroutine verwendet:

resource "google_bigquery_datapolicyv2_data_policy" "mask_policy" {
  provider         = google-beta
  location         = "LOCATION"
  data_policy_type = "DATA_MASKING_POLICY"
  data_policy_id   = "POLICY_ID"
  data_masking_policy {
    predefined_expression = "SHA256"
  }
  data_governance_tag {
    key   = "PROJECT_ID/TAG_KEY"
    value = "TAG_VALUE"
  }
  grantees = [
    "principal://goog/subject/EMAIL_ADDRESS"
  ]
}

Ersetzen Sie Folgendes:

• LOCATION: Die Region, in der Sie die Datenrichtlinie erstellen. Weitere Informationen finden Sie unter Standorte.
• POLICY_ID: die ID für die Datenrichtlinie.
• PROJECT_ID: die ID Ihres Projekts in Cloud de Confiance by S3NS . Wenn Sie anstelle eines Projekts eine Organisation als übergeordnetes Element für Ihr Tag angeben möchten, verwenden Sie Ihre ORGANIZATION_ID anstelle des Formats key (ORGANIZATION_ID/TAG_KEY).
• TAG_KEY: Der Kurzname für den Tag-Schlüssel.
• TAG_VALUE: Der Kurzname des Tag-Werts.
• EMAIL_ADDRESS: die E-Mail-Adresse des Nutzers oder Dienstkontos, dem Zugriff gewährt werden soll.

Richtlinie für den Zugriff auf Rohdaten erstellen

Wenn Sie eine Richtlinie für den Zugriff auf Rohdaten erstellen möchten, legen Sie data_policy_type auf RAW_DATA_ACCESS_POLICY fest:

resource "google_bigquery_datapolicyv2_data_policy" "raw_policy" {
  provider         = google-beta
  location         = "LOCATION"
  data_policy_type = "RAW_DATA_ACCESS_POLICY"
  data_policy_id   = "POLICY_ID"
  data_governance_tag {
    key   = "PROJECT_ID/TAG_KEY"
    value = "TAG_VALUE"
  }
  grantees = [
    "principal://goog/subject/EMAIL_ADDRESS"
  ]
}

Führen Sie die Schritte in den folgenden Abschnitten aus, um Ihre Terraform-Konfiguration auf ein Cloud de Confiance -Projekt anzuwenden.

Cloud Shell vorbereiten

1. Rufen Sie Cloud Shell auf.

2. Legen Sie das Standardprojekt Cloud de Confiance fest, auf das Sie Ihre Terraform-Konfigurationen anwenden möchten.

   Sie müssen diesen Befehl nur einmal pro Projekt und in jedem beliebigen Verzeichnis ausführen.

   export GOOGLE_CLOUD_PROJECT=PROJECT_ID

   Umgebungsvariablen werden überschrieben, wenn Sie in der Terraform-Konfigurationsdatei explizite Werte festlegen.

Verzeichnis vorbereiten

Jede Terraform-Konfigurationsdatei muss ein eigenes Verzeichnis haben (auch als Stammmodul bezeichnet).

1. Erstellen Sie in Cloud Shell ein Verzeichnis und eine neue Datei in diesem Verzeichnis. Der Dateiname muss die Erweiterung .tf haben, z. B. main.tf. In dieser Anleitung wird die Datei als main.tf bezeichnet.

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

2. Wenn Sie einer Anleitung folgen, können Sie den Beispielcode in jedem Abschnitt oder Schritt kopieren.

   Kopieren Sie den Beispielcode in das neu erstellte main.tf.

   Kopieren Sie optional den Code aus GitHub. Dies wird empfohlen, wenn das Terraform-Snippet Teil einer End-to-End-Lösung ist.

3. Prüfen und ändern Sie die Beispielparameter, die auf Ihre Umgebung angewendet werden sollen.
4. Speichern Sie die Änderungen.
5. Initialisieren Sie Terraform. Dies ist nur einmal für jedes Verzeichnis erforderlich.

   terraform init

   Fügen Sie optional die Option -upgrade ein, um die neueste Google-Anbieterversion zu verwenden:

   terraform init -upgrade

Änderungen anwenden

1. Prüfen Sie die Konfiguration und prüfen Sie, ob die Ressourcen, die Terraform erstellen oder aktualisieren wird, Ihren Erwartungen entsprechen:

   terraform plan

   Korrigieren Sie die Konfiguration nach Bedarf.

2. Wenden Sie die Terraform-Konfiguration an. Führen Sie dazu den folgenden Befehl aus und geben Sie yes an der Eingabeaufforderung ein:

   terraform apply

   Warten Sie, bis Terraform die Meldung „Apply complete“ anzeigt.

3. Öffnen Sie Ihr Cloud de Confiance -Projekt, um die Ergebnisse aufzurufen. Rufen Sie in der Cloud de Confiance Console Ihre Ressourcen in der Benutzeroberfläche auf, um sicherzustellen, dass Terraform sie erstellt oder aktualisiert hat.

API

Erstellen Sie eine Datenrichtlinie, die eine vordefinierte SHA256-Maskierungsregel verwendet, oder eine Richtlinie für den Zugriff auf Rohdaten.

Datenrichtlinie mit einer vordefinierten SHA256-Maskierungsregel erstellen

Wenn Sie eine Datenrichtlinie mit einer vordefinierten SHA256-Maskierungsregel erstellen möchten, senden Sie eine POST-Anfrage an den Endpunkt 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

Ersetzen Sie Folgendes:

• PROJECT_ID: die ID Ihres Cloud de Confiance by S3NS-Projekts. Wenn Sie eine Organisation anstelle eines Projekts als übergeordnetes Element Ihres Tags angeben möchten, verwenden Sie Ihre ORGANIZATION_ID anstelle des dataGovernanceTag.key-Formats (ORGANIZATION_ID/TAG_KEY).
• LOCATION: die Region, in der Sie die Datenrichtlinie erstellen. Weitere Informationen finden Sie unter Standorte.
• EMAIL_ADDRESS: die E-Mail-Adresse des Nutzers, dem Zugriff gewährt werden soll.
• TAG_KEY: der Kurzname für den Tag-Schlüssel.
• TAG_VALUE: Ein vom Nutzer angegebener Kurzname des Tag-Werts.
• POLICY_ID: Die ID für die Datenrichtlinie.

Richtlinie für den Zugriff auf Rohdaten erstellen

Wenn Sie eine Richtlinie für den Zugriff auf Rohdaten erstellen möchten, setzen Sie dataPolicyType auf 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. Wenn Sie Nutzer hinzufügen möchten, indem Sie eine Richtlinie direkt aktualisieren, rufen Sie zuerst die aktuelle Richtlinie und ihr etag ab:

   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. Senden Sie eine PATCH-Anfrage mit der aktualisierten Liste der Empfänger und der etag aus dem vorherigen Schritt:

   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"
   

   Ersetzen Sie ETAG durch den etag-Wert, der von der GET-Anfrage im vorherigen Schritt zurückgegeben wurde.

   Alternativ können Sie die Methode addGrantees verwenden, um einer Richtlinie Nutzer hinzuzufügen:

   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. Verwenden Sie die Methode removeGrantees, um Nutzer aus einer Richtlinie zu entfernen:

   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

Senden Sie zum Löschen einer Datenrichtlinie eine DELETE-Anfrage an den Endpunkt 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

Wenn Sie Datenrichtlinien auflisten möchten, die auf einen Tag-Schlüssel verweisen, senden Sie eine GET-Anfrage mit dem Parameter filter an den Endpunkt dataPolicies:

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