Einführung in die Entwicklung in einem Arbeitsbereich

In diesem Dokument erfahren Sie mehr über das Konzept von Arbeitsbereichen in Dataform und ihre Funktionen.

In Dataform interagieren Sie mit Ihrem SQL-Workflow-Code in einem Entwicklungsarbeitsbereich. Ein Entwicklungsarbeitsbereich ist eine bearbeitbare Kopie eines Repositorys. In einem Arbeitsbereich können Sie den Inhalt des Repositories erstellen, bearbeiten oder löschen, ohne andere Nutzer zu beeinträchtigen, die am selben Repository arbeiten. Anschließend können Sie Ihre Änderungen committen und an das Repository pushen.

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 Entwicklungsbereichs

Ein Dataform-Entwicklungsarbeitsbereich besteht aus den folgenden Tabs:

Code
Enthält eine Entwicklungsumgebung, in der Sie Dateien untersuchen, Abfragen entwickeln, Ihre Änderungen versionieren und die Ausführung in BigQuery auslösen können.
Kompiliertes Diagramm
 Zeigt den in Ihrem Arbeitsbereich definierten kompilierten SQL-Workflow als interaktiven gerichteten azyklischen Graphen (Directed Acyclic Graph, DAG) an. Wenn es in Ihrem SQL-Workflow Kompilierungsfehler gibt, wird auf dem Tab anstelle des Diagramms eine Fehlermeldung angezeigt.
Ausführungen
Zeigt Protokolle aller im Arbeitsbereich ausgelösten Ausführungen an. Sie können sich auch Aktionen und deren Details für eine ausgewählte Ausführung ansehen. Weitere Informationen finden Sie unter Ausführungslogs überwachen.

Komponenten auf dem Tab „Code“

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

Bereich „Dateien“
Die Dateistruktur Ihres Arbeitsbereichs. Ihre Änderungen werden automatisch in der Dateistruktur gespeichert. Ausgewählte Dateien werden im Entwicklungsbereich in Tabs geöffnet. Im Feld Eingabe für die Suche können Sie anhand des Pfads nach Dateien oder Verzeichnissen in Ihrem Arbeitsbereich suchen.
Bereich „Versionsverwaltung“
Hier sehen Sie den Status der Versionskontrolle für Ihren Arbeitsbereich und die Versionskontrolloptionen.
Bereich „Entwicklung“
Zum Anzeigen geöffneter Dateien in Tabs. Ihre Änderungen an bearbeiteten Dateien werden automatisch gespeichert.
Schaltfläche „Ausführen“
Eine Vorschau der kompilierten SQL-Abfrage wird ausgeführt.
Schaltfläche „Formatieren“
Formatiert Ihren Dataform-Core- oder JavaScript-Code.
Status der Zusammenstellung
Hier sehen Sie den Kompilierungsstatus des Codes in Ihrem Arbeitsbereich.
Bereich „Metadaten“
Die Metadaten der aktuell bearbeiteten Datei.
Bereich „Kompilierte Abfragen“
Kompiliert die Abfragen in der aktuell bearbeiteten Datei in SQL. Wenn die Abfragekompilierung fehlschlägt, werden Kompilierungsfehler angezeigt. Wenn die Abfragekompilierung erfolgreich war, werden die kompilierten Abfragen angezeigt und durch Trockenläufe in BigQuery validiert. Wenn die Abfragevalidierung fehlschlägt, werden Validierungsfehler angezeigt. Wenn die Abfrage validiert wurde, wird angezeigt, wie viele Byte für die Ausführung der Abfragen in BigQuery benötigt würden.
Drop-down-Menü „Ausführung starten“
Hier werden Optionen zum Auslösen der Ausführung des gesamten Workflows in Ihrem Arbeitsbereich oder in den ausgewählten Elementen angezeigt.

Komponenten des Tabs „Kompiliertes Diagramm“

Auf dem Tab „Kompiliertes Diagramm“ wird ein interaktives Diagramm Ihres kompilierten SQL-Workflows angezeigt. Das Diagramm zeigt alle Aktionen in Ihrem SQL-Workflow und die Beziehungen zwischen ihnen.

Sie können heran- und herauszoomen und per Drag-and-drop durch das Diagramm navigieren.

Sie können den Graphen nach den folgenden Eigenschaften filtern:

  • Name
  • Tag
  • Geben Sie Folgendes ein:
    • Behauptung
    • Deklaration
    • Inkrementelle Tabelle
    • Materialisierte Ansicht
    • Vorgänge
    • Tabelle
    • Unbekannt
    • Ansehen

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

Wenn Sie auf eine Aktion im Diagramm klicken, werden die Details in den folgenden Bereichen angezeigt:

Bereich „Metadaten“
Der vollständige Name, der Typ, die Abhängigkeiten und die abhängigen Elemente der ausgewählten Aktion.
Bereich „Abfrage“
Die kompilierte SQL-Abfrage der ausgewählten Aktion.

Versionskontrolle in einem Arbeitsbereich

In einem Arbeitsbereich interagieren Sie über die Git-basierte Versionskontrolle mit dem Repository. Änderungen, die Sie an Dateien in Ihrem Arbeitsbereich vornehmen, sind zunächst lokale Änderungen, die Sie committen und dann in Ihr Repository pushen können, damit sie für alle Repository-Nutzer verfügbar sind.

Wenn Ihr Repository mit einem Remote-Git-Anbieter verbunden ist, werden Änderungen aus Ihrem Arbeitsbereich an Ihren Hauptentwicklungszweig gesendet. Sie wählen den Hauptzweig aus, wenn Sie Ihr Repository mit dem Remote-Git-Anbieter verbinden. In einem nicht verbundenen Dataform-Repository werden Änderungen an den Standard-Branch gepusht.

Sie können auch Änderungen aus dem Dataform-Repository oder dem Remote-Repository abrufen und mit lokalen Änderungen in Ihrem Entwicklungsbereich zusammenführen. Weitere Informationen zur Versionskontrolle in Dataform finden Sie unter Code mit der Versionskontrolle verwalten.

Nächste Schritte