groupe de commandessettings

remarque

L'utilisation de Databricks CLI est soumise à la licence Databricks et à la politique de confidentialité Databricks, y compris toutes les dispositions relatives aux données d'utilisation.

Le groupe de commandes settings au sein de la CLI Databricks contient des commandes qui gèrent les paramètres au niveau du Workspace, qui contrôlent diverses fonctionnalités et politiques applicables à l'ensemble du Workspace. Consultez Gérer votre Workspace.

databricks settings aibi-dashboard-embedding-access-policy

Contrôle si l'intégration de tableaux de bord publiés AI/BI est activée, activée sous condition ou désactivée au niveau du workspace. Par default, ce paramètre est activé sous condition (ALLOW_APPROVED_DOMAINS).

• delete - Supprimer la politique d'accès d'intégration du AI/BI dashboard
• get - Récupérer la politique d'accès pour l'intégration du AI/BI dashboard
• update - Mettre à jour la politique d’accès d’intégration du AI/BI dashboard

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

Récupérer la politique d'accès intégrée à l'AI/BI dashboard. Le réglage default est ALLOW_APPROVED_DOMAINS, ce qui permet d'intégrer des tableaux de bord AI/BI sur des domaines approuvés.

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

Options

--etag string

etag utilisé pour le contrôle de version.

Indicateurs globaux

Exemples

Bash

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

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

Mettre à jour la politique d'accès intégrée au AI/BI dashboard au niveau du workspace.

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

Options

--json JSON

La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Exemples

Bash

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

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

Supprimez la politique d'accès d'intégration du AI/BI dashboard, en rétablissant le default.

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

Options

--etag string

etag utilisé pour le contrôle de version.

Indicateurs globaux

Exemples

Bash

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

Paramètres Databricks aibi-dashboard-embedding-approved-domains

Contrôle la liste des domaines approuvés pour héberger les tableaux de bord AI/BI intégrés. La liste des domaines approuvés ne peut pas être modifiée lorsque la politique d'accès actuelle n'est pas définie sur ALLOW_APPROVED_DOMAINS.

• delete - Supprimez les domaines approuvés pour l'intégration des AI/BI dashboard
• get - Récupérez la liste des domaines approuvés pour héberger les tableaux de bord AI/BI intégrés.
• update - Mettre à jour la liste des domaines approuvés pour héberger les tableaux de bord AI/BI intégrés

Options

Indicateurs globaux

Exemples

Bash

databricks settings aibi-dashboard-embedding-approved-domains get

Bash

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

paramètres databricks de mise à jour automatique du cluster

Contrôle si la mise à jour automatique des clusters est activée pour le workspace actuel. Par default, il est désactivé.

• get - Obtenez le paramètre de mise à jour automatique des clusters
• update – Mettre à jour le paramètre de mise à jour automatique des clusters

Options

Indicateurs globaux

databricks settings automatic-cluster-update get

Obtient le paramètre de mise à jour automatique du cluster.

databricks settings automatic-cluster-update get [flags]

Options

--etag string

etag utilisé pour le contrôle de version.

Indicateurs globaux

Exemples

Bash

databricks settings automatic-cluster-update get

databricks settings automatic-cluster-update update

Met à jour le paramètre de mise à jour automatique du cluster pour le workspace. Une nouvelle balise ETag doit être fournie dans les demandes de mise à jour (dans le cadre du champ de paramétrage). L'etag peut être récupéré en effectuant une demande GET avant la demande de mise à jour.

databricks settings automatic-cluster-update update [flags]

Options

--json JSON

La chaîne JSON en ligne ou le @chemin vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Exemples

Bash

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

databricks settings conformité-security-profile

Permet de contrôler l'activation du profil de sécurité de conformité pour le workspace actuel. L’activer sur un workspace est permanent. Par default, elle est désactivée.

attention

Ce paramètre ne peut pas être désactivé une fois qu'il est activé.

• get - Obtenez le paramètre du profil de sécurité de la conformité
• update - Mettre à jour le paramètre du profil de sécurité de conformité

Options

Indicateurs globaux

Exemples

Bash

