メインコンテンツまでスキップ
に最終更新

実行中のDatabricksワークスペースを更新する

アカウント管理者は、デプロイ後に実行中のワークスペースの認証情報構成、ネットワーク構成、顧客管理キー、およびAWS PrivateLink設定を変更できます。更新可能なフィールドは一部のみです。FAILED状態のワークスペースは一切更新できないため、再作成する必要があります。

アカウントコンソールまたはアカウントAPIを使用して、ワークスペースオブジェクトを更新します。ワークスペースの更新は非同期で実行されます。更新を送信すると、ワークスペースのステータスはPROVISIONINGに変わり、すべての更新が完了するとRUNNINGに戻ります。

失敗したワークスペースは更新できません​

重要

FAILED状態のワークスペースは更新できません。アカウントコンソールとアカウントAPIの両方が更新を拒否し、次のメッセージを返します：

Console
Updating a failed workspace is no longer supported. Please create a new workspace or reach out to Databricks.

デプロイメントの失敗から復旧するには、失敗したワークスペースを削除し、修正した構成で新しいワークスペースを作成してください。クラシックワークスペースの作成またはアカウントAPIを使用したワークスペースの作成を参照してください。デプロイメントが失敗した理由の診断については、「Databricksワークスペース作成のトラブルシューティング」を参照してください。エラーメッセージが不明な場合は、Databricksアカウントチームにお問い合わせください。

ワークスペースを再作成する前に、「ワークスペース」ページで失敗したワークスペースをクリックし、 「ワークスペースのステータスメッセージ」 を読んで原因を確認してください。メッセージが特定の構成オブジェクトを指している場合は、そのオブジェクトを開いて詳細を確認してください。たとえば、エラーでネットワークについて言及されている場合は、 [クラウドリソース] > [ネットワーク構成] に移動してください。失敗したネットワーク構成を開き、無効なサブネットIDや不正なアドレス範囲などのエラーを確認してください。失敗した構成オブジェクトを削除し、置換ワークスペースで使用する新しいオブジェクトを作成してください。

一般的な原因：

  • 認証情報の構成については、クロスアカウントのIDおよびアクセス管理（IAM）ポリシーに必要な権限が含まれていることを確認してください。デプロイメントタイプに使用するポリシーについては、認証情報設定の作成を参照してください。必要なポリシーは、Databricks管理の仮想プライベートクラウド（VPC）を使用するか、独自のVPCを提供するかによって異なります。
  • ネットワーク構成については、 VPC、サブネット、およびセキュリティ グループが 顧客管理VPC の要件に準拠していることを確認します。
注記

（NATゲートウェイではなく）ファイアウォールまたはNATインスタンスがある場合、ネットワーク検証によってエラーではなく警告が発行されます。

更新可能な項目​

実行中のワークスペースを更新できますが、フィールドのサブセットのみを更新できます：

  • 資格情報の構成の変更。
  • ネットワーク構成の変更は、ワークスペースで既に [顧客管理 の構成]VPCを使用している場合にのみ行ってください。
  • Unity Catalog を有効にします。
  • マネージドサービスまたはワークスペース ストレージに 顧客管理キー を追加します。 この更新プログラムでワークスペース ストレージのキーを追加できるのは、ワークスペースにワークスペース ストレージのキー構成がまだない場合のみです。
  • AWS PrivateLink 設定を有効にするか更新します。
    • ネットワーク構成を更新し、プライベートアクセス設定を追加することで、PrivateLinkを有効にできます。ワークスペースで既にPrivateLinkが有効になっている場合は、アカウントコンソールを使用してプライベートアクセス設定オブジェクトのフィールドを更新するか、実行中のワークスペースに新しいプライベートアクセス設定オブジェクトを追加できます。フロントエンド、バックエンド、またはその両方の接続タイプを追加（アップグレード）することはできますが、既存のフロントエンドまたはバックエンドのPrivateLinkサポートを削除（ダウングレード）することはできませんのでご注意ください。新しい構成を使用するには、新しい設定（例えば、新しいVPCや異なるPrivateLinkサポート設定など）を使用して新しいネットワーク構成を作成し、ワークスペースを更新します。その他の重要な詳細については、 「Databricksへの従来のプライベート接続を構成する」を参照してください。
    • ワークスペースの登録済み VPC エンドポイントを追加または更新するには、登録済みの VPC エンドポイントを使用して新しいネットワーク設定オブジェクトを作成し、ワークスペースのネットワーク設定を更新します。この手順は、アカウント APIを使用して行うこともできます。
    • 既存の VPC の CIDR 範囲を更新するには、「 CIDR の更新」を参照してください。
注記

Databricks マネージド VPC を使用してワークスペースを更新すると、更新によってワークスペースの VPC、サブネット、およびセキュリティグループが削除され、再作成されます。

稼働中のワークスペースでは、認証情報とネットワーク構成のみを更新できます。

  1. アカウント管理者として[アカウントコンソール]にログインします。

  2. 「ワークスペース」ページで、ワークスペース名をクリックします。

  3. [構成] をクリックし、 [ワークスペースの更新] を選択します。

  4. 実行中のワークスペースで使用可能なフィールドを編集します。使用可能なフィールドのリストについては、このセクションの冒頭にあるリストを参照してください。

  5. 更新 をクリックします。

  6. ワークスペースの更新が反映されるまでお待ちください。更新を送信すると、ワークスペースのステータスがPROVISIONINGに変更されます。更新応答では、更新前のフィールド値を持つPROVISIONING状態のワークスペースが返されます。

重要
  • 更新されたフィールド値を読み取る前に、ワークスペースの状態がRUNNINGに戻るまで待ってください。ワークスペースがPROVISIONING状態の間は、フィールド値に依存しないでください。
  • アップデートが失敗した場合、システムはワークスペースを以前の構成にロールバックし、 RUNNING状態に戻します。
  • 更新とロールバックの両方が失敗した場合、ワークスペースのステータスはFAILEDに変わります。ワークスペースを再度更新して復旧させることはできません。失敗したワークスペースは更新できませんを参照してください。
  • ワークスペースの更新中およびステータスがRUNNINGに戻ってからさらに 20 分間は、コンピュート リソースの使用または作成ができません。 この時間が経過する前にコンピュートを作成または使用すると、コンピュートの起動が失敗したり、その他の予期しない動作が発生したりする可能性があります。

オプションのデプロイ後構成​

  • IPアクセスリストを有効にする : ユーザーがWebアプリケーション、 REST API、 JDBC/ODBC エンドポイント、およびDBConnectに接続できるようにするIPアドレスを構成します。 許可リストとブロックリストは、IP アドレスまたは範囲として指定できます。 ワークスペースの IP アクセス リストの構成を参照してください。
  • 監査ログを有効にする : Databricks では、Databricks ユーザーが実行したアクティビティと発生した使用状況を監視するために監査ログを構成することを強くお勧めします。 手順については、「 監査ログ配信の構成 」を参照してください。
このページの見出し