Interface CLI (héritée) Stratégies de cluster

Article
01/31/2025

Important

Cette documentation a été supprimée et peut ne pas être mise à jour.

Ces informations s’appliquent aux versions héritées de Databricks CLI 0.18 et ci-dessous. Databricks vous recommande d’utiliser la version 0.205 ou ultérieure de l’interface CLI Databricks plus récente. Consultez Qu’est-ce que l’interface CLI Databricks ?. Pour rechercher votre version de l’interface CLI Databricks, exécutez databricks -v.

Pour migrer de Databricks CLI version 0.18 ou ultérieure vers Databricks CLI version 0.205 ou ultérieure, consultez migration de l’interface CLI Databricks.

Seuls les utilisateurs administrateurs de l’espace de travail peuvent créer, modifier et supprimer des stratégies. Les utilisateurs administrateurs de l’espace de travail ont également accès à toutes les stratégies.

Pour connaître les exigences et les limitations relatives aux stratégies de cluster, consultez Créer et gérer des stratégies de calcul.

Vous exécutez les sous-commandes CLI Stratégies de cluster Databricks en les ajoutant à databricks cluster-policies. Ces sous-commandes appellent l’API Stratégies du cluster.

databricks cluster-policies --help

Usage: databricks cluster-policies [OPTIONS] COMMAND [ARGS]...

  Utility to interact with Databricks cluster policies.

Options:
  -v, --version   [VERSION]
  --debug         Debug mode. Shows full stack trace on error.
  --profile TEXT  CLI connection profile to use. The default profile is
                  "DEFAULT".

  -h, --help      Show this message and exit.

Commands:
  create  Creates a Databricks cluster policy.
  delete  Removes a Databricks cluster policy given its ID.
  edit    Edits a Databricks cluster policy.
  get     Retrieves metadata about a Databricks cluster policy.
  list    Lists Databricks cluster policies.

Créer une stratégie de cluster

Pour afficher la documentation sur l’utilisation, exécutez databricks cluster-policies create --help.

databricks cluster-policies create --json-file create-cluster-policy.json

create-cluster-policy.json :

{
  "name": "Example Policy",
  "definition": "{\"spark_version\":{\"type\":\"fixed\",\"value\":\"next-major-version-scala2.12\",\"hidden\":true}}"
}

{
  "policy_id": "1A234567B890123C"
}

Supprimer une stratégie de cluster

Pour afficher l’aide, exécutez databricks cluster-policies delete --help.

databricks cluster-policies delete --policy-id 1A234567B890123C

En cas de réussite, cette commande n’affiche rien.

Modifier une stratégie de cluster

Pour afficher la documentation sur l’utilisation, exécutez databricks cluster-policies edit --help.

databricks cluster-policies edit --json-file edit-cluster-policy.json

edit-cluster-policy.json :

{
  "policy_id": "1A234567B890123C",
  "name": "Example Policy",
  "definition": "{\"spark_version\":{\"type\":\"fixed\",\"value\":\"next-major-version-scala2.12\",\"hidden\":false}}",
  "created_at_timestamp": 1619477108000
}

En cas de réussite, cette commande n’affiche rien.

Répertorier les informations sur une stratégie de cluster

Pour afficher la documentation sur l’utilisation, exécutez databricks cluster-policies get --help.

databricks cluster-policies get --policy-id A123456BCD789012

{
  "policy_id": "A123456BCD789012",
  "name": "Cluster Policy Demo",
  "definition": "{\n  \"spark_env_vars.PYSPARK_PYTHON\": {\n    \"type\": \"fixed\",\n    \"value\": \"/databricks/python3/bin/python27\"\n  }\n}",
  "created_at_timestamp": 1615504519000
}

Répertorier les informations sur les stratégies de cluster disponibles

Pour afficher la documentation sur l’utilisation, exécutez databricks cluster-policies list --help.

databricks cluster-policies list --output JSON

{
  "policies": [
    {
      "policy_id": "A123456BCD789012",
      "name": "Cluster Policy Demo",
      "definition": "{\n  \"spark_env_vars.PYSPARK_PYTHON\": {\n    \"type\": \"fixed\",\n    \"value\": \"/databricks/python3/bin/python27\"\n  }\n}",
      "created_at_timestamp": 1615504519000
    },
    ...
  ],
  "total_count": 16
}

Partager via