Einführung in das Entwickeln in einem Arbeitsbereich

In diesem Dokument werden das Konzept von Arbeitsbereichen in Dataform und ihre Funktionen erläutert.

In Dataform interagieren Sie mit Ihrem SQL-Workflowcode in einem Entwicklungsarbeitsbereich. Ein Entwicklungsarbeitsbereich ist Ihre eigene bearbeitbare Kopie eines Repositorys. In einem Arbeitsbereich erstellen, bearbeiten oder löschen Sie den Inhalt des Repositorys, ohne dass sich dies auf andere Nutzer auswirkt, die am selben Repository arbeiten. Sie führen dann einen Commit für Ihre Änderungen durch und übertragen sie per Push in das Repository.

Sie können Ihren SQL-Workflow mit Dataform Core oder JavaScript entwickeln. Dataform kompiliert Ihren Code in Echtzeit in SQL-Abfragen.

In einem Entwicklungsarbeitsbereich können Sie die folgenden Aufgaben ausführen:

Komponenten eines Entwicklungsarbeitsbereichs

Ein Dataform-Entwicklungsarbeitsbereich besteht aus den folgenden Tabs:

Code
Umfasst eine Entwicklungsumgebung, in der Sie Dateien untersuchen, Abfragen entwickeln, die Versionsverwaltung Ihrer Änderungen steuern und die Ausführung in BigQuery auslösen können.
Kompilierte Grafik
Zeigt den kompilierten SQL-Workflow an, der in Ihrem Arbeitsbereich als interaktiver gerichteter azyklischer Graph (DAG) definiert ist. Wenn in Ihrem SQL-Workflow Kompilierungsfehler vorhanden sind, wird auf dem Tab anstelle des Diagramms eine Fehlermeldung angezeigt.
Ausführungen
Zeigt Logs aller Ausführungen an, die im Arbeitsbereich ausgelöst wurden. Sie können auch Aktionen und zugehörige Details für eine ausgewählte Ausführung ansehen. Weitere Informationen finden Sie unter Ausführungslogs für Arbeitsbereiche prüfen.

Komponenten des Tabs „Code“

Der Tab Code eines Entwicklungsarbeitsbereichs enthält die folgenden Komponenten, mit denen Sie SQL-Workflows entwickeln können:

Bereich „Dateien“
Zeigt die Dateistruktur Ihres Arbeitsbereichs an. Ihre Änderungen an der Dateistruktur werden automatisch gespeichert. Die ausgewählten Dateien werden in Tabs im Entwicklungsbereich geöffnet. Im Feld Suchbegriff eingeben können Sie anhand des Pfads nach Dateien oder Verzeichnissen in Ihrem Arbeitsbereich suchen.
Bereich „Versionsverwaltung“
Zeigt den Status der Versionsverwaltung Ihres Arbeitsbereichs und die Optionen zur Versionsverwaltung an.
Bereich „Entwicklung“
Zeigt geöffnete Dateien in Tabs an. Die Änderungen werden automatisch in den bearbeiteten Dateien gespeichert.
Schaltfläche „Ausführen“
Führt eine Vorschau der kompilierten SQL-Abfrage aus.
Schaltfläche „Format“
Formatiert Ihren Dataform-Core- oder JavaScript-Code
Kompilierungsstatus
Gibt den Kompilierungsstatus des Codes in Ihrem Arbeitsbereich an.
Metadatenbereich
Zeigt die Metadaten der aktuell bearbeiteten Datei an
Bereich mit kompilierten Abfragen
Kompiliert die Abfragen in der aktuell bearbeiteten Datei in SQL. Wenn die Abfragekompilierung fehlschlägt, werden Kompilierungsfehler angezeigt. Wenn die Abfragekompilierung erfolgreich ist, werden die kompilierten Abfragen angezeigt und in Probeläufen für BigQuery validiert. Wenn die Abfragevalidierung fehlschlägt, werden Validierungsfehler angezeigt. Wenn die Abfragevalidierung erfolgreich ist, wird angezeigt, wie viele Byte die Ausführung der Abfragen an BigQuery verwenden würde.
Drop-down-Menü „Ausführung starten“
Zeigt Optionen an, mit denen die Ausführung des gesamten Workflows im Arbeitsbereich oder in den ausgewählten Elementen ausgelöst werden kann.

Komponenten des Tabs für kompilierte Grafiken

Auf dem Tab „Kompilierte Grafik“ wird eine interaktive Grafik Ihres kompilierten SQL-Workflows angezeigt. Das Diagramm zeigt alle Aktionen in Ihrem SQL-Workflow und die Beziehungen zwischen diesen.

Sie können heran- und herauszoomen und mit der Maus in der Grafik navigieren.

Sie können das Diagramm nach den folgenden Eigenschaften filtern:

  • Name
  • Tag
  • Typ
    • Assertion
    • Deklaration
    • Inkrementelle Tabelle
    • Materialisierte Ansicht
    • Operations
    • Tabelle
    • Unbekannt
    • Ansehen

Sie können mehrere Filter gleichzeitig auswählen. Dataform wendet sie mit der Bedingung OR an.

Sie können auf eine Aktion in der Grafik klicken, um die zugehörigen Details in den folgenden Bereichen aufzurufen:

Metadatenbereich
Zeigt den vollständigen Namen, den Typ, die Abhängigkeiten und Abhängigkeiten der ausgewählten Aktion an.
Abfragebereich
Zeigt die kompilierte SQL-Abfrage der ausgewählten Aktion an.

Versionsverwaltung in einem Arbeitsbereich

In einem Arbeitsbereich interagieren Sie über die Git-basierte Versionsverwaltung mit dem Repository. Änderungen, die Sie an Dateien in Ihrem Arbeitsbereich vornehmen, beginnen als lokale Änderungen ohne Commit, für die Sie einen Commit durchführen und dann per Push in Ihr Repository übertragen werden, damit sie allen Repository-Nutzern zur Verfügung stehen.

Wenn Ihr Repository mit einem Remote-Git-Anbieter verbunden ist, übertragen Sie Änderungen aus Ihrem Arbeitsbereich in Ihren Hauptentwicklungszweig. Sie wählen den Hauptzweig aus, wenn Sie Ihr Repository mit dem Remote-Git-Anbieter verbinden. In einem nicht verbundenen Dataform-Repository übertragen Sie Änderungen in den Standardzweig.

Sie können auch alle Änderungen aus dem Dataform-Repository oder dem Remote-Repository abrufen und mit lokalen Änderungen in Ihrem Entwicklungsarbeitsbereich zusammenführen. Weitere Informationen zur Versionsverwaltung in Dataform finden Sie unter Versionsverwaltung Ihres Codes.

Nächste Schritte