Databricks Webターミナルでシェルコマンドを実行する
Databricks Web ターミナルは、 Databricks CLIコマンドを含む シェル コマンドを実行したり、 Sparkドライバー ノードで Vim や Emacs などのエディターを使用したりするための、便利で高度にインタラクティブな方法を提供します。 Webターミナルは、1つのコンピュート上で複数のユーザーが利用できます。 Web ターミナルの使用例としては、モニタリング リソースの使用や Linux パッケージのインストールなどが挙げられます。
Web ターミナルは、すべてのワークスペース ユーザーに対してデフォルトによって無効になっています。 有効にするには、 「Web ターミナルを有効にする」を参照してください。
警告
Databricks は、コンピュートの Spark ドライバーのポート 7681 から Web ターミナル サービスをプロキシします。 この Web プロキシは、Web ターミナルでのみ使用することを目的としています。 コンピュートの開始時にポートが占有されている場合、またはその他の競合がある場合、Web ターミナルは期待どおりに動作しない可能性があります。 他の Web サービスがポート 7681 で起動されると、コンピュート ユーザーは潜在的なセキュリティエクスプロイトにさらされる可能性があります。 Databricks は、サポートされていないソフトウェアをコンピュートにインストールしたことに起因する問題については責任を負いません。
要件
Databricksワークスペースで Web ターミナルが有効になっている必要があります。
コンピュートにCan Attach To 。
コンピュートは、 シングル ユーザー または 非分離共有 の アクセス モード を使用する必要があります。
Webターミナルを起動する
コンピュート詳細ページまたは、ポータルからWebターミナルを起動できます。
ノートブックから
ポータルから Web ターミナルを起動するには:
ドイツ語をコンピュートに接続します。
ノートブックの右サイドバーの下部にある「下部パネルを開く」アイコンをクリックします。
。
または、添付のコンピュート ドロップダウンをクリックし、添付のコンピュートの上にマウスを移動して、 [Web ターミナル]をクリックします。
Web ターミナルは画面下部のパネルで開きます。 パネルの右上にあるボタンを使用すると、次のことができます。
新しいターミナルセッションを新しいタブで
開きます。
ターミナルセッション
をリロードします。
下部パネル
を閉じます。 パネルを再度開くには、右サイドバーの下部にある をクリックします
。
Webターミナルを使う
Webターミナルでは、コンピュートドライバノードのコンテナ内のrootからコマンドを実行できます。
各ユーザーは、最大 100 個のアクティブな Web ターミナル セッション (タブ) を開くことができます。 アイドル状態の Web ターミナル セッションがタイムアウトし、Web ターミナル Web アプリケーションが再接続され、新しいシェル プロセスが発生する可能性があります。 Bash セッションを保持する場合、Databricks では tmux の使用が推奨されています。
Databricks CLIコマンドを実行します
Web ターミナルを使用してDatabricks CLIコマンドを実行することもできます。 利用可能な CLI は常に最新バージョンであり、認証は現在のユーザーに基づいて行われます。 コンピュートは以下の要件を満たす必要があります。
クラスターには Databricks Runtime 15.0 以降がインストールされている必要があります。
ワークスペースはプライベート サービス Connect に対して有効にしないでください。
Web ターミナルを起動し、次のコマンドを実行して現在のユーザーに関する情報を出力します。
databricks current-user me
Bundle コマンドも利用可能で、これを使用すると、Databricks Databricksワークスペース内の Web ターミナルから直接 アセット バンドル を作成および管理できます。たとえば、デフォルトのテンプレートを使用して単純なバンドルを作成、デプロイ、実行するには、次のようにします。
Web ターミナルのルートから、ワークスペースのホームに移動し、
bundle init
を実行します。cd /Workspace/Users/someone@example.com databricks bundle init
デフォルトのテンプレートプロンプトを受け入れ、バンドルディレクトリに移動してデプロイします。
cd my_project databricks bundle deploy
デプロイされた
my_project
バンドルは、Databricks ワークスペース UI で表示できます。最後に、バンドル内のデフォルトのジョブを実行します。
databricks bundle run my_project_job
実行中のジョブを確認するには、[ジョブ 実行]に移動します。
制限事項
Databricks 、Web ターミナルからのSparkジョブの実行をサポートしていません。
Databricks Web Terminal は、次のコンピュート タイプでは使用できません。
ジョブコンピューティング
サーバーレスコンピュート
コンピュートは、
DISABLE_WEB_TERMINAL=true
環境変数を設定して起動されました。アクセス モードをSharedに設定してコンピュートが起動されました。
コンピュートは、Spark 構成
spark.databricks.pyspark.enableProcessIsolation
をtrue
に設定して起動しました。
最初のページ読み込みから 12 時間というハード制限があり、その後、アクティブな接続であっても、すべての接続が終了します。 Web ターミナルを更新して再接続できます。 Databricks では、 tmux を使用してシェル セッションを保持することをお勧めします。
ARM コンピュートリソースは、Web ターミナルを使用して、 Gitフォルダー内のファイルを含むワークスペース ファイルにアクセスすることはできません。