Ansichten verwalten

In diesem Dokument wird beschrieben, wie Sie Ansichten in BigQuery verwalten können. Es gibt verschiedene Optionen:

• Ansicht kopieren
• Ansicht umbenennen
• Ansicht löschen

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.

Ansichten kopieren

Derzeit können Sie Ansichten nur mithilfe der Cloud Console kopieren.

Sie können Ansichten nicht mit dem bq-Befehlszeilentool, der REST API oder den Clientbibliotheken kopieren. Sie müssen daher die Ansicht im Ziel-Dataset neu erstellen. Sie können jedoch beim Neuerstellen der Ansicht das bq-Befehlszeilentool verwenden, um die SQL-Abfrage der Ansicht zu kopieren.

Erforderliche Berechtigungen

Zum Kopieren einer Ansicht in der Cloud Console benötigen Sie IAM-Berechtigungen für das Quell- und Ziel-Dataset.

• Für das Quell-Dataset benötigen Sie Folgendes:

  • bigquery.tables.get
  • bigquery.tables.getData (erforderlich, um auf die Tabellen zuzugreifen, auf die in der SQL-Abfrage der Ansicht verwiesen wird)

• Für das Ziel-Dataset benötigen Sie Folgendes:

  • bigquery.tables.create (kann eine Kopie der Ansicht im Ziel-Dataset erstellen)

Jede der folgenden vordefinierten IAM-Rollen enthält die Berechtigungen, die Sie zum Kopieren einer Ansicht benötigen:

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

Wenn Sie die Berechtigung bigquery.datasets.create haben, können Sie außerdem Ansichten in den von Ihnen erstellten Datasets löschen. Sie benötigen auch Zugriff auf das Ziel-Dataset, sofern Sie dieses nicht erstellt haben.

Hinweis: Zum Kopieren einer Ansicht sind keine bigquery.jobs.create-Berechtigungen notwendig. Die Cloud Console generiert beim Kopieren einer Datenansicht keinen Kopierjob.

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

Ansicht kopieren

So kopieren Sie eine Ansicht:

Console

1. Maximieren Sie im Bereich Explorer Ihr Projekt und das Dataset und wählen Sie dann die Ansicht aus.

2. Klicken Sie im Detailbereich auf Ansicht kopieren.

3. Gehen Sie im Dialogfeld Copy view (Ansicht kopieren) so vor:

   • Überprüfen Sie im Abschnitt Source (Quelle), ob Project name (Projektname), Dataset name (Dataset-Name) und Table name (Tabellenname) korrekt sind.

   • Gehen Sie im Abschnitt "Destination" (Ziel) so vor:

     • Bei Project name (Projektname) wählen Sie das Projekt aus, in das Sie die Ansicht kopieren möchten.
     • Bei Dataset name (Dataset-Name) wählen Sie das Dataset aus, in dem die kopierte Ansicht enthalten sein soll.
     • Geben Sie für Table name (Tabellenname) den Namen der Ansicht ein. Sie können die Ansicht umbenennen, indem Sie einen neuen Namen in das Feld eingeben. Wenn Sie einen neuen Namen eingeben, muss dieser den Benennungsregeln für Ansichten entsprechen.

     

   • Klicken Sie auf Kopieren.

bq

Das bq-Befehlszeilentool unterstützt das Kopieren von Ansichten nicht. Sie müssen daher die Ansicht im Ziel-Dataset neu erstellen. Sie können jedoch die Neuerstellung vereinfachen und dafür die SQL-Abfrage kopieren, mit der die Ansicht definiert wurde.

Geben Sie den Befehl bq show aus, um die SQL-Abfrage zu kopieren, die eine Ansicht definiert. Mit dem Flag --format kann die Ausgabe gesteuert werden. Wenn Sie Informationen zu einer Ansicht in einem anderen Projekt als Ihrem Standardprojekt abrufen, fügen Sie dem Dataset die Projekt-ID im folgenden Format hinzu: project_id:dataset. Zum Schreiben der Ansichtsattribute in eine Datei fügen Sie > path_to_file zum Befehl hinzu.

bq show \
--format=prettyjson \
project_id:dataset.view > path_to_file

Dabei gilt:

• project_id ist die Projekt-ID.
• dataset ist der Name des Datasets
• view ist der Name der Ansicht.
• path_to_file der Pfad zur Ausgabedatei auf Ihrem lokalen Rechner ist.

Beispiele:

Geben Sie den folgenden Befehl ein, um Informationen zu myview in mydataset aufzurufen. mydataset befindet sich in Ihrem Standardprojekt.

bq show --format=prettyjson mydataset.myview

Geben Sie den folgenden Befehl ein, um Informationen zu myview in mydataset aufzurufen. mydataset befindet sich in myotherproject, nicht in Ihrem Standardprojekt. Die Ansichtsattribute werden in eine lokale Datei geschrieben: /tmp/myview.json.