databricks settings compliance-security-profile get

Bash

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

databricks settings dashboard-e-mail-subscriptions

Définit si les planifications ou les tâches de charge de travail pour l'actualisation des tableaux de bord AI/BI dans le Workspace peuvent envoyer des e-mails d'abonnement contenant des PDF et/ou des images du tableau de bord. default, ce paramètre est activé (défini sur vrai).

• delete - Supprimer le paramètre des abonnements aux e-mails du tableau de bord
• get - Obtenir le paramètre d'abonnements aux e-mails du tableau de bord
• update - Mettre à jour le paramètre d'abonnements par e-mail du tableau de bord

Options

Indicateurs globaux

Exemples

Bash

databricks settings dashboard-email-subscriptions get

Bash

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

databricks settings default-namespace

Configurez l'espace de noms default pour un Workspace Databricks.

Grâce à cette commande, les utilisateurs peuvent récupérer, définir ou modifier l'espace de noms default utilisé lorsque les queries ne font pas référence à un nom complet à trois niveaux. Par exemple, si vous utilisez l'API pour définir retail_prod comme catalogue default, alors une query SELECT * FROM myTable ferait référence à l'objet retail_prod.default.myTable (le schéma default est toujours supposé).

remarque

Ce paramètre nécessite un redémarrage des clusters et des SQL Warehouse pour prendre effet. De plus, l'espace de noms default ne s'applique que lors de l'utilisation d'un compute compatible avec Unity Catalog.

• delete - Supprimez le paramètre d'espace de noms par default.
• get - Obtenir le paramètre d'espace de noms default
• update - Mettez à jour le paramètre de namespace par default

Options

Indicateurs globaux

Exemples

Bash

databricks settings default-namespace get

Bash

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

Bash

databricks settings default-namespace delete

databricks settings désactiver l'accès hérité

La désactivation de l’accès hérité a les conséquences suivantes :

• Désactive l'accès direct aux Hive Metastores depuis le workspace. Cependant, vous pouvez toujours accéder à un Hive Metastore via la fédération Hive Metastore.

• Désactive le mode fallback sur l'accès aux emplacements externes depuis le workspace.

• Désactive les versions de Databricks Runtime antérieures à 13.3 LTS.

• delete - Supprimer l'état de désactivation de l'accès hérité

• get - Récupérer l'état de désactivation de l'accès hérité

• update – Mise à jour du statut de désactivation de l'accès hérité

Options

Indicateurs globaux

Exemples

Bash

databricks settings disable-legacy-access get

Bash

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

databricks settings pour activer l'exportation de Notebook

Contrôle si les utilisateurs peuvent exporter des Notebooks et des fichiers depuis l'interface utilisateur du Workspace. Par default, ce paramètre est activé.

• get-enable-export-notebook - Obtenir le paramètre d'exportation de notebook et de fichier
• patch-enable-export-notebook - Mettre à jour le paramètre d'exportation des Notebook et des fichiers

Options

Indicateurs globaux

Exemples

Bash

databricks settings enable-export-notebook get-enable-export-notebook

Bash

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

databricks settings enable-notebook-table-clipboard

Contrôle si les utilisateurs peuvent copier des données tabulaires dans le presse-papiers via l'interface utilisateur. Par default, ce paramètre est activé.

• get-enable-notebook-table-clipboard - Obtenir le paramètre des fonctionnalités du presse-papiers de la table des résultats
• patch-enable-notebook-table-clipboard - Mettre à jour le paramètre des fonctionnalités du presse-papiers de la table des résultats

Options

Indicateurs globaux

Exemples

Bash

databricks settings enable-notebook-table-clipboard get-enable-notebook-table-clipboard

Bash

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

Paramètres Databricks pour activer le download des résultats

Contrôle si les utilisateurs peuvent download les résultats de notebook. Par default, ce paramètre est activé.

• get-enable-results-downloading - Obtenir le paramètre de download des résultats du notebook
• patch-enable-results-downloading - Mettre à jour le paramètre de download des résultats du Notebook

Options

Indicateurs globaux

Exemples

Bash

