Condividi tramite


Interfaccia della riga di comando dei criteri del cluster (legacy)

Importante

Questa documentazione è stata ritirata e potrebbe non essere aggiornata.

Queste informazioni si applicano alle versioni legacy dell'interfaccia della riga di comando di Databricks 0.18 e successive. Databricks consiglia di usare invece la versione 0.205 o successiva dell'interfaccia della riga di comando di Databricks più recente. Consultare Databricks CLI. Per trovare la versione dell'interfaccia della riga di comando di Databricks, esegui il comando databricks -v.

Per eseguire la migrazione dalla CLI di Databricks versione 0.18 o inferiore alla CLI di Databricks versione 0.205 o superiore, vedere migrazione della CLI di Databricks.

Solo gli utenti amministratori dell'area di lavoro possono creare, modificare ed eliminare criteri. Gli utenti amministratori dell'area di lavoro hanno anche accesso a tutte le politiche.

Per i requisiti e le limitazioni dei criteri del cluster, vedere Creare e gestire i criteri di calcolo.

Si eseguono i sottocomandi dell'interfaccia a riga di comando delle politiche dei cluster di Databricks appendendoli a databricks cluster-policies. Questi sottocomandi chiamano l'API delle politiche del 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.

Creare una politica del cluster

Per visualizzare la documentazione sull'utilizzo, eseguire 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"
}

Eliminare un criterio del cluster

Per visualizzare la Guida, eseguire databricks cluster-policies delete --help.

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

In caso di esito positivo, questo comando non visualizza nulla.

Modificare i criteri di un cluster

Per visualizzare la documentazione sull'utilizzo, eseguire 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
}

In caso di esito positivo, questo comando non visualizza nulla.

Elencare le informazioni su un criterio del cluster

Per visualizzare la documentazione sull'utilizzo, eseguire 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
}

Elencare le informazioni sui criteri del cluster disponibili

Per visualizzare la documentazione sull'utilizzo, eseguire 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
}