Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Note
Essas informações se aplicam às versões 0.205 e superiores da CLI do Databricks. A CLI do Databricks está em Pré-Visualização Pública.
O uso da CLI do Databricks está sujeito à Licença do Databricks e ao Aviso de Privacidade do Databricks, incluindo quaisquer disposições de Dados de Uso.
O grupo de comandos policies dentro do Databricks CLI permite gerir políticas Attribute-Based Controlo de Acesso (ABAC) no Unity Catalog. O ABAC oferece uma governação de elevada influência para a aplicação das políticas de conformidade. Com as políticas ABAC, o acesso é controlado de forma hierárquica e escalável, com base nos atributos dos dados em vez de recursos específicos. Os chamadores devem ter o privilégio MANAGE de um seguro para ver, criar, atualizar ou eliminar políticas ABAC.
Políticas DataBricks criar-política
Crie uma apólice ABAC sobre um seguro garantido. A nova apólice aplica-se ao seguro garantido e a todos os seus descendentes.
databricks policies create-policy TO_PRINCIPALS FOR_SECURABLE_TYPE POLICY_TYPE [flags]
Arguments
TO_PRINCIPALS
Lista de nomes de utilizadores ou grupos a que a política se aplica.
FOR_SECURABLE_TYPE
Tipo de garantias sobre as quais a apólice deve entrar em vigor. Valores suportados: CATALOG, CLEAN_ROOM, CONNECTIONCREDENTIAL, EXTERNAL_LOCATION, FUNCTIONEXTERNAL_METADATA, , METASTORE, PIPELINEPROVIDERRECIPIENTSCHEMASHARESTAGING_TABLESTORAGE_CREDENTIALTABLEVOLUME
POLICY_TYPE
Tipo de apólice. Valores suportados: POLICY_TYPE_COLUMN_MASK, POLICY_TYPE_ROW_FILTER
Opções
--comment string
Descrição opcional da apólice.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--name string
Nome da política.
--on-securable-fullname string
Nome completo do seguro garantido em que a apólice está definida.
--on-securable-type SecurableType
Tipo do seguro em que a apólice está definida. Valores suportados: CATALOG, CLEAN_ROOM, CONNECTIONCREDENTIAL, EXTERNAL_LOCATION, FUNCTIONEXTERNAL_METADATA, , METASTORE, PIPELINEPROVIDERRECIPIENTSCHEMASHARESTAGING_TABLESTORAGE_CREDENTIALTABLEVOLUME
--when-condition string
Condição opcional em que a apólice deve entrar em vigor.
Examples
O exemplo seguinte cria uma política de filtro de linhas:
databricks policies create-policy "data-engineers" TABLE POLICY_TYPE_ROW_FILTER --name "pii-filter" --on-securable-type TABLE --on-securable-fullname "main.default.customers"
Política de eliminação das políticas Databricks
Eliminar uma política ABAC definida num seguro.
databricks policies delete-policy ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME NAME [flags]
Arguments
ON_SECURABLE_TYPE
Required. O tipo do seguro para eliminar a apólice.
ON_SECURABLE_FULLNAME
Required. O nome totalmente qualificado do seguro para eliminar a apólice.
NAME
Required. O nome da política a apagar.
Opções
Examples
O exemplo seguinte elimina uma política:
databricks policies delete-policy TABLE main.default.customers pii-filter
Políticas do DataBricks Get-Policy
Obtenha a definição da apólice de um seguro garantido.
databricks policies get-policy ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME NAME [flags]
Arguments
ON_SECURABLE_TYPE
Required. O tipo do seguro para recuperar a apólice.
ON_SECURABLE_FULLNAME
Required. O nome totalmente qualificado do seguro para recuperar a apólice.
NAME
Required. O nome da apólice a recuperar.
Opções
Examples
O exemplo seguinte recebe uma apólice:
databricks policies get-policy TABLE main.default.customers pii-filter
Políticas DataBricks Lista-Políticas
Liste todas as apólices definidas num seguro. Opcionalmente, a lista pode incluir políticas herdadas definidas no esquema ou catálogo pai do segurável.
databricks policies list-policies ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME [flags]
Arguments
ON_SECURABLE_TYPE
Required. O tipo de seguro para listar apólices para.
ON_SECURABLE_FULLNAME
Required. O nome totalmente qualificado do seguro para listar apólices.
Opções
--include-inherited
Opcional. Se deve incluir apólices herdadas de títulos principais.
--max-results int
Opcional. Número máximo de resultados a devolver.
--page-token string
Opcional. Token de página de uma chamada de lista anterior.
Examples
O exemplo seguinte lista as políticas numa tabela:
databricks policies list-policies TABLE main.default.customers
O exemplo seguinte lista políticas incluindo as herdadas:
databricks policies list-policies TABLE main.default.customers --include-inherited
Política de atualização das políticas Databricks
Atualize uma apólice ABAC sobre um seguro garantido.
databricks policies update-policy ON_SECURABLE_TYPE ON_SECURABLE_FULLNAME NAME TO_PRINCIPALS FOR_SECURABLE_TYPE POLICY_TYPE [flags]
Arguments
ON_SECURABLE_TYPE
Required. O tipo de seguro para atualizar a apólice.
ON_SECURABLE_FULLNAME
Required. O nome totalmente qualificado do seguro para atualizar a apólice.
NAME
Required. O nome da apólice a atualizar.
TO_PRINCIPALS
Lista de nomes de utilizadores ou grupos a que a política se aplica.
FOR_SECURABLE_TYPE
Tipo de garantias sobre as quais a apólice deve entrar em vigor. Valores suportados: CATALOG, CLEAN_ROOM, CONNECTIONCREDENTIAL, EXTERNAL_LOCATION, FUNCTIONEXTERNAL_METADATA, , METASTORE, PIPELINEPROVIDERRECIPIENTSCHEMASHARESTAGING_TABLESTORAGE_CREDENTIALTABLEVOLUME
POLICY_TYPE
Tipo de apólice. Valores suportados: POLICY_TYPE_COLUMN_MASK, POLICY_TYPE_ROW_FILTER
Opções
--comment string
Descrição opcional da apólice.
--json JSON
A cadeia de caracteres JSON embutida ou o @path para o arquivo JSON com o corpo da solicitação.
--name string
Nome da política.
--on-securable-fullname string
Nome completo do seguro garantido em que a apólice está definida.
--on-securable-type SecurableType
Tipo do seguro em que a apólice está definida.
--update-mask string
Opcional. Máscara de campo a especificar quais os campos a atualizar.
--when-condition string
Condição opcional em que a apólice deve entrar em vigor.
Examples
O exemplo seguinte atualiza uma política:
databricks policies update-policy TABLE main.default.customers pii-filter "data-engineers,data-scientists" TABLE POLICY_TYPE_ROW_FILTER
Bandeiras globais
--debug
Se o log de depuração deve ser habilitado.
-h ou --help
Exiba a ajuda para a CLI do Databricks ou para o grupo de comandos relacionado ou para o comando relacionado.
--log-file String
Uma cadeia de caracteres que representa o ficheiro onde os registos de saída são gravados. Se esse sinalizador não for especificado, o padrão é gravar logs de saída no stderr.
--log-format Formato
O tipo de formato de log, text ou json. O valor predefinido é text.
--log-level String
Uma cadeia de caracteres que representa o nível de formato de log. Se não for especificado, o nível de formato de log será desativado.
-o, --output tipo
O tipo de saída do comando, text ou json. O valor predefinido é text.
-p, --profile String
O nome do perfil no arquivo ~/.databrickscfg a usar para executar o comando. Se esse sinalizador não for especificado, se ele existir, o perfil nomeado DEFAULT será usado.
--progress-format Formato
O formato para exibir logs de progresso: default, append, inplace, ou json
-t, --target String
Se aplicável, o destino do pacote a ser usado