Partager via

settings groupe de commande

Note

Ces informations s’appliquent à Databricks CLI versions 0.205 et ultérieures. L’interface CLI Databricks est en préversion publique.

L’utilisation de l’interface CLI Databricks est soumise à la licence Databricks et à la notification de confidentialité Databricks, y compris les dispositions relatives aux données d’utilisation.

Le settings groupe de commandes dans l’interface CLI Databricks contient des commandes qui gèrent les paramètres au niveau de l’espace de travail, qui contrôlent diverses fonctionnalités et stratégies qui s’appliquent à l’ensemble de l’espace de travail. Consultez pour gérer votre espace de travail.

paramètres databricks politique-d'accès-au-tableau-de-bord-aibi-d'intégration

Détermine si l’incorporation de tableaux de bord publiée par IA/BI est activée, activée conditionnellement ou désactivée au niveau de l’espace de travail. Par défaut, ce paramètre est activé de manière conditionnelle (ALLOW_APPROVED_DOMAINS).

  • delete - Supprimer la stratégie d’accès incorporée au tableau de bord IA/BI
  • get - Récupérer la stratégie d’accès incorporée au tableau de bord IA/BI
  • update - Mettre à jour la stratégie d’accès incorporée au tableau de bord IA/BI

paramètres databricks aibi-dashboard-embedding-access-policy get

Récupérez la stratégie d’accès incorporée au tableau de bord IA/BI. Le paramètre par défaut est ALLOW_APPROVED_DOMAINS, ce qui permet aux tableaux de bord IA/BI d’être incorporés 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

Examples

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

Paramètres de Databricks mise à jour de la politique d'accès de l'intégration du tableau de bord aibi

Mettez à jour la stratégie d’accès incorporée au tableau de bord IA/BI au niveau de l’espace de travail.

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

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

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

paramètres databricks supprimer aibi-dashboard-embedding-access-policy

Supprimez la stratégie d’accès incorporée au tableau de bord IA/BI, rétablissant la valeur par défaut.

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

Options

--etag string

    etag utilisé pour le contrôle de version.

Indicateurs globaux

Examples

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

paramètres databricks des domaines approuvés pour l'intégration du tableau de bord aibi

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

  • delete - Supprimer le tableau de bord IA/BI qui incorpore des domaines approuvés
  • get - Récupérer la liste des domaines approuvés pour héberger des tableaux de bord IA/BI incorporés
  • update - Mettre à jour la liste des domaines approuvés pour héberger des tableaux de bord IA/BI incorporés

Options

Indicateurs globaux

Examples

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

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

Paramètres de mise à jour automatique des clusters dans Databricks

Contrôle si la mise à jour automatique du cluster est activée pour l’espace de travail actuel. Ce paramètre est activé par défaut.

  • get - Obtenir le paramètre de mise à jour automatique du cluster
  • update - Mettre à jour le paramètre de mise à jour automatique du cluster

Options

Indicateurs globaux

paramètres de databricks get update-auto-cluster

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

Examples

databricks settings automatic-cluster-update get

paramètres de databricks automatic-cluster-update mise à jour

Met à jour le paramètre de mise à jour automatique du cluster pour l’espace de travail. Un nouvel ETag doit être fourni dans les demandes de mise à jour (dans le cadre du champ de configuration). L’etag peut être récupéré en effectuant une demande d’obtention avant la demande de mise à jour.

databricks settings automatic-cluster-update update [flags]

Options

--json JSON

    Chaîne JSON inline ou chemin @path vers le fichier JSON avec le corps de la requête.

Indicateurs globaux

Examples

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

paramètres de conformité de sécurité de Databricks

Détermine s’il faut activer le profil de sécurité de conformité pour l’espace de travail actuel. L’activation sur un espace de travail est définitive. Ce paramètre est activé par défaut.

Warning

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

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

Options

Indicateurs globaux

Examples

databricks settings compliance-security-profile get

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

paramètres databricks tableau de bord - abonnements aux e-mails

Détermine si des planifications ou des tâches de charge de travail pour actualiser les tableaux de bord IA/BI dans l’espace de travail peuvent envoyer des e-mails d’abonnement contenant des fichiers PDF et/ou des images du tableau de bord. Par défaut, ce paramètre est activé (défini sur true).

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

Options

Indicateurs globaux

Examples

databricks settings dashboard-email-subscriptions get

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

paramètres databricks default-namespace

Configurez l’espace de noms par défaut pour un espace de travail Databricks.

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

Note

Ce paramètre nécessite un redémarrage des clusters et des entrepôts SQL pour prendre effet. En outre, l'espace de noms par défaut ne s'applique que lorsque vous utilisez un environnement de calcul compatible avec le catalogue Unity.

  • delete - Supprimer le paramètre d’espace de noms par défaut
  • get - Obtenir le paramètre d’espace de noms par défaut
  • update - Mettre à jour le paramètre d’espace de noms par défaut

Options

Indicateurs globaux

Examples

databricks settings default-namespace get

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

databricks settings default-namespace delete

