Teilen über


settings Befehlsgruppe

Note

Diese Informationen gelten für Databricks CLI-Versionen 0.205 und höher. Die Databricks CLI befindet sich in der öffentlichen Vorschau.

Die Verwendung von Databricks CLI unterliegt der Datenbricks-Lizenz - und Databricks-Datenschutzerklärung, einschließlich der Bestimmungen zu Nutzungsdaten.

Die settings Befehlsgruppe in der Databricks CLI enthält Befehle zum Verwalten von Einstellungen auf Arbeitsbereichsebene, die verschiedene Features und Richtlinien steuern, die für den gesamten Arbeitsbereich gelten. Siehe "Arbeitsbereich verwalten".

databricks Einstellungen aibi-Dashboard-Einbettungs-Zugriffsrichtlinie

Steuert, ob die KI/BI veröffentlichte Dashboardeinbettung aktiviert, bedingt aktiviert oder auf Arbeitsbereichsebene deaktiviert ist. Diese Einstellung ist standardmäßig bedingt aktiviert (ALLOW_APPROVED_DOMAINS).

  • delete – Löschen der AI/BI-Dashboard-Einbettungszugriffsrichtlinie
  • get – Zugriffsrichtlinie für die Einbettung des AI/BI-Dashboards abrufen
  • update – Aktualisieren der AI/BI-Dashboard-Einbettungs-Zugriffsrichtlinie

Einstellungen in Databricks: aibi-dashboard-embedding-access-policy-abrufen

Rufen Sie die KI/BI-Dashboard-Einbettungs-Zugriffsrichtlinie ab. Die Standardeinstellung ist ALLOW_APPROVED_DOMAINS, soweit AI/BI-Dashboards in genehmigte Domänen eingebettet werden dürfen.

databricks settings aibi-dashboard-embedding-access-policy get [flags]

Options

--etag string

    etag, das für die Versionierung verwendet wird.

Globale Kennzeichnungen

Examples

databricks settings aibi-dashboard-embedding-access-policy get

databricks-Einstellungen für aibi-Dashboard-Embedding-Zugriffsrichtlinie aktualisieren

Aktualisieren Sie die Richtlinie zum Einbetten des Zugriffs auf das AI/BI-Dashboard auf Arbeitsbereichsebene.

databricks settings aibi-dashboard-embedding-access-policy update [flags]

Options

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.

Globale Kennzeichnungen

Examples

databricks settings aibi-dashboard-embedding-access-policy update --json '{"access_policy": "ALLOW_ALL"}'

Databricks-Einstellungen aibi-dashboard-embedding-access-policy löschen

Löschen Sie die AI/BI-Dashboard-Einbettungszugriffsrichtlinie, und kehren Sie wieder auf die Standardeinstellung zurück.

databricks settings aibi-dashboard-embedding-access-policy delete [flags]

Options

--etag string

    etag, das für die Versionierung verwendet wird.

Globale Kennzeichnungen

Examples

databricks settings aibi-dashboard-embedding-access-policy delete

databricks-Einstellungen freigegebene Domains für aibi-Dashboard-Embedding

Steuert die Liste der Domänen, die zum Hosten der eingebetteten AI/BI-Dashboards genehmigt wurden. Die genehmigte Domänenliste kann nicht geändert werden, wenn die aktuelle Zugriffsrichtlinie nicht auf ALLOW_APPROVED_DOMAINS gesetzt ist.

  • delete - Löschen des AI/BI-Dashboards zum Einbetten genehmigter Domänen
  • get – Abrufen der Liste der Domänen, die zum Hosten eingebetteter AI/BI-Dashboards genehmigt wurden
  • update – Aktualisieren der Liste der Domänen, die zum Hosten eingebetteter AI/BI-Dashboards genehmigt wurden

Options

Globale Kennzeichnungen

Examples

databricks settings aibi-dashboard-embedding-approved-domains get
databricks settings aibi-dashboard-embedding-approved-domains update --json '{"approved_domains": ["example.com", "mydomain.org"]}'

Databricks-Einstellungen automatische Cluster-Aktualisierung

