Labels löschen

So können Sie ein Label aus einem Dataset, einer Tabelle oder Ansicht löschen:

  • Google Cloud Console verwenden
  • DDL-Anweisungen von SQL verwenden
  • Den Befehl bq update des bq-Befehlszeilentools verwenden
  • Durch Aufrufen der API-Methoden datasets.patch und tables.patch
  • Mit den Clientbibliotheken

Hinweis

Erteilen Sie IAM-Rollen (Identity and Access Management), die Nutzern die erforderlichen Berechtigungen zum Ausführen der einzelnen Aufgaben in diesem Dokument geben. Die Berechtigungen, die zum Ausführen einer Aufgabe erforderlich sind (sofern zutreffend), werden im Abschnitt "Erforderliche Berechtigungen" der Aufgabe aufgelistet.

Dataset-Label löschen

In den folgenden Abschnitten werden die Berechtigungen und Schritte zum Löschen eines Dataset-Labels angegeben.

Erforderliche Berechtigungen

Zum Löschen eines Dataset-Labels benötigen Sie die folgenden IAM-Berechtigungen:

  • bigquery.datasets.get
  • bigquery.datasets.update

Jede der folgenden vordefinierten IAM-Rollen enthält die Berechtigungen, die Sie zum Löschen eines Dataset-Labels benötigen:

  • roles/bigquery.dataOwner
  • roles/bigquery.admin

Wenn Sie die Berechtigung bigquery.datasets.create haben, können Sie außerdem die Labels der von Ihnen erstellten Datasets löschen.

Weitere Informationen zu IAM-Rollen und Berechtigungen in BigQuery finden Sie unter Vordefinierte Rollen und Berechtigungen.

Dataset-Label löschen

Wählen Sie eine der folgenden Optionen, um ein Label aus einem Dataset zu löschen:

Console

  1. Wählen Sie das Dataset in der Google Cloud -Console aus.

  2. Klicken Sie auf der Seite "Dataset-Details" auf das Stiftsymbol rechts neben Labels.

    Stiftsymbol

  3. Gehen Sie im Dialogfeld Labels bearbeiten so vor:

    • Klicken Sie für jedes Label, das Sie löschen möchten, auf "Löschen" (X).
    • Um die Änderungen zu speichern, klicken Sie auf Aktualisieren.

SQL

Verwenden Sie die DDL-Anweisung ALTER SCHEMA SET OPTIONS, um die Labels für ein vorhandenes Dataset festzulegen. Durch das Festlegen von Labels werden alle vorhandenen Labels im Dataset überschrieben. Im folgenden Beispiel werden alle Labels im Dataset mydataset gelöscht:

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

    BigQuery aufrufen

  2. Geben Sie im Abfrageeditor die folgende Anweisung ein:

    ALTER SCHEMA mydataset
SET OPTIONS (labels = []);

  3. Klicken Sie auf Ausführen.

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

bq

Wenn Sie ein Dataset-Label löschen möchten, führen Sie den Befehl bq update mit dem Flag clear_label aus. Wiederholen Sie das Flag , um mehrere Labels zu löschen.

Wenn sich das Dataset in einem anderen Projekt als Ihrem Standardprojekt befindet, fügen Sie dem Dataset die Projekt-ID im Format project_id:dataset hinzu.

bq update \
--clear_label key \
project_id:dataset

Dabei gilt:

  • key ist der Schlüssel für ein zu löschendes Label.
  • project_id ist die Projekt-ID.
  • dataset ist das zu aktualisierende Dataset.

Beispiele:

Geben Sie den Befehl bq update mit dem Flag --clear_label ein, um das Label department:shipping aus mydataset zu löschen. mydataset befindet sich in Ihrem Standardprojekt.

    bq update --clear_label department mydataset

Geben Sie den Befehl bq update mit dem Flag --clear_label ein, um das Label department:shipping aus mydataset in myotherproject zu löschen.

    bq update --clear_label department myotherproject:mydataset

Zum Löschen mehrerer Labels aus einem Dataset wiederholen Sie das Flag clear_label und geben Sie die Schlüssel aller Labels an. So löschen Sie beispielsweise das Label department:shipping und die Labels cost_center:logistics aus mydataset in Ihrem Standardprojekt:

    bq update \
    --clear_label department \
    --clear_label cost_center \
    mydataset

Bei jedem dieser Beispiele sieht die Ausgabe so aus: 

Dataset 'myproject:mydataset' successfully updated.