Databricks Webターミナルでシェルコマンドを実行する

Databricks Web ターミナルは、 Databricks CLIコマンドを含む シェル コマンドを実行したり、 Sparkドライバー ノードで Vim や Emacs などのエディターを使用したりするための、便利で高度にインタラクティブな方法を提供します。 SSHを使用する場合とは異なり、Web ターミナルは 1 つのコンピュート上で複数のユーザーが使用でき、キーを設定する必要がありません。 Web ターミナルの使用例としては、モニタリング リソースの使用や Linux パッケージのインストールなどが挙げられます。

Web ターミナルは、すべてのワークスペース ユーザーに対してデフォルトによって無効になっています。 有効にするには、 「Web ターミナルを有効にする」を参照してください。

警告

Databricks は、コンピュートの Spark ドライバーのポート 7681 から Web ターミナル サービスをプロキシします。 この Web プロキシは、Web ターミナルでのみ使用することを目的としています。 コンピュートの開始時にポートが占有されている場合、またはその他の競合がある場合、Web ターミナルは期待どおりに動作しない可能性があります。 他の Web サービスがポート 7681 で起動されると、コンピュート ユーザーは潜在的なセキュリティエクスプロイトにさらされる可能性があります。 Databricks は、サポートされていないソフトウェアをコンピュートにインストールしたことに起因する問題については責任を負いません。

要件

  • Databricksワークスペースで Web ターミナルが有効になっている必要があります。

  • コンピュートにCan Attach To

  • コンピュートは、 シングル ユーザー または 非分離共有 の アクセス モード を使用する必要があります。

Webターミナルを起動する

コンピュート詳細ページまたは、ポータルからWebターミナルを起動できます。

ノートブックから

ポータルから Web ターミナルを起動するには:

  1. ドイツ語をコンピュートに接続します。

  2. ノートブックの右サイドバーの下部にある「下部パネルを開く」アイコンをクリックします。ノートブックの下部パネルを開く

  3. または、添付のコンピュート ドロップダウンをクリックし、添付のコンピュートの上にマウスを移動して、 [Web ターミナル]をクリックします。

Web ターミナルは画面下部のパネルで開きます。 パネルの右上にあるボタンを使用すると、次のことができます。

  • 新しいターミナルセッションを新しいタブで 新しいターミナルセッションを開く開きます。

  • ターミナルセッション ターミナルセッションの再ロードをリロードします。

  • 下部パネル 下部パネルを閉じるを閉じます。 パネルを再度開くには、右サイドバーの下部にある をクリックします 底面パネルを再度開く

コンピュート詳細ページより

コンピュート詳細ページからWebターミナルを起動するには:

  1. ワークスペースのサイドバーで、 「コンピュート」をクリックします。

  2. 汎用コンピュートタブで、コンピュートの名前をクリックします。

  3. スタート」をクリックしてコンピュートを起動します。

  4. [アプリ]タブで、 [Webターミナル]をクリックします。

Web ターミナル UI と Bash プロンプトを含む新しいタブが開きます。

Webターミナルを使う

Webターミナルでは、コンピュートドライバノードのコンテナ内のrootからコマンドを実行できます。

各ユーザーは、最大 100 個のアクティブな Web ターミナル セッション (タブ) を開くことができます。 アイドル状態の Web ターミナル セッションがタイムアウトし、Web ターミナル Web アプリケーションが再接続され、新しいシェル プロセスが発生する可能性があります。 Bash セッションを保持する場合、Databricks では tmux の使用が推奨されています。

Databricks CLIコマンドを実行します

Web ターミナルを使用してDatabricks CLIコマンドを実行することもできます。 利用可能な CLI は常に最新バージョンであり、認証は現在のユーザーに基づいて行われます。 コンピュートは以下の要件を満たす必要があります。

  • クラスターには Databricks Runtime 15.0 以降がインストールされている必要があります。

  • ワークスペースで PrivateLink を有効にしないでください。

Web ターミナルを起動し、次のコマンドを実行して現在のユーザーに関する情報を出力します。

   databricks current-user me

Bundle コマンドも利用可能で、これを使用すると、Databricks Databricksワークスペース内の Web ターミナルから直接 アセット バンドル を作成および管理できます。たとえば、デフォルトのテンプレートを使用して単純なバンドルを作成、デプロイ、実行するには、次のようにします。

  1. Web ターミナルのルートから、ワークスペースのホームに移動し、 bundle initを実行します。

    cd /Workspace/Users/someone@example.com
    databricks bundle init
    
  2. デフォルトのテンプレートプロンプトを受け入れ、バンドルディレクトリに移動してデプロイします。

    cd my_project
    databricks bundle deploy
    

    デプロイされたmy_projectバンドルは、Databricks ワークスペース UI で表示できます。

  3. 最後に、バンドル内のデフォルトのジョブを実行します。

    databricks bundle run my_project_job
    

    実行中のジョブを確認するには、[ジョブ 実行]に移動します。

制限事項

  • Databricks 、Web ターミナルからのSparkジョブの実行をサポートしていません。

  • Databricks Web Terminal は、次のコンピュート タイプでは使用できません。

    • ジョブコンピューティング

    • サーバーレスコンピュート

    • コンピュートは、 DISABLE_WEB_TERMINAL=true環境変数を設定して起動されました。

    • アクセス モードをSharedに設定してコンピュートが起動されました。

    • コンピュートは、Spark 構成spark.databricks.pyspark.enableProcessIsolationtrueに設定して起動しました。

  • 最初のページ読み込みから 12 時間というハード制限があり、その後、アクティブな接続であっても、すべての接続が終了します。 Web ターミナルを更新して再接続できます。 Databricks では、 tmux を使用してシェル セッションを保持することをお勧めします。

  • ARM コンピュートリソースは、Web ターミナルを使用して、 Gitフォルダー内のファイルを含むワークスペース ファイルにアクセスすることはできません。