Mit ArcGIS Notebook Server können Sie mehrere Methoden der Workflow-Automatisierung implementieren, einschließlich der Automatisierung durch geplante Notebooks, durch Webhooks und durch eigene benutzerdefinierte Skripte mithilfe der Verwaltungs-API "Notebook ausführen".
Hinweis:
Zum Automatisieren eines Notebooks mithilfe von geplanten Tasks, Webhooks oder der API "Notebook ausführen" muss das Notebook mit einer Runtime der Version 3.0 oder höher ausgeführt werden.
Erstellen eines Zeitplans für Notebook-Tasks
Notebook-Autoren können die automatische Ausführung von ArcGIS Notebooks zu einem festen Zeitpunkt in der Zukunft planen, entweder einmalig oder in regelmäßigen Abständen. Die Erstellung von Tasks zur Planung von Notebooks ermöglicht die Automatisierung von Routineaufgaben, die Ausführung von datenintensiven Prozessen in Zeiten mit geringer Auslastung sowie die regelmäßige Aktualisierung von Datasets. Sie können für ein Notebook z. B. folgende Aufgaben planen:
- Importieren von Daten aus einer Online-Quelle, die monatlich aktualisiert wird, automatisches Bereinigen der Daten und Anwenden erforderlicher Transformationen sowie Verschieben der Daten in Ihren Workspace
- Ausführen eines Workflows zur Big-Data-Analyse, der hohe Rechenleistung erfordert, über Nacht, wenn die Computerressourcen nicht anderweitig genutzt werden
- Verwalten von Benutzern, die während der letzten Woche Konten in Ihrer Organisation erstellt haben, und Senden der Liste per E-Mail an Ihre Adresse
Sie können einen oder mehrere Tasks für ein Notebook ausführen. Standardmäßig kann der Notebook-Autor oder Administrator maximal 20 Tasks erstellen. Wenn ein Notebook den Besitzer wechselt, werden alle mit dem Notebook verknüpften Tasks deaktiviert und dem neuen Besitzer zugewiesen.
Mit geplanten Tasks können Sie Notebooks parametrisieren. Ein parametrisiertes Notebook ermöglicht Ihnen das Schreiben von generischem Code, der ohne Ihre Interaktion an variierende Eingaben angepasst werden kann. Die ausgewählten Parameter werden in das Notebook eingefügt, wenn ein Task ausgeführt wird, und können optional im Notebook gespeichert werden. Beispielsweise können mit einem parametrisierten Notebook regelmäßig Berichte zur Luftverschmutzung für eine gesamte Region generiert werden. Das Notebook kann mehrere geplante Tasks, einer pro zu untersuchender Region, aufweisen, und für jeden Task können parametrisierte Eingaben, z. B. Ortsname und Verschmutzungstyp, in das Notebook eingespeist werden.
Hinweis:
Die Anzahl gleichzeitig ausgeführter Notebook-Tasks wird durch die Systemeigenschaft maxExecuteNotebookContainersPerNode in Notebook Server beschränkt.
Sie können den Task so konfigurieren, dass der Zustand des Notebooks nach Abschluss des Tasks im ursprünglichen Notebook-Element gespeichert wird.
Für jeden ausgeführten geplanten Task wird eine statische HTML-Ansicht des Notebooks gespeichert.
Mithilfe des Fensters Tasks verwalten auf der ArcGIS Notebook Server-Startseite oder der Seite Tasks in ArcGIS Notebook Server Manager können Administratoren Detailinformationen zu den einzelnen aktiven Notebook-Tasks in der Site anzeigen und die Tasks bearbeiten, anhalten und fortsetzen oder löschen. Administratoren und Notebook-Autoren mit der Berechtigung "Zeitplan für Notebooks festlegen" können auf der Detailseite des Notebooks oder im Task-Bereich des Notebook-Editors Detailinformationen zu einem Notebook-Task anzeigen und den Task bearbeiten, anhalten/fortsetzen oder löschen.
Ein neuer geplanter Task wird übersprungen, wenn eine vorherige Ausführung des Tasks noch nicht abgeschlossen ist. Wenn z. B. für einen Task geplant ist, dass er alle 15 Minuten ausgeführt wird, das Ausführen einer Instanz des Tasks jedoch 20 Minuten dauert, wird die nächste geplante Ausführung übersprungen. Falls dies regelmäßig eintritt, sollte der Task-Besitzer das geplante Zeitintervall so anpassen, dass sich keine Ausführungen überlappen.
Weitere Informationen zu geplanten Notebook-Tasks finden Sie im Hilfethema Erstellen eines Zeitplans für Notebook-Tasks.
Beschränkungen für geplante Tasks
Für geplante Notebook-Tasks sind bestimmte Beschränkungen auf Benutzer-, Organisations- und ArcGIS Notebook Server-Site- (Computer-)Ebene vorhanden.
Ändern der maximalen Anzahl gleichzeitiger automatisierter Notebook-Ausführungen (maxExecuteNotebookContainersPerNode)
Beim Ausführen eines Notebooks durch einen geplanten Task, einen Webhook oder die API "Notebook ausführen" wird von ArcGIS Notebook Server automatisch ein neuer Container geöffnet und das Notebook ohne Benutzerinteraktion ausgeführt. Standardmäßig erfolgen durch ArcGIS Notebook Server maximal 10 gleichzeitige Notebook-Ausführungen pro Notebook Server-Computer. Ein Administrator kann unter Berücksichtigung der auf jedem Computer in der Notebook Server-Site verfügbaren Ressourcen (CPU und Arbeitsspeicher) diese Beschränkung durch Ändern der Systemeigenschaft maxExecuteNotebookContainersPerNode in Notebook Server anpassen. Anforderungen automatisierter Notebooks, die nach Überschreitung dieser Beschränkung gesendet werden, werden einer Warteschlange hinzugefügt und ausgeführt, sobald die Anzahl der automatisierten Task-Ausführungen unter die Beschränkung fällt. Tasks, die sich in der Warteschlange befinden, schlagen fehl, wenn die Wartezeit die Timeout-Zeit überschreitet.
Hinweis:
Die Anzahl der interaktiv über den Notebook-Editor ausgeführten Notebooks wird dadurch nicht eingeschränkt.
Sie können die Beschränkung maxExecuteNotebookContainersPerNode mit den folgenden Schritten ändern.
Hinweis:
Das Heraufsetzen des Limits für die Beschränkung kann zu einem zusätzlichen Ressourcenverbrauch bei den Notebook Server-Computern führen.
- Melden Sie sich als Administrator bei Ihrem ArcGIS Enterprise-Portal an.
- Öffnen Sie ArcGIS Notebook Server Manager.
- Klicken Sie auf Einstellungen > Site.
- Ändern Sie den Wert für die Eigenschaft maxExecuteNotebookContainersPerNode.
- Klicken Sie auf Save.
- Lesen Sie die Warnung zum Neustarten von Notebook Server fest, und klicken Sie auf Speichern und neu starten, um die Änderungen zu speichern.
Maximale Anzahl aktiver geplanter Notebook-Tasks pro Benutzer
Jeder Notebook-Autor mit der Berechtigung "Zeitplan für Notebooks festlegen" kann bis zu 20 aktive Notebook-Tasks erstellen. Sobald dieses Limit erreicht ist, kann der Benutzer keine neuen geplanten Tasks mehr erstellen. Ein neuer Task kann erstellt werden, wenn sich der Status eines vorhandenen Tasks von "Aktiv" zu "Abgeschlossen", "Nicht erfolgreich" oder "Inaktiv" ändert. Diese Beschränkung kann durch Aktualisierung der Eigenschaft ExecuteNotebooksUserLimit mithilfe des Vorgangs zum Aktualisieren von Systembeschränkungen in der ArcGIS Portal Administrator API geändert werden.
Maximale Anzahl aktiver geplanter Notebook-Tasks pro Organisation
Die maximale Anzahl aktiver geplanter Notebook-Tasks für eine Organisation ist auf 200 beschränkt. Dies ist die Gesamtzahl aktiver Tasks aller Benutzer in einer Organisation. Sobald dieses Limit erreicht ist, können Benutzer keine neuen geplanten Notebook-Tasks mehr erstellen. Diese Beschränkung kann durch Aktualisierung von ExecuteNotebooksOrgLimit mithilfe des Vorgangs zum Aktualisieren von Systembeschränkungen in der ArcGIS Portal Administrator API geändert werden.
Anzahl der berichteten Ergebnisse für einen geplanten Task
Die Ergebnisberichte der letzten 30 Ausführungen eines Tasks werden gespeichert. Die Ergebnisse früherer Ausführungen des Tasks werden dauerhaft gelöscht. Diese Beschränkung kann durch Aktualisierung der Eigenschaft TaskRunHistoryCount mithilfe des Vorgangs zum Aktualisieren von Systembeschränkungen in der ArcGIS Portal Administrator API geändert werden.
Automatischer Task-Fehler
Tasks, die fünfmal aufeinanderfolgend fehlschlagen, werden automatisch in den Status "Nicht erfolgreich" versetzt und nicht mehr ausgeführt. Der Task-Besitzer muss vor dem Reaktivieren des Tasks sicherstellen, dass das Notebook ohne Benutzerinteraktion erfolgreich ausgeführt werden kann. Um sicherzustellen, dass die Tasks weiterhin ausgeführt werden, muss der Task-Besitzer den Fehler identifizieren und beheben sowie den Task in den Status "Aktiv" versetzen. Diese Beschränkung kann durch Aktualisierung der Eigenschaft FailedRunsDisableTask mithilfe des Vorgangs zum Aktualisieren von Systembeschränkungen in der ArcGIS Portal Administrator API geändert werden.
API "Notebook ausführen"
Administratoren und Notebook-Autoren können ein Notebook auch mit dem Vorgang "Notebook ausführen" im ArcGIS Notebook Server-Administratorverzeichnis automatisieren, sodass es ohne Benutzerinteraktion ausgeführt wird. Durch das Aufrufen dieses Vorgangs wird ein Notebook automatisch ausgeführt. Sie können jedoch mithilfe eines benutzerdefinierten Skriptes die automatisierte Ausführung zu einem festgelegten Zeitpunkt oder in regelmäßigen Abständen planen. Zum Planen der Ausführung des Vorgangs "Notebook ausführen" zu einem festgelegten Zeitpunkt oder in regelmäßigen Abständen kann auch ein Cron-Job oder ein Windows-Taskplaner verwendet werden.
Weitere Informationen finden Sie in dem Thema zum Vorgang Execute Notebook im Administrator Directory Reference Guide.