Was Weave prüft
Beschreibung
Abschnitt betitelt „Beschreibung“Weave liest die Konfiguration, die Ihr Projekt bereits gespeichert hat, sowie die Aufzeichnungen darüber, wie seine Workflows in den letzten 30 Tagen ausgeführt wurden, und meldet, was es findet: einen Schritt, dessen Umlage nichts umzulegen hat, einen Workflow, dessen gespeicherte Struktur denselben Schritt zweimal aufführt, einen Workflow, dessen letzte Ausführung fehlgeschlagen ist, einen Schritt, dessen Ausgabe weit weniger Zeilen enthält als üblich. Weave liest nur — nichts, was es meldet, ändert einen Schritt, und es führt Ihren Workflow nie aus.
Es ist kein KI-Modell beteiligt. Jede Prüfung ist eine feste Regel, und jeder Satz ist vorab formuliert, sodass ein Bericht nichts kostet, ganz gleich, wie oft Sie einen anfordern.
Drei Antworten, nicht zwei
Abschnitt betitelt „Drei Antworten, nicht zwei“Die meisten Prüfungen in PlaidCloud kennen zwei Antworten: Ihre Konfiguration ist in Ordnung, oder sie wird abgelehnt. Weave kennt eine dritte, und genau diese sollten Sie verstehen.
| Antwort | Bedeutung |
|---|---|
| Weave hat bemerkt … | Weave hat dies geprüft und ein Problem gefunden. |
| (keine Meldung) | Weave hat dies geprüft und nichts Fehlerhaftes gefunden. |
| Weave hat nicht geprüft … | Weave konnte dies überhaupt nicht beurteilen. |
Die dritte Antwort gibt es, weil Schweigen mehrdeutig ist. Wenn Sie einen Umlageschritt erstellen, lässt PlaidCloud Sie ihn speichern, bevor Sie seine Spaltenzuordnung ausgefüllt haben — Sie bauen ihn noch auf, und eine Ablehnung des Speicherns würde Sie bei der Arbeit aufhalten. Ein Monitor, der dieselbe leere Zuordnung liest, könnte den Schritt leicht als fehlerfrei melden. Er ist aber nicht fehlerfrei, sondern unfertig, und niemand hat ihn sich angesehen.
Deshalb sagt Weave das auch. Ein Schritt, den es nicht beurteilen konnte, wird mit Begründung als nicht geprüft gemeldet und nie so gezählt, sortiert oder eingefärbt, als hätte er die Prüfung bestanden.
Es gibt noch eine vierte Aussage, die Weave machen kann, und sie ist überhaupt keine Antwort zu Ihrem Schritt: Weave hat keine Regel für …. Das bedeutet, dass Weave für diese Art von Objekt keine Prüfung hat und es nie beurteilt hat. Anders als bei „nicht geprüft“ führt nichts, was Sie am Schritt ändern, zu einem Urteil, daher lohnt es sich, beides auseinanderzuhalten: Stellen Sie einen nicht geprüften Schritt fertig, beurteilt Weave ihn; ein Schritt, für den es keine Regel hat, bleibt unbeurteilt, egal wie sehr Sie ihn ändern.
So sieht ein Bericht aus
Abschnitt betitelt „So sieht ein Bericht aus“Ein Bericht beginnt mit einer Zusammenfassung, die ihre eigene Bezugsgröße nennt, damit Sie sehen, wie viel des Projekts er abdeckt:
Weave fully checked 3 of the 417 steps and workflows in "Cost Model", and found 1problem in the parts it could judge. 1 more it hasn't fully checked.Weave has no rule for 412 steps and 1 workflow it looked at, so they have not beenjudged either way.
Weave noticed the step "Spread Overheads": No driver split value column found. Onedriver column must have the role "Split Value".Weave hasn't checked the step "Regional Split" — its column mapping is empty.Wenn ein Projekt Tabellen enthält, die nach Zeitplan geschrieben werden oder für die ein Aktualitätsschwellenwert festgelegt ist, zählt die erste Zeile diese gesondert: Weave hat 31 der 36 Schritte und Workflows sowie 3 der 4 Tabellen, die aktuell gehalten werden sollen, in „Finance“ vollständig geprüft und in den Teilen, die es beurteilen konnte, 2 Probleme gefunden.
Der Bruch in der ersten Zeile ist beabsichtigt. Drei geprüfte und als fehlerfrei befundene Schritte sind nicht dasselbe wie ein fehlerfreies Projekt, und die Eröffnungszeile trägt ihren eigenen Maßstab mit sich, sodass sie nicht ohne ihn zitiert werden kann. „In den Teilen, die es beurteilen konnte“ steht aus demselben Grund dort: Wo etwas nur teilweise beurteilt wurde, lassen sich die gefundenen Probleme nicht den Schritten zuordnen, die die Zeile gerade als geprüft bezeichnet hat. Die zweite Zeile nennt, wofür Weave überhaupt keine Regel hat, und sagt ausdrücklich, dass diese in keiner Richtung beurteilt wurden — nicht, dass keine Prüfung nötig war.
Woher Weave das weiß
Abschnitt betitelt „Woher Weave das weiß“Unter jedem Befund steht ein Link Woher Weave das weiß, der einen Bereich öffnet, in dem zu sehen ist, wie Weave zu dem Befund gekommen ist:
- Die Prüfung — was die Regel testet, in einfachen Worten, mit den Grenzwerten, die sie verwendet, etwa wie viele frühere Ausführungen sie für den Vergleich einer Anzahl heranzieht.
- Der Nachweis — die Werte, die die Prüfung verwendet hat. Bei einer veränderten Zeilenanzahl sind das die letzte Anzahl, der Durchschnitt der früheren Ausführungen, wie stark die Anzahl von Ausführung zu Ausführung üblicherweise schwankt, und der Bereich, außerhalb dessen Weave sie meldet.
- Woher es stammt — die Ausführung, der Ausführungsverlauf, die gespeicherten Einstellungen des Schritts, das geplante Ereignis oder die Tabelle, aus der der Nachweis gelesen wurde. Ein als Link dargestellter Eintrag öffnet die Stelle, an der Sie ihn ansehen würden, etwa den Workflow oder den Tabellen-Explorer.
- Was Weave nicht geprüft hat — was die Regel auslässt. Dieser Abschnitt ist nie leer: Eine Prüfung, ob eine Tabelle rechtzeitig geschrieben wurde, betrachtet zum Beispiel nicht, was geschrieben wurde.
Bei einem Befund, den Weave nicht prüfen konnte, zeigt der Bereich die Prüfung und den Grund, warum sie nicht ausgeführt werden konnte, aber keinen Nachweis.
Der Bereich nennt nur, was Sie sehen dürfen. Ein Schritt, Workflow oder eine Tabelle, die Ihre Rolle ausblendet, wird als ein Objekt aufgeführt, das Sie nicht öffnen können, nie mit Namen, und wenn die letzte Ausführung eines Workflows in Schritten fehlgeschlagen ist, die Sie nicht öffnen können, zählt der Nachweis diese Schritte, statt sie zu benennen. Beim Aufbau des Bereichs ist keine KI beteiligt.
Der Bereich erscheint auf der Weave-Registerkarte und in einer Überprüfung. Auch die von KI verfasste Zusammenfassung einer Überprüfung hat einen solchen Bereich; er gibt an, dass sie von KI verfasst wurde, aus wie vielen Befunden, und was Weave geprüft hat, bevor sie angezeigt wurde. Bei einer Überprüfung, die ein KI-Assistent über PlaidCloud MCP ausführt, entfällt der Bereich.
Was Weave derzeit prüft
Abschnitt betitelt „Was Weave derzeit prüft“Spaltenzuordnung von Umlagen. Bei einem Schritt vom Typ Allocation with Dimension oder Allocation Split, dass es eine numerische Spalte zum Umlegen gibt, einen numerischen Treiberwert, nach dem umgelegt wird, eine Hierarchie, wo eine benötigt wird, und — bei einer Aufteilung — einen Zähler und einen Nenner, der eine Spalte nennt, die die Quelltabelle tatsächlich hat. Das sind dieselben Prüfungen, die beim Speichern des Schritts laufen, angewendet auf das bereits Gespeicherte. Beim Speichern wird außerdem die Zuordnungsdimension selbst geprüft — dass sie existiert und genau eine Treibereigenschaft hat —, was Weave nicht tut; ein Schritt, dessen Speichern aus diesem Grund abgelehnt wird, erzeugt also keinen Weave-Befund.
Ausdrücke in Schritten. Bei jedem Schritt, der Ausdrücke enthält, dass jeder Ausdruck, den Sie geschrieben haben — in einer Zielspalte, in der Subset-Klausel oder in der Secondary-Filter-Klausel —, noch kompiliert. Ein Befund nennt die Spalte oder Klausel, damit Sie wissen, welche Sie öffnen müssen, und gibt den Fehler an, etwa Syntax error at line 1, position 280. Der Ausdruck selbst steht unter Woher Weave das weiß, damit ein langer Ausdruck den Fehler nicht verdeckt. Das sind dieselben Prüfungen, die beim Speichern des Schritts laufen.
Zwei Fälle meldet Weave als nicht geprüft, statt sie zu beurteilen:
- Ein Ausdruck, der eine Variable liest. Ein Schritt kann zu mehr als einem Workflow gehören, und jeder Workflow kann eine Variable auf einen anderen Wert setzen — oder gar nicht. Die Prüfung beim Speichern weiß, aus welchem Workflow Sie speichern; ein Scan weiß das nicht. Statt einen Wert auszuwählen und zu riskieren, einen funktionierenden Ausdruck als fehlerhaft zu bezeichnen, meldet Weave den Schritt als nicht geprüft, wenn die Variable nicht überall gesetzt ist oder auf voneinander abweichende Werte gesetzt ist. Ein Workflow, den Ihre Rolle Ihnen nicht anzeigt, zählt genauso: Weave kann auch dessen Variablen nicht lesen und behauptet daher nicht, dass der Schritt übereinstimmt. Wo alle Workflows übereinstimmen, beurteilt es den Schritt normal.
- Filter und Spaltenlisten, die diese Prüfung nicht liest. Manche Schritttypen speichern einen Filter oder eine zweite Spaltenliste in einem Teil des Formulars, den die Ausdrucksprüfung nie gelesen hat — die Joins mit zwei Tabellen und Lookup, die Umlageaufteilungen, Generate Batch und SAP Post Journal Entry. Beim Speichern dieser Schritte wurden diese Felder schon immer übersprungen, daher lässt Weave den Schritt nicht anhand der Hälfte bestehen, die es lesen kann: Es meldet ihn als nicht geprüft. Mehrtabellen-Join- und Delete-Schritte werden ebenso gemeldet, weil ihre Konfiguration nicht in einer Form vorliegt, die diese Prüfung kompilieren kann.
Etwas ist in einem Workflow doppelt aufgeführt. Dass kein Schritt und kein verschachtelter Workflow mehr als einmal im selben Workflow vorkommt und dass keine zwei Ordner mit demselben übergeordneten Element dieselbe Kennung tragen.
Schritte, die ausgeführt werden können, bevor die Tabelle geschrieben ist, die sie lesen. In einem erweiterten Workflow, dass jeder Schritt, der eine Tabelle liest, über die Verbindungslinien auf der Arbeitsfläche nach dem Schritt im selben Workflow ausgeführt wird, der sie schreibt. Weave prüft dies unabhängig davon, ob der Workflow jemals ausgeführt wurde. Ein Befund nennt einen solchen Schritt und den Schritt, nach dem er ausgeführt werden sollte, und gibt an, wie viele Schritte betroffen sind; die Tabellen sind unter Woher Weave das weiß aufgeführt. Ein Schritt, den die Arbeitsfläche bereits zu früh ausführt, wird gesondert gemeldet. Weave meldet den Workflow als nicht geprüft, wenn ein Schritt einen anderen Workflow ausführt oder Tabellen verwendet, denen es nicht folgen kann, und beurteilt keine Tabelle, die auch von mehr als einem Schritt oder einem anderen Workflow geschrieben wird. Um die fehlenden Verbindungslinien zu prüfen und hinzuzufügen, verwenden Sie Abhängigkeiten synchronisieren auf der Arbeitsfläche. Wenn ein Schritt die Ausgabe der vorherigen Ausführung lesen soll, markieren Sie den Befund als erwartet.
Wie Ihre Workflows ausgeführt wurden. Weave liest die Ausführungen jedes Workflows aus den letzten 30 Tagen — bis zu den zwanzig jüngsten Ausführungen jedes Workflows — und beurteilt die letzte im Vergleich zu den vorangegangenen. Für die unten beschriebenen Vergleiche nach Monatsende und Wochentag liest es außerdem einige ältere Ausführungen aus den letzten 180 Tagen. Jeder Vergleich erfolgt mit dem eigenen Verlauf des Workflows, nie mit dem eines anderen Workflows.
-
Letzte Ausführung fehlgeschlagen. Ein Workflow, dessen jüngste Ausführung fehlgeschlagen ist, wird gemeldet, mit dem Datum des Fehlschlags und, falls auch die Ausführungen davor fehlgeschlagen sind, wie viele in Folge und seit wann.
-
Ausführung langsamer als üblich. Eine Ausführung, die abgeschlossen wurde, deren Schritte zusammen aber länger gedauert haben, als es die vorherigen abgeschlossenen Ausführungen des Workflows zulassen — mehr als zwei Standardabweichungen über deren Durchschnitt und mindestens 5 % darüber (nie weniger als eine Sekunde, damit ein schneller Workflow nicht wegen einiger Millisekunden gemeldet wird). Die Zeit ist die Summe der Schritte; bei einem Workflow, der Schritte parallel ausführt, ist sie also größer als die tatsächlich verstrichene Zeit. Eine Ausführung, die schneller abgeschlossen wurde, wird nicht gemeldet.
-
Schritt langsamer als üblich. Ein Schritt, der in seiner letzten abgeschlossenen Ausführung länger gedauert hat als in seinen früheren abgeschlossenen Ausführungen in diesem Workflow, nach demselben Maßstab wie bei einer langsamen Ausführung. So benennt Weave den Schritt hinter einer langsamen Ausführung. Ein Schritt in mehreren Workflows wird in jedem gesondert beurteilt. Die Zeit reicht vom Start bis zum Ende des Schritts: Weave trennt die eigentliche Arbeit des Schritts nicht von Wartezeit, etwa auf ein ausgelastetes Warehouse.
-
Ausführungen sind langsamer geworden. Eine Verlangsamung, die anhält. Sobald langsamere Ausführungen den Großteil der früheren Ausführungen ausmachen, mit denen eine Ausführung verglichen wird, wirkt eine langsame Ausführung nicht mehr ungewöhnlich, daher vergleicht diese Prüfung stattdessen Hälften. Weave liest die letzten 20 Ausführungen des Workflows aus den letzten 30 Tagen, behält die abgeschlossenen und teilt sie nach Startzeit in eine ältere und eine neuere Hälfte. Es meldet den Workflow, wenn die Medianzeit der neueren Hälfte mindestens 25 % und mindestens 30 Sekunden länger ist als die der älteren Hälfte und die neuere Ausführung in mindestens 85 % der Paarungen aus einer neueren und einer älteren Ausführung länger gedauert hat. Die Zeit ist die Summe der Schritte, wie bei einer langsamen Ausführung. Weave benötigt mindestens 12 abgeschlossene Ausführungen, verteilt über mindestens 14 Tage; ein Workflow, der in zwei Wochen mehr als etwa 20-mal ausgeführt wird, wird daher nicht geprüft. Fehlgeschlagene und beendete Ausführungen werden nicht gezählt; eine Ausführung, die nach einem fehlgeschlagenen Schritt weiterlief, schon. Der Befund nennt bis zu drei Schritte, die Sie öffnen können und deren Medianzeit am stärksten gestiegen ist, und sein Satz bleibt gleich, solange die Verlangsamung anhält, sodass Sie nicht nach jeder Ausführung erneut informiert werden.
-
Zielzeilen anders als bei früheren Ausführungen. Ein Schritt, dessen Ausgabetabellen nach seiner letzten Ausführung weit mehr oder weit weniger Zeilen enthielten als nach seinen vorherigen Ausführungen in diesem Workflow, nach demselben Maßstab (und um mindestens eine Zeile). Gezählt wird, was die Tabellen enthalten; ein Schritt, der anfügt, wird also anhand der wachsenden Gesamtzahl beurteilt. Ein Schritt in mehreren Workflows wird in jedem gesondert beurteilt.
-
Join hat mehr Zeilen dupliziert als üblich. Ein Inner, Left oder Right Join, der je Zeile seiner Haupttabelle mehr Zeilen geschrieben hat als nach seinen früheren Ausführungen in diesem Workflow — mehr als zwei Standardabweichungen über deren Durchschnitt und um mindestens 5 % davon. Die Haupttabelle ist Table A bei einem Inner oder Left Join und Table B bei einem Right Join. Mehr als eine geschriebene Zeile je Zeile der Haupttabelle bedeutet, dass einige ihrer Join-Schlüssel in mehr als einer Zeile der anderen Tabelle vorkommen, sodass die Zeilen mit diesen Schlüsseln mehr als einmal geschrieben wurden. Weave meldet nur einen Wert über 1,00, und nur wenn er über dem üblichen Niveau des Joins liegt; ein Join, der bewusst mehrere Zeilen je Zeile schreibt, wird also nur gemeldet, wenn diese Zahl steigt. Bei einem Inner Join werden nur Schlüssel erkannt, die sich in Table B wiederholen. Ein Join mit weniger als vier früheren Ausführungen, bei denen die Zeilen seiner Haupttabelle aufgezeichnet wurden, wird als nicht geprüft gemeldet.
Ein Join, der aggregiert oder Eindeutig, Slicing (Limit) oder einen Secondary Filter verwendet, wird als nicht geprüft gemeldet, weil jede dieser Optionen die Zeilenanzahl selbst verändert. Ebenso ein Join, dessen Haupttabelle keine aufgezeichnete Zeilenanzahl hat, etwa eine Ansicht. Die Zeilen der Haupttabelle sind die, die beim letzten Schreiben der Tabelle aufgezeichnet wurden, vor dem Filter des Schritts darauf. Ein Filter, der bei jeder Ausführung einen anderen Anteil ihrer Zeilen behält, verschiebt den Wert ebenfalls und kann gemeldet werden. Eine Änderung der Haupttabelle auf anderem Weg oder durch einen gleichzeitig laufenden Schritt wird nicht erkannt. Full Outer, Cross und Mehrtabellen-Joins werden nicht geprüft, und ein Lookup kann keine Zeile mehr als einmal schreiben.
-
Leere Werte anders als bei früheren Ausführungen. Eine Spalte der Ausgabetabelle eines Schritts, die in einem viel größeren oder kleineren Anteil ihrer Zeilen leer war als nach den vorherigen Ausführungen des Schritts — mehr als zwei Standardabweichungen vom üblichen Anteil entfernt und mindestens fünf Prozentpunkte davon abweichend. Jede Tabelle, die ein Schritt schreibt, wird anhand ihrer eigenen Zeilen beurteilt.
-
Import hat keine Dateien gefunden. Ein Importschritt, dessen jüngste abgeschlossene Ausführung unter dem Pfad, aus dem er liest, keine Dateien gefunden hat. Der Schritt endet mit einer Warnung statt mit einem Fehler und erstellt seine Zieltabelle leer oder lädt nichts, sodass die nachfolgenden Schritte nichts von ihm zu lesen haben. Der Befund nennt den Workflow und den Pfad, benötigt keine früheren Ausführungen und verschwindet, sobald eine Ausführung Dateien findet. Ein Schritt in mehreren Workflows wird in jedem gesondert beurteilt, und in einem Workflow, den Sie nicht öffnen können, wird der Pfad nicht angezeigt. Weave kann einen absichtlich leeren Ordner nicht von einer fehlenden Datei unterscheiden: Ist ein leerer Ordner dort normal, kann ein Architect des Projekts den Befund als erwartet markieren, und Weave meldet ihn für diesen Schritt in diesem Workflow nicht mehr, unabhängig vom Pfad. Eine Ausführung, die aufgezeichnet wurde, bevor es diese Prüfung gab, enthält den Wortlaut der Warnung nicht, daher wird ihr Schritt als nicht geprüft gemeldet, bis er erneut ausgeführt wird.
Monatsenden und Wochentage. Bei einem Workflow oder Schritt, der höchstens einmal täglich ausgeführt wird, wird eine Ausführung, die diese Prüfungen melden würden, ausgenommen, wenn sie mit mindestens vier früheren Ausführungen an der gleichen Art von Tag aus den letzten 180 Tagen übereinstimmt, die im Verhältnis zu ihrer Größe nicht stärker schwanken als seine früheren Ausführungen an anderen Tagen. Die Arten von Tagen sind der letzte Tag eines Monats, der erste Tag eines Monats und sonst derselbe Wochentag. Ein Monatsendlauf, der immer umfangreich ist, oder ein Ladevorgang, der montags immer geringer ausfällt, wird also nicht gemeldet, wenn diese Ausführungen im Verhältnis zu ihrer Größe stabiler sind als die an anderen Tagen. Der Kalender nimmt eine Ausführung immer nur aus: Er meldet nie eine, die diese Prüfungen bestehen würde. Tage werden in UTC gezählt, Feiertage und Arbeitstagskalender werden nicht berücksichtigt. Ein Workflow oder Schritt, der an einem Tag mehr als einmal ausgeführt wird, eine fehlgeschlagene Ausführung und ihre Wiederholung eingeschlossen, wird wie bisher mit seinen früheren Ausführungen verglichen.
Eine Vergleichsbasis benötigt mindestens vier vorherige Ausführungen. Bei weniger wird der Workflow für seine Ausführungszeit als nicht geprüft gemeldet und seine Schritte für ihre Zeilen und leeren Werte, jeweils mit der Angabe, wie viele abgeschlossene Ausführungen es gab, statt anhand zu weniger Daten beurteilt zu werden. Ein Schritt, der eine Tabelle schreibt, dessen aufgezeichnete Ausführungen aber keine Anzahlen leerer Werte enthalten, wird dafür ebenfalls als nicht geprüft gemeldet. Ein Schritt, der keine Tabelle schreibt, etwa einer, der eine E-Mail sendet oder eine Datei exportiert, wird nicht auf Zeilen oder leere Werte geprüft. Ein Workflow, der in den letzten 30 Tagen nicht ausgeführt wurde, wird als nicht geprüft gemeldet, ebenso einer, dessen Ausführungsverlauf nicht gelesen werden konnte — keiner von beiden wird als fehlerfrei gemeldet. In einem Projekt mit deklariertem Zeilenzugriff gelten die Prüfungen auf Zeilen, Joins, leere Werte und Werteverteilung nicht für Personen, deren Lesezugriffe gefiltert werden: Jede wird über die gesamte Tabelle gemessen, sodass ein Befund ihnen etwas über Zeilen außerhalb ihrer Berechtigung verraten würde. Siehe Zeilenanzahlen und Tabellengrößen.
Was die letzte Ausführung eines Schritts verändert hat. Für jede Tabelle, die die letzte Ausführung eines Schritts geschrieben hat, vergleicht Weave die Tabelle, wie die Ausführung sie hinterlassen hat, mit der Tabelle, wie sie vor dem Start der Ausführung war; es benötigt also keinen Verlauf früherer Ausführungen.
- Werteverteilung anders als vor der letzten Ausführung. Eine Spalte, deren Werte sich nach der Ausführung ganz anders über ihren Wertebereich verteilen als davor. Der Befund nennt einen Verschiebungswert: 0 bedeutet, dass sich die Verteilung nicht geändert hat, und 0,25 oder mehr ist eine große Änderung, ab der Weave sie meldet. Verglichen werden nur Spalten mit Dezimalzahlen. Spalten mit ganzen Zahlen sind meist Codes, Perioden oder Kennzeichen, etwa eine Kontonummer oder ein Monat, und ihre Verteilung ändert sich jedes Mal, wenn neue Perioden geladen werden. Leere Werte gehören nicht zur Verteilung; die oben beschriebene Prüfung auf leere Werte deckt sie ab.
„Vor der Ausführung“ ist die letzte Version der Tabelle, die Zeilen enthielt. Eine Version, die eine teilweise fehlgeschlagene Ausführung leer hinterlassen hat, wird übersprungen, sodass die erste erfolgreiche Ausführung nach einem Fehlschlag mit den letzten korrekten Daten verglichen wird.
Die Ausführung eines Schritts wird mit Begründung als nicht geprüft gemeldet, wenn eine Tabelle, die sie geschrieben hat:
- Zeilenzugriff auf ihren Spalten deklariert hat;
- vor oder nach der Ausführung mehr als 5.000.000 Zeilen enthielt;
- für den Vergleich länger als 10 Sekunden brauchte;
- ihre Version von vor der Ausführung nicht mehr vorhält — manche Lakehouses bewahren frühere Versionen einer Tabelle 7 Tage lang auf, sodass eine Tabelle, die seltener als wöchentlich neu geschrieben wird, keine Vergleichsbasis hat; oder
- durch diese Ausführung zum ersten Mal befüllt wurde.
Ein Projekt, dessen Lakehouse keinen Versionsverlauf vorhält, wird in dieser Prüfung überhaupt nicht beurteilt.
Durch eine Typkonvertierung leer gebliebene Werte. Jede Spalte, die ein
Extract-Schritt schreibt, hat einen Typ, etwa Text, Ganzzahl oder Datum, und der
Schritt konvertiert jeden Wert in diesen Typ. In einem StarRocks-Lakehouse wird ein
Wert, der nicht konvertiert werden kann, etwa N/A in einer Ganzzahlspalte, leer
gespeichert, und die Ausführung endet ohne Fehler. Nachdem ein Extract-Schritt in StarRocks ausgeführt wurde,
zählt Weave für jede Spalte, deren Konvertierung Werte verlieren könnte, die
eingehenden Werte, die nicht bereits leer waren, und wie viele davon leer
herauskamen, und meldet jede Spalte, bei der das der Fall war. Der Befund nennt die
Anzahl und den Typ der Spalte. Er beurteilt die jüngste abgeschlossene Ausführung
des Schritts in jedem Workflow und benötigt daher keine früheren Ausführungen.
- Werte, die beim Eingang bereits leer waren, werden nicht gezählt. Leerer Text hingegen schon, weil er in einer Zahlen- oder Datumsspalte leer gespeichert wird.
- Eine Spalte, deren Konvertierung keinen Wert verlieren kann, etwa ganze Zahlen in einer Dezimalspalte, wird nicht gezählt, ebenso wenig eine Spalte ohne leere Werte nach der Ausführung.
- Dauert die Zählung länger als 30 Sekunden oder stimmen die von Weave gezählten Zeilen nicht mit den vom Schritt geschriebenen Zeilen überein, wird die Ausführung als nicht geprüft gemeldet, und Weave zählt bei der nächsten Ausführung des Schritts erneut.
- Geprüft werden nur Extract-Schritte in StarRocks. Ein Schritt, der einen Secondary Filter verwendet oder nach einem Ausdruck gruppiert, wird als nicht geprüft gemeldet, ebenso einer, der Eindeutig oder Slicing (Limit) verwendet, wenn eine Spalte Werte verlieren könnte, weil Weave seine Zeilen ohne die Konvertierung nicht erneut zählen kann.
- Soll der Schritt diese Werte leer lassen, kann ein Architect des Projekts den Befund als erwartet markieren.
- Wie die Prüfungen auf Zeilen und leere Werte gilt sie nicht für Personen, deren Lesezugriffe durch Zeilenzugriff gefiltert werden.
Geplante Ereignisse. Bei einem Workflow mit geplanten Ereignissen vergleicht Weave jedes Ereignis mit den Ausführungen, die es gestartet hat, und mit dem Job im Cluster, der es auslöst. Jede Zeit wird in der Zeitzone des Ereignisses selbst betrachtet, und eine Auslösung wird 15 Minuten nach ihrer Fälligkeit beurteilt, damit ihr Job Zeit zum Starten hat.
- Zeitplan des geplanten Ereignisses ungültig. Ein aktiviertes Ereignis, dessen Zeitplan nicht gelesen werden kann.
- Geplante Ausführung nicht gestartet. Ein aktiviertes Ereignis, das fällig geworden ist, ohne eine Ausführung zu starten — seit es zuletzt eine gestartet hat, oder seit es gespeichert wurde, falls es nie eine gestartet hat. Wo der Cluster es feststellen kann, ergänzt Weave, ob der Cluster das Ereignis nie ausgelöst hat oder ob der ausgelöste Job fehlgeschlagen ist. Der Befund nennt die letzte Ausführung, die das Ereignis gestartet hat, oder den Zeitpunkt, zu dem es gespeichert wurde, sodass er ein einziger Befund bleibt, solange das Ereignis auf dieselbe Weise defekt ist. Ein Ereignis, das gespeichert wurde, nachdem seine Auslösung fällig war, wird für diese Auslösung nicht beurteilt.
- Geplantes Ereignis während einer Ausführung fällig. Ein Ereignis, das fällig wurde, während der Workflow noch lief, sodass zu diesem Zeitpunkt keine Ausführung gestartet wurde. Ein geplantes Ereignis startet nie eine zweite Ausführung eines Workflows, der bereits läuft; dies wird einmal gemeldet, damit ein Zeitplan, der enger getaktet ist als die Ausführungen des Workflows, nicht unbemerkt Auslösungen verliert.
- Geplantes Ereignis nicht synchron mit dem Cluster. Ein Ereignis und sein Job im Cluster, die nicht übereinstimmen: ein aktiviertes Ereignis ohne Job oder mit angehaltenem Job; ein deaktiviertes Ereignis, dessen Job nicht angehalten ist; oder ein Job mit einem anderen Zeitplan oder einer anderen Zeitzone, als das Ereignis anzeigt. Wo der Cluster nicht gelesen werden kann, wird der Workflow für seine geplanten Ereignisse als nicht geprüft gemeldet.
Ein Ereignis, das keine Ausführungen mehr startet, hat kein Ausführungsende, das Sie darauf hinweisen könnte, daher erscheint es auf der Weave-Registerkarte statt als Nachricht.
Nach Zeitplan geschriebene Tabellen. Bei einer Tabelle, die ein Workflow mit
einem aktivierten geplanten Ereignis schreibt, prüft Weave, ob die Tabelle seit der
letzten Fälligkeit des Zeitplans geschrieben wurde. Eine Tabelle gilt als
geschrieben, wenn ein Schritt, der sie schreibt, abgeschlossen ist. Weave betrachtet
die Daten der Tabelle nicht und erkennt daher kein Laden außerhalb der Schritte des
Projekts. Wie bei den Prüfungen geplanter Ereignisse wird jeder Zeitplan in der
Zeitzone seines Ereignisses gelesen und 15 Minuten nach seiner Fälligkeit
beurteilt. Weave prüft nur die Tabellen, die Ihre Rolle Sie sehen lässt; ohne die
Rolle analyze.table.read prüft es keine Tabellen, und seine erste Zeile zählt nur
Schritte und Workflows.
- Tabelle nicht planmäßig geschrieben. Eine Tabelle, die kein Schritt geschrieben hat, seit ein Workflow, der sie schreibt, laut Zeitplan fällig wurde. Ein Schreibvorgang durch einen beliebigen Schritt zählt, auch durch einen in einem anderen Workflow oder in einer Ausführung, die Sie selbst gestartet haben. Der Befund nennt den Zeitpunkt des letzten Schreibvorgangs statt der verstrichenen Zeit. Eine fehlgeschlagene Ausführung gilt als nicht geschrieben, daher werden die Tabellen eines fehlschlagenden geplanten Workflows hier und zusätzlich unter Letzte Ausführung fehlgeschlagen gemeldet.
Weave meldet eine Tabelle mit Begründung als nicht geprüft statt als nicht geschrieben, wenn:
- ein Workflow, der sie schreibt, gerade läuft, in der Warteschlange steht oder gerade abgeschlossen wurde und seine Ergebnisse noch nicht aufgezeichnet sind;
- ein Schritt, der sie schreibt, in einer Ausführung seit der Fälligkeit des Zeitplans übersprungen wurde, entweder aufgrund seiner eigenen Bedingungen oder weil er nichts zu tun fand, etwa ein Import, dessen Dateien sich nicht geändert hatten;
- ein Schritt, der sie schreibt, übersprungen werden kann, ohne dass das Überspringen aufgezeichnet wird: Er befindet sich in einem Standard-Workflow mit einer Bedingung, die zu einem anderen Schritt springt, oder in einem Workflow vom Typ Standard seriell mit einem Schritt, der bei einem Fehler zu einem anderen Schritt wechselt, oder er liegt in einem Container mit Bedingungen oder in einer Schleife, die möglicherweise null Mal durchlaufen wird;
- der Workflow seit der Fälligkeit eine Ausführung abgeschlossen hat, aber die Aufzeichnung des schreibenden Schritts aus dieser Ausführung fehlt;
- ein Schritt irgendwo im Projekt die Tabelle, die er schreibt, über eine Variable auswählt, deren Wert Weave nicht ermitteln kann, sodass er diese Tabelle schreiben könnte;
- der Zeitplan seltener als alle 180 Tage ausgeführt wird, so weit reicht der Ausführungsverlauf von Weave zurück; oder
- der Zeitplan eines Workflows ungültig ist oder der Ausführungsverlauf nicht gelesen werden kann.
Eine Tabelle wird überhaupt nicht geprüft, wenn:
- sie keinen Aktualitätsschwellenwert hat (siehe unten) und kein Workflow mit einem eigenen aktivierten geplanten Ereignis sie schreibt. Ein Workflow, den ein anderer Workflow über einen Schritt vom Typ Workflow ausführen oder Macro ausführt oder der in einen anderen Workflow eingefügt ist, zählt nur über seinen eigenen Zeitplan;
- die einzigen Schritte, die sie schreiben, deaktiviert sind, in einem deaktivierten Container liegen oder sich an oder nach einem Haltepunkt befinden; oder
- sie eine Ansicht ist.
Der zweite Punkt gilt nicht innerhalb einer Schleife, die ausgeführt wird: Eine Schleife führt jeden Schritt in ihr aus, auch einen, der deaktiviert ist, in einem deaktivierten Container liegt oder sich an oder nach einem Haltepunkt befindet.
Ein geplantes Ereignis, das nach seiner letzten Fälligkeit gespeichert wurde, wird erst beurteilt, wenn es erneut fällig wird.
Ein Workflow, dessen Ausführungen länger dauern als das Intervall seines Zeitplans, überspringt die Auslösungen, die fällig werden, während er läuft, sodass seine Tabellen zwischen den Ausführungen als nicht geschrieben gemeldet werden können; Geplantes Ereignis während einer Ausführung fällig meldet die Ursache.
Wenn der Schritt, der eine Tabelle zuletzt geschrieben hat, einer ist, auf den Sie keinen Zugriff haben, lautet der Befund „ein Schritt, auf den Sie keinen Zugriff haben“ und nennt trotzdem den Zeitpunkt des Schreibvorgangs. „180 Tage“ in einem Befund gibt an, wie weit der Ausführungsverlauf von Weave zurückreicht, und ist keine Aussage über die Tabelle.
Tabellen mit Aktualitätsschwellenwert. Ein Aktualitätsschwellenwert ist die maximale Anzahl an Stunden, die zwischen Schreibvorgängen einer Tabelle vergehen darf, von 1 bis 4.320 (180 Tage). Eine Tabelle mit Schwellenwert wird anhand dieses Werts beurteilt statt anhand der Zeitpläne der Workflows, die sie schreiben. So können Sie eine lockerere oder strengere Grenze festlegen, als ein Zeitplan vorgibt, und eine Tabelle prüfen, die kein geplanter Workflow schreibt. Wie bei Zeitplänen gilt eine Tabelle als geschrieben, wenn ein Schritt, der sie schreibt, abgeschlossen ist.
- Tabelle nicht innerhalb der festgelegten Zeit geschrieben. Kein Schritt hat die Tabelle länger als ihren Schwellenwert geschrieben. Der Befund nennt den Zeitpunkt des letzten Schreibvorgangs und den Schwellenwert.
Weave meldet eine Tabelle mit Schwellenwert mit Begründung als nicht geprüft statt als nicht geschrieben, wenn:
- ein Workflow, der sie schreibt, gerade läuft, in der Warteschlange steht oder gerade abgeschlossen wurde und seine Ergebnisse noch nicht aufgezeichnet sind;
- ein Workflow, der sie schreibt, nach Ablauf des Schwellenwerts eine Ausführung gestartet und abgeschlossen hat, aber die Aufzeichnung des schreibenden Schritts aus dieser Ausführung fehlt;
- ein Schritt irgendwo im Projekt die Tabelle, die er schreibt, über eine Variable auswählt, deren Wert Weave nicht ermitteln kann, sodass er diese Tabelle schreiben könnte;
- kein Schritt im Projekt sie schreibt, etwa bei einer Tabelle, die Sie von Hand laden, sodass Weave keinen Schreibvorgang als Bezugspunkt hat; oder
- der Ausführungsverlauf nicht gelesen werden kann.
Ein übersprungener Schritt macht eine Tabelle mit Schwellenwert nicht zu einer nicht geprüften: Die Tabelle wurde trotzdem länger als ihren Schwellenwert nicht geschrieben. Eine Ansicht kann keinen Schwellenwert haben, und wenn eine Tabelle zu einer Ansicht gemacht wird, wird ihr Schwellenwert entfernt. Eine Kopie einer Tabelle oder eine aus einem ihrer Snapshots erstellte Tabelle beginnt ohne Schwellenwert.
Um einen Schwellenwert festzulegen, wählen Sie die Tabelle in der Liste
Tabellen des Projekts aus und wählen Sie Tabellendetails anzeigen/bearbeiten.
Wählen Sie unter Aktualität die Option Warn if this table
isn’t written for more than aus, geben Sie die Anzahl der Stunden ein und klicken Sie auf Update.
Deaktivieren Sie das Kontrollkästchen, um den Schwellenwert zu entfernen. Solange
kein Schwellenwert festgelegt ist, nennt das Feld die geplanten Workflows, anhand
deren Zeitplänen die Tabelle beurteilt wird, oder gibt an, dass kein Workflow, den
Sie öffnen können, sie nach Zeitplan schreibt. Aktualität wird bei einer Ansicht, bei einer Tabelle,
die Sie gerade erstellen, oder ohne die Rolle analyze.workflow.read nicht angezeigt, und eine Änderung
erfordert analyze.table.write.
Sie können auch einen über PlaidCloud MCP verbundenen KI-Assistenten bitten, den
Aktualitätsschwellenwert der Tabelle festzulegen (sein Tool ist table_upsert, mit
freshness_max_age_hours), oder die Plattform-API aufrufen:
PUT /rest/v1/analyze/weave/freshness{"project_id": "<project>", "table_id": "<table>", "freshness_max_age_hours": 24}Senden Sie null anstelle der Zahl, um ihn zu entfernen; die Tabelle wird dann
wieder anhand der Zeitpläne ihrer Schreiber beurteilt. GET /rest/v1/analyze/weave/freshness?project_id=<project>&table_id=<table> gibt
den Schwellenwert und scheduled_writers zurück, die geplanten Workflows, anhand
deren Zeitplänen die Tabelle beurteilt wird, wenn sie keinen Schwellenwert hat. Das
Lesen eines Schwellenwerts erfordert die Rollen analyze.table.read und
analyze.workflow.read, das Festlegen erfordert analyze.table.write und
analyze.workflow.read. Sie können einen Schwellenwert nur für eine Tabelle
festlegen, die Ihre Rolle Sie sehen lässt, und nicht, solange das Projekt gesperrt ist.
Tabellen, die ein Workflow liest und die seitdem beschrieben wurden. Bei einem Workflow, der eine Tabelle liest, die ein anderer Workflow schreibt, prüft Weave, ob kein anderer Workflow die Tabelle beschrieben hat, seit der Workflow sie zuletzt gelesen hat. Eine Tabelle gilt als gelesen oder geschrieben durch einen Schritt, der sie als Eingabe oder Ausgabe nennt und in einer Ausführung abgeschlossen wurde. Weave liest, was der Ausführungsverlauf aufzeichnet, nicht die Daten der Tabelle.
- Liest eine seit dem letzten Lesen beschriebene Tabelle. Ein Workflow hat eine Tabelle zuletzt in einer seiner Ausführungen gelesen, und ein anderer Workflow hat diese Tabelle seitdem beschrieben, sodass seine Ergebnisse veraltet sein können. Der Befund nennt die Ausführung, die die Tabelle zuletzt gelesen hat, und die Workflows, die sie beschrieben haben. Ein Workflow mit einem aktivierten geplanten Ereignis oder einer, den ein anderer Workflow mit einem solchen Ereignis ausführt, wird erst gemeldet, wenn ein Zeitplan, der ihn ausführt, nach dem Schreibvorgang fällig geworden ist; ein Workflow, der von nichts nach Zeitplan ausgeführt wird, wird sofort gemeldet.
Folgendes zählt nicht als seitdem beschrieben:
- ein Schreibvorgang durch den Workflow selbst, einschließlich eines während seiner Ausführung durch einen Workflow, den er über einen Schritt vom Typ Workflow: Ausführen, Workflow: Schleife oder Workflow: Bedingte Ausführung ausführt;
- eine Tabelle, die der Workflow in einer Ausführung schreibt, bevor ein Schritt in dieser Ausführung sie liest, etwa eine Staging-Tabelle, es sei denn, der Schreibvorgang erfolgte durch einen Schritt vom Typ Tabelle: Anfügen oder Tabelle: Upsert oder durch einen Schritt vom Typ Tabelle: Direkt löschen mit Filter, die die übrigen Zeilen der Tabelle beibehalten; und
- ein Schreibvorgang, der erfolgte, bevor der Schritt, der ihn vorgenommen hat, zuletzt gespeichert wurde, da der Schritt damals in eine andere Tabelle geschrieben haben könnte.
Weave meldet den Workflow mit Begründung als nicht geprüft statt als veraltet, wenn:
- er gerade läuft oder gerade abgeschlossen wurde und seine Ergebnisse noch nicht aufgezeichnet sind;
- ein Schritt, der die Tabelle liest, in einer Ausführung nach dem Schreibvorgang übersprungen wurde;
- der Zeitplan, der ihn ausführt, ungültig ist;
- keine seiner letzten Ausführungen das Lesen der Tabelle abgeschlossen hat, während ein anderer Workflow sie beschrieben hat oder beschrieben haben könnte;
- ein Schritt, der die Tabelle liest, seit dem Start seiner letzten erfolgreichen Ausführung gespeichert wurde, sodass Weave nicht feststellen kann, ob diese Ausführung sie gelesen hat. Jedes Speichern zählt, auch eines, das nichts an dem ändert, was der Schritt liest;
- einer seiner Schritte Tabellen liest, die Weave nicht aus den Einstellungen des Schritts ermitteln kann, etwa ein KI: LLM-Schritt, ein Report-Schritt, ein Schritt vom Typ Ausführen: Remote-Python oder ein Schritt, der mehrere Tabellen liest und eine davon per Suche findet, wie es ein Schritt vom Typ Tabelle: Union Distinct oder Tabelle: Union All kann; eine Tabelle über eine Variable auswählt; eine Tabelle mit einem Namen bezeichnet, den mehr als eine Tabelle trägt; eine Ansicht liest; oder eine Tabelle in einem anderen Projekt liest;
- eine Tabelle, die er liest, auch durch ein Makro beschrieben wird, dessen Ausführungen Weave nicht sieht, oder durch einen Schritt in einem anderen Workflow, der seitdem ausgeführt wurde und die Tabelle, die er schreibt, über eine Variable auswählt, sie mit einem Namen bezeichnet, den mehr als eine Tabelle trägt, oder Tabellen schreibt, die Weave nicht ermitteln kann; oder
- sein Ausführungsverlauf nicht gelesen werden kann.
Ein Workflow ohne Ausführungen in den letzten 30 Tagen wird auf diese Weise nicht geprüft.
Was diese Prüfung nicht erkennt:
- Lese- und Schreibvorgänge, die älter sind als der Ausführungsverlauf, den Weave liest, also die letzten 30 Tage und für jeden Workflow seine letzten 20 Ausführungen;
- die Bedingung eines Schritts, die eine Tabelle prüft, was nicht als Lesen zählt;
- einen Schreibvorgang durch einen anderen Workflow in eine Tabelle, der der Workflow Zeilen hinzufügt und die er dann in derselben Ausführung liest, es sei denn, er fügt sie mit einem Schritt vom Typ Tabelle: Anfügen oder Tabelle: Upsert hinzu;
- ein früheres Lesen durch einen Schritt, wenn ein anderer Schritt des Workflows dieselbe Tabelle später gelesen hat;
- einen Schreibvorgang innerhalb eines Makros durch einen Schritt, der seine Tabelle über eine Variable auswählt oder Tabellen schreibt, die Weave nicht ermitteln kann; und
- Schreibvorgänge, die erfolgten, bevor der schreibende Schritt zuletzt gespeichert wurde, auch wenn das Speichern nichts an dem änderte, was er schreibt, bis sein Workflow erneut ausgeführt wird.
Ohne die Rolle analyze.table.read wird kein Workflow auf diese Weise geprüft. Wenn
ein Workflow oder eine Tabelle, die geschrieben oder gelesen wurde, eines der
Objekte ist, auf die Sie keinen Zugriff haben, lautet der Befund „ein Workflow, auf
den Sie keinen Zugriff haben“ oder „eine Tabelle, auf die Sie keinen Zugriff
haben“, ohne Angabe, wie viele.
Ein Schritt, für dessen Typ Weave keine Regel hat, wird als nicht abgedeckt gemeldet, nicht als fehlerfrei.
Tabellen, die auf einer fehlgeschlagenen Ausführung beruhen. Wenn die letzte Ausführung eines Workflows fehlgeschlagen ist, bevor ein Schritt, der eine Tabelle schreibt, abgeschlossen war, enthält diese Tabelle noch ihre früheren Daten oder nur einen Teil der neuen Daten. Weave verfolgt die Tabelle durch die Schritte, die sie lesen, und die Tabellen, die diese schreiben, über alle Workflows des Projekts hinweg und meldet, was darauf beruht:
- Liest eine Tabelle, die eine fehlgeschlagene Ausführung nicht fertiggestellt hat. Ein Workflow liest die Tabelle oder eine daraus aufgebaute Tabelle, egal wie viele Schritte weiter. Der Befund nennt die Tabelle, die er liest, die Tabelle, die die fehlgeschlagene Ausführung nicht fertiggestellt hat, und den Workflow, der fehlgeschlagen ist, mit dem Startzeitpunkt dieser Ausführung.
- Zeigt eine Tabelle, die eine fehlgeschlagene Ausführung nicht fertiggestellt hat. Ein Dashboard hat ein Diagramm auf einer veröffentlichten Tabelle, die diese Tabelle ist oder aus ihr aufgebaut wurde, oder auf einem SQL-Dataset, das eine solche Tabelle liest. Weave liest die Vorlagenlogik eines SQL-Datasets mit entfernten Tags, sodass auch eine Tabelle in einem Zweig, der nie durchlaufen wird, zählen kann. Der Befund betrifft das Dashboard und wird auf der Registerkarte Weave jedes Projekts aufgeführt, dessen Tabellen seine Diagramme zeigen.
Weave hat beim Dashboard „Board Pack“ bemerkt: Es zeigt die Tabelle „Margin“, aufgebaut aus der Tabelle „Sales“, deren Schreiben der Workflow „Import Sales“ in seiner letzten Ausführung am 27. Okt. 09:15 UTC nicht abgeschlossen hat, sodass seine Diagramme alte oder unvollständige Daten zeigen können
Jeder fehlgeschlagene Workflow ist ein eigener Befund, und er verschwindet, sobald die letzte Ausführung dieses Workflows nicht mehr fehlschlägt. Der fehlgeschlagene Workflow wird hier nicht über seine eigene Ausführung informiert; das deckt sein Befund Letzte Ausführung fehlgeschlagen ab.
Folgendes zählt nicht als Tabelle, die die fehlgeschlagene Ausführung nicht fertiggestellt hat:
- eine Tabelle, deren Schritt absichtlich übersprungen wurde, etwa ein Schritt, dessen Bedingung nicht erfüllt war, ein deaktivierter Schritt oder ein Import, der eine bereits geladene Datei übersprungen hat;
- eine Tabelle, deren Schritt eine Ausführung möglicherweise übergeht. In einem Workflow, der nicht erweitert ist, gilt das bei einem Sprung (goto) einer Bedingung oder einem Sprung eines fehlschlagenden Schritts in einem seriellen Workflow für jeden Schritt. In einem erweiterten Workflow gilt es für einen Schritt in oder nach einem Ausführungscontainer, der Bedingungen prüft, sowie für einen Schritt in einer Schleife;
- eine Tabelle, die ein anderer Workflow nach dem Start der fehlgeschlagenen Ausführung vollständig ersetzt hat, statt ihr Zeilen hinzuzufügen; und
- für einen Workflow eine Tabelle, die er in seiner letzten Ausführung, die sie gelesen hat, selbst ersetzt hat, bevor er sie gelesen hat.
Ein Workflow, der gerade läuft, wird erst nach dem Ende seiner Ausführung beurteilt. Wenn der Ausführungsverlauf nicht gelesen werden kann, meldet Weave diese Fälle als nicht geprüft statt als fehlerfrei.
Was diese Prüfung nicht erkennt:
- eine Ausführung, die endete, ohne dass ein Schritt einen Fehlschlag aufgezeichnet hat, etwa eine, deren Server angehalten wurde, sowie eine Ausführung, die jemand beendet hat;
- eine Tabelle, die ein Schritt über eine Variable auswählt, mit einem Namen bezeichnet, den mehr als eine Tabelle trägt, über eine Ansicht liest oder aus einem anderen Projekt liest;
- ein Dashboard-Diagramm auf einer gespeicherten Abfrage oder auf einem SQL-Dataset, dessen SQL Weave nach dem Entfernen der Vorlagenlogik nicht lesen kann;
- eine Tabelle, deren Namen eine Vorlage erzeugt;
- eine Tabelle, die ein SQL-Dataset ohne Schema nennt, es sei denn, das eigene Schema des Datasets ist das Berichtsschema des Projekts;
- jedes SQL-Dataset in einem Projekt auf einem Snowflake- oder Databricks-Warehouse;
- eine Tabelle, die nicht veröffentlicht ist, sowie Panel-Apps; und
- Ausführungen, die älter sind als der Ausführungsverlauf, den Weave liest, also die letzten 30 Tage und für jeden Workflow seine letzten 20 Ausführungen.
Den Befund eines Dashboards sehen Sie nur bei einem Dashboard, das Sie öffnen
können. Ohne die Rolle analyze.table.read läuft keine der beiden Prüfungen.
Ungewöhnliche Kennzahlensummen. Jeden Tag liest Weave die Kennzahlen Ihres Projekts und meldet eine, deren letzte abgeschlossene Periode weit vom Üblichen abweicht, und nennt das Element, etwa einen Kunden oder ein Werk, hinter der Änderung. Siehe Ungewöhnliche Kennzahlensummen.
Einen einzelnen Workflow überprüfen
Abschnitt betitelt „Einen einzelnen Workflow überprüfen“Eine Überprüfung kontrolliert einen Workflow, bevor Sie sich auf ihn verlassen. Sie führt die Prüfungen von Weave für den Workflow und seine Schritte aus, einschließlich der Schritte jedes Workflows, den er ausführt, sowie drei weitere, die Weave nur in einer Überprüfung ausführt, weil sie mehr lesen, als sich die Weave-Registerkarte bei jedem Öffnen leisten kann:
- Eine Umlage, die ihre eigenen Eingaben speist. Für jeden Umlageschritt, den der Workflow ausführt, ob das, was er schreibt, zurückfließt — über beliebige Schritte, in beliebigen Workflows — in die Tabelle, die er umlegt, oder in seine Treibertabelle. Ist das der Fall, hängt es davon, was er bei einer früheren Ausführung umgelegt hat, ab, wie viel der Schritt umlegt oder wie er es verteilt. Weave nennt die Schritte, durch die der Kreislauf läuft, und bittet Sie zu prüfen, ob der Kreislauf beabsichtigt ist. Ein Kreislauf, der durch keinen Umlageschritt läuft, etwa ein inkrementelles Laden, das die Tabelle liest, an die es anfügt, wird nicht gemeldet.
- Treibertabellen und -spalten von Umlagen. Ob die Treibertabelle, die ein Umlageschritt verwendet, existiert und jede Spalte enthält, die der Schritt daraus liest. Nach einer Treiberspalte, die der Schritt mit einer Konstanten oder einem Ausdruck füllt, wird nicht gesucht. Eine an anderer Stelle aufgebaute Treibertabelle wird in ihrem aktuellen Zustand geprüft; wenn ein Schritt in diesem Workflow sie aufbaut, sind ihre Spalten erst bekannt, wenn dieser Schritt ausgeführt wird, daher meldet Weave die Umlage als nicht geprüft statt als bestanden. Ebenso meldet es die Umlage als nicht geprüft, wenn der Schritt seine Treibertabelle über eine Variable oder einen Ordnerpfad auswählt, wenn der Workflow ein Makro ist und wenn Ihre Rolle die Tabelle nicht sehen kann.
- Sicherheit auf Zeilenebene bei einer umbenannten Spalte. Für jede Tabelle, die der Workflow schreibt, ob sie eine Spalte hat, die mit der Dimension gekennzeichnet ist, die ein Attribut der Sicherheit auf Zeilenebene verwendet, aber nicht nach diesem Attribut benannt ist. Die Sicherheit auf Zeilenebene filtert nur nach Spalten, die nach ihren Attributen benannt sind, und filtert daher nicht nach dieser Spalte. Diese Prüfung erfordert die Rolle Architect im Projekt; für alle anderen gibt die Überprüfung an, dass sie nicht geprüft wurde, ebenso bei einer Tabelle, die der Workflow über eine Variable oder einen Ordnerpfad benennt.
Eine Überprüfung beginnt mit der Angabe, was sie gefunden hat und über welchen Anteil des Workflows, und endet nie mit einer Unbedenklichkeitsbescheinigung:
Weave found 2 problems in the workflow "Q3 Close". It couldn't finish checking 1of its 8 steps (listed below), so it may have missed problems in those. See belowfor what these checks don't cover.
Weave noticed the step "Allocate rent": it uses the column "sq_ft" from its drivertable "Floor space", which doesn't have that column. Pick a column the table has,or add "sq_ft" to it.Weave noticed the step "Allocate IT cost": its output flows back into its drivertable "IT driver" through "Build IT driver", so how it spreads what it allocatesdepends on what it allocated on an earlier run. Check whether that loop isintended.Weave hasn't checked the step "Allocate IT cost" — whether its driver table"IT driver" has the columns it uses: the step "Build IT driver" builds thattable, so its columns aren't known until that step runs.Schritte, die Ihre Rolle nicht sehen kann, zählen zur Gesamtzahl, und die Überprüfung gibt an, dass sie diese nicht geprüft hat.
Eine Überprüfung listet auf, was sie nicht prüft. Sie führt die Prüfungen von Weave für Tabellen nicht aus — ob eine nach Zeitplan geschriebene Tabelle verspätet ist und ob eine Tabelle, die der Workflow liest, seitdem beschrieben wurde —, da diese das gesamte Projekt lesen und auf der Weave-Registerkarte laufen. Bei einem Workflow mit Umlageschritten prüft sie nicht, ob jeder umzulegende Betrag eine passende Treiberzeile oder ein passendes Dimensionselement findet, ob Quell- und Treibertabellen Werte auf derselben Detailebene enthalten, oder Kreisläufe, die durch einen Schritt laufen, der seine Tabelle in SQL oder über eine Variable benennt.
Um einen Workflow zu überprüfen, öffnen Sie ihn auf seiner Arbeitsfläche oder in seinem Raster Schritte und wählen Sie Prüfen. Die Schaltfläche steht Personen zur Verfügung, die den Workflow bearbeiten und die Tabellen des Projekts lesen können. Das Fenster Weave-Prüfung zeigt der Reihe nach:
- die Eröffnungszeilen der Überprüfung;
- Zusammenfassung (von KI verfasst), wenn die Überprüfung eine Zusammenfassung hat;
- die Probleme der Überprüfung und dann, was Nicht prüfbar war. Ein Problem, auf das die Zusammenfassung verweist, ist mit In der Zusammenfassung gekennzeichnet, und Gehe zu neben dem Befund eines Schritts wählt diesen Schritt an der Stelle aus, an der Sie Prüfen gewählt haben;
- Was diese Prüfung nicht abdeckt, immer zuletzt.
Wenn Sie erneut Prüfen wählen, wird im selben Fenster eine neue Überprüfung ausgeführt.
Sie können auch einen über PlaidCloud MCP
verbundenen KI-Assistenten bitten, einen Workflow zu überprüfen — sein Tool ist
workflow_review —, oder die Plattform-API aufrufen. Eine Überprüfung erfordert
Lesezugriff auf die Schritte, Workflows und Tabellen des Projekts. Die drei oben
genannten Prüfungen erscheinen nicht auf der Weave-Registerkarte; Weave führt sie
nur in einer Überprüfung aus.
Im Fenster Weave-Prüfung und über die Plattform-API enthält eine Überprüfung, die Probleme findet, außerdem eine Zusammenfassung aus ein oder zwei Sätzen, verfasst von der integrierten KI von PlaidCloud, sowie bis zu drei ihrer Probleme, die Sie sich zuerst ansehen sollten. Der KI werden nur die Probleme der Überprüfung gezeigt. Bevor die Zusammenfassung zurückgegeben wird, müssen die Probleme, auf die sie verweist, die eigenen der Überprüfung sein, jeder Name, den sie zitiert, und jede Ziffer, die sie schreibt, muss in diesen Problemen vorkommen, und sie darf keine Formulierung wie „keine weiteren Probleme“ verwenden. Eine Zusammenfassung, die diese Kontrolle nicht besteht, wird verworfen, und die Überprüfung wird ohne sie zurückgegeben. Eine Überprüfung ohne Probleme hat keine Zusammenfassung. Über einen KI-Assistenten hat die Überprüfung keine Zusammenfassung; der Assistent liest die Befunde selbst.
Benachrichtigung am Ende einer Ausführung
Abschnitt betitelt „Benachrichtigung am Ende einer Ausführung“Wenn die Ausführung eines Workflows endet, betrachtet Weave diesen Workflow und informiert den Eigentümer jedes Problems — siehe Einem Befund einen Eigentümer zuweisen — per In-App-Nachricht über die Probleme, die es zu diesem Workflow, seinen Ausführungen und der gespeicherten Konfiguration seiner Schritte gleichermaßen festhält und die er auf der Weave-Registerkarte des Projekts noch nicht gelesen hat. Ein Problem ohne Eigentümer oder dessen Eigentümer es nicht mehr sehen kann, geht an die Person, der die Ausführung gehört: die Person, die sie gestartet hat, oder bei einer geplanten Ausführung die Person, die den Zeitplan zuletzt gespeichert hat. Jedes Problem wird einmal erwähnt. Solange Sie es auf der Weave-Registerkarte nicht gelesen haben, erwähnen spätere Ausführungen es nicht erneut, sodass ein Workflow Loop, der viele Workflows ausführt, Ihren Bildschirm nicht mit Wiederholungen füllt. Der Zähler auf der Schaltfläche Weave behält es, bis Sie es lesen.
Die Nachricht bleibt 30 Sekunden auf dem Bildschirm und hat einen Link Weave öffnen, der die Weave-Registerkarte des Projekts mit den Befunden zum ausgeführten Workflow öffnet. Klicken Sie an eine beliebige andere Stelle der Nachricht, um sie zu schließen.
Solange eine Weave-Nachricht zu einem Projekt auf dem Bildschirm ist, wird eine neue zum selben Projekt mit ihr zusammengeführt, statt darunter zu erscheinen. Die Nachricht zeigt den neuesten Satz, gefolgt von einer Zeile wie Plus 2 weitere in diesem Projekt., und bleibt ab der neuesten 30 Sekunden auf dem Bildschirm. Betreffen die Nachrichten verschiedene Workflows, öffnet Weave öffnen die gesamte Weave-Registerkarte. Workflows, die kurz nacheinander fehlschlagen, ergeben also eine Nachricht statt jeweils einer eigenen. Eine Bereitschaftserinnerung erscheint immer für sich allein.
Nachdem Sie ein Problem gelesen haben, wird es nur dann erneut erwähnt, wenn sich seine Aussage ändert. Ein Ausführungsbefund beschreibt die Ausführung, aus der er stammt — ihr Datum, ihre Uhrzeit, ihre Anzahlen —, sodass ein Workflow, der jede Nacht fehlschlägt, beim nächsten Fehlschlag erneut erwähnt wird, nachdem Sie den letzten gelesen haben. Ein Konfigurationsproblem sagt von Ausführung zu Ausführung dasselbe aus; wenn Sie es einmal gelesen haben, wird es also nicht bei jeder Ausführung wiederholt.
Eine beendete Ausführung sendet nichts, unabhängig davon, wer sie beendet hat. Ein Workflow, der von einem Macro-Run- oder Macro-Concurrent-Schritt ausgeführt wird, sendet nichts Eigenes, und dieser Aufruf wird nicht zu seinen Ausführungen gezählt; ein Workflow, der von einem Schritt vom Typ Workflow ausführen oder Workflow Loop gestartet wird, ist eine Ausführung dieses Workflows wie jede andere. Was Weave nicht prüfen konnte, wird nie auf diesem Weg gesendet, ebenso wenig Befunde zu nach Zeitplan geschriebenen Tabellen oder zu Tabellen eines Workflows, die seit dem Lesen beschrieben wurden: Darüber informiert Weave zwischen den Ausführungen. Siehe Benachrichtigung zwischen Ausführungen.
Benachrichtigt zu werden ist nicht dasselbe wie gelesen zu haben: Eine Benachrichtigung markiert den Befund auf der Weave-Registerkarte nicht als gelesen, und das Folgen des Links Weave öffnen ebenfalls nicht.
Jedes Problem, über das eine Nachricht Sie informiert, wird zum Zähler auf der Schaltfläche Weave in der Kopfzeile hinzugefügt. Siehe Die Weave-Schaltfläche in der Kopfzeile.
Benachrichtigung zwischen Ausführungen
Abschnitt betitelt „Benachrichtigung zwischen Ausführungen“Manche Probleme treten auf, ohne dass etwas läuft: eine Tabelle, die nicht nach ihrem Zeitplan oder innerhalb ihres Aktualitätsschwellenwerts geschrieben wurde; eine geplante Ausführung, die nicht gestartet ist oder die fällig wurde, während der Workflow noch lief; ein Workflow, dessen Tabellen ein anderer Workflow beschrieben hat, seit er sie zuletzt gelesen hat; und ein Workflow oder Dashboard, das auf einer Tabelle beruht, die eine fehlgeschlagene Ausführung nicht fertiggestellt hat. Kein Ausführungsende kann Sie darüber informieren, daher prüft Weave jedes Projekt einmal pro Stunde darauf und informiert den Eigentümer jedes Problems — siehe Einem Befund einen Eigentümer zuweisen — per In-App-Nachricht.
Die stündliche Prüfung informiert Sie über jedes dieser Probleme einmal, egal wie viele Prüfungen es finden, und ihre erste Prüfung eines Projekts informiert Sie über die bereits vorhandenen, egal wie lange sie schon bestehen. Erneut informiert sie nur, nachdem das Problem verschwunden und wieder aufgetreten ist, oder nachdem Sie es gelesen haben und sich seine Aussage geändert hat, etwa bei einer späteren geplanten Ausführung, die ebenfalls nicht gestartet ist. Ein Zeitplanproblem gehört auch zu den eigenen Prüfungen eines Workflows; sobald die stündliche Prüfung Sie darüber informiert hat, wiederholt die Nachricht am Ende der nächsten Ausführung des Workflows es nicht, bis Sie es gelesen haben — siehe Benachrichtigung am Ende einer Ausführung. Mehrere Probleme in einem Projekt kommen als eine Nachricht, die sie zählt und das erste zitiert:
Weave hat 3 Probleme im Projekt „Finance Close“ bemerkt, beginnend mit der Tabelle „Sales Daily“: Der Schritt „Load Sales“ hat sie zuletzt am 14. Okt. 06:00 UTC geschrieben, und der Workflow „Nightly Load“ ist seitdem laut Zeitplan zur Ausführung fällig
Eine Tabelle, die von mehr als einem Workflow geschrieben wird, hat keinen Eigentümer, bis jemand einen zuweist. Wurde sie nicht planmäßig geschrieben, informiert Weave den Eigentümer jedes Workflows, der sie hätte schreiben sollen und es nicht getan hat. Jedes andere Problem ohne Eigentümer wird nicht gesendet; es wird auf der Weave-Registerkarte des Projekts aufgeführt.
Die Prüfung läuft im Namen jedes Eigentümers, sodass eine Nachricht nur nennt, was Ihre Rolle Sie sehen lässt. Sie werden nur als aktives Mitglied des Projekts informiert, dessen Rolle Sie dessen Schritte und Workflows sehen lässt, und über Tabellen nur, wenn Sie Tabellen lesen dürfen.
Die Nachricht bleibt 30 Sekunden auf dem Bildschirm und hat einen Link Weave öffnen, der die Weave-Registerkarte des Projekts öffnet, und zwar auf dem Workflow, wenn jedes Problem in der Nachricht denselben betrifft. Eine Nachricht wird nur angezeigt, während Sie angemeldet sind, aber jedes Problem, über das sie Sie informiert, wird zum Zähler auf der Schaltfläche Weave in der Kopfzeile hinzugefügt, sodass eines, das Sie verpasst haben, dort trotzdem gezählt wird. Benachrichtigt zu werden markiert einen Befund nicht als gelesen.
Einen Befund als gelesen markieren
Abschnitt betitelt „Einen Befund als gelesen markieren“Jeder Befund trägt eine ID, und Sie können ihn als gelesen markieren, damit er nicht mehr als neu erscheint — klicken Sie auf der Weave-Registerkarte des Projekts auf seiner Karte auf Als gelesen markieren (siehe Befunde als gelesen markieren). Die ID wird aus dem Befund selbst abgeleitet, sodass ein verworfener Befund wieder als neu erscheint, wenn sich das zugrunde liegende Problem ändert — ein Schritt, den Sie nach dem Beheben einer Spalte als gelesen markiert haben, erscheint erneut, wenn später eine andere Spalte fehlerhaft wird.
Der Gelesen-Status gilt nur für Sie. Wenn Sie einen Befund als gelesen markieren, wird er für niemanden sonst im Projekt als gelesen markiert.
Solange ein Workflow läuft, der eine verspätete Tabelle schreibt, meldet Weave die Tabelle stattdessen als nicht geprüft. Wenn Sie in dieser Zeit einen Befund als gelesen markieren und die Ausführung endet, ohne die Tabelle zu schreiben, erscheint ihr Befund wieder als neu.
Zwei verschiedene Schritte, die in einem Workflow doppelt aufgeführt sind, sind zwei Befunde; wenn Sie einen als gelesen markieren, bleibt der andere ungelesen. Ein Workflow ohne Namen erscheint als „unbenannter Workflow“, und eine Prüfung, die nicht ausgeführt werden konnte, wird mit ihrem Titel bezeichnet, etwa „Letzte Ausführung fehlgeschlagen“.
Ein Digest
Abschnitt betitelt „Ein Digest“Ein Digest ist derselbe Bericht, reduziert auf das, was Sie noch nicht gelesen haben, in derselben Sprache. Sie können jederzeit einen anfordern und ihn sich als In-App-Benachrichtigung zustellen lassen, mit einem Link Weave öffnen zur Weave-Registerkarte des Projekts.
Befunde, die Weave nicht prüfen konnte, gehören wie alle anderen zu einem Digest. Ein Digest, der sie stillschweigend wegließe, wäre genau das beruhigende Schweigen, das die dritte Antwort verhindern soll.