bq show \
--format=prettyjson \
myotherproject:mydataset.myview > /tmp/myview.json

API

Die REST API unterstützt das Kopieren von Ansichten nicht. Sie müssen daher die Ansicht im Ziel-Dataset neu erstellen. Informationen zum Erstellen einer Ansicht mithilfe der REST API finden Sie unter Ansicht erstellen.

Ansicht umbenennen

Derzeit können Sie eine Ansicht nur dann umbenennen, wenn Sie die Ansicht mit der Cloud Console kopieren. Eine Anleitung, wie Sie eine Ansicht beim Kopiervorgang umbenennen, finden Sie im Abschnitt Ansicht kopieren.

Sie können den Namen einer vorhandenen Ansicht nicht mit dem bq-Befehlszeilentool, der API oder den Clientbibliotheken ändern. Sie müssen dann die Ansicht mit dem neuen Namen neu erstellen.

Ansichten löschen

Ansichten können auf folgende Weise gelöscht werden:

• Cloud Console verwenden
• Mit dem Befehl bq rm des bq-Befehlszeilentools
• Durch Aufrufen der API-Methode tables.delete

Derzeit können Sie mit diesen Methoden immer nur eine Ansicht auf einmal löschen.

Wenn Ansichten nach Ablauf eines bestimmten Zeitraums automatisch gelöscht werden sollen, legen Sie dafür die standardmäßige Ablaufzeit auf Dataset-Ebene fest oder geben Sie die Ablaufzeit beim Erstellen der Ansicht an.

Wenn Sie eine autorisierte Ansicht löschen, kann es bis zu 24 Stunden dauern, bis die gelöschte Ansicht aus der autorisierten Ansicht der Liste des Quell-Datasets entfernt wird.

Achtung: Das Löschen einer Ansicht kann nicht rückgängig gemacht werden. Wenn Sie eine autorisierte Ansicht mit demselben Namen wie die gelöschte Ansicht neu erstellen, müssen Sie die neue Ansicht der Liste der autorisierten Ansichten des Quell-Datasets hinzufügen.

Erforderliche Berechtigungen

Zum Löschen einer Ansicht benötigen Sie die folgenden IAM-Berechtigungen:

• bigquery.tables.delete
• bigquery.tables.get

Jede der folgenden vordefinierten IAM-Rollen enthält die Berechtigungen, die Sie für das Löschen einer Tabelle benötigen:

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

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

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

Ansicht löschen

So löschen Sie eine Ansicht:

Console

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

   BigQuery aufrufen

2. Maximieren Sie im Bereich Explorer Ihr Projekt und das Dataset und wählen Sie dann die Ansicht aus.

3. Klicken Sie im Detailbereich auf Ansicht löschen.

4. Geben Sie "delete" in das Dialogfeld ein und klicken Sie zur Bestätigung auf Löschen.

SQL

Verwenden Sie die Anweisung DROP VIEW (Ansicht entfernen), um eine Ansicht zu löschen:

Sie können die SQL-Anweisung in der Cloud Console ausführen. Geben Sie die Anweisung auf der BigQuery-Seite in den Abfrageeditor ein.

BigQuery aufrufen

DROP VIEW mydataset.myview

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

bq

Verwenden Sie den Befehl bq rm mit dem Flag --table (oder dem Kürzel -t), um eine Ansicht zu löschen. Wenn Sie eine Ansicht mit dem bq-Befehlszeilentool entfernen, müssen Sie die Aktion bestätigen. Sie können das Flag --force (oder das Kürzel -f) zum Überspringen der Bestätigung verwenden.

Wenn sich die Ansicht in einem Dataset eines anderen Projekts als dem Standardprojekt befindet, fügen Sie dem Dataset-Namen die Projekt-ID im folgenden Format hinzu: project_id:dataset.

bq rm \
-f \
-t \
project_id:dataset.view

Dabei gilt:

• project_id ist die Projekt-ID.
• dataset ist der Name des Datasets, das die Tabelle enthält.
• view ist der Name der Ansicht, die gelöscht werden soll.

Beispiele:

Mit dem bq-Befehlszeilentool können Sie bq-Befehle ausführen.

Aktivieren Sie Cloud Shell in der Cloud Console.

Cloud Shell aktivieren

Geben Sie den folgenden Befehl ein, um myview aus mydataset zu löschen. mydataset befindet sich in Ihrem Standardprojekt.

bq rm -t mydataset.myview

Geben Sie den folgenden Befehl ein, um myview aus mydataset zu löschen. mydataset befindet sich nicht in Ihrem Standardprojekt, sondern in myotherproject.

bq rm -t myotherproject:mydataset.myview

Geben Sie den folgenden Befehl ein, um myview aus mydataset zu löschen. mydataset befindet sich in Ihrem Standardprojekt. Durch das Kürzel -f in diesem Befehl wird die Bestätigung übersprungen.

bq rm -f -t mydataset.myview

