Globale Initialisierungsskripts (Legacy)

Wichtig

Diese Dokumentation wurde eingestellt und wird unter Umständen nicht aktualisiert. Die in diesem Inhalt erwähnten Produkte, Dienste oder Technologien werden nicht mehr unterstützt. Weitere Informationen finden Sie unter Was sind Initskripts?.

Warnung

Globale und nach Clustern benannte Legacy-Initialisierungsskripts werden nicht mehr unterstützt und können nicht mehr verwendet werden.

Globale Legacy-Initskripts werden auf jedem Cluster ausgeführt. Sie sind weniger sicher als das neue Framework für globale Initialisierungsskripts, ignorieren Fehler automatisch und können nicht auf Umgebungsvariablen verweisen.

Databricks empfiehlt die Migration vorhandener globaler Legacy-Initskripts zum neuen Framework für globale Initskripts. Globale Legacy-Initialisierungsskripts sind in der Benutzeroberfläche nicht sichtbar, Sie finden sie jedoch unter dbfs:/databricks/init/. Sie müssen aus diesem Ordner gelöscht oder verschoben werden, um eine Migration abzuschließen.

Migrieren von Legacy- zu neuen globalen Initialisierungsskripts

Wenn Ihr Azure Databricks-Arbeitsbereich vor August 2020 gestartet wurde, verfügen Sie möglicherweise noch über globale Legacyinitialisierungsskripts. Globale Legacyinitialisierungsskripts sind veraltet und in neuen Arbeitsbereichen nicht mehr verfügbar. Sie sollten nicht verwendet werden.

Hinweis

Am 1. September 2023 deaktiviert Azure Databricks globale Legacyinitialisierungsskripts für alle Arbeitsbereiche. Azure Databricks empfiehlt, Ihre globalen Legacyinitialisierungsskripts so schnell wie möglich zum aktuellen Framework für globale Initialisierungsskripts zu migrieren.

Automatisiertes Migrationsnotebook

Databricks Engineering hat ein Notebook erstellt, um den Migrationsprozess aus globalen Legacyinitialisierungsskripts zu automatisieren. Anweisungen und einen Link zum Notebook-Download finden Sie unter Migrationsnotebook für globale Legacyinitialisierungsskripts.

Anweisungen zur manuellen Migration

So migrieren Sie globale Legacyinitialisierungsskripts zu den neuen globalen Initialisierungsskripts:

  1. Kopieren Sie Ihre vorhandenen globalen Legacy-Initskripts aus ihrem reservierten DBFS-Speicherort (/databricks/init), und fügen Sie sie über die Benutzeroberfläche oder die REST-API dem neuen Framework für globale Initskripts hinzu. Weitere Informationen finden Sie unter Verwenden von globalen Initskripts.

    Lassen Sie sie deaktiviert, bis Sie den nächsten Schritt abgeschlossen haben.

  2. Deaktivieren Sie alle globalen Legacyinitialisierungsskripts.

    Wechseln Sie in den Administratoreinstellungen zur Registerkarte Globale Initialisierungsskripts, und deaktivieren Sie die Umschaltfläche Globale Legacyinitialisierungsskripts.

    Deaktivieren der globalen Legacyinitialisierungsskripts

    Hinweis

    Wenn Sie keinen Zugriff auf die Benutzeroberfläche haben, entfernen Sie alle Dateien aus dem Speicherort /databricks/init, um die Ausführung von Legacyinitialisierungsskripts zu beenden.

  3. Aktivieren Sie Ihre neuen globalen Initialisierungsskripts.

    Aktivieren Sie auf der Registerkarte Globale Initialisierungsskripts die Umschaltfläche Aktiviert für jedes Initialisierungsskript, das Sie aktivieren möchten.

  4. Starten Sie alle Cluster neu.

Wichtig

Sobald globale Legacy-Initskripts deaktiviert sind, werden Legacy-Skripts nicht mehr ausgeführt. Dies hat zwei wichtige Auswirkungen:

  • Legacy-Skripts und neue globale Initskripts werden nicht auf Knoten ausgeführt, die hinzugefügt werden, wenn ein ausgeführter Cluster automatisch skaliert wird. Um sicherzustellen, dass neue Skripts auf allen Clustern und neuen Knoten auf vorhandenen Clustern ausgeführt werden, müssen Sie alle Cluster neu starten.
  • Bei der Migration zum neuen Framework für globale Initialisierungsskripts und der Deaktivierung von Legacyskripts müssen Sie nicht idempotente Skripts möglicherweise ändern.