Clusterrichtlinien-CLI (Legacy)

Artikel
05/03/2024

Wichtig

Diese Dokumentation wurde eingestellt und wird unter Umständen nicht aktualisiert.

Diese Informationen gelten für ältere Versionen der Databricks-Befehlszeilenschnittstelle (0.18 und niedriger). Databricks empfiehlt, stattdessen die neuere Databricks-CLI Version 0.205 oder höher zu verwenden. Weitere Informationen finden Sie unter Was ist die Databricks-CLI?. Führen Sie databricks -v aus, um die Version Ihrer Databricks CLI zu ermitteln.

Informationen zum Migrieren der Databricks CLI-Version 0.18 oder niedriger zur Databricks CLI-Version 0.205 oder höher finden Sie unter Databricks CLI-Migration.

Nur Arbeitsbereichs-Administratorbenutzer können Richtlinien erstellen, bearbeiten und löschen. Arbeitsbereichs-Administratorbenutzer haben ebenfalls Zugriff auf alle Richtlinien.

Anforderungen und Einschränkungen für Clusterrichtlinien finden Sie unter Erstellen und Verwalten von Computerichtlinien.

Sie führen Unterbefehle über die CLI für Databricks-Clusterrichtlinien aus, indem Sie sie an databricks cluster-policies anfügen. Diese Unterbefehle rufen die Clusterrichtlinien-API auf.

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.

Erstellen einer Clusterrichtlinie

Führen Sie databricks cluster-policies create --help aus, um die Syntaxdokumentation anzuzeigen.

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"
}

Löschen einer Clusterrichtlinie

Führen Sie databricks cluster-policies delete --help aus, um Hilfe anzuzeigen.

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

Bei einer erfolgreichen Ausführung zeigt dieser Befehl nichts an.

Ändern einer Clusterrichtlinie

Führen Sie databricks cluster-policies edit --help aus, um die Syntaxdokumentation anzuzeigen.

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
}

Bei einer erfolgreichen Ausführung zeigt dieser Befehl nichts an.

Abrufen von Informationen zu einem Cluster

Führen Sie databricks cluster-policies get --help aus, um die Syntaxdokumentation anzuzeigen.

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
}

Auflisten von Informationen zu verfügbaren Clusterrichtlinien

Führen Sie databricks cluster-policies list --help aus, um die Nutzungsdokumentation anzuzeigen.

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
}

Freigeben über