Hinweis: Sie können den Befehl bq ls dataset eingeben, um zu prüfen, ob eine Ansicht aus einem Dataset entfernt wurde.

API

Rufen Sie die API-Methode tables.delete auf und legen Sie die zu löschende Datenansicht mit dem Parameter tableId fest.

C#

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von C# in der BigQuery-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur BigQuery C# API.

Auf GitHub ansehen Feedback

using Google.Cloud.BigQuery.V2;
using System;

public class BigQueryDeleteTable
{
    public void DeleteTable(
        string projectId = "your-project-id",
        string datasetId = "your_dataset_id",
        string tableId = "your_table_id"
    )
    {
        BigQueryClient client = BigQueryClient.Create(projectId);
        client.DeleteTable(datasetId, tableId);
        Console.WriteLine($"Table {tableId} deleted.");
    }
}

Go

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von Go in der BigQuery-Kurzanleitung zur Verwendung von Clientbibliotheken. Weitere Angaben finden Sie in der Referenzdokumentation zur BigQuery Go API.

Auf GitHub ansehen Feedback

import (
	"context"
	"fmt"

	"cloud.google.com/go/bigquery"
)

// deleteTable demonstrates deletion of a BigQuery table.
func deleteTable(projectID, datasetID, tableID string) error {
	// projectID := "my-project-id"
	// datasetID := "mydataset"
	// tableID := "mytable"
	ctx := context.Background()
	client, err := bigquery.NewClient(ctx, projectID)
	if err != nil {
		return fmt.Errorf("bigquery.NewClient: %v", err)
	}
	defer client.Close()

	table := client.Dataset(datasetID).Table(tableID)
	if err := table.Delete(ctx); err != nil {
		return err
	}
	return nil
}

Java

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von Java in der BigQuery-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur BigQuery Java API.

Auf GitHub ansehen Feedback

TableId tableId = TableId.of(projectId, datasetName, tableName);
boolean deleted = bigquery.delete(tableId);
if (deleted) {
  // the table was deleted
} else {
  // the table was not found
}

Node.js

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von Node.js in der BigQuery-Kurzanleitung: Clientbibliotheken verwenden. Weitere Angaben finden Sie in der Referenzdokumentation zur BigQuery Node.js API.

Auf GitHub ansehen Feedback

// Import the Google Cloud client library
const {BigQuery} = require('@google-cloud/bigquery');
const bigquery = new BigQuery();

async function deleteTable() {
  // Deletes "my_table" from "my_dataset".

  /**
   * TODO(developer): Uncomment the following lines before running the sample.
   */
  // const datasetId = "my_dataset";
  // const tableId = "my_table";

  // Delete the table
  await bigquery
    .dataset(datasetId)
    .table(tableId)
    .delete();

  console.log(`Table ${tableId} deleted.`);
}

PHP

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von PHP in der BigQuery-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur BigQuery PHP API.

Auf GitHub ansehen Feedback

use Google\Cloud\BigQuery\BigQueryClient;

/** Uncomment and populate these variables in your code */
// $projectId = 'The Google project ID';
// $datasetId = 'The BigQuery dataset ID';
// $tableId = 'The BigQuery table ID';

$bigQuery = new BigQueryClient([
    'projectId' => $projectId,
]);
$dataset = $bigQuery->dataset($datasetId);
$table = $dataset->table($tableId);
$table->delete();
printf('Deleted table %s.%s' . PHP_EOL, $datasetId, $tableId);

Python

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von Python in der BigQuery-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur  Python API.

Auf GitHub ansehen Feedback

from google.cloud import bigquery

# Construct a BigQuery client object.
client = bigquery.Client()

# TODO(developer): Set table_id to the ID of the table to fetch.
# table_id = 'your-project.your_dataset.your_table'

# If the table does not exist, delete_table raises
# google.api_core.exceptions.NotFound unless not_found_ok is True.
client.delete_table(table_id, not_found_ok=True)  # Make an API request.
print("Deleted table '{}'.".format(table_id))

Ruby

Bevor Sie dieses Beispiel ausprobieren, folgen Sie den Schritten zur Einrichtung von Ruby in der BigQuery-Kurzanleitung: Clientbibliotheken verwenden. Weitere Informationen finden Sie in der Referenzdokumentation zur BigQuery Ruby API.

Auf GitHub ansehen Feedback

require "google/cloud/bigquery"

def delete_table dataset_id = "my_dataset_id", table_id = "my_table_id"
  bigquery = Google::Cloud::Bigquery.new
  dataset  = bigquery.dataset dataset_id
  table    = dataset.table table_id

  table.delete

  puts "Table #{table_id} deleted."
end

Sicherheit ansehen

Zugriff auf BigQuery-Ansichten steuern

Nächste Schritte

• Ansichten erstellen
• Autorisierte Ansichten erstellen
• Ansichten auflisten
• Metadaten zu Ansichten abrufen
• Ansichten aktualisieren