Steuert, ob die automatische Clusteraktualisierung für den aktuellen Arbeitsbereich aktiviert ist. Diese Funktion ist standardmäßig deaktiviert.

  • get – Einstellung für automatische Clusterupdates abrufen
  • update – Aktualisieren der Einstellung für automatische Clusterupdates

Options

Globale Kennzeichnungen

databricks settings automatic-cluster-update get

Ruft die Einstellung für die automatische Clusteraktualisierung ab.

databricks settings automatic-cluster-update get [flags]

Options

--etag string

    etag, das für die Versionierung verwendet wird.

Globale Kennzeichnungen

Examples

databricks settings automatic-cluster-update get

Databricks-Einstellungen automatische Cluster-Aktualisierung Update

Aktualisiert die Einstellung für die automatische Clusteraktualisierung für den Arbeitsbereich. Ein neues etag muss in Aktualisierungsanforderungen (im Einstellungsfeld) bereitgestellt werden. Das Etag kann abgerufen werden, indem eine Get-Anforderung vor der Updateanforderung gestellt wird.

databricks settings automatic-cluster-update update [flags]

Options

--json JSON

    Die Inline-JSON-Zeichenfolge oder der @path zur JSON-Datei mit dem Anforderungstext.

Globale Kennzeichnungen

Examples

databricks settings automatic-cluster-update update --json '{"automatic_cluster_update": {"enabled": true}}'

databricks Einstellungen Konformität-Sicherheitsprofil

Steuert, ob das Compliancesicherheitsprofil für den aktuellen Arbeitsbereich aktiviert werden soll. Das Aktivieren in einem Arbeitsbereich ist permanent. Diese Funktion ist standardmäßig deaktiviert.

Warning

Diese Einstellung kann nicht deaktiviert werden, sobald sie aktiviert ist.

  • get – Abrufen der Compliance-Sicherheitsprofil-Einstellung
  • update – Aktualisieren der Einstellung des Compliancesicherheitsprofils

Options

Globale Kennzeichnungen

Examples

databricks settings compliance-security-profile get
databricks settings compliance-security-profile update --json '{"compliance_security_profile": {"enabled": true}}'

databricks-Einstellungen Dashboard-E-Mail-Abonnements

Steuert, ob Zeitpläne oder Arbeitsauslastungsaufgaben zum Aktualisieren von AI/BI-Dashboards im Arbeitsbereich Abonnement-E-Mails mit PDFs und/oder Bildern des Dashboards senden können. Diese Einstellung ist standardmäßig aktiviert (auf "true" festgelegt).

  • delete – Einstellung für Dashboard-E-Mail-Abonnements löschen
  • get – Abrufen der Einstellung für Dashboard-E-Mail-Abonnements
  • update – Aktualisieren der Einstellung für Dashboard-E-Mail-Abonnements

Options

Globale Kennzeichnungen

Examples

databricks settings dashboard-email-subscriptions get
databricks settings dashboard-email-subscriptions update --json '{"dashboard_email_subscriptions": {"enabled": false}}'

databricks Einstellungen default-namespace

Konfigurieren Sie den Standardnamespace für einen Databricks-Arbeitsbereich.

Mithilfe dieses Befehls können Benutzer den Standardnamespace abrufen, festlegen oder ändern, der verwendet wird, wenn Abfragen nicht auf einen vollqualifizierten Namen mit drei Ebenen verweisen. Wenn Sie beispielsweise die API zum Festlegen retail_prod als Standardkatalog verwenden, würde eine Abfrage SELECT * FROM myTable auf das Objekt retail_prod.default.myTable verweisen (das Schema default wird immer angenommen).

Note

Für diese Einstellung ist ein Neustart von Clustern und SQL-Warenhäusern erforderlich, damit sie wirksam wird. Darüber hinaus gilt der Standard-Namespace nur, wenn ein Unity Catalog-fähiger Rechenvorgang verwendet wird.

  • delete - Löschen der Standardnamespaceeinstellung
  • get – Die Standardnamespace-Einstellung abrufen
  • update – Aktualisieren der Standardnamespaceeinstellung

Options

Globale Kennzeichnungen

Examples

databricks settings default-namespace get
databricks settings default-namespace update --json '{"namespace": {"value": "retail_prod"}}'
databricks settings default-namespace delete