databricks settings enable-results-downloading get-enable-results-downloading

Bash

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

paramètres databricks monitoring de sécurité amélioré

Contrôle si le monitoring de sécurité renforcée est activé pour le Workspace actuel. Si le profil de sécurité de la conformité est activé, cela est activé automatiquement. Par **default**, il est désactivé. Toutefois, si le profil de sécurité de conformité est activé, celui-ci est automatiquement activé.

Si le profil de sécurité de conformité est désactivé, vous pouvez activer ou désactiver ce paramètre et il n'est pas permanent.

• get - Obtenir le paramètre de monitoring de sécurité renforcé
• update - Mettre à jour le paramètre de monitoring de sécurité améliorée

Options

Indicateurs globaux

Exemples

Bash

databricks settings enhanced-security-monitoring get

Bash

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

paramètres Databricks restreindre les administrateurs de workspace

Le paramètre Restreindre les administrateurs de Workspace vous permet de contrôler les capacités des administrateurs de Workspace. Lorsque le statut du paramètre est défini sur ALLOW_ALL, les administrateurs de Workspace peuvent créer des jetons d'accès personnels de Service Principal au nom de n'importe quel Service Principal dans leur workspace. Les administrateurs de Workspace peuvent également changer le propriétaire d'un job et le définir sur n'importe quel utilisateur dans leur workspace. Et ils peuvent modifier le paramètre run_as du job pour n'importe quel utilisateur de leur workspace ou pour un Service Principal sur lequel ils ont le rôle d'utilisateur de Service Principal.

Lorsque l'état du paramètre est défini sur RESTRICT_TOKENS_AND_JOB_RUN_AS, les administrateurs de workspace peuvent uniquement créer des jetons d'accès personnel au nom des services principaux pour lesquels ils ont le rôle d'utilisateur de service principal. Ils ne peuvent également modifier le propriétaire d'un job que pour eux-mêmes. Et ils peuvent modifier le paramètre run_as du job pour eux-mêmes ou pour un service principal pour lequel ils ont le rôle d'utilisateur de service principal.

• delete - Supprimez le paramètre de restriction des administrateurs du Workspace
• get – Obtenir le paramètre de restriction des administrateurs Workspace
• update - Mettre à jour le paramètre de restriction des administrateurs Workspace

Options

Indicateurs globaux

Exemples

Bash

databricks settings restrict-workspace-admins get

Bash

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

Bash

databricks settings restrict-workspace-admins delete

paramètres databricks download-résultats-sql

Contrôle si les utilisateurs du Workspace sont autorisés à download les résultats des interfaces utilisateur de l'éditeur SQL et des tableaux de bord AI/BI. default, ce paramètre est activé (défini sur vrai).

• delete - Supprimer le paramètre de download des résultats SQL
• get - Obtenir le paramètre de download des résultats SQL
• update - Mettre à jour le paramètre de download des résultats SQL

Options

Indicateurs globaux

Exemples

Bash

databricks settings sql-results-download get

Bash

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

Bash

databricks settings sql-results-download delete

Drapeaux globaux

--debug

Activer ou non la journalisation de débogage.

-h OU --help

Afficher l'aide de Databricks CLI ou du groupe de commandes associé ou de la commande associée.

--log-file chaîne

Une chaîne représentant le fichier dans lequel écrire les logs de sortie. Si cet indicateur n'est pas spécifié, la default est d'écrire les logs de sortie dans stderr.

--log-format Format

Le type de format de log, text ou json. La valeur par default est text.

--log-level chaîne

Une chaîne représentant le niveau de format du log. S'il n'est pas spécifié, le niveau de format du log est désactivé.

-o, --output Type

Le type de sortie de commande, text ou json. La valeur par default est text.

-p, --profile chaîne

Nom du profil dans le fichier ~/.databrickscfg à utiliser pour exécuter la commande. Si cet indicateur n'est pas spécifié, alors s'il existe, le profil nommé DEFAULT est utilisé.

--progress-format Format

Le format pour afficher les logs de progression : default, append, inplace ou json

-t, --target chaîne

Le cas échéant, la cible de bundle à utiliser