Paramètres Databricks pour disable-legacy-access

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

  • Désactive l’accès direct aux metastores Hive à partir de l’espace de travail. Toutefois, vous pouvez toujours accéder à un metastore Hive via la fédération du metastore Hive.

  • Désactive le mode de repli pour l’accès à un emplacement externe depuis l’espace de travail.

  • Désactive les versions 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 ancien

  • update - Mettre à jour l’état de désactivation de l’accès ancien

Options

Indicateurs globaux

Examples

databricks settings disable-legacy-access get

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

paramètres Databricks activer-exporter-notebook

Contrôle si les utilisateurs peuvent exporter des blocs-notes et des fichiers à partir de l’interface utilisateur de l’espace de travail. Par défaut, ce paramètre est activé.

  • get-enable-export-notebook - Obtenez les paramètres d'exportation pour le notebook et le fichier
  • patch-enable-export-notebook - Mettre à jour les paramètres d’exportation du notebook et des fichiers

Options

Indicateurs globaux

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

paramètres Databricks activer-tableau-notebook-presse-papiers

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

  • get-enable-notebook-table-clipboard - Obtenir l’état du paramètre lié à la copie de tables des résultats dans le presse-papiers
  • patch-enable-notebook-table-clipboard - Mettre à jour les paramètres des fonctions de copier-coller des résultats

Options

Indicateurs globaux

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

paramètres databricks activer-téléchargement-des-résultats

Détermine si les utilisateurs peuvent télécharger les résultats du notebook. Par défaut, ce paramètre est activé.

  • get-enable-results-downloading - Obtenir l’état du paramètre de téléchargement des résultats de notebook
  • patch-enable-results-downloading - Mettre à jour le paramètre de téléchargement des résultats du bloc-notes

Options

Indicateurs globaux

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 paramètres surveillance-de-sécurité-améliorée

Détermine si la surveillance améliorée de la sécurité est activée pour l’espace de travail actuel. Si le profil de sécurité de conformité est activé, celui-ci est automatiquement activé. Par défaut, elle est désactivée. 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 ce paramètre n’est pas permanent.

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

Options

Indicateurs globaux

Examples

databricks settings enhanced-security-monitoring get

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

paramètres Databricks pour restreindre les administrateurs de l’espace de travail

Le paramètre Restreindre les administrateurs d’espace de travail vous permet de contrôler les fonctionnalités des administrateurs d’espace de travail. Avec l’état du paramètre défini sur ALLOW_ALL, les administrateurs de l’espace de travail peuvent créer des jetons d’accès personnels pour le principal de service au nom de n’importe quel principal de service dans leur espace de travail. Les administrateurs d’espace de travail peuvent également modifier un propriétaire de travail en n’importe quel utilisateur de son espace de travail. Et ils peuvent modifier le paramètre du travail run_as pour n’importe quel utilisateur de leur espace de travail ou pour un principal de service pour lequel ils ont le rôle de Service Principal User.

Avec l’état du paramètre défini sur RESTRICT_TOKENS_AND_JOB_RUN_AS, les administrateurs de l’espace de travail peuvent uniquement créer des jetons d’accès personnels pour le compte des principaux de service pour lesquels ils ont le rôle d'utilisateur principal de service. Ils ne peuvent également modifier le propriétaire d’un travail que sur eux-mêmes. De même, ils ne peuvent modifier le paramètre run_as d’un travail que pour eux-mêmes ou pour un principal de service sur lequel ils ont le rôle Utilisateur du principal de service.

  • delete - Supprimer le paramètre restreindre les administrateurs de l’espace de travail
  • get - Obtenir le paramètre restreindre les administrateurs de l’espace de travail
  • update - Mettre à jour le paramètre restreindre les administrateurs de l’espace de travail

Options

Indicateurs globaux

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

paramètres databricks téléchargement-des-résultats-sql

Contrôle si les utilisateurs de l’espace de travail sont autorisés à télécharger les résultats à partir de l’éditeur SQL et des interfaces utilisateur des tableaux de bord AI/BI. Par défaut, ce paramètre est activé (défini sur true).

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

Options

Indicateurs globaux

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

Indicateurs globaux

--debug

  Active la journalisation du débogage.

-h ou --help

    Affiche l’aide pour l’interface CLI de Databricks, le groupe de commandes associé ou la commande concernée.

--log-file chaîne

    Chaîne représentant le fichier dans lequel écrire les journaux de sortie. Si cet indicateur n’est pas défini, les journaux de sortie sont écrits par défaut dans stderr.

--log-format format

    Format des journaux : text ou json. La valeur par défaut est text.

--log-level chaîne

    Chaîne représentant le niveau de journalisation. Si cet indicateur n’est pas défini, le niveau de format de journal est désactivé.

Type -o, --output

    Type de sortie de commande, text ou json. La valeur par défaut est text.

-p, --profile chaîne

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

--progress-format format

    Format d’affichage des journaux d’activité de progression : default, append, inplace ou json

-t, --target chaîne

    Le cas échéant, la cible d’offre groupée à utiliser

  • Last updated on