メインコンテンツまでスキップ

Global initスクリプト (legacy)

important

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

警告

従来のグローバル initスクリプトとクラスター名付きの initスクリプトはサポートが終了し、使用できなくなりました。

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

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

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

Databricksワークスペースが2020年8月以前に起動されている場合は、レガシーのグローバルinitスクリプトがまだ残っている可能性があります。レガシーのグローバルinitスクリプトは非推奨となり、新しいワークスペースでは使用できなくなりました。これらは使用しないでください。

注記

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

自動移行ノートブック

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

手動移行の手順

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

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

    次のステップを完了するまで、無効にしておいてください。

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

    管理設定で、[ グローバルInitスクリプト ] タブに移動し、[ レガシーのグローバル初期化スクリプト ] スイッチをオフに切り替えます。

    レガシーのグローバルinitスクリプトを無効にする

注記

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

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

    [ グローバルInitスクリプト ] タブで、有効にする各initスクリプトの [ 有効 ] スイッチをオンにします。

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

important

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

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