Databricks-Einstellungen deaktivieren den Legacyzugriff

Das Deaktivieren des Legacyzugriffs hat folgende Auswirkungen:

  • Deaktiviert den direkten Zugriff auf Hive-Metastores aus dem Arbeitsbereich. Sie können jedoch weiterhin über den Hive-Metastore-Partnerverbund auf einen Hive-Metastore zugreifen.

  • Deaktiviert den Fallbackmodus für den Zugriff auf externe Speicherorte aus dem Arbeitsbereich.

  • Deaktiviert Databricks-Runtime-Versionen vor 13.3 LTS.

  • delete – Legacy-Zugriffsdeaktivierungsstatus löschen

  • get – Abrufen des Deaktivierungsstatus des Legacyzugriffs

  • update – Status der Deaktivierung des Legacy-Zugriffs aktualisieren

Options

Globale Kennzeichnungen

Examples

databricks settings disable-legacy-access get
databricks settings disable-legacy-access update --json '{"disable_legacy_access": {"disabled": true}}'

Databricks-Einstellungen: Export-Notebook aktivieren

Steuert, ob Benutzer Notizbücher und Dateien aus der Arbeitsbereichs-Benutzeroberfläche exportieren können. Diese Einstellung ist standardmäßig aktiviert.

  • get-enable-export-notebook – Abrufen der Notizbuch- und Dateiexporteinstellung
  • patch-enable-export-notebook – Aktualisieren der Einstellung für den Notizbuch- und Dateiexport

Options

Globale Kennzeichnungen

Examples

databricks settings enable-export-notebook get-enable-export-notebook
databricks settings enable-export-notebook patch-enable-export-notebook --json '{"allow_missing": true, "setting": {"enabled": false}}'

Databricks-Einstellungen enable-notebook-table-clipboard

Steuert, ob Benutzer tabellarische Daten über die Benutzeroberfläche in die Zwischenablage kopieren können. Diese Einstellung ist standardmäßig aktiviert.

  • get-enable-notebook-table-clipboard – Einstellung der Zwischenablagenfeatures für die Ergebnistabellen abrufen
  • patch-enable-notebook-table-clipboard – Die Einstellung für die Zwischenablagefunktionen der Ergebnistabelle aktualisieren

Options

Globale Kennzeichnungen

Examples

databricks settings enable-notebook-table-clipboard get-enable-notebook-table-clipboard
databricks settings enable-notebook-table-clipboard patch-enable-notebook-table-clipboard --json '{"allow_missing": true, "setting": {"enabled": false}}'

Databricks-Einstellungen ermöglichen Ergebnisherunterladung

Steuert, ob Benutzer Notizbuchergebnisse herunterladen können. Diese Einstellung ist standardmäßig aktiviert.

  • get-enable-results-downloading – Downloadeinstellung für Notebook-Ergebnisse abrufen
  • patch-enable-results-downloading – Aktualisieren der Downloadeinstellung für Notizbuchergebnisse

Options

Globale Kennzeichnungen

Examples

databricks settings enable-results-downloading get-enable-results-downloading
databricks settings enable-results-downloading patch-enable-results-downloading --json '{"allow_missing": true, "setting": {"enabled": false}}'

databricks-Einstellungen erweiterte Sicherheitsüberwachung

Steuert, ob die erweiterte Sicherheitsüberwachung für den aktuellen Arbeitsbereich aktiviert ist. Wenn das Compliancesicherheitsprofil aktiviert ist, wird dies automatisch aktiviert. Standardmäßig ist sie deaktiviert. Wenn das Compliancesicherheitsprofil jedoch aktiviert ist, wird dies automatisch aktiviert.

Wenn das Compliancesicherheitsprofil deaktiviert ist, können Sie diese Einstellung aktivieren oder deaktivieren, und es ist nicht dauerhaft.

  • get – Die Einstellung für die erweiterte Sicherheitsüberwachung abrufen
  • update – Aktualisieren der Einstellung für die erweiterte Sicherheitsüberwachung

Options

Globale Kennzeichnungen

Examples

databricks settings enhanced-security-monitoring get
databricks settings enhanced-security-monitoring update --json '{"enhanced_security_monitoring": {"enabled": true}}'

