Partager via


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

Important

Cette documentation a été mise hors service et peut ne pas être mise à jour.

Ces informations s’appliquent aux anciennes versions Databricks CLI 0,18 et inférieures. Databricks vous recommande d’utiliser à la place la nouvelle version 0.205 ou supérieure de l’interface CLI Databricks. Consultez Qu’est-ce que l’interface CLI Databricks ?. Pour trouver votre version de l’interface CLI Databricks, exécutez databricks -v.

Pour migrer de Databricks CLI version 0,18 ou inférieure vers Databricks CLI version 0,205 ou supérieure, consultez Migration Databricks CLI.

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

Pour connaître les conditions requises et les limitations relatives aux stratégies de cluster, consultez Créer et gérer les 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 d’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 d’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 relatives à une stratégie de cluster

Pour afficher la documentation d’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 relatives aux stratégies de cluster disponibles

Pour afficher la documentation d’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
}