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

Articolo
01/22/2025

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. Vedere Che cos'è l'interfaccia della riga di comando di Databricks?. 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
}

Condividi tramite