Arbeitsbereiche erstellen und verwenden

In diesem Dokument erfahren Sie, wie Sie mit Arbeitsbereichen in BigQuery arbeiten. Dabei werden die folgenden Aufgaben behandelt:

  • Arbeitsbereiche erstellen
  • Arbeitsbereiche löschen
  • Mit Dateien in Arbeitsbereichen arbeiten
  • Versionskontrolle für Dateien in Arbeitsbereichen

Hinweise

Erstellen Sie ein BigQuery-Repository, falls noch nicht geschehen.

Erforderliche Rollen

Der Zugriff auf Workspaces wird durch Rollen bestimmt, die für das übergeordnete Repository gewährt wurden. Weitere Informationen finden Sie unter Erforderliche Rollen.

Arbeitsbereich erstellen

Die Erstellung von Arbeitsbereichen wird unterschiedlich behandelt, je nachdem, ob Sie ein BigQuery-Repository oder ein Drittanbieter-Repository verwenden.

Arbeitsbereich in einem BigQuery-Repository erstellen

So erstellen Sie einen neuen Arbeitsbereich in einem BigQuery-Repository:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, in dem Sie einen Arbeitsbereich erstellen möchten.

  4. Klicken Sie im Editor auf Arbeitsbereich hinzufügen.

  5. Geben Sie im Bereich Arbeitsbereich erstellen im Feld Workspace-ID eine eindeutige ID für den Arbeitsbereich ein.

    IDs dürfen nur Ziffern, Buchstaben, Bindestriche und Unterstriche enthalten.

  6. Klicken Sie auf Erstellen.

Arbeitsbereich in einem Drittanbieter-Repository erstellen

So erstellen Sie einen neuen Arbeitsbereich in einem Drittanbieter-Repository:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, in dem Sie einen Arbeitsbereich erstellen möchten.

  4. Klicken Sie im Editor auf Arbeitsbereich hinzufügen. Daraufhin wird der Bereich Arbeitsbereich erstellen geöffnet.

  5. Wählen Sie das Optionsfeld Vorhandener Remote-Branch oder Neuer Branch aus, je nachdem, ob Sie einen vorhandenen oder neuen Branch für den Arbeitsbereich verwenden möchten.

  6. Geben Sie den zu verwendenden Branch an:

    1. Wenn Sie das Optionsfeld Vorhandener Remote-Zweig ausgewählt haben, wählen Sie im Feld Remote-Zweig einen vorhandenen Zweig aus.

    2. Wenn Sie das Optionsfeld Neuer Branch ausgewählt haben, geben Sie in das Feld Workspace-ID einen Branch-Namen ein. Der im Repository des Drittanbieters erstellte Branch-Name entspricht der BigQuery-Arbeitsbereich-ID.

      IDs dürfen nur Ziffern, Buchstaben, Bindestriche und Unterstriche enthalten.

  7. Klicken Sie auf Erstellen.

Verzeichnis in einem Arbeitsbereich erstellen

So erstellen Sie ein Verzeichnis in einem Arbeitsbereich:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Klicken Sie auf die Option Hinzufügen.

  6. Klicken Sie auf Im Repository erstellen > Verzeichnis.

  7. Geben Sie im Feld Verzeichnispfad hinzufügen einen Verzeichnispfad ein.

  8. Klicken Sie auf Verzeichnis erstellen.

Mit Dateien in einem Arbeitsbereich arbeiten

Sie können neue Dateien in einem Arbeitsbereich erstellen oder vorhandene Dateien hochladen.

Sie können die folgenden Dateitypen in einem Repository erstellen oder hochladen:

Datei erstellen

So erstellen Sie eine Datei in einem Arbeitsbereich:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Führen Sie einen der folgenden Schritte aus:

    • Klicken Sie auf die Option Hinzufügen.
    • Wählen Sie ein vorhandenes Verzeichnis aus und klicken Sie auf die Option Aktionen.

  6. Klicken Sie auf Im Repository erstellen und dann auf die Art der Datei, die Sie erstellen möchten.

  7. Geben Sie im Feld Name einen Dateinamen ein.

  8. Optional: Geben Sie im Feld Übergeordnetes Verzeichnis den Verzeichnispfad ein, in dem die Datei erstellt werden soll.

  9. Klicken Sie auf Speichern.

Datei hochladen

So laden Sie eine Datei in einen Arbeitsbereich hoch:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Führen Sie einen der folgenden Schritte aus:

    • Klicken Sie auf die Option Hinzufügen.
    • Wählen Sie ein vorhandenes Verzeichnis aus und klicken Sie auf die Option Aktionen.

  6. Klicken Sie auf In Repository hochladen und dann auf den Dateityp, den Sie hochladen möchten.

  7. Führen Sie im Bereich „Upload“ einen der folgenden Schritte aus:

    • Klicken Sie im Feld Dateiupload auf Durchsuchen, wählen Sie eine Datei aus und klicken Sie dann auf Öffnen.
    • Geben Sie im Feld URL die URL der Datei ein.

  8. Optional: Geben Sie im Feld Übergeordnetes Verzeichnis den Verzeichnispfad ein, in dem die Datei erstellt werden soll.

  9. Klicken Sie auf Hochladen.