Databricks-Einstellungen Arbeitsbereich-Administratoren einschränken

Mit der Einstellung "Arbeitsbereichsadministratoren einschränken" können Sie die Funktionen von Arbeitsbereichsadministratoren steuern. Wenn als Einstellungsstatus ALLOW_ALL eingestellt ist, können Arbeitsbereichsadministratoren persönliche Dienstprinzipal-Zugriffstoken für beliebige Dienstprinzipale in ihrem Arbeitsbereich erstellen. Arbeitsbereichsadministratoren können außerdem beliebige Benutzer in ihrem Arbeitsbereich zum Auftragseigentümer ernennen. Und sie können die Einstellung run_as des Auftrags für jeden Benutzer in ihrem Arbeitsbereich oder in einen Dienstprinzipal ändern, für den sie über die Rolle „Dienstprinzipalbenutzer“ verfügen.

Wenn der Einstellungsstatus auf RESTRICT_TOKENS_AND_JOB_RUN_AS festgelegt ist, können Arbeitsbereichsadministratoren nur persönliche Zugriffstokens für Dienstprinzipale erstellen, für die sie die Rolle des Dienstprinzipalbenutzers haben. Zudem können Sie sich selbst zum Jobbesitzer machen. Und sie können die Jobeinstellung run_as für sich oder einen Dienstprinzipal ändern, für den sie die Rolle „Dienstprinzipalbenutzer“ haben.

  • delete – Löschen der Einstellung "Arbeitsbereichadministratoren einschränken"
  • get – Einstellung "Einschränken der Admins im Arbeitsbereich" abrufen
  • update – Aktualisieren der Einstellung "Arbeitsbereichsadministratoren einschränken"

Options

Globale Kennzeichnungen

Examples

databricks settings restrict-workspace-admins get
databricks settings restrict-workspace-admins update --json '{"restrict_workspace_admins": {"status": "RESTRICT_TOKENS_AND_JOB_RUN_AS"}}'
databricks settings restrict-workspace-admins delete

Databricks-Einstellungen SQL-Ergebnisse herunterladen

Steuert, ob Benutzer innerhalb des Arbeitsbereichs Ergebnisse aus dem SQL-Editor und AI/BI-Dashboards-UIs herunterladen dürfen. Diese Einstellung ist standardmäßig aktiviert (auf "true" festgelegt).

  • delete – Löschen der DOWNLOAD-Einstellung für SQL-Ergebnisse
  • get – Abrufen der Einstellung zum Herunterladen von SQL-Ergebnissen
  • update – Aktualisieren der Einstellung zum Herunterladen von SQL-Ergebnissen

Options

Globale Kennzeichnungen

Examples

databricks settings sql-results-download get
databricks settings sql-results-download update --json '{"sql_results_download": {"enabled": false}}'
databricks settings sql-results-download delete

Globale Kennzeichnungen

--debug

  Gibt an, ob die Debugprotokollierung aktiviert werden soll.

-h oder --help

    Hilfe für die Databricks CLI oder die zugehörige Befehlsgruppe oder den zugehörigen Befehl anzeigen.

--log-file Schnur

    Eine Zeichenfolge, die die Datei darstellt, in die Ausgabeprotokolle geschrieben werden sollen. Wenn dieses Flag nicht angegeben ist, werden Ausgabeprotokolle standardmäßig in stderr geschrieben.

--log-format Format

    Der Protokollformattyp text oder json. Der Standardwert ist text.

--log-level Schnur

    Eine Zeichenfolge, die die Protokollformatebene darstellt. Wenn nicht angegeben, ist die Protokollformatebene deaktiviert.

-o, --output Typ

    Der Befehlsausgabetyp text oder json. Der Standardwert ist text.

-p, --profile Schnur

    Der Name des Profils in der ~/.databrickscfg Datei, das zum Ausführen des Befehls verwendet werden soll. Wenn dieses Flag nicht angegeben ist, aber existiert, wird das Profil DEFAULT verwendet.

--progress-format Format

    Das Format zum Anzeigen von Statusprotokollen: default, , append, inplaceoder json

-t, --target Schnur

    Falls zutreffend, das zu verwendende Bündelziel