settings
grupo de comando
Esta informação se aplica a Databricks CLI versões 0.205 e acima. A CLI do Databricks está em pré-visualização pública.
Databricks CLI O uso está sujeito à LicençaDatabricks e à Política de PrivacidadeDatabricks, incluindo qualquer disposição sobre Dados de Uso.
O grupo de comandos settings
dentro do Databricks CLI workspacecontém as configurações de nível do comando gerenciar recursos, que controlam vários recursos e políticas que se aplicam a todo o workspace. Consulte gerenciar o seu workspace.
configurações de databricks aibi-dashboard-embedding-access-policy
Controla se a incorporação de painéis publicados no AI/BI está ativada, ativada condicionalmente ou desativada no nível workspace. Por meio de default, essa configuração está habilitada condicionalmente (ALLOW_APPROVED_DOMAINS
).
delete
- Exclua a política de acesso de incorporação AI/BI dashboardget
- Recuperar a política de acesso de incorporação AI/BI dashboardupdate
- Atualize a política de acesso à incorporação do AI/BI dashboard
configurações do databricks aibi-dashboard-embedding-access-policy get
Recuperar a política de acesso de incorporação do AI/BI dashboard. A configuração " default " é " ALLOW_APPROVED_DOMAINS
", permitindo que painéis AI/BI sejam incorporados em domínios aprovados.
databricks settings aibi-dashboard-embedding-access-policy get [flags]
Opções
--etag string
etag usada para controle de versão.
Exemplos
databricks settings aibi-dashboard-embedding-access-policy get
configurações do databricks aibi-dashboard-embedding-access-policy update
Atualize a política de acesso de incorporação do AI/BI dashboard no nível workspace.
databricks settings aibi-dashboard-embedding-access-policy update [flags]
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
databricks settings aibi-dashboard-embedding-access-policy update --json '{"access_policy": "ALLOW_ALL"}'
configurações de databricks aibi-dashboard-embedding-access-policy delete
Exclua a política de acesso de incorporação AI/BI dashboard, revertendo para default.
databricks settings aibi-dashboard-embedding-access-policy delete [flags]
Opções
--etag string
etag usada para controle de versão.
Exemplos
databricks settings aibi-dashboard-embedding-access-policy delete
configurações de databricks aibi-dashboard-embedding-approved-domains
Controla a lista de domínios aprovados para hospedar os painéis incorporados do AI/BI. A lista de domínios aprovados não pode ser alterada quando a política de acesso atual não está definida como ALLOW_APPROVED_DOMAINS
.
delete
- Excluir domínios aprovados para incorporação de AI/BI dashboardget
- Recuperar a lista de domínios aprovados para hospedar painéis incorporados do AI/BIupdate
- Atualizar a lista de domínios aprovados para hospedar painéis incorporados do AI/BI
Opções
Exemplos
databricks settings aibi-dashboard-embedding-approved-domains get
databricks settings aibi-dashboard-embedding-approved-domains update --json '{"approved_domains": ["example.com", "mydomain.org"]}'
configurações do databricks atualização automática do agrupamento
Controla se a atualização automática de agrupamento está ativada para o atual workspace. Por default, está desativado.
get
- Obter a configuração de atualização automática de agrupamentoupdate
- Atualize a configuração de atualização automática do agrupamento.
Opções
configurações do databricks atualização automática de agrupamento obter
Obtém a configuração de atualização automática do agrupamento.
databricks settings automatic-cluster-update get [flags]
Opções
--etag string
etag usada para controle de versão.
Exemplos
databricks settings automatic-cluster-update get
configurações do databricks atualização automática do agrupamento em cluster atualização
Atualiza a configuração de atualização automática de agrupamento para o workspace. Uma nova etag precisa ser fornecida nas solicitações de atualização (como parte do campo de configuração). A etag pode ser recuperada fazendo uma solicitação get antes da solicitação de atualização.
databricks settings automatic-cluster-update update [flags]
Opções
--json JSON
As cadeias de caracteres JSON ou o caminho @path para o arquivo JSON com o corpo da solicitação.
Exemplos
databricks settings automatic-cluster-update update --json '{"automatic_cluster_update": {"enabled": true}}'
Configurações do Databricks compliance-security-profile
Controla se o perfil de segurança compliance deve ser ativado para o workspace atual. workspace A ativação em um dispositivo com o sistema operacional Android (versão 4.4 e superior) é permanente. Por default, está desativado.
Essa configuração NÃO pode ser desativada depois de ativada.
get
- Obtenha a configuração do perfil de segurança “ compliance ”update
- Atualize a configuração do perfil de segurança “ compliance ” (Protecção contra malware e atualização de segurança).
Opções
Exemplos
databricks settings compliance-security-profile get
databricks settings compliance-security-profile update --json '{"compliance_security_profile": {"enabled": true}}'
Painel de configurações do Databricks -email-inscrição
Controla se a tarefa programada ou a carga de trabalho para atualizar os painéis do AI/BI no workspace pode enviar um e-mail de inscrição contendo PDFs e/ou imagens do painel. Por meio de default, essa configuração está ativada (definida como verdadeira).
delete
- Exclua a configuração de inscrição do painel emailget
- Obtenha o painel de controle email inscrição settingupdate
- Atualize a configuração de inscrição no painel de controle email
Opções
Exemplos
databricks settings dashboard-email-subscriptions get
databricks settings dashboard-email-subscriptions update --json '{"dashboard_email_subscriptions": {"enabled": false}}'
Configurações do Databricks default-namespace
Configure o namespace default para um Databricks workspace.
Através deste comando, os usuários podem recuperar, definir ou modificar o namespace default utilizado quando as consultas não fazem referência a um nome totalmente qualificado de três níveis. Por exemplo, se você usar o API para definir retail_prod
como o catálogo default, uma consulta SELECT * FROM myTable
faria referência ao objeto retail_prod.default.myTable
(o esquema default
é sempre assumido).
Esta configuração requer uma reinicialização do clustering e do armazenamento de dados do SQL para que tenha efeito. Além disso, o namespace default só se aplica ao utilizar o compute habilitado para o Unity Catalog.
delete
- Exclua a configuração do namespace defaultget
- Obter a configuração do namespace defaultupdate
- Atualize a configuração do namespace default
Opções
Exemplos
databricks settings default-namespace get
databricks settings default-namespace update --json '{"namespace": {"value": "retail_prod"}}'
databricks settings default-namespace delete
configurações do databricks disable-legacy-access
A desativação do acesso legado tem os seguintes impactos:
-
Desativa o acesso direto aos Metastores Hive a partir do workspace. No entanto, ainda é possível acessar um Hive metastore através da federação Hive metastore.
-
Desativa o modo “ fallback ” no acesso a locais externos a partir do “ workspace”.
-
Desativa as versões do Databricks Runtime anteriores à 13.3 LTS.
-
delete
- Excluir o status de desativação do acesso legado -
get
- Recupere o status de desativação do acesso legado -
update
- Atualizar o status de desativação do acesso legado
Opções
Exemplos
databricks settings disable-legacy-access get
databricks settings disable-legacy-access update --json '{"disable_legacy_access": {"disabled": true}}'
Configurações do Databricks: habilitar exportação do Notebook
Controla se os usuários podem exportar o Notebook e os arquivos da interface do usuário da área de trabalho. Por meio de default, esta configuração está ativada.
get-enable-export-notebook
- Obter o Notebook e as configurações de exportação de arquivospatch-enable-export-notebook
- Atualize as configurações de exportação do Notebook e dos arquivos.
Opções
Exemplos
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}}'
configurações do databricks habilitar-Notebook-tabela-area de transferência
Controla se os usuários podem copiar dados tabulares para a área de transferência por meio da interface do usuário. Por meio de default, essa configuração está ativada.
get-enable-notebook-table-clipboard
- Obter a configuração do recurso de copiar a tabela de resultados para a área de transferênciapatch-enable-notebook-table-clipboard
- Atualizar a configuração do recurso da área de transferência da tabela de resultados
Opções
Exemplos
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}}'
configurações do databricks habilitar-downloads-de-resultados
Controla se os usuários podem download resultados do Notebook. Por meio de default, esta configuração está ativada.
get-enable-results-downloading
- Obter os resultados do Notebook na configuraçã downloadpatch-enable-results-downloading
- Atualize os resultados do Notebook na configuraçã download.
Opções
Exemplos
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}}'
Configurações do Databricks - monitoramento de segurança aprimorado
Controla se o monitoramento de segurança aprimorado está habilitado para o workspace atual. Se o perfil de segurança compliance estiver ativado, esta opção será ativada automaticamente. Por default, está desativado. No entanto, se o perfil de segurança compliance estiver ativado, esta opção será ativada automaticamente.
Se o perfil de segurança “ compliance ” estiver desativado, é possível ativar ou desativar essa configuração, e ela não será permanente.
get
- Obtenha a configuração de monitoramento de segurança aprimoradoupdate
- Atualize a configuração de monitoramento de segurança aprimorado.
Opções
Exemplos
databricks settings enhanced-security-monitoring get
databricks settings enhanced-security-monitoring update --json '{"enhanced_security_monitoring": {"enabled": true}}'
workspaceAs configurações do Databricks restringem o acesso aos administradores do Databricks. Para permitir o acesso a todos os usuários, altere o
A configuração Restringir administradores do espaço de trabalho permite controlar os recursos dos administradores d workspace. Com a configuração definida como “ ALLOW_ALL
”, os administradores de workspace podem criar uma conta de acesso personalizado de entidade de serviço tokens em nome de qualquer entidade de serviço em seu workspace. Os administradores do espaço de trabalho também podem alterar o proprietário de uma tarefa para qualquer usuário em seu workspace. Eles podem alterar a configuração “ run_as
” (usuário de serviço) da tarefa para qualquer usuário em “ workspace ” (usuários de serviço) ou para uma entidade de serviço na qual eles tenham a função de usuário de serviço.
Com a configuração definida como “ RESTRICT_TOKENS_AND_JOB_RUN_AS
”, os administradores de workspace só podem criar acessos pessoais tokens em nome da entidade de serviço na qual possuem a função de usuário da entidade de serviço. Eles também só podem alterar o proprietário de uma tarefa para si mesmos. Eles podem alterar a configuração do trabalho run_as
para si mesmos ou para uma entidade de serviço na qual possuem a função de usuário da entidade de serviço.
delete
- Remova a configuração de restrição de administradores workspace.get
- Obter a configuração de restrição para administradores do workspaceupdate
- Atualize a configuração de restrição de administradores do workspace
Opções
Exemplos
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
configurações do databricks sql-results-download
Controla se os usuários dentro do workspace têm permissão para download resultados do Editor SQL e das interfaces de usuário dos painéis AI/BI. Por meio de default, essa configuração está ativada (definida como verdadeira).
delete
- Exclua a configuração de download de resultados “ SQL ”.get
- Obter a configuração de download dos resultados SQLupdate
- Atualize a configuração de download dos resultados SQL.
Opções
Exemplos
databricks settings sql-results-download get
databricks settings sql-results-download update --json '{"sql_results_download": {"enabled": false}}'
databricks settings sql-results-download delete
Bandeiras globais
--debug
Se deve habilitar o registro de depuração.
-h
ou --help
Exibir ajuda para o comando Databricks CLI ou para o grupo de comandos relacionado ou para o comando relacionado.
--log-file
string
Uma string que representa o arquivo no qual a saída logs deve ser gravada. Se este sinalizador não for especificado, o default deverá gravar a saída logs no stderr.
--log-format
Formato
O tipo de formato do log, text
ou json
. O valor de default é text
.
--log-level
string
Uma string que representa o nível de formato do log. Se não for especificado, o nível de formato do log será desativado.
-o, --output
Tipo
O tipo de saída do comando, text
ou json
. O valor de default é text
.
-p, --profile
string
O nome do perfil no arquivo ~/.databrickscfg
a ser utilizado para executar o comando. Se esse sinalizador não for especificado, se existir, o perfil chamado DEFAULT
será usado.
--progress-format
Formato
O formato para exibir o progresso logs: default
, append
, inplace
ou json
-t, --target
string
Se aplicável, o destino do pacote a ser usado