グローバル init スクリプト (レガシ)

重要

このドキュメントは廃止され、更新されない可能性があります。 このコンテンツで言及されている製品、サービス、テクノロジは、サポートされなくなりました。 「init スクリプトとは」を参照してください。

警告

レガシのグローバル init スクリプトおよびクラスターの名前付き init スクリプトは、有効期限切れであるため、使用できなくなります。

レガシ グローバル init スクリプトは、すべてのクラスターで実行されています。 これらは、新しいグローバル init スクリプト フレームワークよりも安全性が低く、エラーを警告なく無視し、環境変数を参照できません。

Databricks では、既存のすべてのレガシ グローバル init スクリプトを新しいグローバル init スクリプト フレームワークに移行することをお勧めしています。 従来のグローバル init スクリプトは UI には表示されませんが、dbfs:/databricks/init/ にあります。 移行を完了するには、そのフォルダーからこれらを削除するか移動する必要があります。

レガシから新しいグローバル init スクリプトに移行する

Azure Databricks ワークスペースが 2020 年 8 月より前に導入された場合でも、レガシのグローバル init スクリプトが存在する可能性があります。 レガシ グローバル init スクリプトは非推奨になり、新しいワークスペースでは使用できなくなりました。 これを使用しないでください。

注意

2023 年 9 月 1 日に、Azure Databricks では、すべてのワークスペースのレガシ グローバル init スクリプトが無効になります。 Azure Databricks では、レガシ グローバル init スクリプトを、できるだけ早く現在のグローバル init スクリプト フレームワークに移行することが推奨されています。

自動移行ノートブック

Databricks エンジニアリングは、レガシ グローバル init スクリプトからの移行プロセスを自動化するのに役立つノートブックを作成しました。 ノートブックのダウンロード手順とリンクについては、「レガシ グローバル init スクリプトの移行ノートブック」を参照してください。

手動移行の手順

レガシ グローバル init スクリプトを新しいグローバル init スクリプトに移行するには、以下の手順を実行します。

1. 予約済みの DBFS の場所 (/databricks/init) から既存のレガシ グローバル init スクリプトをコピーし、UI または REST API を使用して新しいグローバル init スクリプト フレームワークに追加します。 グローバル init スクリプトを参照してください。

   次の手順を完了するまで無効にしてください。

2. すべてのレガシ グローバル init スクリプトを無効にします。

   [管理者設定] で、[グローバル init スクリプト] タブに移動し、[レガシ グローバル init スクリプト] スイッチをオフにします。

   

   注意

   UI にアクセスできない場合は、/databricks/init の場所からすべてのファイルを削除して、レガシ init スクリプトの実行を停止してください。

3. 新しいグローバル init スクリプトを有効にします。

   [Global Init Scripts] タブで、有効にする init スクリプトごとに [有効] スイッチを切り替えます。

4. すべてのクラスターを再起動します。

重要

レガシ グローバル init スクリプトが無効になると、レガシ スクリプトは直ちに実行を停止します。 これには、次の 2 つの重要な影響があります。

• レガシ スクリプトと新しいグローバル init スクリプトは、実行中のクラスターの自動スケーリング時に追加されたノードでは実行されません。 新しいスクリプトがすべてのクラスターと既存のクラスター上の新しいノードで実行されるようにするには、すべてのクラスターを再起動する必要があります。
• 新しいグローバル init スクリプト フレームワークに移行し、レガシ スクリプトを無効にするときに、非べき等スクリプトを変更する必要がある場合があります。