Dateien löschen

So löschen Sie eine Datei aus einem Arbeitsbereich:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Wählen Sie die Datei aus, die Sie löschen möchten, klicken Sie auf Aktionen und dann auf Löschen.

  6. Klicken Sie auf Löschen.

Versionsverwaltung für eine Datei verwenden

In diesem Abschnitt erfahren Sie, wie Sie mit der Versionskontrolle in BigQuery Dateien in Arbeitsbereichen im Blick behalten.

BigQuery verwendet Git, um jede Änderung an den Dateien in einem Repository zu verfolgen. In einem BigQuery-Repository interagieren Sie direkt mit dem Git-Repository. In einem verbundenen Repository interagieren Sie mit dem Standardzweig des Remote-Repositories, den Sie beim Verbinden des Repositories konfiguriert haben.

In BigQuery werden die Versionskontrolloptionen basierend auf dem Status der Änderungen in Ihrem Arbeitsbereich angezeigt. In BigQuery wird die Commit-Option beispielsweise nur angezeigt, wenn es in Ihrem Arbeitsbereich nicht committete lokale Änderungen gibt. Wenn die Dateien in Ihrem Arbeitsbereich eine exakte Kopie Ihres Standard- oder Standardzweigs sind, wird in BigQuery der Status Aktuell angezeigt.

In BigQuery werden die folgenden Versionskontrolloptionen angezeigt:

X Änderungen committen
Übernehmen Sie die X lokalen Änderungen in Ihrem Arbeitsbereich oder in den ausgewählten geänderten Dateien. In BigQuery werden die nicht bestätigten Änderungen angezeigt.
An Standardzweig übertragen
Übertragen Sie die Commits an Ihren Standardzweig. Diese Option ist in einem Repository verfügbar, wenn Sie keine nicht committeten Änderungen in Ihrem Arbeitsbereich haben und es Commits gibt, die nicht gepusht wurden.
Zu your-branch-name übertragen
Übertragen Sie die angewandten Änderungen per Push in your-branch-name. Diese Option ist in einem Repository verfügbar, das mit einem Git-Repository eines Drittanbieters verbunden ist, wenn Sie in Ihrem Arbeitsbereich keine nicht committeten Änderungen haben. Der Name des Remote-Zweigs im Repository des Drittanbieters stimmt mit der BigQuery-Arbeitsbereichs-ID überein.
Aus Standardzweig abrufen
Aktualisieren Sie Ihre Arbeitsbereiche mit den letzten Änderungen aus Ihrem Standardzweig. Diese Option ist in einem Repository verfügbar, wenn Sie in Ihrem Arbeitsbereich keine nicht bestätigten Änderungen haben.
Aus your-branch-name abrufen
Aktualisieren Sie Ihren Arbeitsbereich mit den letzten Änderungen von your-branch-name. Diese Option ist in einem Repository verfügbar, das mit einem Git-Repository eines Drittanbieters verbunden ist, wenn Sie in Ihrem Arbeitsbereich keine nicht committeten Änderungen haben. Der Name des Remote-Zweigs im Repository des Drittanbieters stimmt mit der BigQuery-Arbeitsbereichs-ID überein.
Letzten Commit wiederherstellen
Stellen Sie die Dateien in Ihrem Arbeitsbereich in den Zustand des letzten Commits wieder her.

Änderungen abrufen

Wenn Ihr Arbeitsbereich nicht mit Ihrem Repository synchronisiert ist, wird in BigQuery die Option Pull angezeigt.

So holen Sie Änderungen aus Ihrem Repository in Ihren Arbeitsbereich ab:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Führen Sie im Bereich „Arbeitsbereich“ die folgenden Schritte aus:

    1. Wenn Sie sich in einem BigQuery-Repository befinden, klicken Sie auf Aus Standard-Branch abrufen.

    2. Wenn Sie sich in einem Repository befinden, das mit einem Git-Repository eines Drittanbieters verbunden ist, gehen Sie so vor:

      1. Klicken Sie auf Aus Standardzweig abrufen, um aus dem Standardzweig des Drittanbieter-Repositories abzurufen.
      2. Klicken Sie auf Aus your-branch-name abrufen, um aus dem Zweig des Drittanbieter-Repositorys abzurufen, der dem aktuellen Arbeitsbereich entspricht.

Commit für Änderungen durchführen

Nachdem Sie eine Änderung in einem Arbeitsbereich vorgenommen haben, wird in BigQuery die Option Commit angezeigt. Sie können alle lokalen Änderungen oder ausgewählte Dateien festschreiben. Dateien, die Sie hinzugefügt oder geändert haben, sind im Arbeitsbereichsfenster durch einen blauen Punkt gekennzeichnet.

