Mettre à jour un workspace en cours d'exécution ou en échec

Apportez des modifications à un Workspace Databricks existant en utilisant la page des paramètres d'administrateur. Les mises à jour disponibles dépendent de l'état de la configuration du Workspace, qu'elle soit en échec ou déjà en cours d'exécution.

Vous pouvez également apporter des modifications au workspace à l'aide de l'API de compte. Avec l'API, vous pouvez mettre à jour un objet de workspace ou d'autres objets. Consultez l'API du compte. Les mises à jour du Workspace s'exécutent de manière asynchrone. Lorsque vous soumettez une mise à jour, le statut du workspace passe à PROVISIONING et revient à RUNNING une fois toutes les mises à jour terminées.

Mettre à jour un workspace ayant échoué

Vous pouvez mettre à jour la configuration d'un workspace qui ne parvient pas à se déployer, mais seulement un sous-ensemble des champs :

Modifier la configuration de l’identifiant.
Modifiez la configuration de stockage.
Modifiez la configuration réseau. Si une configuration réseau est déjà définie, vous pouvez la modifier. Pour un workspace en échec uniquement, vous pouvez convertir un workspace avec un Virtual Private Cloud (VPC) géré par Databricks pour qu’il utilise à la place un Virtual Private Cloud (VPC) géré par le client. Pour ce faire, ajoutez une configuration réseau.

important

Si vous modifiez un Workspace pour utiliser un Virtual Private Cloud (VPC) géré par les clients, Databricks recommande également de modifier la configuration de vos identifiants afin d'utiliser une politique d'accès spécifique aux <Databricks> Workspaces avec des Virtual Private Cloud (VPC) gérés par les clients, car il s'agit d'un ensemble plus restreint de permissions requises.

Ajoutez des clés gérées par les clients pour les services gérés (certains types de stockage du plan de contrôle, tels que la source de Notebook et les queries Databricks SQL).
Ajouter des clés gérées par le client pour le stockage du workspace (compartiment racine S3 et, facultativement, volumes EBS). Vous ne pouvez ajouter des clés pour le stockage du Workspace dans cette mise à jour que si le Workspace ne dispose pas déjà d'une configuration de clé pour le stockage du Workspace. Si le workspace a été en état d'exécution, même brièvement avant de devenir un workspace en échec, vous ne pouvez pas ajouter un nouvel ID de configuration de clé pour le stockage du workspace.
Activer ou mettre à jour les paramètres de configuration AWS PrivateLink :
- Activez PrivateLink en mettant à jour la configuration réseau et en ajoutant des paramètres d'accès privé. Si le workspace est déjà compatible PrivateLink, vous pouvez utiliser la console de compte pour mettre à jour les champs de l'objet de paramètres d'accès privé ou vous pouvez ajouter un nouvel objet de paramètres d'accès privé à un workspace en cours d'exécution. Notez que vous pouvez ajouter (mettre à niveau) la connectivité front-end, back-end, ou les deux types de connectivité, mais vous ne pouvez pas supprimer (rétrograder) la prise en charge existante de PrivateLink front-end ou back-end. Pour utiliser la nouvelle configuration réseau, créez une nouvelle configuration réseau avec de nouveaux paramètres, par exemple pour un nouveau Virtual Private Cloud (VPC) ou des paramètres de prise en charge PrivateLink différents, puis mettez à jour le workspace. Pour d'autres détails importants, consultez Configurer la connectivité privée classique à Databricks.
- Ajoutez ou mettez à jour les endpoints Virtual Private Cloud (VPC) enregistrés d'un Workspace en créant un nouvel objet de configuration réseau avec des endpoints Virtual Private Cloud (VPC) enregistrés, puis mettez à jour la configuration réseau du Workspace.
- Pour mettre à jour les plages CIDR sur un Virtual Private Cloud (VPC) existant, consultez Mise à jour des CIDR.

Si le statut de votre nouveau Workspace est Failed , vous pouvez mettre à jour la configuration du Workspace ayant échoué et réessayer la création du Workspace avec la nouvelle configuration.

Connectez-vous à la console du compte en tant qu’administrateur de compte.
Sur la page Workspaces, cliquez sur le nom du workspace défaillant.
Affichez le message d'erreur dans **Message de statut du Workspace**.

Le message d'erreur peut vous indiquer la cause du problème. Si l'erreur mentionne des identifiants, un stockage ou une validation réseau, en fonction du problème, vous pourriez avoir besoin de consulter des pages supplémentaires pour voir les erreurs exactes. Votre prochaine étape dépend de ce qui ne va pas. Vous pourriez avoir besoin de sélectionner un objet de configuration différent de celui que vous avez initialement utilisé.

L'une des configurations individuelles du Workspace pourrait contenir une erreur. Par exemple, si l'erreur du workspace mentionne un problème avec le réseau, accédez à Ressources cloud > Configurations réseau pour plus de détails. La vue des détails de la configuration réseau défaillante inclut des messages d'erreur qui identifient des problèmes tels que des ID de sous-réseau invalides ou des plages d'adresses incorrectes.

remarque

Si vous disposez d'un pare-feu ou d'une instance NAT (au lieu d'une passerelle NAT), la validation du réseau émet un avertissement.

Pour toute configuration ayant échoué, supprimez-la et créez-en une nouvelle. Problèmes courants :

Pour les configurations d’informations d’identification, veuillez confirmer que votre politique IAM inter-comptes inclut les autorisations requises. Consultez Créer une configuration d'informations d'identification pour la politique à utiliser pour votre type de déploiement. Lorsque vous décidez quelle politique de rôle utiliser, déterminez si vous souhaitez utiliser le VPC géré par Databricks ou fournir votre propre VPC. Veuillez suivre les instructions sur cette page pour la politique de rôle à utiliser.
Pour les configurations réseau, assurez-vous que votre Virtual Private Cloud (VPC), vos sous-réseaux et vos groupes de sécurité sont conformes aux exigences du Virtual Private Cloud (VPC) géré par le client.

Sur la page Workspaces, cliquez sur le nom du Workspace, cliquez sur Configure , puis sélectionnez Update Workspace .
Modifiez les champs de configuration du Workspace selon les besoins. Par exemple, sélectionnez un autre identifiant ou une autre configuration de stockage. Vous ne pouvez pas modifier le nom du workspace ou l'URL du workspace. Pour la liste des champs disponibles pour les Workspaces échoués, consultez la liste au début de cette section.
Cliquez sur Mettre à jour .
Vérifiez l'état. Voir l'état du Workspace.

Pour obtenir des conseils supplémentaires ou si les messages d'erreur ne sont pas clairs, veuillez contacter l'équipe de votre compte Databricks.