グローバル init スクリプトを使用する

重要

グローバル init スクリプトを実行できるのは、単一ユーザーまたは従来の分離なし共有アクセス モードで構成されたクラスター上だけであるため、Databricks は、すべての init スクリプトをクラスタースコープの init スクリプトとして構成し、クラスター ポリシーを使用してそれらをワークスペース全体で管理することを推奨しています。

グローバル init スクリプトは、ワークスペースで作成されたクラスターごとに実行されます。 グローバル init スクリプトは、組織全体のライブラリ構成またはセキュリティ画面を適用する場合に便利です。 グローバル init スクリプトを作成できるのはワークスペース管理者のみです。 UI または REST API を使用して作成することができます。

重要

グローバル init スクリプトはすべてのクラスターで実行されるため、次のような潜在的な影響を考慮してください。

  • ライブラリの追加や、意図しない影響を引き起こすその他の変更を行うことは容易です。 可能な限り、代わりにクラスター スコープの init スクリプトを使用してください。
  • クラスターを作成し、クラスター ログ配信を有効にするユーザーは、グローバル init スクリプトの stderr および stdout 出力を表示できます。 グローバル init スクリプトで機密情報が出力されていないことを確認する必要があります。

クラスター ログ配信を構成し、init スクリプト ログを調べることで、グローバル init スクリプトのトラブルシューティングを行うことができます。 「Init スクリプトのログ」を参照してください。

Note

グローバル初期化スクリプトはクラスターを処理するモデルでは実行されなくなりました。

UI を使用してグローバル init スクリプトを追加する

管理者設定を使用してグローバル init スクリプトを構成するには、以下の手順を実行します。

  1. 管理者設定に移動して、[計算] タブをクリックします。

  2. [Global init scripts] (グローバル init スクリプト) の横にある [管理] をクリックします。

  3. [+ 追加] をクリックします。

  4. スクリプトに名前を付け、テキスト ファイルを [スクリプト] フィールドに入力、貼り付け、またはドラッグして入力します。

    注意

    init スクリプトは 64 KB より大きくすることはできません。 スクリプトがこのサイズを超えると、保存しようとするときにエラー メッセージが表示されます。

  5. ワークスペースに対して複数のグローバル init スクリプトが構成されている場合は、新しいスクリプトを実行する順序を設定します。

  6. 保存後に新しいクラスターと再起動されたクラスターすべてに対してスクリプトを有効にする場合は、[有効] をオンに切り替えます。

    重要

    グローバル init スクリプトを追加したり、init スクリプトの名前、実行順序、有効化を変更したりしても、クラスターを再起動するまで、それらの変更は有効になりません。

  7. [追加] をクリックします。

Terraform を使用してグローバル init スクリプトを追加する

Databricks Terraform プロバイダーdatabricks_global_init_script を使用して、グローバル init スクリプトを追加できます。

UI を使用してグローバル init スクリプトを編集する

  1. 管理者設定に移動して、[計算] タブをクリックします。
  2. [Global init scripts] (グローバル init スクリプト) の横にある [管理] をクリックします。
  3. スクリプトをクリックします。
  4. スクリプトを編集します。
  5. [Confirm](確認) をクリックします。

API を使用してグローバル init スクリプトを構成する

ワークスペース管理者は、Global Init Scripts API を使用して、ワークスペース内のグローバル init スクリプトに関する情報を追加、削除、順序変更、取得できます。