So übernehmen Sie Änderungen aus Ihrem Arbeitsbereich in Ihr Repository:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Klicken Sie im Bereich „Arbeitsbereich“ auf Änderungen für X übernehmen.

  6. Führen Sie im Bereich Commit für Änderungen ausführen die folgenden Schritte aus:

    1. Wählen Sie die geänderten Dateien aus, für die ein Commit durchgeführt werden soll.

      Wenn Sie keine Dateien auswählen, werden alle lokalen Änderungen in BigQuery committet. Sie können geänderte Dateien nach Dateistatus, Dateinamen und Pfad filtern.

    2. Geben Sie im Feld Commit-Nachricht hinzufügen eine Beschreibung für den Commit ein.

    3. Klicken Sie auf Alle Änderungen übernehmen oder X Änderungen übernehmen.

      Der Name der Schaltfläche hängt von der Auswahl der zu committenden Dateien ab.

Änderungen pushen

In BigQuery wird die Option Push angezeigt, nachdem Sie Änderungen übernommen haben.

So übertragen Sie Änderungen aus Ihrem Arbeitsbereich in Ihr Repository:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Gehen Sie im Bereich „Arbeitsbereich“ so vor:

    1. Wenn Sie sich in einem BigQuery-Repository befinden, klicken Sie auf Push to default branch (In den Standardbranch pushen).

    2. Wenn Sie sich in einem Repository befinden, das mit einem Git-Repository eines Drittanbieters verbunden ist, gehen Sie so vor:

      1. Klicken Sie auf An Standardzweig übertragen, um an den Standardzweig des Drittanbieter-Repositories zu übertragen.
      2. Klicken Sie auf Push to your-branch-name, um an den Branch des Drittanbieter-Repositorys zu pushen, der dem aktuellen Arbeitsbereich entspricht.

Änderungen ohne durchgeführten Commit zurücksetzen

So heben Sie nicht committete Änderungen auf:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Klicken Sie im Bereich „Arbeitsbereich“ auf der Schaltfläche „Versionskontrolle“ auf das Drop-down-Menü  und dann auf Zum letzten Commit zurückkehren.

Zusammenführungskonflikte beheben

Ein Zusammenführungskonflikt kann auftreten, wenn eine lokale Änderung in Ihrem Arbeitsbereich nicht mit einer Änderung kompatibel ist, die am Standard-Branch Ihres Repositorys vorgenommen wurde. Zusammenführungskonflikte treten in der Regel auf, wenn mehrere Nutzer gleichzeitig dieselbe Datei bearbeiten.

Normalerweise treten Zusammenführungskonflikte auf, wenn Sie aus einem Branch ziehen, nachdem ein anderer Nutzer eine in Konflikt stehende Änderung in denselben Branch gepusht hat. Sie müssen einen Zusammenführungskonflikt manuell lösen, indem Sie die betroffene Datei bearbeiten.

Das folgende Codebeispiel zeigt einen Zusammenführungskonflikt, der in einer SQL-Datei angezeigt wird:

    <<<<<<< HEAD
    SELECT 1 as CustomerOrders
    =======
    SELECT 1 as Orders
    >>>>>>> refs/heads/main

So lösen Sie einen Konflikt beim Zusammenführen:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Wählen Sie die betroffene Datei aus und bearbeiten Sie sie mit den gewünschten Änderungen.

  6. Änderungen übernehmen

  7. Optional: Änderungen per Push übertragen

Commit-Verlauf ansehen

So rufen Sie den Commit-Verlauf auf:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Maximieren Sie im Bereich Explorer den Ordner Repositories.

  3. Wählen Sie das Repository aus, das den Arbeitsbereich enthält, mit dem Sie arbeiten möchten.

  4. Suchen Sie im Editor nach dem Arbeitsbereich und klicken Sie auf Öffnen.

    Daraufhin wird der Bereich „Arbeitsbereich“ geöffnet:

    Im Bereich „Arbeitsbereich“

  5. Klicken Sie im Bereich „Arbeitsbereich“ auf der Schaltfläche „Versionskontrolle“ auf den Drop-down-Pfeil  und dann auf Commit-Verlauf ansehen.

Arbeitsbereich löschen

So löschen Sie einen Arbeitsbereich und seinen gesamten Inhalt:

  1. Öffnen Sie in der Google Cloud Console die Seite BigQuery.

    BigQuery aufrufen

  2. Klicken Sie im Bereich Explorer auf den Ordner Repositories.

  3. Wählen Sie im Bereich Git-Repositories den Arbeitsbereich aus, den Sie löschen möchten.

  4. Klicken Sie auf die Option Aktionen und dann auf Löschen.

  5. Klicken Sie auf Löschen.

Nächste Schritte